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 runspjangler audit --jsonand 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
failrows and note which arefixable. 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 — withTOAD_ALLOW_LIVE=1and confirmation — re-run withapply:true. - Re-audit to confirm parity improved.
Safety
- Audit is read-only — always safe.
project_migratewithapply:truemutates the repo; it is refused unlessTOAD_ALLOW_LIVE=1. Dry-run first, confirm, then apply.