Merge pull request #2738 from BigSimmo/claude/review-four-mockups-0l9x8c

docs(ward-flow): Command mockup and design system, third edition

Author: BigSimmo

.gitignore

@@ -203,3 +203,9 @@ tests/zz-tmp-*.test.ts
 # session start and rewritten after a restart. Never committed: it is local, it goes stale the
 # moment a chat ends, and a committed one would freeze a dead role into the repository.
 .ward-session.json
+
+# Ward Flow third edition harness screenshots: local proof images, regenerated by the kit, never committed.
+docs/ward-flow/mockups/third-edition-shots/
+# Transient Playwright probes the shell restyle agents write beside the fragments; the deliverables are shell.css, shell-docs.css, shell-markup.html, shell-script.js, preview.html and SHELL-NOTES.md.
+docs/ward-flow/mockups/third-edition-kit/shell/cap-*.mjs
+docs/ward-flow/mockups/third-edition-kit/shell/probe-*.mjs

data/repo-awareness-snapshot.json

@@ -1,7 +1,7 @@
 {
   "version": "repo-awareness-snapshot-v3",
   "captured_revision": {
-    "committed_at": "2026-09-07"
+    "committed_at": "2026-09-08"
   },
   "routes": {
     "modes": [
@@ -1635,6 +1635,11 @@
         "section": "root",
         "catalogued": true
       },
+      {
+        "path": "docs/ward-flow/mockups/WARD-FLOW-DESIGN-SYSTEM.md",
+        "section": "ward-flow",
+        "catalogued": false
+      },
       {
         "path": "docs/superpowers/specs/2026-09-05-ward-flow-merges-1-3-design-lock.md",
         "section": "superpowers",
@@ -2805,6 +2810,11 @@
         "section": "caring-contacts",
         "catalogued": true
       },
+      {
+        "path": "docs/ward-flow/mockups/third-edition-kit/HANDOVER.md",
+        "section": "ward-flow",
+        "catalogued": false
+      },
       {
         "path": "docs/ward-flow/handovers/ward-builder-one-integration-2026-09-02.md",
         "section": "ward-flow",
@@ -3555,6 +3565,11 @@
         "section": "redesign",
         "catalogued": true
       },
+      {
+        "path": "docs/ward-flow/mockups/third-edition-kit/MERGE-BRIEF.md",
+        "section": "ward-flow",
+        "catalogued": false
+      },
       {
         "path": "docs/ward-flow/sdd-rescued/ward-community-index/task-1-report.md",
         "section": "ward-flow",
@@ -4050,6 +4065,11 @@
         "section": "ward-flow",
         "catalogued": false
       },
+      {
+        "path": "docs/ward-flow/mockups/third-edition-kit/inputs/SHELL-REVIEW.md",
+        "section": "ward-flow",
+        "catalogued": false
+      },
       {
         "path": "docs/ward-flow/sdd-rescued/ward-statistics-skeleton/task-nine-claims-brief.md",
         "section": "ward-flow",
@@ -4390,6 +4410,11 @@
         "section": "caring-contacts",
         "catalogued": true
       },
+      {
+        "path": "docs/ward-flow/mockups/third-edition-kit/fonts/README.md",
+        "section": "ward-flow",
+        "catalogued": false
+      },
       {
         "path": "docs/caring-contacts/PROGRESS-LEDGER.md",
         "section": "caring-contacts",
@@ -5645,6 +5670,11 @@
         "section": "ward-flow",
         "catalogued": false
       },
+      {
+        "path": "docs/ward-flow/mockups/third-edition-kit/inputs/SHELL-SPEC.md",
+        "section": "ward-flow",
+        "catalogued": false
+      },
       {
         "path": "docs/ward-flow-phase-3-workspace/progress.md",
         "section": "ward-flow-phase-3-workspace",
@@ -5775,6 +5805,11 @@
         "section": "archive",
         "catalogued": true
       },
+      {
+        "path": "docs/ward-flow/mockups/third-edition-kit/shell/SHELL-NOTES.md",
+        "section": "ward-flow",
+        "catalogued": false
+      },
       {
         "path": "docs/caring-contacts/phase-2b-pr-body.md",
         "section": "caring-contacts",
@@ -6149,6 +6184,11 @@
         "path": "docs/caring-contacts/phase-2b-sdd-archive/task-5-report.md",
         "section": "caring-contacts",
         "catalogued": true
+      },
+      {
+        "path": "docs/ward-flow/mockups/third-edition-kit/inputs/RAIL-MAP.md",
+        "section": "ward-flow",
+        "catalogued": false
       }
     ],
     "sections": [
@@ -7394,6 +7434,14 @@
         "outcome": "exact merged PR #1491 head; un-checked-out local branch archived in verified batch3 bundle",
         "checks": "GitHub merged exact head, branch not checked out, no open PR claim, batch3 bundle verify ok SHA256 48AF30DD07A04703D02F4A2FFBDE65F1E573D081E4660D4C7E240D8DB1079B8C"
       },
+      {
+        "date": "2026-09-07",
+        "ref": "PR-2628",
+        "head": "0c061ba66d610d6a0ae2ca38cf467cb96191fd54",
+        "scope": "PR merge readiness",
+        "outcome": "Child rollback defect reproduced and corrected locally; RAG behavior classification and live-canary baseline remain merge blockers.",
+        "checks": "44 earlier focused tests and 221 Caring Contacts database tests passed. Revised rollback, both row ceilings, deleted-owner SQL fixtures and transactional migrations passed; regenerated schema manifest."
+      },
       {
         "date": "2026-08-15",
         "ref": "claude/test-source-contract-hardening",
@@ -9530,6 +9578,14 @@
         "outcome": "Before: fixed docks always consumed the measured visual-viewport height, double-lifting them when `interactive-widget=resizes-content` already resized the layout viewport. After: the provider subtracts layout shrink and exposes only residual overlay height to CSS while retaining keyboard-open state.",
         "checks": "Focused Vitest 18/18 pass; `npm run ensure` verified http://localhost:3264; Prettier and diff checks pass; no provider-backed checks run."
       },
+      {
+        "date": "2026-09-07",
+        "ref": "PR-2628",
+        "head": "2897742597ee22017bf54d25fe6474f435d546b0",
+        "scope": "PR CI and review repair",
+        "outcome": "Reviewed migration ordering and rollback semantics, synced current main, and fixed deterministic forms sorting CI expectation.",
+        "checks": "vitest corpus-access and migration-history suites (31); focused offline safety suites (43 total); installed-lock parity; merge-tree clean"
+      },
       {
         "date": "2026-07-24",
         "ref": "PR #1176 / `cursor/pdf-crop-malformed-repro-9b3e`",
@@ -10530,6 +10586,14 @@
         "outcome": "Queued one P1 add request: check:drift reported missing_live 21 (2026-08-09) then 20 (2026-08-14) despite two indexes being restored between, so the expected figure was 19; the gap is consistent with an ongoing drop mechanism. Recorded as inference not fact. Carries a stop rule against beginning the restoration window until resolved. Filed as add rather than a #316 update to avoid colliding with the #316 update already queued in PR #1970.",
         "checks": "verify:pr-local (11 completed, 0 failed)"
       },
+      {
+        "date": "2026-09-07",
+        "ref": "PR-2702",
+        "head": "3687785ed0b3898d4f179933aab8dc7dab791bb3",
+        "scope": "PR merge readiness",
+        "outcome": "Local repair findings corrected; hosted verification pending.",
+        "checks": "154 focused tests, typecheck, SQL regression fixture and schema replay passed; final publication pending."
+      },
       {
         "date": "2026-07-30",
         "ref": "codex/review-pr1423",
@@ -11058,6 +11122,14 @@
         "outcome": "fixed",
         "checks": "git diff --check; static ledger guards; focused tests blocked without node_modules"
       },
+      {
+        "date": "2026-09-07",
+        "ref": "claude/audit-fix-p16",
+        "head": "3c8c48223e38e4c58580df96fb0f3ec2f351303f",
+        "scope": "PR2628 integration of merged PR2702 and schema mirror correction",
+        "outcome": "Integrated main 0177bed184; restored legacy generation function mirror to canonical migration hash; canary baseline still blocks merge.",
+        "checks": "169 focused tests passed; combined Docker schema replay and three SQL fixtures passed; canonical generation function hash 594b1f715fbbfa1df1b1f1183a7fef5a restored; previous head hosted CI passed; new-head CI required; provider canary not dispatched."
+      },
       {
         "date": "2026-08-18",
         "ref": "claude/patient-factsheets-search-regression-8iyvnd",
@@ -18434,6 +18506,14 @@
         "outcome": "FIXED. Hosted Build failed when a runner reported 7.8 GiB via `os.totalmem` and hit the local Docker RAM floor in `guard-next-build.mjs`. Gate now skips under `CI`/`GITHUB_ACTIONS` (local protection retained). Prior tip motion/Bugbot fixes unchanged.",
         "checks": "CI=true guard exit 0; awaiting exact-head hosted Build; no provider checks."
       },
+      {
+        "date": "2026-09-07",
+        "ref": "codex/canary-fallback-repair-20260907",
+        "head": "9181d1a78b0e1b02eb34572c83a93aeb18152d61",
+        "scope": "fallback prose recovery",
+        "outcome": "No actionable findings in targeted review; live baseline pending",
+        "checks": "50 focused tests and 630 offline RAG tests passed; typecheck passed; production readiness blocked by six existing governance approvals"
+      },
       {
         "date": "2026-08-07",
         "ref": "cursor/site-testing-speed-08c1",
@@ -21690,6 +21770,14 @@
         "outcome": "SUPERSEDES the 2026-07-30 db8209be record, which asserted a root cause now REFUTED. That record claimed dragScrollBy clamping made the ui-phone-scroll red; main's #127 carries trace evidence (PR #1404 run 30521269873) that the drag delivered in full (scrollTop 1272 = 552+720) with ~1300px runway spare and a 10s non-flip is a latched state. The change is a diagnostic and guard, NOT a fix, and is now labelled so in the docstring, commit, PR body and #127. Remaining candidates: scrollHidden false vs sharedChromePinned latched; they are indistinguishable from the DOM because only the composite data-scroll-hidden is exposed. Prime suspect in source: composerFocusPinsChrome has a still-the-active-owner guard, headerFocusPinsChrome has none (master-search-header.tsx:397-398). ALSO: this PR ran zero pull_request workflows for ~2h (no CI/Gitleaks/Semgrep, only pull_request_target) because a real conflict blocked refs/pull/1427/merge - issue #116, caught by main's new PR mergeability check. Merging main fixed it and CI ran green first try.",
         "checks": "CI run 30530618838 SUCCESS (13m39). MEASURED shard result, correcting the ~7min prediction: Production UI (1) 121 tests 9m36, (2) 111 tests 6m54, (3) 110 tests 6m20 - per-test cost is NOT uniform, shard 1 holds the slow specs, so the largest shard is 9m36 not the predicted 6.8min. ui-critical-fast 3m14. PR required SUCCESS. verify:cheap on merged tree PASS (434 files / 4563 passed, 4 skipped); prettier --check . PASS; ui-phone-scroll ran locally 1x via PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH: 56 passed (5.3m) - three-run protocol NOT completed and not applicable, since this is not a flake fix."
       },
+      {
+        "date": "2026-09-05",
+        "ref": "claude/audit-fix-p16 (PR #2628)",
+        "head": "ba04794640bd9edf9484d07a530bc5d109fc4537",
+        "scope": "Run PR sweep: CI fix + threads + drift",
+        "outcome": "before: PR required FAILURE (drift-detection test: schema.sql changed without regenerating drift-manifest.json), auto-merge ARMED on a PR carrying a live migration (align_corpus_flip_retrieval_scoped_child_owners). after: regenerated supabase/drift-manifest.json via local disposable Docker Postgres (never touches live project); guard-push correctly refused to push while auto-merge was armed on a migration PR, flagged to the user, user disabled auto-merge, then pushed. Merged origin/main (clean, twice). PR now green and waiting for the user's manual merge inside an approved window — never auto-merged.",
+        "checks": "npm run drift:manifest (local Docker Postgres replay); npx vitest run tests/drift-detection.test.ts (21 passed, twice, before and after the second main merge). No provider-backed / live-Supabase checks run."
+      },
       {
         "date": "2026-08-18",
         "ref": "claude/services-navigation-removal-7bnknn",
@@ -26066,6 +26154,14 @@
         "outcome": "redundant exact head merged in PR 1438; removal deferred by primary-dirty lease",
         "checks": "clean status; GitHub merged exact head; zero cherry-pick-unique commits"
       },
+      {
+        "date": "2026-09-07",
+        "ref": "codex/canary-fallback-repair-20260907",
+        "head": "f13dbc27efd9174c0de5ffcb39a73c791dd0f148",
+        "scope": "fallback prose recovery",
+        "outcome": "Targeted review found no actionable defects; all three original fallbacks pass live; full baseline retains two timing-only failures",
+        "checks": "109 focused tests, 630 offline RAG tests and typecheck passed; live 44 cases: 30/30 substantive, citation/numeric failures zero; two latency rechecks pending; production readiness blocked by six existing approvals"
+      },
       {
         "date": "2026-07-11",
         "ref": "PR #469 / claude/response-formatting-cleanup-b57a9c",

docs/branch-review-records/df6044d9294459264c2f4e359288ec9298831b3b58611b1122a9d55947f76458.record.md

@@ -0,0 +1 @@
+| 2026-09-08 | claude/review-four-mockups-0l9x8c (PR #2738) | 3717589deb70271aef584d855e056fd15aa3460d | Ward Flow Command mockup and design system, third edition, with the universal header and rail (docs only) | Handoff. The Live edition Command re-cut in the Platinum identity with the owner's header and rail grafted over the real engine, plus the design system page and document and the verification kit. Reviewed by five and then two independent reviewers with fix passes applied. Kit harness ALL GREEN in both themes for both artifacts (106 PASS, 0 FAIL). CI on the previous head passed every job that ran to completion; the final head's CI was not observed at handoff. | kit harness check.mjs on both artifacts (ALL GREEN), prettier --check on every changed file, docs:check-links, check:mockups, check:diff-integrity, check:repo-awareness-snapshot; lint, typecheck, test and build left to CI as on the previous green head |