repolint

Overview ¶

Command repolint runs the repository-layout lint checks defined in pkg/repolint against the canonical paths of this repo. It is invoked by .githooks/pre-commit and the Lint job in .github/workflows/ci.yml.

Exit codes:

0 — all checks passed
1 — one or more checks failed (caller should NOT proceed)
2 — internal error (bad invocation, repo structure missing, etc.)

Usage:

repolint                       # run all checks against the repo root
repolint -repo /path           # run checks against an alternate root
repolint -fix-drift            # also: copy api/migrations/ → charts/llmsafespaces/migrations/
repolint -fix-worklogs         # also: auto-renumber duplicate worklog files, then run all checks
repolint -fix-worklogs-only    # ONLY auto-renumber; skip checks. For .githooks/post-rewrite
                               # where the tree may be mid-rebase and checks would be noisy.
repolint -cluster-drift        # also: compare deployed CRDs on the current kubeconfig
                               # context against the chart YAMLs. Off by default — requires
                               # a reachable cluster, so unsuitable for pre-commit/CI
                               # without one. Run after `make helm-deploy` to verify the
                               # CRD apply step actually landed.