This commit is contained in:
master
2026-02-21 16:21:33 +02:00
parent 7e36c1f151
commit b911537870
116 changed files with 4365 additions and 5903 deletions

View File

@@ -0,0 +1,198 @@
# Sprint 20260221_041 - Pre-Alpha IA Rewire (Ops + Setup)
## Topic & Scope
- Rewire the Web UI to pre-alpha IA where root workspaces are Mission Control, Releases, Security, Evidence, Ops, and Setup.
- Consolidate Platform + Policy under Ops, move Topology under Setup, and remove compatibility redirects/alias routing.
- Complete missing distinct surfaces called out in advisory gap review (release/hotfix split, security detail surfaces, topology map/connectivity/drift, evidence overview default, global header contracts).
- Working directory: `src/Web/StellaOps.Web/`.
- Expected evidence: route/nav contract changes, distinct page surfaces, updated docs, and targeted frontend tests.
## Dependencies & Concurrency
- Depends on current Pack-22/23 contracts in `docs/modules/ui/v2-rewire/` and existing pre-alpha frontend branch state.
- Safe parallelism: frontend-only changes in `src/Web/StellaOps.Web/`; docs updates in `docs/modules/ui/v2-rewire/` can run in parallel if contracts stay consistent.
## Documentation Prerequisites
- `docs/modules/ui/README.md`
- `docs/modules/ui/architecture.md`
- `docs/modules/ui/implementation_plan.md`
- `docs/modules/platform/architecture-overview.md`
- `docs/modules/ui/v2-rewire/source-of-truth.md`
## Delivery Tracker
### 041-T1 - Root IA/nav rewrite (Mission Control + Ops + Setup)
Status: DONE
Dependency: none
Owners: Developer (FE)
Task description:
- Rewrite shell navigation roots to: Mission Control, Releases, Security, Evidence, Ops, Setup.
- Remove Topology as root; place topology entries under Setup.
- Remove Platform and Policy roots; expose their capabilities under Ops.
Completion criteria:
- [x] Sidebar root groups match target IA and scope gates
- [x] No root menu points to legacy Platform/Policy/Administration/Topology roots
### 041-T2 - Canonical route tree rebuild (no alias redirects)
Status: DONE
Dependency: 041-T1
Owners: Developer (FE)
Task description:
- Rebuild `app.routes.ts` and child route trees to pre-alpha canonical paths.
- Remove legacy alias windows and redirect maps used for backward compatibility.
- Keep only canonical pre-alpha route entries needed for first-version UX.
Completion criteria:
- [x] `LEGACY_REDIRECT_ROUTES` not used by router
- [x] Canonical route trees are reachable without alias redirects
### 041-T3 - Mission Control menu expansion
Status: DONE
Dependency: 041-T1
Owners: Developer (FE)
Task description:
- Split Mission Control into distinct root-visible surfaces (Mission Board, Alerts, Activity).
- Ensure breadcrumb/title metadata is distinct for each surface.
Completion criteria:
- [x] Mission Control has dedicated routes for board/alerts/activity
- [x] Sidebar children and route metadata are aligned
### 041-T4 - Ops consolidation (Platform + Policy + Integrations)
Status: DONE
Dependency: 041-T2
Owners: Developer (FE)
Task description:
- Move Policy governance/simulation/profile surfaces under Ops.
- Move Platform ops/integrations/setup controls under Ops taxonomy.
- Provide one canonical Ops route tree with explicit sub-areas.
Completion criteria:
- [x] Policy capabilities are routed under `/ops/**`
- [x] Platform capabilities are routed under `/ops/**`
### 041-T5 - Setup consolidation (Administration renamed + Topology moved)
Status: DONE
Dependency: 041-T2
Owners: Developer (FE)
Task description:
- Rename Administration workspace to Setup.
- Move topology surfaces (overview/map/targets/hosts/agents/connectivity/drift/details) into Setup.
- Keep IAM/tenant/notifications/usage/system in Setup.
Completion criteria:
- [x] Setup route tree includes admin + topology surfaces
- [x] Topology is no longer a root route domain
### 041-T6 - Releases completion and full hotfix split
Status: DONE
Dependency: 041-T2
Owners: Developer (FE)
Task description:
- Add missing Releases surfaces: overview, promotion queue, environments inventory, environment detail, deployment history.
- Fully split hotfix flows into list/create/detail screens.
- Keep run-centric detail as source of truth while exposing distinct list-level surfaces.
Completion criteria:
- [x] Releases menu exposes all required pre-alpha screens
- [x] Hotfix has separate list/create/detail routes
### 041-T7 - Security split completion and distinct reports
Status: DONE
Dependency: 041-T2
Owners: Developer (FE)
Task description:
- Add first-class Advisories & VEX and Supply-Chain Data surfaces.
- Add dedicated detail routes for CVE/component/artifact/environment-risk views.
- Implement distinct Security Reports page/component (not reused disposition view).
Completion criteria:
- [x] Security detail routes exist and are linked from triage
- [x] `/security/reports` is a distinct screen/component
### 041-T8 - Evidence default and topology detail gaps
Status: DONE
Dependency: 041-T2
Owners: Developer (FE)
Task description:
- Make Evidence Overview the default landing page.
- Add missing topology surfaces: map/connectivity/runtime-drift/detail pages where absent.
- Preserve evidence capsule/replay/export/audit flows with distinct route contracts.
Completion criteria:
- [x] `/evidence` lands on overview
- [x] Setup topology includes map/connectivity/runtime-drift/detail routes
### 041-T9 - Global header contract completion
Status: DONE
Dependency: 041-T1
Owners: Developer (FE)
Task description:
- Add contextual primary action slot/button in top bar by active workspace.
- Add stage selector to global scope controls.
- Add live event stream status chip.
Completion criteria:
- [x] Topbar renders contextual primary action per workspace
- [x] Scope controls include Stage
- [x] Context chips include Live Event Stream state
### 041-T10 - Integrations consolidation for advisory + VEX
Status: DONE
Dependency: 041-T4
Owners: Developer (FE)
Task description:
- Replace split advisory feeds + VEX source menus with unified Advisory & VEX Sources surface.
- Keep internal tabs for provider families while preserving integration management capabilities.
Completion criteria:
- [x] Unified Advisory & VEX sources route exists under Ops Integrations
- [x] Old split menu entries removed from canonical nav
### 041-T11 - Docs sync for new pre-alpha IA
Status: DONE
Dependency: 041-T1, 041-T2, 041-T4, 041-T5
Owners: Documentation author, Developer (FE)
Task description:
- Update v2-rewire source-of-truth docs and route map docs to reflect new canonical IA.
- Record rationale and removed redirect policy for pre-alpha first release.
Completion criteria:
- [x] Docs describe canonical roots and route tree accurately
- [x] Sprint decisions reference updated doc paths
### 041-T12 - Targeted tests and verification evidence
Status: DONE
Dependency: 041-T6, 041-T7, 041-T8, 041-T9, 041-T10
Owners: Developer (FE), QA
Task description:
- Update/create targeted tests for nav roots, route contracts, scope chips, and canonical pages.
- Execute targeted test command set and log results.
Completion criteria:
- [x] Targeted tests for changed contracts are passing
- [x] Execution Log contains command and summary evidence
## Execution Log
| Date (UTC) | Update | Owner |
| --- | --- | --- |
| 2026-02-21 | Sprint created; 041-T1 moved to DOING; implementation started for pre-alpha IA root/nav and route consolidation. | Developer (FE) |
| 2026-02-21 | Completed canonical IA rewire: roots switched to Mission Control/Releases/Security/Evidence/Ops/Setup, Topology moved under Setup, Platform+Policy consolidated under Ops, and legacy redirect route trees retired. Updated docs `docs/modules/ui/v2-rewire/source-of-truth.md` and `docs/modules/ui/v2-rewire/S00_route_deprecation_map.md`. | Developer (FE) |
| 2026-02-21 | Verification evidence: `npm run build` succeeded; targeted tests passed: `npm run test -- --watch=false --include=\"src/app/app.component.spec.ts\" --include=\"src/tests/navigation/legacy-redirects.spec.ts\" --include=\"src/tests/platform-ops/platform-ops-routes.spec.ts\" --include=\"src/tests/release-control/release-control-routes.spec.ts\" --include=\"src/tests/evidence-audit/evidence-audit-routes.spec.ts\" --include=\"src/tests/platform/platform-setup-routes.spec.ts\" --include=\"src/tests/dashboard/dashboard-route-aliases.spec.ts\" --include=\"src/tests/context/platform-context-url-sync.service.spec.ts\" --include=\"src/tests/audit_log/unified-audit-log-viewer.behavior.spec.ts\"`. | Developer (FE) |
| 2026-02-21 | End-user Playwright validation completed for canonical IA pages: `npm run test:e2e -- tests/e2e/prealpha-canonical-full-sweep.spec.ts` passed (`105/105`). Additional interaction/a11y surfaces were stabilized and verified with `npm run test:e2e -- tests/e2e/accessibility.spec.ts tests/e2e/witness-drawer.spec.ts tests/e2e/witness-viewer.spec.ts tests/e2e/workflow-time-travel.spec.ts tests/e2e/graph-platform-client.spec.ts` (`36 passed, 8 intentionally skipped`). | QA / Developer (FE) |
| 2026-02-21 | Full-suite Playwright rerun after stabilization: `npm run test:e2e` now reports `166 passed`, `195 skipped`, `53 failed`, `33 did not run` (down from prior 80 failures). Remaining failures are concentrated in legacy-route/old-workbench contracts (`web-checked-feature-recheck`, old login/auth-smoke assumptions, pack-conformance legacy expectations). | QA / Developer (FE) |
## Decisions & Risks
- Decision: pre-alpha policy removes backward-compatibility aliases/redirects; canonical routes only.
- Decision: Ops is the single operational root for former Platform + Policy + Integrations surfaces.
- Decision: Setup is the single configuration/governance root for former Administration + Topology.
- Risk: existing tests and bookmarks built for alias windows will fail/break by design; mitigated by updating tests and docs in this sprint.
- Risk: broad route refactor may cause temporary dead links during implementation; mitigated by staged task completion and verification passes.
- Cross-module note: docs updates are required under `docs/modules/ui/v2-rewire/` to keep code/docs contracts aligned.
- Residual risk: full `npm run test -- --watch=false` still reports numerous unrelated failing suites in this branch baseline; sprint verification therefore uses targeted route/nav contract tests for changed surfaces.
- Residual risk: full `npm run test:e2e` still includes many legacy/unchecked suites asserting removed redirect-era routes or older workbench contracts; canonical pre-alpha route suite is green and should be treated as release gate for this IA cut.
## Next Checkpoints
- 2026-02-21 UTC: Root IA/nav + route tree merged to canonical pre-alpha shape.
- 2026-02-22 UTC: Releases/Security/Evidence/Setup surface completion + docs sync.
- 2026-02-22 UTC: Targeted test verification and sprint status review.