agent-trace 0.1.0

Git-backed document memory, trace continuity, and permissioned writes for agent workflows
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
84
85
86
87
88
89
90
91
92
93
94
95
96

use crate::config::MergedConfig;
use crate::llm::Llm;
use crate::manifest::Manifest;
use crate::observability::CliOutput;
use crate::running_summary;
use anyhow::Result;
use std::path::Path;

/// Print the startup banner to stdout before entering TUI mode.
pub fn print_banner(
    store_root: &Path,
    config: &MergedConfig,
    manifest: &Manifest,
    ascii: bool,
    output: &dyn CliOutput,
) -> Result<()> {
    if !config.ui.show_banner {
        return Ok(());
    }
    let version = env!("CARGO_PKG_VERSION");
    let border = if ascii { "+" } else { "╔" };
    let side = if ascii { "|" } else { "║" };
    let bottom = if ascii { "+" } else { "╚" };
    let hr = if ascii { "-" } else { "═" };

    let width = 56;
    let hr_line = hr.repeat(width);

    output.line(&format!(
        "{}{}{}",
        border,
        hr_line,
        if ascii { "+" } else { "╗" }
    ))?;
    output.line(&format!(
        "{}  agent-trace v{}  —  Agent Document Manager{:>width$}{side}",
        side,
        version,
        "",
        width = width - 18 - version.len()
    ))?;
    output.line(&format!(
        "{}{}{}",
        bottom,
        hr_line,
        if ascii { "+" } else { "╝" }
    ))?;
    output.line("")?;
    output.line(&format!("  Documents tracked : {}", manifest.len()))?;

    // Show synthesis backend label from Llm facade
    let backend_info = Llm::backend_info_from_config(config);
    output.line(&format!(
        "  Synthesis         : {}",
        if backend_info.degraded {
            "degraded (run: agent-trace model ensure)".to_string()
        } else {
            backend_info.label.clone()
        }
    ))?;

    if store_root.join("running_summary.md").exists() {
        let resume_lines = running_summary::resume_here_lines(store_root);
        if !resume_lines.is_empty() {
            output.line("")?;
            output.line("  Resume Here:")?;
            for line in resume_lines {
                output.line(&format!("    {line}"))?;
            }
        }
    }
    output.line("")?;
    Ok(())
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::config::MergedConfig;
    use crate::manifest::Manifest;
    use crate::observability::NoopOutput;
    use crate::state::config::StoreInfo;
    use tempfile::TempDir;

    #[test]
    fn test_banner_prints_version() {
        let tmp = TempDir::new().unwrap();
        let root = tmp.path();
        std::fs::create_dir_all(root.join(".agent-trace")).unwrap();
        let info = StoreInfo::new("test".into());
        let manifest = Manifest::create_empty(info, root).unwrap();
        let config = MergedConfig::default();
        print_banner(root, &config, &manifest, false, &NoopOutput).unwrap();
        print_banner(root, &config, &manifest, true, &NoopOutput).unwrap();
    }
}