Struct Facet 

pub struct Facet {
    pub name: String,
    pub medium: String,
    pub scope: Vec<PatternEntry>,
    pub engagement: Option<Value>,
    pub preparation: Option<String>,
}

A Facet — a named way a projection engages with a Medium: the subset in reach, the engagement contract, and an optional preparation step.

The facet record is deliberately heterogeneous (a source facet typically carries scope + preparation; a destination facet carries engagement discipline) — forcing a uniform shape would smuggle complexity elsewhere. The single-type-with-optional-fields modelling is chosen for machinery simplicity (concept-doc Open Question 2); the engagement contract stays a free-form JSON value because its shape is medium-type- and side-specific (verbs, tools, terminology, discipline) and is not load-bearing for the loader’s structural validation.

Fields

name: String

Stable name — projections reference a facet by this.

medium: String

The Medium (by name) this facet is a perspective on. A facet always references exactly one medium.

scope: Vec<PatternEntry>

Allow/deny selection over the referenced medium. Empty = whole medium.

engagement: Option<Value>

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

preparation: Option<String>

Optional deterministic preparation step (string identifier, e.g. pdf-to-markdown). Unset for every text medium today. A facet that names a preparation the engine has no implementation for is accepted at rest but reported unsupported at run time — no silent skip, no crash.

Trait Implementations

impl Clone for Facet

fn clone(&self) -> Facet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Facet

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Facet

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Facet

impl PartialEq for Facet

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Facet

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 Facet