Enum LuciError 

pub enum LuciError {
    Io(Error),
    IndexNotFound(String),
    IndexCorrupted(String),
    WriterLocked,
    SchemaConflict {
        field: String,
        expected: String,
        actual: String,
    },
    UnsupportedQuery(String),
    InvalidQuery(String),
    InvalidValue(String),
    TransactionActive,
    QueryBehaviorDifference {
        feature: String,
        difference: String,
    },
    SegmentFormatMigrationRequired(String),
    SegmentFormatUnknown(String),
}

Top-level error type for all Luci operations.

Designed to map cleanly across the FFI boundary to Python exceptions. See [[architecture-api-surface#Error Handling]].

Variants

Io(Error)

Underlying I/O error.

IndexNotFound(String)

Index file does not exist at the given path.

IndexCorrupted(String)

Index file failed checksum validation — data is corrupt. See [[architecture-storage-format#Crash Recovery]].

WriterLocked

Another IndexWriter holds the file lock. See [[architecture-concurrency-model#Single-Writer Model]].

SchemaConflict

Document field type conflicts with the schema mapping.

Fields

field: String

expected: String

actual: String

UnsupportedQuery(String)

Query type is recognized but not yet implemented.

InvalidQuery(String)

Query JSON is malformed or fails validation.

InvalidValue(String)

A field value cannot be stored as specified — e.g. a keyword or _id whose UTF-8 length exceeds the 65535-byte columnar dictionary limit. Rejected at indexing time rather than silently truncated ([[code-must-not-lie]]). See [[optimization-keyword-dict-offset-index]].

TransactionActive

Write attempted on Index while a transaction is active on the same thread. Use txn.add() instead of index.add().

QueryBehaviorDifference

ES query feature that Luci implements with different behavior. The query will NOT execute — users must acknowledge the difference.

Fields

feature: String

difference: String

SegmentFormatMigrationRequired(String)

HNSW segment is in a recognized older format but requires user-driven migration (re-index). Used for the v0.7.1 → v0.7.2 cosine format break.

SegmentFormatUnknown(String)

HNSW segment carries an unknown format version byte. Most likely a future-format file opened by an older Luci binary.

Trait Implementations

impl Debug for LuciError

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

Formats the value using the given formatter.

impl Display for LuciError

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

Formats the value using the given formatter.

impl Error for LuciError

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 LuciError

fn from(e: Error) -> Self

Converts to this type from the input type.