Skip to content

Make the trust-map explainer a verification explainer; remove the review flow - #29

Merged
theclaymethod merged 5 commits into
mainfrom
claude/strip-review
Oct 12, 2026
Merged

theclaymethod merged 5 commits into
mainfrom
claude/strip-review

Conversation

@theclaymethod

Copy link
Copy Markdown
Owner

The trust-map explainer now explains verification only. The review flow is gone: the checklist, the merge verdict, the approval checks, the review progress marks and the PR-section export.

Changes

  • Removed: ReviewStart, ReviewChecklist, ReviewVerdict, ApproveChecks, ReviewProgress and ChapterProgress; the rail's chapter marks; MergeVerdict with its gates and bugs panels; DiffSpine, FileCard, WhatChanged and UnclaimedChanges; trust-map.mjs (the PR-section export); and UnderstandingCheck (the general Quiz stays). About 2,830 lines fewer.
  • Kept: code refs with syntax and diff marks, WorkedExample, StepThrough, claim and check rows, BarCard, typed diagrams, DiagramModes, Disclosure, Term and Glossary, the paged shell with calm navigation, the fonts, the no-JS pre-render, and the general export checks (STE, copy rules, title-joins, bare lists, examples with provenance, no pasted code).
  • Moved: EvidenceGuide, VerifierView and ClaimTimeline now live in verification.tsx.
  • Minimal data: promises, bars and examples are optional. A map with no promises shows its claims weakest first.
  • Card: cards/trust-map.md is now a short "Verification explainer" card. It opens with a worked example, then gives the minimal contract.
  • Behaviour change: a typed-diagram element's chapter now links to #<id>.

Verification

Check Result
npm run check pass, 47.1 s (main: 45.1 s)
Fixture explainer, 1280 and 375, light and dark renders, no console errors, no sideways scroll

Open item: DESIGN.md still names the old fonts. That mismatch was there before this change.

🤖 Generated with Claude Code

theclaymethod and others added 4 commits October 11, 2026 19:26
Remove the components that only served understando's PR review: the start
panel, the checklist with the reviewer's calls in local storage and its
Markdown export, the verdict, the checks before you approve, the review and
chapter progress marks in the rail, the merge verdict with its gates and bug
panels, the diff spine with its file cards and Reviewed boxes, the older
what-changed and unclaimed-changes levels, the self-check questions, and the
PR-body section (trust-map.mjs pr-section).

Keep the claim, check and bar rows, the evidence guide, the claims and their
checks (now each claim's one detail, with its worked examples), the
invariants (now in view), the code refs with line marks, the typed diagrams
and the paged shell. The data contract takes a minimal shape: promises,
bars, check rows, test counts, examples and the diff are optional.

The fixture is now a verification explainer, and its browser tests check
the page, the minimal shape and the old map shape.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ract

Rewrite the trust-map card as a short card for a verification explainer:
one claim from the data to the page, the minimal data contract, the
components, the copy rules and the export checks. Update the component
reference, DESIGN.md and the design surface to match.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…no tier row

- A check reads as one sentence from its description and provenance
  ("Runs the overdraft refusal test (a contract check) from tests/test_core.py."); its ID is only in the trailing ref.
- The export check now finds glued fields: a name said twice in one sentence, and a colon-joined list of fields. The check block no longer skips the copy checks.
- "At the PR head", "Output at the PR head" and "Open these lines at the PR head" become "At <sha>: passed", "Output" and "Open these lines on GitHub" (the branch name for a ref on another branch).
- The "Strongest check" tier row is dropped: the Evidence row names the strongest check and its result.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@theclaymethod
theclaymethod marked this pull request as ready for review October 12, 2026 02:58
# Conflicts:
#	plugins/visual-explainer/assets/runtime.json.gz
@theclaymethod
theclaymethod merged commit 2ba4096 into main Oct 12, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant