Contributing

Build entrypoints

This repository supports both Makefile and Justfile as first-class interfaces.

Use either:

make help
just help

These commands list the supported build jobs and what each one does.

For normal local development, run mutators first and verification second:

make check-human
just check-human

That flow:

runs fix first so formatters and autofixers clean up the tree before slower checks
runs verify second using read-only checks

If you only want the mutating phase:

make fix
just fix

If you only want read-only verification:

make verify
just verify

For CI-safe, non-mutating verification:

make check-ci
just check-ci

For compact, token-efficient output:

make check-llm
just check-llm

To run read-only checks in parallel with collated logs:

make fast-verify
just fast-verify

Use triage as an alias for the same workflow.

For a correctness- and security-focused pass:

make bugs
just bugs

For easier debugging with serial execution:

make repro
just repro

fix-ci is read-only and checks that formatter-driven changes are not needed.
refresh-schema is intentionally opt-in because it is networked and mutating.
check-md now uses mdformat --check so markdown verification stays read-only.