Struct Source 

pub struct Source {
    pub name: String,
    pub medium_type: MediumType,
    pub pointer: String,
    pub change_detection: Option<String>,
    pub scope: Vec<PatternEntry>,
    pub engagement: Option<Value>,
    pub preparation: Option<String>,
}

One inline source of a v2 crate::binding::Binding — the full description of a body of information the pipeline reads, carrying both halves the retired standalone records used to split: the medium half (where it lives — type / pointer / change_detection) and the facet half (which part of it — scope / engagement / preparation).

name is required and unique within the record: it keys per-source sync/verify state (<mem>/<binding>/<source>#synced) exactly as facet names did before the consolidation, which is why migration preserves facet names as source names byte-verbatim.

Fields

name: String

Stable name — keys per-source sync/verify state.

medium_type: MediumType

What kind of surface this source references (the medium half).

pointer: String

Where the body of information lives — a path, URL, or mem id, interpreted per Self::medium_type. Opaque to this layer.

change_detection: Option<String>

Optional declared change-detection strategy — none / git / mtime / auto. Unset (the common case) means auto: the ingest resolver probes for a git work tree over Self::pointer and picks git or mtime. A graph-typed source ignores this and always uses the graph snapshot signal.

scope: Vec<PatternEntry>

Allow/deny selection over the source (the facet half). A source with no allow patterns is unscoped — a typed refusal at run time (no strategy diffs or enumerates the whole territory; the brief reports it as unmonitored), not “everything”. A source that truly wants everything writes **/*.

engagement: Option<Value>

Engagement contract — verbs, tools, terminology, discipline. Free-form because the shape differs by medium type; the engine does not interpret it.

preparation: Option<String>

Optional deterministic preparation step (string identifier, e.g. pdf-to-markdown). Unset for every text source today. A source that names a preparation the engine has no implementation for is refused at validation time — no silent skip, no crash.

Trait Implementations

impl Clone for Source

fn clone(&self) -> Source

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Source

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Source

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Source

impl PartialEq for Source

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Source

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 Source