{
  "openapi": "3.1.0",
  "info": {
    "title": "ReviOS API",
    "version": "1.0.0",
    "description": "Public APIs for ReviOS documentation, search index, and AI ingestion."
  },
  "servers": [
    {
      "url": "https://revi.cc",
      "description": "Production Server"
    }
  ],
  "paths": {
    "/api/search": {
      "get": {
        "summary": "Search Index",
        "description": "Returns the static compiled ZBSearch documentation index.",
        "operationId": "getSearchIndex",
        "responses": {
          "200": {
            "description": "ZBSearch index database object",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "example": "advanced"
                    },
                    "docs": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "LLMs Index",
        "description": "Returns structured plain text index of documentation for AI agents.",
        "operationId": "getLlmsIndex",
        "responses": {
          "200": {
            "description": "Plain text documentation index",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "summary": "LLMs Full Documentation Corpus",
        "description": "Returns concatenated full plain text documentation corpus for AI ingestion.",
        "operationId": "getLlmsFull",
        "responses": {
          "200": {
            "description": "Full markdown documentation corpus",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/api/health": {
      "get": {
        "summary": "Health Check",
        "description": "Returns operational health and availability status.",
        "operationId": "getHealth",
        "responses": {
          "200": {
            "description": "Health status",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    }
                  },
                  "required": [
                    "status"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "summary": "RFC 9727 API Catalog",
        "description": "Machine-readable directory of APIs exposed by ReviOS.",
        "operationId": "getApiCatalog",
        "responses": {
          "200": {
            "description": "API Catalog linkset",
            "content": {
              "application/linkset+json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "linkset": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  },
                  "required": [
                    "linkset"
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}