Enum BootError 

pub enum BootError {
    NotInitialised(PathBuf),
    Store(StoreError),
    Instantiate(InstantiateError),
    Engine(EngineError),
}

Errors surfaced by [Engine::from_workspace_root] (lean) and its full counterpart (memstead_git_branch::engine_from_workspace_root).

The boot path layers three error sources: layout detection, workspace-store load failures, per-mount backend instantiation (folder + archive vs git-branch), and engine construction (duplicate-mem checks). #[from] lifts the lower-layer types so callers branch on a single error envelope.

Variants

NotInitialised(PathBuf)

detect_layout returned crate::Layout::Empty — workspace root has no recognised layout marker. Operator runs memstead mem-repo init rather than booting against an empty directory.

Store(StoreError)

Underlying crate::WorkspaceStoreAdapter load failed (missing config file, parse error, format-mismatch).

Instantiate(InstantiateError)

Per-mount backend instantiation failed. Today: a mount declared MountStorage::GitBranch while the lean boot path only knows folder + archive.

Engine(EngineError)

Engine construction failed (duplicate mem names, etc.).

Implementations

impl BootError

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

Stable, surface-independent error code token (UPPER_SNAKE, per the EngineError::code convention). Every boot failure class resolves to a typed code — INTERNAL is not producible from this seam. The wrapped layers each own their vocabulary: store-load failures delegate to crate::workspace_store::StoreError::code, backend instantiation to crate::workspace_store::InstantiateError::code, engine construction to EngineError::code.

pub fn details(&self) -> Value

Structured recovery payload for the boot failure, surfacing under error.details on --json envelopes. Engine-layer failures reuse EngineError::details (so e.g. a boot-time SCHEMA_NOT_FOUND ships the same details.sources trail the per-verb surfaces ship); the other layers name the offending path.

pub fn surface_message(&self, workspace_root: &Path) -> String

The one boot-failure message every surface prints verbatim (CLI stderr / --json, MCP boot diagnostics), so the same broken workspace reads identically wherever it refuses. The leaf error’s own message carries the repair command (or states plainly that none exists).

Trait Implementations

impl Debug for BootError

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

Formats the value using the given formatter.

impl Display for BootError

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

Formats the value using the given formatter.

impl Error for BootError

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 From<EngineError> for BootError

fn from(source: EngineError) -> Self

Converts to this type from the input type.

impl From<InstantiateError> for BootError

fn from(source: InstantiateError) -> Self

Converts to this type from the input type.

impl From<StoreError> for BootError

fn from(source: StoreError) -> Self

Converts to this type from the input type.