Function to_agent_trace_record

atomic-agent/src/export.rs:184–220

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)

///
/// This function never fails; any missing data is silently omitted.
pub fn to_agent_trace_record(graph: &ProvenanceGraph, root: &Path) -> TraceRecord {
    let timestamp = DateTime::<Utc>::from_timestamp(graph.timestamp, 0)
        .unwrap_or_else(Utc::now)
        .to_rfc3339();

    // Unique record ID: session + timestamp epoch
    let id = format!("{}-{}", graph.session_id, graph.timestamp);

    // VCS: best-effort Atomic view Merkle state
    let vcs = atomic_revision(root).map(|(view, revision)| VcsInfo {
        vcs_type: "atomic".to_string(),
        view,
        revision,
    });

    // Tool info
    let tool = ToolInfo {
        name: graph.agent_name.clone(),
        version: env!("CARGO_PKG_VERSION").to_string(),
    };

    // Build files + metadata["dev.atomic"] by walking nodes
    let (files, dev_atomic) = build_files_and_metadata(graph);

    let mut metadata: HashMap<String, Value> = HashMap::new();
    metadata.insert("dev.atomic".to_string(), dev_atomic);

    TraceRecord {
        version: "0.1.0".to_string(),
        id,
        timestamp,
        vcs,
        tool,
        files,
        metadata,
    }
}

/// Append a [`TraceRecord`] as a single JSON line to
/// `{root}/.agent-trace/traces.jsonl`.