carryctx 0.3.0

Persistent project context for coding agents
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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

use carryctx::application::runtime::{InvocationContext, OutputFormat};
use carryctx::application::stats::{compute_stats, export_stats_csv, render_stats_markdown};
use carryctx::error::ExitCode;
use clap::Parser;

// ── Stats ────────────────────────────────────────────────────────────────

#[derive(Parser, Debug)]
pub struct StatsArgs {
    /// Agent to show stats for (optional, shows all if not provided)
    #[arg(long)]
    pub for_agent: Option<String>,

    /// Output report file path (.md, .csv, .json)
    #[arg(short, long)]
    pub output: Option<String>,

    /// Format report in Markdown
    #[arg(long)]
    pub markdown: bool,
}

// ═══════════════════════════════════════════════════════════════════════════
//  Handler: stats
// ═══════════════════════════════════════════════════════════════════════════

pub fn handle_stats(
    args: &StatsArgs,
    ctx: &InvocationContext,
    is_json: bool,
) -> Result<ExitCode, ExitCode> {
    let work_dir = crate::resolve_work_dir(ctx);
    let agent_filter = args.for_agent.as_deref();

    let result = compute_stats(work_dir, agent_filter);

    if let Ok(stats) = &result {
        if let Some(out_path) = &args.output {
            let content = if out_path.ends_with(".csv") {
                export_stats_csv(stats)
            } else if out_path.ends_with(".json") {
                serde_json::to_string_pretty(stats).unwrap_or_default()
            } else {
                render_stats_markdown(stats)
            };

            if let Err(e) = std::fs::write(out_path, content) {
                eprintln!("Failed to write stats output: {e}");
                return Err(ExitCode::General);
            }

            if !ctx.quiet {
                println!("Successfully exported project stats to {}", out_path);
            }
            return Ok(ExitCode::Success);
        }

        if args.markdown || matches!(ctx.format, OutputFormat::Markdown) {
            print!("{}", render_stats_markdown(stats));
            return Ok(ExitCode::Success);
        }

        if !is_json && !ctx.quiet {
            println!("Project Overview:");
            println!(
                "   Tasks: {} Total (Done: {}, In Progress: {}, Ready: {}, Planned: {})",
                stats.tasks_total,
                stats.tasks_completed,
                stats.tasks_in_progress,
                stats.tasks_ready,
                stats.tasks_planned
            );
            println!(
                "   Graph: {} Nodes, {} Edges",
                stats.graph_nodes_total, stats.graph_edges_total
            );
            println!(
                "   Sessions: {} | Checkpoints: {}",
                stats.sessions_total, stats.checkpoints_total
            );
            println!();

            println!(
                "{:<20} | {:<10} | {:<12} | {:<12} | {:<15} | {:<10}",
                "Agent Name", "Sessions", "Time Spent", "Checkpoints", "Tasks Done", "Blockers"
            );
            println!(
                "{:-<20}-+-{:-<10}-+-{:-<12}-+-{:-<12}-+-{:-<15}-+-{:-<10}",
                "", "", "", "", "", ""
            );
            for stat in &stats.agent_stats {
                let hours = stat.total_seconds / 3600;
                let minutes = (stat.total_seconds % 3600) / 60;
                let time_str = format!("{}h {}m", hours, minutes);
                println!(
                    "{:<20} | {:<10} | {:<12} | {:<12} | {:<15} | {:<10}",
                    stat.agent_name,
                    stat.total_sessions,
                    time_str,
                    stat.total_checkpoints,
                    stat.tasks_completed,
                    stat.blockers_reported
                );
            }
            return Ok(ExitCode::Success);
        }
    }

    crate::render_and_print("stats", result, is_json, ctx.quiet)
}