feat(dictionary): add the eight-route Dictionary reference mode

[BigSimmo]

Summary

• Adds Dictionary as a full app mode: eight routes under src/app/(search-app)/dictionary/** — Search, Browse, Topics, Topic detail, Definition, Compare, Sources, and the shared mode home.
• Content is a governed static catalogue of 96 entries in src/lib/dictionary-data.ts, with shared search/filter logic in src/lib/dictionary.ts. Nothing is generated: no clinical synthesis, no retrieval, no ranking, no provider call. Every definition carries its own source designation and review status, surfaced on /dictionary/sources.
• Interaction: unified open result rows, abbreviation ambiguity handling, URL-owned filters, topic collections, responsive comparisons, phone disclosures, and the Reference Spine visual system.
• Wired into the existing surfaces rather than bolted on: application launcher, ModeNav, universal search domains and mode context, tools catalogue, docs/site-map.md, docs/codebase-index.md, route reachability, and the design-system adoption manifests. Navigation uses <Link>/router.push and hrefs built from app-modes.ts / tools-catalog.ts; the mode uses the shared shell composer only, so the one-composer-per-page contract holds.

Verification

• npm run verify:pr-local — one stage is knowingly red; see the bundle budget note below.

Gate detail:

• Passed: check:runtime, check:installed-lock-parity, format:changed, sitemap:check, docs:check-index, docs:check-inventory, docs:check-scripts, docs:check-links, check:branch-review-ledger, check:outstanding-issues, check:ledger-write-discipline, lint, typecheck.
• Unit suite: Test Files 2 failed | 648 passed | 2 skipped (652) / Tests 2 failed | 6990 passed | 27 skipped (7019). Both failures were run down and neither belongs to this change:
  • tests/private-access-routes.test.ts passes in isolation on this branch: Test Files 1 passed (1) / Tests 145 passed (145). Full-suite contention.
  • tests/session-start-hook.test.ts fails identically on untouched origin/main — Windows resolves bash to WSL's C:\Windows\System32\bash.exe, which strips drive separators. Pre-existing harness issue.
• Later stages were then run directly: next build reported Compiled successfully, check:client-bundle-secrets passed, check:rag:fixtures 36 golden cases across 25 suites, check:medication-interactions 523 rows, check:medication-lexicon-report 28 catalogue terms — all green.
• check:bundle-budget fails on the production bucket, and the baseline was deliberately left alone:

[bundle-budget] production (what users download, 109 routes): 1516.8 KiB gzip - baseline 1372.3 KiB, +10.5% vs baseline (tolerance 10%).
[bundle-budget] FAIL - production bundle +10.5% vs baseline (tolerance 10%). This is user-facing weight; find the regression before refreshing the baseline.

Measured attribution, because the +10.5% is not all this PR:

• main alone measures 1479.1 KiB (+7.8%) against the same baseline. That number comes from a mockup-only branch built from the same merge base, so it is main's own drift. The baseline was captured 2026-08-13 (baselineSource ca788d41) and has not been refreshed since.
• This PR contributes 33.9 KiB gzip across 11 Dictionary-exclusive chunks, roughly +2.7 points, attributed from the per-route _client-reference-manifest.js files. The two largest are about 10 KiB each: the client-side share of the 96-entry catalogue, and the shared Dictionary UI. The catalogue reaches the client because Browse, Search, Compare and Sources filter interactively with URL-owned state.
• The five Lighthouse route budgets and the mockups bucket are all within tolerance.

The baseline was not refreshed here: AGENTS.md is explicit that a production failure means finding the regression rather than moving the ceiling, and most of the overage predates this branch. The decision for review is whether to re-baseline production in its own change after accounting for main's 7.8% drift, or to require this PR to move the catalogue server-side and thread it into the client pages as props — about 10 KiB, enough to clear the line, but it reworks the mode's filter model.

• After the final origin/main sync (11 further commits), npm run lint and npm run typecheck were re-run against the merged tree. The full unit suite and build were not re-run for that sync; the incoming commits touch disjoint files and were already CI-verified on main.

• tests/ui-dictionary.spec.ts is registered in the Chromium production spec pattern and in the PR shard map, so CI runs it. It was last run green (6/6) before the merge and was not re-run locally afterwards.

• npm run verify:ui when UI, routing, styling, browser behavior, reduced-motion, or forced-colors behavior changed

UI verification not run locally after the merge: the full Chromium gate contends with the repository run coordinator on this machine. The Dictionary journey spec is registered and runs in CI.

• npm run verify:release before release or handoff confidence claims

Verification not run: the release gate is provider-backed and was not authorized for this change.

• npm run eval:retrieval:quality (must stay 36/36) when retrieval, ranking, selection, chunking, or scoring behavior changed

Verification not run: no retrieval, ranking, selection, chunking or scoring behaviour is touched. The Dictionary reads a static local catalogue; it does not enter src/lib/rag/**, clinical-search, retrieval-selection, ranking-config or answer-ranking, and the offline RAG fixture check still ran and passed.

• npm run eval:rag -- --limit 15 + npm run eval:quality -- --rag-only when answer generation, the synthesis prompt, or answer post-processing changed

Verification not run: answer generation and the synthesis prompt are untouched.

• npm run check:production-readiness when clinical workflow, privacy, environment, Supabase, source governance, or deployment behavior changed

Verification not run: no clinical workflow, privacy, environment, Supabase or source-governance behaviour changes — the Dictionary is static local content with no provider, storage or document-access path.

• npm run check:deployment-readiness when deployment startup, hosting, or rollout behavior changed

Verification not run: deployment startup, hosting and rollout behaviour are unchanged.

Risk and rollout

• Risk: Moderate. This adds production routes and touches shared navigation/search integration files (app-modes.ts, universal-search*.ts, search-route-ownership.ts, search-shell-props.ts, tools-catalog.ts, ClinicalDashboard.tsx, ClinicalSidebar.tsx, master-search-header.tsx). The Dictionary itself is read-only static content with no write path, no auth surface and no provider call, so the realistic failure mode is a navigation or search-integration regression rather than a clinical one. src/lib/universal-search.ts remains server-only — the two client modules that reference it use type-only imports, so the catalogue does not enter every route's bundle.
• Rollback: Revert this PR's squash commit. The mode is additive; no existing route, mode or search domain is removed or repointed.
• Provider or production effects: None. No Supabase, OpenAI, storage or ingestion behaviour changes.

Clinical Governance Preflight

• Source-backed claims still require linked source verification before clinical use
• No patient-identifiable document workflow was introduced or expanded without explicit governance approval
• Supabase target remains Clinical KB Database (sjrfecxgysukkwxsowpy)
• Service-role keys and private document access remain server-only
• Demo/synthetic content remains clearly separated from real clinical sources
• Source metadata, review status, and outdated/unknown-source behavior remain conservative
• Deployment classification/TGA SaMD impact was checked when clinical decision-support behavior changed

Notes on the preflight: every Dictionary entry is static, source-designated content. /dictionary/sources renders the governance surface, and an entry whose source is unknown or unreviewed displays that status rather than presenting the text as verified fact. The mode introduces no patient data, no document access and no upload or download path. Supabase configuration, service-role credentials and private document access are untouched. The Dictionary defines terminology and does not recommend, diagnose or dose, so it adds no clinical decision-support behaviour and leaves the SaMD/TGA classification unchanged.

Notes

• Opened as a draft.
• Branch history: the work was completed on codex/chat-dictionary-ultimate-dictionary-ultimate and committed here, then origin/main was merged in (the branch was 96 commits behind, and a final sync brought it fully current). Six files conflicted; the resolutions worth reviewing are the icon ones, because main refactored icon identity while this branch was open:
  • src/lib/app-mode-icons.ts is now derived from APP_MODE_ICON in src/lib/category-identity.ts, so the Dictionary glyph moved there: bookMarked was added to CATEGORY_ICON_KEYS, resolved to Lucide BookMarked in src/lib/category-identity-icons.ts, and registered as dictionary: "bookMarked" (app mode) and "clinical-dictionary": "bookMarked" (tool).
  • "clinical-dictionary" was added to the ToolCatalogId union in src/lib/tools-catalog.ts, which main introduced to make the icon record exhaustive by type.
  • The two icon maps this branch had edited (launcherIconById in applications-launcher-page.tsx, iconByToolId in tools-search-results-page.tsx) were deleted by main in favour of that single registry; the merge takes main's side rather than reviving either copy.
  • playwright.config.ts and scripts/playwright-pr-shards.mjs keep main's patterns with dictionary re-inserted; docs/design-system/COMPONENTS.md and the design-system adoption manifests were regenerated, not hand-merged.

[supabase]

This pull request has been ignored for the connected project sjrfecxgysukkwxsowpy because there are no changes detected in supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.

---

Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

[coderabbitai]

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in: 55 minutes

Limit details: You’ve used all 1 included review currently available under your plan. You completed 101 included PR reviews in the past 7 days; at that activity level, included reviews refill at 1 review per hour.

Your organization has reached its usage spending cap. Adjust your spending cap in the billing tab.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: ecd392e0-7a78-4bd0-a00b-03e6ece8e8a4

📥 Commits

Reviewing files that changed from the base of the PR and between 70821d6 and 15fd063.

📒 Files selected for processing (61)

• docs/branch-review-records/958545248192195caf5c7b0a29d7daf058011f92c1b70d00c86aec57fb44822b.record.md
• docs/codebase-index.md
• docs/design-system/ADOPTION.md
• docs/design-system/COMPONENTS.md
• docs/design-system/adoption-contract.json
• docs/design-system/adoption-manifest.json
• docs/redesign/dictionary-reference-spine.md
• docs/site-map.md
• playwright.config.ts
• scripts/generate-site-map.ts
• scripts/playwright-pr-shards.mjs
• src/app/(search-app)/dictionary/[slug]/page.tsx
• src/app/(search-app)/dictionary/browse/page.tsx
• src/app/(search-app)/dictionary/compare/page.tsx
• src/app/(search-app)/dictionary/layout.tsx
• src/app/(search-app)/dictionary/page.tsx
• src/app/(search-app)/dictionary/search/page.tsx
• src/app/(search-app)/dictionary/sources/page.tsx
• src/app/(search-app)/dictionary/topics/[slug]/page.tsx
• src/app/(search-app)/dictionary/topics/page.tsx
• src/components/ClinicalDashboard.tsx
• src/components/clinical-dashboard/ClinicalSidebar.tsx
• src/components/clinical-dashboard/master-search-header.tsx
• src/components/clinical-dashboard/mode-action-popup.tsx
• src/components/clinical-dashboard/universal-search-command-surface.tsx
• src/components/clinical-dashboard/use-sidebar-pins.ts
• src/components/dictionary/dictionary-catalogue-pages.tsx
• src/components/dictionary/dictionary-compare-page.tsx
• src/components/dictionary/dictionary-home-page.tsx
• src/components/dictionary/dictionary-result-row.tsx
• src/components/dictionary/dictionary-sources-page.tsx
• src/components/dictionary/dictionary-term-page.tsx
• src/components/mode-nav/header-addon-slot.ts
• src/components/mode-nav/registry-mode-nav.tsx
• src/lib/app-modes.ts
• src/lib/category-identity-icons.ts
• src/lib/category-identity.ts
• src/lib/dictionary-data.ts
• src/lib/dictionary.ts
• src/lib/information-pages.ts
• src/lib/mode-secondary-navigation.ts
• src/lib/search-route-ownership.ts
• src/lib/search-shell-props.ts
• src/lib/tools-catalog.ts
• src/lib/ui-copy.ts
• src/lib/universal-search-domains.ts
• src/lib/universal-search-mode-context.ts
• src/lib/universal-search.ts
• tests/app-modes.test.ts
• tests/design-system-adoption.test.ts
• tests/dictionary-data.test.ts
• tests/dictionary-term-page.dom.test.tsx
• tests/information-page-shell.dom.test.tsx
• tests/mode-nav-addon-slot.dom.test.tsx
• tests/mode-secondary-navigation.test.ts
• tests/search-results-band-adoption.test.ts
• tests/shared-home-empty-state.dom.test.tsx
• tests/ui-dictionary.spec.ts
• tests/ui-mode-nav-density.spec.ts
• tests/ui-tools-search-mode-mockup.spec.ts
• tests/ui-tools.spec.ts

---

_{Comment @coderabbitai help to get the list of available commands.}

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.

[github-actions]

CI triage

CI failed on this PR. Automated classification of the 3 failed job(s):

• Build — needs investigation: inspect the failing step and uploaded diagnostics; rerun only after classifying the cause.
• Advisory UI — needs investigation: inspect the failing step and uploaded diagnostics; rerun only after classifying the cause.
• PR required — needs investigation: inspect the failing step and uploaded diagnostics; rerun only after classifying the cause.

Compared with main CI run #11965 (cancelled).

Classification is evidence routing, not permission to ignore a failure. Exact quarantined Playwright identities remain governed by the flake ledger.

[Copilot]

Pull request overview

Adds a static Clinical Dictionary mode with eight production routes, shared navigation/search integration, source metadata, and responsive UI.

Changes:

• Adds a 96-entry catalogue with search, browse, topics, definitions, comparisons, and sources.
• Integrates Dictionary into app modes, universal search, navigation, tools, and shell ownership.
• Adds unit/UI coverage and generated documentation; the production bundle gate remains unresolved.

Reviewed changes

Copilot reviewed 60 out of 60 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/ui-tools.spec.ts	Updates tools search expectations.
tests/ui-mode-nav-density.spec.ts	Covers Dictionary navigation density.
tests/ui-dictionary.spec.ts	Tests all Dictionary routes and responsive behavior.
tests/shared-home-empty-state.dom.test.tsx	Covers Dictionary home presentation.
tests/search-results-band-adoption.test.ts	Registers Dictionary search-band ownership.
tests/mode-secondary-navigation.test.ts	Tests Dictionary secondary navigation.
tests/mode-nav-addon-slot.dom.test.tsx	Registers Dictionary header owners.
tests/information-page-shell.dom.test.tsx	Classifies Dictionary information routes.
tests/dictionary-term-page.dom.test.tsx	Tests term-page content and disclosures.
tests/dictionary-data.test.ts	Validates catalogue integrity and search.
tests/design-system-adoption.test.ts	Updates route adoption totals.
tests/app-modes.test.ts	Covers Dictionary search routing.
src/lib/universal-search.ts	Adds the Dictionary search adapter.
src/lib/universal-search-mode-context.ts	Maps Dictionary mode context.
src/lib/universal-search-domains.ts	Registers the Dictionary domain.
src/lib/ui-copy.ts	Adds Dictionary home copy.
src/lib/tools-catalog.ts	Adds Dictionary to the tools catalogue.
src/lib/search-shell-props.ts	Configures Dictionary shell behavior.
src/lib/search-route-ownership.ts	Assigns Dictionary route ownership.
src/lib/mode-secondary-navigation.ts	Defines Dictionary navigation destinations.
src/lib/information-pages.ts	Recognizes Dictionary detail pages.
src/lib/dictionary.ts	Implements filtering, search, and comparison helpers.
src/lib/dictionary-data.ts	Defines the static governed catalogue.
src/lib/category-identity.ts	Registers Dictionary icon identities.
src/lib/category-identity-icons.ts	Maps the BookMarked icon.
src/lib/app-modes.ts	Registers Dictionary as an app mode.
src/components/mode-nav/registry-mode-nav.tsx	Adds Dictionary navigation icons and density.
src/components/mode-nav/header-addon-slot.ts	Registers Dictionary header slots.
src/components/dictionary/dictionary-catalogue-pages.tsx	Implements search, browse, and topic pages.
src/components/dictionary/dictionary-term-page.tsx	Implements definition detail pages.
src/components/dictionary/dictionary-sources-page.tsx	Implements source governance UI.
src/components/dictionary/dictionary-result-row.tsx	Renders mixed Dictionary results.
src/components/dictionary/dictionary-home-page.tsx	Implements the mode landing page.
src/components/dictionary/dictionary-compare-page.tsx	Implements term comparisons.
src/components/ClinicalDashboard.tsx	Updates shared-mode commentary.
src/components/clinical-dashboard/use-sidebar-pins.ts	Makes Dictionary pinnable.
src/components/clinical-dashboard/universal-search-command-surface.tsx	Adds Dictionary command results.
src/components/clinical-dashboard/mode-action-popup.tsx	Adds Dictionary quick actions.
src/components/clinical-dashboard/master-search-header.tsx	Adds Dictionary mode actions and routing.
src/components/clinical-dashboard/ClinicalSidebar.tsx	Adds Dictionary to sidebar modes.
src/app/(search-app)/dictionary/page.tsx	Adds the Dictionary home route.
src/app/(search-app)/dictionary/search/page.tsx	Adds the search route.
src/app/(search-app)/dictionary/browse/page.tsx	Adds the browse route.
src/app/(search-app)/dictionary/topics/page.tsx	Adds the topics route.
src/app/(search-app)/dictionary/topics/[slug]/page.tsx	Adds topic detail routes.
src/app/(search-app)/dictionary/[slug]/page.tsx	Adds definition routes.
src/app/(search-app)/dictionary/compare/page.tsx	Adds the comparison route.
src/app/(search-app)/dictionary/sources/page.tsx	Adds the sources route.
src/app/(search-app)/dictionary/layout.tsx	Adds the Dictionary route layout.
scripts/playwright-pr-shards.mjs	Registers Dictionary UI tests in CI.
scripts/generate-site-map.ts	Adds the Dictionary mode example.
playwright.config.ts	Includes Dictionary production tests.
docs/site-map.md	Documents Dictionary routes.
docs/redesign/dictionary-reference-spine.md	Defines Dictionary design and governance.
docs/design-system/COMPONENTS.md	Updates generated component usage.
docs/design-system/ADOPTION.md	Updates adoption totals.
docs/design-system/adoption-manifest.json	Registers Dictionary design-system roots.
docs/design-system/adoption-contract.json	Adds Dictionary routes to the contract.
docs/codebase-index.md	Documents Dictionary architecture.
docs/branch-review-records/958545248192195caf5c7b0a29d7daf058011f92c1b70d00c86aec57fb44822b.record.md	Records the prior branch review.

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.