ralph-agent-loop 0.3.1

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

//! Purpose: suite-local fixtures and CLI helpers for `queue_search_test`.
//!
//! Responsibilities:
//! - Create disposable repos from the cached git+`.ralph/` integration scaffold.
//! - Centralize queue/done fixture writes for search scenarios.
//! - Provide small helpers for invoking `ralph queue search` and decoding JSON output.
//!
//! Scope:
//! - Helpers used only by `crates/ralph/tests/queue_search_test.rs`.
//!
//! Usage:
//! - Call `SearchRepo::new()` per test.
//! - Seed queue/done state with `write_queue()` / `write_done()`.
//! - Use `search_json()` for JSON-output assertions and `search()` for raw stdout/stderr checks.
//!
//! Invariants/Assumptions:
//! - Fixtures use cached seeded repo scaffolding instead of repeating `git init` + `.ralph` bootstrap.
//! - Helpers preserve end-to-end CLI coverage by invoking the real `ralph` binary.
//! - JSON assertions are only valid when the caller passes `--format json`.

use anyhow::{Context, Result, ensure};
use ralph::contracts::Task;
use std::path::Path;
use std::process::ExitStatus;
use tempfile::TempDir;

pub(super) struct SearchRepo {
    dir: TempDir,
}

impl SearchRepo {
    pub(super) fn new() -> Result<Self> {
        let dir = super::test_support::temp_dir_outside_repo();
        super::test_support::seed_git_repo_with_ralph(dir.path())?;
        Ok(Self { dir })
    }

    pub(super) fn path(&self) -> &Path {
        self.dir.path()
    }

    pub(super) fn write_queue(&self, tasks: &[Task]) -> Result<()> {
        super::test_support::write_queue(self.path(), tasks)
    }

    pub(super) fn write_done(&self, tasks: &[Task]) -> Result<()> {
        super::test_support::write_done(self.path(), tasks)
    }

    pub(super) fn search(&self, args: &[&str]) -> (ExitStatus, String, String) {
        super::test_support::run_in_dir(self.path(), args)
    }

    pub(super) fn search_ok(&self, args: &[&str]) -> Result<(String, String)> {
        let (status, stdout, stderr) = self.search(args);
        ensure!(
            status.success(),
            "search failed\nstdout:\n{stdout}\nstderr:\n{stderr}"
        );
        Ok((stdout, stderr))
    }

    pub(super) fn search_json(&self, args: &[&str]) -> Result<serde_json::Value> {
        let (stdout, _stderr) = self.search_ok(args)?;
        serde_json::from_str(&stdout).context("parse queue search JSON output")
    }
}