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
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

//! Aging threshold configuration helpers.
//!
//! Responsibilities:
//! - Resolve aging thresholds from queue config with defaults.
//! - Enforce strict threshold ordering before report computation.
//!
//! Not handled here:
//! - Per-task aging computation.
//! - Report assembly or rendering.
//!
//! Invariants/assumptions:
//! - Threshold ordering must remain `warning < stale < rotten`.

use anyhow::{Result, bail};
use time::Duration;

use crate::contracts::QueueConfig;

pub(crate) const DEFAULT_WARNING_DAYS: u32 = 7;
pub(crate) const DEFAULT_STALE_DAYS: u32 = 14;
pub(crate) const DEFAULT_ROTTEN_DAYS: u32 = 30;

#[derive(Debug, Clone, Copy, serde::Serialize)]
pub struct AgingThresholds {
    pub warning_days: u32,
    pub stale_days: u32,
    pub rotten_days: u32,
}

impl AgingThresholds {
    pub(crate) fn from_queue_config(cfg: &QueueConfig) -> Result<Self> {
        let thresholds = cfg.aging_thresholds.clone();
        let warning = thresholds
            .as_ref()
            .and_then(|value| value.warning_days)
            .unwrap_or(DEFAULT_WARNING_DAYS);
        let stale = thresholds
            .as_ref()
            .and_then(|value| value.stale_days)
            .unwrap_or(DEFAULT_STALE_DAYS);
        let rotten = thresholds
            .as_ref()
            .and_then(|value| value.rotten_days)
            .unwrap_or(DEFAULT_ROTTEN_DAYS);

        if !(warning < stale && stale < rotten) {
            bail!(
                "Invalid queue.aging_thresholds ordering: require warning_days < stale_days < rotten_days (got warning_days={}, stale_days={}, rotten_days={})",
                warning,
                stale,
                rotten
            );
        }

        Ok(Self {
            warning_days: warning,
            stale_days: stale,
            rotten_days: rotten,
        })
    }

    pub(crate) fn warning_dur(self) -> Duration {
        Duration::days(self.warning_days as i64)
    }

    pub(crate) fn stale_dur(self) -> Duration {
        Duration::days(self.stale_days as i64)
    }

    pub(crate) fn rotten_dur(self) -> Duration {
        Duration::days(self.rotten_days as i64)
    }
}

impl Default for AgingThresholds {
    fn default() -> Self {
        Self {
            warning_days: DEFAULT_WARNING_DAYS,
            stale_days: DEFAULT_STALE_DAYS,
            rotten_days: DEFAULT_ROTTEN_DAYS,
        }
    }
}