Celestium: Cosmic Compass

{'type': 'object', 'required': ['action'], 'properties': {'data': {'type': 'object', 'description': 'Birth data + params. birth: {name, birth_date (YYYY-MM-DD), birth_time (HH:MM), birth_timezone (IANA), latitude, longitude, birth_location}. partner: same birth shape (synastry/composite/davison; also adds relationship activations to cosmic_weather/check_in). For place-based actions (relocation, relocation_score, planetary_hours, sunrise, heliacal, electional), top-level latitude/longitude = the TARGET location. Plus optional date, start, end, return_type (solar|lunar), city, planet, number (harmonic), orb (antiscia), system (sidereal: lahiri|raman|kp), activity (electional: marriage|business|travel|surgery|legal_matter|creative_work|investment|medical_treatment), ritual: type + max_minutes; tarot: count (1-3) + question; iching: question; check_in: mood, focus, intent, local_hour; review: period (week|month) or start+end; horary: question + house (1-12) + latitude/longitude; bazi: gender (male|female). render: true (natal_reading only) â\x86\x92 also returns a viewable_url: a shareable, unlisted, auto-expiring, revocable web page of the chart+reading; render:{ttl_days:N} sets the expiry (default 90d), render:{burn:true} makes it view-once, render:{e2ee:true} encrypts it at rest (key only in the link #fragment; we store ciphertext and cannot read it). Nothing is stored unless you opt in with render; without it, calls are pure compute.'}, 'action': {'enum': ['cosmic_weather', 'chart', 'positions', 'moon', 'moment_quality', 'retrograde', 'voc', 'planetary_hours', 'sunrise', 'ritual', 'tarot', 'check_in', 'natal_reading', 'iching', 'mayan', 'numerology', 'true_sky', 'event_debrief', 'composite', 'davison', 'relocation', 'relocation_score', 'travel', 'transits', 'synastry', 'timing', 'progressions', 'electional', 'horary', 'returns', 'timeline', 'synthesis', 'perfections', 'midpoints', 'harmonic', 'antiscia', 'declination', 'sidereal', 'heliacal', 'review', 'bazi', 'year_ahead', 'correlate', 'common_threads'], 'type': 'string', 'description': 'The astrology/divination action to run.'}, 'identity': {'type': 'string', 'description': 'Caller email/identity (resolves entitlement tier; optional in free tier).'}}}