docs: document theory-aligned pathing workflow

This commit is contained in:
BruceChen 2026-04-14 11:15:32 +00:00
parent f065d62926
commit 2f65594077
4 changed files with 37 additions and 0 deletions

View file

@ -1,5 +1,10 @@
# Theory Matrix
## Canonical live coverage
This file is generated from `tools/sim_jump_reach.py` and is the first-wave authority
for theory-aligned linear, neo, and headhitter live suites.
| family | subfamily | movement_mode | case_id | expected_reachable | margin |
| --- | --- | --- | --- | --- | --- |
| linear | flat | walk | linear-flat-walk-mm12-gap0-dy0p0 | True | 5.422586344756974 |

View file

@ -36,6 +36,11 @@ def write_theory_artifacts(
lines = [
"# Theory Matrix",
"",
"## Canonical live coverage",
"",
"This file is generated from `tools/sim_jump_reach.py` and is the first-wave authority",
"for theory-aligned linear, neo, and headhitter live suites.",
"",
"| family | subfamily | movement_mode | case_id | expected_reachable | margin |",
"| --- | --- | --- | --- | --- | --- |",
]

View file

@ -1,4 +1,5 @@
import unittest
from pathlib import Path
from tools.pathing_theory.simulator import build_theory_cases
@ -22,6 +23,10 @@ class PathingTheoryMatrixTests(unittest.TestCase):
self.assertTrue(linear_boundary.expected_reachable)
self.assertGreater(linear_boundary.margin, 0.0)
def test_theory_markdown_mentions_canonical_live_coverage(self) -> None:
markdown = Path("tools/pathing_data/theory-matrix.md").read_text(encoding="utf-8")
self.assertIn("Canonical live coverage", markdown)
if __name__ == "__main__":
unittest.main()