test(docs): consistency checks between the docs and the code, refresh stale CI count comments

tests/test_docs_consistency.py (stdlib only, reads files, no process or network modules):
- README anchor links resolve (GitHub slug rule pinned), code fences balanced
- every README "## " section and the key features are linked from the TOC
- newest changelog entry is the 11/4/26 one
- every route registered with routes.get/post is in ProjectStructure.md (method + path)
- the file map lists every root .py, web/ file, resources/ file, tests/e2e, tests/js,
  examples, tests.yml and names no .py that does not exist
- every ultimate_grid.* event sent by the code is in Server Event Types (+ sweep phase payload)
- html_generator.js_files ends with logic_standalone.js and is listed in the docs
- no stale convertStateToConfigs / network_utils.py mentions
- CONTRIBUTING.md names every CI job id and the CI flags

tests.yml: comment-only edit, the "# expect:" counts now match the measured
499 passed / 16 skipped (stub leg).

Note: the docs checks are expected to be red at this commit; the next commit
(docs) makes them green.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
Jason Hoku
2026-11-04 01:05:17 -08:00
co-authored by Claude Fable 5.1
parent 525733d70b
commit ecf28d45aa
2 changed files with 203 additions and 2 deletions
+2 -2
View File
@@ -26,7 +26,7 @@ jobs:
- run: pip install -r tests/requirements-ci.txt
- name: Assert torch is NOT installed (this leg tests the stub path)
run: python -c "import importlib.util,sys; sys.exit(importlib.util.find_spec('torch') is not None)"
# expect: 137 passed, 15 skipped (the requires_torch tests)
# expect: 499 passed, 16 skipped (the requires_torch tests), measured 11/4/26
- run: python -m pytest tests/ -q -ra --ignore=tests/e2e
pytest-torch:
@@ -46,7 +46,7 @@ jobs:
run: pip install torch --index-url https://download.pytorch.org/whl/cpu
- run: pip install -r tests/requirements-ci.txt
- run: python -c "import torch; print(torch.__version__); assert hasattr(torch, 'inference_mode')"
# expect: 152 passed, 0 skipped
# expect: 515 passed, 0 skipped (the stub leg's passed + skipped; the torch leg itself is not measured locally)
- run: python -m pytest tests/ -q -ra --ignore=tests/e2e
js-syntax: