Struct ArtifactPreferenceLedger 

pub struct ArtifactPreferenceLedger {
    pub events: Vec<ArtifactPreferenceEvent>,
}

Validated append-only artifact-preference table.

Fields

events: Vec<ArtifactPreferenceEvent>

Events ordered by (recorded_at, preference_event_uuid).

Implementations

impl ArtifactPreferenceLedger

pub fn new(events: Vec<ArtifactPreferenceEvent>) -> Result<Self, KnowledgeError>

Validate, sort, and construct a preference table.

pub fn merge(&self, staged: &Self) -> Result<Self, KnowledgeError>

Merge staged rows into an existing ledger.

pub fn preference_fingerprint( &self, preference_event_uuid: Uuid, ) -> Result<[u8; 32], KnowledgeError>

Canonical semantic fingerprint over caller-supplied preference-event content.

Excludes prior_artifact_uuid (ledger-derived), provenance_uuid, and recorded_at_micros (clock-derived) so that a retry with the same caller-provided content compares equal to the committed row regardless of when it was retried.

pub fn preference_request_fingerprint( preference_event_uuid: Uuid, source_uuid: Uuid, artifact_uuid: Uuid, reason: &str, ) -> Result<[u8; 32], KnowledgeError>

Canonical semantic fingerprint for caller-supplied preference request fields.

Identical to preference_fingerprint but computed from raw caller-provided fields rather than requiring a committed ledger row. Used to compare an incoming request against the already-committed row before constructing the full staged event.

pub fn current_preferred_artifact(&self, source_uuid: Uuid) -> Option<Uuid>

Return the current preferred Artifact for one Source, if any.

pub fn batch(&self) -> Result<RecordBatch, KnowledgeError>

Encode the authoritative Arrow batch.

pub fn from_batches(batches: &[RecordBatch]) -> Result<Self, KnowledgeError>

Decode one or more Arrow batches.

Trait Implementations

impl Clone for ArtifactPreferenceLedger

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArtifactPreferenceLedger

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

Formats the value using the given formatter.

impl Default for ArtifactPreferenceLedger

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ArtifactPreferenceLedger

impl PartialEq for ArtifactPreferenceLedger

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ArtifactPreferenceLedger