Method append_raw_node

atomic-agent/src/provenance/accumulator/append.rs:320–344

Append a raw node with full control over its fields. This method bypasses the usual edge inference logic and allows direct insertion of nodes with custom details. Used for ingesting external trace formats (e.g., Sherpa JSONL) that carry their own structured data. Returns the new node's ID.

(
        &mut self,
        kind: NodeKind,
        timestamp: i64,
        summary: &str,
        detail: Option<serde_json::Value>,
    )

    ///
    /// Returns the new node's ID.
    pub fn append_raw_node(
        &mut self,
        kind: NodeKind,
        timestamp: i64,
        summary: &str,
        detail: Option<serde_json::Value>,
    ) -> String {
        let node = GraphNode {
            id: self.next_id(),
            kind,
            timestamp,
            summary: summary.to_string(),
            detail,
            change_hash: None,
            tool_name: None,
            tool_call_id: None,
            duration_ms: None,
            classified: false,
            confidence: None,
            consolidated_from: Vec::new(),
        };
        let node_id = node.id.clone();
        self.push_node(node);
        node_id
    }

    /// Append a generic todo snapshot and link it to the active turn goal.
    pub fn append_todo_snapshot(