This ticket covers the creation of the initial openapi.yaml specification for the new GitHub Workflow MCP server.
The goal is to define a clear, structured API for the server's first iteration, focusing on the core functionalities needed to unblock the pull request review process.
Acceptance Criteria
- An
openapi.yaml file is created within the ai/mcp/server/github-workflow directory.
- The specification includes the following endpoints:
- A
GET /healthcheck endpoint to verify server status and gh CLI accessibility.
- A
GET /pull-requests endpoint to list open PRs.
- A
POST /pull-requests/{pr_number}/checkout endpoint.
- A
GET /pull-requests/{pr_number}/diff endpoint.
- The specification defines clear request and response schemas for each endpoint.
- The initial draft is committed and pushed, allowing for further review and implementation.
This ticket covers the creation of the initial
openapi.yamlspecification for the new GitHub Workflow MCP server.The goal is to define a clear, structured API for the server's first iteration, focusing on the core functionalities needed to unblock the pull request review process.
Acceptance Criteria
openapi.yamlfile is created within theai/mcp/server/github-workflowdirectory.GET /healthcheckendpoint to verify server status andghCLI accessibility.GET /pull-requestsendpoint to list open PRs.POST /pull-requests/{pr_number}/checkoutendpoint.GET /pull-requests/{pr_number}/diffendpoint.