Human Design gains two premium overlays: a personalized transit-chart (natal + transiting field, showing the channels a transit temporarily completes) and real connection (synastry) scoring on the composite endpoint. Both are Developer-tier.
＋Added
- New `POST /human-design/transit-chart`: overlays a transiting moment on a natal bodygraph and reports the channels the transit temporarily completes plus any newly-defined centers. Set `include_visual=true` for an overlay bodygraph SVG/PNG. Pro tier.
- MCP tools `explore_human_design_transit` and `explore_human_design_connection` render interactive overlay bodygraphs (transit and two-person connection) in MCP Apps hosts.
△Improved
- `POST /human-design/composite` now returns real connection-channel scoring — every connected channel typed electromagnetic / companionship / dominance / compromise, with combined-center definition and an optional two-person overlay bodygraph. It previously returned an empty result flagged "not yet enabled".
▽Deprecated
- `POST /human-design/composite` moved from Explorer (free) to Pro tier and now costs 3 credits (5 with a visual), matching the comparative relationship endpoints. Free-tier keys that called the previously-stubbed endpoint now receive HTTP 403 `tier_upgrade_required`.
Astrocartography gains an angle-epoch overlay frame, opt-in Human Design gate enrichment, and power-line geometry straight from CCG; geocoding autocomplete gains locale/region bias; ACG crossings now carry structured aspect data.
＋Added
- ACG `angle_epoch` overlay frame: relocated angle lines can be computed against a chosen epoch rather than the natal moment, so epoch-sensitive frames — most notably the Human Design Design line — resolve against the correct time base. (OE-BUG-2026-007)
- Opt-in Human Design gate enrichment on every ACG line type: line and crossing responses can now carry the HD gate and line each activation falls in.
- `include_lines` on `/acg/ccg`: a single call now returns the underlying power-line geometry alongside the CCG crossings, instead of requiring a second request to reconstruct the lines.
△Improved
- Geocoding `/location/autocomplete` now accepts country / region / admin1 / near bias and returns readable region names (e.g. "Springfield, IL"), so birth-data and relocation lookups resolve to the intended place far more often. (OE-BUG-2026-009)
- ACG crossing responses now carry structured `aspect_type` and `angle_type` fields and propagate full aspect data onto each crossing, so clients no longer parse a combined string to know what a crossing is. (OE-BUG-2026-013)
Precomputed-positions rendering for bi-wheel and chart-wheel, per-planet condition on natal & relocation, broader LLM-format coverage, and cleaner JSON output.
＋Added
- Precomputed positions for /visualization/bi-wheel and /visualization/chart-wheel: each subject may supply a `positions` array (plus optional `houses`) instead of birth params, rendering any chart — solar arc directions, progressed/transit hybrids, or parity-exact rings — directly from supplied longitudes. Mixed mode (one ring cast from birth data, the other from positions) is supported, and the emitted SVG/PNG data-attributes are identical to the birth-cast path.
- Per-planet condition data now surfaced on natal and relocation chart responses.
- `no_logo` query parameter on wheel renders suppresses the OpenEphemeris watermark for white-label embeds.
△Improved
- Expanded `?format=llm` token-optimized output to BaZi, Vedic, and predictive returns.
- Optional fields that are unset are now omitted from responses rather than serialized as `null`, for cleaner JSON across the API. (Clients should treat an absent field and a `null` field identically.)
⬡Fixed
- CCG snapshot bodies now include `speed_deg_day` and `is_retrograde`, so retrograde glyphs render correctly in positions-based CCG hybrid wheels.
- The Sun is no longer ever flagged out-of-bounds in per-planet condition.
Major expansion adding Vedic (Jyotish), BaZi (Four Pillars), and Advanced Parans to the API, alongside comprehensive BiWheel comparison modes.
＋Added
- Vedic (Jyotish) API surface: Access sidereal calculations, dashas, and traditional yogas
- BaZi (Four Pillars) API surface: Complete Chinese astrological analysis including earthly branches, heavenly stems, and 10-year luck pillars
- Advanced Angular Paran Engine (Scale Tier): High-fidelity cross-chart relational parans and CCG temporal parans with temporal crossing resolution
- Comprehensive Chart Comparison (BiWheel): Added API and MCP support for Secondary Progressions, Solar Returns, Lunar Returns, and Solar Arc Directions with mode-aware synopses
△Improved
- Expanded overall API coverage by +18 public endpoints (bringing the total to 118)
Accuracy and schema fixes — corrected Chiron orbital elements, house system selection, and progressed chart field mapping
△Improved
- Progressed chart metadata now includes proper ISO datetime fields and calculation metadata instead of raw Julian Day numbers
- Progressed chart house system respects the configuration.house_system field instead of defaulting to Placidus
⬡Fixed
- Progressed chart endpoint now returns fully populated planet fields (sign_name, sign_longitude, longitude_speed, is_retrograde) — previously lost during an internal serialization step
- House system selection works with human-readable names (whole_sign, koch, campanus, etc.) in addition to single-letter codes — clients sending house_system at the request root are now handled correctly
- Chiron and Pholus positional accuracy improved by updating Keplerian orbital elements to JPL Horizons J2000.0 epoch values, reducing propagation error for historical charts
Professional BaZi analytical engine — six new Chinese astrology endpoints, 24 Solar Terms, and MCP v3.9.2
＋Added
- GET /chinese/bazi/{date}/ten-gods — Ten Gods (十神) analysis: every stem in the chart related to the Day Master using the full 10×10 polarity matrix
- GET /chinese/bazi/{date}/luck-pillars — Luck Pillars (大運): ten-year cycles computed from solar term distance at the traditional 3-days-per-year rate
- GET /chinese/bazi/{date}/annual-pillar — Annual Pillar (流年): current year sexagenary overlay with clash and combination analysis against the natal chart
- GET /chinese/bazi/{date}/compatibility — BaZi compatibility (八字合婚): structural relational analysis of two natal charts including Six Clash detection
- GET /chinese/bazi/{date}/element-balance — Wu Xing element balance: Five Element distribution across stems and branches with Day Master strength assessment
- GET /chinese/solar-terms/{year} — All 24 Solar Terms (節氣) for any year, computed from the ephemeris engine to the exact minute
△Improved
- BaZi math engine now includes bazi_hidden_stems.go, bazi_ten_gods.go, bazi_nayin.go, bazi_luck_pillars.go, bazi_compatibility.go, and bazi_element_balance.go — all validated against 56 canonical reference cases
- AllSolarTermsForYear resolves all 24 Jieqi via bisection against the DE440 ephemeris — consistent with natal month pillar computation by construction
- Advanced BaZi endpoints priced at 3 credits (on par with comparative math); basic natal BaZi remains 1 credit
- MCP server updated to v3.9.2 — BaZi analytical tools available to Claude and all MCP-compatible AI agents
- Total public API surface: 116 endpoints across Western, Vedic, Human Design, astrocartography, Chinese, and astronomical calendar traditions
Human Design body graph API, visual chart deliverables, expanded transit bodies, and MCP v3.8.0
＋Added
- POST /human-design/chart — full body graph data: gate and channel activations, defined centers, type, authority, profile, and incarnation cross
- POST /visualization/bodygraph — server-rendered SVG and PNG body graph image (Pro tier+)
- human_design_bodygraph MCP tool — AI assistants can now request rendered body graphs directly
- POST /human-design/composite — composite connection chart for two subjects
- POST /human-design/transit — transiting gates and channels overlaid on the natal design
- POST /human-design/cycles/solar-return, /cycles/return, /cycles/opposition — Human Design life cycle charts
- POST /human-design/penta — group field penta computation
- include_visual: true flag on natal and HD chart endpoints — returns embedded SVG or PNG in a single API response
- Chiron, True Node, South Node, Lilith, and Ceres added to the /predictive/transit-chart body catalog
- All ephemeris kernels bundled into the Docker image — enables horizontal scaling without shared file storage
△Improved
- MCP server updated to v3.8.0 with readOnlyHint annotations for Anthropic directory compliance
- MCP README expanded with full tool surface documentation and setup instructions
⬡Fixed
- Human Design 10-57 channel was not rendering in body graph output
- Duplicate point geometries for Lilith/Nodes resolved via native EclipticToEquatorial fallback
- Chiron mathematical drift resolved
Relocated cardinal angles, True Lilith math fix, and documentation improvements
＋Added
- Cardinal angles (AC, DC, MC, IC) in /acg/local-space with azimuth, altitude, and above-horizon metadata
△Improved
- Documentation page redesigned with text-reveal animations and shimmer copy buttons
⬡Fixed
- True Lilith (OscuLilith) now computed from orbital state vectors — previously crashed the Go sidecar
- MeanNode, MeanLilith, and TrueNode RA/Dec zeroed in analytical path (OE-NODE-001)
- Midpoint features returned empty in /acg/features (OE-MIDPOINT-001)
BSP asteroid precision, draconic charts, and predictive time-lord endpoints
＋Added
- 12 sb441-n16 perturber bodies exposed via high-precision BSP asteroid integration
- Draconic chart, prenatal lunation, and primary directions endpoints — 107 total API surface
- Profections and Firdaria time-lord endpoints wired end-to-end with sect-aware overrides
- Pholus (SE ID 16) added to natal chart body list
△Improved
- Time-lord sect and Lot overrides finalized; return charts now hydrated with full chart data
- Pholus and Chiron upgraded to high-precision sb441-n16 ephemerides
- MCP server tool surface expanded with full README documentation
⬡Fixed
- Pholus mapping fix and res variable scoping in make_ephem_object branch
- NAIF ID routing (2000000+N) corrected for asteroid lookups
- SuperNOVAS compilation fixed with absolute path for Go sidecar
MCP registry submission, billing tier corrections, and public surface audit
＋Added
- MCP server published to Smithery registry with full tool surface documentation
- Health catalog endpoints opened to free tier for API discoverability
- Landing page redesigned — AI API explicitly positioned as the Master Astrologer endpoint
△Improved
- Public surface audit — README rewrite, gitignore cleanup, stale endpoint counts corrected across all meta tags
- OpenAPI spec synced and equivalence-tested against live schema
- MCP allowlist regenerated and test thresholds updated
⬡Fixed
- /ephemeris/schemas/natal-request and /ephemeris/supported-metadata set to 0 credits (were incorrectly billable)
- Delete-account flow: hard-delete FK-referencing rows before auth user deletion
- Annual savings label corrected to 24%
- .vercelignore pattern fixed — was stripping components/dev/ from production build