Struct HaltedContext 

#[non_exhaustive]
pub struct HaltedContext {
    pub pack: String,
    pub action_idx: usize,
    pub action_name: String,
    pub error: ExecError,
    pub recovery_hint: Option<String>,
}

Rich context attached to a SyncError::Halted variant.

Packages the pack + action position together with the underlying executor error and an optional human-readable recovery hint. Marked #[non_exhaustive] so future fields (step transcript, timestamp) can land without breaking match arms or struct destructures.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

pack: String

Name of the pack that owned the halted action.

action_idx: usize

0-based index into the pack’s top-level actions vector.

action_name: String

Short action kind tag (e.g. "symlink", "exec").

error: ExecError

Underlying executor error.

recovery_hint: Option<String>

Optional next-step suggestion for the operator. None when no generic hint applies — the executor error’s own Display already tells the story.

Trait Implementations

impl Debug for HaltedContext

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

Formats the value using the given formatter.