Enum AtomiseError 

pub enum AtomiseError {
    NotFound,
    AlreadyAtomised {
        source_id: String,
        existing_atom_ids: Vec<String>,
    },
    TierLocked,
    CuratorFailed(String),
    SourceTooSmall,
    GovernanceRefused(String),
    SignerError(String),
    DbError(String),
    DepthExceeded {
        attempted: u32,
        cap: u32,
    },
}

Typed error surface for Atomiser::atomise.

Carries enough structured payload that the MCP / HTTP / CLI wrappers can render a clean operator-readable message without re-querying the DB.

Variants

NotFound

Source memory id does not exist (or has been hard-deleted).

AlreadyAtomised

Source has already been atomised. existing_atom_ids is the set of atom ids currently pointing at this source via atom_of. Caller may surface them or re-issue with force = true to mint a fresh set.

Fields

source_id: String

existing_atom_ids: Vec<String>

TierLocked

The daemon’s resolved feature tier is Keyword — atomisation requires the curator LLM (Smart or Autonomous). The MCP surface maps this to a 503-style refusal.

CuratorFailed(String)

Curator round-trip exhausted retries. Carries the last parse diagnostic so the caller can render it.

SourceTooSmall

Source body is already at or under max_atom_tokens — no productive decomposition possible. The caller may surface the source as-is. Distinct from AlreadyAtomised: this is the “never worth atomising” verdict, the latter is the “already done” verdict.

GovernanceRefused(String)

A pre_store substrate hook refused atom index (zero-based into the curator’s atom list). Prior atoms (indices < index) were already committed and are NOT rolled back — see module docs for the rationale.

SignerError(String)

Signer error during a per-atom or per-link write. Carries the underlying diagnostic.

DbError(String)

Database error (SQL, transaction commit, etc.). Carries the underlying diagnostic.

DepthExceeded

ARCH-5 (FX-6) — emitted when the recursive atomisation depth exceeds MAX_ATOMISATION_DEPTH. A curator that chain-fires an atomise on each derived atom (e.g. via an aggressive pre_store auto-atomise hook that itself triggers another atomise) is bounded by the thread-local depth guard installed by enter_atomisation_pass. Past the cap the substrate refuses with this typed variant, surfacing the stable ATOMISATION_DEPTH_EXCEEDED slug to MCP / HTTP / CLI callers.

Mirrors the crate::errors::MemoryError::ReflectionDepthExceeded + crate::errors::MemoryError::SynthesisDepthExceeded contract so the recursive-primitive discipline is uniform across the substrate’s recursive write paths.

Fields

attempted: u32

cap: u32

Trait Implementations

impl Debug for AtomiseError

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

Formats the value using the given formatter.

impl Display for AtomiseError

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

Formats the value using the given formatter.

impl Error for AtomiseError

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.