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
  /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
  /rss.xml:
    get:
      summary: Capability update feed
      responses:
        '200':
          description: RSS feed of high-signal catalog capabilities