Enum TuiError 

pub enum TuiError {
    CatalogNotFound {
        path: String,
    },
    CatalogParse {
        path: String,
        offset: usize,
        detail: String,
    },
    TaintedEntry {
        path: String,
        offset: usize,
        field: String,
    },
    WorkspaceNotFound {
        start: String,
    },
    InvalidWorkspace {
        path: String,
        missing: String,
    },
    RegistryParse {
        path: String,
        detail: String,
    },
    RegistryDuplicate {
        path: String,
        entries: String,
    },
    RegistryFieldMissing {
        entry: String,
        field: String,
    },
    PolicyParse {
        path: String,
        line: Option<usize>,
        detail: String,
    },
    PolicyInvalidRule {
        rule: String,
        reason: String,
    },
    GateCycle {
        gates: String,
    },
    GateConfigParse {
        path: String,
        detail: String,
    },
    PersistenceOpen {
        path: String,
        detail: String,
    },
    PersistenceMigration {
        from: u32,
        to: u32,
        detail: String,
    },
    PersistenceQuery {
        detail: String,
    },
    AuditChainBroken {
        entry_id: i64,
    },
    ConfigConflict {
        detail: String,
    },
    ConfigInvalid {
        flag: String,
        detail: String,
    },
    SubprocessFailed {
        command: String,
        code: i32,
    },
    SubprocessTimeout {
        command: String,
        timeout_secs: u64,
    },
    ValidationRejected {
        value: String,
        rule: String,
    },
    PathTraversal {
        path: String,
    },
    TerminalCapability {
        capability: String,
    },
    LogDestination {
        path: String,
        reason: String,
    },
}

Domain-specific errors with structured context.

All recoverable and non-recoverable errors the TUI can surface. Each variant includes structured context fields for precise error reporting.

Variants

CatalogNotFound

Fields

path: String

CatalogParse

Fields

path: String

offset: usize

detail: String

TaintedEntry

Fields

path: String

offset: usize

field: String

WorkspaceNotFound

Fields

start: String

InvalidWorkspace

Fields

path: String

missing: String

RegistryParse

Workspace registry TOML failed to parse. path is the registry file; line is the 1-based line number when available.

Fields

path: String

detail: String

RegistryDuplicate

Two registry entries resolve to the same canonical workspace path. entries is a human-readable description of the conflicting entries.

Fields

path: String

entries: String

RegistryFieldMissing

A required field is absent from a workspace registry entry.

Fields

entry: String

field: String

PolicyParse

Policy TOML failed to parse. line is the 1-based source line when available.

Fields

path: String

line: Option<usize>

detail: String

PolicyInvalidRule

A policy rule references a nonexistent asset, role, or uses an unsupported rule type.

Fields

rule: String

reason: String

GateCycle

Cycle detected while building the gate execution DAG. gates is the comma-separated list of gate names forming the cycle.

Fields

gates: String

GateConfigParse

The gates.toml (or equivalent) could not be parsed.

Fields

path: String

detail: String

PersistenceOpen

SQLite database file could not be opened or created.

Fields

path: String

detail: String

PersistenceMigration

Schema migration between two versions failed.

Fields

from: u32

to: u32

detail: String

PersistenceQuery

A SQLite query or statement failed at runtime. Mapped from rusqlite::Error via From.

Fields

detail: String

AuditChainBroken

Audit log hash chain integrity check failed at the given entry ID.

Fields

entry_id: i64

ConfigConflict

Two or more CLI flags or config values are mutually exclusive.

Fields

detail: String

ConfigInvalid

A specific CLI flag or config value is invalid.

Fields

flag: String

detail: String

SubprocessFailed

Fields

command: String

code: i32

SubprocessTimeout

Fields

command: String

timeout_secs: u64

ValidationRejected

Fields

value: String

rule: String

PathTraversal

Fields

path: String

TerminalCapability

Fields

capability: String

LogDestination

Fields

path: String

reason: String

Trait Implementations

impl Debug for TuiError

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

Formats the value using the given formatter.

impl Display for TuiError

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

Formats the value using the given formatter.

impl Error for TuiError

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<Error> for TuiError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for TuiError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for TuiError

Maps a rusqlite runtime error to PersistenceQuery.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for TuiError

Maps a TOML deserialization error to ConfigInvalid.

We use ConfigInvalid rather than introducing a one-off TomlParse variant because all TOML errors in this codebase surface as configuration problems (registry, policy, gates), and the existing ConfigInvalid shape (flag + detail) gives callers enough context to add the specific flag / file name at the call site. This keeps the enum focused while remaining ergonomic.

fn from(err: Error) -> Self

Converts to this type from the input type.