Files
boshu2__agentops/docs/cli-surface.json
T
Bo bb8d747d3a feat(ao): add harness-neutral bead ports (#810)
## Summary
- add harness-neutral BR/git ports: `ao ready`, `ao close ...`, and bare
`ao claim <id>` while preserving `ao claim bind/list`
- keep top-level gate commands from #809 as the shared gate surface; `ao
close` reuses the typed commit-persist close path and returns success
when the ledger already proves the bead is closed
- regenerate command docs, command surface inventory, matrix counts, and
registry metadata

## Validation
- `go test ./cmd/ao -run TestTick -count=1`
- `bash scripts/regen-all.sh && bash scripts/regen-all.sh --check`
- `go test ./cmd/ao -count=1`
- `go vet ./...`
- `go test ./... -count=1 -short`
- `git diff --check`
- `/tmp/ao-cp-ljp ready` from `/Users/bo/dev/control-plane` returned
`state_source=br`, `ready_count=20`, and counts `{ready:20, open:30,
in_progress:1, closed:19}`
- `/tmp/ao-cp-ljp claim cp-ljp` from `/Users/bo/dev/control-plane`
succeeded and did not dirty the Git ledger
- `PRE_PUSH_SKIP_MKDOCS=1 bash scripts/pre-push-gate.sh --fast` passed;
warning-only executable-spec drift remains pre-existing (`scenarios
--lint`, `trace --orphans`)

BR: cp-ljp
2026-06-07 02:03:39 -04:00

1765 lines
57 KiB
JSON

{
"categories": [
"public-tested",
"public-stateful-fixture-needed",
"internal-hidden",
"deprecated",
"unsafe-live",
"manual-only"
],
"commands": [
{
"category": "public-tested",
"command": "agent bundle",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "agents doctor",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "agents inspect",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "agents lint",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "anti-patterns",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "autodev init",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "autodev show",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "autodev validate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "badge",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "beads audit",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Requires a beads database fixture; auto-close mode mutates issue state."
},
{
"category": "public-stateful-fixture-needed",
"command": "beads cluster",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Requires a beads database fixture; apply mode mutates issue parents."
},
{
"category": "public-tested",
"command": "beads harvest",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "beads lint",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "beads resume",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "beads scenarios extract",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "beads scenarios validate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "beads stale-claims",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "beads verify",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "canon cite",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Requires an isolated canon ledger and citation fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "canon promote",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Mutates canon promotion state and needs a disposable canon fixture."
},
{
"category": "public-tested",
"command": "canon status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "canon verify",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Verifies canon evidence against repo-local canon fixtures not present in release smoke."
},
{
"category": "public-tested",
"command": "capabilities",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "chaos-test",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "manual-only",
"command": "ci latest",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Depends on live remote CI state; command smoke coverage needs a mocked GitHub/CI fixture."
},
{
"category": "manual-only",
"command": "ci recent",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Depends on live remote CI state; command smoke coverage needs a mocked GitHub/CI fixture."
},
{
"category": "public-tested",
"command": "citation verify",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "claim bind",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "claim list",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Reads claim-evidence stores and needs an isolated claim fixture."
},
{
"category": "public-tested",
"command": "close",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "codex ensure-start",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "codex ensure-stop",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "codex start",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "codex status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "codex stop",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "compile",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "completion",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Framework completion root; subcommand generation has focused tests."
},
{
"category": "public-tested",
"command": "config models",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "constraint activate",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by constraint list smoke behavior."
},
{
"category": "public-tested",
"command": "constraint list",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "constraint retire",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by constraint list smoke behavior."
},
{
"category": "public-tested",
"command": "constraint review",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by constraint list smoke behavior."
},
{
"category": "public-tested",
"command": "contradict",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "corpus capture",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "corpus fitness",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "corpus inject",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "corpus restore",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Restores corpus snapshots and needs a disposable corpus fixture."
},
{
"category": "public-tested",
"command": "corpus snapshot",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "council-gate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "cron self-adjust",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "curate catalog",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by curate command tests."
},
{
"category": "public-tested",
"command": "curate status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "curate verify",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "dedup",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "defrag",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "manual-only",
"command": "demo",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Interactive demonstration requires a TTY."
},
{
"category": "public-stateful-fixture-needed",
"command": "doctor capabilities",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Inspects local installation capabilities and needs a controlled home/repo fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "doctor diff",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Compares local installation state and needs a controlled home/repo fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "doctor explain",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Explains doctor findings from local state and needs a controlled findings fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "doctor fix",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Mutates local installation state and needs an isolated repair fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "doctor gc",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Prunes local doctor artifacts and needs an isolated artifact fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "doctor health",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Inspects local health state and needs a controlled home/repo fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "doctor ls",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Lists local doctor-managed artifacts and needs a controlled home/repo fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "doctor robot-docs",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Generates robot docs from local state and needs a controlled output fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "doctor undo",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Reverts doctor fixes and needs an isolated undo fixture."
},
{
"category": "public-tested",
"command": "eval baseline",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "eval baseline-audit",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "eval cleanup",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "eval compare",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "eval coverage",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "eval outcomes compile",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Holdout-safe rubric projection; core logic unit-tested (eval_outcomes_test.go compileOutcomesRubric); CLI smoke needs an input.json fixture (follow-up)."
},
{
"category": "public-stateful-fixture-needed",
"command": "eval outcomes ingest",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Maps an Outcomes score to the council verdict record; core logic unit-tested (eval_outcomes_ingest_test.go ingestOutcomesScore); CLI smoke needs a score.json fixture (follow-up)."
},
{
"category": "public-tested",
"command": "eval run",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "eval scorecard",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "eval suite n-required",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Computes eval-suite thresholds and needs a representative suite fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "eval suite verdict",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Projects eval-suite verdicts and needs a representative suite fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "eval task add",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Mutates eval task manifests and needs a disposable eval fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "eval task list",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Reads eval task manifests and needs a representative eval fixture."
},
{
"category": "public-tested",
"command": "eval task run",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "eval task show",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Reads eval task manifests and needs a representative eval fixture."
},
{
"category": "public-tested",
"command": "extract",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "feedback-loop",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "findings export",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "findings list",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "findings pull",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "findings retire",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "findings stats",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "flywheel close-loop",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "flywheel compare",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Requires primary and shadow metric fixtures for meaningful comparison."
},
{
"category": "public-tested",
"command": "flywheel gate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "flywheel nudge",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by flywheel status smoke behavior."
},
{
"category": "public-tested",
"command": "flywheel status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "forge batch",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by batch forge tests."
},
{
"category": "public-tested",
"command": "forge markdown",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by forge helper tests."
},
{
"category": "public-tested",
"command": "forge review",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "forge transcript",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by forge helper tests."
},
{
"category": "public-tested",
"command": "gate approve",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by gate command tests."
},
{
"category": "public-tested",
"command": "gate bulk-approve",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by gate command tests."
},
{
"category": "public-tested",
"command": "gate pending",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by gate command tests."
},
{
"category": "public-tested",
"command": "gate reject",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by gate command tests."
},
{
"category": "public-tested",
"command": "gate run",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "goals add",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Writes GOALS.md and needs an isolated goal fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "goals drift",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Requires two goal snapshots to compare."
},
{
"category": "public-tested",
"command": "goals export",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered through goals measure snapshot behavior."
},
{
"category": "public-tested",
"command": "goals history",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Historical view shares goals validation behavior."
},
{
"category": "public-stateful-fixture-needed",
"command": "goals init",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Initializes GOALS.md and may prompt in an existing repo."
},
{
"category": "public-tested",
"command": "goals measure",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "goals meta",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered through goals measure behavior."
},
{
"category": "public-stateful-fixture-needed",
"command": "goals migrate",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Migrates GOALS.md format and needs a disposable fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "goals prune",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Removes stale goal entries and needs a disposable fixture."
},
{
"category": "public-tested",
"command": "goals render",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "goals scenarios",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "goals steer add",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Writes GOALS.md and needs an isolated goal fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "goals steer apply",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Mutates GOALS.md from steering recommendations and needs an isolated goal fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "goals steer prioritize",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Writes GOALS.md and needs an isolated goal fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "goals steer recommend",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Reads goal history and needs a representative goal fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "goals steer remove",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Writes GOALS.md and needs an isolated goal fixture."
},
{
"category": "public-tested",
"command": "goals trace",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "goals validate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "guard-status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "handoff",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "harness status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "harvest",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "internal-hidden",
"command": "help",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Built-in Cobra help dispatcher with no application handler."
},
{
"category": "public-tested",
"command": "init",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "inject",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "install-guards",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "knowledge activate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "knowledge beliefs",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "knowledge brief",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "knowledge gaps",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "knowledge playbooks",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "lookup",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "loop append",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "loop blocked",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "loop converged",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "loop history",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "loop hypothesis append",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Appends loop hypotheses and needs an isolated loop ledger fixture."
},
{
"category": "public-stateful-fixture-needed",
"command": "loop hypothesis list",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Reads loop hypotheses and needs a representative loop ledger fixture."
},
{
"category": "public-tested",
"command": "loop next-work",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "loop verify",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "loop write-stop-marker",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "maturity",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "mcp serve",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "memory sync",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "metrics baseline",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by metrics command tests."
},
{
"category": "public-tested",
"command": "metrics cite",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by metrics command tests."
},
{
"category": "public-tested",
"command": "metrics cite-report",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "metrics health",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "metrics report",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "mind all",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by mind subcommand tests."
},
{
"category": "public-tested",
"command": "mind graph",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by mind subcommand tests."
},
{
"category": "public-tested",
"command": "mind index",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by mind subcommand tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "mind link",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Writes wikilinks through the Python mind tool."
},
{
"category": "public-tested",
"command": "mind normalize",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "mind scan",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by mind command argument construction tests."
},
{
"category": "public-tested",
"command": "mine",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "next-work materialize",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "notebook update",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "operator list",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "operator record",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "orchestrate select",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Selects work from repo-local orchestration state and needs a controlled queue fixture."
},
{
"category": "public-tested",
"command": "patterns repair-filenames",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "pool auto-promote",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by pool command tests."
},
{
"category": "public-tested",
"command": "pool batch-promote",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by batch promote tests."
},
{
"category": "public-tested",
"command": "pool ingest",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "pool list",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "pool migrate-legacy",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by pool legacy migration tests."
},
{
"category": "public-tested",
"command": "pool promote",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by pool command tests."
},
{
"category": "public-tested",
"command": "pool reindex",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "pool reject",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by pool command tests."
},
{
"category": "public-tested",
"command": "pool show",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by pool command tests."
},
{
"category": "public-tested",
"command": "pool stage",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by pool command tests."
},
{
"category": "public-tested",
"command": "provenance add",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "provenance export",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "provenance list",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "provenance trace",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "quick-start",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "ratchet check",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "ratchet find",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered through search and inject command behavior."
},
{
"category": "public-stateful-fixture-needed",
"command": "ratchet migrate",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Migrates legacy ratchet artifacts."
},
{
"category": "public-stateful-fixture-needed",
"command": "ratchet migrate-artifacts",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Adds frontmatter to .agents artifacts."
},
{
"category": "public-tested",
"command": "ratchet next",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "ratchet promote",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Promotes artifact state across tiers."
},
{
"category": "public-stateful-fixture-needed",
"command": "ratchet record",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Records workflow step completion."
},
{
"category": "public-stateful-fixture-needed",
"command": "ratchet skip",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Records intentional skip state."
},
{
"category": "public-tested",
"command": "ratchet spec",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered through ratchet status behavior."
},
{
"category": "public-tested",
"command": "ratchet status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "ratchet trace",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered through trace command behavior."
},
{
"category": "public-tested",
"command": "ratchet validate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "ready",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "reconcile",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "redact",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "registry list",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Reads generated registry state and needs a representative registry fixture."
},
{
"category": "public-tested",
"command": "retrieval-bench",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "robot-docs",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "rpi cancel",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "rpi cleanup",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by rpi cleanup tests."
},
{
"category": "unsafe-live",
"command": "rpi loop",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Autonomous loop is long-running and state-modifying."
},
{
"category": "public-tested",
"command": "rpi mark-probed",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "unsafe-live",
"command": "rpi nudge",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Requires an active RPI tmux session."
},
{
"category": "unsafe-live",
"command": "rpi parallel",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Parallel orchestration is long-running and state-modifying."
},
{
"category": "unsafe-live",
"command": "rpi phased",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Full RPI lifecycle orchestration is long-running and state-modifying."
},
{
"category": "public-tested",
"command": "rpi serve",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "rpi status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "unsafe-live",
"command": "rpi stream",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Requires an active RPI run event stream."
},
{
"category": "public-tested",
"command": "rpi verify",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by RPI status and verification tests."
},
{
"category": "public-tested",
"command": "scenario add",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "scenario init",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "scenario list",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "scenario validate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "scope freeze",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "scope status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "scope unfreeze",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "search",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "seed",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "session bootstrap",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "session close",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Covered by session close tests."
},
{
"category": "public-tested",
"command": "sessions index",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "manual-only",
"command": "sessions spawn",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Spawns runtime sessions and requires live terminal/runtime state."
},
{
"category": "public-tested",
"command": "skills check",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "skills consumers",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "skills find",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "skills graph",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "skills list",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "skills producers",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "tick claim",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "tick close",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "tick council-gate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "tick guard-status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "tick install-guards",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "tick next",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "tick reopen",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "tick smoke",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "tick status",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "tick verdict-gate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "trace",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "turn verify",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "validate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "verdict-gate",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "version",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "vibe-check",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "wiki doctor",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "wiki index",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "wiki inject",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Reads and writes wiki/corpus state and needs an isolated wiki fixture."
},
{
"category": "public-tested",
"command": "wiki lint",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-tested",
"command": "wiki promote",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
},
{
"category": "public-stateful-fixture-needed",
"command": "wiki query",
"coverage_status": "allowlisted",
"kind": "leaf",
"reason": "Queries wiki/corpus indexes and needs a representative wiki fixture."
},
{
"category": "public-tested",
"command": "wiki search",
"coverage_status": "covered",
"kind": "leaf",
"reason": "Covered by release smoke tests, direct command tests, or command handler tests."
}
],
"generated_by": "scripts/check-cmdao-surface-parity.sh --write-surface",
"schema_version": 1
}