Search Transit Events

Search for various types of transit events within a date range.

**Features:**
- Exact crossings of target degrees, several passes per target (`results`)
- Opt-in orb windows (`orb_deg` / `aspect_orbs`): enter, every exact hit including retrograde re-passes, and leave, per continuous in-orb episode (`windows`), with applying/separating at the range start
- Natal points × aspects as labelled targets (`natal_points`, `aspects`)
- Configurable date ranges (plan limits: 1 year on Explorer/PAYG, 5 years on Pro, 10 years on Startup, 40 years on Scale and above)

**Performance:** one sampled track per planet shared by every target; the cost guard counts days × planets × targets.

**Pricing (by requested span, decided before any compute):** up to 1 year (367 days) = 5, up to 3 years (1097 days) = 10, up to 5 years (1828 days) = 15, up to 10 years (3654 days) = 25, up to 20 years (7306 days) = 40, up to 40 years (14611 days) = 70 credits. Plan limits: Explorer/PAYG 1 year, Pro 5 years, Startup 10 years, Scale and Enterprise 40 years. A span above your plan's limit is rejected with 400 `search_span_limit` naming the limit and the bracket that fits — nothing is charged. Any 4xx/5xx outcome is refunded, including a 429 compute_overload shed; rate-limit 429s are refused before anything is charged. Results are capped at 1000 transit events per response; past that the earliest 1000 are returned with `truncated: true` and `truncation.resume_from` to continue from.

**Deadline:** 30 s of compute on every plan. A search that runs out of time returns the bodies it finished with `truncated: true` (reason `deadline`, the unsearched bodies in `truncation.remaining`); if none finished it returns 503 `compute_timeout`, and the credits are refunded.