Convert a [`ProvenanceGraph`] into a [`TraceRecord`] suitable for appending to `.agent-trace/traces.jsonl`. `root` is the repository root used for computing relative paths and for resolving the git HEAD revision. This function never fails; any missing data is silently omitted.
(graph: &ProvenanceGraph, root: &Path)
| 182 | /// |
| 183 | /// This function never fails; any missing data is silently omitted. |
| 184 | pub fn to_agent_trace_record(graph: &ProvenanceGraph, root: &Path) -> TraceRecord { |
| 185 | let timestamp = graph |
| 186 | .timestamp_datetime() |
| 187 | .unwrap_or_else(Utc::now) |
| 188 | .to_rfc3339(); |
| 189 | |
| 190 | // Unique record ID: session + timestamp epoch |
| 191 | let id = format!("{}-{}", graph.session_id, graph.timestamp); |
| 192 | |
| 193 | // VCS: best-effort Atomic view Merkle state |
| 194 | let vcs = atomic_revision(root).map(|(view, revision)| VcsInfo { |
| 195 | vcs_type: "atomic".to_string(), |
| 196 | view, |
| 197 | revision, |
| 198 | }); |
| 199 | |
| 200 | // Tool info |
| 201 | let tool = ToolInfo { |
| 202 | name: graph.agent_name.clone(), |
| 203 | version: env!("CARGO_PKG_VERSION").to_string(), |
| 204 | }; |
| 205 | |
| 206 | // Build files + metadata["dev.atomic"] by walking nodes |
| 207 | let (files, dev_atomic) = build_files_and_metadata(graph); |
| 208 | |
| 209 | let mut metadata: HashMap<String, Value> = HashMap::new(); |
| 210 | metadata.insert("dev.atomic".to_string(), dev_atomic); |
| 211 | |
| 212 | TraceRecord { |
| 213 | version: "0.1.0".to_string(), |
| 214 | id, |
| 215 | timestamp, |
| 216 | vcs, |
| 217 | tool, |
| 218 | files, |
| 219 | metadata, |
| 220 | } |
| 221 | } |
| 222 | |
| 223 | /// Append a [`TraceRecord`] as a single JSON line to |
| 224 | /// `{root}/.agent-trace/traces.jsonl`. |