feat(ui): ship release promotions cutover

docs/modules/ui/release-promotions-cutover/README.md

@@ -0,0 +1,51 @@
+# 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`