rcf-lite 0.32.4 → 0.33.0

package/CHANGELOG.md

@@ -6,6 +6,48 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.33.0] - 2026-10-09
+
+0.33.0 makes the viewer's Readiness tab the command page: questions, blocking items, a coverage summary, a stage grid with sub-tabs, delta counts and a trace matrix, backed by three new trace, impact and coverage JSON routes with a per-version memo on the viewer server. `rcf verify run` and `rcf build finalise` gain a deterministic mode so a dispatched worker that cannot spawn the agent CLI can still produce a report and refuse promotion honestly. Two watcher and server fixes make the live viewer survive write-temp-then-rename saves and never silently drop a change that lands mid-rewalk. breaking: false; every change is additive on the surfaces consumers run (new routes, new flags, new sub-views, a new verify mode, watcher and rewalk fixes); the `@stravica-ai/rcf-schemas` 0.6.3 pin is unchanged. minAgentAction: null.
+
+### Added
+
+- **Readiness tab as the command page: Questions and Blocking tables (FBS-204, US-18003 under REQ-180, PR 332).** The Readiness tabpanel is rebuilt as two linked, read-only command-page tables (TAC-4135 `renderQuestionsTable`, `renderBlockingTable`, `splitCompositeId`; ADR-4139). Questions and Blocking are paired tables with a shared filter bar (stage and persona filters), a copy-for-your-agent control through the shared toast with a textarea fallback, and a `#tab=readiness&...&entity=<itemId>` hash scheme that lands on a non-document row. The engineer blocker cards and the 20-id slice retire; the freeze control is replaced by a plain-words freeze state line that names failing gates and what resolves them. `src/view/readiness/composite-id.js`, `src/view/readiness/tables.js`, updates in `src/view/readiness.js`, `src/view/readiness/po-layer.js`, `src/view/page-init.js` and `src/view/style.css`. AC-18003-1 to AC-18003-8; AC-18001-3, -4 and -6 amended. New table styles sit on existing `--sv-*` tokens so the contrast audit stays green.
+- **Trace, impact and coverage JSON routes with per-version memo (FBS-207, US-208 under REQ-002, PR 335).** Three new viewer routes: `GET /trace.json?id=<id>&direction=<forward|back|both>`, `GET /impact.json?id=<id>` and `GET /coverage.json?scope=<id>`. Each reads the walked tree from server state, calls the pure compute and serves `application/json` with `cache-control: no-store`. A `queryCache` keyed by `${state.version}:${route}:${pivot}:${direction|scope}` is replaced wholesale on every rewalk, so a new tree version never serves a previous version's bytes. The three routes do not call `runWithAdmissibilityGate` so a tree that fails admissibility still answers them; nothing is written under `rcf/`. Error shape: 503 before the first walk completes, 404 `{error:"unknown-id"}` for a missing pivot, 400 `{error:"bad-direction"}` or `{error:"bad-scope"}` on invalid parameters, 405 `Allow: GET, HEAD` for other methods. `renderModelToPage` additionally returns `testPointers` so the three routes share one tree and one resolved pointer map with the rendered page. AC-208-1 to AC-208-7.
+- **Readiness coverage summary and thin-requirements table (FBS-205, US-18004 under REQ-180, PR 338).** New `src/view/readiness/coverage-summary.js` reads `coverage.tree.totals` and `unresolvedTestPointers` and emits a stat line (every slot a number or `coverage unavailable`, never a blank), a stacked bar on `--sv-success` / `--sv-warning` / `--sv-danger` over `--sv-surface`, six family stat tiles, and (when non-empty) an unresolved-pointers table. New `src/view/readiness/thin-reqs.js` widens the former `buildReqWorkRows` to five reasons (`reqHasUs`, `usFloors`, `reqIntent`, `zeroCriteria`, `uncoveredAc`) plus the retained `resolvedBy` signal; each row carries `stories`, `criteria`, `covered`, `thinReason`, `openHref` and `traceHref`. Verdict-card counts on the PO layer become links to the Questions and Blocking tables and the "What happens next" copy folds to one sentence per card. The engineer body no longer renders the old coverage block (it had read `coverage.tree.pass`/`.total`, which the real compute never produces, so it had painted blanks on every live tree). AC-18004-1 to AC-18004-7.
+- **Readiness layout: stage grid, sub-tabs and delta counts (FBS-206, US-18005 under REQ-180, PR 339).** A `SubTabStrip` across Overview, Questions, Blocking, Coverage and Trace carries `sub=` in the hash, restored on load and after an SSE innerHTML swap of `#rcf-live-content`; unknown `sub=` drops to Overview and is cleaned from the hash via `history.replaceState`. `renderVerdictGrid` builds a stage by (tree, delta) grid in Overview; each cell carries pass, total, state and a failing-count link into the Blocking sub-tab filtered to that stage. `renderDeltaCounts` emits six count tiles (`changed`, `added`, `removed`, `briefSince`, `impacted`, `impactedFbs`); the per-document list with its diff widgets sits inside a collapsed `<details>` and only renders when expanded. The For-engineers DocRow wrapper, the stage chips and the stage-detail block retire; freeze state renders in plain words with the "On me" / "On engineers" vocabulary and names each failing gate and what resolves it, or (when ready-to-build) what a freeze would record. CLI `verdictLines` render as a muted parity block in Overview so AC-18001-7 and AC-18002-3 ("every id in the DOM") stay true across sub-views. AC-18005-1 to AC-18005-8.
+- **Trace matrix sub-view (FBS-208, US-209 under REQ-002, PR 340).** The Readiness Trace sub-shell is replaced by a per-pivot matrix with rows per US and AC under the pivot and columns Suites, Cases, Build specs and Components. Cells carry reach and resolution (resolving on `--sv-success`, unresolved on `--sv-warning`, none on `--sv-muted`; no new palette token). `wireTraceMatrix` fetches `./trace.json?id=<pivot>&includeCode=1` and `./coverage.json`, caches per `state.version`, marks the current render stale after an SSE swap and refetches; a row filter kicks in past 200 rows and the empty state offers the lookup. The Questions and Blocking tables and the unresolved-pointers table gain Trace action columns that deep-link into the matrix. The per-REQ Mermaid slice on the Requirements tab retires (the generator in `src/view/mermaid-diagram.js` stays while AC-201-1 binds its unit tests; no user-facing surface renders it any more). AC-209-1 to AC-209-7.
+- **Deterministic verify mode so dispatched workers can run finalise (issue 330, PR 331).** `rcf verify run --mode <agentScreenshotCritique|deterministic>` and the same flag on `rcf build finalise`, defaulting to the pre-existing agent mode so existing runs are unchanged. `src/verify/engine/deterministic.js` is an in-process verifier that probes HTTP reachability and records every testable AC on `blockedAcs[]` as `critique-only`, with `runStats.counts = { verified, failed, skipped, total }`; no chain-level per-AC probe shape exists yet, so BLOCKED is the honest outcome. `src/cli/finalise.js` preseeds the `--out` report with a stub before spawning verify; overwrites it with `{ status: 'aborted', exitCode }` naming the mode when verify exits non-zero without writing (closing the ENOENT the issue cited); refuses promotion on any deterministic-mode run with `counts.skipped > 0` or `counts.verified < counts.total`, referencing ADR-4112; and treats a preseed-only report after a passing exit as unreadable. New ADR-4141, TAC-4141, US-16503 with AC-16503-1 to AC-16503-4, FBS-209 wiring the ACs, and TS-242 binding each AC to its real test pointer; `rcf audit coverage` now exits 0 (119/119 REQ covered). `docs/verify-reference.md` adds Verify modes, the ADR-4112 refusal, the partial-report fallback and a worked example of the forward checkable-AC shape.
+
+### Changed
+
+- **Viewer command-page DEFINE chain lands end to end (PR 326).** TAC-4135-readiness-command-page, TAC-4136-view-query-routes, ADR-4139 (viewer read-only, no CLI commands) and ADR-4140 (view query routes per pivot, matrix not Mermaid); US-18003, US-18004 and US-18005 under REQ-180; US-208 and US-209 under REQ-002; TS-237 to TS-241 bound to the five USes; FBS-204 to FBS-208 at build-order 204 to 208 with their AC lists; decisions-ledger Q1 to Q5 resolved; brief-ledger id 1 updated to the DEFINE-stage text. No `src/` changes in this entry; two Q5 render sketches (`5-subtabs`, `6-one-page`) land under `packages/rcf-lite/guidance/discovery/`. The DEFINE additions do not change any pre-existing readiness state.
+- **`/trace.json` additive opt-in `?includeCode=1` (PR 340).** Default behaviour is unchanged for every pre-FBS-208 caller; the `queryCache` key keys on the flag so a mix never serves wrong bytes.
+- **Dogfood suite expectations rise with the FBS-204 to FBS-208 chain adds.** `test/rcf-tree.test.js` codeNode count 348 to 354 for the FBS-208 code-node mints, with proportional bumps as each FBS-204 to FBS-207 PR landed; `test/view/fixtures/phase-3-6-static.html` and `test/build/fixtures/queue.{md,json}` are regenerated as the chain and view-shape changes land; `test/query/fixtures/{coverage,trace,impact}.{json,mmd,table.txt}` are regenerated after the new USes and the TC-description refresh.
+
+### Fixed
+
+- **Live viewer survives write-temp-then-rename saves (issue 336, PR 337).** On Linux, Node's recursive `fs.watch` reports the first rename over a file then goes permanently blind to that path, so editors that save by write-temp-then-rename (vim `backupcopy=no`, JetBrains safe-write) silently stall the live viewer with no error and keep it stale until restart. `src/watch/index.js` now re-arms the affected base on a `rename` event: it closes the stale `fs.watch` handle and opens a new one, which re-registers inotify descriptors against the current inodes. The re-arm coalesces onto the existing debounce window, so a burst of renames yields one re-arm per flush. Plain `change` events do not re-arm. The primitive accepts an optional `fsWatchImpl` override as a determinism seam for tests; production callers never pass it.
+- **Mid-rewalk changes coalesce into one trailing walk, and fatal watcher and walker errors always reach stderr (issue 333 items 1 and 2, PR 334).** `src/server/index.js` rewalk previously returned the in-flight walk when a change arrived while a walk was running, silently dropping the change until the next event. A change that arrives mid-rewalk now sets a trailing flag; when the in-flight walk settles, exactly one trailing rewalk runs and picks up the final on-disk state. Any number of concurrent calls collapse onto that single trailing walk; a trailing walk that itself coincides with another change queues one more after it. `startServer` now takes a `logError` option alongside `log`. `log` stays verbose-gated (chatty per-event lines keep flowing through it only when `--verbose` is on); `logError` is unconditional and receives `[server] walker failed` and `[watch] <error>`. `src/cli/view.js` wires `logError` to always write to stderr so a host that spawned `rcf audit view` as a supervised child without `--verbose` still sees a dead watcher instead of silently continuing to appear alive. A caller that passes only `log` keeps the pre-fix one-sink behaviour.
+
+### Notes
+
+- Discovery brief and infographics for the viewer command-page restructure land under `packages/rcf-lite/guidance/discovery/`, inside the home carved out at 0.32.5 (PR 323). Chain-first via three brief-ledger statements under `rcf/define/`; two resolve to REQ-180 (command page / readiness) and one to REQ-002 (viewer exposes trace, impact, coverage).
+- One pre-existing env-dependent skip remains (`TC-119 real-account-gated-url-skipped`); eight pre-existing scaffold TODO notices from `rcf define validate` (TAC-4122, FBS-198, TS-216, TS-218, TS-220) are unchanged.
+
+### For embedders
+
+Three new viewer routes (`/trace.json`, `/impact.json`, `/coverage.json`) must be added to the reverse-proxy allow-list for `/rcf-viewer/*` before the version pin bump; without the allow-list the new Readiness Trace sub-view cannot fetch its data. The embed contract and the `rcf-view-theme` postMessage are unchanged. Under `embed=1` the standalone theme control stays absent and the `rcf-view:v1:theme` key is never read or written.
+
+## [0.32.5] - 2026-10-07
+
+0.32.5 ships two chain-shape fixes surfaced by Dex on branch `dex/discovery-viewer-command-page` (reporter), closing issues 321 and 322. The dogfood walker in `test/rcf-tree.test.js` now mirrors the sidecar-ledger carve-out from `src/define/ledgers.js` and ignores `rcf/define/`, so the first `pnpm rcf define ledger brief add` on a fresh tree no longer blows up three dogfood assertions. A new `packages/rcf-lite/guidance/discovery/` (and companion `packages/rcf-lite/docs/discovery/`) subdir gives project discovery artefacts a predictable home outside the locked methodology inventories. The three locked slug lists in `test/guidance/inventory.test.js`, `test/mcp/resources.test.js` and `test/docs/links.test.js` are untouched and `guidance/manifest.json` is untouched, so an in-package methodology addition still requires a coordinated test-code change. breaking: false; the 0.32.1 through 0.32.4 fixes carry forward unchanged. minAgentAction: null.
+
+### Fixed
+
+- **Dogfood walker ignores `rcf/define/` ledgers (issue 321, reporter Dex, w-2026-10-07-dave-006).** `src/define/ledgers.js` exports the new `DEFINE_RELATIVE_DIR` constant; `test/rcf-tree.test.js:walk()` imports it and skips the directory the exact same way the ledger module writes to it, so the four sidecar ledgers (`brief-ledger.json`, `decisions-ledger.json`, `concern-ledger.json`, `probe-ledger.json`) plus the freeze record never surface to `classify()` or `loadAll()`. `loadAll()` additionally takes an optional project-root override so the carve-out works regardless of where the caller rooted the walk. Regression fixture seeds the four ledgers plus a bug-bait REQ-shaped file under `rcf/define/` and proves none of them surface, while a real chain document outside the carve-out does.
+- **Project discovery home carved out of the locked inventories (issue 322, reporter Dex, w-2026-10-07-dave-006).** `packages/rcf-lite/guidance/discovery/` and `packages/rcf-lite/docs/discovery/` are the new home for DISCOVERY-stage artefacts: discovery briefs, prototype notes, exploratory write-ups, infographic sketches. The subdirs sit outside the top-level non-recursive readdir enumerations the methodology locks use, so a first-time contributor can land a discovery brief without touching the methodology lock or the pack manifest. The guidance posture (no em-dash, no non-canonical external URLs, filename stem is a well-formed slug) still runs over the subdir via a new `test/guidance/discovery-home.test.js`. CONTRIBUTING.md documents the home under chain-first discipline.
+
 ## [0.32.4] - 2026-10-07
 
 0.32.4 is the stop-word follow-up to 0.32.3 after Dex's second-consumer check of PR 318 on WESPA main 34ebceba (2026-10-07T10:38Z, issue 319). 0.32.3 moved the English stop-word skip onto the pattern 4 (dot-notation) branch but left patterns 2 and 3 (prose `<name> field` and `fields: <name>`) with no stop-word filter at all; the AC-130-1 then-clause `declares NO join-shaped fields: the earlier jurisdiction ...` fed the word `the` to the extractor and false-failed D6 on WESPA (Ready-to-build no on 0.32.3 against yes on 0.31.0). breaking: false; the 0.32.1, 0.32.2 and 0.32.3 fixes carry forward unchanged. minAgentAction: null.

