Struct Provenance 

pub struct Provenance {
    pub parents: Vec<ObjectId>,
    pub operation: String,
    pub agent: String,
    pub timestamp: u64,
    pub metadata: HashMap<String, SochValue>,
}

Records how a Knowledge Object was derived.

Provenance enables auditable lineage tracking: “Where did this fact come from?” “What transformations produced this summary?” Each provenance record forms a node in a DAG (Directed Acyclic Graph) of derivations.

The provenance chain is hash-linked — each object’s OID is derived from its content (which includes parent OIDs), creating a tamper-evident lineage.

Fields

parents: Vec<ObjectId>

OIDs of the parent objects this was derived from. Empty for root/original objects.

operation: String

The transformation or operation that produced this object. Examples: “chunk”, “summarize”, “extract_entities”, “merge”, “user_input”

agent: String

The agent or system that performed the transformation. Examples: “gpt-4”, “user:alice”, “sochdb:compaction”

timestamp: u64

Timestamp when the derivation occurred (HLC-encoded microseconds).

metadata: HashMap<String, SochValue>

Optional metadata about the transformation.

Implementations

impl Provenance

pub fn root(agent: impl Into<String>, timestamp: u64) -> Self

Create a root provenance (no parents — this is an original object).

pub fn derived( parents: Vec<ObjectId>, operation: impl Into<String>, agent: impl Into<String>, timestamp: u64, ) -> Self

Create a derived provenance with parent objects.

pub fn with_metadata(self, key: impl Into<String>, value: SochValue) -> Self

Add metadata to this provenance record.

pub fn is_root(&self) -> bool

Check if this is a root provenance (no parents).

Trait Implementations

impl Clone for Provenance

fn clone(&self) -> Provenance

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Provenance

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Provenance

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Provenance

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.