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

//! Integration tests for ralph CLI behavior against real git repositories.
//! Scenario: Upstream (push) behavior.

use anyhow::Result;
mod test_support;

#[test]
fn run_one_succeeds_without_upstream_and_warns() -> Result<()> {
    let dir = test_support::temp_dir_outside_repo();
    test_support::git_init(dir.path())?;

    // 1. Setup Ralph
    let (status, stdout, stderr) =
        test_support::run_in_dir(dir.path(), &["init", "--force", "--non-interactive"]);
    anyhow::ensure!(
        status.success(),
        "ralph init failed\nstdout:\n{stdout}\nstderr:\n{stderr}"
    );

    // 2. Add a task
    test_support::write_valid_single_todo_queue(dir.path())?;

    // Create a dummy Makefile for post_run_supervise.
    std::fs::write(dir.path().join("Makefile"), "ci:\n\t@echo 'CI passed'\n")?;

    // Drain stdin before exiting so prompt writes don't race with process exit (EPIPE).
    let runner_path = test_support::create_fake_runner(
        dir.path(),
        "codex",
        "#!/bin/sh\ncat >/dev/null\nexit 0\n",
    )?;
    test_support::configure_runner(dir.path(), "codex", "gpt-5.3-codex", Some(&runner_path))?;
    test_support::trust_project_commands(dir.path())?;

    // 4. Run `ralph run one` with the fake runner
    test_support::git_add_all_commit(dir.path(), "setup test env")?;

    let (status, stdout, stderr) = test_support::run_in_dir(dir.path(), &["run", "one"]);

    anyhow::ensure!(
        status.success(),
        "run one failed but should have succeeded (soft push failure)\nstdout:\n{stdout}\nstderr:\n{stderr}"
    );

    anyhow::ensure!(
        stderr.contains("Git publish mode is off; leaving repo dirty after queue updates."),
        "expected publish-mode-off message\nstdout:\n{stdout}\nstderr:\n{stderr}"
    );

    // Verify task was actually marked done and archived (supervisor logic)
    let done_content = std::fs::read_to_string(dir.path().join(".ralph/done.jsonc"))?;
    anyhow::ensure!(
        done_content.contains("RQ-0001"),
        "task should be moved to done"
    );

    Ok(())
}