Align route ownership and sidebar surface exposure

docs/implplan/SPRINT_20260310_028_FE_route_surface_ownership_alignment.md

@@ -0,0 +1,55 @@
+# Sprint 20260310_028 - FE Route Surface Ownership Alignment
+
+## Topic & Scope
+- Align the live web shell so notifications, environment inventory, release health, and audit/security navigation point to the canonical owning surfaces.
+- Repair the route-level and return-navigation regressions left behind by the in-flight cleanup, especially around Mission Control watchlist handoffs.
+- Working directory: `src/Web/StellaOps.Web/src/app/routes`.
+- Allowed coordination edits: `src/Web/StellaOps.Web/src/app/layout/app-sidebar`, `src/Web/StellaOps.Web/src/app/features/platform/ops`, `src/Web/StellaOps.Web/src/app/features/watchlist`, `src/Web/StellaOps.Web/src/app/core/testing`, `docs/implplan/SPRINT_20260310_028_FE_route_surface_ownership_alignment.md`.
+- Expected evidence: focused Angular route/sidebar/watchlist specs, rebuilt web bundle, live Playwright route/action checks on the changed surfaces.
+
+## Dependencies & Concurrency
+- Depends on the live compose stack from the scratch-setup iteration.
+- Safe parallelism: do not mix unrelated page-revival edits into this slice; keep it bounded to route ownership, sidebar exposure, and watchlist handoff semantics.
+
+## Documentation Prerequisites
+- `AGENTS.md`
+- `docs/qa/feature-checks/FLOW.md`
+- `docs/features/checked/web/left-rail-navigation-shell.md`
+- `docs/features/checked/web/identity-watchlist-management-ui.md`
+- `docs/features/checked/web/platform-setup-canonical-route-preservation-ui.md`
+
+## Delivery Tracker
+
+### FE-ROUTE-OWNERSHIP-001 - Align canonical route ownership and sidebar exposure
+Status: DONE
+Dependency: none
+Owners: QA, Developer
+Task description:
+- The dirty web slice is consolidating notifications and environment inventory under Operations, adding Release Health under Releases, and re-grouping sidebar ownership between Release Control, Security & Audit, and Platform & Setup.
+- Finish the cleanup by validating the route contracts in code, restoring any dropped scope-preservation coverage that is still required, and correcting watchlist return semantics so dedicated Mission Control leaves remain truthful.
+
+Completion criteria:
+- [x] Route specs prove the canonical owners for `/ops/operations/notifications`, `/ops/operations/environments`, `/releases/health`, and the legacy environment redirects.
+- [x] Sidebar spec proves the new exposure model without reintroducing removed Mission Control child leaves.
+- [x] Watchlist return labels distinguish `Mission Alerts`, `Dashboard`, and `Notifications`.
+- [x] Rebuilt live web passes the affected Playwright route/action checks with zero failures.
+
+## Execution Log
+| Date (UTC) | Update | Owner |
+| --- | --- | --- |
+| 2026-03-10 | Sprint created while auditing the remaining dirty route/sidebar slice after the Mission Control iteration. Confirmed the change set is a route-surface ownership cleanup, not the unrelated OpenAPI/header draft sprint. | Developer |
+| 2026-03-10 | Added `route-surface-ownership.spec.ts`, restored the dropped Mission Control scope assertions, and added the missing watchlist return-label coverage. `npx ng test --watch=false --include=src/app/routes/route-surface-ownership.spec.ts --include=src/app/routes/releases.routes.spec.ts --include=src/app/layout/app-sidebar/app-sidebar.component.spec.ts --include=src/app/core/testing/mission-scope-links.component.spec.ts` passed `27/27`; `npx ng test --watch=false --ts-config tsconfig.spec.features.json --include=src/app/features/watchlist/watchlist-page.component.spec.ts` passed `9/9`. | Developer |
+| 2026-03-10 | Rebuilt the web bundle, resynced `dist/stellaops-web/browser` into `compose_console-dist`, and verified the live route/sidebar ownership slice with `node ./scripts/live-route-surface-ownership-check.mjs` (`failedActionCount=0`, `runtimeIssueCount=0`). | QA |
+| 2026-03-10 | Adjacent live check `node ./scripts/live-notifications-watchlist-recheck.mjs` still fails on the Notifications surface (`Notification Administration`) because the watchlist tuning and alert drilldown links are missing and the page raised a visible `!t.items is not iterable` banner. Kept that defect out of this scoped commit as the next iteration. | QA |
+
+## Decisions & Risks
+- Decision: keep environment inventory under Operations and treat Releases-owned environment routes as compatibility redirects only.
+- Decision: preserve dedicated Mission Control alert semantics end to end; restoring the alerts leaf also requires preserving `Mission Alerts` return labels in watchlist drilldowns.
+- Decision: keep a dedicated Playwright harness (`live-route-surface-ownership-check.mjs`) for this cleanup so future route/shell ownership changes can be reverified without rerunning the full canonical sweep.
+- Risk: unrelated page-level UI edits are still present in the dirty tree. They must stay out of this commit unless they are independently verified.
+- Risk: Notifications still has a separate live defect (`!t.items is not iterable`, missing watchlist links). That surface needs its own follow-up iteration before the broader product can be considered clean.
+
+## Next Checkpoints
+- Land focused route/watchlist/spec coverage.
+- Rebuild and sync the web bundle into `compose_console-dist`.
+- Re-run live Playwright on the changed route/action surfaces and commit the verified slice.