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

//! Queue stop subcommand.
//!
//! Responsibilities:
//! - Create a stop signal file to request graceful termination of a running loop.
//!
//! Not handled here:
//! - Signal detection in the run loop (see `crate::commands::run`).
//! - Signal cleanup (handled by the run loop after detection).
//!
//! Invariants/assumptions:
//! - The stop signal is a file-based flag, not a process signal.
//! - Multiple stop commands are idempotent (subsequent calls are no-ops).
//! - The signal is only acted upon between tasks, not during task execution.

use anyhow::Result;

use crate::config::Resolved;
use crate::signal;

pub(crate) fn handle(resolved: &Resolved) -> Result<()> {
    let cache_dir = resolved.repo_root.join(".ralph/cache");

    signal::create_stop_signal(&cache_dir)?;

    log::info!(
        "Stop signal created. The loop will stop starting new tasks and exit when current in-flight work completes."
    );
    log::info!(
        "Sequential mode: exits between tasks. Parallel mode: stops scheduling new tasks and waits for in-flight tasks."
    );
    log::info!("To force immediate termination, press Ctrl+C in the running loop.");

    Ok(())
}