Commit 62a137b
docs(pm): express the entry guard's self-test size as a floor, not a reading (#14002)
The docblock above the `--self-test` entry guard carried two figures frozen at
PR #9897 and both had rotted:
* "THIS file's 77 assertions" read as a present-tense claim about this
file's current suite. It printed 77 at PR #9897 and prints 255 today — a
factor of 3.3.
* "the same reason line 810 carries it" pointed at the sibling
main-invocation guard, which really was line 810 at PR #9897. Line 810 is
now an unrelated `try {` inside the regeneration predicate; the guard has
moved to line 2336.
Writing today's numbers would re-freeze the same defect one value later, so
the 77 is now anchored to PR #9897 as the historical fact it is, today's size
is a FLOOR ("more than three times that") stated as a floor on purpose and
pointing at `--self-test`'s `checked` as the live reading, and the line number
is replaced by a reference to the guard itself, which cannot drift.
Measured before choosing the shape, on this file's own history rather than
inherited from the sibling: across all 13 commits that have ever touched it
(introduced 2026-08-18, never renamed), the static `assert(` count went up 10
times, held flat twice, and has never once gone down (22 -> 248 static). The
counting method reproduces the two independent readings on record — 70 static
at a065e46 and 223 at 9c4c431.
The runtime figure is not even constant across environments, which is a second
reason a floor beats a reading: `--self-test` prints 255 in an installed tree
and 253 without node_modules, where the generator-provenance row fails closed
and says so on its `live:` line. Both readings are green and truthful.
No behaviour change: the guard and the self-test are untouched, and the count
is identical before and after this commit (255 at the merge base, 255 here).
Claude-Session: https://claude.ai/code/session_01Msg17tAHJ3jVTYFgHydCm2
Co-authored-by: Claude <noreply@anthropic.com>1 parent 0f12e32 commit 62a137b
1 file changed
Lines changed: 17 additions & 7 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
3498 | 3498 | | |
3499 | 3499 | | |
3500 | 3500 | | |
3501 | | - | |
3502 | | - | |
3503 | | - | |
3504 | | - | |
3505 | | - | |
3506 | | - | |
3507 | | - | |
| 3501 | + | |
| 3502 | + | |
| 3503 | + | |
| 3504 | + | |
| 3505 | + | |
| 3506 | + | |
| 3507 | + | |
| 3508 | + | |
| 3509 | + | |
| 3510 | + | |
| 3511 | + | |
| 3512 | + | |
| 3513 | + | |
| 3514 | + | |
| 3515 | + | |
| 3516 | + | |
| 3517 | + | |
3508 | 3518 | | |
3509 | 3519 | | |
3510 | 3520 | | |
0 commit comments