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

//! Queue file contracts for Ralph.
//!
//! Responsibilities:
//! - Define the queue file payload structure and defaults.
//!
//! Not handled here:
//! - Queue persistence or scheduling logic (see `crate::queue`).
//! - Task field definitions (see `super::task`).
//!
//! Invariants/assumptions:
//! - `version` is the queue schema version.
//! - Tasks are serialized/deserialized with strict field validation.

use schemars::JsonSchema;
use serde::{Deserialize, Serialize};

use super::Task;

/* --------------------------- QueueFile (JSON) ---------------------------- */

#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema)]
#[serde(deny_unknown_fields)]
pub struct QueueFile {
    pub version: u32,

    #[serde(default)]
    pub tasks: Vec<Task>,
}

/* ------------------------------ Defaults -------------------------------- */

impl Default for QueueFile {
    fn default() -> Self {
        Self {
            version: 1,
            tasks: Vec::new(),
        }
    }
}