docs(adapters): fix stale Codex and Cursor smoke commands in host matrix

The Host Adapter Matrix drifted from the shipped CLI. The Codex Smoke
cell referenced a nonexistent `harness prepare --platform codex` command
and an `html-report` validation step; the current chain is
`harness analyze --platform codex` followed by a validated
`harness render --mode html`. The Cursor Smoke cell claimed a working
`agent --plugin-dir` -> evidence bundle -> validated render chain while
roadmap records the Cursor runtime smoke as missing (open item U-04); it
now names the correct cursor-agent binary and marks the smoke as not yet
available instead of overstating support.

This closes roadmap P0 item A-05. Default Output columns stay unchanged;
the durable-HTML defaults are an accepted contract guarded by
test/better-harness-skill.test.mjs.

Story: roadmap.md TODO A-05
Spec: docs/specs/2026-07-28-a05-adapter-docs-stale-commands.md
Test: node --test test/agent-customize-architecture.test.mjs test/better-harness-skill.test.mjs test/doc-link-graph.test.mjs (19 pass)

Author: creayma

docs/adapters/README.md

@@ -19,9 +19,9 @@ repository's native marketplace manifest.
 | Host | Positioning | Shell | Configured Assets | Session Evidence | Default Output | Rules / Prompts | Smoke |
 | --- | --- | --- | --- | --- | --- | --- | --- |
 | Claude Code | Analysis-capable source-local host | `.claude-plugin/` | `scripts/agent-customize/providers/claude.mjs` | `scripts/session-analysis/platforms/claude.mjs` | self-contained HTML + Markdown | `.claude` + `CLAUDE.md` + Plugin assets | `claude plugin validate --strict .` -> isolated install/discovery -> configured-asset baseline -> validated `html` render |
-| Codex | Analysis-capable source-local host | `.codex-plugin/` | `scripts/agent-customize/providers/codex.mjs` | `scripts/session-analysis/platforms/codex.mjs` | self-contained HTML + Markdown | `.codex` + `.agents` + `AGENTS.md` | `harness prepare --platform codex` -> finalize with `html-report` validation |
+| Codex | Analysis-capable source-local host | `.codex-plugin/` | `scripts/agent-customize/providers/codex.mjs` | `scripts/session-analysis/platforms/codex.mjs` | self-contained HTML + Markdown | `.codex` + `.agents` + `AGENTS.md` | `harness analyze --platform codex` -> validated `harness render --mode html` |
 | Qoder | First-class product host | `.qoder-plugin/` | `scripts/agent-customize/providers/qoder.mjs` | `scripts/session-analysis/platforms/qoder.mjs` | `better-harness` | `.qoder/rules` + `AGENTS.md` + output templates | `better-harness harness render --mode qoder-canvas --validate` |
-| Cursor | Analysis-capable source-local host | `.cursor-plugin/` | `scripts/agent-customize/providers/cursor.mjs` | `scripts/session-analysis/platforms/cursor.mjs` | self-contained HTML + Markdown | `.cursor` + `.codex` compatibility + `AGENTS.md` | `agent --plugin-dir . --mode ask --print` -> Cursor evidence bundle -> validated `html` render |
+| Cursor | Analysis-capable source-local host | `.cursor-plugin/` | `scripts/agent-customize/providers/cursor.mjs` | `scripts/session-analysis/platforms/cursor.mjs` | self-contained HTML + Markdown | `.cursor` + `.codex` compatibility + `AGENTS.md` | packaged `cursor-agent --plugin-dir` runtime smoke is not yet available (roadmap U-04) |
 
 ## Discovery And Evidence
 

docs/specs/2026-07-28-a05-adapter-docs-stale-commands.md

