Skip to main content

Module error

Module error 

Source
Expand description

Runtime error types.

Structs§

AdmissionFailureContext
Structured context for a pre-execution admission failure: a finite-wait pooled writer checkout timeout, a bounded write-queue enqueue timeout, or a bounded storage-admission wait (reader/writer handle slot or pooled reader checkout). All happen before SQLite executes the request, so all are safe to classify as retryable — the request was never accepted, let alone started.
CircularPackDependency
Circular pack dependency detected during topological sort.
GuardedWriteFailure
A guarded edge write (link/link_many) was refused because one or both endpoints no longer existed at write time. Names the exact endpoint(s) missing instead of a generic “source or target” message, and, for a batch write, which entry in the batch failed first.
MissingPackDependencies
Multiple missing pack dependencies collected into one error.
MissingPackDependency
A single missing pack dependency.
RetryableFailureContext
Structured context for a failure that is proven safe to retry.
WriterPoolCheckoutTimeoutContext
Structured context recovered from either a direct SQLite runtime error or a typed SQLite source preserved inside a storage-driver wrapper.

Enums§

ChannelIngestFailureClass
Typed disposition for a channel message whose comm.ingest write failed.
RuntimeError
All errors produced by the khive-runtime layer.

Constants§

READ_TX_AGE_EVICTED_STAGE
Stable wire code/stage for a cached read-only transaction proactively rolled back after pinning a WAL snapshot past the configured read_tx_max_age bound (#1846). Always safe to retry: the eviction only ever fires on a read-only handle, so no side effect can exist for a retry to duplicate. Shared by both khive_storage::StorageError::ReadTransactionAgeEvicted (clean rollback) and khive_storage::StorageError::ReadTransactionAgeEvictionCleanupFailed (rollback denied or failed outright) — the rendered message field distinguishes the two; retry behavior is identical for both.
STORAGE_ADMISSION_TIMEOUT_STAGE
Stable wire code/stage for a bounded storage-admission wait (a reader/writer handle slot or a pooled reader checkout) that elapsed before anything was acquired. The operation never started, so the failure is safe to retry.
WRITER_ADMISSION_SCOPE
Stable ADR-131:251 scope discriminator carried on a WRITER_QUEUE_SATURATED_STAGE failure — distinguishes write-queue admission saturation from other unavailable failure kinds that share the same retryable: true shape but are not bounded by the admission deadline (e.g. WRITER_POOL_CHECKOUT_TIMEOUT_STAGE, which has no ADR-131-defined scope and carries None).
WRITER_POOL_CHECKOUT_TIMEOUT_STAGE
Stable ADR-135 F6 stage and wire code for a finite-wait pooled writer checkout that expires before SQLite executes.
WRITER_QUEUE_SATURATED_STAGE
Stable wire code/stage for a bounded write-queue enqueue that never accepted the request within its configured deadline (#1382, #1643).
WRITER_TASK_BEGIN_BUSY_STAGE
Stable wire code/stage for SQLite write-lock contention after the writer queue accepted a request but before its operation closure ran.

Functions§

fts_text_leg_or_err
Resolve an FTS text-leg search result, failing loud on parser syntax errors instead of silently degrading to vector-only fusion.

Type Aliases§

RuntimeResult
Convenience alias for Result<T, RuntimeError>.