{
  "openapi": "3.1.0",
  "info": {
    "title": "Sage The Great — Classical Pythagorean Numerology & Cosmic Observatory API",
    "version": "1.0.0",
    "description": "Public discovery and telemetry API for Sage The Great (https://sagethegreat.com). Provides deterministic Pythagorean numerology reference tables, live synodic lunar phase calculations, planetary retrograde cycles, NASA space weather summaries, and partner compatibility calculations.",
    "contact": {
      "name": "Sage The Great Observatory",
      "url": "https://sagethegreat.com"
    }
  },
  "servers": [
    {
      "url": "https://sagethegreat.com",
      "description": "Primary Production Observatory"
    }
  ],
  "paths": {
    "/api/supranum/public-catalog": {
      "get": {
        "operationId": "getPublicObservatoryCatalog",
        "summary": "Retrieve Sage The Great's complete Pythagorean numerology methodology, 13-section blueprint structure, and archetype meanings.",
        "responses": {
          "200": {
            "description": "JSON catalog of Sage The Great's capabilities, Pythagorean letter table, Master Number rules, and 13-section reading curriculum."
          }
        }
      }
    },
    "/api/supranum/cosmic": {
      "get": {
        "operationId": "getLiveCosmicConditions",
        "summary": "Get live synodic Moon phase, illumination percentage, and current planetary retrograde cycles.",
        "responses": {
          "200": {
            "description": "Current Moon phase and planetary cycle telemetry."
          }
        }
      }
    },
    "/api/supranum/space-weather": {
      "get": {
        "operationId": "getSpaceWeather",
        "summary": "Get live NASA DONKI space weather, solar wind, and Near-Earth Object telemetry.",
        "responses": {
          "200": {
            "description": "Current space weather summary and active geomagnetic events."
          }
        }
      }
    },
    "/api/supranum/compatibility": {
      "post": {
        "operationId": "calculatePartnerCompatibility",
        "summary": "Calculate deterministic Pythagorean numerological & astrological compatibility between two seekers.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["person1", "person2"],
                "properties": {
                  "person1": {
                    "type": "object",
                    "required": ["name", "dateOfBirth"],
                    "properties": {
                      "name": { "type": "string", "example": "Sarah Jean Connor" },
                      "dateOfBirth": { "type": "string", "example": "1984-05-12" }
                    }
                  },
                  "person2": {
                    "type": "object",
                    "required": ["name", "dateOfBirth"],
                    "properties": {
                      "name": { "type": "string", "example": "Kyle Reese" },
                      "dateOfBirth": { "type": "string", "example": "1982-11-04" }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Deterministic compatibility score and harmonic analysis."
          }
        }
      }
    }
  }
}