Enum ReflectError 

pub enum ReflectError {
    Validation(String),
    SourceNotFound(String),
    DepthExceeded {
        attempted: u32,
        cap: u32,
        namespace: String,
    },
    HookVeto {
        reason: String,
        code: i32,
    },
    Database(String),
}

Typed substrate-level error surface for reflect. Kept distinct from crate::errors::MemoryError so the SQLite substrate layer stays free of HTTP-status concerns; the caller at the MCP / HTTP boundary maps these into the wire-shaped variant. Task 5/8 matches on ReflectError::DepthExceeded here (and the equivalent MemoryError::ReflectionDepthExceeded variant) to emit the signed_events audit record for the refusal decision.

Variants

Validation(String)

Input violated a validator. Carries the operator-readable reason; the MCP layer surfaces it verbatim.

SourceNotFound(String)

One of the requested source memories does not exist. Carries the offending id so the caller can name the missing source.

DepthExceeded

Proposed reflection depth exceeds the resolved namespace cap. The triple is the structured payload Task 5/8 will attach to the audit row.

Fields

attempted: u32

cap: u32

namespace: String

HookVeto

v0.7.0 recursive-learning Task 6/8 — a pre_reflect hook callback returned ReflectHookDecision::Deny, vetoing the reflection. Distinct from DepthExceeded because the substrate cap was NOT evaluated (the veto fires earlier in step 4) and because the Task 5 depth-cap audit row is NOT emitted on this path — hook vetoes are caller-policy refusals that carry their own provenance via the hook’s own decision record (if any).

Fields

reason: String

code: i32

Database(String)

Database error during the atomic write. Carries the underlying rusqlite / anyhow string.

Trait Implementations

impl Debug for ReflectError

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

Formats the value using the given formatter.

impl Display for ReflectError

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

Formats the value using the given formatter.

impl Error for ReflectError

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.