| name | toad-audit-project |
| description | Audit an existing project against the pjangler parity rules and migrate the fixable ones. Use to check whether a project conforms to the latest pjangler/33GOD spec and to bring a legacy project up to standard. |
Toad — Audit & Migrate a Project
Checks a project against the pjangler parity rules and offers to migrate the
fixable ones. Auditing is read-only and safe; migration dry-runs first.
Flow
- Audit. Call
project_audit { repo } (defaults to cwd). It runs
pjangler audit --json and returns the parity rules, each with
{ id, title, status, fixable }, plus the count of failing rules.
- If audit returns no JSON, the repo may not be a git repo yet — report that
plainly rather than treating it as a crash.
- Summarize. Present the
fail rows and note which are fixable. Typical
rules: mise.config-root, mise.versioning, sot.agent-symlinks,
sot.project-json, secrets.env-op, provenance.copier, bmad.scaffold,
bmad.version, hermes.pm-scaffold, hermes.untracked-runtimes,
systemd.sentinel.
- Offer migration. For fixable failures, call
project_migrate { rule: "--all", repo } in dry-run first (default), show
what it would change, then — with TOAD_ALLOW_LIVE=1 and confirmation —
re-run with apply:true.
- Re-audit to confirm parity improved.
Safety
- Audit is read-only — always safe.
project_migrate with apply:true mutates the repo; it is refused unless
TOAD_ALLOW_LIVE=1. Dry-run first, confirm, then apply.
