Struct Anchor 

pub struct Anchor {
    pub artifact: String,
    pub grain: AnchorGrain,
    pub class: AnchorProvenanceClass,
    pub at_version: Option<AnchorVersion>,
    pub hash: Option<String>,
    pub hash_stability: AnchorHashStability,
    pub derived_from: Vec<String>,
    pub binding: Option<String>,
    pub source: Option<String>,
}

One durable anchor record: an entity’s provenance tie to a single source artifact.

This is the persisted + read shape. Malformed wire input is refused upstream via AnchorInput::validate, which produces this strict type only when every rule holds.

Fields

artifact: String

Artifact reference in the medium’s own namespace — a repo-relative path, a path@commit, a URL, or an entity id, interpreted per Self::grain and the medium.

grain: AnchorGrain

The granularity of Self::artifact.

class: AnchorProvenanceClass

The anchor’s epistemic standing.

at_version: Option<AnchorVersion>

The medium-typed pinned version, or None when the medium has no retrievable version (plain path / mtime).

hash: Option<String>

Content hash over the prepared artifact form (never raw bytes), present only when Self::class carries hash semantics. None for authored / informed-by.

hash_stability: AnchorHashStability

The medium’s declared hash stability — governs whether a hash break resolves drifted or recheck.

derived_from: Vec<String>

For a derived class: the input artifact refs the entity was derived from. Empty for every other class.

binding: Option<String>

hash(D) of the binding that produced this anchor (E2), when a binding produced it. None for a manually-authored anchor with no producing binding.

source: Option<String>

The NAME of the source (as declared in the producing binding’s sources[]) that produced this anchor — so a discovery run can be measured per entry point. Optional and additive: pre-existing sidecars load unchanged and are never backfilled (a guessed provenance is worse than an absent one). Validated against the producing binding’s declared names only when Self::binding still resolves in the workspace.

Trait Implementations

impl Clone for Anchor

fn clone(&self) -> Anchor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Anchor

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Anchor

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Anchor

impl PartialEq for Anchor

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Anchor

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 Anchor