ralph-workflow 0.7.18

PROMPT-driven multi-agent orchestrator for git repos
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

//! File system state capture and validation for checkpoints.
//!
//! This module provides functionality for capturing and validating state
//! of key files in repository to enable idempotent recovery.

use crate::checkpoint::execution_history::FileSnapshot;
use crate::workspace::Workspace;
use crate::{ProcessExecutor, RealProcessExecutor};
use serde::{Deserialize, Serialize};
use std::collections::HashMap;
use std::path::Path;

/// 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.
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FileSystemState {
    /// Snapshots of tracked files
    pub files: HashMap<String, FileSnapshot>,
    /// Git HEAD commit OID (if available)
    pub git_head_oid: Option<String>,
    /// Git branch name (if available)
    pub git_branch: Option<String>,
    /// Git status output (porcelain format) for tracking staged/unstaged changes
    pub git_status: Option<String>,
    /// List of modified files from git diff
    pub git_modified_files: Option<Vec<String>>,
}

include!("file_state/capture.rs");
include!("file_state/validation.rs");
include!("file_state/error.rs");
include!("file_state/recovery.rs");

#[cfg(test)]
include!("file_state/tests.rs");