fix(docs): restore CLI command catalog dropped by 74736e7a

74736e7a regenerated COMMANDS.md with a stale .tmp/ao-docgen binary,
silently deleting 152 lines covering ao agents inspect/lint, ao scenario
init/list/validate, ao sessions index, and ao trace. The pre-push gate
caught this via the doc-release CLI_SKILLS_MAP check (declared headings
56, file had 51).

Re-run scripts/generate-cli-reference.sh against a freshly built binary
to restore the catalog and add the new ao agents doctor entry.

cli/docs/COMMANDS.md

@@ -2651,3 +2651,175 @@ ao sessions [command]
 
 **Subcommands:**
 
+#### `ao sessions index`
+
+Maintain derived session pages under .agents/ao/sessions.
+
+```
+ao sessions index [flags]
+```
+
+**Flags:**
+
+```
+  -h, --help                  help for index
+      --prune-orphans         Delete derived session pages whose source_jsonl no longer exists
+      --sessions-dir string   Directory containing derived session pages (default: .agents/ao/sessions)
+```
+
+---
+
+### `ao trace`
+
+Trace the provenance of an artifact back to its source transcript.
+
+```
+ao trace <artifact-path> [flags]
+```
+
+**Flags:**
+
+```
+      --graph   Show ASCII provenance graph
+  -h, --help    help for trace
+```
+
+---
+
+### `ao agents`
+
+Tooling for the .agents/ knowledge surface that backs the
+
+```
+ao agents [command]
+```
+
+**Subcommands:**
+
+#### `ao agents doctor`
+
+Combine ao agents inspect and ao agents lint into a single
+
+```
+ao agents doctor [flags]
+```
+
+**Flags:**
+
+```
+      --agents-dir string   Path to the .agents/ directory under inspection (default ".agents")
+      --contract string     Path to the .agents/ write-surfaces contract doc (default "docs/contracts/agents-write-surfaces.md")
+  -h, --help                help for doctor
+      --json                Emit machine-readable JSON
+      --script string       Path to the lint script (default "scripts/check-agents-write-surfaces.sh")
+      --skills-dir string   Path to the skills/ directory used for skill-owned-subdir cross-check (default "skills")
+      --strict              Exit non-zero on any orphan or undocumented surface
+```
+
+#### `ao agents inspect`
+
+Read the .agents/ write-surface contract and emit a structured
+
+```
+ao agents inspect [flags]
+```
+
+**Flags:**
+
+```
+      --contract string   Path to the .agents/ write-surfaces contract doc (default "docs/contracts/agents-write-surfaces.md")
+  -h, --help              help for inspect
+      --json              Emit machine-readable JSON
+```
+
+#### `ao agents lint`
+
+Wrap scripts/check-agents-write-surfaces.sh and surface its
+
+```
+ao agents lint [flags]
+```
+
+**Flags:**
+
+```
+  -h, --help            help for lint
+      --json            Forward --json to the lint script
+      --script string   Path to the lint script (default "scripts/check-agents-write-surfaces.sh")
+```
+
+---
+
+### `ao extract`
+
+Check for pending session extractions and output a prompt for Claude to process.
+
+```
+ao extract [flags]
+```
+
+**Flags:**
+
+```
+      --all               Process all pending entries
+      --bead string       Bead ID to tag extracted learnings with
+      --clear             Clear pending queue without processing
+  -h, --help              help for extract
+      --max-content int   Maximum characters of session content to include (default 3000)
+```
+
+---
+
+### `ao help`
+
+Help provides help for any command in the application.
+
+```
+ao help [command] [flags]
+```
+
+---
+
+### `ao scenario`
+
+Create, list, and validate holdout scenarios stored in .agents/holdout/.
+
+```
+ao scenario [command]
+```
+
+**Subcommands:**
+
+#### `ao scenario init`
+
+Initialize .agents/holdout/ directory for scenario storage
+
+```
+ao scenario init [flags]
+```
+
+#### `ao scenario list`
+
+List holdout scenarios
+
+```
+ao scenario list [flags]
+```
+
+**Flags:**
+
+```
+  -h, --help            help for list
+      --status string   Filter by status (active, draft, retired)
+```
+
+#### `ao scenario validate`
+
+Validate holdout scenarios against schema
+
+```
+ao scenario validate [flags]
+```
+
+---
+