Struct AdmissionFailureContext 

pub struct AdmissionFailureContext {
    pub stage: &'static str,
    pub timeout: Duration,
    pub capability: Option<StorageCapability>,
    pub operation: Option<String>,
    pub pool_identity: Option<String>,
    pub scope: Option<&'static str>,
    pub retry_after_ms: Option<u64>,
}

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.

Fields

stage: &'static str

Stable wire stage/code: one of WRITER_POOL_CHECKOUT_TIMEOUT_STAGE, WRITER_QUEUE_SATURATED_STAGE, or STORAGE_ADMISSION_TIMEOUT_STAGE.

timeout: Duration

The configured deadline that elapsed.

capability: Option<StorageCapability>

Storage capability the request was scoped to, when known. The write queue is process-local and unscoped by capability, so this is None for WRITER_QUEUE_SATURATED_STAGE.

operation: Option<String>

Storage operation name, when known.

pool_identity: Option<String>

Database identity supplied by the pool that refused admission, when known.

scope: Option<&'static str>

ADR-131:251 scope discriminator. Some(WRITER_ADMISSION_SCOPE) for WRITER_QUEUE_SATURATED_STAGE; None for WRITER_POOL_CHECKOUT_TIMEOUT_STAGE, which ADR-131 does not define a scope for.

retry_after_ms: Option<u64>

ADR-131:251 retry_after_ms hint — set equal to the admission deadline actually applied to the rejected operation, so a retrying caller waits at least one full admission window before retrying. Some(timeout_ms) for WRITER_QUEUE_SATURATED_STAGE; None otherwise.

Trait Implementations

impl Clone for AdmissionFailureContext

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AdmissionFailureContext

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

Formats the value using the given formatter.

impl Eq for AdmissionFailureContext

impl From<AdmissionFailureContext> for RetryableFailureContext

fn from(context: AdmissionFailureContext) -> Self

Converts to this type from the input type.

impl PartialEq for AdmissionFailureContext

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for AdmissionFailureContext