{
  "openapi": "3.1.0",
  "info": {
    "title": "JRM Accessories Public Storefront Discovery",
    "version": "0.1.0",
    "description": "Public, read-only discovery description for JRM Accessories. This description does not expose customer, order, payment, admin, supplier, inventory, cost, margin, or private Shopify data."
  },
  "servers": [
    {
      "url": "https://jrmaccessories.com",
      "description": "JRM Accessories public Shopify storefront"
    }
  ],
  "paths": {
    "/agents.md": {
      "get": {
        "summary": "Read public agent instructions",
        "description": "Returns public Markdown instructions for agents using the JRM Accessories storefront.",
        "responses": {
          "200": {
            "description": "Agent instructions"
          }
        }
      }
    },
    "/.well-known/ucp": {
      "get": {
        "summary": "Read Shopify UCP discovery profile",
        "description": "Returns Shopify-generated UCP discovery metadata where available.",
        "responses": {
          "200": {
            "description": "UCP discovery profile"
          }
        }
      }
    },
    "/products/{handle}.js": {
      "get": {
        "summary": "Read public Shopify product JSON by product handle",
        "description": "Returns public product JSON from Shopify's Ajax Product API. Use only for public product discovery. Do not infer sales, margin, best sellers, supplier reliability, or complete inventory truth from this endpoint.",
        "parameters": [
          {
            "name": "handle",
            "in": "path",
            "required": true,
            "description": "Shopify product handle",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Public product JSON"
          },
          "404": {
            "description": "Product not found"
          }
        }
      }
    },
    "/{locale}/products/{handle}.js": {
      "get": {
        "summary": "Read localized public Shopify product JSON by product handle",
        "description": "Locale-aware version of Shopify's Ajax Product API product endpoint.",
        "parameters": [
          {
            "name": "locale",
            "in": "path",
            "required": true,
            "description": "Locale path segment, for example en, de, fr, or another storefront locale if enabled.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "handle",
            "in": "path",
            "required": true,
            "description": "Shopify product handle",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Localized public product JSON"
          },
          "404": {
            "description": "Product or locale not found"
          }
        }
      }
    },
    "/collections/all": {
      "get": {
        "summary": "Browse public all-products collection",
        "description": "Public storefront collection page for product discovery. This is an HTML page, not a private API.",
        "responses": {
          "200": {
            "description": "Public collection HTML"
          }
        }
      }
    },
    "/policies/shipping-policy": {
      "get": {
        "summary": "Read public shipping policy",
        "description": "Public shipping policy page.",
        "responses": {
          "200": {
            "description": "Public shipping policy HTML"
          }
        }
      }
    },
    "/policies/refund-policy": {
      "get": {
        "summary": "Read public refund policy",
        "description": "Public refund and returns policy page.",
        "responses": {
          "200": {
            "description": "Public refund policy HTML"
          }
        }
      }
    }
  },
  "x-jrm-accessories-data-boundaries": {
    "allowed": [
      "public storefront pages",
      "public product pages",
      "public collection pages",
      "public policy pages",
      "public agent instructions",
      "public Shopify UCP discovery profile"
    ],
    "not_exposed": [
      "customer data",
      "order data",
      "payment data",
      "Shopify Admin API",
      "supplier data",
      "COGS",
      "margin data",
      "private inventory truth",
      "private analytics",
      "private support messages"
    ],
    "human_review_required_for": [
      "checkout automation",
      "payment automation",
      "customer or order data access",
      "inventory claims",
      "pricing or margin decisions",
      "supplier or fulfillment decisions",
      "material claims beyond public product copy"
    ]
  }
}