Spacecraft

Manages the shared spacecraft catalogue used across this repo — the same catalogue fetch_tle and ops-orbit-propagator resolve a spacecraft's official name against. The catalogue has two layers:

• Built-in spacecraft — bootstrapped at import time from the committed seed file skills/ops-spacecraft-catalogue/data/spacecraft_catalogue.json (ISS, the ESA Sentinel-1/2/3/5P/6 series, Swarm-A/B/C, Aeolus, CryoSat-2, EarthCARE, OPS-SAT PRETTY — plus their aliases, e.g. s2a→SENTINEL-2A, pretty→OPS-SAT PRETTY, cryosat→CRYOSAT 2). These can never be overwritten or removed by add; change them only by editing that seed file in a PR.
• Added spacecraft — anything registered with add is persisted to skills/ops-spacecraft-catalogue/data/custom_spacecraft.json (gitignored, machine-local), so it's immediately visible to any later fetch_tle/ops-orbit-propagator invocation and future runs of this script — no restart needed.

All catalogue data lives inside this skill's own data/ directory — nothing is stored elsewhere in the repo.

add rejects a name or alias that already exists in either layer, so built-ins are always safe from collision.

Unlike ops-ground-stations-catalogue's lookup, a spacecraft lookup miss is reported as a plain "not found" result rather than treating an unresolved identifier as an error condition in the underlying catalogue — the CLI script still exits non-zero in that case, so scripted callers can detect it the same way.

Instructions