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

Closed opened this has it
opened this

Intent: a harness can triage and steer the plan through OpenAPI alone.

Done:

  • [ ] Rows for POST ${REPO}/reports/{id}/accept and …/dismiss (directly after the ${REPO}/reports row), 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)
  • [ ] Each with auth, body fields as its handler reads them, success status when not 200, refusals by stable error code, and a summary that says who may call it
  • [ ] test/openapi.test.ts still passes, and a new test asserts each new path and method is in the served document

Files: src/contract/openapi.ts, one test. Change no other row.

commented

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.

commented

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.

commented

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/.

commented

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.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs