{
  "openapi": "3.1.0",
  "info": {
    "title": "Joe's Brand Consumer Goods API",
    "description": "Agentic API for discovering, filtering, and querying authentic consumer packaged goods (CPG) bearing the name 'Joe' or 'Joe's'. Designed for AI agents, LLM tool-calling, and semantic search.",
    "version": "1.0.0",
    "contact": {
      "name": "Joe's Brand Curation Team",
      "url": "https://joesbrand.pages.dev"
    }
  },
  "servers": [
    {
      "url": "https://joesbrand.pages.dev",
      "description": "Production Cloudflare Pages Edge"
    }
  ],
  "paths": {
    "/api/products.json": {
      "get": {
        "operationId": "getJoeProducts",
        "summary": "Retrieve complete catalog of products named Joe or Joe's",
        "description": "Returns full specifications, ingredients, origin, packaging format, retail distribution, brand stories, and authentic image URLs for all 18 curated CPG products.",
        "responses": {
          "200": {
            "description": "Successful retrieval of product catalog",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductCatalogResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/founders.json": {
      "get": {
        "operationId": "getJoeFounders",
        "summary": "Retrieve biographies of authentic entrepreneurs named Joe",
        "description": "Returns verified entrepreneurial histories for Joe Ferrara (Joe Tea & Chips), Joe Davidson (Joe's Kansas City BBQ), and Joe Lazzara (Joe's Butcher Shop & Fish Market).",
        "responses": {
          "200": {
            "description": "Successful retrieval of founders data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FoundersResponse"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLLMsSummary",
        "summary": "Retrieve LLM-optimized Markdown index",
        "description": "Returns concise structured markdown index outlining site capabilities, catalog hierarchy, and knowledge base for AI agents.",
        "responses": {
          "200": {
            "description": "LLM discovery markdown document",
            "content": {
              "text/markdown": {}
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "operationId": "getLLMsFullContext",
        "summary": "Retrieve complete LLM prompt context",
        "description": "Returns complete uncompressed context including every product, ingredient breakdown, formulation, and founder story in a single prompt-optimized file.",
        "responses": {
          "200": {
            "description": "Full LLM context document",
            "content": {
              "text/plain": {}
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ProductCatalogResponse": {
        "type": "object",
        "properties": {
          "version": { "type": "string" },
          "totalProducts": { "type": "integer" },
          "categories": {
            "type": "array",
            "items": { "type": "string" }
          },
          "products": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/ProductItem" }
          }
        }
      },
      "ProductItem": {
        "type": "object",
        "properties": {
          "id": { "type": "string" },
          "code": { "type": "string" },
          "name": { "type": "string" },
          "brand": { "type": "string" },
          "category": { "type": "string" },
          "format": { "type": "string" },
          "origin": { "type": "string" },
          "distribution": { "type": "string" },
          "website": { "type": "string", "format": "uri" },
          "image": { "type": "string" },
          "image_url": { "type": "string", "format": "uri" },
          "summary": { "type": "string" },
          "specs": { "type": "string" },
          "brandStory": { "type": "string" },
          "retail": { "type": "string" },
          "variants": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": { "type": "string" },
                "label": { "type": "string" },
                "type": { "type": "string" },
                "name": { "type": "string" },
                "image": { "type": "string" },
                "format": { "type": "string" },
                "specs": { "type": "string" }
              }
            }
          }
        },
        "required": ["id", "code", "name", "brand", "category", "format", "origin", "summary"]
      },
      "FoundersResponse": {
        "type": "object",
        "properties": {
          "version": { "type": "string" },
          "totalFounders": { "type": "integer" },
          "founders": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": { "type": "string" },
                "name": { "type": "string" },
                "brand": { "type": "string" },
                "company": { "type": "string" },
                "foundedYear": { "type": "integer" },
                "location": { "type": "string" },
                "flagshipProducts": { "type": "array", "items": { "type": "string" } },
                "biography": { "type": "string" },
                "logo_url": { "type": "string" },
                "website": { "type": "string" }
              }
            }
          }
        }
      }
    }
  }
}