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

use super::trace_insights::TraceDocument;

/// Backend trait for trace insight operations (summarize, synthesize, session recap).
pub trait TraceInsightsBackend: Send + Sync {
    fn summarize_change(&self, path: &str, doc_type: &str, diff: &str) -> Result<String, String>;

    fn synthesize_context(
        &self,
        documents: &[TraceDocument],
        updates: &[String],
    ) -> Result<String, String>;

    fn summarize_session(&self, session_id: &str, events: &[String]) -> Result<String, String>;

    fn summarize_event_history(&self, events: &str) -> Result<String, String>;

    fn update_running_summary(
        &self,
        previous_summary: &str,
        new_events: &str,
        plan_snippet: &str,
    ) -> Result<String, String>;
}

/// Stub backend that always fails — triggers template fallback in callers.
pub struct NoTraceBackend;

impl TraceInsightsBackend for NoTraceBackend {
    fn summarize_change(
        &self,
        _path: &str,
        _doc_type: &str,
        _diff: &str,
    ) -> Result<String, String> {
        Err("no trace insights backend available".into())
    }

    fn synthesize_context(
        &self,
        _documents: &[TraceDocument],
        _updates: &[String],
    ) -> Result<String, String> {
        Err("no trace insights backend available".into())
    }

    fn summarize_session(&self, _session_id: &str, _events: &[String]) -> Result<String, String> {
        Err("no trace insights backend available".into())
    }

    fn summarize_event_history(&self, _events: &str) -> Result<String, String> {
        Err("no trace insights backend available".into())
    }

    fn update_running_summary(
        &self,
        _previous_summary: &str,
        _new_events: &str,
        _plan_snippet: &str,
    ) -> Result<String, String> {
        Err("no trace insights backend available".into())
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn no_trace_backend_returns_err() {
        let b = NoTraceBackend;
        assert!(b.summarize_change("a.md", "plan", "+1").is_err());
        assert!(b.update_running_summary("", "", "").is_err());
    }
}