roadkeep-devlisted

# roadkeep — building and committing in this repository Trigger-loaded, and that is the whole reason it is a file (RK23, RK1136). `agents.md` is resident on **every** turn and holds a `[budgets]` ceiling that `lint` enforces (RK30); these twenty-six lines are needed on a turn that runs the tests or writes a commit, and were paid for by every turn that did neither. What is here is what that turn needs, in full — the budget these sentences were squeezed against is not this file's. ## Build and test - **Python ≥3.11** (`tomllib` is stdlib there; 3.13.14 here) and **zero runtime deps**: `argparse` + `tomllib`, never `click` + `pydantic` — a tool meant to run as `uvx roadkeep` in someone else's CI pays for every dependency it takes. - `uv` is **not** installed here. Run `python -m pytest` from the repo root, where `pythonpath = ["src"]` is already declared; the package is not installed, so every command in the plugin's own skill reads as `PYTHONPATH=src python -m roadkeep.cli <…>`. - Test dependencies are `pip install --user pytest pytest-xdist`. `-n auto` is on by default and `-n0` undoes it, which is what a test reading captured output wants. - Round-trip (L3) is a **property test over real files**: this repository's `docs/`, plus Shio's and Turing's at the revision `tests/corpora.py` pins. Absent or unpinnable, they skip — which is what CI does, and why a green run there proves less than a green run here. ## Editing source **Never edit source through a shell