Skip to content
Merged
10 changes: 8 additions & 2 deletions data/outstanding-issues-snapshot.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@
"version": "outstanding-issues-snapshot-v1",
"ledger_revision": {
"sha": "6085a0a59aca4c1bb9e19fb4d490fd34dec950cd",
"committed_at": "2026-08-22T20:52:39Z"
"committed_at": "2026-08-22T20:52:39+00:00"
},
"counts": {
"open": 73,
"p1": 0,
"p2": 40,
"p3": 33,
"queued": 10,
"pending": 15,
"pending": 16,
"resolved": 376
},
"queue": [
Expand Down Expand Up @@ -845,6 +845,12 @@
"summary": "Caring Contacts Phase 2B — the screens",
"created_at": "2026-08-22"
},
{
"request_id": "b5d6b1be-d1c9-4739-898a-33aec4a656a5",
"action": "add",
"summary": "Document /ward-management/constellation as an intentional unlinked compatibility redirect",
"created_at": "2026-08-22"
},
{
"request_id": "ba2bdfba-b1e1-4e13-83b4-8cb0f3ddc092",
"action": "add",
Expand Down
3 changes: 2 additions & 1 deletion docs/codebase-index.md
Original file line number Diff line number Diff line change
Expand Up @@ -358,7 +358,8 @@ visible reasons and a human confirms or overrides.
derivations)
- **Surfaces:** `ward-management-console.tsx` (command), `ward-management-modes.tsx` (mode
workspaces), `ward-management-network.tsx` (network diagram), `ward-management-navigation.tsx`,
`coordinator/coordinator-screen.tsx` (Phase 3 live coordinator screen — priority queue, statewide
`src/app/ward-management/constellation/page.tsx` (retired constellation; server redirect to
`/ward-management/network`), `coordinator/coordinator-screen.tsx` (Phase 3 live coordinator screen — priority queue, statewide
flow diagram, explainable shortlist), `ward/ward-screen.tsx` (Task 8: one inpatient unit's own
view — `/ward-management/ward/[unitId]`; capacity confirmation, incoming-referral accept/hold/
decline, restriction notices, withdrawn referrals), `officer/officer-screen.tsx` (Task 9: the
Expand Down
45 changes: 23 additions & 22 deletions docs/design-system/ADOPTION.md
Original file line number Diff line number Diff line change
Expand Up @@ -358,38 +358,39 @@ Escape, and return focus). This is follow-up evidence, not a visual-baseline com
`generate-design-system-adoption.mjs` discovers every production `src/app/**/page.tsx` and
requires each route to appear exactly once in `adoption-contract.json`. Undeclared, missing, or
multiply-owned routes fail the check. `src/app/api/**` and `src/app/mockups/**` are non-page
product exclusions; the only route-only disposition is the documented legacy document-source
redirect. Shared shell/component roots carry their own explicit `shared-shell` disposition.
product exclusions; the only route-only dispositions are the documented legacy-redirect
surfaces. Shared shell/component roots carry their own explicit `shared-shell` disposition.

Registered public components: 54
Declared product roots: 94
Roots with a literal `.ckb-v2` opt-in: 1
Roots inheriting `.ckb-v2` from the global `<html>`: 93
Production surfaces observed under v2: 16/16
Production surfaces observed under v2: 17/17
Dynamic `ckb-v2` constructions: 0
Declared production page routes: 78/78
Declared production page routes: 79/79

Source observation and contract declaration are independent. A literal `ckb-v2` on the global `<html>` makes every production surface inherit v2, but it does not approve that adoption.
The Proof column summarizes each surface's dark, forced-colours, 320px, print and browser declarations; exact statuses and evidence paths live in the manifest.
Observed v2 under a compatibility declaration fails closed. A declared v2 shell also fails closed unless every proof is passed with evidence and its visual baseline is committed or explicitly not-committed (pending Linux screenshot approval).

| Surface | Disposition | Routes | Roots | Declared shell | Observed shell (mount) | Proof | Baseline |
| ---------------------------------- | --------------- | -----: | ----: | -------------- | -------------------------- | -------------- | -------------- |
| `root-shell-and-settings` | shared-shell | 3 | 6 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `catalogues-forms-and-info` | owned | 23 | 23 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `differentials` | owned | 7 | 7 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `formulation` | owned | 6 | 6 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `specifiers` | owned | 6 | 6 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `therapy-compass` | owned | 9 | 10 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `documents-and-source-evidence` | owned | 3 | 4 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `documents-source-legacy-redirect` | legacy-redirect | 1 | 0 | v2 | v2 (inherited-global-root) | not-applicable | not-applicable |
| `favourites` | owned | 1 | 1 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `tools-and-calculators` | owned | 3 | 3 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `caring-contacts-workspace` | owned | 1 | 1 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `ward-management` | owned | 12 | 20 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `privacy-safety-and-reference` | owned | 3 | 3 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `search-results-shared` | shared-shell | 0 | 1 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `answers-shared` | shared-shell | 0 | 2 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `source-preview-shared` | shared-shell | 0 | 1 | v2 | v2 (inherited-global-root) | passed | not-committed |
| Surface | Disposition | Routes | Roots | Declared shell | Observed shell (mount) | Proof | Baseline |
| ----------------------------------------------- | --------------- | -----: | ----: | -------------- | -------------------------- | -------------- | -------------- |
| `root-shell-and-settings` | shared-shell | 3 | 6 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `catalogues-forms-and-info` | owned | 23 | 23 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `differentials` | owned | 7 | 7 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `formulation` | owned | 6 | 6 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `specifiers` | owned | 6 | 6 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `therapy-compass` | owned | 9 | 10 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `documents-and-source-evidence` | owned | 3 | 4 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `documents-source-legacy-redirect` | legacy-redirect | 1 | 0 | v2 | v2 (inherited-global-root) | not-applicable | not-applicable |
| `ward-management-constellation-legacy-redirect` | legacy-redirect | 1 | 0 | v2 | v2 (inherited-global-root) | not-applicable | not-applicable |
| `favourites` | owned | 1 | 1 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `tools-and-calculators` | owned | 3 | 3 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `caring-contacts-workspace` | owned | 1 | 1 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `ward-management` | owned | 12 | 20 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `privacy-safety-and-reference` | owned | 3 | 3 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `search-results-shared` | shared-shell | 0 | 1 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `answers-shared` | shared-shell | 0 | 2 | v2 | v2 (inherited-global-root) | passed | not-committed |
| `source-preview-shared` | shared-shell | 0 | 1 | v2 | v2 (inherited-global-root) | passed | not-committed |

<!-- adoption-manifest:adoption:end -->
41 changes: 41 additions & 0 deletions docs/design-system/adoption-contract.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@
"documents-source-legacy-redirect": {
"route": "src/app/(search-app)/documents/source/page.tsx",
"kind": "next-redirect-only"
},
"ward-management-constellation-legacy-redirect": {
"route": "src/app/ward-management/constellation/page.tsx",
"kind": "next-redirect-only"
}
},
"proofEvidencePolicy": {
Expand Down Expand Up @@ -427,6 +431,43 @@
"sanctionedSpecialPatterns": [],
"documentedDisposition": "Legacy source URLs validate the document id and redirect to the canonical /documents/[id] route; they do not own a visual surface."
},
{
"id": "ward-management-constellation-legacy-redirect",
"disposition": "legacy-redirect",
"routes": ["src/app/ward-management/constellation/page.tsx"],
"routeRoots": false,
"roots": [],
"permittedComponentFamilies": [],
"expectedShellState": "v2",
"proof": {
"dark": {
"status": "not-applicable",
"evidence": []
},
"forcedColours": {
"status": "not-applicable",
"evidence": []
},
"compact320": {
"status": "not-applicable",
"evidence": []
},
"print": {
"status": "not-applicable",
"evidence": []
},
"browser": {
"status": "not-applicable",
"evidence": []
}
},
"baseline": {
"status": "not-applicable",
"files": []
},
"sanctionedSpecialPatterns": [],
"documentedDisposition": "Retired Phase 1 constellation URLs redirect to /ward-management/network; they do not own a visual surface."
},
{
"id": "favourites",
"disposition": "owned",
Expand Down
71 changes: 67 additions & 4 deletions docs/design-system/adoption-manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,10 @@
"documents-source-legacy-redirect": {
"route": "src/app/(search-app)/documents/source/page.tsx",
"kind": "next-redirect-only"
},
"ward-management-constellation-legacy-redirect": {
"route": "src/app/ward-management/constellation/page.tsx",
"kind": "next-redirect-only"
}
},
"evidence": {
Expand Down Expand Up @@ -3170,6 +3174,63 @@
"sanctionedSpecialPatterns": [],
"roots": []
},
{
"id": "ward-management-constellation-legacy-redirect",
"disposition": "legacy-redirect",
"documentedDisposition": "Retired Phase 1 constellation URLs redirect to /ward-management/network; they do not own a visual surface.",
"routes": ["src/app/ward-management/constellation/page.tsx"],
"routeRoots": false,
"proofApplicability": "not-applicable",
"nonVisualRoute": {
"contract": {
"route": "src/app/ward-management/constellation/page.tsx",
"kind": "next-redirect-only"
},
"source": {
"importsNextRedirect": true,
"hasDefaultFunction": true,
"hasJsx": false,
"terminalOutcomes": ["redirect"],
"redirectOnly": true
},
"topologyMatches": true
},
"declaredShellState": "v2",
"observedShellState": "v2",
"v2ShellMounted": true,
"v2MountMode": "inherited-global-root",
"inheritedFrom": "src/app/layout.tsx",
"directV2MountFiles": [],
"proof": {
"browser": {
"status": "not-applicable",
"evidence": []
},
"compact320": {
"status": "not-applicable",
"evidence": []
},
"dark": {
"status": "not-applicable",
"evidence": []
},
"forcedColours": {
"status": "not-applicable",
"evidence": []
},
"print": {
"status": "not-applicable",
"evidence": []
}
},
"baseline": {
"status": "not-applicable",
"files": []
},
"permittedComponentFamilies": [],
"sanctionedSpecialPatterns": [],
"roots": []
},
{
"id": "favourites",
"disposition": "owned",
Expand Down Expand Up @@ -3948,6 +4009,7 @@
"src/app/reference/colour-coding/page.tsx",
"src/app/safety-plan/page.tsx",
"src/app/ward-management/capacity/page.tsx",
"src/app/ward-management/constellation/page.tsx",
"src/app/ward-management/ed/[edId]/page.tsx",
"src/app/ward-management/exceptions/page.tsx",
"src/app/ward-management/governance/page.tsx",
Expand Down Expand Up @@ -4028,6 +4090,7 @@
"src/app/reference/colour-coding/page.tsx",
"src/app/safety-plan/page.tsx",
"src/app/ward-management/capacity/page.tsx",
"src/app/ward-management/constellation/page.tsx",
"src/app/ward-management/ed/[edId]/page.tsx",
"src/app/ward-management/exceptions/page.tsx",
"src/app/ward-management/governance/page.tsx",
Expand All @@ -4048,15 +4111,15 @@
"literalCkbV2RootCount": 1,
"inheritedCkbV2RootCount": 93,
"dynamicCkbV2RootCount": 0,
"v2MountedSurfaceCount": 16,
"declaredV2SurfaceCount": 16
"v2MountedSurfaceCount": 17,
"declaredV2SurfaceCount": 17
},
"summary": {
"registeredComponentCount": 54,
"previewCount": 54,
"productImportedComponentCount": 34,
"rootCount": 94,
"productionRouteCount": 78,
"nextUiEntryCount": 139
"productionRouteCount": 79,
"nextUiEntryCount": 140
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{
"version": 2,
"id": "b5d6b1be-d1c9-4739-898a-33aec4a656a5",
"createdOn": "2026-08-22",
"action": "add",
"payload": {
"pri": "P3",
"type": "issue",
"summary": "Document /ward-management/constellation as an intentional unlinked compatibility redirect",
"detail": "PR #2303 restored /ward-management/constellation as a server redirect to /ward-management/network so live-main bookmarks do not 404 after Phase 3 retired the constellation command view. The route is on the reachability allowlist because in-app navigation uses the remaining rail modes and must not send readers through the redirect. STOP: do not add inbound nav to this route, and do not treat it as a visual Ward Flow surface; it is a bookmark/deep-link backstop only. Related: tests/route-reachability.test.ts REACHABILITY_ALLOWLIST, src/app/ward-management/constellation/page.tsx, docs/design-system/adoption-contract.json ward-management-constellation-legacy-redirect.",
"source": "PR #2303 CodeRabbit review; AGENTS.md new-route checklist requiring an /issues note for allowlisted orphans",
"issueUlid": "01M0NKTEQJHXY7QJXR82WCBXBT"
}
}
8 changes: 5 additions & 3 deletions docs/site-map.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,15 +59,16 @@ This file is generated by `npm run docs:update` (or `npm run sitemap:update` dir
- `/tools` - Clinical tools and applications launcher directory. Source: `src/app/(search-app)/tools/page.tsx`.
- `/ward-management` - Statewide psychiatry ward demand, bed capacity, and patient flow console. Source: `src/app/ward-management/page.tsx`.
- `/ward-management/capacity` - Ward bed availability, unit occupancy, and staffing capacity. Source: `src/app/ward-management/capacity/page.tsx`.
- `/ward-management/ed/[edId]` - Route discovered from app directory Source: `src/app/ward-management/ed/[edId]/page.tsx`.
- `/ward-management/constellation` - Compatibility redirect to `/ward-management/network`. Phase 2 retired the constellation command view. Source: `src/app/ward-management/constellation/page.tsx`.
- `/ward-management/ed/[edId]` - Synthetic emergency-department role screen for one origin department. Source: `src/app/ward-management/ed/[edId]/page.tsx`.
- `/ward-management/exceptions` - Patient flow exceptions, delays, and escalation alerts. Source: `src/app/ward-management/exceptions/page.tsx`.
- `/ward-management/governance` - Ward coordination governance, compliance, and audit log. Source: `src/app/ward-management/governance/page.tsx`.
- `/ward-management/movements` - Scheduled and completed patient transfers and bed movements. Source: `src/app/ward-management/movements/page.tsx`.
- `/ward-management/network` - Psychiatric bed network status and regional catchment map. Source: `src/app/ward-management/network/page.tsx`.
- `/ward-management/queue` - Priority referral queue and triage waiting list. Source: `src/app/ward-management/queue/page.tsx`.
- `/ward-management/transport` - Patient inter-hospital transfer and transport logistics. Source: `src/app/ward-management/transport/page.tsx`.
- `/ward-management/transport/officer` - Route discovered from app directory Source: `src/app/ward-management/transport/officer/page.tsx`.
- `/ward-management/ward/[unitId]` - Route discovered from app directory Source: `src/app/ward-management/ward/[unitId]/page.tsx`.
- `/ward-management/transport/officer` - Synthetic transport-officer phone screen for in-flight jobs. Source: `src/app/ward-management/transport/officer/page.tsx`.
- `/ward-management/ward/[unitId]` - Synthetic ward-manager screen for one inpatient unit. Source: `src/app/ward-management/ward/[unitId]/page.tsx`.

## Mode/query routes

Expand Down Expand Up @@ -1347,6 +1348,7 @@ This file is generated by `npm run docs:update` (or `npm run sitemap:update` dir
- `/services` - Redirects to `/?mode=services`. Source: `src/app/(search-app)/services/page.tsx`.
- `/specifiers` - Redirects to `/?mode=specifiers`. Source: `src/app/(search-app)/specifiers/page.tsx`.
- `/therapy-compass` - Redirects to `/?mode=therapy-compass`. Source: `src/app/(search-app)/therapy-compass/page.tsx`.
- `/ward-management/constellation` - Redirects to `/ward-management/network`. Source: `src/app/ward-management/constellation/page.tsx`.

## Known caveats and stale-path flags

Expand Down
Loading
Loading