Documentation
¶
Overview ¶
Command dev is the one developer tool behind the Makefile: every gate and generator that is not a Go service lives here as a subcommand, so `make <target>` is one line and nothing is CI-only (ci.yml and release.yml call the same targets a human runs).
go run ./tools/dev <subcommand> [args]
Subcommands: coverage, license-check, license-scan, ratchet-guard, modvalidate, k8s-check, pin-images, quickstart-compose, api-docs. Each prints its own usage on -h.
Command modvalidate is the module-artifact validator: it loads one or more module directories, validates every artifact against the module contract's reject list, and exits non-zero on the first batch that has any named error. Wired as `make validate-modules` (validates modules/*/) and into `make check`. A directory with no module.manifest.json is treated as a bare migrations tree (migrations/registry etc. — `make validate-migrations`): only the filename/order/ledger rules apply there.