git.stella-ops.org/docs/modules/ui/release-promotions-cutover

Release Promotions Cutover

Purpose

• Make Releases own the promotion workflow instead of splitting it across stale queue aliases, orphaned promotion routes, and approval-only entry points.
• Keep approvals as the adjudication surface, but move promotion list, create, and detail flows under one canonical subtree.

Canonical Routes

• /releases/promotions
• /releases/promotions/create
• /releases/promotions/:promotionId

Alias Policy

• Preserve legacy /release-control/promotions, /release-control/promotions/create, and /release-control/promotions/:promotionId bookmarks.
• Preserve stale /releases/promotion-queue, /releases/promotion-queue/create, and /releases/promotion-queue/:promotionId bookmarks.
• Redirect aliases into the canonical /releases/promotions* subtree while preserving query params and fragments.

Shell Surfacing

• Releases sidebar now exposes separate Approvals and Promotions entries.
• Releases > Overview links to canonical Promotions.
• The active release workbench launches the promotion wizard directly instead of trapping the operator in a non-executable promote tab.

Release-Context Handoff

• The release workbench opens /releases/promotions/create with:
  • releaseId
  • returnTo
• The promotion wizard treats this as a first-class release-context launch:
  • preloads environments for the supplied release
  • advances directly to target selection once release identity is known
  • keeps a return path back to the originating release or run context
  • deep-links into Decisioning Studio with a return path back to the canonical promotion wizard

Merge Notes From Dropped Surfaces

• The dormant PromotionRequestComponent was not revived as a second page.
• Its worthwhile behavior was merged into the canonical wizard:
  • contextual return-to handling
  • decisioning preview handoff
  • release-context launch semantics

Verification

• Angular tests cover:
  • canonical promotions route ownership
  • legacy alias redirects
  • promotion wizard release-context hydration
  • release workbench handoff into the canonical wizard
• Playwright covers:
  • overview surfacing of the canonical promotions page
  • legacy create alias redirect plus end-to-end promotion request submission

Related

• docs/features/checked/web/release-promotions-cutover-ui.md
• docs/modules/ui/component-preservation-map/RESTORATION_PRIORITIES.md