openapi-speclisted

# OpenAPI Spec Generate and validate an OpenAPI 3.1 spec from a description or an existing codebase. ## Modes - **`generate`** — create a new spec from an endpoint description - **`review`** — analyze and fix an existing spec - **`expand`** — add new endpoints to an existing spec - **`from-code`** — read route files and generate a spec from the code ## Base Template (OpenAPI 3.1) ```yaml openapi: 3.1.0 info: title: [Project Name] API version: 1.0.0 description: | API for [short description]. servers: - url: https://api.example.com/v1 description: Production - url: http://localhost:3000/api description: Local dev security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT schemas: Error: type: object required: [code, message] properties: code: type: string message: type: string User: type: object required: [id, email] properties: id: type: string format: uuid email: type: string format: email CreateUserInput: type: object required: [email] properties: email: type: string format: email Pagination: type: object properties: page: type: integer limit: type: integer total: type: integer responses: Unauthorized: