Enum LmsError 

pub enum LmsError {
    StrategyExecutionFailure {
        pipeline_step: String,
        context: String,
        reason: String,
    },
    MissingTrait {
        pipeline_step: String,
        trait_key: String,
        reason: String,
    },
    InvalidTag {
        pipeline_step: String,
        tag: String,
        reason: String,
    },
    ResolutionFailed {
        pipeline_step: String,
        tag: String,
        reason: String,
    },
    IntegrityViolation {
        pipeline_step: String,
        context: String,
        reason: String,
    },
    SecurityFault {
        pipeline_step: String,
        context: String,
        reason: String,
    },
    PersistenceFault {
        pipeline_step: String,
        context: String,
        reason: String,
    },
    RuleSynthesisFailure {
        pipeline_step: String,
        context: String,
        reason: String,
    },
    ResourceResolutionFailure {
        pipeline_step: String,
        context: String,
        reason: String,
    },
    ExtensionMappingFailure {
        pipeline_step: String,
        context: String,
        reason: String,
    },
}

The universal error type for the Bistun LMS pipeline.

Time: O(1) (Definition) | Space: O(1)

Logic Trace (Internal)

1. Associates standard pipeline failures with explicit context fields.
2. Derives standard std::error::Error and std::fmt::Display via thiserror.

Examples

use crate::bistun_core::LmsError;

let err = LmsError::MissingTrait {
    pipeline_step: "Phase 2: Aggregation".to_string(),
    trait_key: "MORPHOLOGY_TYPE".to_string(),
    reason: "Golden Set baseline breached".to_string(),
};

assert_eq!(
    err.to_string(),
    "[Phase 2: Aggregation] Missing Trait (MORPHOLOGY_TYPE): Golden Set baseline breached"
);

Variants

StrategyExecutionFailure

Raised when a linguistic algorithm fails to process the input string.

Fields

pipeline_step: String

Where did it fail? (e.g., “Phase 4: Stemming Strategy”)

context: String

What failed? (e.g., the input word or language tag)

reason: String

Why did it fail? (e.g., “Invalid UTF-8 sequence”)

MissingTrait

Raised when the CapabilityManifest lacks a required trait during resolution.

Fields

pipeline_step: String

Where did it fail? (e.g., “Phase 2: Aggregation”)

trait_key: String

What failed? (e.g., “PRIMARY_DIRECTION”)

reason: String

Why did it fail? (e.g., “Script Definition lacks fallback”)

InvalidTag

Raised when a BCP 47 tag is mathematically invalid or unparseable.

Fields

pipeline_step: String

Where did it fail? (e.g., “Phase 1: Taxonomic Resolution”)

tag: String

What failed? (The raw tag, e.g., “en-US-u-foo-bar”)

reason: String

Why did it fail? (e.g., “Malformed Unicode extension subtag”)

ResolutionFailed

Raised when the Taxonomic Engine fails to resolve a locale, exhausting the fallback chain.

Fields

pipeline_step: String

Where did it fail? (e.g., “Phase 1: Taxonomic Resolution”)

tag: String

What failed? (e.g., the missing canonical tag)

reason: String

Why did it fail? (e.g., “Exhausted fallback chain without finding a registry entry”)

IntegrityViolation

Raised when a capability manifest fails structural or typological integrity checks.

Fields

pipeline_step: String

Where did it fail? (e.g., “Phase 4: Integrity Check”)

context: String

What failed? (e.g., the canonical locale ID being verified)

reason: String

Why did it fail? (e.g., “Bidirectional text inherently requires complex shaping logic”)

SecurityFault

Raised when registry signature verification or WORM state fails.

Fields

pipeline_step: String

Where did it fail? (e.g., “Phase 0: WORM Hydration”)

context: String

What failed? (e.g., the registry snapshot payload)

reason: String

Why did it fail? (e.g., “Ed25519 signature mismatch”)

PersistenceFault

Raised when the WORM snapshot cannot be read or contains a structural persistence breach.

Fields

pipeline_step: String

Where did it fail? (e.g., “Phase 0: WORM Hydration”)

context: String

What failed? (e.g., the file path or URI)

reason: String

Why did it fail? (e.g., “Snapshot checksum mismatch”)

RuleSynthesisFailure

Raised when Phase 2 (Aggregation) fails to synthesize algorithmic rules due to unresolvable conflicts.

Fields

pipeline_step: String

Where did it fail? (e.g., “Phase 2: Typology Aggregation”)

context: String

What failed? (e.g., “PLURAL_LOGIC”)

reason: String

Why did it fail? (e.g., “Conflicting plural categories without a clear High-Water Mark”)

ResourceResolutionFailure

Raised when Phase 2.5 (Resource Bridge) cannot map an abstract Resource ID to a physical URI.

Fields

pipeline_step: String

Where did it fail? (e.g., “Phase 2.5: Resource Bridge”)

context: String

What failed? (e.g., “icu_arab”)

reason: String

Why did it fail? (e.g., “Resource ID not found in deployment map”)

ExtensionMappingFailure

Raised when Phase 3 (Override) encounters a malformed or unsupported BCP 47 extension subtag.

Fields

pipeline_step: String

Where did it fail? (e.g., “Phase 3: Extension Override”)

context: String

What failed? (e.g., “-u-nu-invalid”)

reason: String

Why did it fail? (e.g., “Unsupported numbering system requested”)

Trait Implementations

impl Clone for LmsError

fn clone(&self) -> LmsError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LmsError

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

Formats the value using the given formatter.

impl Display for LmsError

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

Formats the value using the given formatter.

impl Error for LmsError

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 LmsError

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

impl StructuralPartialEq for LmsError