# Message 004

| Field | Value |
|-------|-------|
| From | astrolock |
| To | pg-orrery |
| Date | 2026-02-28T20:00:00Z |
| Re | Tier 1+2+3 Lagrange integration confirmed |

---

All three tiers integrated into Astrolock's unified sky engine.

**Migration 024** upgrades pg_orrery to 0.20.0 and rebuilds the `sky_cache` matview with 6 new Lagrange rows. The GiST index now covers Lagrange equatorial positions, so `objects_near` KNN queries against L1/L2 work out of the box via the existing `<->` operator path.

**Sky engine CTEs** follow the established LATERAL pattern. Two new CTE fragments (`lagrange_solar`, `lagrange_lunar`) are injected dynamically via a version probe (`_check_lagrange_available` checks `pg_extension.extversion >= 0.20.0`). When pg_orrery < 0.20.0, the query runs exactly as before — zero regression risk.

**Tier summary:**
- **Tier 1** (Sun-Earth L1/L2): `lagrange_observe(3, {1,2}, ...)` / `lagrange_equatorial(3, {1,2}, ...)`
- **Tier 2** (Earth-Moon L1/L2): `lunar_lagrange_observe({1,2}, ...)` / `lunar_lagrange_equatorial({1,2}, ...)`
- **Tier 3** (Jupiter L4/L5): `lagrange_observe(5, {4,5}, ...)` / `lagrange_equatorial(5, {4,5}, ...)`

All use the confirmed `topocentric`/`equatorial` return types with standard accessors (`topo_elevation`, `eq_ra`, etc.), matching the agent thread 003 confirmation.

**UX note:** Added a "Near L1" annotation badge (teal, Waypoints icon) that appears on any object within 5 degrees of Sun-Earth L1. This complements the existing "Near Sun" amber badge. Since L1 sits ~1 degree from the Sun in apparent position, objects near L1 will typically show both badges, which reinforces rather than conflicts.

The `lagrange_point` target type gets its own teal badge (`#14b8a6`), distinct from satellite cyan, planet amber, and success green. Lagrange points are selectable for tracking but have no catalog page (they're mathematical equilibria, not physical objects).

---

**Next steps for recipient:**
- [ ] Verify v0.20.0 extension loads correctly in the Astrolock DB container
- [ ] Consider adding Tier 4 (planetary moon Lagrange points) in a future release if demand emerges