@@ -0,0 +1,72 @@
+# Adapter Matrix Stale Commands Cleanup
+
+Fix stale smoke commands in the Host Adapter Matrix so every referenced CLI
+step exists in the current implementation and the Cursor row does not claim a
+runtime smoke that the roadmap tracks as missing. This is roadmap P0 item A-05.
+
+## Traceability
+
+- Spec ID: 2026-07-28-a05-adapter-docs-stale-commands
+- Story: roadmap.md TODO A-05
+- Status: Implemented
+
+## Intent
+
+The `docs/adapters/README.md` matrix drifted from the shipped CLI:
+
+1. The Codex Smoke cell references `harness prepare --platform codex` and a
+   `html-report` validation step. Neither exists: the registry has no
+   `prepare` subcommand, and rendering/validation runs through
+   `harness analyze` plus `harness render --mode html --validate`
+   (`scripts/better-harness-cli/registry.mjs`,
+   `scripts/harness-analysis/render-report.mjs`).
+2. The Cursor Smoke cell presents `agent --plugin-dir . --mode ask --print ->
+   Cursor evidence bundle -> validated html render` as an existing smoke
+   chain, while `roadmap.md` records "Real host smoke test: Cursor No" and
+   tracks the packaged `cursor-agent --plugin-dir` smoke as open item U-04.
+   The cell also uses the `agent` binary name instead of `cursor-agent`.
+
+Reader-facing output contracts (Default Output columns, `html-visual.md`
+routing) already match the durable-HTML product decision from
+`docs/specs/2026-07-27-claude-durable-html-default.md` and stay unchanged.
+
+## Acceptance Scenarios
+
+- AC-1: The matrix's Codex Smoke cell uses only commands that exist today:
+  `harness analyze --platform codex` and a validated
+  `harness render --mode html` step; the strings `harness prepare` and
+  `html-report` no longer appear in `docs/adapters/README.md`.
+- AC-2: The Cursor Smoke cell no longer claims an existing evidence-bundle ->
+  validated render smoke chain; it states that the packaged
+  `cursor-agent --plugin-dir` runtime smoke is not yet available and points
+  to roadmap item U-04.
+- AC-3: Existing content-contract tests keep passing unchanged:
+  `test/agent-customize-architecture.test.mjs` and
+  `test/better-harness-skill.test.mjs` assertions over
+  `docs/adapters/README.md`.
+- AC-4: `node --test test/doc-link-graph.test.mjs` passes; no markdown links
+  change.
+
+## Non-Goals
+
+- No change to Default Output or Session Evidence columns; the durable-HTML
+  defaults for Claude Code, Codex, and Cursor are an accepted product
+  contract guarded by `test/better-harness-skill.test.mjs`.
+- No support-declaration consistency tests (tracked separately as A-06).
+- No CLI, renderer, or provider code changes.
+
+## Plan
+
+1. Rewrite the Codex Smoke cell to the current
+   `harness analyze --platform codex` -> validated
+   `harness render --mode html` chain.
+2. Rewrite the Cursor Smoke cell to name the correct `cursor-agent` binary
+   and mark the runtime smoke as pending roadmap U-04 instead of claiming a
+   working chain.
+3. Check A-05 off in `roadmap.md`.
+
+## Test Evidence
+
+- `node --test test/agent-customize-architecture.test.mjs`
+- `node --test test/better-harness-skill.test.mjs`
+- `node --test test/doc-link-graph.test.mjs`

roadmap.md

@@ -45,7 +45,7 @@ platform depth.
 | [ ] | P0 | A-02 | Make checkup plan/apply provider-aware and fail closed by default. | Codex and Cursor plans never contain `qodercli` actions. |
 | [ ] | P0 | A-03 | Bind source references and provider-home paths to an explicit provider. | A patch cannot resolve into another host's configuration root. |
 | [x] | P0 | A-04 | Add a help-only path to `agent-customize`. | `--help` returns before reading HOME, workspace, SQLite, or plugin caches. |
-| [ ] | P0 | A-05 | Fix stale adapter documentation and smoke commands. | The matrix uses current `harness analyze` / `harness render` commands and does not overstate Cursor output support. |
+| [x] | P0 | A-05 | Fix stale adapter documentation and smoke commands. | The matrix uses current `harness analyze` / `harness render` commands and does not overstate Cursor output support. |
 | [ ] | P0 | A-06 | Add support-declaration consistency tests. | CLI help, provider registry, session platforms, report platforms, and docs agree. |
 | [ ] | P1 | C-01 | Add Codex-specific configuration source precedence. | Checkup distinguishes editable sources from cache, audit, and session data. |
 | [ ] | P1 | C-02 | Normalize Codex model, usage, and hook evidence when present. | Missing data stays unavailable; no model, token, or hook values are invented. |