package/fixtures/canary-manifest.json

@@ -1,9 +1,9 @@
 {
   "registerCanary": [
     {
-      "id": "rc-2026-10-07-001",
-      "createdAt": "2026-10-07T11:27:52.587Z",
-      "buildVersion": "0.32.4-mockdriver",
+      "id": "rc-2026-10-09-001",
+      "createdAt": "2026-10-09T16:13:02.682Z",
+      "buildVersion": "0.33.0-mockdriver",
       "fixturePromptId": "canary-prompt-01",
       "responseWordCount": 55,
       "grades": {
@@ -34,9 +34,9 @@
       "shipDespiteFailReason": "mock canary driver used; no real subagent was dispatched. This record verifies canary infrastructure only, not the register itself."
     },
     {
-      "id": "rc-2026-10-07-002",
-      "createdAt": "2026-10-07T11:27:52.588Z",
-      "buildVersion": "0.32.4-mockdriver",
+      "id": "rc-2026-10-09-002",
+      "createdAt": "2026-10-09T16:13:02.682Z",
+      "buildVersion": "0.33.0-mockdriver",
       "fixturePromptId": "canary-prompt-02",
       "responseWordCount": 55,
       "grades": {
@@ -67,9 +67,9 @@
       "shipDespiteFailReason": "mock canary driver used; no real subagent was dispatched. This record verifies canary infrastructure only, not the register itself."
     },
     {
-      "id": "rc-2026-10-07-003",
-      "createdAt": "2026-10-07T11:27:52.588Z",
-      "buildVersion": "0.32.4-mockdriver",
+      "id": "rc-2026-10-09-003",
+      "createdAt": "2026-10-09T16:13:02.682Z",
+      "buildVersion": "0.33.0-mockdriver",
       "fixturePromptId": "canary-prompt-03",
       "responseWordCount": 55,
       "grades": {

package/guidance/discovery/README.md

@@ -0,0 +1,22 @@
+# guidance/discovery/
+
+Home for project discovery artefacts: discovery briefs, prototype
+notes, exploratory write-ups, and anything else that belongs to a
+specific DISCOVERY-stage effort rather than the methodology pack
+itself.
+
+Files directly under `guidance/` are the methodology inventory,
+locked by `test/guidance/inventory.test.js` and `test/mcp/resources.test.js`
+and reachable through `rcf://docs/<slug>`. New additions there require a
+coordinated test-code change and a manifest update.
+
+Files here, under `guidance/discovery/<slug>.md`, do NOT need a manifest
+update and are not served through the methodology-doc URIs. They still
+carry the guidance posture (no em-dash, no non-canonical external URLs,
+filename stem is a well-formed slug of lowercase letters, digits and
+hyphens); `test/guidance/discovery-home.test.js` enforces that.
+
+Companion home for engineer-facing docs: `docs/discovery/`.
+
+Issue 322 carved out this subdir so a first-time contributor can land a
+discovery brief without touching the methodology lock.

package/guidance/discovery/discovery-viewer-command-page-1-layout.html

@@ -0,0 +1,191 @@
+<!doctype html>
+<html lang="en-GB">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Discovery sketch: 1-layout</title>
+  <style>
+    <!-- F7-note: these --sv-* hex tokens are the LIGHT-mode palette only; the dark-mode block lives in src/view/style.css under html[data-theme="dark"] (and its auto variant) and is covered pair-by-pair by test/view/contrast-aa.test.js. The sketches set color-scheme: light to keep OS dark-mode from re-inking them; the viewer runtime switches tokens by data-theme, not by color-scheme. -->
+    :root {
+      --sv-canvas: #F6F8FC;
+      --sv-surface: #FFFFFF;
+      --sv-raised: #EEF2F8;
+      --sv-ink: #111927;
+      --sv-muted: #536176;
+      --sv-border: #D8DFEA;
+      --sv-control: #738198;
+      --sv-link: #2447EB;
+      --sv-hover: #1737C7;
+      --sv-active: #E9EEFF;
+      --sv-button: #2447EB;
+      --sv-onbutton: #FFFFFF;
+      --sv-code: #EEF2F8;
+      --sv-success: #116B4D;
+      --sv-successbg: #E7F4ED;
+      --sv-warning: #895000;
+      --sv-warningbg: #FFF3DC;
+      --sv-danger: #B4233B;
+      --sv-dangerbg: #FDECF0;
+      --sv-focus: #2447EB;
+      --sv-font: Arial, Helvetica, sans-serif;
+      --sv-mono: ui-monospace, SFMono-Regular, Consolas, "Liberation Mono", monospace;
+      color-scheme: light;
+    }
+    * { box-sizing: border-box; }
+    body { background: var(--sv-canvas); color: var(--sv-ink); font-family: var(--sv-font); margin: 0; }
+    main { max-width: 1100px; margin: 0 auto; padding: 30px 16px 22px; }
+    p { margin: 0; }
+    a { color: var(--sv-link); text-decoration: none; }
+    a:hover { color: var(--sv-hover); text-decoration: underline; }
+    a:focus-visible, button:focus-visible { outline: 2px solid var(--sv-focus); outline-offset: 4px; }
+    .intro { max-width: 980px; margin-bottom: 24px; font-size: 16px; line-height: 1.6; }
+    .verdicts { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 16px; margin-bottom: 22px; }
+    .card { background: var(--sv-surface); border: 1px solid var(--sv-border); border-radius: 8px; }
+    .verdict { padding: 22px 24px; }
+    .verdict-heading { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 18px; }
+    h1, h2 { margin: 0; }
+    .verdict h2 { font-size: 19px; line-height: 1.3; font-weight: 600; }
+    .verdict > a { font-size: 14px; line-height: 1.5; }
+    .pill { display: inline-block; padding: 5px 10px; border-radius: 20px; font-size: 12px; line-height: 1.25; font-weight: 600; }
+    .success { color: var(--sv-success); background: var(--sv-successbg); }
+    .warning { color: var(--sv-warning); background: var(--sv-warningbg); }
+    .verdict .pill { font-size: 13px; white-space: nowrap; }
+    .tabs { display: flex; flex-wrap: wrap; gap: 6px; padding: 0 0 12px; border-bottom: 1px solid var(--sv-border); margin-bottom: 24px; }
+    .tabs a { padding: 10px 16px; border-radius: 6px; font-size: 14px; font-weight: 600; }
+    .tabs a[aria-current="page"] { background: var(--sv-active); color: var(--sv-link); }
+    .section-heading { display: flex; align-items: baseline; justify-content: space-between; gap: 12px; margin-bottom: 14px; }
+    h1 { font-size: 21px; line-height: 1.3; letter-spacing: -0.4px; }
+    .eyebrow { color: var(--sv-muted); font-size: 11px; font-weight: 600; letter-spacing: 1.2px; text-transform: uppercase; }
+    .grid-card { padding: 0 20px 8px; }
+    table { width: 100%; border-collapse: collapse; table-layout: fixed; text-align: left; font-size: 14px; }
+    caption { color: var(--sv-muted); padding: 16px 0; text-align: left; font-size: 12px; }
+    col.stage { width: 9%; }
+    col.name { width: 22%; }
+    col.count { width: 15%; }
+    col.state { width: 24%; }
+    col.items { width: 15%; }
+    th, td { padding: 12px 10px; border-bottom: 1px solid var(--sv-border); vertical-align: middle; overflow-wrap: anywhere; }
+    thead th { background: var(--sv-raised); color: var(--sv-muted); font-size: 11px; letter-spacing: 0.7px; text-transform: uppercase; font-weight: 600; }
+    tbody th { font-family: var(--sv-mono); font-size: 13px; font-weight: 500; }
+    tbody tr:last-child > * { border-bottom: 0; }
+    .mono, code { font-family: var(--sv-mono); }
+    .mono { font-size: 13px; }
+    .muted { color: var(--sv-muted); }
+    .item-link { font-size: 13px; font-weight: 600; }
+    .tiles { display: grid; grid-template-columns: 1fr 1.25fr 0.75fr; gap: 14px; margin-top: 16px; }
+    .tile { display: flex; flex-direction: column; align-items: flex-start; gap: 12px; min-width: 0; padding: 20px; color: var(--sv-ink); }
+    .tile:hover { color: var(--sv-ink); text-decoration: none; border-color: var(--sv-control); }
+    .tile-label { font-size: 12px; font-weight: 600; color: var(--sv-muted); }
+    .tile-value { font-size: 15px; line-height: 1.5; }
+    .tile-value strong { font-weight: 600; }
+    .coverage-number { color: var(--sv-warning); }
+    .zero { font-size: 26px; line-height: 1.2; }
+    .show { color: var(--sv-link); font-size: 12px; margin-top: auto; }
+    .tile:hover .show { color: var(--sv-hover); text-decoration: underline; }
+    .next-action { display: flex; align-items: baseline; gap: 10px; margin: 20px 0 0; color: var(--sv-muted); font-size: 12px; line-height: 1.8; }
+    .next-action p { min-width: 0; }
+    code { background: var(--sv-code); padding: 3px 4px; border-radius: 3px; font-size: 11px; overflow-wrap: anywhere; }
+    button { font-family: var(--sv-font); font-size: 11px; color: var(--sv-muted); border: 1px solid var(--sv-border); background: var(--sv-surface); border-radius: 4px; padding: 5px 9px; }
+    .source { color: var(--sv-muted); margin-top: 28px; font-size: 12px; line-height: 1.7; overflow-wrap: anywhere; }
+    footer { margin-top: 20px; padding-top: 16px; border-top: 1px solid var(--sv-border); color: var(--sv-muted); font-size: 11px; line-height: 1.6; }
+    @media (max-width: 719px) {
+      main { padding-top: 20px; }
+      .verdicts, .tiles { grid-template-columns: 1fr; }
+      .verdict { padding: 20px; }
+      .tabs { gap: 2px; }
+      .tabs a { padding: 10px; font-size: 12px; }
+      .section-heading { align-items: flex-start; }
+      .grid-card { padding: 0 6px 6px; }
+      table { font-size: 12px; }
+      caption { padding: 14px 5px; }
+      th, td { padding: 12px 4px; }
+      thead th { font-size: 9px; letter-spacing: 0; }
+      .mono, tbody th, .item-link { font-size: 11px; }
+      .pill { padding: 4px 5px; font-size: 10px; max-width: 100%; }
+      .next-action { flex-wrap: wrap; }
+    }
+  </style>
+</head>
+<body>
+  <main>
+    <p class="intro">The rcf-lite viewer's Readiness tab currently mixes two verdict cards with a long scratchpad; this sketch shows the full rebuilt tab as linked tables and tiles that explain whether work can begin.</p>
+
+    <section aria-label="Readiness command page">
+      <div class="verdicts">
+        <section class="card verdict" aria-labelledby="engineers-heading">
+          <div class="verdict-heading">
+            <h2 id="engineers-heading">Ready for engineers</h2>
+            <span class="pill success">Yes</span>
+          </div>
+          <a href="#" title="#tab=readiness&amp;surface=questions">0 questions waiting for you</a>
+        </section>
+        <section class="card verdict" aria-labelledby="build-heading">
+          <div class="verdict-heading">
+            <h2 id="build-heading">Ready to build</h2>
+            <span class="pill warning">Not yet</span>
+          </div>
+          <a href="#" title="#tab=readiness&amp;surface=blocking">2 items for engineers, none for you</a>
+        </section>
+      </div>
+
+      <nav class="tabs" aria-label="Readiness sub-tabs">
+        <a href="#" title="#tab=readiness&amp;surface=overview" aria-current="page">Overview</a>
+        <a href="#" title="#tab=readiness&amp;surface=questions">Questions</a>
+        <a href="#" title="#tab=readiness&amp;surface=blocking">Blocking</a>
+        <a href="#" title="#tab=readiness&amp;surface=coverage">Coverage</a>
+        <a href="#" title="#tab=readiness&amp;surface=trace">Trace</a>
+      </nav>
+
+      <section aria-labelledby="grid-heading">
+        <div class="section-heading">
+          <h1 id="grid-heading">Readiness verdicts</h1>
+          <span class="eyebrow">Overview</span>
+        </div>
+        <div class="card grid-card">
+          <table>
+            <caption>D1 to D8 verdict grid, 8 rows</caption>
+            <colgroup><col class="stage"><col class="name"><col class="count"><col class="count"><col class="state"><col class="items"></colgroup>
+            <thead>
+              <tr><th scope="col">Stage</th><th scope="col">Name</th><th scope="col">Tree</th><th scope="col">Delta</th><th scope="col">State</th><th scope="col">Items</th></tr>
+            </thead>
+            <tbody>
+              <tr><th scope="row">D1</th><td>Brief</td><td class="mono">4/4</td><td class="mono">4/4</td><td><span class="pill success">pass</span></td><td class="muted">0</td></tr>
+              <tr><th scope="row">D2</th><td>Skeleton</td><td class="mono">6/6</td><td class="mono">6/6</td><td><span class="pill success">pass</span></td><td class="muted">0</td></tr>
+              <tr><th scope="row">D3</th><td>Shapes</td><td class="mono">8/8</td><td class="mono">8/8</td><td><span class="pill success">pass</span></td><td class="muted">0</td></tr>
+              <tr><th scope="row">D4</th><td>Stories</td><td class="mono">7/7</td><td class="mono">7/7</td><td><span class="pill success">pass</span></td><td class="muted">0</td></tr>
+              <tr><th scope="row">D5</th><td>Crosscut</td><td class="mono">5/5</td><td class="mono">5/5</td><td><span class="pill success">pass</span></td><td class="muted">0</td></tr>
+              <tr><th scope="row">D6</th><td>Consistency</td><td class="mono">9/9</td><td class="mono">7/9</td><td><span class="pill warning">unsatisfiable</span></td><td><a class="item-link" href="#" title="#tab=readiness&amp;surface=blocking&amp;stage=D6&amp;over=delta">2 <span class="muted">Delta</span></a></td></tr>
+              <tr><th scope="row">D7</th><td>Decisions</td><td class="mono">3/3</td><td class="mono">3/3</td><td><span class="pill success">pass</span></td><td class="muted">0</td></tr>
+              <tr><th scope="row">D8</th><td>Freeze</td><td class="mono">2/3</td><td class="mono">3/3</td><td><span class="pill warning">priorGates</span></td><td><a class="item-link" href="#" title="#tab=readiness&amp;surface=blocking&amp;stage=D8&amp;over=tree">1 <span class="muted">Tree</span></a></td></tr>
+            </tbody>
+          </table>
+        </div>
+
+        <div class="tiles">
+          <a class="card tile" href="#" title="#tab=readiness&amp;surface=overview&amp;section=delta">
+            <span class="tile-label">Delta</span>
+            <span class="tile-value"><strong>616 added</strong>, 0 changed, 0 removed</span>
+            <span class="show">show</span>
+          </a>
+          <a class="card tile" href="#" title="#tab=readiness&amp;surface=coverage">
+            <span class="tile-label">Coverage</span>
+            <span class="tile-value"><strong class="coverage-number">15 of 55 requirements covered (27 percent)</strong></span>
+          </a>
+          <a class="card tile" href="#" title="#tab=readiness&amp;surface=questions&amp;kind=decision">
+            <span class="tile-label">Open decisions</span>
+            <span class="tile-value zero">0</span>
+          </a>
+        </div>
+
+        <div class="next-action">
+          <p>Next action (engineer): D6 consistency:unsatisfiable, 2 items, re-check with <code>rcf define readiness --check consistency</code></p>
+          <button type="button" title="copies the re-check command">Copy</button>
+        </div>
+      </section>
+    </section>
+
+    <p class="source">Data: readiness.levels, readiness.stages[].checks[] grouped by over, readiness.delta, readiness.coverage.tree.totals. The For-engineers row no longer exists on the page; its content now lives on the Blocking and Coverage sub-tabs.</p>
+    <footer>Static sketch for the rcf-lite discovery document; mocked data, light theme.</footer>
+  </main>
+</body>
+</html>

package/guidance/discovery/discovery-viewer-command-page-2-coverage.html

@@ -0,0 +1,193 @@
+<!doctype html>
+<html lang="en-GB">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Discovery sketch: 2-coverage</title>
+  <style>
+    <!-- F7-note: these --sv-* hex tokens are the LIGHT-mode palette only; the dark-mode block lives in src/view/style.css under html[data-theme="dark"] (and its auto variant) and is covered pair-by-pair by test/view/contrast-aa.test.js. The sketches set color-scheme: light to keep OS dark-mode from re-inking them; the viewer runtime switches tokens by data-theme, not by color-scheme. -->
+    :root {
+      --sv-canvas: #F6F8FC; --sv-surface: #FFFFFF; --sv-raised: #EEF2F8; --sv-ink: #111927;
+      --sv-muted: #536176; --sv-border: #D8DFEA; --sv-control: #738198; --sv-link: #2447EB;
+      --sv-hover: #1737C7; --sv-active: #E9EEFF; --sv-button: #2447EB; --sv-onbutton: #FFFFFF;
+      --sv-code: #EEF2F8; --sv-success: #116B4D; --sv-successbg: #E7F4ED; --sv-warning: #895000;
+      --sv-warningbg: #FFF3DC; --sv-danger: #B4233B; --sv-dangerbg: #FDECF0; --sv-focus: #2447EB;
+      --sv-font: Arial, Helvetica, sans-serif;
+      --sv-mono: ui-monospace, SFMono-Regular, Consolas, "Liberation Mono", monospace;
+    }
+    * { box-sizing: border-box; }
+    body { background: var(--sv-canvas); color: var(--sv-ink); font-family: var(--sv-font); margin: 0; }
+    main { max-width: 1100px; padding: 28px 16px 20px; margin: 0 auto; }
+    p { line-height: 1.55; }
+    .intro { max-width: 850px; font-size: 17px; margin: 0 0 22px; }
+    .panel, .stat { background: var(--sv-surface); border: 1px solid var(--sv-border); border-radius: 8px; }
+    .panel { padding: 24px; }
+    .heading { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 20px; }
+    h1 { font-size: 25px; letter-spacing: -.6px; margin: 0; }
+    .eyebrow { color: var(--sv-muted); font-size: 11px; font-weight: 700; letter-spacing: 1.2px; text-transform: uppercase; margin: 0 0 7px; }
+    .mock { font-size: 11px; color: var(--sv-muted); padding: 6px 9px; border: 1px solid var(--sv-border); border-radius: 4px; white-space: nowrap; }
+    .stats { display: grid; grid-template-columns: repeat(6, minmax(0, 1fr)); gap: 10px; }
+    .stat { padding: 16px 12px; min-width: 0; }
+    .number { display: block; color: var(--sv-ink); font-size: clamp(24px, 3vw, 32px); font-weight: 700; letter-spacing: -1px; font-variant-numeric: tabular-nums; }
+    .label { display: block; color: var(--sv-muted); font-size: 12px; margin-top: 6px; }
+    .secondary { display: block; font-size: 11px; line-height: 1.4; margin-top: 9px; color: var(--sv-warning); }
+    .coverage { display: grid; grid-template-columns: minmax(0, 1fr) 150px; gap: 32px; align-items: center; margin: 28px 0 30px; }
+    h2 { font-size: 16px; margin: 0 0 7px; }
+    .summary { font-size: 13px; color: var(--sv-muted); margin: 0 0 13px; }
+    .summary strong { color: var(--sv-warning); }
+    .bar { display: flex; height: 36px; overflow: hidden; border-radius: 5px; }
+    .segment { display: flex; align-items: center; justify-content: center; color: var(--sv-onbutton); font-size: 13px; font-weight: 700; }
+    .covered-segment { flex-basis: 27.272727%; background: var(--sv-success); }
+    .unresolved-segment { flex-basis: 21.818182%; background: var(--sv-warning); }
+    .uncovered-segment { flex-basis: 50.909091%; background: var(--sv-danger); }
+    .legend { list-style: none; margin: 14px 0 0; padding: 0; display: grid; gap: 8px; }
+    .legend li { display: flex; align-items: baseline; gap: 8px; color: var(--sv-muted); font-size: 12px; line-height: 1.4; }
+    .legend strong { color: var(--sv-ink); font-weight: 600; }
+    .swatch { width: 9px; height: 9px; flex: 0 0 9px; border-radius: 2px; }
+    .swatch.success { background: var(--sv-success); }
+    .swatch.warning { background: var(--sv-warning); }
+    .swatch.danger { background: var(--sv-danger); }
+    figure { margin: 0; text-align: center; }
+    .donut { display: block; width: 120px; height: 120px; margin: 0 auto; }
+    .donut circle { fill: none; stroke-width: 20; }
+    .arc-success { stroke: var(--sv-success); }
+    .arc-warning { stroke: var(--sv-warning); }
+    .arc-danger { stroke: var(--sv-danger); }
+    .donut-percent { fill: var(--sv-warning); font-family: var(--sv-font); font-size: 23px; font-weight: 700; }
+    .donut-label { fill: var(--sv-muted); font-family: var(--sv-font); font-size: 10px; }
+    figcaption { color: var(--sv-muted); font-size: 11px; margin-top: 12px; }
+    table { border-collapse: separate; border-spacing: 0; width: 100%; table-layout: fixed; font-size: 12px; }
+    caption { text-align: left; color: var(--sv-ink); font-size: 16px; font-weight: 700; padding-bottom: 13px; line-height: 1.5; }
+    caption span { color: var(--sv-muted); font-size: 11px; font-weight: 400; }
+    th, td { padding: 12px 8px; border-bottom: 1px solid var(--sv-border); text-align: left; vertical-align: middle; overflow-wrap: anywhere; }
+    thead th { color: var(--sv-muted); background: var(--sv-raised); font-size: 10px; font-weight: 700; }
+    thead th:first-child { border-radius: 5px 0 0 0; }
+    thead th:last-child { border-radius: 0 5px 0 0; }
+    tbody th { font-weight: 400; }
+    .mono, code { font-family: var(--sv-mono); font-size: 11px; }
+    .numeric { text-align: right; font-variant-numeric: tabular-nums; }
+    .pill { display: inline-block; border-radius: 20px; padding: 4px 7px; font-size: 10px; font-weight: 700; white-space: nowrap; }
+    .pill.covered { color: var(--sv-success); background: var(--sv-successbg); }
+    .pill.unresolved { color: var(--sv-warning); background: var(--sv-warningbg); }
+    .pill.uncovered { color: var(--sv-danger); background: var(--sv-dangerbg); }
+    a { color: var(--sv-link); text-decoration: none; }
+    a:hover { color: var(--sv-hover); text-decoration: underline; }
+    a:focus-visible { outline: 2px solid var(--sv-focus); outline-offset: 3px; border-radius: 2px; }
+    .pointers { margin-top: 30px; }
+    .pointers td:last-child { color: var(--sv-warning); }
+    .continuation { font-size: 12px; color: var(--sv-muted); margin: 12px 0 0; }
+    code { background: var(--sv-code); border-radius: 3px; padding: 2px 4px; overflow-wrap: anywhere; }
+    .source { font-size: 12px; color: var(--sv-muted); margin: 18px 0; overflow-wrap: anywhere; }
+    footer { border-top: 1px solid var(--sv-border); padding-top: 13px; color: var(--sv-muted); font-size: 11px; line-height: 1.5; }
+    @media (min-width: 720px) and (max-width: 900px) {
+      .panel { padding: 16px; }
+      .stat { padding: 14px 8px; }
+      th, td { padding: 11px 4px; }
+      .pill { padding: 4px 5px; font-size: 9px; }
+      .mono { font-size: 10px; }
+    }
+    @media (max-width: 719px) {
+      main { padding-top: 20px; }
+      .panel { padding: 16px; }
+      .intro { font-size: 16px; }
+      .stats { grid-template-columns: repeat(3, minmax(0, 1fr)); }
+      .coverage { grid-template-columns: minmax(0, 1fr); gap: 22px; }
+      .heading { align-items: flex-start; }
+      h1 { font-size: 22px; }
+      table, caption, tbody, tr, td, tbody th { display: block; width: 100%; }
+      thead { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); }
+      tbody { display: grid; gap: 12px; }
+      tbody tr { border: 1px solid var(--sv-border); border-radius: 6px; overflow: hidden; }
+      tbody th, tbody td { display: grid; grid-template-columns: 92px minmax(0, 1fr); gap: 8px; text-align: left; padding: 9px 10px; align-items: center; }
+      tbody th { background: var(--sv-raised); }
+      tbody td:last-child { border-bottom: 0; }
+      tbody th::before, tbody td::before { content: attr(data-label); font-family: var(--sv-font); font-size: 11px; color: var(--sv-muted); font-weight: 400; }
+      .pill { justify-self: start; }
+    }
+    @media (max-width: 380px) {
+      .stats { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+      .heading { flex-wrap: wrap; }
+    }
+  </style>
+</head>
+<body>
+  <main>
+    <p class="intro">The Coverage sub-tab turns raw test coverage counts and unresolved test references into a chart-and-table report.</p>
+    <section class="panel" aria-labelledby="page-title">
+      <header class="heading">
+        <div><p class="eyebrow">Discovery / Coverage</p><h1 id="page-title">Coverage summary</h1></div>
+        <span class="mock">Static mock</span>
+      </header>
+      <div class="stats" aria-label="Tree totals">
+        <div class="stat"><span class="number">55</span><span class="label">Requirements</span><span class="secondary">27 percent covered</span></div>
+        <div class="stat"><span class="number">165</span><span class="label">Stories</span></div>
+        <div class="stat"><span class="number">1,121</span><span class="label">Criteria</span></div>
+        <div class="stat"><span class="number">188</span><span class="label">Test suites</span></div>
+        <div class="stat"><span class="number">1,314</span><span class="label">Test cases</span></div>
+        <div class="stat"><span class="number">128</span><span class="label">Build specs</span></div>
+      </div>
+      <section class="coverage" aria-labelledby="distribution-title">
+        <div>
+          <h2 id="distribution-title">Requirement coverage</h2>
+          <p class="summary"><strong>15 of 55</strong> requirements covered</p>
+          <div class="bar" role="img" aria-label="55 requirements: 15 covered, 12 covered-unresolved, 28 uncovered">
+            <div class="segment covered-segment" title="15 covered">15</div>
+            <div class="segment unresolved-segment" title="12 covered-unresolved">12</div>
+            <div class="segment uncovered-segment" title="28 uncovered">28</div>
+          </div>
+          <ul class="legend">
+            <li><span class="swatch success" aria-hidden="true"></span><span><strong>covered:</strong> every criterion has a test that resolves on disk</span></li>
+            <li><span class="swatch warning" aria-hidden="true"></span><span><strong>unresolved:</strong> a test is named but its pointer does not resolve</span></li>
+            <li><span class="swatch danger" aria-hidden="true"></span><span><strong>uncovered:</strong> at least one criterion has no test</span></li>
+          </ul>
+        </div>
+        <figure>
+          <svg class="donut" viewBox="0 0 120 120" role="img" aria-labelledby="donut-title donut-desc">
+            <title id="donut-title">27% covered</title>
+            <desc id="donut-desc">15 covered, 12 unresolved and 28 uncovered requirements, out of 55.</desc>
+            <g transform="rotate(-90 60 60)">
+              <circle class="arc-success" cx="60" cy="60" r="50" stroke-dasharray="85.679800 228.479465" />
+              <circle class="arc-warning" cx="60" cy="60" r="50" stroke-dasharray="68.543840 245.615425" stroke-dashoffset="-85.679800" />
+              <circle class="arc-danger" cx="60" cy="60" r="50" stroke-dasharray="159.935625 154.223640" stroke-dashoffset="-154.223640" />
+            </g>
+            <text class="donut-percent" x="60" y="60" text-anchor="middle">27%</text>
+            <text class="donut-label" x="60" y="76" text-anchor="middle">covered</text>
+          </svg>
+          <figcaption>Share of 55 requirements</figcaption>
+        </figure>
+      </section>
+      <table aria-label="Requirements by coverage class">
+        <caption>Requirements by coverage class<span>, 8 rows (truncated from 55)</span></caption>
+        <colgroup><col style="width:12%"><col style="width:25%"><col style="width:8%"><col style="width:8%"><col style="width:9%"><col style="width:16%"><col style="width:11%"><col style="width:11%"></colgroup>
+        <thead><tr><th scope="col">Requirement</th><th scope="col">Title</th><th scope="col" class="numeric">Stories</th><th scope="col" class="numeric">Criteria</th><th scope="col" class="numeric">Covered</th><th scope="col">Class</th><th scope="col">Open</th><th scope="col">Trace</th></tr></thead>
+        <tbody>
+          <tr><th scope="row" data-label="Requirement" class="mono">REQ-022</th><td data-label="Title">Natural language query</td><td data-label="Stories" class="numeric">2</td><td data-label="Criteria" class="numeric">18</td><td data-label="Covered" class="numeric">0</td><td data-label="Class"><span class="pill uncovered">uncovered</span></td><td data-label="Open"><a href="#" title="#tab=requirements&amp;entity=REQ-022">Open</a></td><td data-label="Trace"><a href="#" title="#tab=trace&amp;id=REQ-022">Trace</a></td></tr>
+          <tr><th scope="row" data-label="Requirement" class="mono">REQ-031</th><td data-label="Title">Audit export</td><td data-label="Stories" class="numeric">3</td><td data-label="Criteria" class="numeric">22</td><td data-label="Covered" class="numeric">0</td><td data-label="Class"><span class="pill uncovered">uncovered</span></td><td data-label="Open"><a href="#" title="#tab=requirements&amp;entity=REQ-031">Open</a></td><td data-label="Trace"><a href="#" title="#tab=trace&amp;id=REQ-031">Trace</a></td></tr>
+          <tr><th scope="row" data-label="Requirement" class="mono">REQ-004</th><td data-label="Title">Freeze workflow</td><td data-label="Stories" class="numeric">1</td><td data-label="Criteria" class="numeric">7</td><td data-label="Covered" class="numeric">0</td><td data-label="Class"><span class="pill uncovered">uncovered</span></td><td data-label="Open"><a href="#" title="#tab=requirements&amp;entity=REQ-004">Open</a></td><td data-label="Trace"><a href="#" title="#tab=trace&amp;id=REQ-004">Trace</a></td></tr>
+          <tr><th scope="row" data-label="Requirement" class="mono">REQ-018</th><td data-label="Title">Delta rendering</td><td data-label="Stories" class="numeric">2</td><td data-label="Criteria" class="numeric">14</td><td data-label="Covered" class="numeric">9</td><td data-label="Class"><span class="pill unresolved">unresolved</span></td><td data-label="Open"><a href="#" title="#tab=requirements&amp;entity=REQ-018">Open</a></td><td data-label="Trace"><a href="#" title="#tab=trace&amp;id=REQ-018">Trace</a></td></tr>
+          <tr><th scope="row" data-label="Requirement" class="mono">REQ-007</th><td data-label="Title">Consistency checks</td><td data-label="Stories" class="numeric">3</td><td data-label="Criteria" class="numeric">24</td><td data-label="Covered" class="numeric">17</td><td data-label="Class"><span class="pill unresolved">unresolved</span></td><td data-label="Open"><a href="#" title="#tab=requirements&amp;entity=REQ-007">Open</a></td><td data-label="Trace"><a href="#" title="#tab=trace&amp;id=REQ-007">Trace</a></td></tr>
+          <tr><th scope="row" data-label="Requirement" class="mono">REQ-012</th><td data-label="Title">Coverage render</td><td data-label="Stories" class="numeric">2</td><td data-label="Criteria" class="numeric">15</td><td data-label="Covered" class="numeric">15</td><td data-label="Class"><span class="pill covered">covered</span></td><td data-label="Open"><a href="#" title="#tab=requirements&amp;entity=REQ-012">Open</a></td><td data-label="Trace"><a href="#" title="#tab=trace&amp;id=REQ-012">Trace</a></td></tr>
+          <tr><th scope="row" data-label="Requirement" class="mono">REQ-001</th><td data-label="Title">Readiness verdict</td><td data-label="Stories" class="numeric">2</td><td data-label="Criteria" class="numeric">11</td><td data-label="Covered" class="numeric">11</td><td data-label="Class"><span class="pill covered">covered</span></td><td data-label="Open"><a href="#" title="#tab=requirements&amp;entity=REQ-001">Open</a></td><td data-label="Trace"><a href="#" title="#tab=trace&amp;id=REQ-001">Trace</a></td></tr>
+          <tr><th scope="row" data-label="Requirement" class="mono">REQ-015</th><td data-label="Title">Trace matrix</td><td data-label="Stories" class="numeric">1</td><td data-label="Criteria" class="numeric">9</td><td data-label="Covered" class="numeric">9</td><td data-label="Class"><span class="pill covered">covered</span></td><td data-label="Open"><a href="#" title="#tab=requirements&amp;entity=REQ-015">Open</a></td><td data-label="Trace"><a href="#" title="#tab=trace&amp;id=REQ-015">Trace</a></td></tr>
+        </tbody>
+      </table>
+      <table class="pointers" aria-label="Unresolved test pointers">
+        <caption>Unresolved test pointers<span>, 6 of 94 shown</span></caption>
+        <colgroup><col style="width:16%"><col style="width:20%"><col style="width:46%"><col style="width:18%"></colgroup>
+        <thead><tr><th scope="col">Suite</th><th scope="col">Case</th><th scope="col">Pointer</th><th scope="col">Reason</th></tr></thead>
+        <tbody>
+          <tr><th scope="row" data-label="Suite" class="mono">TS-018-a</th><td data-label="Case" class="mono">TC-018-a-04</td><td data-label="Pointer" class="mono">tests/rcf/foo.spec.mjs::case</td><td data-label="Reason" class="mono">test-missing</td></tr>
+          <tr><th scope="row" data-label="Suite" class="mono">TS-018-a</th><td data-label="Case" class="mono">TC-018-a-05</td><td data-label="Pointer" class="mono">tests/rcf/foo.spec.mjs::case</td><td data-label="Reason" class="mono">test-missing</td></tr>
+          <tr><th scope="row" data-label="Suite" class="mono">TS-022-b</th><td data-label="Case" class="mono">TC-022-b-01</td><td data-label="Pointer" class="mono">tests/rcf/query.spec.mjs::nlq</td><td data-label="Reason" class="mono">file-missing</td></tr>
+          <tr><th scope="row" data-label="Suite" class="mono">TS-031-a</th><td data-label="Case" class="mono">TC-031-a-02</td><td data-label="Pointer" class="mono">tests/rcf/export.spec.mjs::audit</td><td data-label="Reason" class="mono">test-missing</td></tr>
+          <tr><th scope="row" data-label="Suite" class="mono">TS-007-c</th><td data-label="Case" class="mono">TC-007-c-03</td><td data-label="Pointer" class="mono">tests/rcf/consistency.spec.mjs::shape</td><td data-label="Reason" class="mono">test-missing</td></tr>
+          <tr><th scope="row" data-label="Suite" class="mono">TS-018-b</th><td data-label="Case" class="mono">TC-018-b-01</td><td data-label="Pointer" class="mono">tests/rcf/delta.spec.mjs::row</td><td data-label="Reason" class="mono">file-missing</td></tr>
+        </tbody>
+      </table>
+      <p class="continuation">List continues; the full set is available from <code>rcf audit coverage --json</code>.</p>
+    </section>
+    <p class="source">Data: coverage.tree.totals, coverage.tree.requirements[].coverageClass, coverage.tree.unresolvedTestPointers[], family counts from the tree model. Today the Coverage block prints a blank where this page prints 15 of 55.</p>
+    <footer>Static sketch for the rcf-lite discovery document; mocked data, light theme.</footer>
+  </main>
+</body>
+</html>