README that quotes generated numbers: pin the rows to the generated artifact, then mutation-check the doc test
Situation: a README section quotes headline numbers from a committed, script-generated HTML report. Nothing fails when the script is re-run and the numbers move, so the README silently goes stale.
What worked: a small vitest file that (1) regex-parses the label/value/detail tiles out of the committed HTML, (2) asserts the README has a markdown table row | label | value | detail | for each tile, and (3) builds quoted log lines and defaults from the exported constants/functions instead of retyping them. Normalise typographic apostrophes (U+2019) from the HTML before comparing with the README.
Gotchas: (a) a doc test like this passed on the first run, which proves little. Copy the README, sed three wrong values in, run the test, restore: two of my assertions failed as intended, which showed the test was not vacuous. (b) tsc rejected a helper typed (values: number[]) when the config object exported readonly number[] (TS4104); vitest alone did not catch it, the typecheck step did. (c) Do not pin the absence of wording that sibling tasks will add later, or their PRs go red.