Enum Fault 

pub enum Fault {
    NoMatch,
    Denied {
        reason: String,
    },
    BackendError {
        reason: String,
    },
    FlushMiss,
    PostCompactionBootstrap,
    PinnedInvariantMiss,
    DuplicateTool,
    Refetch,
}

Typed fault reason codes surfaced from context construction, recall, and writeback.

Each variant is a terminal outcome that should be logged or rendered in the audit view; none of them is an internal retry signal. Callers that want to distinguish recoverable errors from terminal faults should match on the variant.

Variants

NoMatch

The query ran to completion but produced no matching entries. Distinct from an error — this is the empty-result reason code.

Denied

The backend rejected the request (policy, auth, rate-limit).

Fields

reason: String

BackendError

The backend returned a transport / IO error.

Fields

reason: String

FlushMiss

A dirty page was dropped because the writeback protocol was skipped or bypassed.

PostCompactionBootstrap

A Bootstrap page that should have been pinned was missing after compaction / reset.

PinnedInvariantMiss

A hard-pinned page was not present at prompt-assembly time.

DuplicateTool

An equivalent tool call ran again because its previous result was evicted.

Refetch

A tool result had to be re-fetched after eviction.

Implementations

impl Fault

pub fn is_no_match(&self) -> bool

true iff the fault is the empty-result reason code.

pub fn is_denied(&self) -> bool

true iff the fault is a policy / auth rejection.

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

Short machine-readable reason-code string suitable for logs and TUI audit view filtering.

Trait Implementations

impl Clone for Fault

fn clone(&self) -> Fault

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Fault

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Fault

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Fault

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

Formats the value using the given formatter.

impl Error for Fault

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 Fault

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Fault

impl StructuralPartialEq for Fault