\n+ \n \n- Sample content shown — edit every field with your patient.\n+ Confirm every contact and crisis number with your patient before printing or sharing this plan.\n

\n \n \n- \n+ \n );\n }\ndiff --git a/src/components/therapy-compass/screens/home-screen.tsx b/src/components/therapy-compass/screens/home-screen.tsx\nindex bcd28c0e8b9a3dedfdd1930dc75d14c2ca1619a5..da2bd5e1e5a3419fb4265c78487d5f44df9b8be3 100644\n--- a/src/components/therapy-compass/screens/home-screen.tsx\n+++ b/src/components/therapy-compass/screens/home-screen.tsx\n@@ -11,51 +11,51 @@ import { LoadingState } from \"../ui\";\n const SUGGESTIONS = [\n \"Anxiety in outpatient care\",\n \"Low mood & motivation\",\n \"Trauma-focused\",\n \"5-minute grounding\",\n \"Relapse prevention\",\n ];\n \n export function HomeScreen() {\n const b = useTcBindings();\n \n // Avoid presenting an empty or fabricated catalogue while required data loads.\n if (b.loading && b.therapies.length === 0) {\n return ;\n }\n \n const therapyCountCopy =\n b.therapies.length === 0\n ? \"Source-grounded therapy records.\"\n : `${b.therapies.length} source-grounded therapy ${b.therapies.length === 1 ? \"record\" : \"records\"}.`;\n \n return (\n \n \n \n \n );\n }\n \n function TherapyCompassDataError() {\n const b = useTcBindings();\n return (\n

\n-

Therapy Compass could not load

\n+

Therapy mode could not load

\n The therapy catalogue is unavailable. No results are being shown as a substitute.\n

