openapi: "3.1.0"
info:
  title: "PlatPhorm Evals"
  version: "0.1.0"
  description: "Registry-driven evaluation mesh for the PlatPhorm ecosystem. Evals produces evidence-backed scorecards and release decisions. Public-safe read, discovery, dashboard, documentation, registry summary, health, feed, sitemap, OpenAPI, AsyncAPI, llms, MCP descriptor, read-only JSON-RPC methods, Web Status, provenance, fingerprints, and trust-policy surfaces are public. Protected eval execution, registry sync, suite mutation, release gate mutation, private exports, downstream protected calls, and admin actions require PLATPHORM_API_KEY. AWS_POSTGRES_* is the primary database configuration; DATABASE_URL is documented only as a lower-priority migration compatibility fallback."
servers:
  - 
    url: "https://evals.platphormnews.com"
paths:
  "/api/health":
    get:
      summary: "Health check"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "System"
      responses:
        200:
          description: "Health check"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/health":
    get:
      summary: "Versioned health check"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "System"
      responses:
        200:
          description: "Versioned health check"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/docs":
    get:
      summary: "OpenAPI JSON document"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "System"
      responses:
        200:
          description: "OpenAPI JSON document"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/openapi.yaml":
    get:
      summary: "OpenAPI YAML document"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "OpenAPI YAML document"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/openapi.json":
    get:
      summary: "OpenAPI JSON document"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "OpenAPI JSON document"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/llms.txt":
    get:
      summary: "Readable LLMS discovery"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Readable LLMS discovery"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/llms-full.txt":
    get:
      summary: "Complete LLMS discovery"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Complete LLMS discovery"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/llms-index.json":
    get:
      summary: "Machine-readable LLMS index"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Machine-readable LLMS index"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/sitemap.xml":
    get:
      summary: "Public sitemap"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Public sitemap"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/sitemap-main.xml":
    get:
      summary: "Main public sitemap"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Main public sitemap"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/sitemap-index.xml":
    get:
      summary: "Sitemap index"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Sitemap index"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/sitemap-runs.xml":
    get:
      summary: "Public run sitemap"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Public run sitemap"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/sitemap-scorecards.xml":
    get:
      summary: "Public scorecard sitemap"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Public scorecard sitemap"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/rss.xml":
    get:
      summary: "RSS feed"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "RSS feed"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/feed.xml":
    get:
      summary: "Atom feed"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Atom feed"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/robots.txt":
    get:
      summary: "Robots policy"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Robots policy"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/manifest.webmanifest":
    get:
      summary: "Web app manifest"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Web app manifest"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/.well-known/mcp.json":
    get:
      summary: "MCP well-known descriptor"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "MCP well-known descriptor"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/.well-known/agents.json":
    get:
      summary: "Agent descriptor"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Agent descriptor"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/.well-known/agent-policy.json":
    get:
      summary: "Agent policy"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Agent policy"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/.well-known/ai-policy.json":
    get:
      summary: "AI policy"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "AI policy"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/.well-known/ai-plugin.json":
    get:
      summary: "AI plugin manifest"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "AI plugin manifest"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/.well-known/trust.json":
    get:
      summary: "Trust policy"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Trust policy"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/.well-known/security.txt":
    get:
      summary: "Security contact"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Security contact"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/.well-known/web.json":
    get:
      summary: "Web Status manifest"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Web Status manifest"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/.well-known/web4.json":
    get:
      summary: "Legacy Web Status manifest alias"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Legacy Web Status manifest alias"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/.well-known/provenance.json":
    get:
      summary: "Public provenance index"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "Public provenance index"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/asyncapi.yaml":
    get:
      summary: "AsyncAPI event contract"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Discovery"
      responses:
        200:
          description: "AsyncAPI event contract"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/mcp":
    get:
      summary: "MCP server descriptor"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "MCP"
      responses:
        200:
          description: "MCP server descriptor"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
    post:
      summary: "MCP JSON-RPC endpoint"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "MCP"
      responses:
        200:
          description: "MCP JSON-RPC endpoint"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/registry":
    get:
      summary: "Registry summary"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Registry"
      responses:
        200:
          description: "Registry summary"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/registry/status":
    get:
      summary: "Registry status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Registry"
      responses:
        200:
          description: "Registry status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/registry/sync":
    post:
      summary: "Sync registry"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Registry"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Sync registry"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/registry/services":
    get:
      summary: "List registry services"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Registry"
      responses:
        200:
          description: "List registry services"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/targets":
    get:
      summary: "List eval targets"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Targets"
      responses:
        200:
          description: "List eval targets"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/targets/{idOrSlug}":
    get:
      summary: "Get eval target"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Targets"
      parameters:
        - 
          name: "idOrSlug"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get eval target"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/capabilities":
    get:
      summary: "List eval capabilities"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Capabilities"
      responses:
        200:
          description: "List eval capabilities"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/capabilities/{id}":
    get:
      summary: "Get eval capability"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Capabilities"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get eval capability"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evals":
    get:
      summary: "List eval suites"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Suites"
      responses:
        200:
          description: "List eval suites"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
    post:
      summary: "Create eval suite"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Suites"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Create eval suite"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/builder/evals":
    post:
      summary: "Create suite from suggested builder template and optionally run it"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Builder"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Create suite from suggested builder template and optionally run it"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evals/{id}":
    get:
      summary: "Get eval suite"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Suites"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get eval suite"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/suites":
    get:
      summary: "List eval suites"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Suites"
      responses:
        200:
          description: "List eval suites"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
    post:
      summary: "Create eval suite"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Suites"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Create eval suite"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/suites/{idOrSlug}":
    get:
      summary: "Get eval suite"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Suites"
      parameters:
        - 
          name: "idOrSlug"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get eval suite"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
    patch:
      summary: "Update eval suite"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Suites"
      parameters:
        - 
          name: "idOrSlug"
          in: "path"
          required: true
          schema:
            type: "string"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Update eval suite"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
    delete:
      summary: "Delete eval suite"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Suites"
      parameters:
        - 
          name: "idOrSlug"
          in: "path"
          required: true
          schema:
            type: "string"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Delete eval suite"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/suites/{idOrSlug}/cases":
    get:
      summary: "List eval cases"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Suites"
      parameters:
        - 
          name: "idOrSlug"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "List eval cases"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/runs":
    get:
      summary: "List eval runs"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Runs"
      responses:
        200:
          description: "List eval runs"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
    post:
      summary: "Start eval run"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Runs"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Start eval run"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/runs/{id}":
    get:
      summary: "Get eval run"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Runs"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get eval run"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/runs/{id}/results":
    get:
      summary: "Get eval run results"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Runs"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get eval run results"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/runs/{id}/evidence":
    get:
      summary: "Get public-safe run evidence"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Runs"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get public-safe run evidence"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/runs/{id}/scorecard":
    get:
      summary: "Get run scorecard"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Runs"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get run scorecard"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/runs/{id}/trace":
    get:
      summary: "Get run trace link"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Runs"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get run trace link"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/runs/{id}/cancel":
    post:
      summary: "Cancel eval run"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Runs"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Cancel eval run"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/runs/{id}/rerun":
    post:
      summary: "Rerun eval"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Runs"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Rerun eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/discovery":
    post:
      summary: "Run discovery eval"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evaluation"
      responses:
        200:
          description: "Run discovery eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/openapi":
    post:
      summary: "Run OpenAPI eval"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evaluation"
      responses:
        200:
          description: "Run OpenAPI eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/mcp":
    post:
      summary: "Run MCP eval"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evaluation"
      responses:
        200:
          description: "Run MCP eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/claws":
    post:
      summary: "Run Claws eval"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evaluation"
      responses:
        200:
          description: "Run Claws eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/browserops":
    post:
      summary: "Run BrowserOps eval"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Evaluation"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Run BrowserOps eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/agentui":
    post:
      summary: "Run AgentUI eval"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evaluation"
      responses:
        200:
          description: "Run AgentUI eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/sandbox":
    post:
      summary: "Run Sandbox eval"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Evaluation"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Run Sandbox eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/workflow":
    post:
      summary: "Run workflow eval"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evaluation"
      responses:
        200:
          description: "Run workflow eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/llm-judge":
    post:
      summary: "Run LLM judge eval"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Evaluation"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Run LLM judge eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/regression":
    post:
      summary: "Run regression eval"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evaluation"
      responses:
        200:
          description: "Run regression eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/release-gate":
    post:
      summary: "Run release gate eval"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Evaluation"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Run release gate eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/evaluate/cli":
    post:
      summary: "Run CLI/platphormctl eval"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evaluation"
      responses:
        200:
          description: "Run CLI/platphormctl eval"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/scorecards":
    get:
      summary: "List scorecards"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Scorecards"
      responses:
        200:
          description: "List scorecards"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/scorecards/{id}":
    get:
      summary: "Get scorecard"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Scorecards"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get scorecard"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/release-gates":
    get:
      summary: "List release gates"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Release Gates"
      responses:
        200:
          description: "List release gates"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
    post:
      summary: "Create release gate"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Release Gates"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Create release gate"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/release-gates/{id}":
    get:
      summary: "Get release gate"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Release Gates"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get release gate"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/release-gates/{id}/run":
    post:
      summary: "Run release gate"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Release Gates"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Run release gate"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/templates":
    get:
      summary: "List eval templates"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Templates"
      responses:
        200:
          description: "List eval templates"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/templates/{slug}":
    get:
      summary: "Get eval template"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Templates"
      parameters:
        - 
          name: "slug"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get eval template"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/benchmarks":
    get:
      summary: "List benchmarks"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Benchmarks"
      responses:
        200:
          description: "List benchmarks"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/benchmarks/{slug}":
    get:
      summary: "Get benchmark"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Benchmarks"
      parameters:
        - 
          name: "slug"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get benchmark"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations":
    get:
      summary: "List integrations"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "List integrations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/status":
    get:
      summary: "List integration statuses"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "List integration statuses"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/mcp":
    get:
      summary: "Get MCP integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get MCP integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/api":
    get:
      summary: "Get API Hub integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get API Hub integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/claws":
    get:
      summary: "Get Claws integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get Claws integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/spec":
    get:
      summary: "Get Spec integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get Spec integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/sandbox":
    get:
      summary: "Get Sandbox integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get Sandbox integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/browserops":
    get:
      summary: "Get BrowserOps integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get BrowserOps integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/agentui":
    get:
      summary: "Get AgentUI integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get AgentUI integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/docs":
    get:
      summary: "Get Docs integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get Docs integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/sheets":
    get:
      summary: "Get Sheets integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get Sheets integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/cli":
    get:
      summary: "Get CLI integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get CLI integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/platphormctl":
    get:
      summary: "Get platphormctl integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get platphormctl integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/integrations/webhooks":
    get:
      summary: "Get WebhookLab integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Integrations"
      responses:
        200:
          description: "Get WebhookLab integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/agent-policy":
    get:
      summary: "Get agent policy"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Agent Policy"
      responses:
        200:
          description: "Get agent policy"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/agent-policy/platforms":
    get:
      summary: "List agent platforms"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Agent Policy"
      responses:
        200:
          description: "List agent platforms"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/agent-policy/platforms/{id}":
    get:
      summary: "Get agent platform"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Agent Policy"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get agent platform"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/agent-policy/robots":
    get:
      summary: "Get robots policy"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Agent Policy"
      responses:
        200:
          description: "Get robots policy"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/agent-policy/summary":
    get:
      summary: "Get agent policy summary"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Agent Policy"
      responses:
        200:
          description: "Get agent policy summary"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/reports/docs":
    post:
      summary: "Create Docs report"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Reports"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Create Docs report"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/reports/sheets":
    post:
      summary: "Create Sheets report"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Reports"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Create Sheets report"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/reports/decks":
    post:
      summary: "Create Deck summary"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Reports"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Create Deck summary"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/reports/{id}":
    get:
      summary: "Get report"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Reports"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get report"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/compare":
    get:
      summary: "List run comparisons"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Compare"
      responses:
        200:
          description: "List run comparisons"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
    post:
      summary: "Create run comparison"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Compare"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Create run comparison"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/regressions":
    get:
      summary: "List regressions"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Regressions"
      responses:
        200:
          description: "List regressions"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
    post:
      summary: "Create regression"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Regressions"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Create regression"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/v1/regressions/{id}":
    get:
      summary: "Get regression"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Regressions"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get regression"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/status":
    get:
      summary: "Evals canonical status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "Evals canonical status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/database-status":
    get:
      summary: "AWS Postgres database status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "AWS Postgres database status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/registry":
    get:
      summary: "Evals registry status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "Evals registry status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/registry/sync":
    post:
      summary: "Sync Evals registry"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Evals"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Sync Evals registry"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/services":
    get:
      summary: "List Evals services"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "List Evals services"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/services/{id}":
    get:
      summary: "Get Evals service"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get Evals service"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/capabilities":
    get:
      summary: "List Evals capabilities"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "List Evals capabilities"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/suites":
    get:
      summary: "List Evals suites"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "List Evals suites"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/suites/{id}":
    get:
      summary: "Get Evals suite"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get Evals suite"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/cases":
    get:
      summary: "List Evals cases"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "List Evals cases"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/cases/{id}":
    get:
      summary: "Get Evals case"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get Evals case"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/runs":
    get:
      summary: "List Evals runs"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "List Evals runs"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
    post:
      summary: "Start protected eval run"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Evals"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Start protected eval run"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/runs/{id}":
    get:
      summary: "Get Evals run bundle"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get Evals run bundle"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/runs/{id}/steps":
    get:
      summary: "Get run steps"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get run steps"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/runs/{id}/evidence":
    get:
      summary: "Get run evidence"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get run evidence"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/runs/{id}/artifacts":
    get:
      summary: "Get run artifacts"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get run artifacts"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/runs/{id}/scorecard":
    get:
      summary: "Get run scorecard"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get run scorecard"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/runs/{id}/findings":
    get:
      summary: "Get run findings"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get run findings"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/runs/{id}/release-gate":
    get:
      summary: "Get run release gate"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get run release gate"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/runs/{id}/events":
    get:
      summary: "Run event stream"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Run event stream"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/run":
    post:
      summary: "Start protected eval run"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Evals"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Start protected eval run"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/dry-run":
    post:
      summary: "Preview public-safe dry-run"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "Preview public-safe dry-run"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/score":
    get:
      summary: "Fetch a confirmable scorecard artifact"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "Fetch a confirmable scorecard artifact"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
    post:
      summary: "Compute deterministic scorecard"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "Compute deterministic scorecard"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/scorecards":
    get:
      summary: "List confirmable scorecard artifacts"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "List confirmable scorecard artifacts"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/scorecards/{id}":
    get:
      summary: "Get confirmable scorecard artifact"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get confirmable scorecard artifact"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/scorecards/{id}/confirm":
    get:
      summary: "Confirm scorecard artifact"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Confirm scorecard artifact"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/scorecards/{id}/evidence":
    get:
      summary: "Get scorecard evidence summary"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get scorecard evidence summary"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/scorecards/{id}/findings":
    get:
      summary: "Get scorecard findings summary"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get scorecard findings summary"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/scorecards/{id}/release-gate":
    get:
      summary: "Get scorecard release gate"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get scorecard release gate"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/scorecards/{id}/export.json":
    get:
      summary: "Export scorecard JSON"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Export scorecard JSON"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/scorecards/{id}/export.md":
    get:
      summary: "Export scorecard Markdown"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Export scorecard Markdown"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/release-gate":
    post:
      summary: "Mutate release gate decision"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Evals"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Mutate release gate decision"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/findings/{id}/resolve":
    post:
      summary: "Resolve finding"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Resolve finding"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/benchmarks":
    get:
      summary: "List benchmarks"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "List benchmarks"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/benchmarks/{id}":
    get:
      summary: "Get benchmark"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      parameters:
        - 
          name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
      responses:
        200:
          description: "Get benchmark"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/model-grade":
    post:
      summary: "Run protected model grade"
      description: "Protected operation. Requires Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY."
      tags:
        - "Evals"
      security:
        - 
          PlatPhormBearer:
