stagesetctl baseline
Adopts a system whose once-per-lifetime bootstrap already ran by asserting an
action complete in the
StageLedger
’s
spec.baseline — the controller promotes it to a recorded completion without
running the action. --export instead prints the ledger’s current completions as
a committable spec.baseline snippet, for disaster recovery or renaming a ledger.
stagesetctl baseline NAME [flags]
| Flag | Default | Description |
|---|---|---|
--stage | (required) | Stage the action belongs to. |
--action | (required) | Name of the scope: Lifetime action to baseline. |
--export | false | Print the ledger’s current completions as a spec.baseline snippet instead of adding one. Mutually exclusive with --stage/--action. |
When the StageSet exists, the named action must be a scope: Lifetime action or
the command fails (a typo guard). When it does not exist yet, the command
proceeds — applying the ledger before the StageSet is the race-free adoption
order — and the controller validates the entry once the StageSet is applied.
Examples
Adopt a running system without re-running its bootstrap:
stagesetctl baseline moodle --stage app --action install-database
Export completions to commit for disaster recovery:
stagesetctl baseline moodle --export > moodle-ledger.yaml