ralph_workflow/files/
mod.rs

1//! File management utilities for Ralph's agent files.
2//!
3//! This module manages the `.agent/` directory structure and files:
4//! - PLAN.md, ISSUES.md, STATUS.md, NOTES.md lifecycle
5//! - commit-message.txt management
6//! - PROMPT.md validation
7//! - Isolation mode file cleanup
8//! - Result extraction from agent JSON logs
9//! - File integrity verification and checksums
10//! - Error recovery and state repair
11//! - Real-time file system monitoring for PROMPT.md protection
12//!
13//! # Module Organization
14//!
15//! The files module is organized by domain concern:
16//!
17//! - [`io`] - File I/O operations (agent files, recovery, backup, context)
18//! - [`protection`] - File protection and integrity (validation, integrity, monitoring)
19//! - [`llm_output_extraction`] - LLM output extraction (commit message, JSON extraction)
20//! - [`result_extraction`] - Plan and issue extraction from logs
21//!
22//! # Isolation Mode
23//!
24//! By default, Ralph operates in isolation mode where STATUS.md, NOTES.md,
25//! and ISSUES.md are not persisted between runs. This prevents context
26//! contamination from previous runs.
27//!
28//! # Orchestrator-Controlled File I/O
29//!
30//! The orchestrator is the sole entity responsible for writing output files.
31//! Agent JSON output is extracted and written by the orchestrator, ensuring
32//! consistent file handling regardless of agent behavior.
33
34// Domain-driven submodules
35pub mod io;
36pub mod protection;
37
38// Extraction modules (already domain-organized)
39pub mod llm_output_extraction;
40pub mod result_extraction;
41
42// Re-exports from new domain structure for backward compatibility
43pub use io::{
44    clean_context_for_reviewer, cleanup_generated_files, create_prompt_backup,
45    delete_commit_message_file, delete_issues_file_for_isolation, delete_plan_file, ensure_files,
46    file_contains_marker, make_prompt_read_only, make_prompt_writable, read_commit_message_file,
47    reset_context_for_isolation, update_status, write_commit_message_file,
48};
49
50pub use protection::{restore_prompt_if_needed, validate_prompt_md};
51pub use result_extraction::extract_issues;
52#[cfg(any(test, feature = "test-utils"))]
53pub use result_extraction::extract_plan;
54
55// File operations trait for testable I/O (requires test-utils feature)
56#[cfg(any(test, feature = "test-utils"))]
57pub use io::{FileOperation, FileOps, MockFileOps, RealFileOps};
ralph_workflow/files/mod.rs

ralph_workflow/files/
mod.rs
