| name | linting |
| description | Running the repo lint (nix run .#lint) and that the pre-commit hook and CI share the entry point. Use before committing or when a lint check fails. |
Linting
nix run .#lint
The tracked pre-commit hook runs the same lint app. CI runs the same check
through the flake. Keep one lint entry point so local and CI failures mean the
same thing.
For machine consumption (loading results as a dataframe rather than grepping
the log), nix run .#lint -- --json prints one JSON array with a record per
check — {check, ok, output}, where output carries the stage's diagnostics
on failure — and still exits nonzero when any check fails.
Always lint through nix run .#lint (or build the package), never an ad-hoc
nix shell nixpkgs#ruff -c ruff check. The flake pins ruff and passes a fixed
--target-version; an ambient ruff is a different version with a different
default target, so version-gated rules (e.g. UP041, PERF203) fire in one and
not the other. A check that passes ad-hoc can still fail the gate, and vice
versa.
