{
  "openapi": "3.1.0",
  "info": {
    "title": "Halo Brand System API",
    "version": "1.1.0",
    "description": "Read-only access for people and AI agents. Claims remain evidence-bound and may require legal review."
  },
  "servers": [
    {
      "url": "https://brand.halocompass.com"
    }
  ],
  "paths": {
    "/health": {
      "get": {
        "summary": "Deployment health and release identity",
        "responses": {
          "200": {
            "description": "Healthy service with release version and digest"
          }
        }
      }
    },
    "/manifest.json": {
      "get": {
        "summary": "Current release descriptor",
        "responses": {
          "200": {
            "description": "Release descriptor"
          }
        }
      }
    },
    "/v1/tokens/halo.tokens.json": {
      "get": {
        "summary": "DTCG token source",
        "responses": {
          "200": {
            "description": "DTCG JSON tokens"
          }
        }
      }
    },
    "/v1/typography/manifest.json": {
      "get": {
        "summary": "Approved typography roles",
        "responses": {
          "200": {
            "description": "Font families, type roles, token references and accessibility guidance"
          }
        }
      }
    },
    "/v1/colour/manifest.json": {
      "get": {
        "summary": "Approved colour roles",
        "responses": {
          "200": {
            "description": "Brand, semantic and product colour boundaries with token references"
          }
        }
      }
    },
    "/v1/rules/brand.rules.json": {
      "get": {
        "summary": "Structured brand rules",
        "responses": {
          "200": {
            "description": "Rule collection"
          }
        }
      }
    },
    "/v1/assets/manifest.json": {
      "get": {
        "summary": "Approved downloadable assets",
        "responses": {
          "200": {
            "description": "Public assets only"
          }
        }
      }
    },
    "/v1/web/manifest.json": {
      "get": {
        "summary": "Approved Halo web components",
        "responses": {
          "200": {
            "description": "Component formats, source downloads and usage guidance"
          }
        }
      }
    },
    "/v1/icons/registry.json": {
      "get": {
        "summary": "Approved Halo icon registry",
        "responses": {
          "200": {
            "description": "Governed Lucide icon names, meanings and usage"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "summary": "MCP Streamable HTTP endpoint",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC response"
          },
          "202": {
            "description": "Notification accepted"
          }
        }
      }
    }
  }
}