ralph-agent-loop 0.4.0

A Rust CLI for managing AI agent loops with a structured JSON task queue
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
99
100
101
102
103
104
105

//! Dry-run presenters for `ralph task batch`.
//!
//! Responsibilities:
//! - Provide stable preview output for each batch operation.
//! - Keep the main batch handler free of formatting noise.

use crate::contracts::TaskStatus;

pub(super) fn simple(action: &str, task_ids: &[String]) {
    println!("{action}");
    for task_id in task_ids {
        println!("  - {}", task_id);
    }
    println!("\nDry run complete. No changes made.");
}

pub(super) fn status(status: TaskStatus, task_ids: &[String]) {
    simple(
        &format!(
            "Dry run - would update {} tasks to status '{}':",
            task_ids.len(),
            status
        ),
        task_ids,
    );
}

pub(super) fn terminal_status(status: TaskStatus, task_ids: &[String]) {
    simple(
        &format!(
            "Dry run - would mark {} tasks as {} and archive them:",
            task_ids.len(),
            status
        ),
        task_ids,
    );
}

pub(super) fn field(key: &str, value: &str, task_ids: &[String]) {
    simple(
        &format!(
            "Dry run - would set field '{}' = '{}' on {} tasks:",
            key,
            value,
            task_ids.len()
        ),
        task_ids,
    );
}

pub(super) fn clone_tasks(status: TaskStatus, title_prefix: Option<&str>, task_ids: &[String]) {
    println!(
        "Dry run - would clone {} tasks with status '{}':",
        task_ids.len(),
        status
    );
    for task_id in task_ids {
        let prefix_info = title_prefix
            .map(|p| format!(" [prefix: '{}']", p))
            .unwrap_or_default();
        println!("  - {}{}", task_id, prefix_info);
    }
    println!("\nDry run complete. No changes made.");
}

pub(super) fn split_tasks(
    count: usize,
    status: TaskStatus,
    distribute_plan: bool,
    task_ids: &[String],
) {
    println!(
        "Dry run - would split {} tasks into {} children each with status '{}':",
        task_ids.len(),
        count,
        status
    );
    for task_id in task_ids {
        let dist_info = if distribute_plan {
            " [distribute plan]"
        } else {
            ""
        };
        println!("  - {}{}", task_id, dist_info);
    }
    println!("\nDry run complete. No changes made.");
}

pub(super) fn plan_items(action: &str, plan_items: &[String], task_ids: &[String]) {
    println!(
        "Dry run - would {} {} plan items to {} tasks:",
        action,
        plan_items.len(),
        task_ids.len()
    );
    println!("Plan items to {}:", action);
    for item in plan_items {
        println!("  - {}", item);
    }
    println!("\nTarget tasks:");
    for task_id in task_ids {
        println!("  - {}", task_id);
    }
    println!("\nDry run complete. No changes made.");
}