Struct SemanticAttributionTracker 

pub struct SemanticAttributionTracker {
    pub records: HashMap<u64, AttributionRecord>,
    pub output_index: HashMap<u64, Vec<u64>>,
    pub session_index: HashMap<u64, Vec<u64>>,
    /* private fields */
}

Tracks attribution chains between outputs and their source documents / embeddings / inference results, enabling explainability and audit.

Fields

records: HashMap<u64, AttributionRecord>

Primary store: record_id → record.

output_index: HashMap<u64, Vec<u64>>

Secondary index: output_id → list of record_ids.

session_index: HashMap<u64, Vec<u64>>

Secondary index: session_id → list of record_ids.

Implementations

impl SemanticAttributionTracker

pub fn new() -> Self

Creates an empty tracker.

pub fn record( &mut self, output_id: u64, sources: Vec<AttributionSource>, tick: u64, session_id: Option<u64>, ) -> u64

Records an attribution event and returns the new record_id.

pub fn records_for_output(&self, output_id: u64) -> Vec<&AttributionRecord>

Returns all records attributed to output_id, sorted by record_id ascending.

pub fn records_for_session(&self, session_id: u64) -> Vec<&AttributionRecord>

Returns all records belonging to session_id, sorted by tick ascending then record_id ascending.

pub fn top_documents(&self, n: usize) -> Vec<u64>

Returns the n document ids most frequently appearing as AttributionSource::Document across all records.

Ties are broken by doc_id ascending. The result is truncated to n entries.

pub fn remove_record(&mut self, record_id: u64) -> bool

Removes a record and cleans up all secondary indices. Returns true if the record existed.

pub fn stats(&self) -> AttributionStats

Computes aggregate statistics over all held records.

Trait Implementations

impl Default for SemanticAttributionTracker

fn default() -> Self

Returns the “default value” for a type.