{calc.bands.map((band) => (
))}
diff --git a/src/components/clinical-dashboard/visual-evidence.tsx b/src/components/clinical-dashboard/visual-evidence.tsx
index 4b2b02a7e5..b4788da4cf 100644
--- a/src/components/clinical-dashboard/visual-evidence.tsx
+++ b/src/components/clinical-dashboard/visual-evidence.tsx
@@ -450,7 +450,7 @@ function EvidenceGapsPanel({ warnings }: { warnings: string[] }) {
key={`${warning}:${index}`}
className="grid grid-cols-[auto_minmax(0,1fr)] items-start gap-2 rounded-md border border-[color:var(--warning-border)] bg-[color:var(--warning-soft)]/45 px-2.5 py-2"
>
-
+
{index + 1}
{warning}
diff --git a/src/components/ui-primitives.tsx b/src/components/ui-primitives.tsx
index 24b00b27f7..dec02a1140 100644
--- a/src/components/ui-primitives.tsx
+++ b/src/components/ui-primitives.tsx
@@ -171,10 +171,10 @@ export const tableCardHeader =
export const tableMicroActionRow =
"flex min-h-tap flex-wrap items-center gap-1 border-t border-[color:var(--border)] px-2 py-1.5 text-xs font-semibold text-[color:var(--text-muted)] sm:min-h-9";
export const sidebarItem = `flex min-h-tap min-w-0 w-full items-center gap-2 overflow-hidden rounded-lg px-2.5 text-sm font-semibold text-[color:var(--text-muted)] transition hover:bg-[color:var(--surface-subtle)] hover:text-[color:var(--text)] focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[color:var(--focus)] ${controlDisabled}`;
-const statusDotBase = "inline-block h-2 w-2 shrink-0 rounded-full";
-export const statusDotReady = `${statusDotBase} bg-[color:var(--success)]`;
-export const statusDotReview = `${statusDotBase} bg-[color:var(--warning)]`;
-export const statusDotMuted = `${statusDotBase} bg-[color:var(--decoration-soft)]`;
+const statusMarkerBase = "inline-block h-2 w-2 shrink-0";
+export const statusDotReady = `${statusMarkerBase} rounded-full border-2 border-[color:var(--text-heading)] bg-transparent`;
+export const statusDotReview = `${statusMarkerBase} rotate-45 rounded-sm bg-[color:var(--warning)]`;
+export const statusDotMuted = `${statusMarkerBase} rounded-full bg-[color:var(--decoration-soft)]`;
export const toneSuccess =
"border-[color:var(--success-border)] bg-[color:var(--success-soft)] text-[color:var(--success)]";
diff --git a/src/lib/ui-copy.ts b/src/lib/ui-copy.ts
index 5dca4c8e4b..5584afddfe 100644
--- a/src/lib/ui-copy.ts
+++ b/src/lib/ui-copy.ts
@@ -115,6 +115,11 @@ export const sharedHomePresentation = {
},
} as const satisfies Record;
+/** Browser/assistive-technology title for the mode selected on the shared home. */
+export function sharedHomeDocumentTitle(modeId: AppModeId) {
+ return `${sharedHomePresentation[modeId].title} | Clinical KB`;
+}
+
export const sharedHomeEmptyState = {
starterActionsLabel: "Starter actions",
recentLabel: "Recent searches",
diff --git a/tests/shared-home-metadata.test.ts b/tests/shared-home-metadata.test.ts
new file mode 100644
index 0000000000..a145607ff5
--- /dev/null
+++ b/tests/shared-home-metadata.test.ts
@@ -0,0 +1,46 @@
+import { describe, expect, it } from "vitest";
+
+import { generateMetadata } from "@/app/(search-app)/page";
+import { appModeIds } from "@/lib/app-modes";
+import { sharedHomeDocumentTitle, sharedHomePresentation } from "@/lib/ui-copy";
+
+describe("shared home metadata", () => {
+ it.each([
+ [undefined, "Clinical Answers | Clinical KB"],
+ ["dictionary", "Clinical Dictionary | Clinical KB"],
+ ["therapy-compass", "Therapy | Clinical KB"],
+ ])("describes the selected %s mode", async (mode, title) => {
+ const metadata = await generateMetadata({
+ searchParams: Promise.resolve(mode ? { mode } : {}),
+ });
+
+ expect(metadata.title).toBe(title);
+ });
+
+ it("falls back to Answer for an unavailable mode", async () => {
+ const metadata = await generateMetadata({
+ searchParams: Promise.resolve({ mode: "not-a-mode" }),
+ });
+
+ expect(metadata.title).toBe("Clinical Answers | Clinical KB");
+ });
+
+ it("covers every app mode from the canonical presentation map", async () => {
+ for (const mode of appModeIds) {
+ const metadata = await generateMetadata({ searchParams: Promise.resolve({ mode }) });
+
+ expect(metadata.title).toBe(sharedHomeDocumentTitle(mode));
+ expect(metadata.title).toBe(`${sharedHomePresentation[mode].title} | Clinical KB`);
+ }
+ });
+
+ it.each([
+ [[], "Clinical Answers | Clinical KB"],
+ [["dictionary", "therapy-compass"], "Clinical Dictionary | Clinical KB"],
+ [["not-a-mode", "dictionary"], "Clinical Answers | Clinical KB"],
+ ])("handles adversarial repeated mode parameters %#", async (mode, title) => {
+ const metadata = await generateMetadata({ searchParams: Promise.resolve({ mode }) });
+
+ expect(metadata.title).toBe(title);
+ });
+});
diff --git a/tests/status-semantics-contract.test.ts b/tests/status-semantics-contract.test.ts
new file mode 100644
index 0000000000..d6c7dd7f5f
--- /dev/null
+++ b/tests/status-semantics-contract.test.ts
@@ -0,0 +1,42 @@
+import { readFileSync } from "node:fs";
+
+import { describe, expect, it } from "vitest";
+
+import {
+ findColourOnlyStatusIndicatorsInSource,
+ findStatusColouredNumeralsInSource,
+} from "../scripts/design-system-contract-utils.mjs";
+
+const owners = [
+ "src/components/calculators/calculator-ui.tsx",
+ "src/components/ui-primitives.tsx",
+ "src/components/clinical-dashboard/visual-evidence.tsx",
+] as const;
+
+function source(path: (typeof owners)[number]) {
+ return readFileSync(new URL(`../${path}`, import.meta.url), "utf8");
+}
+
+describe("clinical status semantics", () => {
+ it.each(owners)("keeps %s free of colour-only status and status-coloured numerals", (path) => {
+ const contents = source(path);
+ expect(findColourOnlyStatusIndicatorsInSource(path, contents)).toEqual([]);
+ expect(findStatusColouredNumeralsInSource(path, contents)).toEqual([]);
+ });
+
+ it("gives every calculator severity tone a distinct non-colour edge pattern", () => {
+ const calculator = source("src/components/calculators/calculator-ui.tsx");
+ expect(calculator).toContain('success: "border-b-2 border-[color:var(--text-heading)]"');
+ expect(calculator).toContain('info: "border-t-2 border-[color:var(--text-heading)]"');
+ expect(calculator).toContain('warning: "border-y-2 border-[color:var(--text-heading)]"');
+ expect(calculator).toContain('danger: "border-2 border-[color:var(--text-heading)]"');
+ expect(calculator).toContain("aria-label={`Score severity scale from ${calc.minScore} to ${calc.maxScore}`}");
+ });
+
+ it("distinguishes ready, review, and muted markers by geometry as well as tone", () => {
+ const primitives = source("src/components/ui-primitives.tsx");
+ expect(primitives).toContain("statusDotReady = `${statusMarkerBase} rounded-full border-2");
+ expect(primitives).toContain("statusDotReview = `${statusMarkerBase} rotate-45 rounded-sm");
+ expect(primitives).toContain("statusDotMuted = `${statusMarkerBase} rounded-full bg");
+ });
+});
diff --git a/tests/ui-accessibility.spec.ts b/tests/ui-accessibility.spec.ts
index fd6a97d186..e0c686283a 100644
--- a/tests/ui-accessibility.spec.ts
+++ b/tests/ui-accessibility.spec.ts
@@ -275,6 +275,27 @@ test.describe("Clinical KB accessibility coverage", () => {
await expect(modeButton).toHaveAttribute("aria-expanded", "false");
});
+ test("shared-home mode changes keep the document title aligned with visible copy", async ({ page }) => {
+ await mockMinimalDashboardApi(page);
+ await gotoApp(page);
+
+ await expect(page).toHaveTitle("Clinical Answers | Clinical KB");
+ await page.getByRole("button", { name: /Mode\s*Answer/i }).click();
+ const modeMenu = page.getByRole("menu");
+ await expect(modeMenu).toBeVisible();
+ await modeMenu.getByText("Dictionary", { exact: true }).click();
+
+ await expect(page).toHaveURL(/\?mode=dictionary$/);
+ await expect(page.getByRole("heading", { level: 2, name: "Clinical Dictionary" })).toBeVisible();
+ await expect(page).toHaveTitle("Clinical Dictionary | Clinical KB");
+
+ // Repeated parameters are an adversarial deep-link case. The first value is
+ // the canonical selection used by both the server metadata and client state.
+ await page.goto("/?mode=therapy-compass&mode=dictionary", { waitUntil: "domcontentloaded" });
+ await expect(page.getByRole("heading", { level: 2, name: "Therapy" })).toBeVisible();
+ await expect(page).toHaveTitle("Therapy | Clinical KB");
+ });
+
test("an open sheet deactivates the page behind it and releases it on close", async ({ page }) => {
// jsdom cannot enforce `inert`, so the browser is the only place the modal
// containment contract (and its release) can actually be proven.
From c22b3ec5cd78e119bdd7764abdde4ce8123e3000 Mon Sep 17 00:00:00 2001
From: Cursor Agent
Date: Sat, 22 Aug 2026 16:22:06 +0000
Subject: [PATCH 2/3] docs(design-system): remove offline-safe PR publication
claim per CodeRabbit P1
Line 270 of design-system-live-convergence-plan.md listed PR publication
as an agent-safe action. Per the API/provider confirmation boundary in
AGENTS.md, branch or pull-request publication requires separate explicit
user authorization and must not be described as an agent-safe cloud action.
Co-authored-by: BigSimmo
---
docs/plans/design-system-live-convergence-plan.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/plans/design-system-live-convergence-plan.md b/docs/plans/design-system-live-convergence-plan.md
index 87bfd94865..a5f4d2a5fc 100644
--- a/docs/plans/design-system-live-convergence-plan.md
+++ b/docs/plans/design-system-live-convergence-plan.md
@@ -267,7 +267,7 @@ Use `npm run verify:ui` only when shared UI foundations changed or the PR-local
- deterministic demo-mode browser checks;
- design-system, adoption, design-sync, lint, type, unit, and local production-build checks;
- screenshot candidate generation;
-- feature-branch commits and native Cloud PR publication when the connector is available.
+- feature-branch commits only; branch or pull-request publication requires separate explicit user authorization.
### Local operator or human required
From 97e02c21bbaa947c0d4610ff8965a66f61f4f86c Mon Sep 17 00:00:00 2001
From: Cursor Agent
Date: Sat, 22 Aug 2026 16:23:59 +0000
Subject: [PATCH 3/3] chore(ledger): record pr-ci-fix review of PR #2295
Co-authored-by: BigSimmo
---
...253b5017e75703fa591adbb9c5f76c5632f1bd44c923f39569b.record.md | 1 +
1 file changed, 1 insertion(+)
create mode 100644 docs/branch-review-records/76e5eff45d022253b5017e75703fa591adbb9c5f76c5632f1bd44c923f39569b.record.md
diff --git a/docs/branch-review-records/76e5eff45d022253b5017e75703fa591adbb9c5f76c5632f1bd44c923f39569b.record.md b/docs/branch-review-records/76e5eff45d022253b5017e75703fa591adbb9c5f76c5632f1bd44c923f39569b.record.md
new file mode 100644
index 0000000000..18a4da3114
--- /dev/null
+++ b/docs/branch-review-records/76e5eff45d022253b5017e75703fa591adbb9c5f76c5632f1bd44c923f39569b.record.md
@@ -0,0 +1 @@
+| 2026-08-22 | codex/review-design-system-and-live-design | c22b3ec5cd78e119bdd7764abdde4ce8123e3000 | pr-ci-fix | green | merge-conflict-resolved(GATES.md), focused-tests(status-semantics-contract+shared-home-metadata: 13/13), phone-chrome-dry-run(focused-ownership-sufficient), doc-fix(design-system-live-convergence-plan.md:270) |