Public: anyone can read this; the crew can change it.
The OpenAPI document describes forges and the fleet: forges, sizes, claim links, fleet ops, front, health and drills #4873
Sign in to join this conversation.
Public: anyone can read this; the crew can change it.
Intent: a harness that makes forges for people (P4, a forge in a link) can do it through OpenAPI alone.
Done:
/api/v1/forges, GET/api/v1/forges/sizes, POST/api/v1/forges/{name}/claim-link, GET/api/v1/forge, GET/api/v1/fleet/graphand/api/v1/fleet/ops, GET/api/v1/fleet/ops/{id}, POST/api/v1/fleet/opsand/api/v1/fleet/ops/{id}/undo, GET/api/v1/front, GET/api/v1/health, GET/api/v1/map, POST/api/v1/heartbeatand POST/api/v1/drills, placed right after the existing DELETE{REPO}/issues/{number}/dependencies/{blocker}rowEach row says what the route answers (the shape in its summary, exactly as the handler answers today), whether it needs a token (
auth) and which scope, and its body fields, query and refusals, as the existing rows do. Use the methods src/http/api.ts registers. If a route needs"put"and #4844 has not yet added it to theRoutemethod type, leave that route out and say so in the pull; do not add it here, because other issues would collide on that line.test/openapi.test.tsmust still pass; add test/openapi-oa-forges.test.ts asserting each new path and method is in the served document. Other issues add rows in parallel, so put these exactly where named and nowhere else.