RELEASE_NOTES_5.2.3 - TheDaniel166/moira GitHub Wiki
Moira 5.2.3 - Installed Small-Body Manifest Readiness
Release date: 2026-07-25
Public upgrade path: 5.2.2 to 5.2.3
Moira 5.2.3 is an operational-correctness patch for asteroid and comet kernel discovery. It does not change astronomical calculations, catalog membership, public result vessels, or BSP data.
What Changed
Published wheels retain asteroid and comet manifests as catalog and provenance
metadata, while their large BSP shards remain separately installed resources.
Earlier automatic discovery treated the presence of those metadata files as
proof that the corresponding ephemeris was installed. A wheel used alongside
an external small-body ephemeris could therefore report a missing packaged
shard in Moira.kernel_status and the server /ready receipt even though the
external ephemeris was loaded and functional.
Automatic discovery now admits a manifest only when at least one shard it references is present:
- metadata-only wheel manifests remain available as packaged records but are not treated as installed ephemerides;
- complete external manifests load normally;
- partial installations remain discoverable so the shard loader rejects them rather than silently hiding corruption; and
MOIRA_SOVEREIGN_SMALL_BODY_MANIFESTremains an explicit, strict operator instruction and is never suppressed by automatic discovery policy.
Asteroid And Comet Data Boundary
No asteroid or comet manifest content, BSP shard, catalog identity, family membership, coverage interval, or NAIF mapping changed in this release. Existing external ephemerides remain the positional authority until a later shard set is fully built, validated, and admitted as one coherent manifest-owned resource.
Validation
The release exercises:
- metadata-only automatic discovery;
- complete installed-manifest discovery;
- partial-installation fail visibility;
- explicit-manifest fail visibility;
- facade kernel readiness; and
- REST server startup and
/readybehavior.
A wheel-shaped isolated installation confirms that packaged manifests without their large BSP shards are not admitted as installed ephemerides.