Skip to content

docs(site): check the example report line for line against its command - #23

Merged
TMHSDigital merged 1 commit into
mainfrom
docs/example-report-verified
Sep 22, 2026
Merged

TMHSDigital merged 1 commit into
mainfrom
docs/example-report-verified

Conversation

@TMHSDigital

Copy link
Copy Markdown
Owner

The README called docs/example-report.md "real, unedited output", and #21 hand-edited it. Until now the site build only compared the report's ECE line with a fresh run of its recorded command, so the claim wasn't enforced.

What I found. A fresh run of the recorded command reproduces all 49 report lines exactly, latency included: the mock's latencies are simulated from its seed. #21's hand edits are identical to what the code now prints. Two lines would differ in CI or on another day: Generated <date> and the dataset path, which the committed report wrote with Windows separators.

The check. build_site.py now compares every line of the committed report with the fresh run, after normalizing only those two things. On any difference it refuses and prints the line number with both versions. Tested locally: changing p50 37.7ms to 37.8ms is refused, and changing the date passes.

Wording.

  • README: the report "is the output of one seeded mock run, and CI holds it to that: on every change and before every deploy it reruns the report's recorded command and refuses if any line differs, other than the date."
  • The report's own preamble says the same.
  • The quoted ECE line is called "a real line", no longer "unedited".
  • The report's Date row now matches its Generated line (2026-09-22; the row said 2026-09-21).

🤖 Generated with Claude Code

The build compared only the ECE line, while the README called the whole report
"unedited" output. Every line is now compared with a fresh run of the recorded
command, with only the generation date and the dataset path's separators
normalized, and the README states that check instead.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
@TMHSDigital
TMHSDigital merged commit b809ab4 into main Sep 22, 2026
14 checks passed
@TMHSDigital
TMHSDigital deleted the docs/example-report-verified branch September 22, 2026 23:39
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