The deep dive's verified figures are re-derived by a test, or they are not on the line

[Shashankss1205]

Closes #42.

The rot

The Verified this pass paragraph quotes concrete numbers and nothing checked them, so they drifted — twice:

the page said	the tree had
1,533 passed … 103 submodules	1,754 tests, 116 submodules
1,985 passed, 12 deselected	2,137 selected, 13 live

Both were hand-corrected at the time; the mechanism that let them rot was still there.

The choice the issue offered, and which one this takes

The issue offered two: assert the figures, or remove them. This asserts them — the repo's stated discipline is that prose stating a checkable fact gets a check, the same one tests/test_readme.py and tests/test_cookbook_*.py already enforce by byte-comparing output.

But it rewords first, and the reword is the substance, not cosmetics: the figures are now what one command re-derives — how many tests pytest selects, and how many it holds back as live — rather than a pass count. A pass count cannot be re-derived without running the suite from inside itself, which is precisely how "1,985 passed" came to be a number no test owned. The suite being green is asserted by the suite being green.

How it re-derives

One collection pass in a subprocess. In-process is not an option — this module is collected by the session doing the asking, and re-entering the collector from inside it is not supported. -m "" clears the -m 'not live' that pyproject's addopts supplies, and the marker is read off each item, so a single pass yields both figures rather than two passes yielding one each. Cost: ~2s.

Two guards behind the two comparisons

Both close ways a check can pass while proving nothing:

• test_the_paragraph_still_quotes_every_figure_this_file_checks — deleting a number from the sentence makes the test red rather than vacuous. Same trap test_the_section_still_holds_the_two_blocks_this_file_checks closes for the README.
• test_the_paragraph_quotes_no_figure_that_nothing_re_derives — any bare count with a unit that this file does not own fails, with wording that says to add a check or take it off the line. This is what stops the next "1,985 passed" from being added.

The version the paragraph claims is on PyPI is held against pyproject.toml, for the same reason ci.yml already refuses a grapharc.__version__ that disagrees with it.

Verification

• uv run pytest tests/test_deep_dive.py — 5 passed.
• uv run ruff check grapharc tests — clean.
• Restoring the exact historical drift (1,985 passed, 12 selected) turns two red: the selection comparison and the unowned-figure guard.

🤖 Generated with Claude Code