Quality gates

just is the shared repo validation entrypoint.

Standard check

Run before packaging or committing:

bash

just check

On Unix-like hosts this covers formatting, shell linting, source-only render smoke tests, whitespace checks, and secret scanning.

Use focused checks when changing a narrow area:

bash

python3 scripts/validate-codex-config.py
python3 tests/test_codex_hooks.py
scripts/smoke-test.sh --source-only
pnpm docs:build

Shell script edits should stay clean under:

bash

shfmt -d scripts/*.sh home/dot_local/bin/executable_*
shellcheck scripts/*.sh home/dot_local/bin/executable_*

For broad prose, metadata, or docs changes:

bash

just lint-extra