Enum CapabilityError 

pub enum CapabilityError {
    EmptySourceName,
    DuplicateSourceName {
        name: String,
    },
    OperationOutOfScope {
        operation: &'static str,
        source_name: String,
        medium_type: String,
    },
    GraphScopeNotEntitySelector {
        source_name: String,
        pattern: String,
    },
    ScopeNotInterpretable {
        source_name: String,
        pattern: String,
        medium_type: String,
    },
    GlobDenyIllegal {
        source_name: String,
        medium_type: String,
        anchor_namespace: &'static str,
    },
    PreparationUnsupported {
        source_name: String,
        preparation: String,
        impl_version: u32,
    },
    PreparationGrainMismatch {
        source_name: String,
        preparation: String,
        medium_type: String,
        anchor_namespace: &'static str,
    },
    CoverageExhaustiveUnsupported {
        source_name: String,
        medium_type: String,
    },
    PruneGuaranteeUnsupported {
        source_name: String,
        medium_type: String,
        requested: &'static str,
        supported: &'static str,
    },
}

A validation-time refusal: a capability the source’s medium half cannot support, or a malformed in-record source declaration. Every refusal names the offending source so it is diagnosable without re-reading the store.

Variants

EmptySourceName

A source has an empty name — the name keys per-source sync/verify state, so it must be present.

DuplicateSourceName

Two sources in the record share a name — per-source state keys would collide.

Fields

name: String

The colliding name.

OperationOutOfScope

A sync / verify operation is declared over a medium that cannot support it this cycle (a web source — operator decision 7). The out-of-scope statement is said out loud, never a silent mtime-over-URL.

Fields

operation: &'static str

The offending operation.

source_name: String

The source declaring it.

medium_type: String

The medium type that cannot support the operation.

GraphScopeNotEntitySelector

A graph source’s scope carries a pattern the entity-namespace vocabulary does not define. Refused at declaration rather than silently selecting nothing: a scope that looks like selection but reaches nothing is the defect this rule exists to prevent.

Fields

source_name: String

The source declaring it.

pattern: String

The offending pattern, verbatim.

ScopeNotInterpretable

A source’s scope carries a pattern its medium has no vocabulary to express at all, so nothing anywhere can interpret it. Distinct from Self::GraphScopeNotEntitySelector, which names the legal forms because a legal form exists; here there is none, so the only honest scope is no scope.

Fields

source_name: String

The source declaring it.

pattern: String

The offending pattern, verbatim.

medium_type: String

The medium with no scope vocabulary.

GlobDenyIllegal

Glob deny_paths are declared over a medium whose namespace is not path-shaped (graph, web) — a glob cannot select in that namespace.

Fields

source_name: String

The offending source.

medium_type: String

The medium type whose namespace is not path-shaped.

anchor_namespace: &'static str

That medium’s anchor namespace.

PreparationUnsupported

A source declares a preparation identifier the engine’s preparation registry (crate::preparation) does not know. The refusal is exactly “not in this engine’s registry”: a registered identifier validates clean, an unknown one refuses, and the message names the registered set.

Raised by validate_binding, which the edit/validate paths call — NOT projection init (which has no --preparation flag). The brief renderer mirrors the same rule for a record that acquired an unknown identifier by hand (accepted at rest, reported unsupported and skipped at run time with exit 0; see GLOSSARY.md and crate::pipeline::Source::preparation), so both refusal paths carry one semantics and move together.

Fields

source_name: String

The offending source.

preparation: String

The declared preparation identifier.

impl_version: u32

The current preparation-implementation version.

PreparationGrainMismatch

A registered preparation is declared over a medium whose anchor namespace admits none of the grains it prepares (entity-load-bearing over a codebase source). It would never meet an anchor it applies to, so the declaration is refused at validation rather than accepted and silently never applying.

Fields

source_name: String

The offending source.

preparation: String

The declared (registered) preparation identifier.

medium_type: String

The medium type it was declared over.

anchor_namespace: &'static str

That medium’s anchor namespace.

CoverageExhaustiveUnsupported

The binding declares coverage_semantics: exhaustive while at least one source sits on a medium whose scope the engine cannot enumerate (web) — S(D) is not computable, so exhaustive coverage cannot be asserted over it. Refused at binding-validation time with curated as the remedy. An undeclared field never trips this: it resolves per medium via effective_coverage_semantics.

Fields

source_name: String

The offending source.

medium_type: String

The medium type whose scope is not enumerable.

PruneGuaranteeUnsupported

The binding requests a prune guarantee the source’s medium cannot support (F1) — never-clobber over a medium whose base leg is not retrievable (web). Refused at binding-validation time with the downgrade remedy, never discovered at run time.

Fields

source_name: String

The offending source.

medium_type: String

The medium type that cannot support the requested guarantee.

requested: &'static str

The requested guarantee wire string.

supported: &'static str

The strongest guarantee this medium supports (the downgrade remedy).

Trait Implementations

impl Clone for CapabilityError

fn clone(&self) -> CapabilityError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CapabilityError

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

Formats the value using the given formatter.

impl Display for CapabilityError

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

Formats the value using the given formatter.

impl Eq for CapabilityError

impl Error for CapabilityError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for CapabilityError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CapabilityError