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

//! Stats report assembly helpers.
//!
//! Responsibilities:
//! - Compose the full `StatsReport` from filtered tasks and focused helpers.
//! - Keep top-level stats facade free of metric-construction details.
//!
//! Not handled here:
//! - Text or JSON rendering.
//! - Execution-history ETA lookup.
//!
//! Invariants/assumptions:
//! - Queue inputs are already validated.
//! - Tag filtering happens before all downstream metric calculations.

use crate::contracts::QueueFile;

use super::breakdowns::{calc_slow_groups, calc_velocity_breakdowns};
use super::model::{StatsFilters, StatsReport};
use super::summary::{
    build_time_tracking_stats, collect_all_tasks, filter_tasks_by_tags, summarize_tasks,
};
use super::tag_breakdown::build_tag_breakdown;

pub(crate) fn build_stats_report(
    queue: &QueueFile,
    done: Option<&QueueFile>,
    tags: &[String],
) -> StatsReport {
    let all_tasks = collect_all_tasks(queue, done);
    let filtered_tasks = filter_tasks_by_tags(all_tasks, tags);
    let summary = summarize_tasks(&filtered_tasks);
    let time_tracking = build_time_tracking_stats(&filtered_tasks);
    let velocity = calc_velocity_breakdowns(&filtered_tasks);
    let slow_groups = calc_slow_groups(&filtered_tasks);
    let tag_breakdown = build_tag_breakdown(&filtered_tasks, summary.total);

    StatsReport {
        summary,
        durations: time_tracking.lead_time.clone(),
        time_tracking,
        velocity,
        slow_groups,
        tag_breakdown,
        filters: StatsFilters {
            tags: tags.to_vec(),
        },
        execution_history_eta: None,
    }
}