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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

//! PROMPT.md integrity utilities.
//!
//! This module provides utilities for ensuring PROMPT.md integrity during pipeline execution.

use crate::workspace::Workspace;

/// Periodically restore PROMPT.md if it was deleted by an agent.
///
/// This is a defense-in-depth measure to ensure PROMPT.md is always available
/// even if an agent accidentally deletes it during pipeline execution.
///
/// Uses the workspace abstraction for file operations, enabling testing with
/// `MemoryWorkspace`.
///
/// # Parameters
/// - `workspace`: The workspace for file operations
/// - `logger`: The logger to use for output
/// - `phase`: The phase name (e.g., "development", "review") for logging
/// - `iteration`: The iteration/cycle number for logging
pub fn ensure_prompt_integrity(
    workspace: &dyn Workspace,
    logger: &crate::logger::Logger,
    phase: &str,
    iteration: u32,
) {
    let result = crate::files::validate_prompt_md_with_workspace(workspace, false, false);

    let has_restore_warning = result.warnings.iter().any(|w| w.contains("restored from"));
    if has_restore_warning {
        logger.warn(
            "[PROMPT_INTEGRITY] PROMPT.md was missing or empty and has been restored from backup",
        );
        logger.warn(&format!(
            "[PROMPT_INTEGRITY] Deletion detected during {phase} phase (iteration {iteration})"
        ));
        logger.warn(
            "[PROMPT_INTEGRITY] Possible cause: Agent used 'rm' or file write tools on PROMPT.md",
        );
        let restore_warning = result.warnings.iter().find(|w| w.contains("restored from"));
        if let Some(warning) = restore_warning {
            logger.success(
                &warning.replace("PROMPT.md was missing and was automatically ", "PROMPT.md "),
            );
        }
        return;
    }

    let has_recoverable_error = result
        .errors
        .iter()
        .any(|e| e.contains("not found") || e.contains("missing") || e.contains("empty"));
    if has_recoverable_error {
        let error = result
            .errors
            .iter()
            .find(|e| e.contains("not found") || e.contains("missing") || e.contains("empty"));
        if let Some(error) = error {
            logger.error(&format!(
                "[PROMPT_INTEGRITY] Failed to restore PROMPT.md: {error}"
            ));
        }
        logger.error(&format!(
            "[PROMPT_INTEGRITY] Error occurred during {phase} phase (iteration {iteration})"
        ));
        logger.error("Pipeline may not function correctly without PROMPT.md");
    }
}