Skip to content

docs(agents): add npm run audit to AGENTS.md command tables #28

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dhruva-reddy merged 1 commit into from
May 13, 2026
Merged

docs(agents): add npm run audit to AGENTS.md command tables #28

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/<org-a>/` and `resources/<org-b>/` |
| Deploy local changes (default) | `npm run apply -- <org>` — pull → merge → push, safe against dashboard drift |
| Pre-flight schema check (no network) | `npm run validate -- <org>` — run before every `apply` |
| Audit state/dashboard drift (read-only) | `npm run audit -- <org>` — orphans, ghosts, content-identical clusters, inline-tools. Exit 1 on findings. |
| Pull latest from Vapi | `npm run pull -- <org>`, `--force`, or `--bootstrap` |
| Pull one known remote resource | `npm run pull -- <org> --type assistants --id <uuid>` |
| Deploy a single file | `npm run apply -- <org> resources/<org>/assistants/my-agent.md` |
Expand Down Expand Up @@ -813,6 +814,8 @@ npm run push -- <org> --dry-run # Preview without applying an
npm run push -- <org> --strict # Abort push if any validator returns an error
npm run apply -- <org> # Pull then push (full sync)
npm run validate -- <org> # Lint resources locally (fails fast on schema drift)
npm run audit -- <org> # 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 -- <org> --type assistants # Scope audit to a single resource type
npm run sim -- <org> --suite <name> --target <name> # Run a simulation suite against an assistant/squad
npm run rollback -- <org> --to <ISO-timestamp> # Re-apply a snapshot taken before a push
npm run rollback -- <org> --list # List available snapshots
Expand Down