openapi: 3.1.0
info:
  title: RC Gate API
  version: 1.1.0
  description: PRD Validation with AI Analysis, Gate Scaffolding, Audit Reports
servers:
  - url: https://adspy-api.com
paths:
  /prd/validate:
    post:
      summary: Validate PRD Markdown
      description: Validates PRD against best practices with optional AI analysis (Pro/Ultra)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [prd_markdown]
              properties:
                prd_markdown:
                  type: string
                ruleset:
                  type: string
                  default: rc-v1.0.0
      responses:
        '200':
          description: Validation result
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok: { type: boolean }
                  score: { type: integer, minimum: 0, maximum: 100 }
                  errors: { type: array }
                  summary: { type: object }
                  ai_feedback: { type: object }
  /gate/patches:
    post:
      summary: Generate Gate Scripts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [repo_type]
              properties:
                repo_type:
                  type: string
                  enum: [node-npm-ts, node-pnpm-ts, node-yarn-ts]
      responses:
        '200':
          description: Generated patches
  /audit/render:
    post:
      summary: Generate Audit Reports
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [logs]
              properties:
                project_name: { type: string }
                logs: { type: object }
      responses:
        '200':
          description: Generated reports
components:
  securitySchemes:
    LicenseKey:
      type: apiKey
      in: header
      name: X-License-Key