# astronomy

Astronomy adapter pack — real ephemeris (sun/moon rise & set, moon phase & illumination, planet positions, seasons, Julian date) powered by astronomy-engine. Loaded by leumas-api /api/astronomy.


Real observational astronomy — powered by the pure-JS **astronomy-engine** ephemeris (a bundled
dependency; see `package.json`). No network calls; all values are computed astronomical quantities.

## Tools

| Tool | Args | Returns |
|---|---|---|
| `sunTimes` | `{ date, latitude, longitude, elevation? }` | sunrise / sunset / solar noon |
| `moonPhase` | `{ date? }` | phase angle, name, illumination % |
| `moonTimes` | `{ date, latitude, longitude }` | moonrise / moonset |
| `planetPosition` | `{ body, date?, latitude?, longitude? }` | RA/Dec (+ alt/az with an observer) |
| `nextFullMoon` / `nextNewMoon` | `{ date? }` | next occurrence (ISO) |
| `seasons` | `{ year }` | equinoxes & solstices |
| `julianDate` | `{ date? }` | Julian date (UT) |
| `visiblePlanets` | `{ date, latitude, longitude }` | planets above the horizon |

Bodies: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto.

**Boundary:** `astronomy` is observational (positions, rise/set, phases). Interpretive zodiac/natal
work lives in the `astrology` pack, which shares this same ephemeris core.


---
Source: shared/engines/adapters/domain/astronomy/README.md
Canonical: https://docs.leumas.tech/p/adapters/adapter-astronomy