# 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`