# a2a command / MCP tool catalog

Generated by `a2a __catalog` (spec 13 §11 wave-7 amendment). Do not hand-edit — this file is regenerated from the built binary and byte-diffed by the `skill-drift` CI job (spec 13 T4/T5).

## Commands

- `__catalog` — print this generated command/MCP catalog (hidden, machine-consumed)
- `accept` — accept one or more artifacts
- `ack` — acknowledge one or more artifacts
- `approve` — approve a decision (always G3-gated)
- `await` — wait for a recorded pending write to merge: await <artifact-id> [--timeout <duration>]
- `block` — block one or more artifacts on a blocker
- `cancel` — cancel one or more artifacts
- `close` — close one or more responded parents
- `completion` — print a shell completion script (bash|zsh|fish)
- `connect` — register a space locally (mirror clone + config entry)
- `contract adopt` — register this system as a consumer of a contract (writes consumes.yaml)
- `contract deprecate` — deprecate a contract with a linked announcement (--sunset)
- `contract diff` — diff two contract versions (--json)
- `contract new` — draft a new contract (alias for `a2a new contract --slug`)
- `contract publish` — publish a contract version (--version/--bump, digest tree)
- `contract retire` — retire a contract (consumer-ack precondition, --override)
- `contract verify-export` — verify a local export's digest tree (--local)
- `contracts` — list known contracts from the local cache: contracts [--provider <sys>]
- `dashboard` — render a self-contained local dashboard (graph + inbox + contracts) from the cache
- `decline` — decline one or more artifacts
- `disconnect` — remove a connected space's config entry + mirror + cache
- `dispute` — dispute a response: dispute --reason <text> [--reason-code <enum>] <response-id>
- `doctor` — run local health checks over every connected space (credentials, mirror access, identity, versions, CI, space scaffolding, auto-merge, CODEOWNERS, notifications, statusline, skill) — see troubleshooting.md for what each FAIL means
- `feedback` — agent feedback loop: new <kind> [--title] | validate <file> [--ci] | submit <file...> [--all] | status [--json] | triage [--json] [--apply <file>]
- `html` — render a self-contained local dashboard (graph + inbox + contracts) from the cache
- `inbox` — list items across every connected space; --actionable applies the normative OP-207 union
- `init` — non-interactive project setup: config + skill install + surface link + AGENTS.md/CLAUDE.md pointer (--no-skill / --no-skill-link / --no-agents-pointer to opt out)
- `mcp` — serve the §7.7 MCP tool surface over stdio JSON-RPC
- `new` — draft a new artifact from its canonical template: new <type> [--field k=v | k.nested=v]... [--body-file <path>]
- `note` — annotate one or more artifacts: note --note <text> <id...>
- `notifications` — install, inspect, test, and control native notification surfaces
- `outbox` — list own open items across every connected space; --attention applies the normative OP-208 union
- `reject` — reject a decision (always G3-gated)
- `respond` — respond to one or more parents: respond --result <answered|delivered|partial|cannot> <parent-id...>
- `satisfy` — satisfy a requirement
- `search` — search the local cache: search <query> [--type --space --state --thread]
- `show` — show an artifact's body, folded state, events, and any V5 digest/staleness warning
- `skill` — install the a2ahub expert-skill tree into this repo, and link it so an agent surface can discover it
- `space` — space scaffolding: init <space-id> [--dir <path>] | update [--space <id>] [--dry-run] — write/migrate a space tree from the embedded template
- `start` — start work on one or more artifacts
- `statusline` — print status facts for prompt integration [--json] [--sample] [--no-prefix] (§7.5)
- `submit` — validate (V2) and submit staged draft(s): submit <artifact> | submit --batch <artifact...> | submit --drafts
- `supersede` — supersede an artifact with its successor
- `sync` — fetch all connected spaces' mirrors and refresh the local cache
- `template` — inspect canonical templates: list | show <type>
- `thread` — read one thread's ordered transcript and open items: thread <thread-id|artifact-id> [--space <id>] (OP-210)
- `unblock` — unblock one or more artifacts (recovers pre-block state)
- `update` — resolve, verify, and atomically swap to the latest release (OP-217)
- `validate` — validate a draft (V1), JSON output: validate <path> | validate --all
- `verify` — verify one or more responses: verify <response-id|parent-id...> [--refs <response-id>]
- `verify-fail` — record a failing handoff verification
- `verify-pass` — record a passing handoff verification
- `version` — print the binary version stamp
- `whatsnew` — show what changed in this release and what to do about it (P31)
- `withdraw` — withdraw one or more requirements

## MCP tools

- `a2a_contract` — contract family: action=new|publish|deprecate|retire|diff|verify-export|adopt
- `a2a_exchange` — exchange verbs: action=respond|verify|dispute|note
- `a2a_lifecycle` — generic lifecycle transition: action=ack|accept|decline|start|block|unblock|cancel|close|withdraw|supersede|satisfy|approve|reject|verify-pass|verify-fail
- `a2a_new` — draft one or more new artifacts (items[]) on one thread; an item's fields key may be a dotted path into a nested field, e.g. expected_response.shape
- `a2a_read` — read the local cache: view=inbox|outbox|show|thread|search|contracts
- `a2a_submit` — validate (V2) and submit staged draft(s); accepts an id array (OP-220 batch) or a single id
- `a2a_whatsnew` — release directives and current known issues — optional since=<version>