ralph-agent-loop 0.3.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

//! `ralph machine` CLI facade.
//!
//! Responsibilities:
//! - Re-export the machine-facing Clap surface consumed by the macOS app.
//! - Keep routing and JSON/document helpers in focused companion modules.
//! - Preserve the stable public entrypoint for `main.rs` and tests.
//!
//! Not handled here:
//! - Queue/task/run business logic beyond delegated machine handlers.
//! - Machine contract type definitions (see `crate::contracts::machine`).
//! - Human-facing CLI output.
//!
//! Invariants/assumptions:
//! - Machine responses remain versioned and deterministic.
//! - This facade stays thin as machine sub-surfaces evolve.

mod args;
mod common;
mod handle;
mod io;
mod queue;
mod run;
mod task;

pub use args::{
    MachineArgs, MachineCommand, MachineConfigArgs, MachineConfigCommand, MachineDashboardArgs,
    MachineDoctorArgs, MachineDoctorCommand, MachineQueueArgs, MachineQueueCommand,
    MachineQueueRepairArgs, MachineQueueUndoArgs, MachineRunArgs, MachineRunCommand,
    MachineRunLoopArgs, MachineRunOneArgs, MachineSystemArgs, MachineSystemCommand,
    MachineTaskArgs, MachineTaskCommand, MachineTaskCreateArgs, MachineTaskDecomposeArgs,
    MachineTaskMutateArgs,
};
pub use handle::handle_machine;
pub(crate) use queue::{
    build_repair_document as build_queue_repair_document,
    build_undo_document as build_queue_undo_document,
    build_validate_document as build_queue_validate_document,
};
pub(crate) use task::{
    build_decompose_document as build_task_decompose_document, build_task_mutation_document,
};