{
  "openapi": "3.1.0",
  "info": {
    "title": "Blackhole Cybersecurity Agent Discovery API",
    "version": "1.0.0",
    "description": "Read-only public metadata for automated discovery of the Blackhole Cybersecurity website."
  },
  "servers": [
    {
      "url": "https://blackholecyberstrategy.com"
    }
  ],
  "paths": {
    "/.well-known/site-description.json": {
      "get": {
        "summary": "Get the website description",
        "operationId": "getSiteDescription",
        "responses": {
          "200": {
            "description": "Machine-readable website description",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["@context", "@type", "name", "url", "description", "inLanguage"],
                  "properties": {
                    "@context": { "type": "string", "format": "uri" },
                    "@type": { "type": "string", "const": "WebSite" },
                    "name": { "type": "string" },
                    "url": { "type": "string", "format": "uri" },
                    "description": { "type": "string" },
                    "inLanguage": { "type": "string" }
                  },
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/api-status.json": {
      "get": {
        "summary": "Get discovery API status",
        "operationId": "getApiStatus",
        "responses": {
          "200": {
            "description": "The public discovery API is available",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["status", "service", "version"],
                  "properties": {
                    "status": { "type": "string", "const": "ok" },
                    "service": { "type": "string", "const": "agent-discovery" },
                    "version": { "type": "string", "const": "1.0.0" }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    }
  }
}