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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

/// Recovery strategy for checkpoint validation failures.
#[derive(Debug, Clone, Copy, PartialEq, Eq, clap::ValueEnum, Default)]
pub enum RecoveryStrategyArg {
    /// Fail fast - require user intervention
    #[default]
    Fail,
    /// Attempt automatic recovery where possible
    Auto,
    /// Warn but continue (not recommended)
    Force,
}

impl From<RecoveryStrategyArg> for crate::checkpoint::recovery::RecoveryStrategy {
    fn from(arg: RecoveryStrategyArg) -> Self {
        match arg {
            RecoveryStrategyArg::Fail => Self::Fail,
            RecoveryStrategyArg::Auto => Self::Auto,
            RecoveryStrategyArg::Force => Self::Force,
        }
    }
}

/// Recovery command flags.
#[derive(Parser, Debug, Default)]
pub struct RecoveryFlags {
    /// Resume from last checkpoint after an interruption
    #[arg(
        long,
        help = "Resume from last checkpoint (if one exists from a previous interrupted run)",
        hide = true
    )]
    pub resume: bool,

    /// Do not offer to resume even if a checkpoint exists
    #[arg(
        long = "no-resume",
        help = "Skip interactive resume prompt even if a checkpoint exists (for CI/automation)",
        hide = true
    )]
    pub no_resume: bool,

    /// Inspect checkpoint without resuming
    #[arg(
        long = "inspect-checkpoint",
        help = "Display checkpoint information without resuming (use with --resume to see saved state)",
        hide = true
    )]
    pub inspect_checkpoint: bool,

    /// Recovery strategy when validation fails (requires hardened-resume feature)
    #[arg(
        long,
        value_enum,
        default_value = "fail",
        help = "Recovery strategy when checkpoint validation fails (fail=stop, auto=attempt recovery, force=continue anyway)"
    )]
    pub recovery_strategy: RecoveryStrategyArg,

    /// Validate setup without running agents (dry run)
    #[arg(
        long,
        help = "Validate configuration and PROMPT.md without running agents",
        hide = true
    )]
    pub dry_run: bool,

    /// Output comprehensive diagnostic information
    #[arg(long, short = 'd', help = "Show system info, agent status, and config for troubleshooting")]
    pub diagnose: bool,

    /// Show extended help with more details
    #[arg(
        long = "extended-help",
        visible_alias = "man",
        help = "Show extended help with shell completion, all presets, and troubleshooting"
    )]
    pub extended_help: bool,
}

/// Rebase control flags.
#[derive(Parser, Debug, Default)]
pub struct RebaseFlags {
    /// Enable automatic rebase before/after pipeline
    ///
    /// When enabled, ralph will automatically rebase to the main branch before
    /// starting development and after the review phase. Default is disabled to
    /// keep operations fast and avoid conflicts.
    #[arg(long, help = "Enable automatic rebase to main branch before and after pipeline")]
    pub with_rebase: bool,

    /// Only perform rebase and exit
    #[arg(
        long,
        help = "Only rebase to main branch, then exit (no pipeline execution)",
        hide = true
    )]
    pub rebase_only: bool,
}