Struct FileSystemState 

pub struct FileSystemState {
    pub files: HashMap<String, FileSnapshot>,
    pub git_head_oid: Option<String>,
    pub git_branch: Option<String>,
    pub git_status: Option<String>,
    pub git_modified_files: Option<Vec<String>>,
}

File system state snapshot for key files.

Captures the state of important files that affect pipeline execution. This enables validation on resume to detect unexpected changes.

Fields

files: HashMap<String, FileSnapshot>

Snapshots of tracked files

git_head_oid: Option<String>

Git HEAD commit OID (if available)

git_branch: Option<String>

Git branch name (if available)

git_status: Option<String>

Git status output (porcelain format) for tracking staged/unstaged changes

git_modified_files: Option<Vec<String>>

List of modified files from git diff

Implementations

impl FileSystemState

pub fn new() -> Self

Create a new file system state.

pub fn capture_with_optional_executor( executor: Option<&dyn ProcessExecutor>, ) -> Self

👎Deprecated since 0.5.0: Uses CWD-relative paths. Use capture_with_workspace instead.

Capture the current state with an optional executor.

If executor is None, uses RealProcessExecutor (production default).

Note

This function requires an explicit executor parameter to enable proper dependency injection for testing. For production code, pass Some(&RealProcessExecutor::new()).

Deprecated

This function uses CWD-relative paths. Prefer capture_with_workspace for new code.

pub fn capture_with_workspace( workspace: &dyn Workspace, executor: &dyn ProcessExecutor, ) -> Self

Capture the current state of key files using a workspace.

This includes files that are critical for pipeline execution:

• PROMPT.md: The primary task description
• .agent/PLAN.md: The implementation plan (if exists)
• .agent/ISSUES.md: Review findings (if exists)
• .agent/config.toml: Agent configuration (if exists)
• .agent/start_commit: Baseline commit reference (if exists)
• .agent/NOTES.md: Development notes (if exists)
• .agent/status: Pipeline status file (if exists)

pub fn capture_current_with_executor(executor: &dyn ProcessExecutor) -> Self

👎Deprecated since 0.5.0: Uses CWD-relative paths. Use capture_with_workspace instead.

Capture the current state of key files with a provided process executor.

This includes files that are critical for pipeline execution:

• PROMPT.md: The primary task description
• .agent/PLAN.md: The implementation plan (if exists)
• .agent/ISSUES.md: Review findings (if exists)
• .agent/config.toml: Agent configuration (if exists)
• .agent/start_commit: Baseline commit reference (if exists)
• .agent/NOTES.md: Development notes (if exists)
• .agent/status: Pipeline status file (if exists)

Deprecated

This function uses CWD-relative paths. Prefer capture_with_workspace for new code.

pub fn capture_file_with_workspace( &mut self, workspace: &dyn Workspace, path: &str, )

Capture a single file’s state using a workspace.

pub fn capture_file(&mut self, path: &str)

👎Deprecated since 0.5.0: Uses CWD-relative paths. Use capture_file_with_workspace instead.

Capture a single file’s state.

Deprecated

This function uses CWD-relative paths. Prefer capture_file_with_workspace for new code.

pub fn validate(&self) -> Vec<ValidationError>

👎Deprecated since 0.5.0: Uses CWD-relative paths. Use validate_with_workspace instead.

Validate the current file system state against this snapshot.

Returns a list of validation errors. Empty list means all checks passed.

Deprecated

This function uses CWD-relative paths. Prefer validate_with_workspace for new code.

pub fn validate_with_workspace( &self, workspace: &dyn Workspace, executor: Option<&dyn ProcessExecutor>, ) -> Vec<ValidationError>

Validate the current file system state against this snapshot using a workspace.

Returns a list of validation errors. Empty list means all checks passed.

pub fn validate_with_executor( &self, executor: Option<&dyn ProcessExecutor>, ) -> Vec<ValidationError>

👎Deprecated since 0.5.0: Uses CWD-relative paths. Use validate_with_workspace instead.

Trait Implementations

impl Clone for FileSystemState

fn clone(&self) -> FileSystemState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FileSystemState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FileSystemState

fn default() -> FileSystemState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FileSystemState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FileSystemState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.