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.