From e01a9a5aa9ea890fc7e7971aa9032255a92d74a9 Mon Sep 17 00:00:00 2001
From: BigSimmo <87357024+BigSimmo@users.noreply.github.com>
Date: Sun, 2 Aug 2026 10:49:50 +0800
Subject: [PATCH 1/6] DS V2 PR-V 5a: close out token values (colour, elevation,
 ink)

No value deltas remain for slice 5a. 59e4c3dfc landed --shadow-well, the spine and status-mark families and the dark --clinical-chat-document fix; PR 3 (#1570) landed the remaining ink roles. The v2 light and dark blocks declare the same colour set, and the design-system contract reports rawColorLiterals 2 / literalShadowClasses 0 / legacyTapClasses 0 against an unchanged baseline.

The two surviving #0f766e literals restate a Postgres column default for a per-record accent colour, so they are data rather than design tokens and stay put; SPEC now records why, to stop a later reader 'fixing' the app default away from the database default.
---
 docs/design-system/SPEC.md | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/docs/design-system/SPEC.md b/docs/design-system/SPEC.md
index 23d3a7406..0b9ba0126 100644
--- a/docs/design-system/SPEC.md
+++ b/docs/design-system/SPEC.md
@@ -640,11 +640,20 @@ and adoption.** Status keys as in the header; "done" entries cite their commit.
 
 ### Phase 2 — values, split three ways
 
-| PR                                | Contents                                                                                              | Status                                                                                                                                                                                        |
-| --------------------------------- | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| PR 5a · Token values, no geometry | Colour, elevation, ink roles                                                                          | **partially done** — `59e4c3dfc` landed the `--shadow-well` rename, the spine and status-mark families, and the dark `--clinical-chat-document` fix; the remaining colour/ink deltas are open |
-| PR 5b · Tap 44→48 in `@theme`     | The 407-site geometry change; contract-test pin update; visual QA pass; `--tap-min` becomes the alias | open                                                                                                                                                                                          |
-| PR 5c · Radius step               | Every `rounded-md` moves; its own visual diff                                                         | open                                                                                                                                                                                          |
+| PR                                | Contents                                                                                              | Status                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| --------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| PR 5a · Token values, no geometry | Colour, elevation, ink roles                                                                          | **done** — `59e4c3dfc` landed the `--shadow-well` rename, the spine and status-mark families, and the dark `--clinical-chat-document` fix; the remaining ink-role deltas landed with PR 3 (`--text-placeholder`, eyebrows and placeholders off the decoration tier, the disabled encoding). The v2 light and dark blocks now declare the same colour roles, and the only raw colour literals left in `src/` are the two `#0f766e` accent defaults, which are **not** design tokens — see the note below |
+| PR 5b · Tap 44→48 in `@theme`     | The 407-site geometry change; contract-test pin update; visual QA pass; `--tap-min` becomes the alias | open                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| PR 5c · Radius step               | Every `rounded-md` moves; its own visual diff                                                         | open                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+
+**`#0f766e` is data, not a token.** The two remaining raw colour literals
+(`src/lib/medications.ts`, `src/lib/medication-records.ts`) restate a Postgres column
+default (`accent text not null default '#0f766e'`) for a per-record, user-chosen accent
+colour. Changing the application default without migrating the database default would
+diverge the two, so both stay. The raw-colour ratchet in
+`scripts/design-system-contract-baseline.json` is a **ceiling, not a target**: it exists to
+stop new literals appearing, and a value that is persisted data rather than design intent
+is outside the token system entirely.
 
 ### Phase 3 — safety structure
 

From d927c64b23feb385876f0af2a123a7fb1ef7f3a4 Mon Sep 17 00:00:00 2001
From: BigSimmo <87357024+BigSimmo@users.noreply.github.com>
Date: Sun, 2 Aug 2026 11:03:39 +0800
Subject: [PATCH 2/6] DS V2 PR-V 5b: move the tap knob to 48px

--spacing-tap goes 2.75rem -> 3rem in the globals @theme block, which is the only place it may be set (SPEC 4.10, DECISIONS C2). The v2 layer's --tap-min stops carrying its own value and becomes the pure alias var(--spacing-tap), so the app cannot render a 44/48 split. This moves 426 *-tap call sites across 90-odd files at once.

Pins flip in this commit, not a follow-up: ckb-v2-token-contract now asserts the alias, that the v2 layer never declares the knob, and that the @theme value is at least 48px (checked on resolved rem, since a string compare would pass on an alias); ui-style-contract raises its rendered Chromium floor to 48; ui-tools expects the mode-home hero tile at 48.

Two follow-through rules came out of the sweep and are written into SPEC 4.10. A grid track that holds a tap-sized child reads var(--spacing-tap) instead of copying the number - seven hardcoded 2.75rem tracks were audited and the launcher search row, the one with no gap between columns, was rebound; the other six absorb the extra 4px into an existing gap or the row's own padding. And the phone composer keeps a deliberate 44px below 431px, because its height is part of the search-chrome contract and 4px per button would re-tune the dock reserve and the phone CLS budget for no accessibility gain.

Also retires two min-h-[44px] literals on interactive links onto min-h-tap, and rewrites the comments that restated 44px so they name the token instead. GATES gate 2 moves to implemented-blocking.
---
 docs/design-system.md                         | 15 ++--
 docs/design-system/DECISIONS.md               | 14 +++-
 docs/design-system/GATES.md                   | 30 ++++----
 docs/design-system/SPEC.md                    | 30 +++++---
 docs/design-system/TOKENS.md                  | 76 +++++++++----------
 src/app/ckb-v2-tokens.css                     |  6 +-
 src/app/globals.css                           | 38 ++++++----
 src/components/applications-launcher-page.tsx |  5 +-
 .../clinical-output-helpers.tsx               |  2 +-
 .../clinical-dashboard/evidence-panels.tsx    |  2 +-
 src/components/mode-nav/mode-nav.tsx          |  2 +-
 src/components/ui-primitives.tsx              |  4 +-
 src/components/ui/button.tsx                  |  2 +-
 src/components/ui/chip.tsx                    |  2 +-
 src/components/ui/citation.tsx                |  2 +-
 tests/ckb-v2-token-contract.test.ts           | 26 ++++++-
 tests/ui-style-contract.spec.ts               |  6 +-
 tests/ui-tools.spec.ts                        |  6 +-
 18 files changed, 168 insertions(+), 100 deletions(-)

diff --git a/docs/design-system.md b/docs/design-system.md
index 6a421d394..af80d224e 100644
--- a/docs/design-system.md
+++ b/docs/design-system.md
@@ -121,16 +121,19 @@ Icon **glyphs** use the parallel `--spacing-icon-*` scale in `@theme`:
   a few roles (nav, composer, hero, panel headings); most icons stay one fixed size.
 - **Not** for container tiles (`iconTilePremium` / panel-heading tile h-9, empty-state tile h-10)
   or non-icon boxes (the `ToggleSwitch` knob, status dots) — those keep the integer spacing
-  scale. Icon glyph size is independent of the 44px tap target (§3), which stays on
+  scale. Icon glyph size is independent of the tap target (§3), which stays on
   `--spacing-tap`.
 
 ## 3. Spacing & tap targets
 
 - 4px grid via Tailwind spacing; safe-area env paddings on shell edges.
-- Interactive targets use the `--spacing-tap` token (44px): `min-h-tap` / `min-w-tap` /
-  `size-tap`. Do **not** hand-write `min-h-11` / `h-[44px]` for tap semantics.
-- Exception (documented in `globals.css`): controls scrolled deep inside sheets stay on
-  `min-h-12` (48px) to satisfy the ui-smoke sub-pixel tap check — do not "fix" them down.
+- Interactive targets use the `--spacing-tap` token (48px): `min-h-tap` / `min-w-tap` /
+  `size-tap`. Do **not** hand-write `min-h-11` / `h-[44px]` for tap semantics, and size a grid
+  track that holds a tap target with `var(--spacing-tap)` rather than a copy of the number.
+- `min-h-12` sites now match the token instead of exceeding it — leave them; never "fix" a tap
+  target down.
+- Exception (documented in `globals.css`): the phone composer icon buttons stay 44px below
+  431px, because the dock height is part of the search-chrome contract.
 
 ## 4. Radius & shadows
 
@@ -172,7 +175,7 @@ rung — never a new number.
   the applications-launcher DetailDialog migration is the template for converting one.
 - Empty and loading states use `EmptyState` / `LoadingPanel`, not bespoke markup.
 - **Icon-only buttons use `IconButton`** (`ui-primitives.tsx`): its `label` prop is required and
-  renders `aria-label` + an `aria-hidden` glyph + a 44px tap target, so an unlabeled icon button
+  renders `aria-label` + an `aria-hidden` glyph + a `--spacing-tap` hit area, so an unlabeled icon button
   cannot be written by accident. Pass a recipe (`toolbarButton`, …) via `className` for chrome.
 - Composer-chrome caveat: the `answer-footer-search-*` / `desktop-home-search-*` classes are
   intentionally **unlayered** and beat Tailwind utilities on the same element — check the class
diff --git a/docs/design-system/DECISIONS.md b/docs/design-system/DECISIONS.md
index cf628fe78..8e6f621a5 100644
--- a/docs/design-system/DECISIONS.md
+++ b/docs/design-system/DECISIONS.md
@@ -42,9 +42,17 @@ anything that cannot be verified is listed as blocked rather than guessed.
 `globals.css` — the token the `min-h-tap` / `h-tap` / `size-tap` utilities compile against.
 `--tap-min` in the v2 layer becomes a pure alias (`var(--spacing-tap)`), and the v2 layer
 never declares `--spacing-tap`. What moves with it, in the same change: the contract-test
-pin (`ckb-v2-token-contract.test.ts:181-185`), the `Button` comment that still claims 44px,
-and a dedicated visual-QA pass — it is a 407-call-site geometry change and ships as its own
-PR (5b). No existing 48px target (`min-h-12`, 53 sites) is touched.
+pins, the component comments that still claim 44px, and a dedicated visual-QA pass — it is a
+426-call-site geometry change and ships as its own commit (5b). No existing 48px target
+(`min-h-12`) is touched.
+
+**Landed (PR 5b).** Two follow-through rules came out of doing it, both now in SPEC §4.10.
+A grid track sized to hold a tap-sized child reads `var(--spacing-tap)` instead of copying
+its value, or the track and its child desync on the next move — seven hardcoded `2.75rem`
+tracks were audited, and the one with no gap between columns (the launcher search row) was
+rebound; the other six absorb the extra 4px into an existing gap or the row's own padding.
+And the phone composer keeps a written 44px exception below 431px, because its height is
+part of the search-chrome contract and 44px already clears WCAG 2.5.5.
 
 **Rejected.** Declaring the value in the v2 layer. In the design side's `:root`-structural
 copy it silently **loses** a same-specificity cascade tie to `@theme` (later wins), leaving
diff --git a/docs/design-system/GATES.md b/docs/design-system/GATES.md
index 8e7273fc4..30079567c 100644
--- a/docs/design-system/GATES.md
+++ b/docs/design-system/GATES.md
@@ -37,20 +37,20 @@ those rules as gates.
 
 ## 2 · The twelve system gates, labelled
 
-| #   | Gate                                                                                                                                          | Status                   | Evidence / path to blocking                                                                                                                                                  |
-| --- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 1   | Contrast ≥4.5:1 for every text/background pair, both themes, live **and** v2; `--decoration-soft` asserted below 4.5 and never on a text node | **implemented-blocking** | v2 pairs + `--text-placeholder` + `--decoration-soft` tier + recipe AST (`decoration-on-text.contract.test.ts`); live full matrix remains follow-on.                         |
-| 2   | Tap targets ≥48px interactive; static pills never carry `min-h-tap`; no production target reduced                                             | **implemented-partial**  | Legacy-class and literal ratchets run; the 48px value itself lands in PR 5b (until then the token honestly says 44); geometry assertions live in the held visual harness.    |
-| 3   | Focus outline present, `--focus`, no companion ring                                                                                           | **planned**              | `--focus` is referenced nowhere in the DS export (finding N3). Global fix first, then the check.                                                                             |
-| 4   | Non-colour encoding on every status indicator                                                                                                 | **manual → planned**     | `MissingValue`/`DoseLine` text marks arrive in PR 6; contract test follows.                                                                                                  |
-| 5   | Tables: semantic caption, associated headers, `aria-controls` on the expander                                                                 | **implemented-partial**  | Expander and alignment tested; semantic-caption rule fails today (div caption, optional).                                                                                    |
-| 6   | Enum resilience — neutral fallback, never throws                                                                                              | **implemented-blocking** | `source-badges-off-vocab.dom.test.tsx`.                                                                                                                                      |
-| 7   | Elevation monotonicity — no child heavier than its parent                                                                                     | **implemented-partial**  | Token-ramp monotonicity is tested; the per-surface child/parent rule is planned (needs a render-tree check).                                                                 |
-| 8   | Edge ownership — no `border-*` + `ring-*` on one surface; no 1px spread in a drop shadow                                                      | **implemented-partial**  | Ladder is tested spread-free; the per-surface co-occurrence lint and spread-term check are planned (PR 9). The spread form was chosen _because_ it is mechanically lintable. |
-| 9   | No layout-property animation; no hardcoded durations                                                                                          | **planned**              | PR 9 wires `--duration-*`/`--ease-*` and adds the lint; ten known layout-animation sites are the seed list.                                                                  |
-| 10  | Named z and motion tokens have real consumers; no unapproved `z-` value                                                                       | **implemented-partial**  | `require-z-index-ladder` lints z discipline; motion-token consumption is planned (one consumer today against 25 hardcoded durations).                                        |
-| 11  | Published-type conformance — every `dtsPropsFor` entry assignable from source props                                                           | **planned**              | PR 12 generates declarations from real types; known drift: `confirmPhraseLabel`, Sheet omissions, narrowed callbacks.                                                        |
-| 12  | Component coverage — every registered component has a direct behavioural test                                                                 | **implemented-partial**  | Tested subset in COMPONENTS §0; registry-wide requirement lands with PR 12.                                                                                                  |
+| #   | Gate                                                                                                                                          | Status                   | Evidence / path to blocking                                                                                                                                                                                                                                                                                                                                                                                                             |
+| --- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1   | Contrast ≥4.5:1 for every text/background pair, both themes, live **and** v2; `--decoration-soft` asserted below 4.5 and never on a text node | **implemented-blocking** | v2 pairs + `--text-placeholder` + `--decoration-soft` tier + recipe AST (`decoration-on-text.contract.test.ts`); live full matrix remains follow-on.                                                                                                                                                                                                                                                                                    |
+| 2   | Tap targets ≥48px interactive; static pills never carry `min-h-tap`; no production target reduced                                             | **implemented-blocking** | `--spacing-tap` is 48px and pinned from both sides: `ckb-v2-token-contract` asserts the `@theme` knob is ≥48 and that `--tap-min` is its alias, `ui-style-contract` measures the rendered floor in Chromium, and the legacy-class and literal ratchets still run. Two carve-outs are written down rather than gated away: the phone composer below 431px (SPEC §4.10) and per-surface geometry, which stays in the held visual harness. |
+| 3   | Focus outline present, `--focus`, no companion ring                                                                                           | **planned**              | `--focus` is referenced nowhere in the DS export (finding N3). Global fix first, then the check.                                                                                                                                                                                                                                                                                                                                        |
+| 4   | Non-colour encoding on every status indicator                                                                                                 | **manual → planned**     | `MissingValue`/`DoseLine` text marks arrive in PR 6; contract test follows.                                                                                                                                                                                                                                                                                                                                                             |
+| 5   | Tables: semantic caption, associated headers, `aria-controls` on the expander                                                                 | **implemented-partial**  | Expander and alignment tested; semantic-caption rule fails today (div caption, optional).                                                                                                                                                                                                                                                                                                                                               |
+| 6   | Enum resilience — neutral fallback, never throws                                                                                              | **implemented-blocking** | `source-badges-off-vocab.dom.test.tsx`.                                                                                                                                                                                                                                                                                                                                                                                                 |
+| 7   | Elevation monotonicity — no child heavier than its parent                                                                                     | **implemented-partial**  | Token-ramp monotonicity is tested; the per-surface child/parent rule is planned (needs a render-tree check).                                                                                                                                                                                                                                                                                                                            |
+| 8   | Edge ownership — no `border-*` + `ring-*` on one surface; no 1px spread in a drop shadow                                                      | **implemented-partial**  | Ladder is tested spread-free; the per-surface co-occurrence lint and spread-term check are planned (PR 9). The spread form was chosen _because_ it is mechanically lintable.                                                                                                                                                                                                                                                            |
+| 9   | No layout-property animation; no hardcoded durations                                                                                          | **planned**              | PR 9 wires `--duration-*`/`--ease-*` and adds the lint; ten known layout-animation sites are the seed list.                                                                                                                                                                                                                                                                                                                             |
+| 10  | Named z and motion tokens have real consumers; no unapproved `z-` value                                                                       | **implemented-partial**  | `require-z-index-ladder` lints z discipline; motion-token consumption is planned (one consumer today against 25 hardcoded durations).                                                                                                                                                                                                                                                                                                   |
+| 11  | Published-type conformance — every `dtsPropsFor` entry assignable from source props                                                           | **planned**              | PR 12 generates declarations from real types; known drift: `confirmPhraseLabel`, Sheet omissions, narrowed callbacks.                                                                                                                                                                                                                                                                                                                   |
+| 12  | Component coverage — every registered component has a direct behavioural test                                                                 | **implemented-partial**  | Tested subset in COMPONENTS §0; registry-wide requirement lands with PR 12.                                                                                                                                                                                                                                                                                                                                                             |
 
 **Computed-style suites (planned, PR 1–2):** Tailwind conflict order · v2 cascade, ancestor
 **and** same-node forms · HCM remapping under all three v2 selectors · z-index · target
@@ -84,7 +84,7 @@ as design tokens · export/preview parity.
 | Hardcode a transition duration                                       | Gate 9                                                                                           | planned                                                                          |
 | A `z-` value outside the named rungs                                 | `require-z-index-ladder` (ESLint)                                                                | implemented-blocking                                                             |
 | Ship a registered component without a direct test                    | Gate 12                                                                                          | implemented-partial                                                              |
-| Lower a production tap target below 48px                             | Gate 2 + `ui-smoke` flake history + held visual probe                                            | implemented-partial                                                              |
+| Lower a production tap target below 48px                             | Gate 2 + `ui-smoke` flake history + held visual probe                                            | implemented-blocking (token floor); per-surface geometry still held              |
 | Construct an enabled control with no action, destination or name     | PR 4 discriminated unions + DOM contracts; `require-button-wiring` covers raw `<button>`         | implemented-blocking (Citation/Chip/ToggleSwitch/RadioGroup)                     |
 | Render `AnswerCard` without a verification and answer state          | PR 6 required props (type-level)                                                                 | planned                                                                          |
 | Use a bare dash for a missing clinical value                         | `MissingValue` + review                                                                          | planned                                                                          |
diff --git a/docs/design-system/SPEC.md b/docs/design-system/SPEC.md
index 0b9ba0126..c03d44a21 100644
--- a/docs/design-system/SPEC.md
+++ b/docs/design-system/SPEC.md
@@ -283,22 +283,34 @@ translates its arrow, `ToggleSwitch` translates its knob. Wiring + lint is PR 9
 ### 4.10 Density and tap targets (C2 resolved)
 
 **48px, one knob.** The knob is `--spacing-tap` in the `@theme` block of `globals.css` — it is
-what `min-h-tap` / `h-tap` / `size-tap` compile against. `--tap-min` in the v2 layer becomes a
+what `min-h-tap` / `h-tap` / `size-tap` compile against. `--tap-min` in the v2 layer is a
 **pure alias** reading `var(--spacing-tap)`; the two are never set independently.
 
-**The 44→48 change lands in `@theme`, never in the v2 layer.** In the design side's
+**The 44→48 change landed in `@theme`, never in the v2 layer** (PR 5b). In the design side's
 `:root`-structural copy the v2 declaration silently loses a same-specificity cascade tie to
 `@theme`; in the repo's class-scoped copy it would win _inside_ opted-in subtrees and produce
-a 44/48 split app. Either failure mode is worse than the current wrong value. It is a 407-site
-geometry change (all `*-tap` utilities), so it ships as its own PR with its own visual QA
-(PR 5b), and it must update the contract test's `--tap-min` pin (`:181-185`) in the same
-commit. Full reasoning: DECISIONS §C2.
+a 44/48 split app. Either failure mode is worse than a single honest value. It moved 426
+`*-tap` call sites at once, which is why it shipped as its own commit with its own visual QA
+and flipped its pins in the same commit: the `--tap-min` alias and 48px floor assertions in
+`tests/ckb-v2-token-contract.test.ts`, the rendered floor in `tests/ui-style-contract.spec.ts`,
+and the mode-home hero tile in `tests/ui-tools.spec.ts`. Full reasoning: DECISIONS §C2.
+
+**A grid track that holds a tap-sized child reads the knob, never a copy of its value.** A
+literal `2.75rem`/`3rem` track desyncs from its child the next time the knob moves; the
+launcher search row is the case where that overlaps rather than merely tightening a gap.
+
+**The phone composer is the one sanctioned exception to the floor.** Below 431px the composer
+icon buttons stay 44px (`globals.css`, `max-width: 430px`): the phone composer is an
+edge-to-edge dock whose height is part of the search-chrome contract, and 4px per button
+re-tunes the dock reserve and the phone CLS budget for no accessibility gain — 44px already
+clears WCAG 2.5.5. Any further exception needs the same kind of written reason.
 
 Three concepts stay separate: visible glyph size · visible control face · interactive hit
 target. Dense clinical UI keeps compact faces with padded or pseudo-element targets, and row
 hit-areas may overlap padding where density matters. Static chips are text, not targets —
-exempt under WCAG 2.5.8's inline exception. **No existing 48px production target may be
-reduced** (`min-h-12` sites stay; 44px is a known `ui-smoke` flake).
+exempt under WCAG 2.5.8's inline exception. **No production target may be reduced**
+(`min-h-12` sites now match the knob rather than exceeding it — leave them; 44px is a known
+`ui-smoke` flake).
 
 ### 4.11 Transitional architecture (C3 resolved)
 
@@ -643,7 +655,7 @@ and adoption.** Status keys as in the header; "done" entries cite their commit.
 | PR                                | Contents                                                                                              | Status                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | --------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | PR 5a · Token values, no geometry | Colour, elevation, ink roles                                                                          | **done** — `59e4c3dfc` landed the `--shadow-well` rename, the spine and status-mark families, and the dark `--clinical-chat-document` fix; the remaining ink-role deltas landed with PR 3 (`--text-placeholder`, eyebrows and placeholders off the decoration tier, the disabled encoding). The v2 light and dark blocks now declare the same colour roles, and the only raw colour literals left in `src/` are the two `#0f766e` accent defaults, which are **not** design tokens — see the note below |
-| PR 5b · Tap 44→48 in `@theme`     | The 407-site geometry change; contract-test pin update; visual QA pass; `--tap-min` becomes the alias | open                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| PR 5b · Tap 44→48 in `@theme`     | The 407-site geometry change; contract-test pin update; visual QA pass; `--tap-min` becomes the alias | **done** — `--spacing-tap: 3rem` in `@theme`; `--tap-min` reduced to `var(--spacing-tap)`; 426 `*-tap` call sites moved; three pins flipped in the same commit; the phone composer keeps a written 44px exception below 431px (§4.10)                                                                                                                                                                                                                                                                   |
 | PR 5c · Radius step               | Every `rounded-md` moves; its own visual diff                                                         | open                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 
 **`#0f766e` is data, not a token.** The two remaining raw colour literals
diff --git a/docs/design-system/TOKENS.md b/docs/design-system/TOKENS.md
index 68d2ac0c3..5ad9b9417 100644
--- a/docs/design-system/TOKENS.md
+++ b/docs/design-system/TOKENS.md
@@ -24,15 +24,15 @@ utilities) · `live` — `globals.css` `:root` / `.dark` · `v2` — branch `ckb
 
 This is the two-sources-of-truth failure C1 exists to kill. One winner per role:
 
-| Role                     | Design side has                              | Repo side has                                            | **Winner**                                          | Action                                                                                                                                                                                                                                                                |
-| ------------------------ | -------------------------------------------- | -------------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Recessed well shadow     | `--shadow-well`                              | _(had overridden `--shadow-inset` in both themes)_       | **`--shadow-well`** (new role, both themes)         | **Done (`59e4c3dfc`).** The two v2 `--shadow-inset` overrides became `--shadow-well`, so the DS bevel inherits from `live` again; the contract test now pins `--shadow-well` as a true inset and asserts `--shadow-inset` is _not_ redeclared in `v2`.                |
-| DS bevel                 | `--shadow-inset` (inherited, un-overridden)  | `--shadow-inset` (overridden to a true inset)            | **`--shadow-inset` stays the bevel, owner `live`**  | The v2 override was the wrong move (it stripped a highlight from ~40 surfaces); reverted per above.                                                                                                                                                                   |
-| Quantity unit typography | `--quantity-unit-scale`                      | `--quantity-unit-tracking` + `--quantity-unit-gap`       | **repo pair wins**                                  | Two real physical properties beat one ambiguous scale factor; unit _size_ comes from the type scale (one step down), never a bespoke multiplier. Design side deletes `--quantity-unit-scale` at next sync.                                                            |
-| Tap target knob          | `--spacing-tap` declared inside the v2 layer | `--tap-min` literal in `v2`; `--spacing-tap` in `@theme` | **`--spacing-tap`, owner `@theme` — the only knob** | C2 (DECISIONS): the 44→48 change lands in `@theme`; `v2`'s `--tap-min` becomes a pure alias `var(--spacing-tap)`; never set independently. Same commit: update the pin at `tests/ckb-v2-token-contract.test.ts:181-185`. The v2 layer never declares `--spacing-tap`. |
-| Evidence-spine roles     | present (names unrecoverable)                | `--spine-w` · `--spine-current` · `--spine-stale`        | **repo names win (authored `59e4c3dfc`)**           | The design-side copy proved unrecoverable, so the names were authored repo-side, derived from existing roles (`--rule-w`, `--clinical-accent`, `--warning`) rather than reconstructed from prose.                                                                     |
-| Status-mark roles        | present (names unrecoverable)                | `--status-mark-size` · `--status-mark-stroke`            | **repo names win (authored `59e4c3dfc`)**           | Codifies `StatusMark`'s previously-inline geometry (`--gutter-dot` size; the component's own stroke).                                                                                                                                                                 |
-| Confidence-meter roles   | present (names unrecoverable)                | _(absent, deliberately)_                                 | **deferred — no call site**                         | `ConfidenceMeter` (P2) is unbuilt; no new token without a call site. The family enters `v2` with the component.                                                                                                                                                       |
+| Role                     | Design side has                              | Repo side has                                            | **Winner**                                          | Action                                                                                                                                                                                                                                                                     |
+| ------------------------ | -------------------------------------------- | -------------------------------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Recessed well shadow     | `--shadow-well`                              | _(had overridden `--shadow-inset` in both themes)_       | **`--shadow-well`** (new role, both themes)         | **Done (`59e4c3dfc`).** The two v2 `--shadow-inset` overrides became `--shadow-well`, so the DS bevel inherits from `live` again; the contract test now pins `--shadow-well` as a true inset and asserts `--shadow-inset` is _not_ redeclared in `v2`.                     |
+| DS bevel                 | `--shadow-inset` (inherited, un-overridden)  | `--shadow-inset` (overridden to a true inset)            | **`--shadow-inset` stays the bevel, owner `live`**  | The v2 override was the wrong move (it stripped a highlight from ~40 surfaces); reverted per above.                                                                                                                                                                        |
+| Quantity unit typography | `--quantity-unit-scale`                      | `--quantity-unit-tracking` + `--quantity-unit-gap`       | **repo pair wins**                                  | Two real physical properties beat one ambiguous scale factor; unit _size_ comes from the type scale (one step down), never a bespoke multiplier. Design side deletes `--quantity-unit-scale` at next sync.                                                                 |
+| Tap target knob          | `--spacing-tap` declared inside the v2 layer | `--tap-min` literal in `v2`; `--spacing-tap` in `@theme` | **`--spacing-tap`, owner `@theme` — the only knob** | C2 (DECISIONS): **done (PR 5b)** — the 44→48 change landed in `@theme`, `v2`'s `--tap-min` is now the pure alias `var(--spacing-tap)`, and the contract test pins both the alias and the 48px floor. Never set independently; the v2 layer never declares `--spacing-tap`. |
+| Evidence-spine roles     | present (names unrecoverable)                | `--spine-w` · `--spine-current` · `--spine-stale`        | **repo names win (authored `59e4c3dfc`)**           | The design-side copy proved unrecoverable, so the names were authored repo-side, derived from existing roles (`--rule-w`, `--clinical-accent`, `--warning`) rather than reconstructed from prose.                                                                          |
+| Status-mark roles        | present (names unrecoverable)                | `--status-mark-size` · `--status-mark-stroke`            | **repo names win (authored `59e4c3dfc`)**           | Codifies `StatusMark`'s previously-inline geometry (`--gutter-dot` size; the component's own stroke).                                                                                                                                                                      |
+| Confidence-meter roles   | present (names unrecoverable)                | _(absent, deliberately)_                                 | **deferred — no call site**                         | `ConfidenceMeter` (P2) is unbuilt; no new token without a call site. The family enters `v2` with the component.                                                                                                                                                            |
 
 ---
 
@@ -40,26 +40,26 @@ This is the two-sources-of-truth failure C1 exists to kill. One winner per role:
 
 Declared in the `.ckb-v2` structural block **[verified: full read at `ef13a072a`]**.
 
-| Group            | Roles                                                                                                                                       | Notes                                                                                                                                                               |
-| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Space scale      | `--space-0` … `--space-11`                                                                                                                  | 4px base. Markup never references the raw scale — semantic tokens only.                                                                                             |
-| Semantic gaps    | `--gap-tight` · `--gap-inline` · `--gap-stack` · `--gap-block` · `--gap-section`                                                            | The only inter-element spacing markup may use.                                                                                                                      |
-| Semantic padding | `--pad-chip-x` · `--pad-control-x` · `--pad-cta-x` · `--pad-card` · `--pad-panel` · `--pad-strip`                                           | Heading-inset convention rides on these (SPEC §4.6).                                                                                                                |
-| Page             | `--page-gutter` · `--page-max` · `--measure` · `--header-h`                                                                                 | `--measure` is the prose measure — never wider.                                                                                                                     |
-| Type steps       | `--text-{xs,sm,body,md,lg,xl}` each with `-lh` and `-tr` · `--text-hero` · `--text-hero--line-height` · `--text-hero-tr`                    | Seven steps, per-step line-height and tracking (gated). ⚠️ `--text-hero--line-height` is the one double-dash name — keep as-is; renaming is churn without a defect. |
-| Type companions  | `--leading-prose` · `--tracking-eyebrow` · `--nums`                                                                                         | `--nums` = numeric variant for all data.                                                                                                                            |
-| Weights          | `--font-weight-{body,label,heading,value}`                                                                                                  | One job each; display uses heading weight (SPEC §4.6).                                                                                                              |
-| Radius           | `--radius-{sm,md,lg,xl,2xl}`                                                                                                                | One step per surface role. ⚠️ v2 `--radius-md` ≠ live `--radius-md` — adoption is PR 5c, its own visual diff.                                                       |
-| Icons            | `--icon-{xs,sm,md,lg}`                                                                                                                      | Paired to adjacent type steps.                                                                                                                                      |
-| Density          | `--tap-min` (→ alias of `--spacing-tap`, §1) · `--chip-height` · `--row-comfortable` · `--row-compact` · `--cell-pad-{comfortable,compact}` | Tap target is not row height (gated: `--row-compact` ≠ `--tap-min`).                                                                                                |
-| Accent rules     | `--rule-w` · `--rule-accent` · `--rule-warning`                                                                                             | ⚠️ Reference `var(--clinical-accent)` / `var(--warning)` **without declaring them** — v2 depends on the live layer for both (§5).                                   |
-| Evidence gutter  | `--gutter-col` · `--gutter-dot` · `--gutter-line-w`                                                                                         | One gutter column owns line and dot (SPEC §7).                                                                                                                      |
-| Evidence spine   | `--spine-w` · `--spine-current` · `--spine-stale`                                                                                           | Authored `59e4c3dfc` (§1); derived from rule/accent/warning roles.                                                                                                  |
-| Status mark      | `--status-mark-size` · `--status-mark-stroke`                                                                                               | Authored `59e4c3dfc` (§1); codifies `StatusMark`'s inline geometry.                                                                                                 |
-| Quantity         | `--quantity-unit-tracking` · `--quantity-unit-gap`                                                                                          | Winners per §1.                                                                                                                                                     |
-| Dashed edge      | `--border-dashed`                                                                                                                           | Drop targets / "nothing here yet" — distinct from `--border-strong`, which means emphasis.                                                                          |
-| Stacking         | `--z-{base,raised,chrome,overlay,popover,modal,toast}`                                                                                      | Each rung names its `--eN` partner; toast above modal deliberately.                                                                                                 |
-| Motion           | `--duration-{fast,base,slow}` · `--ease-standard` · `--ease-physical`                                                                       | Durations zero under `prefers-reduced-motion` (gated).                                                                                                              |
+| Group            | Roles                                                                                                                                     | Notes                                                                                                                                                               |
+| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Space scale      | `--space-0` … `--space-11`                                                                                                                | 4px base. Markup never references the raw scale — semantic tokens only.                                                                                             |
+| Semantic gaps    | `--gap-tight` · `--gap-inline` · `--gap-stack` · `--gap-block` · `--gap-section`                                                          | The only inter-element spacing markup may use.                                                                                                                      |
+| Semantic padding | `--pad-chip-x` · `--pad-control-x` · `--pad-cta-x` · `--pad-card` · `--pad-panel` · `--pad-strip`                                         | Heading-inset convention rides on these (SPEC §4.6).                                                                                                                |
+| Page             | `--page-gutter` · `--page-max` · `--measure` · `--header-h`                                                                               | `--measure` is the prose measure — never wider.                                                                                                                     |
+| Type steps       | `--text-{xs,sm,body,md,lg,xl}` each with `-lh` and `-tr` · `--text-hero` · `--text-hero--line-height` · `--text-hero-tr`                  | Seven steps, per-step line-height and tracking (gated). ⚠️ `--text-hero--line-height` is the one double-dash name — keep as-is; renaming is churn without a defect. |
+| Type companions  | `--leading-prose` · `--tracking-eyebrow` · `--nums`                                                                                       | `--nums` = numeric variant for all data.                                                                                                                            |
+| Weights          | `--font-weight-{body,label,heading,value}`                                                                                                | One job each; display uses heading weight (SPEC §4.6).                                                                                                              |
+| Radius           | `--radius-{sm,md,lg,xl,2xl}`                                                                                                              | One step per surface role. ⚠️ v2 `--radius-md` ≠ live `--radius-md` — adoption is PR 5c, its own visual diff.                                                       |
+| Icons            | `--icon-{xs,sm,md,lg}`                                                                                                                    | Paired to adjacent type steps.                                                                                                                                      |
+| Density          | `--tap-min` (alias of `--spacing-tap`, §1) · `--chip-height` · `--row-comfortable` · `--row-compact` · `--cell-pad-{comfortable,compact}` | Tap target is not row height (gated on resolved values, not strings, now that `--tap-min` is an alias).                                                             |
+| Accent rules     | `--rule-w` · `--rule-accent` · `--rule-warning`                                                                                           | ⚠️ Reference `var(--clinical-accent)` / `var(--warning)` **without declaring them** — v2 depends on the live layer for both (§5).                                   |
+| Evidence gutter  | `--gutter-col` · `--gutter-dot` · `--gutter-line-w`                                                                                       | One gutter column owns line and dot (SPEC §7).                                                                                                                      |
+| Evidence spine   | `--spine-w` · `--spine-current` · `--spine-stale`                                                                                         | Authored `59e4c3dfc` (§1); derived from rule/accent/warning roles.                                                                                                  |
+| Status mark      | `--status-mark-size` · `--status-mark-stroke`                                                                                             | Authored `59e4c3dfc` (§1); codifies `StatusMark`'s inline geometry.                                                                                                 |
+| Quantity         | `--quantity-unit-tracking` · `--quantity-unit-gap`                                                                                        | Winners per §1.                                                                                                                                                     |
+| Dashed edge      | `--border-dashed`                                                                                                                         | Drop targets / "nothing here yet" — distinct from `--border-strong`, which means emphasis.                                                                          |
+| Stacking         | `--z-{base,raised,chrome,overlay,popover,modal,toast}`                                                                                    | Each rung names its `--eN` partner; toast above modal deliberately.                                                                                                 |
+| Motion           | `--duration-{fast,base,slow}` · `--ease-standard` · `--ease-physical`                                                                     | Durations zero under `prefers-reduced-motion` (gated).                                                                                                              |
 
 ## 3 · v2 shell inventory — light and dark blocks
 
@@ -94,15 +94,15 @@ the full pair-matrix gate lands (GATES §2, gate 1).
 
 The v2 layer _references_ or _depends on_ these; their values stay in `live` / `@theme`:
 
-| Role                                                    | Owner            | Rule                                                                                                                       |
-| ------------------------------------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `--spacing-tap`                                         | `@theme`         | **The** tap knob; generates `min-h-tap`/`h-tap`/`size-tap`/`min-w-tap`/`w-tap` (407 call sites). 44→48 lands here (PR 5b). |
-| `--clinical-accent`                                     | `live`           | Consumed by v2 `--rule-accent` without declaration — inherited dependency.                                                 |
-| `--warning`                                             | `live`           | Consumed by v2 `--rule-warning` — same.                                                                                    |
-| `--danger`, `--danger-solid`, `--danger-solid-contrast` | `live`           | Filled danger pairs with `--danger-solid-contrast` (HCM-mapped to `MarkText`); pairing enforced from PR 3.                 |
-| `--success`, `--info`                                   | `live`           | Clinical/status palette — reserved channel.                                                                                |
-| `--focus`                                               | `live`           | The only focus outline colour; no companion ring, ever.                                                                    |
-| `--text-placeholder`                                    | `planned` (PR 3) | New role ≥4.5:1; until it exists, placeholders use `--text-muted`.                                                         |
+| Role                                                    | Owner            | Rule                                                                                                                        |
+| ------------------------------------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| `--spacing-tap`                                         | `@theme`         | **The** tap knob; generates `min-h-tap`/`h-tap`/`size-tap`/`min-w-tap`/`w-tap` (426 call sites). 44→48 landed here (PR 5b). |
+| `--clinical-accent`                                     | `live`           | Consumed by v2 `--rule-accent` without declaration — inherited dependency.                                                  |
+| `--warning`                                             | `live`           | Consumed by v2 `--rule-warning` — same.                                                                                     |
+| `--danger`, `--danger-solid`, `--danger-solid-contrast` | `live`           | Filled danger pairs with `--danger-solid-contrast` (HCM-mapped to `MarkText`); pairing enforced from PR 3.                  |
+| `--success`, `--info`                                   | `live`           | Clinical/status palette — reserved channel.                                                                                 |
+| `--focus`                                               | `live`           | The only focus outline colour; no companion ring, ever.                                                                     |
+| `--text-placeholder`                                    | `planned` (PR 3) | New role ≥4.5:1; until it exists, placeholders use `--text-muted`.                                                          |
 
 ## 6 · Deprecations and deletions
 
diff --git a/src/app/ckb-v2-tokens.css b/src/app/ckb-v2-tokens.css
index 32875a06d..632c89b8d 100644
--- a/src/app/ckb-v2-tokens.css
+++ b/src/app/ckb-v2-tokens.css
@@ -100,7 +100,11 @@
   --icon-lg: 1.25rem; /* 20 - empty states, tiles */
 
   /* Density - tap target is not row height */
-  --tap-min: 2.75rem; /* 44 - interactive only */
+  /* Pure alias of the @theme knob (C2). The value lives in globals.css because
+     that is where the *-tap utilities are generated; declaring it here would
+     either lose a same-specificity tie (design-side :root copy) or win inside
+     opted-in subtrees and split the app 44/48. Never set independently. */
+  --tap-min: var(--spacing-tap); /* interactive only */
   --chip-height: 1.75rem; /* 28 - static chips */
   --row-comfortable: 2.75rem;
   --row-compact: 2.25rem;
diff --git a/src/app/globals.css b/src/app/globals.css
index 6a62567f3..4f3be273d 100644
--- a/src/app/globals.css
+++ b/src/app/globals.css
@@ -39,13 +39,19 @@
   --radius-xl: 1rem;
   --radius-2xl: 1.25rem;
 
-  /* Minimum interactive target (WCAG 2.5.5 / 2.5.8). Named spacing token so the
-     44px tap-target minimum is a single source of truth instead of copy-pasted
-     `min-h-11` / `h-[44px]` magic numbers. Generates min-h-tap, h-tap, w-tap,
-     min-w-tap, size-tap. Semantic intent: "this is a touch target", not "44px".
-     NB: controls that flake the ui-smoke sub-pixel tap-target check when scrolled
-     deep in sheets stay on min-h-12 (48px) — do not downgrade those to the token. */
-  --spacing-tap: 2.75rem;
+  /* Minimum interactive target (WCAG 2.5.5 / 2.5.8) — 48px, and the design
+     system's ONE tap knob (SPEC §4.10, DECISIONS §C2). It is declared here in
+     @theme because this is the layer that generates min-h-tap / h-tap / w-tap /
+     min-w-tap / size-tap; the v2 layer's --tap-min is a pure alias of it and
+     never carries its own value, so the app can never render a 44/48 split.
+     Semantic intent: "this is a touch target", not a pixel count.
+     NB: the min-h-12 sites now match the token rather than exceeding it — leave
+     them alone; no production target is ever reduced. A grid track sized to hold
+     a tap target uses var(--spacing-tap), never a copy of the number, or the
+     track and its child desync the next time this value moves. The one
+     deliberate exception is the phone composer, pinned to 44px below 431px so
+     the edge-to-edge dock keeps its height (see the max-width: 430px block). */
+  --spacing-tap: 3rem;
 
   /* Icon glyph size scale. Named spacing tokens so icon sizing is a documented
      scale (size-icon-md is the 16px default) instead of raw `h-4 w-4` literals,
@@ -1426,11 +1432,15 @@ summary::-webkit-details-marker {
   opacity: 0.5;
 }
 
-/* Small-phone pin for the composer icon buttons: hold the 44px tap target and a
-   1.1rem glyph below 431px (the ≥640px block grows them to 48px/3rem). Single
-   source of truth — do not re-add a second max-width:430px block for these.
-   The mode-action popover only renders ≥1024px, so this holds no .mode-action-*
-   overrides. */
+/* Small-phone pin for the composer icon buttons: hold a 44px tap target and a
+   1.1rem glyph below 431px, where the base rule above would otherwise apply the
+   48px --spacing-tap knob. This is the design system's one sanctioned exception
+   to the 48px floor (SPEC §4.10): the phone composer is an edge-to-edge dock
+   whose height is part of the search-chrome contract, and growing three buttons
+   by 4px each re-tunes the dock reserve and the phone CLS budget for no
+   accessibility gain — 44px already clears WCAG 2.5.5. Single source of truth —
+   do not re-add a second max-width:430px block for these. The mode-action
+   popover only renders ≥1024px, so this holds no .mode-action-* overrides. */
 @media (max-width: 430px) {
   .chat-composer-icon-button,
   .chat-send-button {
@@ -1798,7 +1808,7 @@ summary::-webkit-details-marker {
 
 /* Touch devices: suggestion/follow-up chips are primary tap targets (the
    follow-ups sit directly under the composer and each fires a new search).
-   Meet the 44px tap floor and widen the gap so neighbouring chips in the
+   Meet the --spacing-tap floor and widen the gap so neighbouring chips in the
    horizontal scroll row don't invite mis-taps. Fine-pointer (mouse) users keep
    the compact 32px chip — no desktop visual change. */
 @media (pointer: coarse) {
@@ -2787,7 +2797,7 @@ td,
     box-shadow: none !important;
   }
 
-  /* Source capsule: a compact visible face inside an invisible 44px tap target.
+  /* Source capsule: a compact visible face inside an invisible tap-sized target.
      Border/shadow/transform live here (component layer) so the face reads small
      while the hover, expanded, and focus chrome stay premium. Border colour is
      owned here — the face carries no border-colour utility — so these rules win
diff --git a/src/components/applications-launcher-page.tsx b/src/components/applications-launcher-page.tsx
index 2732dffb6..1526c4ea0 100644
--- a/src/components/applications-launcher-page.tsx
+++ b/src/components/applications-launcher-page.tsx
@@ -245,7 +245,10 @@ function ToolSearch({
         onSubmit();
       }}
       className={cn(
-        "grid min-h-13 grid-cols-[2.75rem_minmax(0,1fr)_2.75rem] items-center rounded-full border border-[color:var(--border)] bg-[color:var(--surface-lux)] text-left shadow-[var(--shadow-card)]",
+        // The leading track holds a tap-sized glyph and the row has no gap, so it
+        // reads the tap knob rather than a copy of its value — a literal here
+        // overlaps the input the moment `--spacing-tap` moves.
+        "grid min-h-13 grid-cols-[var(--spacing-tap)_minmax(0,1fr)_2.75rem] items-center rounded-full border border-[color:var(--border)] bg-[color:var(--surface-lux)] text-left shadow-[var(--shadow-card)]",
         className,
       )}
     >
diff --git a/src/components/clinical-dashboard/clinical-output-helpers.tsx b/src/components/clinical-dashboard/clinical-output-helpers.tsx
index e9054ece8..e6c9f9a3b 100644
--- a/src/components/clinical-dashboard/clinical-output-helpers.tsx
+++ b/src/components/clinical-dashboard/clinical-output-helpers.tsx
@@ -243,7 +243,7 @@ export function EvidenceMapTable({ rows }: { rows: AnswerEvidenceMapRow[] }) {
               data-testid="evidence-map-open-source"
               className={cn(
                 sourceCard,
-                "grid min-h-[44px] grid-cols-[minmax(0,1fr)_auto] items-center gap-3 p-3 text-sm transition hover:border-[color:var(--primary)]/45 hover:bg-[color:var(--surface-subtle)] focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[color:var(--focus)]",
+                "grid min-h-tap grid-cols-[minmax(0,1fr)_auto] items-center gap-3 p-3 text-sm transition hover:border-[color:var(--primary)]/45 hover:bg-[color:var(--surface-subtle)] focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[color:var(--focus)]",
               )}
               aria-label={`Open source for ${row.section}: ${row.bestSourceLabel}`}
             >
diff --git a/src/components/clinical-dashboard/evidence-panels.tsx b/src/components/clinical-dashboard/evidence-panels.tsx
index 9766a45e0..8209dd120 100644
--- a/src/components/clinical-dashboard/evidence-panels.tsx
+++ b/src/components/clinical-dashboard/evidence-panels.tsx
@@ -1196,7 +1196,7 @@ function RenderModelSourceList({
           <article key={`${source.id}:${source.href}`} className={cn(sourceCard, "overflow-hidden p-0")}>
             <Link
               href={source.href}
-              className="block min-h-[44px] px-3 py-3 transition hover:bg-[color:var(--surface-subtle)] focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[color:var(--focus)]"
+              className="block min-h-tap px-3 py-3 transition hover:bg-[color:var(--surface-subtle)] focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[color:var(--focus)]"
               aria-label={openLabel}
             >
               <div className="grid grid-cols-[auto_minmax(0,1fr)_auto] items-start gap-3">
diff --git a/src/components/mode-nav/mode-nav.tsx b/src/components/mode-nav/mode-nav.tsx
index 8f45a61a4..235fa22db 100644
--- a/src/components/mode-nav/mode-nav.tsx
+++ b/src/components/mode-nav/mode-nav.tsx
@@ -28,7 +28,7 @@ export type ModeNavItem = {
 const focusRing =
   "focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-[color:var(--focus)]";
 
-/** 48px hit area — clear of `expectMinTouchTarget`'s 44px and its rounding flake. */
+/** 48px hit area — matches `--spacing-tap`, clear of the `expectMinTouchTarget` rounding flake. */
 const slotBase =
   "mode-nav__slot relative flex min-h-12 min-w-0 items-center justify-center px-3 no-underline transition-colors";
 
diff --git a/src/components/ui-primitives.tsx b/src/components/ui-primitives.tsx
index 91b9532a2..da9032fe4 100644
--- a/src/components/ui-primitives.tsx
+++ b/src/components/ui-primitives.tsx
@@ -95,7 +95,7 @@ export const chatAnswerText =
 export const chatActionRow =
   "flex min-h-tap flex-wrap items-center gap-1.5 text-xs font-semibold text-[color:var(--text-heading)] sm:min-h-8";
 export const chatMicroAction = `inline-flex min-h-tap min-w-tap items-center justify-center gap-1.5 rounded-md px-2 text-xs font-semibold text-[color:var(--text-muted)] transition hover:bg-[color:var(--clinical-accent-soft)] hover:text-[color:var(--clinical-accent)] focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[color:var(--focus)] ${controlDisabled}`;
-// Answer "Sources" capsule. `sourceCapsuleHit` is an invisible 44px WCAG touch
+// Answer "Sources" capsule. `sourceCapsuleHit` is an invisible tap-sized WCAG touch
 // target that wraps the compact visible pill `sourceCapsule` (`.source-capsule-face`),
 // so the control reads smaller and lighter without shrinking the tap area. Hover,
 // expanded, and focus chrome are driven from the hit target's :hover /
@@ -200,7 +200,7 @@ type IconButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "aria-label
 
 /**
  * Accessible icon-only button. Guarantees the accessible name (`aria-label`), an
- * `aria-hidden` icon glyph, a 44px tap target, and the shared focus ring. Pass a
+ * `aria-hidden` icon glyph, a `--spacing-tap` hit area, and the shared focus ring. Pass a
  * recipe like `toolbarButton`/`floatingControl` via `className` for chrome; the
  * base stays colour-neutral so the glyph inherits `currentColor` from context.
  */
diff --git a/src/components/ui/button.tsx b/src/components/ui/button.tsx
index 2e86b3dc0..d1aaf4894 100644
--- a/src/components/ui/button.tsx
+++ b/src/components/ui/button.tsx
@@ -26,7 +26,7 @@ const VARIANT: Record<ButtonVariant, string> = {
     "bg-[color:var(--danger-solid)] text-[color:var(--danger-solid-contrast)] shadow-[var(--shadow-tight)] hover:brightness-110 active:brightness-95",
 };
 
-// Height is the tap target and never drops below 44px; `size` moves the optical
+// Height is the tap target and never drops below `--spacing-tap` (48px); `size` moves the optical
 // padding and label step, not the hit area (register #7/#18).
 const SIZE: Record<ButtonSize, string> = {
   sm: "px-3 text-xs",
diff --git a/src/components/ui/chip.tsx b/src/components/ui/chip.tsx
index 1e7bc79f3..211d677d6 100644
--- a/src/components/ui/chip.tsx
+++ b/src/components/ui/chip.tsx
@@ -38,7 +38,7 @@ type ChipBase = {
 export type ChipProps = ChipBase &
   ({ onRemove: () => void; removeLabel: string } | { onRemove?: never; removeLabel?: never });
 
-// A chip is static text at 28px (`--chip-height`), NOT a 44px tap target — that
+// A chip is static text at 28px (`--chip-height`), NOT a tap target — that
 // floor is for interactive controls (register #7/#18). The remove control inside
 // a removable chip is interactive and keeps its own hit area.
 export function Chip({
diff --git a/src/components/ui/citation.tsx b/src/components/ui/citation.tsx
index 293e90714..7848db1eb 100644
--- a/src/components/ui/citation.tsx
+++ b/src/components/ui/citation.tsx
@@ -30,7 +30,7 @@ export type CitationProps = CitationBase &
  * class strings (`sourceCapsuleHit`, `sourceCapsule`, `sourceCapsuleCountBadge`)
  * plus unlayered CSS, so a designer could not place one and nothing tested it.
  *
- * Structure: an invisible 44px hit target wrapping a compact visible face. The
+ * Structure: an invisible tap-sized hit target wrapping a compact visible face. The
  * chip reads small and light without shrinking the tap area — the same trick the
  * old recipes used, kept because it is correct.
  *
diff --git a/tests/ckb-v2-token-contract.test.ts b/tests/ckb-v2-token-contract.test.ts
index c4f0a3986..f1a9a6896 100644
--- a/tests/ckb-v2-token-contract.test.ts
+++ b/tests/ckb-v2-token-contract.test.ts
@@ -20,6 +20,15 @@ import { describe, expect, it } from "vitest";
  */
 
 const stylesheet = readFileSync(new URL("../src/app/ckb-v2-tokens.css", import.meta.url), "utf8");
+const globalsStylesheet = readFileSync(new URL("../src/app/globals.css", import.meta.url), "utf8");
+
+// The tap knob lives in the globals `@theme` block, not here (C2), so density
+// relationships have to be checked across both files.
+const tapKnobRem = Number.parseFloat(/^\s*--spacing-tap:\s*([\d.]+)rem;/m.exec(globalsStylesheet)?.[1] ?? "0");
+
+function remOf(value: string | undefined) {
+  return value?.endsWith("rem") ? Number.parseFloat(value) : Number.NaN;
+}
 
 function block(selector: string) {
   // After the cascade port there are two top-level `.ckb-v2` blocks (structural
@@ -257,9 +266,24 @@ describe("ckb-v2 structure", () => {
   });
 
   it("separates the tap-target floor from the static chip height (#7, #18)", () => {
-    expect(structural.get("--tap-min")).toBe("2.75rem");
+    expect(structural.get("--tap-min")).toBe("var(--spacing-tap)");
     expect(structural.get("--chip-height")).toBe("1.75rem");
     expect(structural.get("--row-compact")).not.toBe(structural.get("--tap-min"));
+    // Resolved, not just textually different: --tap-min is an alias now, so a
+    // string comparison alone would pass even if the knob were retuned onto the
+    // compact row height.
+    expect(tapKnobRem).not.toBe(remOf(structural.get("--row-compact")));
+    expect(tapKnobRem).not.toBe(remOf(structural.get("--chip-height")));
+  });
+
+  it("keeps the tap knob in @theme at 48px, and never redeclares it in the v2 layer (C2)", () => {
+    // One knob. Declaring --spacing-tap here would lose a same-specificity tie in
+    // a :root-structural copy and win inside opted-in subtrees in this
+    // class-scoped one — a 44/48 split app either way (DECISIONS §C2).
+    expect(structural.has("--spacing-tap")).toBe(false);
+    expect(stylesheet.replace(/\/\*[\s\S]*?\*\//g, "")).not.toMatch(/^\s*--spacing-tap\s*:/m);
+    expect(tapKnobRem, "--spacing-tap must be declared in the globals @theme block").toBeGreaterThan(0);
+    expect(tapKnobRem * 16).toBeGreaterThanOrEqual(48);
   });
 
   it("zeroes motion durations under prefers-reduced-motion", () => {
diff --git a/tests/ui-style-contract.spec.ts b/tests/ui-style-contract.spec.ts
index 4c987cb5c..f5265ccb2 100644
--- a/tests/ui-style-contract.spec.ts
+++ b/tests/ui-style-contract.spec.ts
@@ -102,7 +102,7 @@ test.describe("unlayered style rules render their effect", () => {
         `${element.tagName.toLowerCase()}.${(element.className || "").toString().split(/\s+/).slice(0, 3).join(".")}`;
       const tapToken = getComputedStyle(document.documentElement).getPropertyValue("--spacing-tap").trim();
       const probe = document.createElement("div");
-      probe.style.height = tapToken || "2.75rem";
+      probe.style.height = tapToken || "3rem";
       document.body.appendChild(probe);
       const tapFloor = probe.getBoundingClientRect().height;
       probe.remove();
@@ -130,7 +130,9 @@ test.describe("unlayered style rules render their effect", () => {
       return { tapFloor, measuredCount, inlineCarriers, undersized };
     });
 
-    expect(audit.tapFloor, "--spacing-tap must resolve to a real pixel floor").toBeGreaterThanOrEqual(44);
+    // 48px since PR 5b: the knob is the design system's single tap floor
+    // (SPEC §4.10) and no production target is ever reduced below it.
+    expect(audit.tapFloor, "--spacing-tap must resolve to a real pixel floor").toBeGreaterThanOrEqual(48);
     expect(audit.measuredCount, "expected at least one rendered tap-sized control").toBeGreaterThan(0);
     expect(audit.inlineCarriers, "tap-sized min-height is inert on inline boxes").toEqual([]);
     expect(audit.undersized, "controls rendered below their declared min-height").toEqual([]);
diff --git a/tests/ui-tools.spec.ts b/tests/ui-tools.spec.ts
index 8db5b8a76..923879061 100644
--- a/tests/ui-tools.spec.ts
+++ b/tests/ui-tools.spec.ts
@@ -796,8 +796,10 @@ test.describe("Clinical KB tools launcher", () => {
         headingFontSize,
         subtitleFontSize,
       };
-      expect(metrics.iconWidth).toBe(44);
-      expect(metrics.iconHeight).toBe(44);
+      // The hero tile is `h-tap w-tap` on phones, so it tracks `--spacing-tap`
+      // (48px since PR 5b), not a standalone pixel choice.
+      expect(metrics.iconWidth).toBe(48);
+      expect(metrics.iconHeight).toBe(48);
       expect(metrics.headingFontSize).toBeCloseTo(23.2, 1);
       expect(metrics.subtitleFontSize).toBeCloseTo(14, 1);
 

From d33721b436c05014e8ef1f362a945fe9574e676e Mon Sep 17 00:00:00 2001
From: BigSimmo <87357024+BigSimmo@users.noreply.github.com>
Date: Sun, 2 Aug 2026 11:08:11 +0800
Subject: [PATCH 3/6] DS V2 PR-V 5c: move the control radius to 10px

Live @theme --radius-md goes 0.5rem -> 0.625rem, which is the value the v2 layer already declares for controls, inputs and buttons. The two layers disagreeing is what made adoption reshape every control on a surface the moment it opted in (SPEC 4.6), so the step lands here, once, moving all 243 rounded-md call sites across 81 files with a single visual diff instead of one surprise per adopted surface.

The 4px-grid pin flips in the same commit: the ladder now carries two named half-steps (sm 6px, md 10px) so a third cannot slip in, and the test additionally asserts the v2 control rung equals the live one - the drift this commit closes cannot silently reopen.

Fourteen arbitrary radius literals are absorbed onto the ladder, each to its nearest rung with ties going to the smaller: the therapy 9/10/11/14px values PR-T carried over from the retired stylesheet, the 5px choice box, and the 1.1/1.15/1.35rem dialog and popover corners. The 2px cap on the mode-nav indicator stays a literal and now says why - it is a hairline below the ladder's 4px floor, where the nearest rung would double it into a visible dome.
---
 docs/design-system.md                           |  8 +++++---
 docs/design-system/SPEC.md                      | 13 +++++++++----
 docs/design-system/TOKENS.md                    |  2 +-
 src/app/globals.css                             | 17 +++++++++++------
 .../clinical-dashboard/account-setup-dialog.tsx |  2 +-
 .../clinical-dashboard/mode-action-popup.tsx    |  2 +-
 .../clinical-dashboard/settings-dialog.tsx      |  4 ++--
 src/components/mode-home-template.tsx           |  2 +-
 src/components/mode-nav/mode-nav.tsx            |  5 ++++-
 src/components/therapy-compass/bindings.tsx     |  4 ++--
 src/components/therapy-compass/controls.ts      |  4 ++--
 .../therapy-compass/screens/detail-screen.tsx   |  2 +-
 .../screens/recommend-screen.tsx                |  2 +-
 src/components/therapy-compass/therapy-card.tsx |  2 +-
 src/components/ui/choice.tsx                    |  4 ++--
 tests/design-token-contract.test.ts             | 14 ++++++++++++--
 16 files changed, 56 insertions(+), 31 deletions(-)

diff --git a/docs/design-system.md b/docs/design-system.md
index af80d224e..5d5489c7f 100644
--- a/docs/design-system.md
+++ b/docs/design-system.md
@@ -137,9 +137,11 @@ Icon **glyphs** use the parallel `--spacing-icon-*` scale in `@theme`:
 
 ## 4. Radius & shadows
 
-- Radii come from `@theme` and run on the 4px grid — `xs` 4 · `sm` 6 · `md` 8 · `lg` 12 ·
-  `xl` 16 · `2xl` 20 (px). `sm` is the one deliberate half-step, for chips and pills that read
-  as too heavy at 8. Roles are unchanged: `rounded-md` chips/pills · `rounded-lg`
+- Radii come from `@theme` — `xs` 4 · `sm` 6 · `md` 10 · `lg` 12 · `xl` 16 · `2xl` 20 (px).
+  Two deliberate half-steps off the 4px grid: `sm` at 6, for chips and pills that read as too
+  heavy at 8, and `md` at 10, which is the control radius the v2 layer also declares. A third
+  half-step fails `tests/design-token-contract.test.ts`. Roles are unchanged: `rounded-md`
+  chips/pills · `rounded-lg`
   controls/cards/panels · `rounded-xl`+ sheets/dialogs. Never pass a radius token through an
   arbitrary value (`rounded-[var(--radius-md)]` → `rounded-md`) — the plain utility is the
   same token.
diff --git a/docs/design-system/SPEC.md b/docs/design-system/SPEC.md
index c03d44a21..7ef3ad827 100644
--- a/docs/design-system/SPEC.md
+++ b/docs/design-system/SPEC.md
@@ -236,9 +236,14 @@ convention:** a panel's first child is its heading and carries no top margin; th
 padding provides the space. _A compensating margin is always a symptom of a missing padding
 token._
 
-Radius: one step per surface role. ⚠️ Live `--radius-md` and v2 `--radius-md` differ (8px vs
-10px) — adoption moves **every** `rounded-md`, so it ships as its own PR with its own visual
-diff (PR 5c).
+Radius: one step per surface role. The live and v2 control rungs agreed at 10px in PR 5c,
+which moved **every** `rounded-md` in the app at once — 243 call sites across 81 files — as
+its own commit with its own visual diff, and pinned the two layers to each other so they
+cannot drift apart again. The ladder now carries two deliberate half-steps, `sm` at 6px and
+`md` at 10px; everything else is on the 4px grid, and a third half-step fails the contract
+test. An arbitrary radius literal in markup goes to its **nearest** rung, ties to the smaller
+one; the only sanctioned exception is a hairline below the 4px floor, where the nearest rung
+would be a visible change rather than a rounding of it.
 
 ### 4.7 Elevation, borders, rings
 
@@ -656,7 +661,7 @@ and adoption.** Status keys as in the header; "done" entries cite their commit.
 | --------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | PR 5a · Token values, no geometry | Colour, elevation, ink roles                                                                          | **done** — `59e4c3dfc` landed the `--shadow-well` rename, the spine and status-mark families, and the dark `--clinical-chat-document` fix; the remaining ink-role deltas landed with PR 3 (`--text-placeholder`, eyebrows and placeholders off the decoration tier, the disabled encoding). The v2 light and dark blocks now declare the same colour roles, and the only raw colour literals left in `src/` are the two `#0f766e` accent defaults, which are **not** design tokens — see the note below |
 | PR 5b · Tap 44→48 in `@theme`     | The 407-site geometry change; contract-test pin update; visual QA pass; `--tap-min` becomes the alias | **done** — `--spacing-tap: 3rem` in `@theme`; `--tap-min` reduced to `var(--spacing-tap)`; 426 `*-tap` call sites moved; three pins flipped in the same commit; the phone composer keeps a written 44px exception below 431px (§4.10)                                                                                                                                                                                                                                                                   |
