Add a topic-grouped mockup index to mockups/README.md

data/repo-awareness-snapshot.json

@@ -1,8 +1,8 @@
 {
   "version": "repo-awareness-snapshot-v1",
   "captured_revision": {
-    "sha": "6b2d6f421ee2b2e33f4ccf4fa1d31581b452d4b4",
-    "committed_at": "2026-08-27T12:18:53+00:00"
+    "sha": "b64ecf90673ad17c8650b11318c2fd7844c05e7a",
+    "committed_at": "2026-08-27T20:45:44+08:00"
   },
   "routes": {
     "modes": [
@@ -678,41 +678,11 @@
         "file": "src/app/mockups/factsheets-topics-phone/page.tsx",
         "area": "mockup"
       },
-      {
-        "path": "/mockups/favourites-command-console",
-        "file": "src/app/mockups/favourites-command-console/page.tsx",
-        "area": "mockup"
-      },
-      {
-        "path": "/mockups/favourites-command-desk",
-        "file": "src/app/mockups/favourites-command-desk/page.tsx",
-        "area": "mockup"
-      },
-      {
-        "path": "/mockups/favourites-library-view",
-        "file": "src/app/mockups/favourites-library-view/page.tsx",
-        "area": "mockup"
-      },
       {
         "path": "/mockups/favourites-phone-perfected",
         "file": "src/app/mockups/favourites-phone-perfected/page.tsx",
         "area": "mockup"
       },
-      {
-        "path": "/mockups/favourites-review-console",
-        "file": "src/app/mockups/favourites-review-console/page.tsx",
-        "area": "mockup"
-      },
-      {
-        "path": "/mockups/favourites-set-board",
-        "file": "src/app/mockups/favourites-set-board/page.tsx",
-        "area": "mockup"
-      },
-      {
-        "path": "/mockups/favourites-set-navigator",
-        "file": "src/app/mockups/favourites-set-navigator/page.tsx",
-        "area": "mockup"
-      },
       {
         "path": "/mockups/filter-sheet-restyle",
         "file": "src/app/mockups/filter-sheet-restyle/page.tsx",
@@ -1397,9 +1367,9 @@
     ],
     "counts": {
       "modes": 15,
-      "pages": 195,
+      "pages": 189,
       "product_pages": 55,
-      "mockup_pages": 140,
+      "mockup_pages": 134,
       "redirects": 17,
       "api": 58
     }

docs/site-map.md

@@ -1212,14 +1212,8 @@ This file is generated by `npm run docs:update` (or `npm run sitemap:update` dir
 - `/mockups/document-top-navigation` - Route discovered from app directory Source: `src/app/mockups/document-top-navigation/page.tsx`.
 - `/mockups/factsheets-compact-view` - Route discovered from app directory Source: `src/app/mockups/factsheets-compact-view/page.tsx`.
 - `/mockups/factsheets-topics-phone` - Route discovered from app directory Source: `src/app/mockups/factsheets-topics-phone/page.tsx`.
-- `/mockups/favourites-command-console` - Route discovered from app directory Source: `src/app/mockups/favourites-command-console/page.tsx`.
-- `/mockups/favourites-command-desk` - Route discovered from app directory Source: `src/app/mockups/favourites-command-desk/page.tsx`.
 - `/mockups/favourites-hub` - Route discovered from app directory Source: `src/app/mockups/favourites-hub/page.tsx`.
-- `/mockups/favourites-library-view` - Route discovered from app directory Source: `src/app/mockups/favourites-library-view/page.tsx`.
 - `/mockups/favourites-phone-perfected` - Route discovered from app directory Source: `src/app/mockups/favourites-phone-perfected/page.tsx`.
-- `/mockups/favourites-review-console` - Route discovered from app directory Source: `src/app/mockups/favourites-review-console/page.tsx`.
-- `/mockups/favourites-set-board` - Route discovered from app directory Source: `src/app/mockups/favourites-set-board/page.tsx`.
-- `/mockups/favourites-set-navigator` - Route discovered from app directory Source: `src/app/mockups/favourites-set-navigator/page.tsx`.
 - `/mockups/filter-sheet-restyle` - Route discovered from app directory Source: `src/app/mockups/filter-sheet-restyle/page.tsx`.
 - `/mockups/medication-prescribing` - Route discovered from app directory Source: `src/app/mockups/medication-prescribing/page.tsx`.
 - `/mockups/mode-dropdown` - Route discovered from app directory Source: `src/app/mockups/mode-dropdown/page.tsx`.

mockups/README.md

@@ -11,6 +11,150 @@ npm run sitemap:update
 npm run sitemap:check
 ```
 
+## Mockup index, by topic
+
+A quick-scan catalogue of every route under `src/app/mockups/` and what state it's in, so
+nobody has to open 84 folders to find out what's still useful. `docs/site-map.md` remains
+the authoritative list of exact live paths (regenerate it after any change here); this
+table exists to group those paths by topic and record a status for each one.
+
+**Status key** — _Prototype app_: a full working tool, not a design sketch, out of scope
+for cleanup. _Chosen design_: the direction that was picked; still runnable for reference.
+_Active study_: still-relevant design work with no single "winner" yet, or reference
+material behind a chosen design. _Redirect_: a legacy URL kept for compatibility.
+_Superseded — recommend removing_: explicitly and in writing replaced by a later version,
+with no other mockup depending on it. _Parallel draft, no recorded winner_: one of several
+competing drafts on the same brief where nothing in the repo says which one (if any) was
+picked — kept as-is rather than guessed at.
+
+### Full prototype apps (out of scope for cleanup)
+
+| Route                | What it is                                                                                                                                                 |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `development/**`     | Developer hub — reads repo status (docs index, ingestion status, task ledger, review records, route map). Linked from Settings for signed-in admins.       |
+| `care-plan/**`       | Fully synthetic care-planning prototype (management/patient/safety plans, presentations, review), richly cross-linked.                                     |
+| `caring-contacts/**` | Fully synthetic Caring Contacts coordination prototype.                                                                                                    |
+| `ward-flow/**`       | Synthetic ward patient-flow prototype (capacity, discharge board, escalation, handover, live vehicle tracker, etc.), cross-linked via its own sidebar nav. |
+
+### Redirects
+
+| Route                    | Forwards to                |
+| ------------------------ | -------------------------- |
+| `favourites-hub`         | `/favourites`              |
+| `medication-prescribing` | `/medications/acamprosate` |
+
+### Favourites page
+
+| Route                        | Status                                               |
+| ---------------------------- | ---------------------------------------------------- |
+| `favourites-phone-perfected` | Chosen design (2026-08-27) — see the write-up above. |
+
+Six earlier studies (`favourites-command-console`, `favourites-command-desk`,
+`favourites-library-view`, `favourites-review-console`, `favourites-set-board`,
+`favourites-set-navigator`) were removed on 2026-08-27, along with their shared
+component folder `favourites-page-mockups/` — confirmed superseded by
+`favourites-phone-perfected` and confirmed (by import search) to have no other
+route depending on them before removal.
+
+### Services filter surface — three sequential rounds, keep together
+
+| Route                     | Status                                                                                          |
+| ------------------------- | ----------------------------------------------------------------------------------------------- |
+| `services-filter-refined` | Round 1. Round 2 imports its facet engine, chips and sheet shell — do not remove independently. |
+| `services-filter-options` | Round 2, builds on round 1's code.                                                              |
+| `filter-sheet-restyle`    | Round 3, a craft pass on the same decision.                                                     |
+
+### Tools page
+
+| Route                                                                                                                                                                                                                              | Status                                                                             |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `tools-search-mode`                                                                                                                                                                                                                | Chosen design — "Perfected Tools search mode" per this README.                     |
+| `tools-search-directions`                                                                                                                                                                                                          | Active reference — grounds tracked issue `#162`.                                   |
+| `tools-action-workbench`, `tools-clinical-lanes`, `tools-command-center`, `tools-split-clinical-brief`, `tools-split-compact-sheet`, `tools-split-pane`, `tools-split-safety-deck`, `tools-task-directory`, `tools-workflow-board` | Parallel drafts, no recorded winner — nine different Tools-page layout directions. |
+
+### Privacy page
+
+| Route                           | Status                                                      |
+| ------------------------------- | ----------------------------------------------------------- |
+| `privacy-live-signal-perfected` | Chosen design.                                              |
+| `privacy-page-directions`       | Active reference — the full study behind the chosen design. |
+
+### Document navigation pane — five rounds, no recorded winner
+
+`document-navigation-contract`, `document-navigation-final`, `document-navigation-final-review`,
+`document-navigation-pane`, `document-navigation-perfected` — parallel drafts on the same
+brief. Nothing in the repo states which (if any) is final, so all five are kept pending a
+design decision rather than guessed at from the names.
+
+### Document phone chrome — four rounds, no recorded winner
+
+`document-phone-fused-directions`, `document-phone-title`, `document-phone-title-refined`,
+`document-phone-zero-chrome` — same situation as above.
+
+### Document search & viewer
+
+| Route                                                                          | Status                                                                                                                  |
+| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
+| `document-search` (+ `search`, `source`, `source/evidence`, `source-overlays`) | Active reference — the master runnable document-search flow; `source-overlays` hands off into the real document viewer. |
+| `document-search-evidence-lens`                                                | Parallel draft, no recorded winner.                                                                                     |
+| `document-search-triage-board`                                                 | Parallel draft, no recorded winner.                                                                                     |
+| `document-top-navigation`                                                      | Active study — three nav concepts shown side by side, not competing routes.                                             |
+| `document-image-status`                                                        | Fixture backing a component test — keep.                                                                                |
+| `accessible-table-browser-fixture`                                             | Fixture backing a component test — keep.                                                                                |
+
+### Dictionary browse header — three rounds, no recorded winner
+
+`dictionary-browse-header`, `dictionary-browse-header-compact`, `dictionary-control-row` —
+see the dated write-ups below; each attacks a different part of the same header and none is
+recorded as the final pick.
+
+### Search chrome & composer
+
+`search-band-directions`, `search-heading`, `search-lens-menu`, `search-refine-adaptive`,
+`mode-dropdown`, `phone-inpage-navigation`, `recent-searches-bottom`, `pinned-plus-menu`,
+`universal-search-command`, `universal-search-redesign`, `sidebar-live` — parallel drafts,
+no recorded winner for any of them.
+
+### Calculators
+
+`calculators-bedside-sheet`, `calculators-clinical-console`, `calculators-directory-grid`,
+`calculators-guided-flow`, `calculators-popup-sheet`, `calculators-search`,
+`calculators-search-page`, `calculators-show-all` — parallel drafts, no recorded winner.
+
+### Settings
+
+`settings-search-clinical`, `settings-search-general`, `settings-search-privacy` — parallel
+drafts, no recorded winner.
+
+### Answer / chat
+
+`answer-chat-perfected`, `answer-chat-perfected-v2`, `answer-chat-redesign`,
+`answer-home-proposal`, `answer-evidence-popups` — parallel drafts. `answer-chat-perfected-v2`
+looks by name like it replaces `answer-chat-perfected`, but nothing in the repo says so in
+writing, so both are kept — worth a quick human check rather than a removal in this pass.
+
+### Factsheets
+
+`factsheets-compact-view`, `factsheets-topics-phone` — parallel drafts, no recorded winner.
+
+### Therapy navigation
+
+`therapy-navigation-context`, `therapy-navigation-dock`, `therapy-navigation-rail` — three
+named directions, cross-linked to each other for comparison, no recorded winner.
+
+### One-off studies
+
+| Route                        | Status                                                                                                                                    |
+| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `also-matches-accents`       | Chosen design — records the picked "also matches" accent treatment.                                                                       |
+| `verification-notice-subtle` | Active study, no recorded winner.                                                                                                         |
+| `warning-consolidation`      | Active study — first pass on consolidating warning lines.                                                                                 |
+| `warning-line`               | Active study — second pass answering a narrower, different brief (words only, no icon/border/tint); not a replacement for the first pass. |
+| `phone-mode-sheet-yes`       | Active study — design review of the shipping phone mode sheet.                                                                            |
+
+Static (non-route) design comps under `public/mockups/mode-page-redesign-2026-07/` are
+already documented below and are not part of this route index.
+
 ## Design tokens
 
 Mockups use the Clinical White / Sky Graphite role tokens (`--command`, `--clinical-accent`, `--success`) from [`docs/redesign/02-design-direction.md`](../docs/redesign/02-design-direction.md). Older design-exploration mockups were removed in July 2026 so stale palettes do not mislead future design review.