Enum MemoryError 

pub enum MemoryError {
    NotFound(String),
    ValidationFailed(String),
    DatabaseError(String),
    Conflict(String),
    ReflectionDepthExceeded {
        attempted: u32,
        cap: u32,
        namespace: String,
    },
    SynthesisDepthExceeded {
        attempted: u32,
        cap: u32,
        namespace: String,
    },
    ReflectionCycleDetected {
        source: String,
        target: String,
        cycle_path: Vec<String>,
    },
    RefusedByGovernance(String),
    RefusedByGovernanceGate(GovernanceRefusal),
}

Variants

NotFound(String)

ValidationFailed(String)

DatabaseError(String)

Conflict(String)

ReflectionDepthExceeded

v0.7.0 recursive-learning Task 4/8 (issue #655) — emitted by the memory_reflect write path when the proposed reflection’s depth exceeds the resolved namespace crate::models::GovernancePolicy::effective_max_reflection_depth cap. The variant carries the structured triple so Task 5/8 can match on it without parsing a string, then emit a signed_events audit row for the refusal decision.

Wire shape (HTTP): 409 CONFLICT with code REFLECTION_DEPTH_EXCEEDED.

Fields

attempted: u32

cap: u32

namespace: String

SynthesisDepthExceeded

Issue #1240 (HIGH) — emitted by the memory_store write path when the synthesis-pass recursion depth (post-store hooks that fire further memory_store calls, e.g. via curator chain-fire) exceeds the compiled-in cap of 3. Mirrors the Self::ReflectionDepthExceeded variant so audit + wire shape stay symmetric across the two recursive-write primitives.

Wire shape (HTTP): 409 CONFLICT with code SYNTHESIS_DEPTH_EXCEEDED.

Fields

attempted: u32

cap: u32

namespace: String

ReflectionCycleDetected

v0.7.0 L1-2 (issue #659) — emitted by the memory_link write path when adding a reflects_on edge would close a cycle in the reflection graph. Carries source, target, and the reconstructed cycle_path (ordered source → … → source) for the audit row and the operator-readable error message.

Wire shape (HTTP / MCP): surfaced as a String error at the MCP layer with code REFLECTION_CYCLE_DETECTED.

Fields

source: String

target: String

cycle_path: Vec<String>

RefusedByGovernance(String)

v0.7.0 L1-6 Deliverable E (issue #691) — emitted by crate::storage::insert, crate::storage::insert_with_conflict, and crate::storage::insert_if_newer when the optional crate::storage::GOVERNANCE_PRE_WRITE hook returns Err(reason). The hook is installed once at daemon serve boot and consults the substrate’s signed governance_rules table via governance::agent_action::check_agent_action against a synthetic Custom { custom_kind = "memory_write" } action; a Refuse decision short-circuits the SQL INSERT cleanly (no row written, no partial state).

The hook is NOT installed in CLI one-shot mode — operator-direct CLI invocations stay unimpeded by design (operator standing directive: rules gate AGENT writes, not the operator’s own hands-on substrate ops).

Wire shape (HTTP): 403 FORBIDDEN with code GOVERNANCE_REFUSED. Carries the operator-authored reason from the matching governance_rules.reason column verbatim.

RefusedByGovernanceGate(GovernanceRefusal)

#963 Phase 2 — substrate gate-evaluator refusal (crate::storage::enforce_governance / Store::enforce_governance_action). Distinguished from Self::RefusedByGovernance (the substrate pre-write hook) by carrying the typed crate::governance::GovernanceRefusal envelope so handlers can surface denied_level / namespace / owner in HTTP / MCP / CLI responses without re-parsing the wire message.

Wire shape (HTTP): 403 FORBIDDEN with code GOVERNANCE_REFUSED. The message() is the canonical envelope Display ("<action> denied by governance: <reason>"), byte-identical to the pre-#963 free-form Deny(String) wire shape.

Implementations

impl MemoryError

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

pub fn status(&self) -> StatusCode

pub fn message(&self) -> String

Trait Implementations

impl Debug for MemoryError

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

Formats the value using the given formatter.

impl Display for MemoryError

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

Formats the value using the given formatter.

impl From<Error> for MemoryError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MemoryError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl IntoResponse for MemoryError

fn into_response(self) -> Response

Create a response.