\n \n {b.loading ? \"Retrying…\" : \"Retry\"}\n \n

\n );\n }\n \n function TherapyCompassMain({\n children,\n showFooter,\n asMain,\n }: {\n children: ReactNode;\n showFooter: boolean;\n /** Home renders ModeHomeMain; keep a non-main shell so landmarks are not nested. */\n asMain: boolean;\ndiff --git a/src/components/tools-page-mockups/tool-fixtures.ts b/src/components/tools-page-mockups/tool-fixtures.ts\nindex cbd395bafc864f08ecf4358a64ea48c279f79c69..3474f619a2588e2ad56567b8e1b5d952c8869a0d 100644\n--- a/src/components/tools-page-mockups/tool-fixtures.ts\n+++ b/src/components/tools-page-mockups/tool-fixtures.ts\n@@ -1,26 +1,26 @@\n-import { Brain, FileCheck2, FileText, Pill, Search, Star, type LucideIcon } from \"lucide-react\";\n+import { Brain, ClipboardList, FileCheck2, FileText, Pill, Search, Star, type LucideIcon } from \"lucide-react\";\n import { appModeIcons } from \"@/lib/app-mode-icons\";\n import { toolCatalogRecordById } from \"@/lib/tools-catalog\";\n \n export type ToolStatus = \"ready\" | \"review_due\" | \"recent\";\n export type ToolArea = \"reference\" | \"assessment\" | \"care\" | \"coordination\" | \"personal\";\n \n export type ToolFixture = {\n id: string;\n title: string;\n description: string;\n href: string;\n icon: LucideIcon;\n area: ToolArea;\n sourceBacked: boolean;\n status: ToolStatus;\n lastUsed: string;\n primaryAction: string;\n secondary: string;\n };\n \n // Identity (title/description/href/sourceBacked) comes from the shared tools catalog\n // (src/lib/tools-catalog.ts); only mockup-specific presentation extras live here.\n type ToolFixtureExtras = {\n id: string;\n icon: LucideIcon;\n@@ -66,50 +66,59 @@ const fixtureExtras: ToolFixtureExtras[] = [\n icon: Pill,\n area: \"care\",\n status: \"review_due\",\n lastUsed: \"May 12, 2025\",\n primaryAction: \"Prescribe\",\n secondary: \"Monitoring, interactions, templates\",\n },\n {\n id: \"services\",\n icon: appModeIcons.services,\n area: \"coordination\",\n status: \"review_due\",\n lastUsed: \"Today, 8:15 AM\",\n primaryAction: \"Refer\",\n secondary: \"Access pathways, criteria, contacts\",\n },\n {\n id: \"forms\",\n icon: FileCheck2,\n area: \"coordination\",\n status: \"ready\",\n lastUsed: \"Today, 8:05 AM\",\n primaryAction: \"Open\",\n secondary: \"Forms, tasks, pathway checks\",\n },\n+ {\n+ id: \"safety-plan\",\n+ icon: ClipboardList,\n+ area: \"care\",\n+ status: \"ready\",\n+ lastUsed: \"Today, 9:10 AM\",\n+ primaryAction: \"Open\",\n+ secondary: \"Warning signs, coping, supports, means safety\",\n+ },\n {\n id: \"favourites\",\n icon: Star,\n area: \"personal\",\n status: \"recent\",\n lastUsed: \"Today, 8:45 AM\",\n primaryAction: \"Resume\",\n secondary: \"Saved items, recent work, pins\",\n // The mockups keep the shorter historical framing for this entry.\n title: \"Favourites\",\n description: \"Return to saved clinical work, sources, and repeated workflows.\",\n },\n ];\n \n export const tools: ToolFixture[] = fixtureExtras.map((extras) => {\n const record = toolCatalogRecordById(extras.id);\n return {\n id: record.id,\n title: extras.title ?? record.title,\n description: extras.description ?? record.description,\n href: record.href,\n sourceBacked: record.sourceBacked,\n icon: extras.icon,\n area: extras.area,\n status: extras.status,\ndiff --git a/src/lib/app-modes.ts b/src/lib/app-modes.ts\nindex 5bd72ee752193c04a3d2fde428a8b1efba655b42..c28b9b68bbba24373f8c390f3c772b8ddf6094ae 100644\n--- a/src/lib/app-modes.ts\n+++ b/src/lib/app-modes.ts\n@@ -289,72 +289,72 @@ export const appModeDefinitions = [\n },\n {\n id: \"tools\",\n label: \"Tools\",\n description: \"Clinical tools and applications\",\n href: \"/?mode=tools\",\n search: {\n kind: \"tools\",\n placeholder: \"Search tools...\",\n inputAriaLabel: \"Search clinical tools and applications\",\n submitIdleLabel: \"Tools\",\n submitBusyLabel: \"Tools\",\n submitAriaLabel: \"Search tools\",\n emptyTitle: \"Browse tools\",\n readyTitle: \"Search clinical tools\",\n progressLabel: \"Searching tools.\",\n resultKind: \"tools\",\n resultHeading: \"Tools\",\n statusLabel: \"Tools\",\n nextStep: \"Launch a tool\",\n badgeLabel: null,\n },\n },\n {\n id: \"therapy-compass\",\n- label: \"Therapy\",\n+ label: \"Therapy mode\",\n description: \"Source-grounded therapy decision support\",\n href: \"/therapy-compass\",\n // Cleared for production discovery: the re-curated therapy pathways have\n // qualified-clinician sign-off, so Therapy is now a first-class mode in the\n // production sidebar and MODE dropdown (no longer devOnly-gated).\n search: {\n // Therapy Compass owns its in-tool search over the imported therapy library\n // (not the document corpus), so it borrows the benign \"tools\" search kind and\n // suppresses the universal composer on its route.\n kind: \"tools\",\n placeholder: \"Search therapies, symptoms, or skills...\",\n inputAriaLabel: \"Search therapies by problem, symptom, skill, or population\",\n- submitIdleLabel: \"Therapy\",\n- submitBusyLabel: \"Therapy\",\n- submitAriaLabel: \"Open Therapy\",\n+ submitIdleLabel: \"Therapy mode\",\n+ submitBusyLabel: \"Therapy mode\",\n+ submitAriaLabel: \"Open Therapy mode\",\n emptyTitle: \"Browse the therapy library\",\n readyTitle: \"Search source-grounded therapies\",\n progressLabel: \"Loading the therapy library.\",\n resultKind: \"tools\",\n resultHeading: \"Therapies\",\n- statusLabel: \"Therapy\",\n+ statusLabel: \"Therapy mode\",\n nextStep: \"Open a therapy record\",\n badgeLabel: null,\n },\n },\n {\n id: \"factsheets\",\n label: \"Factsheets\",\n description: \"Plain-language patient information to read, save, and print\",\n href: \"/factsheets\",\n search: {\n // Factsheets owns its own in-tool search over the local patient-information\n // library (not the document corpus), so it borrows the benign \"tools\" search\n // kind — like Therapy Compass — while keeping the shared composer visible.\n kind: \"tools\",\n placeholder: \"Search a medicine, condition, therapy or test…\",\n inputAriaLabel: \"Search patient information factsheets\",\n submitIdleLabel: \"Sheets\",\n submitBusyLabel: \"Sheets\",\n submitAriaLabel: \"Search patient information factsheets\",\n emptyTitle: \"Search patient information\",\n readyTitle: \"Find a patient factsheet\",\n progressLabel: \"Searching patient factsheets.\",\n resultKind: \"tools\",\n resultHeading: \"Factsheets\",\n statusLabel: \"Factsheets\",\ndiff --git a/src/lib/tools-catalog.ts b/src/lib/tools-catalog.ts\nindex 5c56ee524fa4137a7ab6be162690284210dffbe6..f5d6aae3d61f41c50e474fa3d31f69fafd18eb38 100644\n--- a/src/lib/tools-catalog.ts\n+++ b/src/lib/tools-catalog.ts\n@@ -176,50 +176,79 @@ export const toolCatalogRecords: ToolCatalogRecord[] = [\n sourceBacked: true,\n highYield: true,\n actionLabel: \"Open\",\n keywords: [\"forms\", \"paperwork\", \"readiness\", \"pathway\"],\n checkFirst: [\"Current form version\", \"Required fields\", \"Linked service pathway\"],\n neededInput: [\"Form type\", \"Clinical pathway\", \"Patient or service context\"],\n output: \"Relevant form, readiness tasks, and source-backed pathway details.\",\n },\n {\n id: \"care-plans\",\n title: \"Care plans\",\n description: \"Create and review management plans with monitoring and follow-up.\",\n bestFor: \"Ongoing care planning\",\n detail: \"Structure care planning, review milestones, monitoring needs, and follow-up tasks.\",\n href: \"/?mode=answer&q=care%20plan&focus=1\",\n area: \"care\",\n status: \"ready\",\n sourceBacked: true,\n highYield: true,\n actionLabel: \"Open\",\n keywords: [\"care plan\", \"management\", \"follow-up\", \"monitoring\"],\n checkFirst: [\"Goals of care\", \"Review date\", \"Monitoring responsibilities\"],\n neededInput: [\"Diagnosis or working problem\", \"Current plan\", \"Follow-up timeframe\"],\n output: \"Care-plan structure, review points, and monitoring prompts.\",\n },\n+ {\n+ id: \"safety-plan\",\n+ title: \"Safety plan\",\n+ mobileTitle: \"Safety plan\",\n+ description: \"Build a patient safety plan with the Stanley-Brown six steps and a printable copy.\",\n+ bestFor: \"Collaborative safety planning\",\n+ detail:\n+ \"Build an evidence-based safety plan with the patient — warning signs, coping strategies, supports, and means safety — with a live patient copy to print, save as PDF, or hand over.\",\n+ href: \"/safety-plan\",\n+ area: \"care\",\n+ status: \"ready\",\n+ sourceBacked: false,\n+ safetyFirst: true,\n+ actionLabel: \"Open\",\n+ keywords: [\n+ \"safety plan\",\n+ \"safety planning\",\n+ \"crisis\",\n+ \"crisis plan\",\n+ \"stanley brown\",\n+ \"coping\",\n+ \"warning signs\",\n+ \"suicide\",\n+ \"means safety\",\n+ ],\n+ checkFirst: [\"Current risk and recent changes\", \"Warning signs and triggers\", \"Trusted supports and crisis lines\"],\n+ neededInput: [\"Warning signs\", \"Coping strategies and supports\", \"Crisis contacts and means-safety steps\"],\n+ output: \"A six-step safety plan with a patient copy to print, save as PDF, or hand over.\",\n+ },\n {\n id: \"monitoring\",\n title: \"Monitoring\",\n description: \"Track and review key monitoring parameters and results.\",\n bestFor: \"Ongoing monitoring\",\n detail: \"Review monitoring intervals, parameters, alerts, and follow-up actions.\",\n href: \"/?mode=answer&q=monitoring%20schedule&focus=1\",\n area: \"care\",\n status: \"ready\",\n sourceBacked: true,\n highYield: true,\n actionLabel: \"Open\",\n keywords: [\"monitoring\", \"results\", \"parameters\", \"schedule\", \"labs\"],\n checkFirst: [\"Monitoring indication\", \"Last result date\", \"Thresholds and alerts\"],\n neededInput: [\"Medication or condition\", \"Recent results\", \"Monitoring timeframe\"],\n output: \"Monitoring schedule, thresholds, and review prompts.\",\n },\n {\n id: \"favourites\",\n title: \"Saved workflows\",\n mobileTitle: \"Saved\",\n description: \"Return to saved clinical workspaces and repeated workflows.\",\n bestFor: \"Repeated or complex work\",\n detail: \"Resume saved answers, pinned sources, and repeated clinical workflows.\",\n href: \"/favourites\",\ndiff --git a/tests/design-system-contract-utils.test.ts b/tests/design-system-contract-utils.test.ts\nindex f5f45f39edf9c9ec1dd9dcd47cbabc34081711a5..0f3f6916f8f1e3cc975c2d7006a5ca9fd99645bb 100644\n--- a/tests/design-system-contract-utils.test.ts\n+++ b/tests/design-system-contract-utils.test.ts\n@@ -33,35 +33,103 @@ describe(\"design-system contract helpers\", () => {\n \"@media print { /* an opening brace here must be inert: { */ body { background: #ffffff; } }\",\n ].join(\"\\n\");\n const scopedTherapy = rawColorContractSource(\n \"src/components/therapy-compass/therapy-compass.css\",\n therapySource,\n reportFailure,\n );\n expect(scopedTherapy).toContain(\"#123456\");\n expect(scopedTherapy).toContain(\"#654321\");\n expect(scopedTherapy).not.toContain(\"#ffffff\");\n \n const factsheetSource = [\n 'const appChrome = \"#123456\";',\n 'function FactsheetPrintSheet() { return

; }',\n ].join(\"\\n\");\n const scopedFactsheet = rawColorContractSource(\n \"src/components/factsheets/factsheet-detail-page.tsx\",\n factsheetSource,\n reportFailure,\n );\n expect(scopedFactsheet).toContain(\"#123456\");\n expect(scopedFactsheet).not.toContain(\"#ffffff\");\n expect(reportFailure).not.toHaveBeenCalled();\n });\n \n+ it(\"masks only the pre-paint theme-color constant, not the rest of theme.ts\", () => {\n+ const reportFailure = vi.fn();\n+ const source = [\n+ \"export const APP_THEME_COLORS = {\",\n+ ' light: \"#ffffff\",',\n+ ' dark: \"#060708\",',\n+ \"} as const satisfies Record;\",\n+ \"\",\n+ \"// A later, unrelated raw colour in this file must stay countable — the\",\n+ \"// whole-file exemption this replaced would have hidden it.\",\n+ 'export const UNRELATED_ACCENT = \"#0f766e\";',\n+ 'export const SCRIPT = `var c=d?\"${APP_THEME_COLORS.dark}\":\"${APP_THEME_COLORS.light}\";`;',\n+ ].join(\"\\n\");\n+\n+ const scoped = rawColorContractSource(\"src/lib/theme.ts\", source, reportFailure);\n+\n+ expect(scoped).not.toContain(\"#ffffff\");\n+ expect(scoped).not.toContain(\"#060708\");\n+ expect(scoped).toContain(\"#0f766e\");\n+ // The interpolating bootstrap script holds no literals of its own and must\n+ // survive masking intact.\n+ expect(scoped).toContain(\"APP_THEME_COLORS.dark\");\n+ expect(reportFailure).not.toHaveBeenCalled();\n+ });\n+\n+ it(\"anchors the theme-color boundary on the declaration, not a passing mention\", () => {\n+ const reportFailure = vi.fn();\n+ // A doc comment naming the constant sits ABOVE an unrelated raw colour. A\n+ // bare \"APP_THEME_COLORS\" marker would anchor on that mention and mask\n+ // everything from the comment through the block, silently swallowing the\n+ // unrelated colour with no failure reported. Masking runs before comments\n+ // are stripped, so comment-stripping does not rescue it.\n+ const source = [\n+ \"// Pre-paint values live in APP_THEME_COLORS below.\",\n+ 'export const UNRELATED_ACCENT = \"#0f766e\";',\n+ \"export const APP_THEME_COLORS = {\",\n+ ' light: \"#ffffff\",',\n+ ' dark: \"#060708\",',\n+ \"} as const;\",\n+ ].join(\"\\n\");\n+\n+ const scoped = rawColorContractSource(\"src/lib/theme.ts\", source, reportFailure);\n+\n+ expect(scoped).toContain(\"#0f766e\");\n+ expect(scoped).not.toContain(\"#ffffff\");\n+ expect(scoped).not.toContain(\"#060708\");\n+ expect(reportFailure).not.toHaveBeenCalled();\n+ });\n+\n+ it(\"fails closed when the pre-paint theme-color boundary disappears\", () => {\n+ const reportFailure = vi.fn();\n+ // The constant was renamed/removed but the exemption still matches the path.\n+ const source = 'export const THEME_COLORS = { light: \"#ffffff\" };';\n+\n+ // Unmasked, so both literals are counted and the ratcheted baseline goes red\n+ // rather than silently exempting the file.\n+ expect(rawColorContractSource(\"src/lib/theme.ts\", source, reportFailure)).toBe(source);\n+ expect(reportFailure).toHaveBeenCalledWith(\"pre-paint theme-color boundary is missing\");\n+ });\n+\n+ it(\"does not mistake a renamed/suffixed declaration for the real APP_THEME_COLORS boundary\", () => {\n+ const reportFailure = vi.fn();\n+ const source = 'export const APP_THEME_COLORS_V2 = { light: \"#ffffff\" };';\n+\n+ expect(rawColorContractSource(\"src/lib/theme.ts\", source, reportFailure)).toBe(source);\n+ expect(reportFailure).toHaveBeenCalledWith(\"pre-paint theme-color boundary is missing\");\n+ });\n+\n it(\"fails closed when a fixed-paper boundary disappears\", () => {\n const reportFailure = vi.fn();\n const source = \".tc-app { color: #123456; }\";\n \n expect(rawColorContractSource(\"src/components/therapy-compass/therapy-compass.css\", source, reportFailure)).toBe(\n source,\n );\n expect(reportFailure).toHaveBeenCalledWith(\"printable Therapy paper raw-color boundaries are missing\");\n });\n });\ndiff --git a/tests/route-reachability.test.ts b/tests/route-reachability.test.ts\nindex d020f9a06ae30ca0c2745ff1847be40a91f6999d..f9ff1fea51042506de9d00fa7e48cc49c704b76c 100644\n--- a/tests/route-reachability.test.ts\n+++ b/tests/route-reachability.test.ts\n@@ -1,158 +1,628 @@\n import { readFileSync, readdirSync } from \"node:fs\";\n import path from \"node:path\";\n \n+import { parse } from \"@babel/parser\";\n import { describe, expect, it } from \"vitest\";\n \n import { appModeDefinitions, appModeHomeHref } from \"@/lib/app-modes\";\n import { tools } from \"@/components/tools-page-mockups/tool-fixtures\";\n import { collectSiteMapData } from \"../scripts/generate-site-map\";\n \n /**\n * Orphan-route guard. `site-map.test.ts` proves every route is *documented*;\n * this proves every static production page route is *reachable* — i.e. some\n * in-app navigation actually links to it. A page you can only reach by typing\n * its URL (the `/tools` class) is an orphan and must be either wired into nav\n * or added, with a reason, to REACHABILITY_ALLOWLIST below.\n *\n * Scope: static page routes only. Dynamic `[slug]` detail routes are reached\n * via href builders from live/seeded data (`universal-search.ts`, registry\n * loaders); their targets are covered by `site-map.test.ts`'s documented-href\n * assertions, and pattern-matching interpolated hrefs here would be brittle.\n * Mockups (`src/app/mockups/**`, `*-mockups/**`) are design-scratch and 404 in\n * production, so a link *from* a mockup does not count and mockup routes are\n * not required to be linked.\n */\n \n const repoRoot = process.cwd();\n const srcRoot = path.join(repoRoot, \"src\");\n \n /** Intentionally-unlinked static page routes, each with the reason it is exempt. */\n const REACHABILITY_ALLOWLIST = new Map([\n [\n \"/tools\",\n \"Orphan parallel to /?mode=tools; nothing links to the standalone page. Tracked as issue #007 (decide the canonical Tools entry point). Reachable via URL and the /applications redirect.\",\n ],\n [\n \"/documents/source\",\n \"Legacy compatibility redirect target reached by external/legacy deep links, not in-app navigation (frontend-architecture.md).\",\n ],\n [\n \"/documents/source/evidence\",\n \"Legacy compatibility redirect target reached by external/legacy deep links, not in-app navigation (frontend-architecture.md).\",\n ],\n ]);\n \n function isMockupPath(relPosix: string) {\n return relPosix.toLowerCase().includes(\"mockup\");\n }\n \n function pathOnly(href: string) {\n return href.split(/[?#]/)[0] || \"/\";\n }\n \n-function collectSourceFiles(dir: string): { rel: string; content: string }[] {\n- const out: { rel: string; content: string }[] = [];\n+const ROUTER_METHODS = new Set([\"push\", \"replace\"]);\n+const FUNCTION_NODE_TYPES = new Set([\n+ \"ArrowFunctionExpression\",\n+ \"ClassMethod\",\n+ \"ClassPrivateMethod\",\n+ \"FunctionDeclaration\",\n+ \"FunctionExpression\",\n+ \"ObjectMethod\",\n+]);\n+\n+type AstNode = Record;\n+type BindingKind =\n+ \"mode-home-template\" | \"next-link\" | \"next-redirect\" | \"next-response\" | \"next-use-router\" | \"other\" | \"router\";\n+\n+type Scope = {\n+ bindings: Map;\n+ parent: Scope | null;\n+};\n+\n+function asNode(value: unknown): AstNode | null {\n+ return value && typeof value === \"object\" && typeof (value as AstNode).type === \"string\" ? (value as AstNode) : null;\n+}\n+\n+function isFunctionNode(node: AstNode) {\n+ return FUNCTION_NODE_TYPES.has(String(node.type));\n+}\n+\n+function identifierName(node: AstNode | null) {\n+ return node?.type === \"Identifier\" && typeof node.name === \"string\" ? node.name : null;\n+}\n+\n+function jsxIdentifierName(node: AstNode | null) {\n+ return node?.type === \"JSXIdentifier\" && typeof node.name === \"string\" ? node.name : null;\n+}\n+\n+function importedName(node: AstNode | null) {\n+ if (!node) return null;\n+ if (node.type === \"Identifier\" && typeof node.name === \"string\") return node.name;\n+ if (node.type === \"StringLiteral\" && typeof node.value === \"string\") return node.value;\n+ return null;\n+}\n+\n+function declarePattern(pattern: AstNode | null, scope: Scope) {\n+ if (!pattern) return;\n+ const name = identifierName(pattern);\n+ if (name) {\n+ scope.bindings.set(name, \"other\");\n+ return;\n+ }\n+ if (pattern.type === \"RestElement\" || pattern.type === \"AssignmentPattern\") {\n+ declarePattern(asNode(pattern.argument ?? pattern.left), scope);\n+ return;\n+ }\n+ if (pattern.type === \"ObjectProperty\") {\n+ declarePattern(asNode(pattern.value), scope);\n+ return;\n+ }\n+ if (pattern.type === \"TSParameterProperty\") {\n+ declarePattern(asNode(pattern.parameter), scope);\n+ return;\n+ }\n+ if (pattern.type === \"ObjectPattern\") {\n+ const properties = Array.isArray(pattern.properties) ? pattern.properties : [];\n+ properties.forEach((property) => declarePattern(asNode(property), scope));\n+ return;\n+ }\n+ if (pattern.type === \"ArrayPattern\") {\n+ const elements = Array.isArray(pattern.elements) ? pattern.elements : [];\n+ elements.forEach((element) => declarePattern(asNode(element), scope));\n+ }\n+}\n+\n+function resolveBinding(name: string, scope: Scope): BindingKind | null {\n+ for (let current: Scope | null = scope; current; current = current.parent) {\n+ const binding = current.bindings.get(name);\n+ if (binding) return binding;\n+ }\n+ return null;\n+}\n+\n+function isImportedHookCall(node: AstNode | null, scope: Scope) {\n+ if (!node || (node.type !== \"CallExpression\" && node.type !== \"OptionalCallExpression\")) return false;\n+ const calleeName = identifierName(asNode(node.callee));\n+ return Boolean(calleeName && resolveBinding(calleeName, scope) === \"next-use-router\");\n+}\n+\n+function predeclareVariable(node: AstNode, scope: Scope) {\n+ const declarations = Array.isArray(node.declarations) ? node.declarations : [];\n+ for (const declarationValue of declarations) {\n+ const declaration = asNode(declarationValue);\n+ if (declaration?.type !== \"VariableDeclarator\") continue;\n+ declarePattern(asNode(declaration.id), scope);\n+ }\n+}\n+\n+function classifyRouterVariables(node: AstNode, scope: Scope) {\n+ const declarations = Array.isArray(node.declarations) ? node.declarations : [];\n+ for (const declarationValue of declarations) {\n+ const declaration = asNode(declarationValue);\n+ const name = identifierName(asNode(declaration?.id));\n+ if (name && isImportedHookCall(asNode(declaration?.init), scope)) {\n+ scope.bindings.set(name, \"router\");\n+ }\n+ }\n+}\n+\n+function declareDirectBindings(statements: unknown[], scope: Scope, includeImports = false) {\n+ if (includeImports) {\n+ for (const statementValue of statements) {\n+ const statement = asNode(statementValue);\n+ if (statement?.type !== \"ImportDeclaration\") continue;\n+ const source = asNode(statement.source);\n+ if (source?.type !== \"StringLiteral\" || typeof source.value !== \"string\") continue;\n+ const specifiers = Array.isArray(statement.specifiers) ? statement.specifiers : [];\n+ for (const specifierValue of specifiers) {\n+ const specifier = asNode(specifierValue);\n+ const localName = identifierName(asNode(specifier?.local));\n+ if (!specifier || !localName) continue;\n+ let kind: BindingKind = \"other\";\n+ if (\n+ source.value === \"next/link\" &&\n+ (specifier.type === \"ImportDefaultSpecifier\" ||\n+ (specifier.type === \"ImportSpecifier\" && importedName(asNode(specifier.imported)) === \"default\"))\n+ ) {\n+ kind = \"next-link\";\n+ } else if (source.value === \"next/navigation\" && specifier.type === \"ImportSpecifier\") {\n+ const name = importedName(asNode(specifier.imported));\n+ if (name === \"redirect\" || name === \"permanentRedirect\") kind = \"next-redirect\";\n+ else if (name === \"useRouter\") kind = \"next-use-router\";\n+ } else if (\n+ source.value === \"next/server\" &&\n+ specifier.type === \"ImportSpecifier\" &&\n+ importedName(asNode(specifier.imported)) === \"NextResponse\"\n+ ) {\n+ kind = \"next-response\";\n+ } else if (\n+ source.value === \"@/components/mode-home-template\" &&\n+ specifier.type === \"ImportSpecifier\" &&\n+ importedName(asNode(specifier.imported)) === \"ModeHomeTemplate\"\n+ ) {\n+ kind = \"mode-home-template\";\n+ }\n+ scope.bindings.set(localName, kind);\n+ }\n+ }\n+ }\n+\n+ // Predeclare every direct lexical binding before classifying router results.\n+ // This makes later declarations shadow imports throughout their real scope.\n+ for (const statementValue of statements) {\n+ const statement = asNode(statementValue);\n+ if (!statement) continue;\n+ if (statement.type === \"VariableDeclaration\") predeclareVariable(statement, scope);\n+ else if (statement.type === \"FunctionDeclaration\" || statement.type === \"ClassDeclaration\") {\n+ declarePattern(asNode(statement.id), scope);\n+ }\n+ }\n+ for (const statementValue of statements) {\n+ const statement = asNode(statementValue);\n+ if (statement?.type === \"VariableDeclaration\") classifyRouterVariables(statement, scope);\n+ }\n+}\n+\n+function declareFunctionVars(node: AstNode, scope: Scope) {\n+ const declarations: AstNode[] = [];\n+ const visit = (value: unknown) => {\n+ const child = asNode(value);\n+ if (!child) return;\n+ if (\n+ child !== node &&\n+ (isFunctionNode(child) || child.type === \"ClassDeclaration\" || child.type === \"ClassExpression\")\n+ ) {\n+ return;\n+ }\n+ if (child.type === \"VariableDeclaration\" && child.kind === \"var\") declarations.push(child);\n+ for (const nested of Object.values(child)) {\n+ if (Array.isArray(nested)) nested.forEach(visit);\n+ else visit(nested);\n+ }\n+ };\n+ visit(node.body);\n+ declarations.forEach((declaration) => predeclareVariable(declaration, scope));\n+ declarations.forEach((declaration) => classifyRouterVariables(declaration, scope));\n+}\n+\n+function stringVariants(node: AstNode | null): string[] | null {\n+ if (!node) return null;\n+ if (node.type === \"StringLiteral\" && typeof node.value === \"string\") return [node.value];\n+ if (node.type === \"TemplateLiteral\") {\n+ const quasis = Array.isArray(node.quasis) ? node.quasis : [];\n+ const expressions = Array.isArray(node.expressions) ? node.expressions : [];\n+ if (quasis.length !== expressions.length + 1) return null;\n+\n+ let variants = [\"\"];\n+ for (let index = 0; index < quasis.length; index += 1) {\n+ const quasi = asNode(quasis[index]);\n+ const value = (quasi?.value as Record | undefined)?.cooked;\n+ if (typeof value !== \"string\") return null;\n+ variants = variants.map((prefix) => prefix + value);\n+ if (index === expressions.length) continue;\n+ const expressionVariants = stringVariants(asNode(expressions[index]));\n+ if (!expressionVariants) return null;\n+ variants = variants.flatMap((prefix) => expressionVariants.map((expression) => prefix + expression));\n+ }\n+ return variants;\n+ }\n+ if (node.type === \"ConditionalExpression\") {\n+ const consequent = stringVariants(asNode(node.consequent));\n+ const alternate = stringVariants(asNode(node.alternate));\n+ return consequent && alternate ? [...consequent, ...alternate] : null;\n+ }\n+ if (node.type === \"LogicalExpression\") {\n+ const left = stringVariants(asNode(node.left));\n+ const right = stringVariants(asNode(node.right));\n+ if (!left || !right) return null;\n+ return left.flatMap((value) => {\n+ if (node.operator === \"&&\") return value ? right : [value];\n+ if (node.operator === \"||\") return value ? [value] : right;\n+ return [value];\n+ });\n+ }\n+ if (node.type === \"BinaryExpression\" && node.operator === \"+\") {\n+ const left = stringVariants(asNode(node.left));\n+ const right = stringVariants(asNode(node.right));\n+ return left && right ? left.flatMap((prefix) => right.map((suffix) => prefix + suffix)) : null;\n+ }\n+ if (node.type === \"SequenceExpression\") {\n+ const expressions = Array.isArray(node.expressions) ? node.expressions : [];\n+ return stringVariants(asNode(expressions.at(-1)));\n+ }\n+ if (\n+ node.type === \"TSAsExpression\" ||\n+ node.type === \"TSSatisfiesExpression\" ||\n+ node.type === \"TSTypeAssertion\" ||\n+ node.type === \"TSNonNullExpression\" ||\n+ node.type === \"ParenthesizedExpression\"\n+ ) {\n+ return stringVariants(asNode(node.expression));\n+ }\n+ return null;\n+}\n+\n+function addNavigationExpressionTargets(node: AstNode | null, targets: Set) {\n+ if (!node) return;\n+ const variants = stringVariants(node);\n+ if (variants) {\n+ for (const href of variants) {\n+ if (href.startsWith(\"/\")) targets.add(pathOnly(href));\n+ }\n+ return;\n+ }\n+\n+ if (node.type === \"ObjectExpression\") {\n+ const properties = Array.isArray(node.properties) ? node.properties : [];\n+ for (const propertyValue of properties) {\n+ const property = asNode(propertyValue);\n+ if (property?.type !== \"ObjectProperty\") continue;\n+ const key = asNode(property.key);\n+ const isPathname =\n+ (key?.type === \"Identifier\" && !property.computed && key.name === \"pathname\") ||\n+ (key?.type === \"StringLiteral\" && key.value === \"pathname\");\n+ if (isPathname) addNavigationExpressionTargets(asNode(property.value), targets);\n+ }\n+ return;\n+ }\n+\n+ if (node.type === \"TemplateLiteral\") {\n+ const firstQuasi = asNode(Array.isArray(node.quasis) ? node.quasis[0] : null);\n+ const prefix = (firstQuasi?.value as Record | undefined)?.cooked;\n+ if (typeof prefix === \"string\" && prefix.startsWith(\"/\") && /[?#]/.test(prefix)) {\n+ targets.add(pathOnly(prefix));\n+ }\n+ return;\n+ }\n+\n+ if (node.type === \"ConditionalExpression\") {\n+ addNavigationExpressionTargets(asNode(node.consequent), targets);\n+ addNavigationExpressionTargets(asNode(node.alternate), targets);\n+ } else if (node.type === \"LogicalExpression\") {\n+ if (node.operator !== \"&&\") addNavigationExpressionTargets(asNode(node.left), targets);\n+ addNavigationExpressionTargets(asNode(node.right), targets);\n+ }\n+}\n+\n+function memberName(node: AstNode | null) {\n+ if (!node || (node.type !== \"MemberExpression\" && node.type !== \"OptionalMemberExpression\")) return null;\n+ const property = asNode(node.property);\n+ if (!node.computed && property?.type === \"Identifier\" && typeof property.name === \"string\") return property.name;\n+ if (node.computed && property?.type === \"StringLiteral\" && typeof property.value === \"string\") return property.value;\n+ return null;\n+}\n+\n+function isNavigationCall(node: AstNode, scope: Scope) {\n+ if (node.type !== \"CallExpression\" && node.type !== \"OptionalCallExpression\") return false;\n+ const callee = asNode(node.callee);\n+ const calleeName = identifierName(callee);\n+ if (calleeName) return resolveBinding(calleeName, scope) === \"next-redirect\";\n+\n+ const method = memberName(callee);\n+ const objectName = identifierName(asNode(callee?.object));\n+ if (!method || !objectName) return false;\n+ const binding = resolveBinding(objectName, scope);\n+ return (ROUTER_METHODS.has(method) && binding === \"router\") || (method === \"redirect\" && binding === \"next-response\");\n+}\n+\n+function jsxElementName(node: AstNode) {\n+ return jsxIdentifierName(asNode(node.name));\n+}\n+\n+function addModeHomeActionTargets(value: unknown, targets: Set) {\n+ const node = asNode(value);\n+ if (!node) return;\n+ if (node.type === \"ObjectProperty\") {\n+ const key = asNode(node.key);\n+ const isHref =\n+ (key?.type === \"Identifier\" && key.name === \"href\") || (key?.type === \"StringLiteral\" && key.value === \"href\");\n+ if (isHref) {\n+ addNavigationExpressionTargets(asNode(node.value), targets);\n+ return;\n+ }\n+ }\n+ for (const child of Object.values(node)) {\n+ if (Array.isArray(child)) child.forEach((entry) => addModeHomeActionTargets(entry, targets));\n+ else addModeHomeActionTargets(child, targets);\n+ }\n+}\n+\n+/** Parse executable syntax and return only destinations used by bound navigation APIs. */\n+function collectNavigationTargets(source: string, filename = \"fixture.tsx\") {\n+ let ast: ReturnType;\n+ try {\n+ ast = parse(source, { sourceType: \"unambiguous\", plugins: [\"jsx\", \"typescript\"] });\n+ } catch (error) {\n+ throw new Error(`route-reachability: could not parse ${filename}`, { cause: error });\n+ }\n+\n+ const targets = new Set();\n+ const visit = (value: unknown, scope: Scope) => {\n+ const node = asNode(value);\n+ if (!node) return;\n+\n+ if (node.type === \"Program\") {\n+ const programScope: Scope = { bindings: new Map(), parent: null };\n+ const body = Array.isArray(node.body) ? node.body : [];\n+ declareDirectBindings(body, programScope, true);\n+ body.forEach((entry) => visit(entry, programScope));\n+ return;\n+ }\n+\n+ let activeScope = scope;\n+ if (isFunctionNode(node)) {\n+ activeScope = { bindings: new Map(), parent: scope };\n+ const params = Array.isArray(node.params) ? node.params : [];\n+ params.forEach((param) => declarePattern(asNode(param), activeScope));\n+ declareFunctionVars(node, activeScope);\n+ } else if (node.type === \"BlockStatement\") {\n+ activeScope = { bindings: new Map(), parent: scope };\n+ declareDirectBindings(Array.isArray(node.body) ? node.body : [], activeScope);\n+ } else if (node.type === \"CatchClause\") {\n+ activeScope = { bindings: new Map(), parent: scope };\n+ declarePattern(asNode(node.param), activeScope);\n+ }\n+\n+ if (node.type === \"JSXOpeningElement\") {\n+ const elementName = jsxElementName(node);\n+ const binding = elementName ? resolveBinding(elementName, activeScope) : null;\n+ const isLink = binding === \"next-link\";\n+ const isModeHomeTemplate = binding === \"mode-home-template\";\n+ const attributes = Array.isArray(node.attributes) ? node.attributes : [];\n+ for (const attributeValue of attributes) {\n+ const attribute = asNode(attributeValue);\n+ if (attribute?.type !== \"JSXAttribute\") continue;\n+ const name = jsxIdentifierName(asNode(attribute.name));\n+ const valueNode = asNode(attribute.value);\n+ const expression = valueNode?.type === \"JSXExpressionContainer\" ? asNode(valueNode.expression) : valueNode;\n+ if (isLink && name === \"href\") addNavigationExpressionTargets(expression, targets);\n+ else if (isModeHomeTemplate && name === \"actions\") addModeHomeActionTargets(expression, targets);\n+ }\n+ } else if (isNavigationCall(node, activeScope)) {\n+ const args = Array.isArray(node.arguments) ? node.arguments : [];\n+ addNavigationExpressionTargets(asNode(args[0]), targets);\n+ }\n+\n+ for (const [key, child] of Object.entries(node)) {\n+ if (key === \"body\" && node.type === \"Program\") continue;\n+ if (Array.isArray(child)) child.forEach((entry) => visit(entry, activeScope));\n+ else visit(child, activeScope);\n+ }\n+ };\n+\n+ visit(ast, { bindings: new Map(), parent: null });\n+ return targets;\n+}\n+\n+function collectSourceFiles(dir: string): { rel: string; targets: Set }[] {\n+ const out: { rel: string; targets: Set }[] = [];\n for (const entry of readdirSync(dir, { withFileTypes: true })) {\n const abs = path.join(dir, entry.name);\n if (entry.isDirectory()) {\n out.push(...collectSourceFiles(abs));\n } else if (/\\.(js|jsx|ts|tsx)$/.test(entry.name)) {\n const rel = path.relative(repoRoot, abs).split(path.sep).join(\"/\");\n- if (!isMockupPath(rel)) out.push({ rel, content: readFileSync(abs, \"utf8\") });\n+ if (!isMockupPath(rel)) out.push({ rel, targets: collectNavigationTargets(readFileSync(abs, \"utf8\"), rel) });\n }\n }\n return out;\n }\n \n const sourceFiles = collectSourceFiles(srcRoot);\n \n /** Route targets produced by the canonical nav builders (never bare string literals). */\n const builderTargets = new Set();\n for (const mode of appModeDefinitions) {\n // Record both the default home path and a query-bearing variant: appModeHomeHref\n // can emit a different path when given a query (e.g. document / namespaced-search\n // routes), and those are valid static targets that must not read as orphaned.\n const hrefs = [\n (\"href\" in mode ? mode.href : undefined) ?? appModeHomeHref(mode.id),\n appModeHomeHref(mode.id, { query: \"__reachability__\" }),\n ];\n for (const href of hrefs) builderTargets.add(pathOnly(href));\n }\n for (const tool of tools) builderTargets.add(pathOnly(tool.href));\n \n // Therapy Compass owns a self-contained route family whose fixed screens are\n // navigated via a local `screenHref(screen)` builder (`go*()` → router.push),\n // so the sub-route paths never appear as literals a static scan could see. Read\n // the family's reserved segments straight from the source of truth so new screens\n // are picked up automatically. See src/components/therapy-compass/bindings.tsx.\n const tcBindingsSrc = readFileSync(path.join(srcRoot, \"components/therapy-compass/bindings.tsx\"), \"utf8\");\n const tcBaseMatch = tcBindingsSrc.match(/const BASE = \"([^\"]+)\"/);\n const tcReservedMatch = tcBindingsSrc.match(/RESERVED_SEGMENTS = new Set\$\\[([^\\]]*)]\$/);\n // Fail loudly if the source shape changed: a silent `?? default` / empty fallback\n // would drop every reserved Therapy Compass route from the guard without notice.\n if (!tcBaseMatch || !tcReservedMatch) {\n throw new Error(\n \"route-reachability: could not parse BASE / RESERVED_SEGMENTS from therapy-compass/bindings.tsx — \" +\n \"update this parser to match the current source so reserved routes stay covered.\",\n );\n }\n const tcBase = tcBaseMatch[1];\n const tcReservedSegments = [...tcReservedMatch[1].matchAll(/\"([^\"]+)\"/g)];\n if (tcReservedSegments.length === 0) {\n throw new Error(\n \"route-reachability: RESERVED_SEGMENTS parsed to an empty set — Therapy Compass routes would be unchecked.\",\n );\n }\n for (const match of tcReservedSegments) {\n builderTargets.add(`${tcBase}/${match[1]}`);\n }\n \n /** A route is reachable if a builder emits it, or a non-mockup source file links to it. */\n-function referenceRegExp(route: string) {\n- const escaped = route.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n- // Require a navigation context immediately before the path literal — an `href`\n- // attribute/prop or a router/redirect call — so that route-ownership checks\n- // (`pathname === \"/tools\"`), switch cases, and comment mentions do NOT count as\n- // a link. Left boundary is the opening quote/backtick; the right boundary\n- // forbids a path-continuation char so `/dsm/compare` does not match inside\n- // `/dsm/comparexyz` but does match `/dsm/compare\"` or `/dsm/compare?q=…`.\n- const navLeadIn = \"(?:href\\\\s*[=:]\\\\s*\\\\{?\\\\s*|(?:push|replace|prefetch|redirect|permanentRedirect)\\\\s*\\\\(\\\\s*)\";\n- return new RegExp(navLeadIn + \"[\\\"'`]\" + escaped + \"(?![A-Za-z0-9_\\\\-/])\");\n-}\n-\n function isReachable(route: string, selfFile: string) {\n if (builderTargets.has(route)) return true;\n- const re = referenceRegExp(route);\n- return sourceFiles.some((file) => file.rel !== selfFile && re.test(file.content));\n+ return sourceFiles.some((file) => file.rel !== selfFile && file.targets.has(route));\n }\n \n const staticPageRoutes = collectSiteMapData()\n .pageRoutes.map((route) => ({ route: route.route, file: route.file.split(path.sep).join(\"/\") }))\n .filter(\n (entry) =>\n entry.route !== \"/\" && // app root, trivially the entry point\n !entry.route.includes(\"[\") && // dynamic families reached via builders (see header)\n !entry.route.startsWith(\"/mockups\"),\n );\n \n describe(\"route reachability\", () => {\n+ it(\"counts only navigation APIs resolved to their framework imports\", () => {\n+ const targets = collectNavigationTargets(`\n+ import AppLink from \"next/link\";\n+ import { redirect as go, useRouter as useAppRouter } from \"next/navigation\";\n+\n+ const linked = ;\n+ const unboundLink = ;\n+ const rawAnchor = ;\n+ go(\"/framework-redirect\");\n+\n+ function BoundRouter() {\n+ const router = useAppRouter();\n+ router.push(\"/bound-router\");\n+ router.prefetch(\"/prefetch-only\");\n+ return null;\n+ }\n+\n+ function ShadowedRedirect(go: (href: string) => void) {\n+ go(\"/shadowed-redirect\");\n+ }\n+\n+ function ShadowedRouter({ router }: { router: { push(href: string): void } }) {\n+ router.push(\"/shadowed-router\");\n+ return ;\n+ }\n+\n+ function ShadowedLink(AppLink: React.ComponentType<{ href: string }>) {\n+ return ;\n+ }\n+\n+ const router = { push: (href: string) => href };\n+ router.push(\"/unbound-router-name\");\n+ redirect(\"/unbound-redirect-name\");\n+ `);\n+\n+ expect([...targets].sort()).toEqual([\"/aliased-link\", \"/bound-router\", \"/framework-redirect\", \"/still-bound-link\"]);\n+ });\n+\n+ it(\"extracts conditional and template destinations from bound navigation nodes\", () => {\n+ const targets = collectNavigationTargets(`\n+ import Link from \"next/link\";\n+ import { permanentRedirect, useRouter } from \"next/navigation\";\n+\n+ const conditional = ;\n+ const template = ;\n+ const objectForm = ;\n+ permanentRedirect(enabled ? \"/redirect-primary\" : \"/redirect-fallback\");\n+\n+ function ClientNavigation() {\n+ const navigation = useRouter();\n+ navigation.replace(enabled ? \"/replace-primary\" : \"/replace-fallback?from=test\");\n+ navigation[\"push\"](\"/computed-push\");\n+ }\n+ `);\n+\n+ expect([...targets].sort()).toEqual([\n+ \"/computed-push\",\n+ \"/conditional-fallback\",\n+ \"/conditional-primary\",\n+ \"/object-fallback\",\n+ \"/object-primary\",\n+ \"/redirect-fallback\",\n+ \"/redirect-primary\",\n+ \"/replace-fallback\",\n+ \"/replace-primary\",\n+ \"/template-target\",\n+ ]);\n+ });\n+\n+ it(\"allows inline href data only for ModeHomeTemplate.actions\", () => {\n+ const targets = collectNavigationTargets(`\n+ import { ModeHomeTemplate as Home } from \"@/components/mode-home-template\";\n+\n+ const arbitrary = ;\n+ const home = (\n+ \n+ );\n+ `);\n+\n+ expect([...targets].sort()).toEqual([\"/inline-action\", \"/inline-conditional-a\", \"/inline-conditional-b\"]);\n+ });\n+\n it(\"every static production page route is linked from in-app navigation\", () => {\n const orphans = staticPageRoutes\n .filter((entry) => !REACHABILITY_ALLOWLIST.has(entry.route))\n .filter((entry) => !isReachable(entry.route, entry.file))\n .map((entry) => entry.route);\n \n expect(\n orphans,\n `Orphan page route(s) with no inbound /router.push/redirect. Wire them into nav ` +\n `(sidebar/launcher/mode home/search), or add to REACHABILITY_ALLOWLIST with a reason: ${orphans.join(\", \")}`,\n ).toEqual([]);\n });\n \n it(\"reachability allowlist has no stale entries\", () => {\n const routes = new Set(staticPageRoutes.map((entry) => entry.route));\n for (const route of REACHABILITY_ALLOWLIST.keys()) {\n expect(routes.has(route), `${route} is allowlisted but is no longer a static page route`).toBe(true);\n }\n });\n });\ndiff --git a/tests/therapy-compass-data-recovery.dom.test.tsx b/tests/therapy-compass-data-recovery.dom.test.tsx\nindex 0fd27ae73ab535a527df64ef519929ce7ae75b69..2262b3af95b15a771732e83d8a0b1c1d646172a2 100644\n--- a/tests/therapy-compass-data-recovery.dom.test.tsx\n+++ b/tests/therapy-compass-data-recovery.dom.test.tsx\n@@ -39,87 +39,87 @@ afterEach(() => {\n describe(\"Therapy Compass required data recovery\", () => {\n it(\"does not advertise a zero therapy count while the catalogue is still loading\", async () => {\n let release!: (value: unknown) => void;\n const therapiesGate = new Promise((resolve) => {\n release = resolve;\n });\n const fetchMock = vi.fn(async (input: RequestInfo | URL) => {\n const path = String(input);\n if (path.endsWith(\"/therapies-index.json\")) {\n await therapiesGate;\n return response([therapy]);\n }\n throw new Error(`Unexpected fetch: ${path}`);\n });\n vi.stubGlobal(\"fetch\", fetchMock);\n \n render(\n \n \n ,\n );\n \n expect(await screen.findByRole(\"status\")).toHaveTextContent(\"Loading therapy library…\");\n expect(screen.getAllByRole(\"main\")).toHaveLength(1);\n expect(screen.queryByText(/Source-grounded therapy records\\./)).not.toBeInTheDocument();\n- expect(screen.queryByRole(\"heading\", { name: \"Therapy\" })).not.toBeInTheDocument();\n+ expect(screen.queryByRole(\"heading\", { name: \"Therapy mode\" })).not.toBeInTheDocument();\n \n release(undefined);\n \n await waitFor(() => expect(screen.getByText(/1 source-grounded therapy record\\./)).toBeInTheDocument());\n- expect(screen.getByRole(\"heading\", { name: \"Therapy\" })).toBeInTheDocument();\n+ expect(screen.getByRole(\"heading\", { name: \"Therapy mode\" })).toBeInTheDocument();\n expect(screen.getAllByRole(\"main\")).toHaveLength(1);\n expect(screen.queryByText(/Source-grounded therapy records\\./)).not.toBeInTheDocument();\n });\n \n it(\"shows an honest load error, retries all required files, and recovers\", async () => {\n let failTherapies = true;\n const fetchMock = vi.fn(async (input: RequestInfo | URL) => {\n const path = String(input);\n if (path.endsWith(\"/therapies-index.json\")) {\n return failTherapies ? response(null, false, 503) : response([therapy]);\n }\n throw new Error(`Unexpected fetch: ${path}`);\n });\n vi.stubGlobal(\"fetch\", fetchMock);\n \n render(\n \n \n ,\n );\n \n expect(screen.getByRole(\"status\")).toHaveTextContent(\"Loading therapy library\");\n expect(screen.queryByText(/Source-grounded therapy records\\./)).not.toBeInTheDocument();\n expect(screen.queryByRole(\"heading\", { name: \"Frequently used therapies\" })).not.toBeInTheDocument();\n \n- expect(await screen.findByRole(\"alert\")).toHaveTextContent(\"Therapy Compass could not load\");\n- expect(screen.queryByRole(\"heading\", { name: \"Therapy\" })).not.toBeInTheDocument();\n+ expect(await screen.findByRole(\"alert\")).toHaveTextContent(\"Therapy mode could not load\");\n+ expect(screen.queryByRole(\"heading\", { name: \"Therapy mode\" })).not.toBeInTheDocument();\n \n failTherapies = false;\n fireEvent.click(screen.getByRole(\"button\", { name: \"Retry\" }));\n \n- expect(await screen.findByRole(\"heading\", { name: \"Therapy\" })).toBeInTheDocument();\n+ expect(await screen.findByRole(\"heading\", { name: \"Therapy mode\" })).toBeInTheDocument();\n expect(screen.getByText(/1 source-grounded therapy record\\./)).toBeInTheDocument();\n expect(screen.queryByRole(\"alert\")).not.toBeInTheDocument();\n await waitFor(() => expect(fetchMock).toHaveBeenCalledTimes(2));\n });\n \n it(\"loads full therapy records only on a record-rich route\", async () => {\n navigation.pathname = \"/therapy-compass/test-therapy\";\n const fetchMock = vi.fn(async (input: RequestInfo | URL) => {\n const path = String(input);\n if (path.endsWith(\"/therapies.json\")) return response([therapy]);\n throw new Error(`Unexpected fetch: ${path}`);\n });\n vi.stubGlobal(\"fetch\", fetchMock);\n \n render(\n \n

Detail ready

ℹ️ Recent review info

\n\n

⚙️ Run configuration

\n\n**Configuration used**: Path: .coderabbit.yaml\n\n**Review profile**: CHILL\n\n**Plan**: Pro Plus\n\n**Run ID**: `eccf1fe9-889f-43f1-8e03-d17621757b68`\n\n

\n\n

📥 Commits

\n\nReviewing files that changed from the base of the PR and between ee0c0185e96f8991d7e7a25b02f31b4a98d1cfe8 and eb2a83c18bf14a6a5722de91cf69fcc235767cf1.\n\n

\n\n

📒 Files selected for processing (1)

\n\n* `docs/outstanding-issues.md`\n\n

\n\n