Struct VectorProvenance 

pub struct VectorProvenance {
    pub model_id: Option<String>,
    pub codec: CodecKind,
    pub codec_version: u16,
    pub rotation_seed: Option<u64>,
    pub dim: usize,
    pub metric: DistanceMetric,
    pub source_hash: Option<String>,
    pub lineage: Vec<String>,
}

Provenance every stored vector carries (ADR-297 §7). Snapshots must be reproducible from (source, provenance) alone — which is why rotation seeds are recorded and codecs are versioned.

Fields

model_id: Option<String>

Embedding model identity (e.g. “text-embedding-3-large”).

codec: CodecKind

Representation of the stored blob.

codec_version: u16

Version of that codec’s layout/tables. Bump on any change that alters encoded bytes for identical input.

rotation_seed: Option<u64>

Rotation seed for rotated codecs (Turbo4, RaBitQ).

dim: usize

Dimensionality.

metric: DistanceMetric

Distance metric the codes were prepared for.

source_hash: Option<String>

Hex SHA-256 of the source object, when known.

lineage: Vec<String>

Migration lineage, oldest first (e.g. “fp32→turbo4@2026-08-06”).

Implementations

impl VectorProvenance

pub fn new(codec: &dyn VectorCodec, metric: DistanceMetric) -> Self

Provenance for a freshly encoded vector under codec.

pub fn push_migration(&mut self, entry: impl Into<String>)

Record a migration step (old codec → new codec).

Trait Implementations

impl Clone for VectorProvenance

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 VectorProvenance

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VectorProvenance

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for VectorProvenance

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for VectorProvenance

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for VectorProvenance