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

//! Queue file saving functionality.
//!
//! Responsibilities:
//! - Serialize queue files to JSON with pretty formatting.
//! - Write queue files atomically to prevent corruption.
//!
//! Not handled here:
//! - Queue file loading or backup creation.
//! - Lock acquisition (assumed to be held by caller).
//!
//! Invariants/assumptions:
//! - Queue files are written atomically using `write_atomic`.
//! - Serialization should never fail for valid QueueFile structures.

use crate::contracts::QueueFile;
use crate::fsutil;
use anyhow::{Context, Result};
use std::path::Path;

pub fn save_queue(path: &Path, queue: &QueueFile) -> Result<()> {
    let rendered = serde_json::to_string_pretty(queue).context("serialize queue JSON")?;
    fsutil::write_atomic(path, rendered.as_bytes())
        .with_context(|| format!("write queue JSON {}", path.display()))?;
    Ok(())
}