Enum DbError 

pub enum DbError {
    Open {
        path: PathBuf,
        source: Error,
    },
    PrepareDir {
        path: PathBuf,
        source: Error,
    },
    Pragma(Error),
    Schema(Error),
    RagSchema(Error),
    BackupFailed {
        path: PathBuf,
        source: Error,
    },
    EmbeddingDimension(Error),
    SchemaDrift {
        expected: u32,
        stored: u32,
    },
    Sqlite(Error),
}

Typed errors for the database-open and schema-migration paths.

The rest of the query API still returns anyhow::Result for now; this enum exists so callers (the binary, MCP server, plugin authors) can pattern-match on the actionable failure modes around opening a database — especially distinguishing a corrupt file from a missing one from a schema incompatibility. A From<DbError> impl on anyhow::Error is provided automatically by the trait blanket, so existing ?-based call sites keep working unchanged.

Variants

Open

Failure opening or creating the SQLite file itself (permission denied, path missing, disk full, etc.).

Fields

path: PathBuf

source: Error

PrepareDir

Failure preparing the on-disk layout (e.g. could not create the .cartog/ parent directory).

Fields

path: PathBuf

source: Error

Pragma(Error)

Could not apply one of the startup PRAGMAs (journal_mode, WAL, …).

Schema(Error)

Could not apply the CREATE TABLE IF NOT EXISTS schema bootstrap.

RagSchema(Error)

Could not create or migrate the RAG (FTS + vector) tables.

BackupFailed

Pre-migration backup via VACUUM INTO failed.

Fields

path: PathBuf

source: Error

EmbeddingDimension(Error)

Embedding-dimension reconciliation failed (the stored symbol_vec shape didn’t match the requested one and we couldn’t rebuild it).

SchemaDrift

Read-only attach found a schema_version on disk that this binary doesn’t know how to query. The primary writer was upgraded to a newer cartog; the read-only client should exit cleanly and let the user restart against the new version.

Fields

expected: u32

stored: u32

Sqlite(Error)

A catch-all for other rusqlite-level failures inside open — use more specific variants whenever they fit.

Trait Implementations

impl Debug for DbError

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

Formats the value using the given formatter.

impl Display for DbError

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

Formats the value using the given formatter.

impl Error for DbError

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 DbError

fn from(source: Error) -> Self

Converts to this type from the input type.