Rectification API

Runs the same engine as /event-score internally, pre-filtered to the top 3 candidates with a plain-text rank/confidence summary in each language. Note: this does NOT call the Astro Shivanii AI module — no LLM/AI logic is involved, it's the identical dasha+transit scoring math as /event-score (see that endpoint's docstring), just reformatted to the 3 best candidates. Use /event-score directly if you want the full candidate list and per-event dasha/transit score breakdown.

Return all 12 ascendant rising windows for the birth day with physical & personality traits. Use this when birth time is completely unknown.

The main rectification engine. Tests every candidate time inside ±time_range_minutes of approx_tob (and, when day_unknown=True, every day of that month too), scoring each by matching active Vimshottari dasha lords on your known event dates to the event-relevant houses, GATED by transiting Jupiter/Saturn/Rahu/Ketu/Mars on those same dates (Gochar) — dasha sets multi-year eligibility, transit is the trigger within it. Optionally (use_kp=true, OFF by default — see EventScoreRequest.use_kp) also gates by the real KP significator method (reuses this API's own /v1/kp house-significator logic); tested against the real case this engine is validated against and found genuinely neutral (no demonstrated benefit, plus real added computation cost), so it's available for callers who want the extra corroborating signal, not shipped as an on-by-default improvement. Also optionally (use_primary_directions=true, OFF by default — see EventScoreRequest.use_primary_directions) gates by classical Western Primary Directions; tested and found essentially no discriminating effect on the real case. Each event_breakdown[] entry exposes dasha_score/transit_score/kp_score/primary_directions_score separately alongside the combined score. Set use_transit=false to fall back to pure dasha-only scoring. Returns ranked candidates with confidence scores — the top result is your best-estimate rectified birth time (and date, when day_unknown=True).

KP ruling planet method: At the query moment, 6 ruling planets are identified. The birth time is valid when the Lagna sub lord at birth matches one of these. Returns ruling planets + sub lord for every 4-minute window in the search range.