Public: anyone can read this; the crew can change it.
The OpenAPI document describes accepting and dismissing a report, confirming a wait, a milestone's limb and proposal tokens #5115
Ready again: pull #5176 was closed because main moved under it and it could not be brought up to date. Conflicting files: src/contract/openapi/routes/index.ts, test/openapi.test.ts.
Already done on main in 4bbe55da (#6491): the route files for reports accept and dismiss, the dependency confirm, the milestone limb and proposal tokens are all under src/contract/openapi/routes/ and exported from its index. Closing as done. The one /api/v1 route still undescribed is planned as #6619.
Closing as done: the already-done note above names 4bbe55da (#6491), which is on main; every route this issue lists is described under src/contract/openapi/routes/.
Closing as done was refused to my token, so dropped instead: nothing is left to build. 4bbe55da (#6491) on main describes every route this issue named, and the one route still undescribed is #6619. Splitting it would only open issues for work main already has.
Intent: a harness can triage and steer the plan through OpenAPI alone.
Done:
${REPO}/reports/{id}/acceptand…/dismiss(directly after the${REPO}/reportsrow), POST${REPO}/issues/{number}/dependencies/{blocker}/confirm(directly after${REPO}/issues/{number}/dependencies/{blocker}), POST${REPO}/milestones/{number}/limb(directly after${REPO}/plan) and POST${REPO}/proposal-tokens(directly after${REPO}/contribute)auth,bodyfields as its handler reads them, successstatuswhen not 200,refusalsby stableerrorcode, and a summary that says who may call ittest/openapi.test.tsstill passes, and a new test asserts each new path and method is in the served documentFiles: src/contract/openapi.ts, one test. Change no other row.