diff --git a/AGENTS.md b/AGENTS.md index bc4182a..69915a9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -62,6 +62,7 @@ If you're unsure where something goes, default to `docs/learnings/`. The README | Promote resources across orgs | Copy files between `resources//` and `resources//` | | Deploy local changes (default) | `npm run apply -- ` — pull → merge → push, safe against dashboard drift | | Pre-flight schema check (no network) | `npm run validate -- ` — run before every `apply` | +| Audit state/dashboard drift (read-only) | `npm run audit -- ` — orphans, ghosts, content-identical clusters, inline-tools. Exit 1 on findings. | | Pull latest from Vapi | `npm run pull -- `, `--force`, or `--bootstrap` | | Pull one known remote resource | `npm run pull -- --type assistants --id ` | | Deploy a single file | `npm run apply -- resources//assistants/my-agent.md` | @@ -813,6 +814,8 @@ npm run push -- --dry-run # Preview without applying an npm run push -- --strict # Abort push if any validator returns an error npm run apply -- # Pull then push (full sync) npm run validate -- # Lint resources locally (fails fast on schema drift) +npm run audit -- # Read-only drift detector: orphan YAML, state ghosts, content-identical clusters, sibling base-slugs, dashboard orphans, inline model.tools. Exit 1 on findings. +npm run audit -- --type assistants # Scope audit to a single resource type npm run sim -- --suite --target # Run a simulation suite against an assistant/squad npm run rollback -- --to # Re-apply a snapshot taken before a push npm run rollback -- --list # List available snapshots