rt runs stage-done
rt › runs › stage-done
Pipeline: finish the latest attempt of a stage (reads RT_RUN_DB)
Usage
rt runs stage-done [flags]
Arguments & flags
| Flag / Arg | Type | Default | Description |
|---|---|---|---|
--stage | text | Stage name |
See code: commands/runs-write.ts › runsStageDone
Examples & notes
Closing a stage that was never opened with stage-start is a usage bug, not a no-op: stage-done exits 3 and reports the error instead of answering ok.
$ rt runs stage-done --stage gates
{"ok":false,"error":"stage never started: gates"}
$ echo $?
3
The same holds for stage-fail on a stage with no matching stage-start. A pipeline that sees exit 3 has a sequencing bug to fix, not a run to retry.