Files
pipelines/docs/notes/retry-selected-stage-input-overrides.md
T

1004 B

Retry selected stage and input overrides

As of 2026-10-18, retry can select a stage recorded in a terminal failed run with --stage and, when that stage was visited repeatedly, --visit. The default remains the last failed visit. --version may select an explicitly published version of the same pipeline; the server rejects a changed or missing completed prefix.

--input-file FILE (or - for stdin) accepts a bounded JSON object. Its keys are shallow-merged into the reconstructed selected-stage input, replacing values with the same key while preserving all other handoff fields. The override is stored in the retry checkpoint and downstream stages receive the selected stage's output normally. Runtime, ownership, pipeline, workspace and scope fields are reserved. The selected stage may repeat its partial side effects.

The shared documentation and packaged OpenCode skill reference for retry options are now stale and should be folded from this note by the manual docs-fold pipeline.