Repository navigation
Description
Split A of #1851 (mcpx docs interface pages), filed by queue triage task 2741 (2026-10-29) so the page set lands in two reviewable pieces.
Write the prose level-2 pages for: interfaces (abstract interfaces — one ops table behind every surface; client interfaces), cli (overview; cli-arguments — the two flag kinds: hand-parsed globals before the subcommand, registry flags bound per command; cli-commands overview prose), binary (what is shipped per go.mod / docs/dependencies.md / docs/container.md), and scripts (the script contract). Content spec, anchors (interfaces#…, cli#…, binary#binary, scripts#script), and per-section detail: #1851.
Triage notes (verified on main 82b019a0, 2026-10-29): all four code findings that gated these pages are resolved (Commands()/dispatch parity held by TestEveryDispatchedCommandIsDeclared; mcpx openapi generated from the ops table; dependencies doc corrected). Do not hand-copy generated tables — link/include docs/configuration.md, docs/environment.md, docs/parity.md. Page map: #1848. Split B (MCP + /v1 pages) is the sibling sub-issue of #1851 filed alongside this one.
Acceptance criteria
- Prose level-2 pages exist for interfaces (abstract interface — one ops table behind every surface — and client interfaces), cli (overview; cli-arguments covering both flag kinds: hand-parsed globals before the subcommand, registry flags bound per command; cli-commands overview), binary (what is shipped, per go.mod / docs/dependencies.md / docs/container.md), and scripts (the script contract), at the anchors named in mcpx docs: interface pages -- abstract and client interfaces, CLI, MCP, binary, script, /v1 and the SDKs #1851 (
interfaces#…,cli#…,binary#binary,scripts#script) and in the mcpx docs: level-2 page map, and the configuration, modes and transport pages #1848 page map. - No generated content is hand-copied: command/flag/spec tables are linked or included from
docs/configuration.md,docs/environment.md,docs/parity.mdas the triage notes direct. - The docs build/validation for pkgs/mcpx passes in CI on the implementing PR.
- Sibling split B (mcpx docs interface pages B: MCP and /v1 (http-api) prose pages (split of #1851) #2109) is untouched by this issue's PR; together mcpx docs interface pages A: interfaces, CLI, binary, scripts prose pages (split of #1851) #2108 + mcpx docs interface pages B: MCP and /v1 (http-api) prose pages (split of #1851) #2109 close out parent mcpx docs: interface pages -- abstract and client interfaces, CLI, MCP, binary, script, /v1 and the SDKs #1851's page set.
Activity
developing-today commentedon Oct 29, 2026
CODE-1013
dezren39 commentedon Oct 29, 2026
Intake review
Fleet monitor intake pass (protocol §5), 2026-10-28 ~23:20 CDT.
82b019a0per the triage notes on the issue (Commands()/dispatch parity test, ops-table OpenAPI generation, dependencies doc correction).queue/queuedwas missing).Acceptance criteria were appended to the issue body this pass (original text preserved verbatim above them).
9 remaining items
docs(mcpx): correct exit-75 and Node TypeScript claims (Codex review, #…
dezren39 commentedon Oct 29, 2026
🤖 Agent note · parked
pkgs/mcpx/docs/interfaces.md,cli.md,binary.md,scripts.mdat the mcpx docs: level-2 page map, and the configuration, modes and transport pages #1848 anchors, facts re-verified at5a34fa70. PR-head CI green (basic test, spec parity); both Codex P2 findings were verified against the code, fixed in0384763f(exit 75 collects viamcpx task result, no retry; Node--experimental-transform-typesruns non-erasable TS), replied on-thread, and the Codex re-review is clean.queue/3063-2108-mcpx-docs-interfaces-a· laptop worktree~/git/fleet/3063-2108-mcpx-docs-interfaces-adezren39 commentedon Oct 30, 2026
🤖 Agent note · picked up → parked
dezren39 commentedon Oct 30, 2026
Lane A (queue task 3063): verified fresh — PR #2458 MERGED 2026-10-30T01:08:19Z (merge commit f97e95c) once blocker #2403 cleared. Task 3063 completing as already_done; stale queue/status/work labels removed.
🤖 Agent note · picked up → done (already_done)