opschain admin agent-release promote
packs:agentspacks:agent-governance
opschain admin agent-release promote <name>@<version> [--to <stage>] \
[--approver <user>]... [--reason <text>]
Promotes a release one rung up the estate's stage ladder (default
dev → test → prod; see opschain admin agent-release stages) — skips
and demotions refuse, naming the ladder — re-verifying the signature
first, so a tampered release can never climb. --to names the next rung;
omitted, the next rung is taken. One promotion may be open per release at
a time.
On an estate carrying the approval fabric, a promotion into a governed
rung (prod on the default ladder) lands held: a strict checklist opens in
the same approval funnel governed change enters (opschain approvals / the
approvals inbox), its subject naming the target rung; named approvers
resolve from --approver, else the configured agents.approvers (a
governed promotion is never approver-less). Quorum completion promotes the
release (info:agent_release:promoted); rejection or quorum-TTL expiry
refuses it (info:agent_release:promotion_rejected) and the stage never
moves. Without the fabric the promotion completes directly, audited.
Once promoted, every connected instance of the release carries the new
stage at once — environment floors and grant conditions decide on it from
the next request (opschain docs agent-releases, "Where a stage may act").
Flags
| Flag | Meaning |
|---|---|
--to <stage> | Target stage: the next rung of the ladder (one rung at a time). Default: the next rung. |
--approver <user> | Approver for a funnel-held promotion into a governed rung (repeatable). |
--reason <text> | Audited promotion reason. |
--server <url> | Server base URL. Default: the active context, then OPSCHAIN_SERVER. |
Output
promoted felix@2.1.0 to test
promotion of felix@2.1.0 to prod (governed) is held for approval (promotion 019a…) — approve or reject it through the approvals inbox
See also
opschain docs cli/admin-agent-release-stages— the ladder and which rungs are governed.opschain docs cli/admin-agent-release-show— the promotion attestations.opschain docs agent-releases— the lifecycle, the governed rung and where a stage may act.