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
40
41
42
43
44
45
46
47

//! Change-reporting helpers for task updates.
//!
//! Responsibilities:
//! - Compare before/after task payloads and log changed fields.
//! - Report when a task was moved to `done.jsonc` or removed during update.
//!
//! Not handled here:
//! - Queue loading or validation.
//! - Runner execution.
//!
//! Invariants/assumptions:
//! - Input JSON snapshots represent the task state before and after a single update.
//! - Removal from both queue and done is logged as a warning, not treated as a hard error.

use super::super::compare_task_fields;
use crate::contracts::Task;
use anyhow::Result;

pub(super) fn log_task_update_changes(
    before_json: &str,
    task_id: &str,
    location: &str,
    after_task: Option<&Task>,
) -> Result<()> {
    let Some(after_task) = after_task else {
        log::warn!(
            "Task {} was removed during update and not found in done.jsonc.",
            task_id
        );
        return Ok(());
    };

    let after_json = serde_json::to_string(after_task)?;
    if before_json == after_json {
        log::info!("Task {} {}. No changes detected.", task_id, location);
        return Ok(());
    }

    let changed_fields = compare_task_fields(before_json, &after_json)?;
    log::info!(
        "Task {} {}. Changed fields: {}",
        task_id,
        location,
        changed_fields.join(", ")
    );
    Ok(())
}