boshu2__agentops/docs/cli-surface.md

ao CLI Command Surface

Generated by scripts/check-cmdao-surface-parity.sh --write-surface. Do not edit command rows manually.

Command	Category	Coverage	Reason
ao agents doctor	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao agents inspect	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao agents lint	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao anti-patterns	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao autodev init	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao autodev show	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao autodev validate	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao badge	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao beads audit	public-stateful-fixture-needed	allowlisted	Requires a beads database fixture; auto-close mode mutates issue state.
ao beads cluster	public-stateful-fixture-needed	allowlisted	Requires a beads database fixture; apply mode mutates issue parents.
ao beads harvest	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao beads lint	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao beads verify	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao codex ensure-start	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao codex ensure-stop	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao codex start	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao codex status	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao codex stop	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao compile	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao completion	public-tested	allowlisted	Framework completion root; subcommand generation has focused tests.
ao config models	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao constraint activate	public-tested	allowlisted	Covered by constraint list smoke behavior.
ao constraint list	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao constraint retire	public-tested	allowlisted	Covered by constraint list smoke behavior.
ao constraint review	public-tested	allowlisted	Covered by constraint list smoke behavior.
ao contradict	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao corpus fitness	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao curate catalog	public-tested	allowlisted	Covered by curate command tests.
ao curate status	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao curate verify	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao daemon events tail	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao daemon jobs cancel	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao daemon jobs list	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao daemon jobs show	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao daemon jobs submit	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao daemon jobs wait	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao daemon ready	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao daemon run	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao daemon service install	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao daemon soak	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao daemon status	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao dedup	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao defrag	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao demo	manual-only	allowlisted	Interactive council-first demonstration requires a TTY.
ao doctor	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao eval baseline	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao eval baseline-audit	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao eval cleanup	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao eval compare	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao eval coverage	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao eval run	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao eval scorecard	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao eval suite n-required	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao eval suite verdict	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao eval task add	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao eval task list	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao eval task run	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao eval task show	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao evolve	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao extract	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao factory pilot	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao factory start	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao feedback-loop	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao findings export	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao findings list	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao findings pull	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao findings retire	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao findings stats	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao flywheel close-loop	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao flywheel compare	public-stateful-fixture-needed	allowlisted	Requires primary and shadow metric fixtures for meaningful comparison.
ao flywheel gate	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao flywheel nudge	public-tested	allowlisted	Covered by flywheel status smoke behavior.
ao flywheel status	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao forge batch	public-tested	allowlisted	Covered by batch forge tests.
ao forge markdown	public-tested	allowlisted	Covered by forge helper tests.
ao forge review	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao forge transcript	public-tested	allowlisted	Covered by forge helper tests.
ao gate approve	public-tested	allowlisted	Covered by gate command tests.
ao gate bulk-approve	public-tested	allowlisted	Covered by gate command tests.
ao gate pending	public-tested	allowlisted	Covered by gate command tests.
ao gate reject	public-tested	allowlisted	Covered by gate command tests.
ao goals add	public-stateful-fixture-needed	allowlisted	Writes GOALS.md and needs an isolated goal fixture.
ao goals drift	public-stateful-fixture-needed	allowlisted	Requires two goal snapshots to compare.
ao goals export	public-tested	allowlisted	Covered through goals measure snapshot behavior.
ao goals history	public-tested	allowlisted	Historical view shares goals validation behavior.
ao goals init	public-stateful-fixture-needed	allowlisted	Initializes GOALS.md and may prompt in an existing repo.
ao goals measure	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao goals meta	public-tested	allowlisted	Covered through goals measure behavior.
ao goals migrate	public-stateful-fixture-needed	allowlisted	Migrates GOALS.md format and needs a disposable fixture.
ao goals prune	public-stateful-fixture-needed	allowlisted	Removes stale goal entries and needs a disposable fixture.
ao goals steer add	public-stateful-fixture-needed	allowlisted	Writes GOALS.md and needs an isolated goal fixture.
ao goals steer prioritize	public-stateful-fixture-needed	allowlisted	Writes GOALS.md and needs an isolated goal fixture.
ao goals steer remove	public-stateful-fixture-needed	allowlisted	Writes GOALS.md and needs an isolated goal fixture.
ao goals validate	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao handoff	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao harvest	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao help	internal-hidden	allowlisted	Built-in Cobra help dispatcher with no application handler.
ao hooks init	public-tested	allowlisted	Covered by hook helper tests.
ao hooks install	public-tested	allowlisted	Covered by hook helper tests.
ao hooks run	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao hooks show	public-tested	allowlisted	Covered by hook helper tests.
ao hooks test	public-tested	allowlisted	Covered by hook helper tests.
ao init	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao inject	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao knowledge activate	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao knowledge beliefs	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao knowledge brief	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao knowledge gaps	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao knowledge playbooks	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao lookup	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao maturity	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao memory sync	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao metrics baseline	public-tested	allowlisted	Covered by metrics command tests.
ao metrics cite	public-tested	allowlisted	Covered by metrics command tests.
ao metrics cite-report	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao metrics health	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao metrics report	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao mind all	public-tested	allowlisted	Covered by mind subcommand tests.
ao mind graph	public-tested	allowlisted	Covered by mind subcommand tests.
ao mind index	public-tested	allowlisted	Covered by mind subcommand tests.
ao mind link	public-stateful-fixture-needed	allowlisted	Writes wikilinks through the Python mind tool.
ao mind normalize	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao mind scan	public-tested	allowlisted	Covered by mind command argument construction tests.
ao mine	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao notebook update	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao overnight curator compact	unsafe-live	allowlisted	Executes a configured local curator worker script.
ao overnight curator diagnose	manual-only	allowlisted	Depends on local curator, runner, and Ollama environment.
ao overnight curator enqueue	public-stateful-fixture-needed	allowlisted	Writes jobs into a configured local curator queue.
ao overnight curator event	public-stateful-fixture-needed	allowlisted	Appends events to a configured local curator ledger.
ao overnight curator status	manual-only	allowlisted	Depends on local curator, runner, and Ollama environment.
ao overnight report	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao overnight setup	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao overnight start	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao overnight warn-only reset	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao plans diff	public-tested	allowlisted	Covered by plans command tests.
ao plans list	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao plans register	public-tested	allowlisted	Covered by plans command tests.
ao plans search	public-tested	allowlisted	Covered by plans command tests.
ao plans sync	public-tested	allowlisted	Covered by plans command tests.
ao plans update	public-tested	allowlisted	Covered by plans command tests.
ao pool auto-promote	public-tested	allowlisted	Covered by pool command tests.
ao pool batch-promote	public-tested	allowlisted	Covered by batch promote tests.
ao pool ingest	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao pool list	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao pool migrate-legacy	public-tested	allowlisted	Covered by pool legacy migration tests.
ao pool promote	public-tested	allowlisted	Covered by pool command tests.
ao pool reindex	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao pool reject	public-tested	allowlisted	Covered by pool command tests.
ao pool show	public-tested	allowlisted	Covered by pool command tests.
ao pool stage	public-tested	allowlisted	Covered by pool command tests.
ao quick-start	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao ratchet check	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao ratchet find	public-tested	allowlisted	Covered through search and inject command behavior.
ao ratchet migrate	public-stateful-fixture-needed	allowlisted	Migrates legacy ratchet artifacts.
ao ratchet migrate-artifacts	public-stateful-fixture-needed	allowlisted	Adds frontmatter to .agents artifacts.
ao ratchet next	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao ratchet promote	public-stateful-fixture-needed	allowlisted	Promotes artifact state across tiers.
ao ratchet record	public-stateful-fixture-needed	allowlisted	Records workflow step completion.
ao ratchet skip	public-stateful-fixture-needed	allowlisted	Records intentional skip state.
ao ratchet spec	public-tested	allowlisted	Covered through ratchet status behavior.
ao ratchet status	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao ratchet trace	public-tested	allowlisted	Covered through trace command behavior.
ao ratchet validate	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao retrieval-bench	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao rpi cancel	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao rpi cleanup	public-tested	allowlisted	Covered by rpi cleanup tests.
ao rpi loop	unsafe-live	allowlisted	Autonomous loop is long-running and state-modifying.
ao rpi mark-probed	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao rpi nudge	unsafe-live	allowlisted	Requires an active RPI tmux session.
ao rpi parallel	unsafe-live	allowlisted	Parallel orchestration is long-running and state-modifying.
ao rpi phased	unsafe-live	allowlisted	Full RPI lifecycle orchestration is long-running and state-modifying.
ao rpi serve	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao rpi status	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao rpi stream	unsafe-live	allowlisted	Requires an active RPI run event stream.
ao rpi verify	public-tested	allowlisted	Covered by RPI status and verification tests.
ao scenario add	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao scenario init	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao scenario list	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao scenario validate	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao schedule add	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao schedule list	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao schedule remove	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao schedule run	manual-only	missing	No smoke, direct test, or allowlist coverage found.
ao scope freeze	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao scope status	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao scope unfreeze	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao search	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao seed	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao session close	public-tested	allowlisted	Covered by session close tests.
ao sessions index	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao skills check	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao status	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao trace	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao version	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao vibe-check	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao watch	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.