docs(simulation): the claims audit printed counts its own commands contradict #1914
No reviewers
Labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
jaylouisw/packetforge!1914
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "docs/1117-2316"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
docs/SIMULATION.md�11 exists to stop the other pages overstating the code. Two of the counts it states had themselves gone stale, and the page prints the commands that contradict them.What was untrue
2,348 models across 258 vendors� the catalogue command printed two lines below it now answersmodels 2351 vendors 258 categories 25, andnode scripts/regen-registry-doc.js --checksays "The catalogue pages are current: 2,351 models across 258 vendors". �1 of the same page (the firewall row, fixed today in #1912) already said 2,351, so the page contradicted itself as well as the tree.eighteen mechanisms today�test/help-completeness.test.jsenumerates nineteen and prints19 mechanisms are all implemented, all inhelp, and all indocs/CLI.md``.ip routing(#1869) is the mechanism the sentence did not count.Evidence
Why it drifted unguarded:
test/doc-catalog-counts.test.jsasserts the catalogue counts in the generated pages (DEVICE_REGISTRY, README, CONNECTORS, wiki) and reads no line of SIMULATION.md;help-completenessreadsdocs/CLI.mdonly. The page is hand-written prose about measured code, so nothing was watching the two numbers it tells the reader to trust.Docs only � no engine, test or workflow change. Guards before and after are identical (nothing reads these lines yet).
`docs/SIMULATION.md` §11 tells the reader to measure the tree rather than trust a number, prints the two commands that do it, and then stated two counts neither command has produced for several merges: * **2,348 models across 258 vendors** -> the page's own catalogue command now prints `models 2351 vendors 258 categories 25`, and `node scripts/regen-registry-doc.js --check` agrees ("2,351 models across 258 vendors"). §1 of the same page already said 2,351, so the page contradicted itself as well as the tree. * **eighteen mechanisms today** -> `test/help-completeness.test.js` enumerates nineteen and prints "19 mechanisms are all implemented"; `ip routing` (#1869) is the addition the sentence did not count. Both were unguarded: `test/doc-catalog-counts.test.js` checks the generated catalogue pages (registry, README, CONNECTORS, wiki) but reads no line of this page, and `help-completeness` reads `docs/CLI.md` only. Numbers are now the ones the code states, and the mechanism count says where it comes from.