Enum EngineError 

#[non_exhaustive]
pub enum EngineError {
    DeadlineExceeded {
        partial_lint: LintResult,
    },
    InvalidThreshold(InvalidThreshold),
}

Runtime errors from Engine::lint_with_options / Engine::fix_with_options (spec 005).

Distinct from EngineConstructionError by design — construction errors are build-time configuration defects the integrator fixes before shipping; EngineError reports runtime conditions (a per-call deadline expired, a per-call threshold override is out of range) the caller can react to. Keeping the two enums separate means matching on one does not force callers to pattern against build-time variants they could never encounter at request time.

#[non_exhaustive] so future runtime conditions (memory budget exceeded, per-rule deadline expired, cancellation token tripped) can land without a semver-breaking change.

Spec §R5 (asymmetric response shape): the lint path does not return EngineError::DeadlineExceeded on its own — partial lint results are surfaced through LintResult.truncated instead, so the caller can render whatever diagnostics were produced before the abort. Only fix_with_options raises DeadlineExceeded, because a partial FixResult would commit half a fix to the audit stream (Constitution V Principle V).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

DeadlineExceeded

fix_with_options aborted before applying every fix because the call’s deadline expired. partial_lint is the LintResult that the lint pass produced before the abort — callers can render its diagnostics to the user even though no fixes were committed. partial_lint.truncated indicates whether the lint pass itself was also truncated (deadline expired during scanning) versus the fix-application loop (lint pass completed, fixes did not).

Carries the lint result by value (not boxed) because the happy path returns Ok(FixResult) and the size penalty on the error variant is paid only on the cold path.

Fields

partial_lint: LintResult

InvalidThreshold(InvalidThreshold)

fix_with_options rejected the per-call confidence threshold override. Wraps the existing standalone InvalidThreshold struct so Engine::fix_with_threshold can keep its Result<FixResult, InvalidThreshold> public signature unchanged while internally routing through fix_with_options.

Trait Implementations

impl Debug for EngineError

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

Formats the value using the given formatter.

impl Display for EngineError

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

Formats the value using the given formatter.

impl Error for EngineError

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<InvalidThreshold> for EngineError

fn from(value: InvalidThreshold) -> Self

Converts to this type from the input type.