refactor(mode-home): short titles and single-line hero subtitles

src/components/applications-launcher-page.tsx

@@ -107,7 +107,7 @@ function launcherAppsForSession(canAccessFavourites: boolean): LauncherApp[] {
 
 const toolsLauncherCopy = {
   heading: "Tools",
-  description: "Assessment, prescribing, documents, and clinical workflows.",
+  description: "Assessment, prescribing, and clinical workflows.",
   allSectionLabel: "All tools",
   countNoun: "tools",
   emptyTitle: "No tools match",

src/components/clinical-dashboard/favourites-hub.tsx

@@ -163,7 +163,7 @@ export function FavouritesHub({
         <ModeHomeHero
           testId="favourites-home"
           title="Favourites"
-          subtitle="Notes, sources, medication pages, and clinical sets, ready to reuse."
+          subtitle="Notes, sources, and clinical sets, ready to reuse."
           icon={Heart}
           headingLevel={headingLevel}
         />

src/components/clinical-dashboard/medication-prescribing-workspace.tsx

@@ -217,7 +217,7 @@ function MedicationHome({
   return (
     <ModeHomeTemplate
       testId="medication-home"
-      title="Medication prescribing"
+      title="Medication"
       subtitle="Search a medication or prescribing question."
       icon={Pill}
       headingLevel={2}

src/components/dsm/dsm-home-page.tsx

@@ -15,7 +15,7 @@ export function DsmHomePage() {
       <ModeHomeTemplate
         testId="dsm-home"
         title="DSM-5 Diagnosis"
-        subtitle="Find diagnostic criteria, review specifiers, compare diagnoses, and clarify differential considerations."
+        subtitle="Diagnostic criteria, specifiers, and comparisons."
         icon={BookOpenCheck}
         actionsLabel="DSM-5 Diagnosis actions"
         desktopComposerSlotId={modeHomeDesktopComposerSlotId}

src/components/factsheets/factsheets-home-page.tsx

@@ -23,8 +23,8 @@ export function FactsheetsHomePage() {
       <div className="mode-home-template mx-auto flex w-full max-w-none flex-col items-center gap-5 px-0 text-center sm:max-w-[62rem] sm:gap-6">
         <ModeHomeHero
           testId="factsheets-home"
-          title="Clear information for the next conversation."
-          subtitle="Find a short, plain-language factsheet to support a patient conversation — sourced, dated, and easy to take away."
+          title="Factsheets"
+          subtitle="Plain-language patient handouts to print and share."
           icon={BookOpenText}
         />
 

src/components/forms/forms-home-page.tsx

@@ -116,7 +116,7 @@ export function FormsHomePage() {
       <ModeHomeTemplate
         testId="forms-home-template"
         title="Forms"
-        subtitle="The complete WA MHA 2014 forms register. Search by form code, task, authority, clock, or pathway."
+        subtitle="The complete WA MHA 2014 forms register."
         icon={FileText}
         desktopComposerSlotId={modeHomeDesktopComposerSlotId}
         actionsLabel="Forms tasks"

src/components/formulation/formulation-home-page.tsx

@@ -97,8 +97,8 @@ function FormulationHome() {
     <ModeHomeMain testId="formulation-home" contentAlign="startOnPhone">
       <ModeHomeTemplate
         testId="formulation"
-        title="How can I help with the formulation?"
-        subtitle="Search mechanisms, compare alternatives, or build a structured clinical formulation from the evidence in front of you."
+        title="Formulation"
+        subtitle="Build a structured clinical formulation from the evidence."
         icon={Network}
         actionsLabel="Formulation workflows"
         desktopComposerSlotId={modeHomeDesktopComposerSlotId}

src/components/services/services-home-page.tsx

@@ -126,8 +126,8 @@ export function ServicesHomePage({ defaultServiceSlug = null }: { defaultService
     >
       <ModeHomeTemplate
         testId="services-home-template"
-        title="Find a service"
-        subtitle="Search by need, catchment, referral route, or provider."
+        title="Services"
+        subtitle="Search by need, catchment, or referral route."
         icon={Users}
         desktopComposerSlotId={modeHomeDesktopComposerSlotId}
         actionsLabel="Service tasks"

src/components/specifiers/specifiers-home-page.tsx

@@ -104,8 +104,8 @@ function SpecifiersHome() {
     <ModeHomeMain testId="specifiers-home" contentAlign="startOnPhone">
       <ModeHomeTemplate
         testId="specifiers"
-        title="Refine the diagnosis with the right specifier"
-        subtitle="Describe the presentation in ordinary clinical language, then check fit, exclusions, and diagnostic wording."
+        title="Specifiers"
+        subtitle="Refine diagnostic wording, exclusions, and episode patterns."
         icon={Tags}
         actionsLabel="Specifier workflows"
         desktopComposerSlotId={modeHomeDesktopComposerSlotId}

src/components/therapy-compass/screens/home-screen.tsx

@@ -26,14 +26,14 @@ export function HomeScreen() {
 
   const therapyCountCopy =
     b.therapies.length === 0
-      ? "Search source-grounded therapy records by problem, symptom, skill or population — or jump into a clinical pathway."
-      : `Search ${b.therapies.length} source-grounded therapy ${b.therapies.length === 1 ? "record" : "records"} by problem, symptom, skill or population — or jump into a clinical pathway.`;
+      ? "Source-grounded therapy records and clinical pathways."
+      : `${b.therapies.length} source-grounded therapy ${b.therapies.length === 1 ? "record" : "records"} and clinical pathways.`;
 
   return (
     <ModeHomeMain testId="therapy-compass-home" contentAlign="startOnPhone">
       <ModeHomeTemplate
         testId="therapy-compass"
-        title="What therapy are you looking for?"
+        title="Therapy"
         subtitle={therapyCountCopy}
         icon={Search}
         actionsLabel="Therapy workflows"

tests/therapy-compass-data-recovery.dom.test.tsx

@@ -60,15 +60,17 @@ describe("Therapy Compass required data recovery", () => {
 
     expect(await screen.findByRole("status")).toHaveTextContent("Loading therapy library…");
     expect(screen.getAllByRole("main")).toHaveLength(1);
-    expect(screen.queryByText(/Search 0 source-grounded therapy/)).not.toBeInTheDocument();
-    expect(screen.queryByRole("heading", { name: "What therapy are you looking for?" })).not.toBeInTheDocument();
+    expect(screen.queryByText(/Source-grounded therapy records and clinical pathways/)).not.toBeInTheDocument();
+    expect(screen.queryByRole("heading", { name: "Therapy" })).not.toBeInTheDocument();
 
     release(undefined);
 
-    await waitFor(() => expect(screen.getByText(/Search 1 source-grounded therapy record by/)).toBeInTheDocument());
-    expect(screen.getByRole("heading", { name: "What therapy are you looking for?" })).toBeInTheDocument();
+    await waitFor(() =>
+      expect(screen.getByText(/1 source-grounded therapy record and clinical pathways/)).toBeInTheDocument(),
+    );
+    expect(screen.getByRole("heading", { name: "Therapy" })).toBeInTheDocument();
     expect(screen.getAllByRole("main")).toHaveLength(1);
-    expect(screen.queryByText(/Search 0 source-grounded therapy/)).not.toBeInTheDocument();
+    expect(screen.queryByText(/Source-grounded therapy records and clinical pathways/)).not.toBeInTheDocument();
   });
 
   it("shows an honest load error, retries all required files, and recovers", async () => {
@@ -89,17 +91,17 @@ describe("Therapy Compass required data recovery", () => {
     );
 
     expect(screen.getByRole("status")).toHaveTextContent("Loading therapy library");
-    expect(screen.queryByText(/Search 0 source-grounded therapy records/)).not.toBeInTheDocument();
+    expect(screen.queryByText(/Source-grounded therapy records and clinical pathways/)).not.toBeInTheDocument();
     expect(screen.queryByRole("heading", { name: "Frequently used therapies" })).not.toBeInTheDocument();
 
     expect(await screen.findByRole("alert")).toHaveTextContent("Therapy Compass could not load");
-    expect(screen.queryByRole("heading", { name: "What therapy are you looking for?" })).not.toBeInTheDocument();
+    expect(screen.queryByRole("heading", { name: "Therapy" })).not.toBeInTheDocument();
 
     failTherapies = false;
     fireEvent.click(screen.getByRole("button", { name: "Retry" }));
 
-    expect(await screen.findByRole("heading", { name: "What therapy are you looking for?" })).toBeInTheDocument();
-    expect(screen.getByText(/Search 1 source-grounded therapy record by/)).toBeInTheDocument();
+    expect(await screen.findByRole("heading", { name: "Therapy" })).toBeInTheDocument();
+    expect(screen.getByText(/1 source-grounded therapy record and clinical pathways/)).toBeInTheDocument();
     expect(screen.queryByRole("alert")).not.toBeInTheDocument();
     await waitFor(() => expect(fetchMock).toHaveBeenCalledTimes(2));
   });

tests/ui-accessibility.spec.ts

@@ -382,7 +382,7 @@ test.describe("Clinical KB accessibility coverage", () => {
     await page.setViewportSize({ width: 390, height: 844 });
     await page.goto("/therapy-compass", { waitUntil: "domcontentloaded" });
 
-    await expect(page.getByRole("heading", { name: "What therapy are you looking for?" })).toBeVisible({
+    await expect(page.getByRole("heading", { name: "Therapy", exact: true })).toBeVisible({
       timeout: 60_000,
     });
 

tests/ui-formulation.spec.ts

@@ -57,7 +57,7 @@ test("searches patient language, opens a mechanism guide, and carries it into th
 }, testInfo) => {
   await gotoApp(page, "/formulation");
 
-  await expect(page.getByRole("heading", { name: "How can I help with the formulation?" })).toBeVisible();
+  await expect(page.getByRole("heading", { name: "Formulation", exact: true })).toBeVisible();
   await expect(page.getByTestId("formulation-home")).toBeVisible();
 
   const search = page.getByTestId("global-search-input").filter({ visible: true }).first();

tests/ui-route-coverage.spec.ts

@@ -218,9 +218,9 @@ test.describe("previously uncovered production routes", () => {
       "/therapy-compass",
       async (currentPage) => {
         await expect(currentPage.getByRole("main")).toBeVisible();
-        await expect(
-          currentPage.getByRole("heading", { name: "What therapy are you looking for?", level: 1 }),
-        ).toBeVisible({ timeout: 30_000 });
+        await expect(currentPage.getByRole("heading", { name: "Therapy", level: 1, exact: true })).toBeVisible({
+          timeout: 30_000,
+        });
       },
       async (currentPage) => {
         const search = currentPage

tests/ui-specifiers.spec.ts

@@ -63,7 +63,7 @@ test("searches clinical language without provenance fields and carries a result
 }, testInfo) => {
   await gotoApp(page, "/specifiers");
 
-  await expect(page.getByRole("heading", { name: "Refine the diagnosis with the right specifier" })).toBeVisible();
+  await expect(page.getByRole("heading", { name: "Specifiers", exact: true })).toBeVisible();
   await expect(page.getByTestId("specifiers-home")).toBeVisible();
 
   const search = page.getByTestId("global-search-input").filter({ visible: true }).first();

tests/ui-tools.spec.ts

@@ -481,14 +481,14 @@ test.describe("Clinical KB tools launcher", () => {
     await expect(page).toHaveURL(/\/services$/);
     await expect(page.getByRole("button", { name: "Mode Services" })).toBeVisible();
     await expect(page.getByTestId("services-home")).toBeVisible();
-    await expect(page.getByRole("heading", { level: 1, name: "Find a service" })).toBeVisible();
+    await expect(page.getByRole("heading", { level: 1, name: "Services" })).toBeVisible();
     await expect(page.getByRole("button", { name: "Expand sidebar" })).toBeVisible();
     await expect(page.getByTestId("collapsed-account-settings")).toBeVisible();
     await expect(visibleGlobalSearchInput(page)).toHaveCount(1);
     const servicesHomeSearch = page.getByTestId("services-home").getByTestId("global-search-input");
     await expect(servicesHomeSearch).toBeVisible();
     const servicesSearchBox = await servicesHomeSearch.boundingBox();
-    const servicesHeadingBox = await page.getByRole("heading", { level: 1, name: "Find a service" }).boundingBox();
+    const servicesHeadingBox = await page.getByRole("heading", { level: 1, name: "Services" }).boundingBox();
     expect(servicesSearchBox).not.toBeNull();
     expect(servicesHeadingBox).not.toBeNull();
     expect((servicesHeadingBox?.y ?? 0) + (servicesHeadingBox?.height ?? 0)).toBeLessThan(servicesSearchBox?.y ?? 0);
@@ -559,7 +559,7 @@ test.describe("Clinical KB tools launcher", () => {
 
     for (const home of [
       { path: "/?mode=answer", testId: "answer-empty-state", heading: "How can I help?", headingLevel: 2 },
-      { path: "/services", testId: "services-home", heading: "Find a service", headingLevel: 1 },
+      { path: "/services", testId: "services-home", heading: "Services", headingLevel: 1 },
       { path: "/forms", testId: "forms-home", heading: "Forms", headingLevel: 1 },
       { path: "/differentials", testId: "differentials-home", heading: "Differentials", headingLevel: 1 },
       { path: "/favourites", testId: "favourites-hub", heading: "Favourites command library", headingLevel: 1 },
@@ -763,10 +763,10 @@ test.describe("Clinical KB tools launcher", () => {
       {
         path: "/?mode=prescribing",
         testId: "medication-home",
-        heading: "Medication prescribing",
+        heading: "Medication",
         headingLevel: 2,
       },
-      { path: "/services", testId: "services-home", heading: "Find a service", headingLevel: 1 },
+      { path: "/services", testId: "services-home", heading: "Services", headingLevel: 1 },
       { path: "/forms", testId: "forms-home", heading: "Forms", headingLevel: 1 },
       { path: "/differentials", testId: "differentials-home", heading: "Differentials", headingLevel: 1 },
       { path: "/tools", testId: "tools-home", heading: "Tools", headingLevel: 1 },
@@ -784,8 +784,12 @@ test.describe("Clinical KB tools launcher", () => {
         await expect(heroSearch).toBeVisible();
 
         const searchBox = await heroSearch.boundingBox();
+        // Scope to the mode-home container and match exactly: the standalone
+        // "Medication" hero title is otherwise a substring of the answer
+        // section's sr-only "Medication matches" heading (strict-mode clash).
         const headingBox = await page
-          .getByRole("heading", { level: home.headingLevel, name: home.heading })
+          .getByTestId(home.testId)
+          .getByRole("heading", { level: home.headingLevel, name: home.heading, exact: true })
           .boundingBox();
         expect(searchBox).not.toBeNull();
         expect(headingBox).not.toBeNull();