Actions

• ActionDirty

  A stage with an incomplete once-per-lifetime action failed repeatedly, so the controller halted auto-retry; clear the halt with a manual reconcile once the cause is fixed.

• Actions

  Typed pre, post, and on-failure steps — jobs, HTTP gates, waits, patches, deletes, transient applies.

• Best practices

  How to get the most out of StageSet — keep the render pure, model the release as gated stages, choose action scopes deliberately — and the anti-patterns that bite.

• MigrationFailed

  A migration's action failed; the run halts at that stage and retries with backoff, skipping already-completed actions.

• StageFailed

  A stage failed to fetch, build, apply, verify, or run an action; the run halts there.

• stagesetctl baseline

  Assert a once-per-lifetime action already completed (adoption), or export a ledger's completions as a committable baseline.

• stagesetctl plan

  Preview what the next reconcile will do — which actions run, skip, or re-run, and why.

• stagesetctl reset-ledger

  Forget a StageLedger completion so its once-per-lifetime action runs again.

• Versioned migrations

  Run migrations once, when the deployed version crosses a release boundary — inline, or sourced from a Flux artifact and shared across StageSets.