Skip to content

mcpx docs interface pages B: MCP and /v1 (http-api) prose pages (split of #1851) #2109

Closed

Description

@dezren39

Split B 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: mcp (overview; mcp-sdk — the three readings in #1851 answered honestly; mcp-compatibility) and http-api (/v1 prose around the spec; /v1-sdk per #1851's recommended Approach C — document generation from /v1/openapi.json with standard tools, the unix-socket caveat, and the tools-vs-daemon OpenAPI callout). Content spec and anchors: #1851.

Triage notes (verified on main 82b019a0, 2026-10-29): Finding 2 is resolved (mcpx openapi is generated from the ops table, so the spec is producible offline). Generated content is linked/included, never hand-copied: the /v1 rendering and protocol revision matrix belong to #1846 — include its fragments if landed by claim time, else link docs/protocol.md / docs/parity.md and name the interim source on the page. Split A (interfaces/CLI/binary/scripts) is the sibling sub-issue of #1851 filed alongside this one.

Acceptance criteria

Activity

  1. developing-today commented on Oct 29, 2026

    @developing-today
    Contributor
  2. added
    source/queue-workerFiled or worked by the queue/worker pilot
    priority/normalOrdinary priority (the default)
    effort/mMedium: expected under 1 day of work
    app/mcpxPackage/app: mcpx (pkgs/ or apps/ in this repo)
    queue/queuedHas a queued task in the Supabase agent queue
    meta/enrichedIntake review done: acceptance criteria, links, and normalized labels added
    on Oct 29, 2026
  3. dezren39 commented on Oct 29, 2026

    @dezren39
    MemberAuthor

    Intake review

    Fleet monitor intake pass (protocol §5), 2026-10-28 ~23:20 CDT.

    Acceptance criteria were appended to the issue body this pass (original text preserved verbatim above them).

  4. added
    queue/parkedQueue task is parked (waiting on CI, time, or an event)
    status/parkedDeliberately paused with a recorded resume condition
    work/assignedQueue worker lifecycle state
    and removed on Oct 29, 2026
  5. 55 remaining items

  6. added
    queue/claimedQueue worker lifecycle state
    and removed
    status/parkedDeliberately paused with a recorded resume condition
    queue/parkedQueue task is parked (waiting on CI, time, or an event)
    on Oct 30, 2026
  7. dezren39 commented on Oct 30, 2026

    @dezren39
    MemberAuthor

    Agent note — picked up (resume)

  8. added
    queue/parkedQueue task is parked (waiting on CI, time, or an event)
    status/parkedDeliberately paused with a recorded resume condition
    and removed
    queue/claimedQueue worker lifecycle state
    on Oct 30, 2026
  9. dezren39 commented on Oct 30, 2026

    @dezren39
    MemberAuthor

    Agent note — parked (merge queue)

  10. dezren39 commented on Oct 30, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · done

  11. removed
    status/parkedDeliberately paused with a recorded resume condition
    queue/parkedQueue task is parked (waiting on CI, time, or an event)
    work/assignedQueue worker lifecycle state
    on Oct 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

app/mcpxPackage/app: mcpx (pkgs/ or apps/ in this repo)effort/mMedium: expected under 1 day of workkind/docsDocumentation improvement or additionmeta/enrichedIntake review done: acceptance criteria, links, and normalized labels addedpriority/normalOrdinary priority (the default)source/queue-workerFiled or worked by the queue/worker pilot

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions