docs: restore remaining reviewed session follow-ups - #1510
Conversation
…he unpushed hook fix Three findings from the 2026-07-30 organisation session that were recorded nowhere durable: - #149 the session GitHub PAT lacks Checks: Read, so no agent can confirm a PR is green. The endpoint that does work returns an empty result rather than an error, so it reads like an absence of checks rather than an absence of permission. - #150 four worktrees on already-merged branches hold uncommitted work that exists in no branch and no PR, the largest being +395/-200 across 19 files including CI config. - #151 the pre-commit fail-open for #143 lives only on a never-pushed local branch, which is also 17 behind main and conflicts on the file whose count sentence main's new docs:update generator now owns. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Main resolved#148 via #1491 and moved it to the archive table, so its side of the open-items hunk was empty. Resolution keeps main's archival and re-adds only #149, #150 and #151; the next-id marker stays at 152, which is the value this branch allocated and is still above main's highest. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Correct archived #143: PR #1442 tracked the hook/script but did not land fail-open (pre-commit still invokes the inventory script at L97). #151 owns that remaining half and now says not to discard the unpushed branch. Separate #149's Checks: Read remedy from #132's missing-gh path. Merge origin/main so #148 stays archived from #1491. Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
#150 — the four at-risk worktrees were snapshotted onto their own already-merged branches (748ef018f, 5dbd9f965, b7eae51a4, d949859c3), so the work survives a worktree reclaim. All four are clean now. None is pushed or reviewed; the next action is per-snapshot promote-or-reset. #151 — the never-pushed branch is superseded rather than salvageable: its script and hook reached main by other routes, so the fail-open guard was applied to main's committed hook in PR #1494 instead. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
edits Another session reconciled the same three rows while this one snapshotted the worktrees. Resolution keeps this side for #149 and #150 (theirs carried no snapshot SHAs) and unions #151: their PR #1442 provenance plus the correction that the archived #143 row implied the fail-open was durable when only the hook and script had landed, kept alongside this side's redirect to PR #1494. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
PR #1463 merged as dba7356, so #86's "Next X3 unit — rag-hydration.ts" is now stale. The row records the extraction as shipped and keeps the corrected boundary: hydration re-homed only two of prepareCoverageGateResults's five rag.ts-only dependencies, so it did not unblock that function — exactly as the Codex review on PR #1461 predicted. This row was deliberately dropped from #1463 itself (commit 6290d02) after docs/outstanding-issues.md conflicted on five consecutive main syncs. Recording it separately here is the same pattern used for #1454 via #1461. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GGEBHp4Seoh1jK1vGTNtYS
Appended with npm run ledger:append (never hand-written), keyed to the squash commit dba7356 so ledger:lookup can resolve it. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GGEBHp4Seoh1jK1vGTNtYS
Both defects were raised by Codex on PR #1495 and both are real; verified against the files before accepting. 1. #101 is NOT this extraction. docs/outstanding-issues.md:138 shows #101 is "Canary-gated retrieval parallelisation candidates" (P3, rec) — a separate, still-open recommendation gated on a live canary pair. Calling the hydration extraction "#101" marked that unrelated work as shipped and could have caused the live-evaluation work to be skipped. The label came from the original task brief and was propagated without checking it against the ledger. Both the #86 row and the X3 work-order entry now identify the change as the X3 hydration unit (PR #1463) instead. #101's own row is untouched and still open. 2. The ledger row did not resolve. `npm run ledger:lookup -- dba7356` returned NOT REVIEWED, because the ref cell held only the slash-form branch token and that branch no longer resolves locally, so the throttling record could not prevent a repeat review. Appended a superseding record keyed to the landed SHA; the same lookup now returns ALREADY REVIEWED. The original row is retained, per the ledger's append-only rule. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GGEBHp4Seoh1jK1vGTNtYS
… seed it
`playwright.visual.config.ts` records snapshots under
`__screenshots__/{platform}/`, so a baseline taken on Windows lands in `win32/`
and is never consulted by the `ubuntu-24.04` CI job, which reads `linux/`.
Nothing said so, and committing `win32/` images looks like protection while
providing none.
Records the constraint, names the CI artifact as the supported recorder for
`linux/` baselines, and notes that comparison stays advisory until the jobs come
off `continue-on-error`. Also creates the tracked directory `.gitignore` already
claims exists, which sets `ui_changed=true` (`scripts/ci-change-scope.mjs`) so
the visual job can run and produce that first artifact.
No baselines are added here — they cannot be produced on this platform.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
PR #1494 landed the fail-open guard on main, so close the open salvage row and update the #143 archive from PARTIAL to resolved across #1442 and #1494. Also carries the merge of origin/main that cleared the GitHub DIRTY mergeability state. Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Main's #1496 reused #149/#150 for lock-parity scope and CodeRabbit spending-cap findings. Rebuild from main, keep those rows, archive #151 for the #1494 fail-open landing, and re-home this PR's open findings as #152 (CI Checks: Read) and #153 (merged-worktree WIP). Correct #143 to fully resolved across #1442+#1494. Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
PR #1510 is reopen-ready at Done
Key content fixes
No further unresolved review threads. Safe to reopen when you want. |
Supersede the prior approve-with-no-findings row after correcting the false #98 canary attribution and NOTES triage drift. Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
There was a problem hiding this comment.
Actionable comments posted: 4
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.design-sync/NOTES.md:
- Around line 84-89: Update the triage rule in the notes to say unresolved
var(--name) declarations become invalid at computed-value time and resolve to
the property’s initial or inherited value, replacing the inaccurate “dropped at
CSS parse time” wording while preserving the setter/fallback defect criteria.
In `@docs/branch-review-ledger.md`:
- Around line 332-345: Resolve the PR-1510 ledger lookup by replacing the
unresolvable ref “1510” with its full resolvable commit SHA, then rerun
ledger:lookup against that ref and append the resulting review record to the
branch-review ledger. Preserve the existing ledger and outstanding-issues guard
results.
In `@docs/outstanding-issues.md`:
- Around line 66-67: Update the queue-order value for the `#147` or `#033` entry in
the outstanding-issues table so each item has a unique order, while preserving
the surrounding rows’ ordering and keeping the numbering consistent.
- Line 129: In the `#098` row, remove the second duplicated completion block
beginning with “Done 2026-07-30 (PR `#1450`, `1bff4c78`)” and ending with the
repeated round-trip-counter blind-spot statement. Preserve the first identical
block and all subsequent search-budget findings and next steps unchanged.
🪄 Autofix (Beta)
❌ Autofix failed (check again to retry)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Run ID: 42a59e9a-2b14-4874-aec7-22809cc90cf3
📒 Files selected for processing (4)
.design-sync/NOTES.mddocs/branch-review-ledger.mddocs/outstanding-issues.mdsrc/components/favourites-page-mockups/favourites-library-redesign-page.tsx
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Note Autofix is a beta feature. Expect some limitations and changes as we gather feedback and continue to improve it. The branch was updated while autofix was in progress. Please try again. |
Co-authored-by: BigSimmo <BigSimmo@users.noreply.github.com>
Uh oh!
There was an error while loading. Please reload this page.


Summary
Areas touched
.design-sync/NOTES.mddocs/outstanding-issues.mddocs/branch-review-ledger.mdVerification
npm run check:outstanding-issues— passed: 156 rows, 47 open, 109 archived, next-id 159npm run check:branch-review-ledger— passed before the final review append: 286 live + 1206 archived recordsnpm run check:design-system-contract— passed: 614 production filesnpm run docs:check-links— passed: 1418 referencesnpm run docs:check-scripts— passed: 413 referencesnpm run docs:check-index— passednpm run format:changed— passednode ./node_modules/typescript/bin/tsc --noEmit— passedgit diff --check origin/main...HEAD— passedNot run
RAG impact: no retrieval behaviour change — documentation evidence only; protected retrieval source is unchanged.
Summary by CodeRabbit
Style
Documentation