Enum LifecycleError 

pub enum LifecycleError {
    NotFound {
        env_id: EnvId,
        revision_id: RevisionId,
    },
    InvalidTransition {
        from: RevisionLifecycle,
        to: RevisionLifecycle,
    },
    Conflict {
        revision_id: RevisionId,
        actual: RevisionLifecycle,
        expected_starts: Vec<RevisionLifecycle>,
    },
    EmptyChain,
    ActiveTrafficReference {
        revision_id: RevisionId,
        splits: Vec<ActiveSplitRef>,
    },
    HealthGateFailed {
        revision_id: RevisionId,
        failed_checks: Vec<HealthCheckId>,
        message: String,
    },
    Store(StoreError),
}

Errors produced by apply_revision_transition. Cleanly maps onto cli::OpError via the From impl in cli/mod.rs. The storage-free variants mirror RevisionLifecycleError 1:1 (see the From impl below); LifecycleError::Store is the local-storage addition.

Variants

NotFound

The targeted revision was not present in the loaded environment.

Fields

env_id: EnvId

revision_id: RevisionId

InvalidTransition

The spec matrix rejected an edge inside the requested chain. This is a programming error in the caller, not a runtime conflict — the helper should never see this in production because every chain passed in from cli::revisions is hand-curated. Surfaced as a distinct variant so call sites can choose to panic in debug.

Fields

from: RevisionLifecycle

to: RevisionLifecycle

Conflict

The revision was loaded in a state that does not start any edge in the accepted chain. actual carries the lifecycle the helper found; expected_starts lists the from states of each accepted edge so callers can render a useful error.

Fields

revision_id: RevisionId

actual: RevisionLifecycle

expected_starts: Vec<RevisionLifecycle>

EmptyChain

The caller passed an empty accepted_chain. Internal-API misuse.

ActiveTrafficReference

The archive path (prune_from_splits = true) was invoked against a revision still referenced by one or more live traffic splits. Blindly pruning the entry would either silently drop the route (100%-single-entry split) or produce a split whose weights no longer sum to 10,000 bps (the spec invariant), so the helper refuses. Callers must rebalance traffic via gtc op traffic set before retrying. splits carries the offending references for rendering an actionable error.

Fields

revision_id: RevisionId

splits: Vec<ActiveSplitRef>

HealthGateFailed

The warm/ready health gate rejected the revision after the chain reached its final state. The helper has flipped the revision’s lifecycle to Failed and persisted the env before surfacing this error, so the on-disk state reflects the failed warm — callers then choose to retry (Failed → Staged) or retire (Failed → Archived) via the operator CLI.

Fields

revision_id: RevisionId

failed_checks: Vec<HealthCheckId>

message: String

Store(StoreError)

Underlying storage layer failure (load/save through the Locked<'_>).

Trait Implementations

impl Debug for LifecycleError

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

Formats the value using the given formatter.

impl Display for LifecycleError

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

Formats the value using the given formatter.

impl Error for LifecycleError

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<LifecycleError> for OpError

fn from(err: LifecycleError) -> Self

Converts to this type from the input type.

impl From<RevisionLifecycleError> for LifecycleError

Lift a pure-engine lifecycle failure onto the local storage-aware error. Variants map 1:1; the engine’s stage-verb DeploymentNotFound (which has no lifecycle twin here) surfaces through the storage variant the CLI already maps to a dependent-not-found.

fn from(err: RevisionLifecycleError) -> Self

Converts to this type from the input type.

impl From<StoreError> for LifecycleError

fn from(source: StoreError) -> Self

Converts to this type from the input type.