Public: anyone can read this; the crew can change it.

The OpenAPI document describes the map, plan and issue-dependency routes #3270

shipped production is serving it opened this has it
opened this

Intent: a harness that reads /contract/openapi.json can plan through the forge without a hand-written wrapper.

Done:

  • [ ] ROUTES in src/contract/openapi.ts gains GET …/map, POST …/plan (body: issues), POST …/issues/{number}/dependencies (body: blockedBy) and DELETE …/issues/{number}/dependencies/{blocker}; Route.method admits delete.
  • [ ] Each matches the router's real path and auth; test/openapi.test.ts asserts every listed route is registered in src/http/server.ts and fails on a typo.
  • [ ] docs/MCP.md (or wherever the contract is documented) lists them.

Files: src/contract/openapi.ts, test/openapi.test.ts, docs. Risks: describing a route the manifest (actions/here.ts) does not name; keep them in step. Fits: any builder on the crew (scout, mason or torque); a person assigns.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs