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

use crate::git_store::CommitInfo;
use crate::observability::CliOutput;
use crate::store::Store;
use crate::types::{Action, Actor, DocType};
use anyhow::{bail, Result};
use std::path::Path;

pub fn run(
    store_root: &Path,
    doc_type: DocType,
    file: &Path,
    output: &dyn CliOutput,
) -> Result<()> {
    if !store_root.join(file).exists() && !file.exists() {
        bail!("File not found: {}", file.display());
    }

    // Resolve to a relative path from store root.
    let rel = if file.is_absolute() {
        file.strip_prefix(store_root).unwrap_or(file).to_path_buf()
    } else {
        file.to_path_buf()
    };

    let mut store = Store::open(store_root)?;

    if store.manifest.is_tracked(&rel) {
        bail!("File is already tracked: {}", rel.display());
    }

    store.manifest.register(&rel, doc_type.clone(), "")?;
    store.manifest.save(store_root)?;

    // Regenerate AGENT-TRACE.md so the new document appears.
    let agent_trace_content = crate::agent_trace_md::generate(store_root, &store.manifest);
    std::fs::write(store_root.join("AGENT-TRACE.md"), &agent_trace_content)?;

    let info = CommitInfo {
        action: Action::Create,
        files: vec![
            (rel.clone(), Action::Create, doc_type.clone()),
            (
                std::path::PathBuf::from("AGENT-TRACE.md"),
                Action::Modify,
                DocType::Reference,
            ),
        ],
        actor: Actor::User,
        summary: format!("add {}: {}", doc_type, rel.display()),
        agent_name: None,
        session_id: None,
    };
    store.commit(&info)?;

    output.line(&format!("Added {} as {}", rel.display(), doc_type))?;
    Ok(())
}