Skip to main content
Version: v5.6.1

opschain admin agent-release rename-stage

packs:agentspacks:agent-governance

opschain admin agent-release rename-stage <old> <new>

Renames one rung of the estate's release stage ladder in place, as one set-based write: the ladder, every release currently at the rung (each gains a completed promotion attestation <old> → <new> with the reason stage renamed), every pending promotion into or out of it, every environment release-stage floor and every trust grant release_stage condition naming it move together, and every connected instance's cached stage follows at once. The rung's governed flag is kept.

Refusals, by name: <old> is not a rung; <new> is already a rung or is not a valid rung name; the estate's agents.release_stage configuration floor names <old> (deployment configuration is not rewritten — change it first). Admin-only, needs packs:agent-governance, audited (info:agent_release:ladder_changed with renamed_from, renamed_to and releases_attested).

Flags​

FlagMeaning
--server <url>Server base URL. Default: the active context, then OPSCHAIN_SERVER.

Output​

renamed stage test to uat (2 release(s) attested)
RANK STAGE GOVERNED
1 dev no
2 uat no
3 prod yes

-o json|yaml prints stages and releases_attested.

See also​

  • opschain docs cli/admin-agent-release-stages — show or replace the ladder.
  • opschain docs cli/admin-agent-release-show — the attestation each affected release gained.
  • opschain docs agent-releases — "The stage ladder is the estate's".