Enum ExecResult 

#[non_exhaustive]
pub enum ExecResult {
    PerformedChange,
    WouldPerformChange,
    AlreadySatisfied,
    NoOp,
    #[non_exhaustive]
    Skipped {
        pack_path: PathBuf,
        actions_hash: String,
    },
}

Coarse-grained outcome of a single step.

Marked #[non_exhaustive] so future milestones (M4 plugin system, lockfile idempotency) can introduce additional outcomes without breaking downstream consumers. External match sites must include a _ arm.

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.

PerformedChange

Wet-run executor actually mutated state.

WouldPerformChange

Planner determined the change would happen in a wet run.

AlreadySatisfied

Target state already matches (e.g. symlink already points at the right src). Idempotent short-circuit.

NoOp

Action was a no-op: when.os branch not taken, or require failed with on_fail: skip | warn. Not an error.

#[non_exhaustive]

Skipped

Action was deliberately skipped by a caller-level policy — in M4 the trigger is a lockfile actions_hash match on the pack. The variant carries the pack path and the matched hash so downstream audit tooling can render “pack X at hash Y was skipped” without having to thread extra context.

Marked #[non_exhaustive] at the variant level so future audit fields (e.g. skipped_at, policy_source) can be added without breaking downstream struct-pattern match sites.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

pack_path: PathBuf

Path to the pack whose actions were skipped.

actions_hash: String

Actions-hash that matched the lockfile entry.

Trait Implementations

impl Clone for ExecResult

fn clone(&self) -> ExecResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExecResult

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

Formats the value using the given formatter.

impl PartialEq for ExecResult

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ExecResult

impl StructuralPartialEq for ExecResult