-| PR 5c · Radius step               | Every `rounded-md` moves; its own visual diff                                                         | open                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| PR 5c · Radius step               | Every `rounded-md` moves; its own visual diff                                                         | **done** — live `@theme --radius-md` 8px → 10px, matching the v2 control rung and moving 243 `rounded-md` call sites; the 4px-grid pin now names both half-steps and asserts the two layers agree; 14 arbitrary radius literals absorbed onto the ladder (§4.6)                                                                                                                                                                                                                                         |
 
 **`#0f766e` is data, not a token.** The two remaining raw colour literals
 (`src/lib/medications.ts`, `src/lib/medication-records.ts`) restate a Postgres column
diff --git a/docs/design-system/TOKENS.md b/docs/design-system/TOKENS.md
index 5ad9b9417..cde524aee 100644
--- a/docs/design-system/TOKENS.md
+++ b/docs/design-system/TOKENS.md
@@ -49,7 +49,7 @@ Declared in the `.ckb-v2` structural block **[verified: full read at `ef13a072a`
 | Type steps       | `--text-{xs,sm,body,md,lg,xl}` each with `-lh` and `-tr` · `--text-hero` · `--text-hero--line-height` · `--text-hero-tr`                  | Seven steps, per-step line-height and tracking (gated). ⚠️ `--text-hero--line-height` is the one double-dash name — keep as-is; renaming is churn without a defect. |
 | Type companions  | `--leading-prose` · `--tracking-eyebrow` · `--nums`                                                                                       | `--nums` = numeric variant for all data.                                                                                                                            |
 | Weights          | `--font-weight-{body,label,heading,value}`                                                                                                | One job each; display uses heading weight (SPEC §4.6).                                                                                                              |
-| Radius           | `--radius-{sm,md,lg,xl,2xl}`                                                                                                              | One step per surface role. ⚠️ v2 `--radius-md` ≠ live `--radius-md` — adoption is PR 5c, its own visual diff.                                                       |
+| Radius           | `--radius-{sm,md,lg,xl,2xl}`                                                                                                              | One step per surface role. v2 and live `--radius-md` agreed in PR 5c and are now pinned to each other by the live token contract.                                   |
 | Icons            | `--icon-{xs,sm,md,lg}`                                                                                                                    | Paired to adjacent type steps.                                                                                                                                      |
 | Density          | `--tap-min` (alias of `--spacing-tap`, §1) · `--chip-height` · `--row-comfortable` · `--row-compact` · `--cell-pad-{comfortable,compact}` | Tap target is not row height (gated on resolved values, not strings, now that `--tap-min` is an alias).                                                             |
 | Accent rules     | `--rule-w` · `--rule-accent` · `--rule-warning`                                                                                           | ⚠️ Reference `var(--clinical-accent)` / `var(--warning)` **without declaring them** — v2 depends on the live layer for both (§5).                                   |
diff --git a/src/app/globals.css b/src/app/globals.css
index 4f3be273d..c8309a505 100644
--- a/src/app/globals.css
+++ b/src/app/globals.css
@@ -27,14 +27,19 @@
  * New overlays go through components/ui/sheet.tsx rather than a new layer.
  */
 @theme {
-  /* Radius ladder on the 4px grid: 4 · 6 · 8 · 12 · 16 · 20. `lg` used to be
-     10px, which broke the rhythm; moving it to 12 collided with `xl`, so the
-     whole upper ladder shifted a rung rather than collapsing two names onto one
-     value. `sm` stays 6px — the one deliberate half-step, for chips and pills
-     that read as too heavy at 8. */
+  /* Radius ladder: 4 · 6 · 10 · 12 · 16 · 20 — the 4px grid with two deliberate
+     half-steps. `sm` is 6px, for chips and pills that read as too heavy at 8.
+     `md` is 10px because it is the control rung, and it is the one value the v2
+     layer and the live layer had to agree on: `ckb-v2-tokens.css` sizes
+     controls, inputs and buttons at 10px, and leaving the live ladder at 8
+     meant every adopted surface silently changed shape (SPEC §4.6). Moving it
+     here instead moves every `rounded-md` at once, deliberately, with one
+     visual diff. `lg` used to be 10px, which collided with `xl` when it moved
+     to 12, so the whole upper ladder shifted a rung rather than collapsing two
+     names onto one value. */
   --radius-xs: 0.25rem;
   --radius-sm: 0.375rem;
-  --radius-md: 0.5rem;
+  --radius-md: 0.625rem;
   --radius-lg: 0.75rem;
   --radius-xl: 1rem;
   --radius-2xl: 1.25rem;
diff --git a/src/components/clinical-dashboard/account-setup-dialog.tsx b/src/components/clinical-dashboard/account-setup-dialog.tsx
index a3b9f5798..b470ea151 100644
--- a/src/components/clinical-dashboard/account-setup-dialog.tsx
+++ b/src/components/clinical-dashboard/account-setup-dialog.tsx
@@ -112,7 +112,7 @@ export function AccountSetupDialog({
       closeLabel="Close account setup"
       initialFocusRef={emailInputRef}
       bodyClassName="p-0 sm:p-0"
-      contentClassName="account-setup-dialog max-h-[calc(100dvh-0.75rem)] rounded-t-[1.35rem] border-[color:var(--border-lux)] bg-[color:var(--surface-lux)] shadow-[var(--shadow-elevated)] sm:max-h-[calc(100dvh-2rem)] sm:max-w-[32rem] sm:rounded-xl"
+      contentClassName="account-setup-dialog max-h-[calc(100dvh-0.75rem)] rounded-t-2xl border-[color:var(--border-lux)] bg-[color:var(--surface-lux)] shadow-[var(--shadow-elevated)] sm:max-h-[calc(100dvh-2rem)] sm:max-w-[32rem] sm:rounded-xl"
       portal
     >
       <form onSubmit={submit} className="relative">
diff --git a/src/components/clinical-dashboard/mode-action-popup.tsx b/src/components/clinical-dashboard/mode-action-popup.tsx
index 13cb5f0dc..b1613a5a5 100644
--- a/src/components/clinical-dashboard/mode-action-popup.tsx
+++ b/src/components/clinical-dashboard/mode-action-popup.tsx
@@ -896,7 +896,7 @@ export function ModeActionPopup({
           className={cn(
             glassOverlaySurface,
             "mode-action-panel overflow-hidden bg-[color:var(--surface-raised)] shadow-[var(--shadow-elevated)]",
-            integrated ? "rounded-[1.35rem] shadow-[var(--shadow-elevated)]" : "rounded-[1rem]",
+            integrated ? "rounded-2xl shadow-[var(--shadow-elevated)]" : "rounded-xl",
           )}
         >
           {renderPopoverHeader()}
diff --git a/src/components/clinical-dashboard/settings-dialog.tsx b/src/components/clinical-dashboard/settings-dialog.tsx
index 2ba52301c..24c86ed08 100644
--- a/src/components/clinical-dashboard/settings-dialog.tsx
+++ b/src/components/clinical-dashboard/settings-dialog.tsx
@@ -706,7 +706,7 @@ export function SettingsDialog({
 
             {/* Keyboard shortcuts */}
             <SettingsSection id="keyboard" title="Keyboard shortcuts">
-              <div className="overflow-hidden rounded-[1.1rem] border border-[color:var(--border-lux)] bg-[color:var(--surface-lux)] shadow-[var(--shadow-soft),var(--shadow-inset)] lg:rounded-xl lg:bg-[color:var(--surface)] lg:shadow-[var(--shadow-inset)]">
+              <div className="overflow-hidden rounded-xl border border-[color:var(--border-lux)] bg-[color:var(--surface-lux)] shadow-[var(--shadow-soft),var(--shadow-inset)] lg:rounded-xl lg:bg-[color:var(--surface)] lg:shadow-[var(--shadow-inset)]">
                 <ShortcutRow label="Focus search" keys={["/"]} />
                 <ShortcutRow label="Open command menu" keys={["Ctrl", "K"]} />
                 <ShortcutRow label="New question" keys={["Ctrl", "Shift", "O"]} />
@@ -717,7 +717,7 @@ export function SettingsDialog({
 
             {/* Help & About */}
             <SettingsSection id="help" title="Help & About">
-              <div className="rounded-[1.1rem] border border-[color:var(--border-lux)] bg-[color:var(--surface-lux)] p-4 shadow-[var(--shadow-soft),var(--shadow-inset)] lg:rounded-xl lg:bg-[color:var(--surface)] lg:shadow-[var(--shadow-inset)]">
+              <div className="rounded-xl border border-[color:var(--border-lux)] bg-[color:var(--surface-lux)] p-4 shadow-[var(--shadow-soft),var(--shadow-inset)] lg:rounded-xl lg:bg-[color:var(--surface)] lg:shadow-[var(--shadow-inset)]">
                 <p className="text-sm font-semibold leading-5 text-[color:var(--text-heading)]">
                   Clinical Knowledge Base
                 </p>
diff --git a/src/components/mode-home-template.tsx b/src/components/mode-home-template.tsx
index f7c34a174..f604ef3b3 100644
--- a/src/components/mode-home-template.tsx
+++ b/src/components/mode-home-template.tsx
@@ -77,7 +77,7 @@ export function ModeHomeHero({
       className="grid justify-items-center gap-1.5 px-4 sm:gap-3 sm:px-0"
       aria-labelledby={`${testId ?? "mode-home"}-title`}
     >
-      <span className="mode-home-icon grid h-tap w-tap place-items-center rounded-2xl border border-[color:var(--clinical-accent-border)] bg-[color:var(--clinical-accent-soft)] text-[color:var(--clinical-accent)] shadow-[var(--shadow-inset)] sm:h-12 sm:w-12 lg:h-14 lg:w-14 lg:rounded-[1.15rem]">
+      <span className="mode-home-icon grid h-tap w-tap place-items-center rounded-2xl border border-[color:var(--clinical-accent-border)] bg-[color:var(--clinical-accent-soft)] text-[color:var(--clinical-accent)] shadow-[var(--shadow-inset)] sm:h-12 sm:w-12 lg:h-14 lg:w-14 lg:rounded-2xl">
         <Icon className="h-5 w-5 sm:h-6 sm:w-6 lg:h-7 lg:w-7" aria-hidden="true" />
       </span>
       <div className="grid gap-1 sm:gap-1.5">
diff --git a/src/components/mode-nav/mode-nav.tsx b/src/components/mode-nav/mode-nav.tsx
index 235fa22db..2b98e7f7e 100644
--- a/src/components/mode-nav/mode-nav.tsx
+++ b/src/components/mode-nav/mode-nav.tsx
@@ -86,7 +86,10 @@ function SlotInk({
       {trailing ? <ChevronDown aria-hidden="true" className="h-3.5 w-3.5 shrink-0 opacity-55" /> : null}
       {/* The rule hangs off the ink, so it is exactly as wide as icon plus word:
           short under "Search", long under "Recommend". A rule sized to the
-          padding box always looks a few pixels wrong. */}
+          padding box always looks a few pixels wrong.
+          The 2px cap stays a literal: it is a hairline on a 2px-tall bar, below
+          the radius ladder's 4px floor, and rounding it to `rounded-t-xs` would
+          double it into a visible dome. */}
       <span
         aria-hidden="true"
         className={cn(
diff --git a/src/components/therapy-compass/bindings.tsx b/src/components/therapy-compass/bindings.tsx
index fc5e9bdfb..f9ef94f78 100644
--- a/src/components/therapy-compass/bindings.tsx
+++ b/src/components/therapy-compass/bindings.tsx
@@ -187,7 +187,7 @@ const TcContext = createContext<TcBindings | null>(null);
 
 function navStyle(active: boolean): string {
   return [
-    "inline-flex min-h-tap flex-none items-center justify-center gap-2 whitespace-nowrap rounded-[10px] border border-transparent bg-transparent px-[13px] py-2 text-sm-minus font-medium text-[color:var(--text-muted)] no-underline",
+    "inline-flex min-h-tap flex-none items-center justify-center gap-2 whitespace-nowrap rounded-md border border-transparent bg-transparent px-[13px] py-2 text-sm-minus font-medium text-[color:var(--text-muted)] no-underline",
     "hover:enabled:border-[color:var(--border-strong)] hover:enabled:bg-[color:var(--surface-subtle)] hover:enabled:text-[color:var(--text)]",
     active
       ? "border-[color:var(--clinical-accent-border)] bg-[color:var(--clinical-accent-soft)] font-semibold text-[color:var(--clinical-accent-hover)]"
@@ -216,7 +216,7 @@ function segStyle(active: boolean): string {
 }
 function chipStyle(active: boolean): string {
   return [
-    "inline-flex min-h-tap items-center justify-center rounded-[10px] border border-[color:var(--border)] bg-[color:var(--surface)] px-3.5 py-2 text-sm-minus font-semibold text-[color:var(--text-muted)]",
+    "inline-flex min-h-tap items-center justify-center rounded-md border border-[color:var(--border)] bg-[color:var(--surface)] px-3.5 py-2 text-sm-minus font-semibold text-[color:var(--text-muted)]",
     "hover:enabled:border-[color:var(--border-strong)] hover:enabled:bg-[color:var(--surface-subtle)] hover:enabled:text-[color:var(--text)]",
     active
       ? "border-[color:var(--clinical-accent-border)] bg-[color:var(--clinical-accent-soft)] font-semibold text-[color:var(--clinical-accent-hover)]"
diff --git a/src/components/therapy-compass/controls.ts b/src/components/therapy-compass/controls.ts
index 66ffaeaf8..e96a380be 100644
--- a/src/components/therapy-compass/controls.ts
+++ b/src/components/therapy-compass/controls.ts
@@ -19,7 +19,7 @@ export const therapyBtn = cn(
 );
 
 const controlBase = cn(
-  "inline-flex min-h-tap items-center justify-center gap-2 rounded-[11px] text-sm-minus font-semibold",
+  "inline-flex min-h-tap items-center justify-center gap-2 rounded-md text-sm-minus font-semibold",
   therapyBtn,
 );
 
@@ -52,7 +52,7 @@ export const softControl = cn(
 
 export const iconControl = cn(
   therapyBtn,
-  "inline-flex h-tap w-tap items-center justify-center rounded-[9px] border border-[color:var(--border)] bg-[color:var(--surface)] text-[color:var(--text-soft)]",
+  "inline-flex h-tap w-tap items-center justify-center rounded-md border border-[color:var(--border)] bg-[color:var(--surface)] text-[color:var(--text-soft)]",
   "hover:enabled:border-[color:var(--border-strong)] hover:enabled:bg-[color:var(--surface-subtle)] hover:enabled:text-[color:var(--text)]",
 );
 
diff --git a/src/components/therapy-compass/screens/detail-screen.tsx b/src/components/therapy-compass/screens/detail-screen.tsx
index 2eaf2bb4c..fdf61380e 100644
--- a/src/components/therapy-compass/screens/detail-screen.tsx
+++ b/src/components/therapy-compass/screens/detail-screen.tsx
@@ -270,7 +270,7 @@ function Tile({
 }) {
   return (
     <div
-      className={`rounded-[14px] border border-[color:var(--border)] bg-[color:var(--surface)] px-[17px] py-4 text-[color:var(--text-muted)] [&_p]:m-0 [&_p]:text-sm-minus [&_p]:leading-normal [&_p]:text-inherit ${tone === "accent" ? "border-[color:var(--clinical-accent-border)]" : tone === "warning" ? "border-[color:var(--warning-border)] bg-[color:var(--warning-bg)] text-[color:var(--warning-text)]" : tone === "info" ? "border-[color:var(--info-border)] bg-[color:var(--info-bg)] text-[color:var(--info-text)]" : ""}`}
+      className={`rounded-lg border border-[color:var(--border)] bg-[color:var(--surface)] px-[17px] py-4 text-[color:var(--text-muted)] [&_p]:m-0 [&_p]:text-sm-minus [&_p]:leading-normal [&_p]:text-inherit ${tone === "accent" ? "border-[color:var(--clinical-accent-border)]" : tone === "warning" ? "border-[color:var(--warning-border)] bg-[color:var(--warning-bg)] text-[color:var(--warning-text)]" : tone === "info" ? "border-[color:var(--info-border)] bg-[color:var(--info-bg)] text-[color:var(--info-text)]" : ""}`}
     >
       <div className="mb-2 flex items-center gap-[7px]">
         <Icon size={15} strokeWidth={1.9} />
diff --git a/src/components/therapy-compass/screens/recommend-screen.tsx b/src/components/therapy-compass/screens/recommend-screen.tsx
index 78e1a3a80..b5313c650 100644
--- a/src/components/therapy-compass/screens/recommend-screen.tsx
+++ b/src/components/therapy-compass/screens/recommend-screen.tsx
@@ -63,7 +63,7 @@ export function RecommendScreen() {
               <button
                 key={c.key}
                 type="button"
-                className={`${therapyBtn} inline-flex min-h-tap items-center rounded-[10px] border border-[color:var(--border)] bg-[color:var(--surface)] px-3.5 py-2 text-sm-minus font-semibold text-[color:var(--text-muted)] aria-pressed:border-[color:var(--clinical-accent-border)] aria-pressed:bg-[color:var(--clinical-accent-soft)] aria-pressed:font-semibold aria-pressed:text-[color:var(--clinical-accent-hover)]`}
+                className={`${therapyBtn} inline-flex min-h-tap items-center rounded-md border border-[color:var(--border)] bg-[color:var(--surface)] px-3.5 py-2 text-sm-minus font-semibold text-[color:var(--text-muted)] aria-pressed:border-[color:var(--clinical-accent-border)] aria-pressed:bg-[color:var(--clinical-accent-soft)] aria-pressed:font-semibold aria-pressed:text-[color:var(--clinical-accent-hover)]`}
                 onClick={() => b.toggleConstraint(c.key)}
                 aria-pressed={on}
               >
diff --git a/src/components/therapy-compass/therapy-card.tsx b/src/components/therapy-compass/therapy-card.tsx
index baa01a039..448660d14 100644
--- a/src/components/therapy-compass/therapy-card.tsx
+++ b/src/components/therapy-compass/therapy-card.tsx
@@ -66,7 +66,7 @@ export function ResultCard({ therapy }: { therapy: Therapy }) {
         <div className="flex gap-1">
           <button
             type="button"
-            className={`${therapyBtn} inline-flex h-tap w-tap cursor-not-allowed items-center justify-center rounded-[9px] border border-[color:var(--border)] bg-[color:var(--surface)] text-[color:var(--text-soft)] opacity-65`}
+            className={`${therapyBtn} inline-flex h-tap w-tap cursor-not-allowed items-center justify-center rounded-md border border-[color:var(--border)] bg-[color:var(--surface)] text-[color:var(--text-soft)] opacity-65`}
             disabled
             title="Favourite saving is not available yet"
             aria-label="Favourite saving is not available yet"
diff --git a/src/components/ui/choice.tsx b/src/components/ui/choice.tsx
index 6a9710598..cd36dd87d 100644
--- a/src/components/ui/choice.tsx
+++ b/src/components/ui/choice.tsx
@@ -21,7 +21,7 @@ import { cn, textMuted } from "@/components/ui-primitives";
  */
 
 const boxBase =
-  "grid size-[1.125rem] shrink-0 place-items-center rounded-[0.3125rem] border transition motion-reduce:transition-none";
+  "grid size-[1.125rem] shrink-0 place-items-center rounded-xs border transition motion-reduce:transition-none";
 
 const rowBase =
   "group flex min-h-tap w-full cursor-pointer items-start gap-3 rounded-md px-1 py-1.5 transition hover:bg-[color:var(--surface-subtle)] has-[:disabled]:cursor-not-allowed has-[:disabled]:hover:bg-transparent";
@@ -87,7 +87,7 @@ export function Checkbox({ label, description, indeterminate, disabled, classNam
           ref={(node) => {
             if (node) node.indeterminate = Boolean(indeterminate);
           }}
-          className="peer absolute inset-0 size-full cursor-pointer appearance-none rounded-[0.3125rem] disabled:cursor-not-allowed"
+          className="peer absolute inset-0 size-full cursor-pointer appearance-none rounded-xs disabled:cursor-not-allowed"
         />
         <span
           aria-hidden
diff --git a/tests/design-token-contract.test.ts b/tests/design-token-contract.test.ts
index 4166485eb..5ebdba94a 100644
--- a/tests/design-token-contract.test.ts
+++ b/tests/design-token-contract.test.ts
@@ -257,6 +257,8 @@ describe("radius ladder", () => {
     // --radius-lg sat at 10px and broke the rhythm. Moving it to 12 collided
     // with --radius-xl, so the upper ladder shifted a rung — two names must
     // never share one value, or the lg/xl role split stops meaning anything.
+    // Two half-steps are sanctioned: `sm` at 6px, and `md` at 10px since PR 5c,
+    // where the live control radius met the v2 one (SPEC §4.6).
     const rungs = ["xs", "sm", "md", "lg", "xl", "2xl"].map((step) => {
       const value = new RegExp(`--radius-${step}:\\s*([\\d.]+)rem;`, "i").exec(themeConfigBlock);
       expect(value, `--radius-${step} is not defined in @theme`).toBeTruthy();
@@ -265,10 +267,18 @@ describe("radius ladder", () => {
 
     expect(rungs, "radius ladder must ascend").toEqual([...rungs].sort((a, b) => a - b));
     expect(new Set(rungs).size, "two radius names share one value").toBe(rungs.length);
-    // 6px `sm` is the one sanctioned half-step; everything else is a multiple of 4.
-    for (const rung of rungs.filter((value) => value !== 6)) {
+    // 6px `sm` and 10px `md` are the two sanctioned half-steps; everything else
+    // is a multiple of 4. Both are named here so a third one cannot slip in.
+    const halfSteps = new Set([6, 10]);
+    for (const rung of rungs.filter((value) => !halfSteps.has(value))) {
       expect(rung % 4, `${rung}px is off the 4px grid`).toBe(0);
     }
+    // The control rung is the one the v2 layer also declares; they must agree or
+    // adopting a surface reshapes every control on it.
+    const v2 = readFileSync(new URL("../src/app/ckb-v2-tokens.css", import.meta.url), "utf8");
+    const v2ControlRadius = /^\s*--radius-md:\s*([\d.]+)rem;/m.exec(v2)?.[1];
+    expect(v2ControlRadius, "--radius-md is not declared in the v2 layer").toBeTruthy();
+    expect(Math.round(Number.parseFloat(v2ControlRadius!) * 16)).toBe(rungs[2]);
   });
 });
 

From 3bc571c7b137470fb1b473f2c387d1e97788a2d9 Mon Sep 17 00:00:00 2001
From: BigSimmo <87357024+BigSimmo@users.noreply.github.com>
Date: Sun, 2 Aug 2026 12:22:25 +0800
Subject: [PATCH 4/6] DS V2 PR-V: record the review ledger row for the values
 PR

---
 docs/branch-review-ledger.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/branch-review-ledger.md b/docs/branch-review-ledger.md
index 0bca45f0b..498e21ac3 100644
--- a/docs/branch-review-ledger.md
+++ b/docs/branch-review-ledger.md
@@ -585,3 +585,4 @@ Records before 2026-07-28 were written by hand and had drifted: 146 lines carrie
 | 2026-08-01 | claude/ds-v2-tooling-loop (PR #1568) | f6317ea48355c26e080ce45b6f574159e8397e24 | PR #1568 unblock/fix | merged origin/main (behind-but-clean; merge-tree was clean); cleared GitHub DIRTY/CONFLICTING; advisory review threads left open (not merge/CI blockers); auto-merge remains armed | merge-tree clean; ahead 7 behind 0; no provider-backed checks; no product code fix needed |
 | 2026-08-01 | claude/ds-v2-tooling-loop (PR #1568) | b76bcc9fbc39f2f986a52869c810ba3cb89994f2 | PR #1568 review-thread resolve | fixed and resolved all 13 review threads (fail-closed project identity, inventory exit code, provenance demo id, buildCmd execution, chrome pin, context7 rollback); ledger row for superseded 93d41c1 dispositioned | node --check scripts; design-sync --dry-run; no provider-backed checks |
 | 2026-08-01 | claude/ds-v2-correctness | 1aa9822978668a10447ef3246bd60cda6f1208cb | ds-v2 PR-A correctness (HCM/contrast/prop-unions) | ready-to-merge | unit 4878p; verify:ui 344p; style-contract HCM 5p; verify:pr-local green (eval:rag:offline 574/574; fixture 36/23); typecheck+ds-contract green |
+| 2026-08-02 | claude/ds-v2-values | d33721b436c05014e8ef1f362a945fe9574e676e | DS V2 PR-V values | Wave 2 self-verified before push: 5a close-out (no value deltas remain after decision J2; contract metrics unchanged at rawColorLiterals 2 / literalShadowClasses 0 / legacyTapClasses 0), 5b tap knob 2.75rem to 3rem in @theme with --tap-min reduced to var(--spacing-tap) across 426 *-tap sites and three pins flipped in-commit, 5c --radius-md 8px to 10px across 243 rounded-md sites with the 4px-grid pin naming both half-steps and 14 arbitrary radius literals absorbed. Two carve-outs recorded in SPEC 4.10/4.6: the phone composer stays 44px below 431px, and the 2px mode-nav hairline stays off the ladder. An offline.html tap bump was reverted before push because it would have forced a service-worker CACHE_VERSION bump. Known-red local gate: tests/ui-smoke.spec.ts:2221 phone runway pin fails on unmodified origin/main here too (maxOffset 99 at base vs 111 at this head, reproduced in a pristine capture worktree) while CI run 30720360137 is green on the same tree - plan finding L, CI binding. | typecheck exit 0; verify:pr-local PASS with 4880 passed 3 skipped (4883) in 471 files, production build compiled, client-bundle secret scan passed, eval:rag:offline fixture line plus 574/574 (better than the J4 known-red baseline); verify:ui 346 passed 1 failed (the known-red phone runway pin); verify:phone-chrome --full=never contracts 116/116 and ui-tools 87/87 with the same single known-red test; test:e2e:critical 15/15; design-system contract, branch-review-ledger, outstanding-issues, sitemap, docs link/index/inventory/scripts all exit 0 |

From 48012d359b84daae347201697c82f3e433c182c5 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sun, 2 Aug 2026 04:48:22 +0000
Subject: [PATCH 5/6] DS V2 PR-V: fix tap leftovers and retune phone chrome
 pins

Complete the phone-composer 44px exception for the input, move Tools
search submit onto the tap knob, demote gate 2 to honest partial
coverage, correct the SPEC 426-site count, and retune short-runway
smoke pins for the 48px geometry.

Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
---
 docs/design-system/GATES.md                   | 82 +++++++++----------
 docs/design-system/SPEC.md                    | 19 +++--
 src/app/globals.css                           | 27 +++---
 src/components/applications-launcher-page.tsx | 12 +--
 .../account-setup-dialog.tsx                  |  2 +-
 tests/mobile-interaction-regressions.test.ts  |  6 ++
 tests/ui-overlay-css-contract.test.ts         |  2 +-
 tests/ui-smoke.spec.ts                        | 22 +++--
 8 files changed, 97 insertions(+), 75 deletions(-)

diff --git a/docs/design-system/GATES.md b/docs/design-system/GATES.md
index 30079567c..5833699ab 100644
--- a/docs/design-system/GATES.md
+++ b/docs/design-system/GATES.md
@@ -37,20 +37,20 @@ those rules as gates.
 
 ## 2 · The twelve system gates, labelled
 
-| #   | Gate                                                                                                                                          | Status                   | Evidence / path to blocking                                                                                                                                                                                                                                                                                                                                                                                                             |
-| --- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 1   | Contrast ≥4.5:1 for every text/background pair, both themes, live **and** v2; `--decoration-soft` asserted below 4.5 and never on a text node | **implemented-blocking** | v2 pairs + `--text-placeholder` + `--decoration-soft` tier + recipe AST (`decoration-on-text.contract.test.ts`); live full matrix remains follow-on.                                                                                                                                                                                                                                                                                    |
-| 2   | Tap targets ≥48px interactive; static pills never carry `min-h-tap`; no production target reduced                                             | **implemented-blocking** | `--spacing-tap` is 48px and pinned from both sides: `ckb-v2-token-contract` asserts the `@theme` knob is ≥48 and that `--tap-min` is its alias, `ui-style-contract` measures the rendered floor in Chromium, and the legacy-class and literal ratchets still run. Two carve-outs are written down rather than gated away: the phone composer below 431px (SPEC §4.10) and per-surface geometry, which stays in the held visual harness. |
-| 3   | Focus outline present, `--focus`, no companion ring                                                                                           | **planned**              | `--focus` is referenced nowhere in the DS export (finding N3). Global fix first, then the check.                                                                                                                                                                                                                                                                                                                                        |
-| 4   | Non-colour encoding on every status indicator                                                                                                 | **manual → planned**     | `MissingValue`/`DoseLine` text marks arrive in PR 6; contract test follows.                                                                                                                                                                                                                                                                                                                                                             |
-| 5   | Tables: semantic caption, associated headers, `aria-controls` on the expander                                                                 | **implemented-partial**  | Expander and alignment tested; semantic-caption rule fails today (div caption, optional).                                                                                                                                                                                                                                                                                                                                               |
-| 6   | Enum resilience — neutral fallback, never throws                                                                                              | **implemented-blocking** | `source-badges-off-vocab.dom.test.tsx`.                                                                                                                                                                                                                                                                                                                                                                                                 |
-| 7   | Elevation monotonicity — no child heavier than its parent                                                                                     | **implemented-partial**  | Token-ramp monotonicity is tested; the per-surface child/parent rule is planned (needs a render-tree check).                                                                                                                                                                                                                                                                                                                            |
-| 8   | Edge ownership — no `border-*` + `ring-*` on one surface; no 1px spread in a drop shadow                                                      | **implemented-partial**  | Ladder is tested spread-free; the per-surface co-occurrence lint and spread-term check are planned (PR 9). The spread form was chosen _because_ it is mechanically lintable.                                                                                                                                                                                                                                                            |
-| 9   | No layout-property animation; no hardcoded durations                                                                                          | **planned**              | PR 9 wires `--duration-*`/`--ease-*` and adds the lint; ten known layout-animation sites are the seed list.                                                                                                                                                                                                                                                                                                                             |
-| 10  | Named z and motion tokens have real consumers; no unapproved `z-` value                                                                       | **implemented-partial**  | `require-z-index-ladder` lints z discipline; motion-token consumption is planned (one consumer today against 25 hardcoded durations).                                                                                                                                                                                                                                                                                                   |
-| 11  | Published-type conformance — every `dtsPropsFor` entry assignable from source props                                                           | **planned**              | PR 12 generates declarations from real types; known drift: `confirmPhraseLabel`, Sheet omissions, narrowed callbacks.                                                                                                                                                                                                                                                                                                                   |
-| 12  | Component coverage — every registered component has a direct behavioural test                                                                 | **implemented-partial**  | Tested subset in COMPONENTS §0; registry-wide requirement lands with PR 12.                                                                                                                                                                                                                                                                                                                                                             |
+| #   | Gate                                                                                                                                          | Status                   | Evidence / path to blocking                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| --- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1   | Contrast ≥4.5:1 for every text/background pair, both themes, live **and** v2; `--decoration-soft` asserted below 4.5 and never on a text node | **implemented-blocking** | v2 pairs + `--text-placeholder` + `--decoration-soft` tier + recipe AST (`decoration-on-text.contract.test.ts`); live full matrix remains follow-on.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| 2   | Tap targets ≥48px interactive; static pills never carry `min-h-tap`; no production target reduced                                             | **implemented-partial**  | `--spacing-tap` is 48px and pinned from both sides: `ckb-v2-token-contract` asserts the `@theme` knob is ≥48 and that `--tap-min` is its alias, `ui-style-contract` measures the rendered floor for declared `min-height` carriers in Chromium, and the legacy-class and literal ratchets still run. Residual gap before blocking: the Chromium audit skips elements whose declared height is below the floor (so a fixed `h-10` control would not fail it), and full interactive enumeration with an explicit exception list is still open. Written carve-outs: the phone composer below 431px (SPEC §4.10) and per-surface geometry in the held visual harness. |
+| 3   | Focus outline present, `--focus`, no companion ring                                                                                           | **planned**              | `--focus` is referenced nowhere in the DS export (finding N3). Global fix first, then the check.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| 4   | Non-colour encoding on every status indicator                                                                                                 | **manual → planned**     | `MissingValue`/`DoseLine` text marks arrive in PR 6; contract test follows.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| 5   | Tables: semantic caption, associated headers, `aria-controls` on the expander                                                                 | **implemented-partial**  | Expander and alignment tested; semantic-caption rule fails today (div caption, optional).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| 6   | Enum resilience — neutral fallback, never throws                                                                                              | **implemented-blocking** | `source-badges-off-vocab.dom.test.tsx`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| 7   | Elevation monotonicity — no child heavier than its parent                                                                                     | **implemented-partial**  | Token-ramp monotonicity is tested; the per-surface child/parent rule is planned (needs a render-tree check).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| 8   | Edge ownership — no `border-*` + `ring-*` on one surface; no 1px spread in a drop shadow                                                      | **implemented-partial**  | Ladder is tested spread-free; the per-surface co-occurrence lint and spread-term check are planned (PR 9). The spread form was chosen _because_ it is mechanically lintable.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| 9   | No layout-property animation; no hardcoded durations                                                                                          | **planned**              | PR 9 wires `--duration-*`/`--ease-*` and adds the lint; ten known layout-animation sites are the seed list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| 10  | Named z and motion tokens have real consumers; no unapproved `z-` value                                                                       | **implemented-partial**  | `require-z-index-ladder` lints z discipline; motion-token consumption is planned (one consumer today against 25 hardcoded durations).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| 11  | Published-type conformance — every `dtsPropsFor` entry assignable from source props                                                           | **planned**              | PR 12 generates declarations from real types; known drift: `confirmPhraseLabel`, Sheet omissions, narrowed callbacks.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| 12  | Component coverage — every registered component has a direct behavioural test                                                                 | **implemented-partial**  | Tested subset in COMPONENTS §0; registry-wide requirement lands with PR 12.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 
 **Computed-style suites (planned, PR 1–2):** Tailwind conflict order · v2 cascade, ancestor
 **and** same-node forms · HCM remapping under all three v2 selectors · z-index · target
@@ -68,33 +68,33 @@ as design tokens · export/preview parity.
 
 ## 3 · The prohibition table
 
-| Never do this                                                        | Gate                                                                                             | Status                                                                           |
-| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- |
-| Reintroduce `.ckb-v2:not(.dark)`                                     | Cascade computed-style test (PR 1) + contract-test selector filter update                        | implemented-blocking — landed #1538; contract parser + dark-ink regression guard |
-| Add `prefers-color-scheme` rules to the v2 layer                     | — (users pin a theme against OS preference)                                                      | **manual**                                                                       |
-| Paint a numeral with a status colour; use amber/red decoratively     | Colour-boundary lint                                                                             | planned                                                                          |
-| Put `--decoration-soft`/`--text-soft` on a text node                 | Tier pinned both sides in the token contract; recipe AST (`decoration-on-text.contract.test.ts`) | implemented-blocking (recipes); broader AST follow-on                            |
-| Uppercase a dose unit                                                | `Quantity` pins `normal-case` + unit test                                                        | implemented-blocking (branch)                                                    |
-| Invert a PDF, diagram or clinical image in any theme                 | `DocumentFrame` refuses transforms; CSS check                                                    | planned                                                                          |
-| Border **and** ring on one surface, or a 1px spread in a drop shadow | Gate 8                                                                                           | implemented-partial                                                              |
-| A child shadow heavier than its parent's                             | Gate 7                                                                                           | implemented-partial                                                              |
-| Use `--shadow-tight`/any alias in new code                           | PR 9 recipe cleanup, then lint                                                                   | planned                                                                          |
-| Raw pixel size, padding, radius or line-height in markup             | Contract ratchet                                                                                 | implemented-partial (colour/shadow/tap literals only)                            |
-| Animate `width`, `height`, `grid-template-*`, `top`, `left`, `gap`   | Gate 9                                                                                           | planned                                                                          |
-| Hardcode a transition duration                                       | Gate 9                                                                                           | planned                                                                          |
-| A `z-` value outside the named rungs                                 | `require-z-index-ladder` (ESLint)                                                                | implemented-blocking                                                             |
-| Ship a registered component without a direct test                    | Gate 12                                                                                          | implemented-partial                                                              |
-| Lower a production tap target below 48px                             | Gate 2 + `ui-smoke` flake history + held visual probe                                            | implemented-blocking (token floor); per-surface geometry still held              |
-| Construct an enabled control with no action, destination or name     | PR 4 discriminated unions + DOM contracts; `require-button-wiring` covers raw `<button>`         | implemented-blocking (Citation/Chip/ToggleSwitch/RadioGroup)                     |
-| Render `AnswerCard` without a verification and answer state          | PR 6 required props (type-level)                                                                 | planned                                                                          |
-| Use a bare dash for a missing clinical value                         | `MissingValue` + review                                                                          | planned                                                                          |
-| Render "0 matches" after a failed request                            | `ErrorState` adoption + check                                                                    | planned                                                                          |
-| Hand-rolled rows replacing `AccessibleTable` without declaring it    | —                                                                                                | **manual** (declaration convention)                                              |
-| Drop the AI verification disclaimer                                  | PR 6 required prop                                                                               | planned                                                                          |
-| Fix a collapsed column by nudging pixels                             | 320px snapshot                                                                                   | planned (held harness)                                                           |
-| `dark:` colour override                                              | Lint                                                                                             | planned (3 live instances to burn down)                                          |
-| Truncate a page title, dialog title, drug name or review warning     | —                                                                                                | **manual**                                                                       |
-| Restate a token value in prose                                       | —                                                                                                | **manual** (eleven divergences came from this; TOKENS.md is the only inventory)  |
+| Never do this                                                        | Gate                                                                                             | Status                                                                                    |
+| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- |
+| Reintroduce `.ckb-v2:not(.dark)`                                     | Cascade computed-style test (PR 1) + contract-test selector filter update                        | implemented-blocking — landed #1538; contract parser + dark-ink regression guard          |
+| Add `prefers-color-scheme` rules to the v2 layer                     | — (users pin a theme against OS preference)                                                      | **manual**                                                                                |
+| Paint a numeral with a status colour; use amber/red decoratively     | Colour-boundary lint                                                                             | planned                                                                                   |
+| Put `--decoration-soft`/`--text-soft` on a text node                 | Tier pinned both sides in the token contract; recipe AST (`decoration-on-text.contract.test.ts`) | implemented-blocking (recipes); broader AST follow-on                                     |
+| Uppercase a dose unit                                                | `Quantity` pins `normal-case` + unit test                                                        | implemented-blocking (branch)                                                             |
+| Invert a PDF, diagram or clinical image in any theme                 | `DocumentFrame` refuses transforms; CSS check                                                    | planned                                                                                   |
+| Border **and** ring on one surface, or a 1px spread in a drop shadow | Gate 8                                                                                           | implemented-partial                                                                       |
+| A child shadow heavier than its parent's                             | Gate 7                                                                                           | implemented-partial                                                                       |
+| Use `--shadow-tight`/any alias in new code                           | PR 9 recipe cleanup, then lint                                                                   | planned                                                                                   |
+| Raw pixel size, padding, radius or line-height in markup             | Contract ratchet                                                                                 | implemented-partial (colour/shadow/tap literals only)                                     |
+| Animate `width`, `height`, `grid-template-*`, `top`, `left`, `gap`   | Gate 9                                                                                           | planned                                                                                   |
+| Hardcode a transition duration                                       | Gate 9                                                                                           | planned                                                                                   |
+| A `z-` value outside the named rungs                                 | `require-z-index-ladder` (ESLint)                                                                | implemented-blocking                                                                      |
+| Ship a registered component without a direct test                    | Gate 12                                                                                          | implemented-partial                                                                       |
+| Lower a production tap target below 48px                             | Gate 2 + `ui-smoke` flake history + held visual probe                                            | implemented-partial (token floor + declared carriers); interactive enumeration still open |
+| Construct an enabled control with no action, destination or name     | PR 4 discriminated unions + DOM contracts; `require-button-wiring` covers raw `<button>`         | implemented-blocking (Citation/Chip/ToggleSwitch/RadioGroup)                              |
+| Render `AnswerCard` without a verification and answer state          | PR 6 required props (type-level)                                                                 | planned                                                                                   |
+| Use a bare dash for a missing clinical value                         | `MissingValue` + review                                                                          | planned                                                                                   |
+| Render "0 matches" after a failed request                            | `ErrorState` adoption + check                                                                    | planned                                                                                   |
+| Hand-rolled rows replacing `AccessibleTable` without declaring it    | —                                                                                                | **manual** (declaration convention)                                                       |
+| Drop the AI verification disclaimer                                  | PR 6 required prop                                                                               | planned                                                                                   |
+| Fix a collapsed column by nudging pixels                             | 320px snapshot                                                                                   | planned (held harness)                                                                    |
+| `dark:` colour override                                              | Lint                                                                                             | planned (3 live instances to burn down)                                                   |
+| Truncate a page title, dialog title, drug name or review warning     | —                                                                                                | **manual**                                                                                |
+| Restate a token value in prose                                       | —                                                                                                | **manual** (eleven divergences came from this; TOKENS.md is the only inventory)           |
 
 ## 3a · Rules added by the perfection pass (31 July, second half)
 
diff --git a/docs/design-system/SPEC.md b/docs/design-system/SPEC.md
index 7ef3ad827..a5f968af2 100644
--- a/docs/design-system/SPEC.md
+++ b/docs/design-system/SPEC.md
@@ -305,10 +305,11 @@ literal `2.75rem`/`3rem` track desyncs from its child the next time the knob mov
 launcher search row is the case where that overlaps rather than merely tightening a gap.
 
 **The phone composer is the one sanctioned exception to the floor.** Below 431px the composer
-icon buttons stay 44px (`globals.css`, `max-width: 430px`): the phone composer is an
-edge-to-edge dock whose height is part of the search-chrome contract, and 4px per button
-re-tunes the dock reserve and the phone CLS budget for no accessibility gain — 44px already
-clears WCAG 2.5.5. Any further exception needs the same kind of written reason.
+input and icon/send buttons stay 44px (`globals.css`, `max-width: 430px`): the phone composer
+is an edge-to-edge dock whose height is part of the search-chrome contract, and 4px on the
+input plus buttons re-tunes the dock reserve and the phone CLS budget for no accessibility
+gain — 44px already clears WCAG 2.5.5. Any further exception needs the same kind of written
+reason.
 
 Three concepts stay separate: visible glyph size · visible control face · interactive hit
 target. Dense clinical UI keeps compact faces with padded or pseudo-element targets, and row
@@ -657,11 +658,11 @@ and adoption.** Status keys as in the header; "done" entries cite their commit.
 
 ### Phase 2 — values, split three ways
 
-| PR                                | Contents                                                                                              | Status                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| --------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| PR 5a · Token values, no geometry | Colour, elevation, ink roles                                                                          | **done** — `59e4c3dfc` landed the `--shadow-well` rename, the spine and status-mark families, and the dark `--clinical-chat-document` fix; the remaining ink-role deltas landed with PR 3 (`--text-placeholder`, eyebrows and placeholders off the decoration tier, the disabled encoding). The v2 light and dark blocks now declare the same colour roles, and the only raw colour literals left in `src/` are the two `#0f766e` accent defaults, which are **not** design tokens — see the note below |
-| PR 5b · Tap 44→48 in `@theme`     | The 407-site geometry change; contract-test pin update; visual QA pass; `--tap-min` becomes the alias | **done** — `--spacing-tap: 3rem` in `@theme`; `--tap-min` reduced to `var(--spacing-tap)`; 426 `*-tap` call sites moved; three pins flipped in the same commit; the phone composer keeps a written 44px exception below 431px (§4.10)                                                                                                                                                                                                                                                                   |
-| PR 5c · Radius step               | Every `rounded-md` moves; its own visual diff                                                         | **done** — live `@theme --radius-md` 8px → 10px, matching the v2 control rung and moving 243 `rounded-md` call sites; the 4px-grid pin now names both half-steps and asserts the two layers agree; 14 arbitrary radius literals absorbed onto the ladder (§4.6)                                                                                                                                                                                                                                         |
+| PR                                | Contents                                                                                                      | Status                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| PR 5a · Token values, no geometry | Colour, elevation, ink roles                                                                                  | **done** — `59e4c3dfc` landed the `--shadow-well` rename, the spine and status-mark families, and the dark `--clinical-chat-document` fix; the remaining ink-role deltas landed with PR 3 (`--text-placeholder`, eyebrows and placeholders off the decoration tier, the disabled encoding). The v2 light and dark blocks now declare the same colour roles, and the only raw colour literals left in `src/` are the two `#0f766e` accent defaults, which are **not** design tokens — see the note below |
+| PR 5b · Tap 44→48 in `@theme`     | The 426-site tap-call-site migration; contract-test pin update; visual QA pass; `--tap-min` becomes the alias | **done** — `--spacing-tap: 3rem` in `@theme`; `--tap-min` reduced to `var(--spacing-tap)`; 426 `*-tap` call sites moved; three pins flipped in the same commit; the phone composer keeps a written 44px exception below 431px (§4.10)                                                                                                                                                                                                                                                                   |
+| PR 5c · Radius step               | Every `rounded-md` moves; its own visual diff                                                                 | **done** — live `@theme --radius-md` 8px → 10px, matching the v2 control rung and moving 243 `rounded-md` call sites; the 4px-grid pin now names both half-steps and asserts the two layers agree; 14 arbitrary radius literals absorbed onto the ladder (§4.6)                                                                                                                                                                                                                                         |
 
 **`#0f766e` is data, not a token.** The two remaining raw colour literals
 (`src/lib/medications.ts`, `src/lib/medication-records.ts`) restate a Postgres column
diff --git a/src/app/globals.css b/src/app/globals.css
index c8309a505..c41fbd40b 100644
--- a/src/app/globals.css
+++ b/src/app/globals.css
@@ -55,7 +55,8 @@
      a tap target uses var(--spacing-tap), never a copy of the number, or the
      track and its child desync the next time this value moves. The one
      deliberate exception is the phone composer, pinned to 44px below 431px so
-     the edge-to-edge dock keeps its height (see the max-width: 430px block). */
+     the edge-to-edge dock keeps its height (see the max-width: 430px block,
+     which covers the composer input as well as the icon/send buttons). */
   --spacing-tap: 3rem;
 
   /* Icon glyph size scale. Named spacing tokens so icon sizing is a documented
@@ -1437,16 +1438,22 @@ summary::-webkit-details-marker {
   opacity: 0.5;
 }
 
-/* Small-phone pin for the composer icon buttons: hold a 44px tap target and a
-   1.1rem glyph below 431px, where the base rule above would otherwise apply the
-   48px --spacing-tap knob. This is the design system's one sanctioned exception
-   to the 48px floor (SPEC §4.10): the phone composer is an edge-to-edge dock
-   whose height is part of the search-chrome contract, and growing three buttons
-   by 4px each re-tunes the dock reserve and the phone CLS budget for no
-   accessibility gain — 44px already clears WCAG 2.5.5. Single source of truth —
-   do not re-add a second max-width:430px block for these. The mode-action
-   popover only renders ≥1024px, so this holds no .mode-action-* overrides. */
+/* Small-phone pin for the composer: hold a 44px tap target (and a 1.1rem glyph
+   on the icon/send buttons) below 431px, where the base rules above would
+   otherwise apply the 48px --spacing-tap knob to the input and the buttons.
+   This is the design system's one sanctioned exception to the 48px floor
+   (SPEC §4.10): the phone composer is an edge-to-edge dock whose height is
+   part of the search-chrome contract, and growing the input plus three
+   buttons by 4px each re-tunes the dock reserve and the phone CLS budget for
+   no accessibility gain — 44px already clears WCAG 2.5.5. Single source of
+   truth — do not re-add a second max-width:430px block for these. The
+   mode-action popover only renders ≥1024px, so this holds no .mode-action-*
+   overrides. */
 @media (max-width: 430px) {
+  .chat-composer-input {
+    min-height: 2.75rem;
+  }
+
   .chat-composer-icon-button,
   .chat-send-button {
     height: 2.75rem !important;
diff --git a/src/components/applications-launcher-page.tsx b/src/components/applications-launcher-page.tsx
index 1526c4ea0..0c301a4eb 100644
--- a/src/components/applications-launcher-page.tsx
+++ b/src/components/applications-launcher-page.tsx
@@ -245,10 +245,11 @@ function ToolSearch({
         onSubmit();
       }}
       className={cn(
-        // The leading track holds a tap-sized glyph and the row has no gap, so it
-        // reads the tap knob rather than a copy of its value — a literal here
-        // overlaps the input the moment `--spacing-tap` moves.
-        "grid min-h-13 grid-cols-[var(--spacing-tap)_minmax(0,1fr)_2.75rem] items-center rounded-full border border-[color:var(--border)] bg-[color:var(--surface-lux)] text-left shadow-[var(--shadow-card)]",
+        // Both end tracks hold tap-sized children and the row has no gap, so they
+        // read the tap knob rather than a copy of its value — a literal here
+        // overlaps the input (or undersizes the submit control) the moment
+        // `--spacing-tap` moves.
+        "grid min-h-13 grid-cols-[var(--spacing-tap)_minmax(0,1fr)_var(--spacing-tap)] items-center rounded-full border border-[color:var(--border)] bg-[color:var(--surface-lux)] text-left shadow-[var(--shadow-card)]",
         className,
       )}
     >
@@ -268,8 +269,9 @@ function ToolSearch({
       <button
         type="submit"
         aria-label={copy.openSelectedAriaLabel}
+        data-testid="tools-local-search-submit"
         className={cn(
-          "mr-1 grid h-10 w-10 place-items-center rounded-full bg-[color:var(--clinical-accent)] text-[color:var(--clinical-accent-contrast)] shadow-[var(--shadow-tight)] transition hover:bg-[color:var(--clinical-accent-hover)]",
+          "grid h-tap w-tap place-items-center rounded-full bg-[color:var(--clinical-accent)] text-[color:var(--clinical-accent-contrast)] shadow-[var(--shadow-tight)] transition hover:bg-[color:var(--clinical-accent-hover)]",
           focusRing,
         )}
       >
diff --git a/src/components/clinical-dashboard/account-setup-dialog.tsx b/src/components/clinical-dashboard/account-setup-dialog.tsx
index b470ea151..500be601e 100644
--- a/src/components/clinical-dashboard/account-setup-dialog.tsx
+++ b/src/components/clinical-dashboard/account-setup-dialog.tsx
@@ -121,7 +121,7 @@ export function AccountSetupDialog({
           onClick={onClose}
           className={cn(
             toolbarButton,
-            "absolute right-3 top-3 z-10 h-10 w-10 border-transparent bg-transparent shadow-none hover:bg-[color:var(--surface-subtle)] sm:right-4 sm:top-4",
+            "absolute right-3 top-3 z-10 border-transparent bg-transparent shadow-none hover:bg-[color:var(--surface-subtle)] sm:right-4 sm:top-4",
           )}
           aria-label="Close account setup"
         >
diff --git a/tests/mobile-interaction-regressions.test.ts b/tests/mobile-interaction-regressions.test.ts
index 5ede56748..2f57af9fa 100644
--- a/tests/mobile-interaction-regressions.test.ts
+++ b/tests/mobile-interaction-regressions.test.ts
@@ -102,6 +102,12 @@ describe("mobile interaction regressions", () => {
     expect(tools).not.toContain("hasMenu");
     expect(tools).toContain('label: "Saved", desktopLabel: "Favourites"');
     expect(tools).toMatch(/effectiveFilter === "more"\s*\?\s*app\.area === "coordination" \|\| app\.area === "saved"/);
+    // Tools local search submit is an interactive control: both end tracks and
+    // the submit face must read the tap knob (not a leftover h-10 / 2.75rem).
+    expect(tools).toContain("grid-cols-[var(--spacing-tap)_minmax(0,1fr)_var(--spacing-tap)]");
+    expect(tools).toMatch(
+      /data-testid="tools-local-search-submit"[\s\S]{0,120}?className=\{cn\(\s*"grid h-tap w-tap place-items-center/,
+    );
 
     expect(header).toContain('router.push("/dsm/compare")');
     expect(header).toContain('router.push("/specifiers/builder")');
diff --git a/tests/ui-overlay-css-contract.test.ts b/tests/ui-overlay-css-contract.test.ts
index f48c433ac..b57633c11 100644
--- a/tests/ui-overlay-css-contract.test.ts
+++ b/tests/ui-overlay-css-contract.test.ts
@@ -74,7 +74,7 @@ describe("overlay and global CSS contracts", () => {
   it("keeps one authoritative 430px composer-action sizing block", () => {
     expect(occurrenceCount(globalStylesSource, "@media (max-width: 430px)")).toBe(1);
     expect(globalStylesSource).toMatch(
-      /@media \(max-width: 430px\) \{[\s\S]*?\.chat-composer-icon-button,[\s\S]*?min-height: 2\.75rem;[\s\S]*?\.chat-composer-icon-button svg,[\s\S]*?height: 1\.1rem;/,
+      /@media \(max-width: 430px\) \{[\s\S]*?\.chat-composer-input \{[\s\S]*?min-height: 2\.75rem;[\s\S]*?\.chat-composer-icon-button,[\s\S]*?min-height: 2\.75rem;[\s\S]*?\.chat-composer-icon-button svg,[\s\S]*?height: 1\.1rem;/,
     );
   });
 
diff --git a/tests/ui-smoke.spec.ts b/tests/ui-smoke.spec.ts
index f994cc641..32d0bbead 100644
--- a/tests/ui-smoke.spec.ts
+++ b/tests/ui-smoke.spec.ts
@@ -2106,7 +2106,10 @@ test.describe("Clinical KB UI smoke coverage", () => {
     // Content-sized section => no unexplained phantom scroll. Submitted universal
     // matches are real content below the answer, so their compact panel may account
     // for the overflow; the old viewport floor created much more empty scroll.
-    const permittedOverflow = geo.alsoMatchesHeight > 0 ? geo.alsoMatchesHeight + 24 : 4;
+    // After the 48px tap / 10px control-radius step, bare short answers still fit
+    // with only a couple of pixels of layout slack — keep the empty-state budget
+    // tight, but allow a small sub-pixel band so radius/tap rounding cannot flake.
+    const permittedOverflow = geo.alsoMatchesHeight > 0 ? geo.alsoMatchesHeight + 24 : 8;
     expect(scrollGeometry.owner).toBe("document");
     expect(scrollGeometry.maxScrollTop).toBeLessThanOrEqual(permittedOverflow);
     // Top-aligned: the answer sits just under the header, not pushed toward the dock
@@ -2271,15 +2274,18 @@ test.describe("Clinical KB UI smoke coverage", () => {
       postCollapseMaxOffset: Math.max(0, scrollGeometry.maxScrollTop - collapseBudget),
     };
     expect(scrollGeometry.owner).toBe("document");
-    // Pin the unmodified short-result geometry. Its 39px post-collapse range
-    // clears top-reveal + hide-intent distance (32px), but not the 72px in-flow
-    // activation band; synthetic tail content would hide this distinction.
+    // Pin the unmodified short-result geometry after the 48px tap step. The
+    // post-collapse range must still clear top-reveal + hide-intent distance
+    // (32px) and stay below the 72px in-flow activation band; synthetic tail
+    // content would hide this distinction. The prior 44px-era ~39px pin moved
+    // up with taller answer controls, so the upper bound tracks that band
+    // rather than the old 48px ceiling.
     expect(geometry.maxOffset).toBeGreaterThan(140);
-    expect(geometry.maxOffset).toBeLessThan(180);
+    expect(geometry.maxOffset).toBeLessThan(200);
     expect(geometry.collapseBudget).toBeGreaterThan(112);
     expect(geometry.collapseBudget).toBeLessThan(128);
     expect(geometry.postCollapseMaxOffset).toBeGreaterThanOrEqual(32);
-    expect(geometry.postCollapseMaxOffset).toBeLessThan(48);
+    expect(geometry.postCollapseMaxOffset).toBeLessThan(72);
     // A jump straight onto the bottom edge (PageDown / full-page flick) lands
     // past the post-collapse range; hiding there would clamp content under the
     // finger, so the near-bottom guard keeps both chrome edges visible.
@@ -2289,8 +2295,8 @@ test.describe("Clinical KB UI smoke coverage", () => {
     await scrollPrimarySurface(page, 0);
     // Deliberate downward travel that still fits the post-collapse range is
     // the designed hide path: past the 8px top band plus 24px intent, at or
-    // below the ~39px post-collapse maximum (floored so fractional layout
-    // readings can never overshoot the hook's own near-bottom tolerance).
+    // below the post-collapse maximum (floored so fractional layout readings
+    // can never overshoot the hook's own near-bottom tolerance).
     await scrollPrimarySurface(page, Math.floor(geometry.postCollapseMaxOffset));
     await expect(header).toHaveAttribute("data-scroll-hidden", "true");
     await expect(dock).toHaveAttribute("data-scroll-hidden", "true");

From 28992adda44969c02e957efaeff0d655f226340d Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sun, 2 Aug 2026 04:56:13 +0000
Subject: [PATCH 6/6] DS V2 PR-V: clarify gate 2 partial scope and bound phone
 CSS pin

Revise the Gate 2 objective/evidence so fixed h-10 controls and the
unwired Chromium audit are explicitly not claimed as blocked, and
scope the 430px composer contract assertion to the extracted media
block.

Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
---
 docs/branch-review-ledger.md          |  2 +
 docs/design-system/GATES.md           | 82 +++++++++++++--------------
 tests/ui-overlay-css-contract.test.ts |  7 ++-
 3 files changed, 48 insertions(+), 43 deletions(-)

diff --git a/docs/branch-review-ledger.md b/docs/branch-review-ledger.md
index 498e21ac3..7bd29b4a0 100644
--- a/docs/branch-review-ledger.md
+++ b/docs/branch-review-ledger.md
@@ -586,3 +586,5 @@ Records before 2026-07-28 were written by hand and had drifted: 146 lines carrie
 | 2026-08-01 | claude/ds-v2-tooling-loop (PR #1568) | b76bcc9fbc39f2f986a52869c810ba3cb89994f2 | PR #1568 review-thread resolve | fixed and resolved all 13 review threads (fail-closed project identity, inventory exit code, provenance demo id, buildCmd execution, chrome pin, context7 rollback); ledger row for superseded 93d41c1 dispositioned | node --check scripts; design-sync --dry-run; no provider-backed checks |
 | 2026-08-01 | claude/ds-v2-correctness | 1aa9822978668a10447ef3246bd60cda6f1208cb | ds-v2 PR-A correctness (HCM/contrast/prop-unions) | ready-to-merge | unit 4878p; verify:ui 344p; style-contract HCM 5p; verify:pr-local green (eval:rag:offline 574/574; fixture 36/23); typecheck+ds-contract green |
 | 2026-08-02 | claude/ds-v2-values | d33721b436c05014e8ef1f362a945fe9574e676e | DS V2 PR-V values | Wave 2 self-verified before push: 5a close-out (no value deltas remain after decision J2; contract metrics unchanged at rawColorLiterals 2 / literalShadowClasses 0 / legacyTapClasses 0), 5b tap knob 2.75rem to 3rem in @theme with --tap-min reduced to var(--spacing-tap) across 426 *-tap sites and three pins flipped in-commit, 5c --radius-md 8px to 10px across 243 rounded-md sites with the 4px-grid pin naming both half-steps and 14 arbitrary radius literals absorbed. Two carve-outs recorded in SPEC 4.10/4.6: the phone composer stays 44px below 431px, and the 2px mode-nav hairline stays off the ladder. An offline.html tap bump was reverted before push because it would have forced a service-worker CACHE_VERSION bump. Known-red local gate: tests/ui-smoke.spec.ts:2221 phone runway pin fails on unmodified origin/main here too (maxOffset 99 at base vs 111 at this head, reproduced in a pristine capture worktree) while CI run 30720360137 is green on the same tree - plan finding L, CI binding. | typecheck exit 0; verify:pr-local PASS with 4880 passed 3 skipped (4883) in 471 files, production build compiled, client-bundle secret scan passed, eval:rag:offline fixture line plus 574/574 (better than the J4 known-red baseline); verify:ui 346 passed 1 failed (the known-red phone runway pin); verify:phone-chrome --full=never contracts 116/116 and ui-tools 87/87 with the same single known-red test; test:e2e:critical 15/15; design-system contract, branch-review-ledger, outstanding-issues, sitemap, docs link/index/inventory/scripts all exit 0 |
+| 2026-08-02 | claude/ds-v2-values | 48012d359b84daae347201697c82f3e433c182c5 | PR #1571 review-and-fix (ds-v2-values tap/radius) | fixed: Tools submit + account-setup close onto h-tap; phone composer input 44px pin; gate 2 demoted to implemented-partial; SPEC 407→426; short-runway/short-answer smoke pins retuned; verify:cheap + verify:pr-local + 2 smoke tests green; CI Production UI in progress | verify:cheap 471/4879; verify:pr-local build+fixtures; test:e2e 2 phone smoke passed; design-system-contract raw 2/0/0 |
+| 2026-08-02 | claude/ds-v2-values | d2a29198415292a28ed1dbf1c740c94f6c12ddb3 | PR #1571 review-and-fix (ds-v2-values tap/radius) | fixed+clarified: gate2 objective acknowledges h-10/unwired audit not blocked; overlay 430px assertion scoped to media block; prior tip 48012d35 Production UI+PR required green | verify:cheap; verify:pr-local; 2 smoke; UI overlay contract; CI Production UI (1)(2)(3)+PR required SUCCESS on 48012d35 |
diff --git a/docs/design-system/GATES.md b/docs/design-system/GATES.md
index 5833699ab..71202d2f1 100644
--- a/docs/design-system/GATES.md
+++ b/docs/design-system/GATES.md
@@ -37,20 +37,20 @@ those rules as gates.
 
 ## 2 · The twelve system gates, labelled
 
-| #   | Gate                                                                                                                                          | Status                   | Evidence / path to blocking                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
-| --- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 1   | Contrast ≥4.5:1 for every text/background pair, both themes, live **and** v2; `--decoration-soft` asserted below 4.5 and never on a text node | **implemented-blocking** | v2 pairs + `--text-placeholder` + `--decoration-soft` tier + recipe AST (`decoration-on-text.contract.test.ts`); live full matrix remains follow-on.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| 2   | Tap targets ≥48px interactive; static pills never carry `min-h-tap`; no production target reduced                                             | **implemented-partial**  | `--spacing-tap` is 48px and pinned from both sides: `ckb-v2-token-contract` asserts the `@theme` knob is ≥48 and that `--tap-min` is its alias, `ui-style-contract` measures the rendered floor for declared `min-height` carriers in Chromium, and the legacy-class and literal ratchets still run. Residual gap before blocking: the Chromium audit skips elements whose declared height is below the floor (so a fixed `h-10` control would not fail it), and full interactive enumeration with an explicit exception list is still open. Written carve-outs: the phone composer below 431px (SPEC §4.10) and per-surface geometry in the held visual harness. |
-| 3   | Focus outline present, `--focus`, no companion ring                                                                                           | **planned**              | `--focus` is referenced nowhere in the DS export (finding N3). Global fix first, then the check.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| 4   | Non-colour encoding on every status indicator                                                                                                 | **manual → planned**     | `MissingValue`/`DoseLine` text marks arrive in PR 6; contract test follows.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
-| 5   | Tables: semantic caption, associated headers, `aria-controls` on the expander                                                                 | **implemented-partial**  | Expander and alignment tested; semantic-caption rule fails today (div caption, optional).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| 6   | Enum resilience — neutral fallback, never throws                                                                                              | **implemented-blocking** | `source-badges-off-vocab.dom.test.tsx`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| 7   | Elevation monotonicity — no child heavier than its parent                                                                                     | **implemented-partial**  | Token-ramp monotonicity is tested; the per-surface child/parent rule is planned (needs a render-tree check).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| 8   | Edge ownership — no `border-*` + `ring-*` on one surface; no 1px spread in a drop shadow                                                      | **implemented-partial**  | Ladder is tested spread-free; the per-surface co-occurrence lint and spread-term check are planned (PR 9). The spread form was chosen _because_ it is mechanically lintable.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| 9   | No layout-property animation; no hardcoded durations                                                                                          | **planned**              | PR 9 wires `--duration-*`/`--ease-*` and adds the lint; ten known layout-animation sites are the seed list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
-| 10  | Named z and motion tokens have real consumers; no unapproved `z-` value                                                                       | **implemented-partial**  | `require-z-index-ladder` lints z discipline; motion-token consumption is planned (one consumer today against 25 hardcoded durations).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| 11  | Published-type conformance — every `dtsPropsFor` entry assignable from source props                                                           | **planned**              | PR 12 generates declarations from real types; known drift: `confirmPhraseLabel`, Sheet omissions, narrowed callbacks.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| 12  | Component coverage — every registered component has a direct behavioural test                                                                 | **implemented-partial**  | Tested subset in COMPONENTS §0; registry-wide requirement lands with PR 12.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| #   | Gate                                                                                                                                                                                                               | Status                   | Evidence / path to blocking                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| 1   | Contrast ≥4.5:1 for every text/background pair, both themes, live **and** v2; `--decoration-soft` asserted below 4.5 and never on a text node                                                                      | **implemented-blocking** | v2 pairs + `--text-placeholder` + `--decoration-soft` tier + recipe AST (`decoration-on-text.contract.test.ts`); live full matrix remains follow-on.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| 2   | Tap targets ≥48px interactive (token + declared carriers today; fixed-height `h-10` controls and full interactive enumeration not yet blocked); static pills never carry `min-h-tap`; no production target reduced | **implemented-partial**  | Enforced today: `--spacing-tap` is 48px and pinned from both sides (`ckb-v2-token-contract` asserts the `@theme` knob is ≥48 and that `--tap-min` is its alias), `ui-style-contract` measures the rendered floor for declared `min-height` carriers in Chromium, and the legacy-class / literal ratchets still run. **Not blocked today:** the Chromium audit skips elements whose declared height is below the floor (a fixed `h-10` control would not fail it), and `test:e2e:style-contract` is not part of `verify:cheap`. Path to blocking: enumerate rendered interactive elements with an explicit exception list (phone composer below 431px is already written — SPEC §4.10), then wire that audit into required CI. Per-surface geometry stays in the held visual harness. |
+| 3   | Focus outline present, `--focus`, no companion ring                                                                                                                                                                | **planned**              | `--focus` is referenced nowhere in the DS export (finding N3). Global fix first, then the check.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| 4   | Non-colour encoding on every status indicator                                                                                                                                                                      | **manual → planned**     | `MissingValue`/`DoseLine` text marks arrive in PR 6; contract test follows.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| 5   | Tables: semantic caption, associated headers, `aria-controls` on the expander                                                                                                                                      | **implemented-partial**  | Expander and alignment tested; semantic-caption rule fails today (div caption, optional).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| 6   | Enum resilience — neutral fallback, never throws                                                                                                                                                                   | **implemented-blocking** | `source-badges-off-vocab.dom.test.tsx`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| 7   | Elevation monotonicity — no child heavier than its parent                                                                                                                                                          | **implemented-partial**  | Token-ramp monotonicity is tested; the per-surface child/parent rule is planned (needs a render-tree check).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| 8   | Edge ownership — no `border-*` + `ring-*` on one surface; no 1px spread in a drop shadow                                                                                                                           | **implemented-partial**  | Ladder is tested spread-free; the per-surface co-occurrence lint and spread-term check are planned (PR 9). The spread form was chosen _because_ it is mechanically lintable.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| 9   | No layout-property animation; no hardcoded durations                                                                                                                                                               | **planned**              | PR 9 wires `--duration-*`/`--ease-*` and adds the lint; ten known layout-animation sites are the seed list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| 10  | Named z and motion tokens have real consumers; no unapproved `z-` value                                                                                                                                            | **implemented-partial**  | `require-z-index-ladder` lints z discipline; motion-token consumption is planned (one consumer today against 25 hardcoded durations).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| 11  | Published-type conformance — every `dtsPropsFor` entry assignable from source props                                                                                                                                | **planned**              | PR 12 generates declarations from real types; known drift: `confirmPhraseLabel`, Sheet omissions, narrowed callbacks.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| 12  | Component coverage — every registered component has a direct behavioural test                                                                                                                                      | **implemented-partial**  | Tested subset in COMPONENTS §0; registry-wide requirement lands with PR 12.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 
 **Computed-style suites (planned, PR 1–2):** Tailwind conflict order · v2 cascade, ancestor
 **and** same-node forms · HCM remapping under all three v2 selectors · z-index · target
@@ -68,33 +68,33 @@ as design tokens · export/preview parity.
 
 ## 3 · The prohibition table
 
-| Never do this                                                        | Gate                                                                                             | Status                                                                                    |
-| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- |
-| Reintroduce `.ckb-v2:not(.dark)`                                     | Cascade computed-style test (PR 1) + contract-test selector filter update                        | implemented-blocking — landed #1538; contract parser + dark-ink regression guard          |
-| Add `prefers-color-scheme` rules to the v2 layer                     | — (users pin a theme against OS preference)                                                      | **manual**                                                                                |
-| Paint a numeral with a status colour; use amber/red decoratively     | Colour-boundary lint                                                                             | planned                                                                                   |
-| Put `--decoration-soft`/`--text-soft` on a text node                 | Tier pinned both sides in the token contract; recipe AST (`decoration-on-text.contract.test.ts`) | implemented-blocking (recipes); broader AST follow-on                                     |
-| Uppercase a dose unit                                                | `Quantity` pins `normal-case` + unit test                                                        | implemented-blocking (branch)                                                             |
-| Invert a PDF, diagram or clinical image in any theme                 | `DocumentFrame` refuses transforms; CSS check                                                    | planned                                                                                   |
-| Border **and** ring on one surface, or a 1px spread in a drop shadow | Gate 8                                                                                           | implemented-partial                                                                       |
-| A child shadow heavier than its parent's                             | Gate 7                                                                                           | implemented-partial                                                                       |
-| Use `--shadow-tight`/any alias in new code                           | PR 9 recipe cleanup, then lint                                                                   | planned                                                                                   |
-| Raw pixel size, padding, radius or line-height in markup             | Contract ratchet                                                                                 | implemented-partial (colour/shadow/tap literals only)                                     |
-| Animate `width`, `height`, `grid-template-*`, `top`, `left`, `gap`   | Gate 9                                                                                           | planned                                                                                   |
-| Hardcode a transition duration                                       | Gate 9                                                                                           | planned                                                                                   |
-| A `z-` value outside the named rungs                                 | `require-z-index-ladder` (ESLint)                                                                | implemented-blocking                                                                      |
-| Ship a registered component without a direct test                    | Gate 12                                                                                          | implemented-partial                                                                       |
-| Lower a production tap target below 48px                             | Gate 2 + `ui-smoke` flake history + held visual probe                                            | implemented-partial (token floor + declared carriers); interactive enumeration still open |
-| Construct an enabled control with no action, destination or name     | PR 4 discriminated unions + DOM contracts; `require-button-wiring` covers raw `<button>`         | implemented-blocking (Citation/Chip/ToggleSwitch/RadioGroup)                              |
-| Render `AnswerCard` without a verification and answer state          | PR 6 required props (type-level)                                                                 | planned                                                                                   |
-| Use a bare dash for a missing clinical value                         | `MissingValue` + review                                                                          | planned                                                                                   |
-| Render "0 matches" after a failed request                            | `ErrorState` adoption + check                                                                    | planned                                                                                   |
-| Hand-rolled rows replacing `AccessibleTable` without declaring it    | —                                                                                                | **manual** (declaration convention)                                                       |
-| Drop the AI verification disclaimer                                  | PR 6 required prop                                                                               | planned                                                                                   |
-| Fix a collapsed column by nudging pixels                             | 320px snapshot                                                                                   | planned (held harness)                                                                    |
-| `dark:` colour override                                              | Lint                                                                                             | planned (3 live instances to burn down)                                                   |
-| Truncate a page title, dialog title, drug name or review warning     | —                                                                                                | **manual**                                                                                |
-| Restate a token value in prose                                       | —                                                                                                | **manual** (eleven divergences came from this; TOKENS.md is the only inventory)           |
+| Never do this                                                        | Gate                                                                                             | Status                                                                                                                                       |
+| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| Reintroduce `.ckb-v2:not(.dark)`                                     | Cascade computed-style test (PR 1) + contract-test selector filter update                        | implemented-blocking — landed #1538; contract parser + dark-ink regression guard                                                             |
+| Add `prefers-color-scheme` rules to the v2 layer                     | — (users pin a theme against OS preference)                                                      | **manual**                                                                                                                                   |
+| Paint a numeral with a status colour; use amber/red decoratively     | Colour-boundary lint                                                                             | planned                                                                                                                                      |
+| Put `--decoration-soft`/`--text-soft` on a text node                 | Tier pinned both sides in the token contract; recipe AST (`decoration-on-text.contract.test.ts`) | implemented-blocking (recipes); broader AST follow-on                                                                                        |
+| Uppercase a dose unit                                                | `Quantity` pins `normal-case` + unit test                                                        | implemented-blocking (branch)                                                                                                                |
+| Invert a PDF, diagram or clinical image in any theme                 | `DocumentFrame` refuses transforms; CSS check                                                    | planned                                                                                                                                      |
+| Border **and** ring on one surface, or a 1px spread in a drop shadow | Gate 8                                                                                           | implemented-partial                                                                                                                          |
+| A child shadow heavier than its parent's                             | Gate 7                                                                                           | implemented-partial                                                                                                                          |
+| Use `--shadow-tight`/any alias in new code                           | PR 9 recipe cleanup, then lint                                                                   | planned                                                                                                                                      |
+| Raw pixel size, padding, radius or line-height in markup             | Contract ratchet                                                                                 | implemented-partial (colour/shadow/tap literals only)                                                                                        |
+| Animate `width`, `height`, `grid-template-*`, `top`, `left`, `gap`   | Gate 9                                                                                           | planned                                                                                                                                      |
+| Hardcode a transition duration                                       | Gate 9                                                                                           | planned                                                                                                                                      |
+| A `z-` value outside the named rungs                                 | `require-z-index-ladder` (ESLint)                                                                | implemented-blocking                                                                                                                         |
+| Ship a registered component without a direct test                    | Gate 12                                                                                          | implemented-partial                                                                                                                          |
+| Lower a production tap target below 48px                             | Gate 2 + `ui-smoke` flake history + held visual probe                                            | implemented-partial — token floor + declared carriers only; fixed `h-10` interactive controls and the unwired Chromium audit are not blocked |
+| Construct an enabled control with no action, destination or name     | PR 4 discriminated unions + DOM contracts; `require-button-wiring` covers raw `<button>`         | implemented-blocking (Citation/Chip/ToggleSwitch/RadioGroup)                                                                                 |
+| Render `AnswerCard` without a verification and answer state          | PR 6 required props (type-level)                                                                 | planned                                                                                                                                      |
+| Use a bare dash for a missing clinical value                         | `MissingValue` + review                                                                          | planned                                                                                                                                      |
+| Render "0 matches" after a failed request                            | `ErrorState` adoption + check                                                                    | planned                                                                                                                                      |
+| Hand-rolled rows replacing `AccessibleTable` without declaring it    | —                                                                                                | **manual** (declaration convention)                                                                                                          |
+| Drop the AI verification disclaimer                                  | PR 6 required prop                                                                               | planned                                                                                                                                      |
+| Fix a collapsed column by nudging pixels                             | 320px snapshot                                                                                   | planned (held harness)                                                                                                                       |
+| `dark:` colour override                                              | Lint                                                                                             | planned (3 live instances to burn down)                                                                                                      |
+| Truncate a page title, dialog title, drug name or review warning     | —                                                                                                | **manual**                                                                                                                                   |
+| Restate a token value in prose                                       | —                                                                                                | **manual** (eleven divergences came from this; TOKENS.md is the only inventory)                                                              |
 
 ## 3a · Rules added by the perfection pass (31 July, second half)
 
diff --git a/tests/ui-overlay-css-contract.test.ts b/tests/ui-overlay-css-contract.test.ts
index b57633c11..d88c1dfeb 100644
--- a/tests/ui-overlay-css-contract.test.ts
+++ b/tests/ui-overlay-css-contract.test.ts
@@ -73,9 +73,12 @@ describe("overlay and global CSS contracts", () => {
 
   it("keeps one authoritative 430px composer-action sizing block", () => {
     expect(occurrenceCount(globalStylesSource, "@media (max-width: 430px)")).toBe(1);
-    expect(globalStylesSource).toMatch(
-      /@media \(max-width: 430px\) \{[\s\S]*?\.chat-composer-input \{[\s\S]*?min-height: 2\.75rem;[\s\S]*?\.chat-composer-icon-button,[\s\S]*?min-height: 2\.75rem;[\s\S]*?\.chat-composer-icon-button svg,[\s\S]*?height: 1\.1rem;/,
+    const phoneComposerBlock = cssBlock(globalStylesSource, "@media (max-width: 430px)");
+    expect(phoneComposerBlock).toMatch(/\.chat-composer-input\s*\{[\s\S]*?min-height:\s*2\.75rem;/);
+    expect(phoneComposerBlock).toMatch(
+      /\.chat-composer-icon-button,[\s\S]*?\.chat-send-button\s*\{[\s\S]*?min-height:\s*2\.75rem;/,
     );
+    expect(phoneComposerBlock).toMatch(/\.chat-composer-icon-button svg,[\s\S]*?height:\s*1\.1rem;/);
   });
 
   it("lets contextual composer surfaces own their resting and focus border colors", () => {