docs(simulation): the firewall row named catalogue counts from two generations ago #1912

Merged
jaylouisw merged 1 commit from docs/1117-2245 into main 2026-11-17 22:50:42 +00:00
Owner

docs/SIMULATION.md �5.3, the ACL/firewall Absent row, said:

58 firewall models are catalogued and 217 device specs declare the capability

Both numbers were measured when the page was written (#74) and never re-checked. Against the catalogue at a93bf189 (loadCatalog(devices) � 2,351 specs, 258 vendors, matching the totals doc-catalog-counts asserts):

  • 64 specs are category: firewall (not 58)
  • 755 declare the firewall capability � 350 routers, 158 ptp, 97 wireless, 54 firewalls, 27 hosts, 23 ONTs, and the rest cameras/NAS/modems (not 217)

The sentence's actual claim � that no engine code reads the token � is still true, so only the counts were wrong. firewall sits in CAPABILITIES at engine/device.js:127 and test/capability-vocabulary.test.js still lists it as a pending unread token (engine/device.js:120-121 says the same); no grep firewall engine/ hit is a hasCap/indexOf reader.

The row's citation engine/device.js:90 now lands on this.mtu = 1500 in the interface constructor, 37 lines from the vocabulary � the same page already cites :127 for the identical claim further down. Moved to :127.

Docs-only, no code or catalogue touched.

Guards

  • node scripts/syntax-check.js � 399 files, all OK
  • docs-commands (test/docs-show-commands.test.js) � 7/0
  • docs-syntax (test/docs-cli-transcript.test.js) � 4/0
  • help-coverage (test/help-completeness.test.js) � 8/0
  • help-forms (test/no-form-help-key.test.js) � 81/0
  • test/help-key-works-in-every-prompt.test.js � 10/0
  • test/doc-catalog-counts.test.js � 43/43 current
  • check-control-bytes � clean; check-doc-citations � 348 citations, same 5 tolerated suspects as on main

All counts identical before and after: no suite reads this table row.

`docs/SIMULATION.md` �5.3, the ACL/firewall **Absent** row, said: > 58 firewall models are catalogued and 217 device specs declare the capability Both numbers were measured when the page was written (#74) and never re-checked. Against the catalogue at `a93bf189` (`loadCatalog(devices)` � 2,351 specs, 258 vendors, matching the totals `doc-catalog-counts` asserts): - **64** specs are `category: firewall` (not 58) - **755** declare the `firewall` capability � 350 routers, 158 ptp, 97 wireless, 54 firewalls, 27 hosts, 23 ONTs, and the rest cameras/NAS/modems (not 217) The sentence's actual claim � that no engine code reads the token � is still true, so only the counts were wrong. `firewall` sits in `CAPABILITIES` at `engine/device.js:127` and `test/capability-vocabulary.test.js` still lists it as a pending unread token (`engine/device.js:120-121` says the same); no `grep firewall engine/` hit is a `hasCap`/`indexOf` reader. The row's citation `engine/device.js:90` now lands on `this.mtu = 1500` in the interface constructor, 37 lines from the vocabulary � the same page already cites `:127` for the identical claim further down. Moved to `:127`. Docs-only, no code or catalogue touched. ### Guards - `node scripts/syntax-check.js` � 399 files, all OK - docs-commands (`test/docs-show-commands.test.js`) � 7/0 - docs-syntax (`test/docs-cli-transcript.test.js`) � 4/0 - help-coverage (`test/help-completeness.test.js`) � 8/0 - help-forms (`test/no-form-help-key.test.js`) � 81/0 - `test/help-key-works-in-every-prompt.test.js` � 10/0 - `test/doc-catalog-counts.test.js` � 43/43 current - `check-control-bytes` � clean; `check-doc-citations` � 348 citations, same 5 tolerated suspects as on main All counts identical before and after: no suite reads this table row.
docs(simulation): the firewall row's catalogue counts were two catalogue generations old (#74)
All checks were successful
CI / Classify the change (pull_request) Successful in 9s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 8s
CI / Server smoke test (pull_request) Has been skipped
CI / Docker build (pull_request) Has been skipped
CI / Test (Node 20) (pull_request) Successful in 49s
CI / Test (Node 18) (pull_request) Successful in 56s
CI / Test (Node 22) (pull_request) Successful in 53s
CI / Arm auto-merge (pull_request) Successful in 20s
6456de9824
58 firewall models and 217 declaring specs were measured when the page was
written. The catalogue is now 2,351 specs: 64 are category 'firewall' and 755
declare the capability (350 routers, 158 ptp, 97 wireless, 54 firewalls and the
rest hosts/ONTs/cameras). The claim the sentence makes - that engine/ reads
none of them - still holds: 'firewall' is listed in CAPABILITIES at
engine/device.js:127 and test/capability-vocabulary.test.js still records it as
a pending, unread token.

The citation moves from :90 (now the port's mtu initialiser) to :127, the line
that actually names the token, matching the same page's other reference to it.
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
jaylouisw/packetforge!1912
No description provided.