Enum Selector 

pub enum Selector {
    Seed,
    Relation,
    ScopePath,
    Contract,
    Governance,
    SessionState,
    IntentMatch,
}

What reached an entry. This is the provenance of the selection, and it is a different fact from the provenance of the file: Relation says the compiler followed an edge the layer declares, IntentMatch says it guessed from words. An answer that did not keep them apart could not say which half of itself to trust.

The division that matters is Selector::declared, and it is deliberately lopsided: six of the seven selectors follow something the repository states, and exactly one guesses. That ratio is the design. Inference is confined to a single selector so that the inferred part of any answer can be found, weighed and ignored, rather than being mixed through the rest at unmarked strength.

use majordomus_cli::devcontext::Selector;

// exactly one selector infers, and the answer can always be split on it
let inferred: Vec<&str> = Selector::ALL
    .iter()
    .filter(|s| !s.declared())
    .map(|s| s.as_str())
    .collect();
assert_eq!(inferred, ["intent_match"]);

// every selector has its own word, so a reason is never ambiguous
let mut words: Vec<&str> = Selector::ALL.iter().map(|s| s.as_str()).collect();
let before = words.len();
words.sort();
words.dedup();
assert_eq!(words.len(), before);

// and the word is the serialised form
assert_eq!(
    serde_json::to_value(Selector::ScopePath).unwrap(),
    serde_json::json!("scope_path"),
);

Variants

Seed

Named in the request.

Relation

Reached along a typed edge of the composed graph.

ScopePath

Its path lies under a path the request or a seed declares.

Contract

A directory contract that reaches one of those paths.

Governance

A rule or policy the layer applies to everything.

SessionState

A recorded session of this branch or of these paths, the handover the resolver chose, the newest checkpoint.

IntentMatch

Inferred: the words of the intent occur in the object’s own words.

Implementations

impl Selector

pub const ALL: &'static [Selector]

Every selector, in a stable order.

pub fn as_str(self) -> &'static str

The word this selector is reported under.

use majordomus_cli::devcontext::Selector;
assert_eq!(Selector::ScopePath.as_str(), "scope_path");

pub fn declared(self) -> bool

Did the repository state this, or did the compiler infer it? A declared selector carries confidence 1.0; an inferred one carries less, and says how much.

use majordomus_cli::devcontext::Selector;
assert!(Selector::Contract.declared());
assert!(!Selector::IntentMatch.declared());

Trait Implementations

impl Clone for Selector

fn clone(&self) -> Selector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Selector

impl Debug for Selector

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Selector

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Selector

impl JsonSchema for Selector

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Ord for Selector

fn cmp(&self, other: &Selector) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Selector

fn eq(&self, other: &Selector) -> 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 PartialOrd for Selector

fn partial_cmp(&self, other: &Selector) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Selector

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 Selector