Governing Authority: Moira Canonical Instruction (AGENTS.md)
Original Audit Date: September 21, 2026
Last Reconciled: September 29, 2026
Baseline: current main; this is not a release-version manifest
Vedic completion entries are OUTDATED as a backlog (6 October 2026). Frontiers 10, 15 and 16 mix engine completion with incomplete transport or chart admission. Their corrections below point to the Vedic remaining work register. This notice does not re-audit or supersede the non-Vedic entries.
This register preserves the 2026-09-21 completion receipts and records the
remaining active validation and doctrinal frontiers identified in Moira’s core
engine (moira/), native substrate (src/native/), and server transport layer
(moira_server/). Completed entries below are historical receipts, not active
backlog.
In alignment with Moira’s Law of Policy Explicitness and Documentation Law, every item is recorded with its precise file anchor, architectural rationale, and verified gate conditions.
These items represent discrepancies between live executable code and comments or documentation, or small harness-level stubs.
| Target | Location | Classification | Current State & Resolution |
|---|---|---|---|
moira.sky Subsystem Headers |
moira/sky/__init__.py |
Stale Docstrings | REMEDIATED (2026-09-21). Removed stale [stub] markers from all 6 fully-implemented astronomy submodules (bodies, observation, galactic, events, eclipse, occultation) and synchronized the design contract. |
| Export Policy Subsystem | moira/_export_governance/ |
Dead Subsystem | REMEDIATED (2026-09-21). Excised unused moira/_export_governance package (11 modules), associated tests/export_governance (8 test suites / 162 tests), old audit reports (reports/governance/), and one-shot archived audit scripts. Port compliance verified across 282 engine files. |
| Stars Bulk Serializer | moira_server/serializers/stars.py |
Dead Transport Helper | REMEDIATED (2026-09-28). Removed the unused placeholder serializer. The live bulk-stars service constructs StarsBulkResponse directly from the validated request datetime. |
| House Dynamics and Polar-House Prose | moira/houses.py, HOUSES_BACKEND_STANDARD.md |
Stale / overstated documentation | REMEDIATED (2026-09-28). Reconciled the implemented dynamics surface, _POLAR_SYSTEMS == {'K'}, and internal analytical/invariant validation scope. |
The following projects were active frontiers during the original survey and are retained only as completion receipts. They are not current work items.
all_planets_at Cash-In)src/native/include/planetary_evaluator.hpp, src/native/bindings/moira_native.cpp, moira/planets.py.NativePlanetaryEvaluator::evaluate_all_planets_apparent_with_speed, reducing the three sequential Python-native boundary crossings for central finite-difference speed into a single GIL-released pass.resolved_segments_) across invocations, eliminating memory allocation and kernel mutex traffic._prefill_npe_public_vector_cache to iterate over all _NPE_ADMITTED_BODIES using canonical NAIF routes, eliminating the Mercury route lookup defect.v1-draft)docs/architecture/ASPECT_PATTERN_QUALITATIVE_SCORING_V1_DRAFT.md, moira/pattern_coherence.pymoira.pattern_coherence.qualitative.v1-draft in moira/pattern_coherence.py, re-exported through moira/patterns.py with AspectPattern.evaluate_coherence().Very strong, Strong, Moderate, Loose, Marginal) and Motion Qualifier (Motion unavailable, Partial motion, Station-sensitive, Exact, Applying, Separating, Mixed motion).NOT_ASSESSED.tests/unit/test_pattern_coherence_qualitative.py satisfying all 8 acceptance requirements (IEEE-754 adjacent boundary cuts, motion qualifier precedence, speed reversal independence, degenerate/adversarial handling, and Section 7 synthetic configurations).POST /v1/patterns/coherence (PatternCoherenceSearchResponse) and enriched discovery endpoint POST /v1/patterns/find embedding coherence: PatternCoherenceResponse | None on AspectPatternResponse.tests/server/test_server_pattern_coherence_routes.py (6/6 tests passing) verifying OpenAPI schema registration, engine-backed evaluation, filtering/dominance forwarding, and mock isolation.moira/primary_directions/, src/native/include/primary_directions.hpp, src/native/bindings/moira_native.cpp, moira/primary_directions/geometry.pysrc/native/include/primary_directions.hpp containing NativeSpeculumPoint, branch-independent continuous zenith distance invariant (campanus_regio_sin_zenith_distance), pole height solvers (regiomontanus_pole_height, topocentric_pole_height), oblique coordinate projector (under_pole_w), directed arc calculators (regiomontanus_under_pole_arc, topocentric_under_pole_arc), role-exchanged direct/converse arc pair solver (compute_under_pole_pair_arcs), and batched OpenMP matrix generator (compute_under_pole_arcs_matrix).| Formulated continuous vector/plane invariant $\sin ZD = | \text{transverse} | / \text{norm}$ where $\text{transverse} = \cos \delta \sin HA$ and $\text{meridional} = \cos \phi \cos \delta \cos HA + \sin \phi \sin \delta$, eliminating the classical meridian-quadrature ($MD = 90^\circ$) singularity without trigonometric discontinuities. |
Integrated seamless Python fallback and native dispatch in moira/primary_directions/geometry.py, achieving exact bit-level / sub-microarcsecond numerical parity ($ |
\Delta | < 10^{-12 \circ}$) with the pure-Python reference. |
tests/unit/test_native_primary_directions_parity.py.moira/houses.py, moira/experimental_*.py, src/native/include/houses.hpp, moira_server/routers/chart.py, moira_server/models/chart.pyhouses.hpp).Re-classified HouseSystem.CAMPANUS, HouseSystem.REGIOMONTANUS, and HouseSystem.TOPOCENTRIC as polar_capable=True. _POLAR_SYSTEMS reduced to {HouseSystem.KOCH} due to intrinsic diurnal semi-arc circumpolar collapse ($ |
\tan \phi \tan \delta_{\text{MC}} | > 1$). |
Under HousePolicy.default(), charts at polar latitudes ($ |
\phi | \ge 90^\circ - \varepsilon$) with admissible ARMC now automatically deliver real Campanus, Regiomontanus, or Topocentric cusps (effective_system=system, fallback=False), falling back cleanly to Porphyry with full provenance only when geometry degenerates or cusps fold. |
POST /v1/houses/polar-admissibility returning contiguous valid ARMC windows, valid fractions, sample counts, practical windows, and stability metrics.moira/primary_directions/timeline.py, moira/primary_directions/distributor.py, moira/primary_directions/keys.py, moira_server/routers/primary_directions.py, moira_server/models/primary_directions.pyresolve_distributor_chronology and resolve_primary_direction_bound_targets mapping direct and converse arc traversals through Egyptian and Ptolemaic bounds without missing segments or overlapping boundaries.tol_days=1e-6) in invert_solar_arc_ra and invert_solar_arc_lon, resolving exact solar non-uniformity across perihelion/aphelion velocities within $<30$ ephemeris queries. Added keys PrimaryDirectionKey.SOLAR_RA_DYNAMIC and PrimaryDirectionKey.SOLAR_LON_DYNAMIC.compute_primary_directions_timeline and facade method primary_directions_timeline, unifying arc search, bound boundary crossings, active distributor determination, and participator aspectual tagging into a chronological life sequence. Added REST endpoint POST /v1/primary-directions/timeline with strict Pydantic v2 schemas (PrimaryDirectionsTimelineRequest and PrimaryDirectionsTimelineResponse).test_primary_directions_bounds.py, test_primary_directions_dynamic_keys.py, test_primary_directions_timeline.py) and server test suite (test_server_primary_directions_timeline_routes.py), achieving 100% pass across all 280+ primary directions tests.moira/primary_directions/converse.py, moira/primary_directions/relations.py, moira/primary_directions/targets.py, moira/primary_directions/placidus.py, moira/primary_directions/__init__.py, moira/primary_directions/geometry.py, src/native/include/primary_directions.hpp, src/native/bindings/moira_native.cppneo_converse Motion Doctrine): Implemented counter-diurnal West-to-East primary motion ($\Delta_{\text{neo}} = (360^\circ - \Delta_{\text{dir}}) \pmod{360^\circ}$) holding the Significator stationary while directing promissors against the diurnal rotation. Rigorously differentiated from Morin’s Traditional Converse role-exchange doctrine ($\Delta_{\text{conv}}(S \to P) = \Delta_{\text{dir}}(P \to S)$) on asymmetric oblique semi-arc systems (Placidus, Campanus, Topocentric), while preserving exact circle-complement identity with traditional converse on symmetric equatorial/meridian systems. Added PrimaryDirectionConverseDoctrine.NEO_CONVERSE and preset option converse_doctrine="neo_converse".wrap_mundane_fraction(), allowing promissor mundane aspect points to inherit the parent promissor’s diurnal/nocturnal semi-arc and be directed directly, converse, or neo-converse to significators across all quadrants. Added PrimaryDirectionsPreset.PLACIDUS_MUNDANE_ASPECT and resolve_primary_direction_mundane_aspect_targets().Part 3 (Native Placidian Mundane Solver _moira_native): Implemented C++ functions placidian_required_ha, placidian_mundane_arc, compute_placidian_pair_arcs, and batched OpenMP matrix generator compute_placidian_arcs_matrix in primary_directions.hpp and exposed via pybind11 in moira_native.cpp. Dispatched transparently in moira/primary_directions/geometry.py with zero-drift numerical parity ($ |
\Delta | < 10^{-12 \circ}$) against Python reference math. |
test_primary_directions_neo_converse.py, test_primary_directions_mundane_aspects.py, test_native_primary_directions_parity.py) and server contract suite, achieving 100% pass across all 395 primary directions tests.moira/primary_directions/relations.py, moira/primary_directions/targets.py, moira/primary_directions/placidus.py, moira/primary_directions/__init__.py, moira_server/models/primary_directions.py, moira_server/services/primary_directions.py| Part 1 (Placidian Mundane Parallels & Contra-Parallels In Mundo): Implemented true mundane parallel reflections across the Meridian ($f_{\text{par}} = -f_S$) and contra-parallel reflections across the Horizon ($f_{\text{contra}} = \text{copysign}(2.0 - | f_S | , f_S)$) via compute_placidian_mundane_parallel_arc. Direct and converse arcs evaluated with native equatorial acceleration. Added PrimaryDirectionsPreset.PLACIDIAN_MUNDANE_PARALLEL and target generators. |
PrimaryDirectionMethod.PTOLEMY_SEMI_ARC), expanding the existing Placidian semi-arc trisection to Ptolemaic semi-arcs with exact quadrant temporal hour fractions. Added PrimaryDirectionsPreset.PTOLEMY_MUNDANE_ASPECT.test_primary_directions_mundane_parallels.py, test_primary_directions_ptolemy_mundane_aspects.py, test_primary_directions_midpoints.py) with 412/412 tests passing (100% green).moira/houses.py, moira/_facade_core.py, moira_server/routers/chart.py, moira_server/models/chart.pyanalytical_mc_speed().analytical_asc_speed().analytical_vertex_speed().house_dynamics_from_armc at package root; integrated Moira.house_dynamics(dt, latitude, longitude, system=...) into CoreFacadeMixin for seamless high-level execution.CuspSpeedResponse, HouseDynamicsRequest, HouseDynamicsResponse) and registered endpoint POST /v1/houses/dynamics with timezone validation and custom step/policy forwarding.tests/unit/test_house_dynamics_oracle.py, 28 tests in tests/unit/test_house_dynamics.py, and 4 server contract tests in tests/server/test_server_house_dynamics_routes.py.2026.10.10.1 are published and active; see the release closure. The September receipt below remains bound to its original releases and target solutions, not relabelled as a new geometric-node oracle sweep.tests/artifacts/oracle/small_body_orbital_catalog_admission_2026-09-28.json, tests/integration/test_orbital_elements_full_catalog.py, tests/integration/test_geometric_nodes_full_catalog.pymoira-asteroids@2026.09.18.1 (11,223 bodies / 449 shards) while retaining moira-comets@2026.07.28.1 (497 bodies / 20 shards).JPL#K273/14 to JPL#K273/17.moira/jaimini_extended.py, tests/unit/test_jaimini_extended.pycycles parameter in chara_dasha allowing generation of exact multi-cycle continuous sequences.moira/eclipse.py (SolarEclipsePath)SolarEclipsePath to return northern_limit_lats, northern_limit_lons, southern_limit_lats, and southern_limit_lons._umbral_envelope_points and helpers for rigorous intersection solving along the path.moira/varga.py, tests/unit/test_d60_deities.pyVargaPoint with the deity attribute exposing the traditionally designated lord.moira/avasthas.py, tests/unit/test_sayanadi.pyevaluate_avasthas admitted birth_ghati and first_syllable_value. Current code accepts neither input and does not populate PlanetAvasthas.sayanadi; that integration claim is superseded.2026.10.10.1. The asteroid release
repairs the 59-body/40-shard audit roster and reuses 409 unchanged shards
after full server-hash verification. All 497 comets use certified adaptive
apsidal sampling, with bounded Horizons refinement queries and explicit
target-solution receipts. The final freshness census checked all 497 comet
solutions, refreshed 38 bodies and preserved 459 trajectory segments exactly.
Sealed-release integration checks all 11,720 bodies for native
state/element, identity, coverage and provenance invariants, four asteroid
element holdouts, six asteroid apsidal events and three current-solution
Halley/Encke events under the unchanged 8.64-second / 1e-9 AU gates.
The public manifests, downloads, runtime identities and health were verified;
previous catalogs remain available for rollback and historical downloads.
This is selected external-oracle event coverage, not a blanket all-body,
all-epoch accuracy guarantee. The historical September admission and fixtures
remain unchanged. See the release closure
and VALIDATION_ASTRONOMY.md.These systems represent intentional boundaries where Moira refuses to invent speculative math without primary authority or oracle validation.
HellenisticRayTruth)moira/hellenistic_relations.py:146–164HellenisticRayTruth now computes the physical focal point and evaluates applying/separating states through precise relative velocity inheritance (inclusive of retrograde sweeps). Supported orb doctrines: strict_3 and moiety.moira/phase.pyThe bounded engine and REST surface may remain in place. Additional historical epoch claims, schematic-projection expansion, or release work stay parked until explicitly reopened.
CHANGELOG.md and the relevant validation or release receipt.NotImplementedError or typed unavailable receipts) rather than returning misleading zero or placeholder values.