Enum CliError 

pub(crate) enum CliError {
    IndexWork(IndexWorkFailure),
    Db(DbError),
    Service(ServiceError),
    Fs(FsError),
    Io {
        path: PathBuf,
        source: Error,
    },
    Output(Error),
    Json(Error),
    Mcp(String),
    Watcher(String),
    AtlasMap(AtlasMapError),
    ParserPack(OptionalParserPackLifecycleError),
    OptionalParserOperationAndCleanup {
        operation: Box<Self>,
        cleanup: Box<Self>,
    },
    PurposeMutationRollback {
        operation: Box<Self>,
        rollback: DbError,
    },
    InvalidInput(String),
    InitRequired(Box<IndexInitRequired>),
    WorktreeRequired(Box<ProjectWorktreeRequired>),
    RefreshRequired(Box<IndexRefreshRequired>),
    VerificationIncomplete(Box<IndexVerificationIncomplete>),
    ProjectMismatch(Box<IndexProjectMismatch>),
    RootTransitionFollowup {
        root: Option<String>,
        transition: RootTransition,
        message: String,
        source: Box<CliError>,
    },
}

Error type for CLI boundary failures.

Variants

IndexWork(IndexWorkFailure)

Cooperative index work was canceled or exceeded a declared bound.

Db(DbError)

Database operation failed.

Service(ServiceError)

Shared service operation failed.

Fs(FsError)

Filesystem scanner operation failed.

Io

File or directory operation failed.

Fields

path: PathBuf

Path involved in the IO failure.

source: Error

Source IO error.

Output(Error)

Output stream write failed.

Json(Error)

JSON serialization failed.

Mcp(String)

MCP runtime failed.

Watcher(String)

Watcher runtime failed.

AtlasMap(AtlasMapError)

Atlas map operation failed.

ParserPack(OptionalParserPackLifecycleError)

Optional parser-pack lifecycle operation failed.

OptionalParserOperationAndCleanup

Optional parsing failed and the requested process cleanup also failed.

Fields

operation: Box<Self>

Original staging or parser failure.

cleanup: Box<Self>

Cleanup failure observed before releasing process ownership.

PurposeMutationRollback

Purpose mutation failed and its mandatory rollback also failed.

Fields

operation: Box<Self>

Original mutation, freshness, or cancellation failure.

rollback: DbError

Storage failure observed while rolling the transaction back.

InvalidInput(String)

User input was invalid.

InitRequired(Box<IndexInitRequired>)

The selected source root has not been initialized.

WorktreeRequired(Box<ProjectWorktreeRequired>)

A bare/common Git directory was selected instead of checked-out source.

RefreshRequired(Box<IndexRefreshRequired>)

Current local source differs from the durable index.

VerificationIncomplete(Box<IndexVerificationIncomplete>)

Current local source could not be verified completely.

ProjectMismatch(Box<IndexProjectMismatch>)

The selected project root does not own the opened index.

RootTransitionFollowup

A durable root transition committed before generated configuration failed.

Fields

root: Option<String>

Lossless root display when the host can represent the committed native identity.

transition: RootTransition

Durable transition that already completed.

message: String

Recovery guidance that never substitutes a lossy root display.

source: Box<CliError>

Follow-up configuration failure.

Trait Implementations

impl Debug for CliError

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

Formats the value using the given formatter.

impl Display for CliError

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

Formats the value using the given formatter.

impl Error for CliError

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<AtlasMapError> for CliError

fn from(source: AtlasMapError) -> Self

Converts to this type from the input type.

impl From<DbError> for CliError

fn from(source: DbError) -> Self

Converts to this type from the input type.

impl From<Error> for CliError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CliError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FsError> for CliError

fn from(source: FsError) -> Self

Converts to this type from the input type.

impl From<GraphContractError> for CliError

fn from(error: GraphContractError) -> Self

Converts to this type from the input type.

impl From<IndexWorkFailure> for CliError

fn from(source: IndexWorkFailure) -> Self

Converts to this type from the input type.

impl From<OptionalParserPackLifecycleError> for CliError

fn from(source: OptionalParserPackLifecycleError) -> Self

Converts to this type from the input type.

impl From<ServiceError> for CliError

fn from(source: ServiceError) -> Self

Converts to this type from the input type.