Files
boshu2__agentops/docs/cli-surface.md
T
Bo db1a0573ea Add bounded source reads and pinned OKF profile checks (#1114)
Adds two explicit read-only operations for the context delivery
lifecycle: bounded raw source reads with reversible bytes and integrity
checks, and structural checking of the pinned AgentOps OKF page profile.

Source reads require independently selected context policy and enforce a
measured serialized-output bound before emitting content. Emitted bytes
do not establish host delivery or understanding; restricted-source
processing remains unavailable without native enforcement. The OKF
checker rejects missing status and incompatible profiles, and never
grants truth, disclosure, or usefulness approval.

Validation: focused tests and Linux/Windows source-reader builds passed.
The combined candidate is undergoing the required full repository checks
and fresh independent review before landing.
2026-09-09 09:37:34 -04:00

73 lines
8.6 KiB
Markdown

# 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. |