mirror of
https://github.com/boshu2/agentops.git
synced 2026-09-14 15:08:13 +08:00
Bo
238964fdd2
Workflows get the skills treatment (operator decision): canonical source in the product tree, installed by a product verb, Claude-only labeled as such. **What moves:** all seven Claude workflow scripts + README migrate from force-added exceptions inside the gitignored `.claude/` to a tracked top-level `workflows/` (sibling of `skills/`) — the four existing conveyors plus `audit-dimensions`, `verify-fixes`, `implement-wave`: three thin, args-parameterized orchestration conveyors extracted from this session's hand-rolled waves, contract-reviewed, and smoke-proven through the real Workflow runtime (the smoke caught two contract gaps static review could not: an `export default` wrapper the runtime never invokes, and args arriving as a JSON string — both fixed, string-args tolerance now built in). **New verb:** `ao workflows link` / `unlink` mirror `ao skills link` semantics — dry-run `--json`, refuse to replace real files or foreign links, unlink only checkout-owned links — targeting the project-local `.claude/workflows/` where Claude Code resolves named workflows (`--into` overrides). Checkout identity reuses the skillsapp marker discipline, fail-closed. Claude-only runtime adapter, same doctrine as the Codex-only `skills-codex/`. **Legacy surfaces repointed:** `install-workflows.sh` (user-global $HOME installer), `check-workflow-drift.sh` + gate comment, `check-bdd-foundry-markers.sh`; spine allowlist + YAML-probe excuse + go-cli.md spine region gain the workflows group; COMMANDS.md, cli-surface projections, and surface-count fixture regenerated; new tests carry per-command git-env scrubbing (test-isolation ratchet back at baseline). **Built BY the workflow being canonized** — `implement-wave` orchestrated its own canonization: two disjoint-ownership lanes plus a seam-checking verifier that ran the real binary's link → resolve → unlink cycle in the live tree (both lanes RESOLVED). The lanes correctly *refused* to self-approve their command into the spine invariants and handed integration three flagged edits instead. **Expected local gate note:** `workflow.install-drift` correctly FAILS on machines whose user-global `~/.claude/workflows` links still point at the old location — that is the transition it exists to catch. CI stays green (absent→skip). **Post-merge operator step:** `cd ~/dev/agentops && git pull && bash scripts/install-workflows.sh`. **Verified:** full suite 63/63 pkgs; golangci-lint clean; `gate check --full` over this range = 66/67 with only the documented install-drift environment finding; workflows smoke-run evidence in session logs.
84 lines
9.5 KiB
Markdown
84 lines
9.5 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` | `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. |
|