Code Standards

One deterministic quality gate for Sarj Python, TypeScript, Swift, Kotlin, shell, SQL, IaC, and repository policy.

uv tool install --python 3.14 code-standards

Contributing

Install uv 0.12.5, Python 3.14, Node 24.19, and GNU Make. Then bootstrap a fresh checkout:

make setup
make verify

Once a new rule and its tests are registered, stage it as a warning and validate it locally:

code-standards --root . maintain rules stage-warning python:no-string-concat-in-loop
code-standards --root . maintain rules evaluate --rule python:no-string-concat-in-loop --scope corpus
make verify

After committing the resulting changes, review the complete rule diff:

code-standards --root . maintain rules changes --before origin/main --after HEAD

Fleet calibration and downstream PR creation run automatically after review and release.

Documentation · Source