Enum CapabilityError 

pub enum CapabilityError {
    ManifestJson(Error),
    UnknownCapability {
        external: String,
        capability: String,
    },
    LoadRejected {
        marker: &'static str,
        story: String,
        missing: Vec<MissingCapability>,
    },
}

Errors from manifest parsing or the row join.

Variants

ManifestJson(Error)

UnknownCapability

The tier-1 admission rule: a manifest-declared capability name that no register_capability call ever registered. Always a load-time error — never silently dropped (an unregistered name means the join cannot prove which ComponentId the row may touch, which would under-report access, the one direction docs/effects-spec.md §3 forbids).

Fields

external: String

capability: String

LoadRejected

Load-boundary hard error (issue #912, RULED 2026-07-18 option (b)): a story failed to load under a marker because that marker’s CapabilityRegistry is missing one or more manifest-required capabilities. Raised by bevy-brink’s fulfill_flow_requests at the story-load boundary itself — the tier-1 admission posture applied per-marker. Before this variant existed, an unregistered name only ever surfaced as a per-story [UnknownCapability] logged into CapabilityTable at call time (a silent err-table); this is the load refusing to happen at all, loudly, naming the marker, the story, and every missing capability at once (not just the first).

Fields

marker: &'static str

The marker type name (std::any::type_name::<M>()) the story was loading under.

story: String

A human-readable identifier for the story — its asset path if the handle carries one, otherwise its AssetId debug form.

missing: Vec<MissingCapability>

Every manifest-required capability name this marker’s registry doesn’t recognize, deduplicated and sorted (external, then capability).

Trait Implementations

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 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 From<Error> for CapabilityError

fn from(source: Error) -> Self

Converts to this type from the input type.