Struct SourceProvenance 

pub struct SourceProvenance {
    pub source_kind: SourceKind,
    pub source_uri: String,
    pub origin_id: Option<String>,
    pub fingerprint: Option<String>,
    pub captured_at: Option<DateTime<Utc>>,
    pub imported_at: DateTime<Utc>,
    pub metadata: HashMap<String, String>,
}

Provenance metadata shared by all ingesters.

This supports consistent source attribution and deterministic re-ingestion.

Fields

source_kind: SourceKind

What kind of source produced the content.

source_uri: String

Stable source URI/path (e.g., file:///..., notes://...).

origin_id: Option<String>

Optional upstream source identifier (e.g., Apple Note ID, Photos asset ID).

fingerprint: Option<String>

Optional content fingerprint (checksum, hash, opaque digest).

captured_at: Option<DateTime<Utc>>

When the source artifact was originally created/captured, if known.

imported_at: DateTime<Utc>

When this provenance record was created during import.

metadata: HashMap<String, String>

Arbitrary source-specific metadata.

Implementations

impl SourceProvenance

pub fn new(source_kind: SourceKind, source_uri: impl Into<String>) -> Self

Create a new provenance record.

pub fn with_origin_id(self, origin_id: impl Into<String>) -> Self

Set the upstream origin ID.

pub fn with_fingerprint(self, fingerprint: impl Into<String>) -> Self

Set the source fingerprint.

pub fn with_captured_at(self, captured_at: DateTime<Utc>) -> Self

Set the capture timestamp.

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

Add a source-specific metadata key/value pair.

pub fn idempotency_key(&self) -> String

Generate a deterministic idempotency key for de-duplication.

Preference order:

1. origin_id (best external identity)
2. fingerprint (content identity)
3. source_uri (path identity fallback)

pub fn metadata_pairs(&self) -> Vec<(String, String)>

Export normalized metadata pairs for attaching to knowledge entries.

Keys are namespaced under source.*.

Trait Implementations

impl Clone for SourceProvenance

fn clone(&self) -> SourceProvenance

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceProvenance

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SourceProvenance

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SourceProvenance

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

where __S: Serializer,

Serialize this value into the given Serde serializer.