openapi: 3.1.0
info:
  title: PlatPhorm Capability Catalog
  version: 1.0.0
  description: Static public catalog artifacts for repositories, capabilities, search, graph, and reuse recommendations.
servers:
  - url: https://catalog.platphormnews.com
paths:
  /api/health:
    get:
      summary: Static catalog health
      responses:
        '200':
          description: Catalog health and generation status
  /api/v1/health:
    get:
      summary: Versioned static catalog health
      responses:
        '200':
          description: Catalog health and generation status
  /api/mcp:
    get:
      summary: MCP server metadata and public read-only capability names
      responses:
        '200':
          description: MCP endpoint metadata
    post:
      summary: Public read-only JSON-RPC MCP transport
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: JSON-RPC response
  /catalog/generated/capabilities.json:
    get:
      summary: Global capability index
      responses:
        '200':
          description: Global capability index JSON
  /catalog/generated/repos.json:
    get:
      summary: Repository index
      responses:
        '200':
          description: Repository index JSON
  /catalog/generated/search-index.json:
    get:
      summary: Search index
      responses:
        '200':
          description: Plain JSON search index
  /catalog/generated/best-implementations.json:
    get:
      summary: Best implementation rankings
      responses:
        '200':
          description: Best reusable implementation candidates
  /catalog/generated/vision-tool-selection.json:
    get:
      summary: Vision tool selection
      responses:
        '200':
          description: Browser, PlatPhorm Content, and PlatPhorm Docs mapped to catalog capabilities
  /api/vision/capabilities:
    get:
      summary: Vision capability selection API
      responses:
        '200':
          description: Standard ok/data wrapper around the public vision selection artifact
  /api/vision/evidence-pack:
    get:
      summary: Vision evidence pack API
      responses:
        '200':
          description: Preview-only JSON and Markdown-ready evidence pack generated from catalog state
  /catalog/generated/vision-evidence-pack.json:
    get:
      summary: Static vision evidence pack
      responses:
        '200':
          description: Public read-only evidence pack artifact
  /rss.xml:
    get:
      summary: Capability update feed
      responses:
        '200':
          description: RSS feed of high-signal catalog capabilities
components:
  securitySchemes:
    PlatPhormApiKey:
      type: apiKey
      in: header
      name: X-PlatPhorm-API-Key
      description: Future protected catalog mutations use PLATPHORM_API_KEY. Public catalog reads require no auth.
    PlatPhormBearer:
      type: http
      scheme: bearer
      description: 'Future protected catalog mutations also accept Authorization: Bearer $PLATPHORM_API_KEY.'