sara-tasks 2.0.0

Sara — folder-aware task manager
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

//! Folded-operation trace for `begin`. With the `telemetry` feature, every internal
//! op `begin` composes emits its own ordered telemetry event (stamped with one
//! random `trace_id` and a `seq`) and is returned in the result's `folded` log.
//! Without the feature this is a zero-sized no-op and the result is unchanged.

use std::time::Instant;

use serde_json::Value;

use crate::infrastructure::config::Config;
use crate::infrastructure::telemetry::Source;

#[cfg(feature = "telemetry")]
pub(super) struct Folded<'a> {
    cfg: &'a Config,
    source: Source,
    trace_id: String,
    log: Vec<Value>,
}

#[cfg(feature = "telemetry")]
impl<'a> Folded<'a> {
    pub(super) fn new(cfg: &'a Config, source: Source) -> Self {
        Self {
            cfg,
            source,
            trace_id: uuid::Uuid::new_v4().to_string(),
            log: Vec::new(),
        }
    }

    /// Record one folded op; `n` is an optional non-identifying outcome count.
    pub(super) fn emit(&mut self, op: &str, started: Instant, n: Option<u64>) {
        use crate::infrastructure::telemetry::{self, Span};
        use serde_json::json;

        let dur_ms = started.elapsed().as_millis() as u64;
        let seq = self.log.len() as u32;
        let name = match self.source {
            Source::Mcp => format!("mcp {op}"),
            Source::Cli => op.to_string(),
        };
        telemetry::capture_span(
            self.cfg,
            self.source,
            &name,
            &["via_begin".to_string()],
            dur_ms,
            &Ok::<(), anyhow::Error>(()),
            None,
            Some(Span {
                trace_id: &self.trace_id,
                seq,
                n,
            }),
        );
        let mut entry = json!({ "op": op, "seq": seq, "duration_ms": dur_ms });
        if let Some(n) = n {
            entry["n"] = json!(n);
        }
        self.log.push(entry);
    }

    pub(super) fn finish(self, out: &mut Value) {
        out["begin_id"] = Value::String(self.trace_id);
        out["folded"] = Value::Array(self.log);
    }
}

#[cfg(not(feature = "telemetry"))]
pub(super) struct Folded;

#[cfg(not(feature = "telemetry"))]
impl Folded {
    pub(super) fn new(_cfg: &Config, _source: Source) -> Self {
        Folded
    }

    pub(super) fn emit(&mut self, _op: &str, _started: Instant, _n: Option<u64>) {}

    pub(super) fn finish(self, _out: &mut Value) {}
}