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 context	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 gate check	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao gc check	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao gc prepare	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao gc recover-affinity	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 check-okf	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao provenance digest	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao provenance evidence-orphans	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
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 manifest	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
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 internal/commands/provenance module tests after the provenance carve-out.
ao provenance snapshot-intent	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao provenance store-verdict	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
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 provenance verify-judgments	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao provenance verify-manifest	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao provenance verify-subject	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao provenance verify-verdict	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao quick-start	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 prune-agents	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler tests.
ao session read-source	public-tested	covered	Covered by release smoke tests, direct command tests, or command handler 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.