[]
        - 
          PlatPhormApiKey:
[]
      responses:
        200:
          description: "Run protected model grade"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/receive-handoff":
    post:
      summary: "Receive Evals handoff"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "Receive Evals handoff"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/send-handoff":
    post:
      summary: "Send Evals handoff"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "Send Evals handoff"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        201:
          description: "Created or accepted"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/suite-registry":
    get:
      summary: "List canonical suite registry"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "List canonical suite registry"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/integrations/status":
    get:
      summary: "Get integration status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "Get integration status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/evals/evidence":
    get:
      summary: "Get route evidence"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Evals"
      responses:
        200:
          description: "Get route evidence"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/web/status":
    get:
      summary: "Get Web Status"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Web Status"
      responses:
        200:
          description: "Get Web Status"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/web/manifest":
    get:
      summary: "Get Web Status manifest"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Web Status"
      responses:
        200:
          description: "Get Web Status manifest"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/web/scorecard":
    get:
      summary: "Get Web Status scorecard"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Web Status"
      responses:
        200:
          description: "Get Web Status scorecard"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/web/fingerprints":
    get:
      summary: "List public-safe Web Status fingerprints"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Web Status"
      responses:
        200:
          description: "List public-safe Web Status fingerprints"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/web4/status":
    get:
      summary: "Get legacy Web Status alias"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Web Status"
      responses:
        200:
          description: "Get legacy Web Status alias"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/web4/manifest":
    get:
      summary: "Get legacy Web Status manifest alias"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Web Status"
      responses:
        200:
          description: "Get legacy Web Status manifest alias"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/web4/scorecard":
    get:
      summary: "Get legacy Web Status scorecard alias"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Web Status"
      responses:
        200:
          description: "Get legacy Web Status scorecard alias"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/web4/fingerprints":
    get:
      summary: "List legacy public-safe Web Status fingerprints alias"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Web Status"
      responses:
        200:
          description: "List legacy public-safe Web Status fingerprints alias"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/provenance/lookup":
    get:
      summary: "Lookup public provenance"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Provenance"
      responses:
        200:
          description: "Lookup public provenance"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
  "/api/provenance/verify":
    get:
      summary: "Verify public provenance"
      description: "Public-safe read or bounded public evaluation operation."
      tags:
        - "Provenance"
      responses:
        200:
          description: "Verify public provenance"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: true
                  data:
                    type: "object"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                        enum:
                          - "aws_postgres"
                          - "memory"
                          - "generated"
                          - "remote"
                          - "fallback"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                required:
                  - "ok"
                  - "data"
        400:
          description: "Bad request"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        401:
          description: "Unauthorized for protected operations"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        404:
          description: "Not found"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
        500:
          description: "Internal server error"
          content:
            "application/json":
              schema:
                type: "object"
                properties:
                  ok:
                    type: "boolean"
                    const: false
                  data:
                    type: "null"
                  meta:
                    type: "object"
                    properties:
                      generatedAt:
                        type: "string"
                        format: "date-time"
                      traceId:
                        type: "string"
                      degraded:
                        type: "boolean"
                      source:
                        type: "string"
                  warnings:
                    type: "array"
                    items:
                      type: "object"
                  errors:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        code:
                          type: "string"
                        message:
                          type: "string"
                      required:
                        - "code"
                        - "message"
                  error:
                    type: "object"
                    properties:
                      code:
                        type: "string"
                      message:
                        type: "string"
                      details:
{}
                    required:
                      - "code"
                      - "message"
                required:
                  - "ok"
