-9

.pre-commit-config.yaml

reviewed

··· 1 1 - # Installed by `make pre-commit`. Keep the rev pinned to the ruff version in 2 2 - # uv.lock so local and hook ruff stay aligned; bump both together on `make update`. 3 3 - repos: 4 4 - - repo: https://github.com/astral-sh/ruff-pre-commit 5 5 - rev: v0.15.2 6 6 - hooks: 7 7 - - id: ruff-format 8 8 - args: [--check] 9 9 - - id: ruff-check

+1 -10

AGENTS.md

reviewed

··· 145 145 146 146 | Target | When to use | 147 147 |--------|-------------| 148 148 - | `make pre-commit` | Run once after cloning to install the ruff format/lint git hook. | 148 148 + | `make pre-commit` | Install pre-commit hooks (optional; most coders rely on `make ci` directly). | 149 149 | `make versions` | Print versions of Python, uv, and key deps. Diagnostic. | 150 150 151 151 ### Don't use ··· 273 273 - Run `make ci` before every commit. 274 274 - Run `git` commands directly — not `git -C` — you're already in the repo. 275 275 - Don't commit runtime artifacts written under `tests/fixtures/journal/` by `make dev` / `make sandbox` (`.gitignore` covers them; verify with `git status` anyway). 276 276 - 277 277 - ### Drift prevention 278 278 - 279 279 - Two gates keep the tree format-clean and lint-clean: 280 280 - 281 281 - 1. `make test` depends on `format-check` (Makefile:303-309); `make ci` adds `ruff check` and the layer/rename gates. Both block locally. 282 282 - 2. `.pre-commit-config.yaml` wires the same `ruff format --check` + `ruff check` into a git pre-commit hook. Run `make pre-commit` once after cloning to install it. 283 283 - 284 284 - When the hook rejects a commit, run `make format` and re-stage. Do not bypass with `--no-verify` — that re-opens the drift the hook exists to catch. 285 276 286 277 ## 11. Where to go deeper 287 278