{
  "openapi": "3.1.0",
  "info": {
    "title": "Incubagent Framework Catalog",
    "version": "0.1.0",
    "description": "Read-only access to Incubagent framework records. Research records are not executable recommendations and earnings are not guaranteed."
  },
  "servers": [{ "url": "https://incubagent.com" }],
  "paths": {
    "/api/v1/frameworks.json": {
      "get": {
        "operationId": "listFrameworks",
        "summary": "List current public frameworks",
        "responses": {
          "200": {
            "description": "Framework catalog",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Catalog" } } }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Catalog": {
        "type": "object",
        "required": ["schema_version", "notice", "frameworks"],
        "properties": {
          "schema_version": { "type": "string" },
          "generated_at": { "type": "string", "format": "date" },
          "notice": { "type": "string" },
          "frameworks": { "type": "array", "items": { "$ref": "#/components/schemas/Framework" } }
        }
      },
      "Framework": {
        "type": "object",
        "required": [
          "id", "name", "creator", "status", "eligible_regions", "human_approvals",
          "risk_factors", "verification", "review_by", "source_urls",
          "execution_available", "canonical_url"
        ],
        "properties": {
          "id": { "type": "string" },
          "name": { "type": "string" },
          "creator": {
            "type": "object",
            "required": ["display_name", "kind"],
            "properties": {
              "display_name": { "type": "string" },
              "kind": { "type": "string", "enum": ["internal", "independent"] }
            }
          },
          "status": { "type": "string", "enum": ["research", "pilot", "active", "paused"] },
          "summary": { "type": "string" },
          "eligible_regions": { "type": "array", "items": { "type": "string" } },
          "human_approvals": { "type": "array", "items": { "type": "string" } },
          "capital_required": { "type": "string" },
          "estimated_value": { "type": ["object", "null"] },
          "risk_factors": { "type": "array", "items": { "type": "string" } },
          "commission": { "type": "string" },
          "verification": { "type": "string" },
          "last_reviewed": { "type": "string", "format": "date" },
          "review_by": { "type": "string", "format": "date", "description": "Treat the framework as stale after this date unless a newer record is published." },
          "source_checked_at": { "type": ["string", "null"], "format": "date" },
          "source_urls": { "type": "array", "items": { "type": "string", "format": "uri" } },
          "version": { "type": "string" },
          "execution_available": { "type": "boolean" },
          "canonical_url": { "type": "string", "format": "uri" }
        }
      }
    }
  }
}