Enum Reason 

pub enum Reason {
    Usage,
    TargetNotFound,
    ForgeUndetected,
    ForgeUnsupported,
    PrerequisiteUnmet,
    ForgeAuthentication,
    ForgePermission,
    ForgeRateLimit,
    ForgeTemporary,
    RemoteConflict,
    DestructiveRefusal,
    StateDrift,
    UnsupportedSchema,
    JournalUnavailable,
    SubprocessSpawn,
    SubprocessFailed,
    Io,
    Internal,
    ConfigInvalid,
    RegistryUnreachable,
    BundleUnverified,
    PlanNotReady,
    PostconditionFailed,
    TargetBusy,
    ObservationIncomplete,
    RecordInvalid,
    MergeFormMismatch,
    PresetContradiction,
}

The closed reason vocabulary, the machine twin of the exit-code matrix.

Many reasons map to one exit code — that is the point: the code carries the category, the reason carries the instance. Classification is honest or absent: a failure nothing can classify further stays Reason::Io or Reason::Internal rather than guessing.

Variants

Usage

Semantically invalid arguments or names.

TargetNotFound

The named target does not exist or is not usable as a target.

ForgeUndetected

No forge could be detected from the repository’s remote.

ForgeUnsupported

The detected or named forge is not one the binary supports.

PrerequisiteUnmet

A prerequisite probe failed before any side effect.

ForgeAuthentication

The forge CLI is present and not authenticated.

ForgePermission

The forge refused the caller’s permissions.

ForgeRateLimit

The forge rate-limited the call.

ForgeTemporary

The forge failed in a way a retry can cure.

RemoteConflict

The remote state changed under the run.

DestructiveRefusal

The command refused an action it judged destructive.

StateDrift

The state found differs from what would permit the action.

UnsupportedSchema

A record or document declares a schema this binary does not know.

JournalUnavailable

A mutating run could not create its journal.

SubprocessSpawn

A child process could not be spawned.

SubprocessFailed

A child process ran and failed without a finer classification.

Io

Filesystem failure.

Internal

A defect in this binary.

ConfigInvalid

A hand-authored target configuration is invalid.

RegistryUnreachable

A registry did not answer. No live path emits it; the vocabulary is append-only, so the word stays.

BundleUnverified

A fetched artifact failed its verification. No live path emits it; the vocabulary is append-only, so the word stays.

PlanNotReady

A precondition did not hold before a write. No live path emits it; the vocabulary is append-only, so the word stays.

PostconditionFailed

A postcondition found the target short after a write. No live path emits it; the vocabulary is append-only, so the word stays.

TargetBusy

Another run holds the target, and this one wrote nothing.

ObservationIncomplete

A read-only observation could not decide a step from where it ran, and found no step wrong.

RecordInvalid

The landing record exists and does not parse as one.

MergeFormMismatch

An argument the recorded merge form does not take, such as a trunk message under rebase, where every commit keeps its own.

PresetContradiction

An explicit flag contradicts an answer a preset flag sets, such as --integration forge beside --workflow-only.

Implementations

impl Reason

pub const fn as_str(self) -> &'static str

The kebab-case wire form, identical to the serde rendering.

Trait Implementations

impl Clone for Reason

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Reason

impl Debug for Reason

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

Formats the value using the given formatter.

impl Eq for Reason

impl PartialEq for Reason

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Reason

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Reason