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 capabilities	public-tested	allowlisted	Covered by capability contract tests.
ao completion	public-tested	allowlisted	Framework completion root has focused generation tests.
ao config	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao demo	manual-only	allowlisted	Interactive demonstration requires a TTY.
ao doctor capabilities	public-stateful-fixture-needed	allowlisted	Inspects local installation state.
ao doctor diff	public-stateful-fixture-needed	allowlisted	Compares local installation state.
ao doctor explain	public-stateful-fixture-needed	allowlisted	Requires controlled findings.
ao doctor fix	public-stateful-fixture-needed	allowlisted	Mutates local installation state.
ao doctor gc	public-stateful-fixture-needed	allowlisted	Prunes local doctor artifacts.
ao doctor health	public-stateful-fixture-needed	allowlisted	Inspects local health state.
ao doctor ls	public-stateful-fixture-needed	allowlisted	Lists local doctor artifacts.
ao doctor robot-docs	public-stateful-fixture-needed	allowlisted	Generates docs from local installation state.
ao doctor undo	public-stateful-fixture-needed	allowlisted	Reverts a doctor repair fixture.
ao eval baseline	public-tested	allowlisted	Promotion logic covered by internal/eval baseline tests; composition covered by cmd/ao eval tests.
ao eval baseline-audit	public-tested	allowlisted	Audit policy covered by internal/eval baseline_audit tests.
ao eval cleanup	public-tested	allowlisted	Covered by internal/eval cleanup_service tests.
ao eval compare	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao eval coverage	public-tested	allowlisted	Covered by internal/eval coverage tests.
ao eval outcomes compile	public-tested	allowlisted	Covered by evalsubstrate rubric tests and module tests.
ao eval outcomes ingest	public-tested	allowlisted	Covered by internal/eval outcomes_service tests.
ao eval run	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao eval scenario add	public-tested	allowlisted	Covered by internal/scenario and module tests.
ao eval scenario evaluate	public-tested	allowlisted	Covered by internal/eval scenario_service tests.
ao eval scenario init	public-tested	allowlisted	Covered by internal/scenario and module tests.
ao eval scenario list	public-tested	allowlisted	Covered by internal/scenario and module tests.
ao eval scenario validate	public-tested	allowlisted	Covered by internal/scenario and module tests.
ao eval scenario-ab	unsafe-live	allowlisted	Spawns a live model runtime (codex exec) per arm; exercised by adapter tests with fakes, never in smoke.
ao eval scenario-moat	unsafe-live	allowlisted	Aggregates live scenario-ab cards; adapter-tested with fixtures.
ao eval scorecard	public-tested	allowlisted	Covered by internal/eval scorecard tests.
ao eval suite n-required	public-tested	allowlisted	Covered by internal/eval suite_service and module tests.
ao eval suite verdict	public-tested	allowlisted	Covered by internal/eval suite_service and module tests.
ao eval task add	public-tested	allowlisted	Covered by internal/eval task_service and module tests.
ao eval task list	public-tested	allowlisted	Covered by internal/eval task_service and module tests.
ao eval task run	public-tested	allowlisted	Covered by internal/eval task_service and module tests.
ao eval task show	public-tested	allowlisted	Covered by internal/eval task_service and module tests.
ao flywheel compare	public-tested	allowlisted	Covered by internal/flywheelapp Compare tests after the flywheel carve-out.
ao flywheel status	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao gate check	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao goals drift	public-stateful-fixture-needed	allowlisted	Requires two goal snapshots.
ao goals export	public-tested	allowlisted	Covered through goals snapshot behavior.
ao goals history	public-tested	allowlisted	Historical view shares goals validation behavior.
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 measurement behavior.
ao goals render	public-tested	allowlisted	Covered by internal/goals render tests after the goals carve-out.
ao goals scenarios	public-tested	allowlisted	Covered by internal/commands/goals module tests and internal/goals scenario tests after the goals carve-out.
ao goals validate	public-tested	allowlisted	Covered by internal/commands/goals module tests and internal/goals validate tests after the goals carve-out.
ao help	internal-hidden	allowlisted	Built-in Cobra help dispatcher with no application handler.
ao init	public-tested	allowlisted	Covered by internal/commands/init module tests and internal/initapp tests after the init carve-out.
ao provenance add	public-tested	allowlisted	Covered by internal/commands/provenance module tests after the provenance carve-out.
ao provenance export	public-tested	allowlisted	Covered by internal/commands/provenance module tests after the provenance carve-out.
ao provenance list	public-tested	allowlisted	Covered by internal/commands/provenance module tests after the provenance carve-out.
ao provenance mine-session	public-tested	allowlisted	Covered by internal/provenanceapp mine-session tests after the provenance carve-out.
ao provenance position	public-tested	allowlisted	Covered by internal/commands/provenance module tests after the provenance carve-out.
ao provenance show	public-tested	allowlisted	Covered by generic provenance read tests.
ao provenance show	public-tested	allowlisted	Covered by internal/commands/provenance module tests after the provenance carve-out.
ao provenance trace	public-tested	allowlisted	Covered by internal/commands/provenance module tests after the provenance carve-out.
ao provenance verify	public-tested	allowlisted	Covered by internal/commands/provenance module tests after the provenance carve-out.
ao quick-start	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao redact	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao robot-docs	public-tested	allowlisted	Covered by generated documentation tests.
ao session bootstrap	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao session handoff	public-tested	allowlisted	Covered by handoff artifact tests.
ao session rehydrate	public-tested	allowlisted	Covered by rehydrate artifact tests.
ao skills check	public-tested	allowlisted	Covered by internal/commands/skills module tests after the skills carve-out.
ao skills consumers	public-tested	allowlisted	Covered by internal/commands/skills module tests after the skills carve-out.
ao skills find	public-tested	allowlisted	Covered by internal/commands/skills module tests after the skills carve-out.
ao skills graph	public-tested	allowlisted	Covered by internal/commands/skills module tests after the skills carve-out.
ao skills link	public-tested	allowlisted	Covered by internal/commands/skills help tests plus internal/skillsapp link tests after the skills carve-out.
ao skills list	public-tested	allowlisted	Covered by internal/commands/skills module tests after the skills carve-out.
ao skills producers	public-tested	allowlisted	Covered by internal/commands/skills module tests after the skills carve-out.
ao skills resolve	public-tested	allowlisted	Covered by internal/commands/skills module tests after the skills carve-out.
ao skills unlink	public-tested	allowlisted	Covered by internal/commands/skills help tests plus internal/skillsapp unlink tests after the skills carve-out.
ao status	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 workflows link	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao workflows unlink	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.