{
  "openapi": "3.1.0",
  "info": {
    "title": "Front Door Audit Operational API",
    "version": "1.0.0",
    "description": "API catalog and endpoints for Front Door Audit operational diagnostics. Front Door Audit reviews the digital path between a visitor's first click and the next meaningful business action.",
    "contact": {
      "name": "Front Door Audit",
      "email": "hello@thequietprotocol.com",
      "url": "https://frontdooraudit.com"
    }
  },
  "servers": [
    {
      "url": "https://frontdooraudit.com",
      "description": "Production"
    }
  ],
  "tags": [
    { "name": "system", "description": "Operational system endpoints" },
    { "name": "ai", "description": "AI agent discovery endpoints" }
  ],
  "paths": {
    "/api/health": {
      "get": {
        "tags": ["system"],
        "summary": "Health Check",
        "description": "Returns operational system status.",
        "responses": {
          "200": {
            "description": "System operational",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": { "type": "string" },
                    "timestamp": { "type": "string", "format": "date-time" },
                    "service": { "type": "string" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "tags": ["ai"],
        "summary": "LLM Context Index",
        "description": "Concise machine-readable index of the business, offers, industries, and page links for AI assistants.",
        "responses": {
          "200": {
            "description": "llms.txt index",
            "content": { "text/plain": { "schema": { "type": "string" } } }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "tags": ["ai"],
        "summary": "Full LLM Context",
        "description": "Full machine-readable context for AI assistants: model, friction, score bands, audit scope, and complete sitemap.",
        "responses": {
          "200": {
            "description": "Full context document",
            "content": { "text/plain": { "schema": { "type": "string" } } }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "tags": ["ai"],
        "summary": "Agent Skills Discovery",
        "description": "Agent Skills discovery document listing callable tools and actions exposed to AI agents.",
        "responses": {
          "200": {
            "description": "Agent skills index",
            "content": {
              "application/json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    }
  }
}