Struct Storage 

pub struct Storage { /* private fields */ }

Implementations

impl Storage

pub fn new(project_root: Option<PathBuf>) -> Self

pub fn project_root(&self) -> &Path

Get the project root directory

pub fn scud_dir(&self) -> PathBuf

pub fn tasks_file(&self) -> PathBuf

pub fn config_file(&self) -> PathBuf

pub fn docs_dir(&self) -> PathBuf

pub fn guidance_dir(&self) -> PathBuf

pub fn load_guidance(&self) -> Result<String>

Load all .md files from .scud/guidance/ folder Returns concatenated content with file headers, or empty string if no files

pub fn is_initialized(&self) -> bool

pub fn initialize(&self) -> Result<()>

pub fn initialize_with_config(&self, config: &Config) -> Result<()>

pub fn load_config(&self) -> Result<Config>

pub fn load_tasks(&self) -> Result<HashMap<String, Phase>>

pub fn save_tasks(&self, tasks: &HashMap<String, Phase>) -> Result<()>

pub fn get_active_group(&self) -> Result<Option<String>>

pub fn set_active_group(&self, group_tag: &str) -> Result<()>

pub fn clear_cache(&self)

Clear the active group cache Useful when active-tag file is modified externally or for testing

pub fn clear_active_group(&self) -> Result<()>

Clear the active group setting (remove the active-tag file)

pub fn load_group(&self, group_tag: &str) -> Result<Phase>

Load a single task group by tag Parses the SCG file and extracts the requested group

pub fn load_active_group(&self) -> Result<Phase>

Load the active task group directly (optimized) Combines get_active_group() and load_group() in one call

pub fn update_group(&self, group_tag: &str, group: &Phase) -> Result<()>

Update a single task group atomically Holds exclusive lock across read-modify-write cycle to prevent races

pub fn update_task_status( &self, group_tag: &str, task_id: &str, status: TaskStatus, ) -> Result<()>

Update a single task’s status within a group Convenience method that loads, modifies, and saves the group atomically

pub fn read_file(&self, path: &Path) -> Result<String>

pub fn archive_dir(&self) -> PathBuf

Get the archive directory path

pub fn ensure_archive_dir(&self) -> Result<()>

Ensure archive directory exists

pub fn archive_filename(&self, tag: Option<&str>) -> String

Generate archive filename for a tag or all tasks Format: {YYYY-MM-DD}_{tag}.scg or {YYYY-MM-DD}_all.scg

pub fn archive_phase( &self, tag: &str, phases: &HashMap<String, Phase>, ) -> Result<PathBuf>

Archive a single phase/tag Returns the path to the created archive file

pub fn archive_all(&self, phases: &HashMap<String, Phase>) -> Result<PathBuf>

Archive all phases together Returns the path to the created archive file

pub fn parse_archive_filename(filename: &str) -> (String, Option<String>)

Parse archive filename to extract date and tag Returns (date, tag) where tag is None if “all”

pub fn list_archives(&self) -> Result<Vec<ArchiveInfo>>

List all archives in the archive directory Returns sorted by date descending (newest first)

pub fn load_archive(&self, path: &Path) -> Result<HashMap<String, Phase>>

Load an archive file Returns the phases contained in the archive

pub fn restore_archive( &self, archive_name: &str, replace: bool, ) -> Result<Vec<String>>

Restore an archive by merging it into current tasks.

Arguments

• archive_name - filename or partial match (e.g., “v1”, “2026-01-13_v1”, “2026-01-13_v1.scg”)
• replace - if true, replace existing tags; if false, skip existing

Returns

The list of restored tag names