components:
  schemas:
    SuccessEnvelope:
      type: "object"
      properties:
        ok:
          type: "boolean"
          const: true
        data:
          type: "object"
        meta:
          type: "object"
          properties:
            generatedAt:
              type: "string"
              format: "date-time"
            traceId:
              type: "string"
            degraded:
              type: "boolean"
            source:
              type: "string"
              enum:
                - "aws_postgres"
                - "memory"
                - "generated"
                - "remote"
                - "fallback"
        warnings:
          type: "array"
          items:
            type: "object"
        errors:
          type: "array"
          items:
            type: "object"
      required:
        - "ok"
        - "data"
    ErrorEnvelope:
      type: "object"
      properties:
        ok:
          type: "boolean"
          const: false
        data:
          type: "null"
        meta:
          type: "object"
          properties:
            generatedAt:
              type: "string"
              format: "date-time"
            traceId:
              type: "string"
            degraded:
              type: "boolean"
            source:
              type: "string"
        warnings:
          type: "array"
          items:
            type: "object"
        errors:
          type: "array"
          items:
            type: "object"
            properties:
              code:
                type: "string"
              message:
                type: "string"
            required:
              - "code"
              - "message"
        error:
          type: "object"
          properties:
            code:
              type: "string"
            message:
              type: "string"
            details:
{}
          required:
            - "code"
            - "message"
      required:
        - "ok"
  securitySchemes:
    PlatPhormBearer:
      type: "http"
      scheme: "bearer"
      description: "Use Authorization: Bearer $PLATPHORM_API_KEY"
    PlatPhormApiKey:
      type: "apiKey"
      in: "header"
      name: "X-PlatPhorm-API-Key"
      description: "Use X-PlatPhorm-API-Key: $PLATPHORM_API_KEY"
tags:
  - 
    name: "System"
  - 
    name: "Discovery"
  - 
    name: "MCP"
  - 
    name: "Registry"
  - 
    name: "Targets"
  - 
    name: "Capabilities"
  - 
    name: "Suites"
  - 
    name: "Builder"
  - 
    name: "Runs"
  - 
    name: "Evaluation"
  - 
    name: "Scorecards"
  - 
    name: "Release Gates"
  - 
    name: "Templates"
  - 
    name: "Benchmarks"
  - 
    name: "Integrations"
  - 
    name: "Agent Policy"
  - 
    name: "Reports"
  - 
    name: "Compare"
  - 
    name: "Regressions"
  - 
    name: "Evals"
  - 
    name: "Web Status"
  - 
    name: "Provenance"