Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions data/outstanding-issues-snapshot.json
Original file line numberDiff line numberDiff 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 DownExpand 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 numberDiff line numberDiff 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 numberDiff line numberDiff 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 numberDiff line numberDiff 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 DownExpand 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 numberDiff line numberDiff 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 DownExpand 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 DownExpand 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 DownExpand 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 numberDiff line numberDiff 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 numberDiff line numberDiff 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 DownExpand 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