Pay down group-2 visual debt without raising design-system ratchets

data/repo-awareness-snapshot.json

@@ -1,8 +1,8 @@
 {
  "version": "repo-awareness-snapshot-v1",
  "captured_revision": {
- "sha": "9b26a3d69b447c5fa3d45b4e011b26ba46c32b69",
- "committed_at": "2026-08-27T12:01:45+00:00"
+ "sha": "6b2d6f421ee2b2e33f4ccf4fa1d31581b452d4b4",
+ "committed_at": "2026-08-27T12:18:53+00:00"
  },
  "routes": {
  "modes": [
@@ -2389,7 +2389,7 @@
  {
  "path": "docs/design-system/FIX-GUIDE.md",
  "section": "design-system",
- "catalogued": false
+ "catalogued": true
  },
  {
  "path": "docs/design-system/GATES.md",
@@ -3873,8 +3873,8 @@
  ],
  "counts": {
  "documents": 481,
- "catalogued": 106,
- "uncatalogued": 375,
+ "catalogued": 107,
+ "uncatalogued": 374,
  "sections": 19
  }
  },

docs/README.md

@@ -36,6 +36,7 @@ npm run docs:check-links
 - [design-system/COMPONENTS.md](design-system/COMPONENTS.md) — the eight safety-component specifications plus the maturity matrix
 - [design-system/DECISIONS.md](design-system/DECISIONS.md) — conflicts C1–C5 resolved, clinical Q&A record, assumptions, blocked items
 - [design-system/GATES.md](design-system/GATES.md) — every design-system rule paired with its enforcement status
+- [design-system/FIX-GUIDE.md](design-system/FIX-GUIDE.md) — Hazard 1–2 sweep dispositions (Fixed / Documented / Deferred / Out-of-scope)
 - [design-system/ADOPTION.md](design-system/ADOPTION.md) — PR 13 registration record: adoption order, per-surface file allowlists, exclusions, pins, proof shots
 - [comparison-behaviour.md](comparison-behaviour.md) — shared selection, state, responsive, and accessibility contract for comparison surfaces
 - [clinical-chat-ui-component-map.md](clinical-chat-ui-component-map.md) — chat UI component inventory

docs/design-system/COMPONENTS.md

@@ -39,14 +39,21 @@ _Remaining from the original eight in this document:_ `DocumentFrame` is built l
 (`src/components/ui/document-frame.tsx`, shell-only in `DocumentViewer`) but is not yet among
 the 55 design-sync registered visual exports — registration and full controls remain follow-up.
 
+`AppliedFilters` (`src/components/ui/applied-filters.tsx`) and `CopyButton`
+(`src/components/ui/copy-button.tsx`) are built, proof-migrated (CatalogueToolbar chip row
+and answer-status copy control), and covered by DOM tests. They are **not** design-sync
+registered — do not count them toward the 55 visual exports, and do not treat them as
+specified-not-built. Registration remains follow-up (the Chip/Button add path is a 55-row
+cascade).
+
 `OverlayRoot`, `SegmentedControl`, and the PR 6–8 components are built and represented by the
 local publication contract. The generated snapshot records their current product-import counts;
 registration still proves only a source/API/preview/test reference and does not prove remote
 design-project publication or browser acceptance.
 
 _P1 reusable (specified in outline only):_ `Menu`/`Popover` · `KeyValue` ·
-`AppliedFilters`/`FilterSheet` · `ResponsiveActionGroup` · `ScrollableStrip`/
-`ScrollAffordance` · `SourceLink` · `Banner` · `CopyButton`/`CopyField` ·
+`FilterSheet` · `ResponsiveActionGroup` · `ScrollableStrip`/
+`ScrollAffordance` · `SourceLink` · `Banner` · `CopyField` ·
 state family (`ErrorState`, `OfflineState`, `PermissionDeniedState`, `NotFoundState`,
 `UnavailableState`).
 
@@ -976,9 +983,9 @@ This generated snapshot is a local source-derived inventory. It does not assert
 | `AnswerFooter` | answer | yes | yes | inherited-global-root | yes | no | 1 |
 | `AsyncButton` | controls | yes | yes | inherited-global-root | yes | no | 4 |
 | `Breadcrumb` | layout | yes | yes | inherited-global-root | yes | no | 1 |
-| `Button` | controls | yes | yes | inherited-global-root | yes | no | 19 |
+| `Button` | controls | yes | yes | inherited-global-root | yes | no | 21 |
 | `Checkbox` | controls | yes | yes | no | yes | no | 0 |
-| `Chip` | controls | yes | yes | inherited-global-root | yes | no | 5 |
+| `Chip` | controls | yes | yes | inherited-global-root | yes | no | 6 |
 | `ChoiceChip` | controls | yes | yes | inherited-global-root | yes | no | 4 |
 | `Citation` | source | yes | yes | no | yes | no | 0 |
 | `CitationList` | source | yes | yes | no | yes | no | 0 |

docs/design-system/FIX-GUIDE.md

@@ -37,27 +37,27 @@ measurement of `globals.css` / `ckb-v2-tokens.css`.
 
 ## Batch B — docs dispositions
 
-| ID | Status | Rationale |
-| -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| DS-P2-04 | Documented | Intentional Geist variable interpolation. Already explained in [`docs/design-system.md`](../design-system.md) (intermediate weights; do **not** snap to 600/700). |
-| DS-P2-22 | Documented | `SectionHeading` exists (`src/components/ui/section-heading.tsx`); 14 production call sites. No opportunistic migration this sweep. |
-| DS-P2-23 | Documented | `AnswerCard` `frame?: "raised" \| "bare"` — both valid. Production answersurface uses **bare**. Future visual baselines must include both. Do not commit screenshots.  |
-| DS-P2-27 | Documented | 15-mode load: recommend first-run / Tools prominence later. No IA redesign this sweep. |
-| DS-P2-28 | Documented | Settings **Motion** already has a per-control description. **Recent searches on home** does not — docs recommendation only; no extra intro copy in product this sweep. |
-| DS-P2-29 | Deferred | Phone document-viewer density waits on the tap-floor (Hazard ≥3). |
-| DS-P2-30 | Documented | Toast primitive exists; there is no **universal network-error** toast. Do not build toast infra here. `OverlayRoot` remains the overlay owner. |
-| DS-P2-31 | Documented | Already in TOKENS §4 / SPEC §3: add `--kind-*` **with the first call site**. No values in this sweep. |
-| DS-P2-32 | Documented | `--text-placeholder` is **live** (globals + v2 + `placeholder:` consumers), not planned. TOKENS §5 corrected. No further role migration. |
-| DS-P2-33 | Documented | Contract `textSoftConsumers=0` in production. Keep the `--text-soft` alias until zero `var(--text-soft)` remain **including mockups**. Do not rename; do not delete this sweep. |
-| DS-P3-01 | Deferred | PR-9 plan. `--shadow-focus` and dead springs are already gone. `--shadow-lift` still has live `mode-nav` and `document-search-results` consumers — do **not** delete it. |
-| DS-P3-02 | Documented | TOKENS already: `--tone-*` frozen, not deleted. |
-| DS-P3-03 | Documented | TOKENS already: design-side `--quantity-unit-scale` never lands. |
-| DS-P3-04 | Documented | TOKENS already: ConfidenceMeter deferred; no token without a call site. |
-| DS-P3-05 | Documented | Registry has **55** registered visual exports. `DocumentFrame` is built shell-only and still unregistered. Register when print primitives ship (PR 11). Docs elsewhere may still say 53/54. |
-| DS-P3-07 | Documented | Full visual state matrix grows incrementally with new adoptions. |
-| DS-P3-08 | Documented | QA checklist: inspect the filter band at 414–430px. No code this sweep. |
-| DS-P3-09 | Documented | `#TYZK23` PWA install CLS already fixed (PR #2253). Regression-check note only; no speculative CSS. |
-| DS-P3-10 | Documented | Mockup `min-h-11` and `--text-soft` body must not leak into production. |
+| ID | Status | Rationale |
+| -------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| DS-P2-04 | Documented | Intentional Geist variable interpolation. Already explained in [`docs/design-system.md`](../design-system.md) (intermediate weights; do **not** snap to 600/700). |
+| DS-P2-22 | Documented | `SectionHeading` exists (`src/components/ui/section-heading.tsx`); 14 production call sites. No opportunistic migration this sweep. |
+| DS-P2-23 | Residual / Documented | Both frames valid. Production `answer-result-surface` uses `frame="bare"`; default/preview is `frame="raised"`. Harness note on `targets` in `tests/ui-visual-baseline.spec.ts`: a future AnswerCard baseline must capture **both** frames. Do not add targets, PNGs, or `AWAITING_BASELINE` entries until a real approval path exists. |
+| DS-P2-27 | Documented | 15-mode load: recommend first-run / Tools prominence later. No IA redesign this sweep. |
+| DS-P2-28 | Documented | Settings **Motion** already has a per-control description. **Recent searches on home** does not — docs recommendation only; no extra intro copy in product this sweep. |
+| DS-P2-29 | Deferred | Phone document-viewer density waits on the tap-floor (Hazard ≥3). |
+| DS-P2-30 | Documented | Toast primitive exists; there is no **universal network-error** toast. Do not build toast infra here. `OverlayRoot` remains the overlay owner. |
+| DS-P2-31 | Documented | Already in TOKENS §4 / SPEC §3: add `--kind-*` **with the first call site**. No values in this sweep. |
+| DS-P2-32 | Documented | `--text-placeholder` is **live** (globals + v2 + `placeholder:` consumers), not planned. TOKENS §5 corrected. No further role migration. |
+| DS-P2-33 | Documented | Contract `textSoftConsumers=0` in production. Keep the `--text-soft` alias until zero `var(--text-soft)` remain **including mockups**. Do not rename; do not delete this sweep. |
+| DS-P3-01 | Deferred | PR-9 plan. `--shadow-focus` and dead springs are already gone. `--shadow-lift` still has live `mode-nav` and `document-search-results` consumers — do **not** delete it. |
+| DS-P3-02 | Documented | TOKENS already: `--tone-*` frozen, not deleted. |
+| DS-P3-03 | Documented | TOKENS already: design-side `--quantity-unit-scale` never lands. |
+| DS-P3-04 | Documented | TOKENS already: ConfidenceMeter deferred; no token without a call site. |
+| DS-P3-05 | Documented | Registry has **55** registered visual exports. `DocumentFrame` is built shell-only and still unregistered. Register when print primitives ship (PR 11). Docs elsewhere may still say 53/54. |
+| DS-P3-07 | Documented | Full visual state matrix grows incrementally with new adoptions. |
+| DS-P3-08 | Documented | QA checklist: inspect the filter band at 414–430px. No code this sweep. |
+| DS-P3-09 | Documented | `#TYZK23` PWA install CLS already fixed (PR #2253). Regression-check note only; no speculative CSS. |
+| DS-P3-10 | Documented | Mockup `min-h-11` and `--text-soft` body must not leak into production. |
 
 ---
 
@@ -92,3 +92,4 @@ capture · `npm run ensure` unless a visual defect is proven.
 - `--shadow-lift` still live (`mode-nav`, `document-search-results`).
 - Mockup `--text-soft` still blocks alias deletion.
 - Mockup `min-h-11` must stay mockup-only.
+- AnswerCard visual baselines: future captures must include `frame="bare"` (live `answer-result-surface`) and `frame="raised"` (default/preview). No committed screenshots this sweep.