toad-audit-project

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

1. 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.
2. 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.
3. 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.
4. 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.