kshana 0.12.0 → 0.13.0

package/README.md

@@ -12,6 +12,7 @@
 <p align="center">
   <a href="https://ashfordeou.github.io/kshana/"><img src="https://img.shields.io/badge/playground-try%20in%20browser-c79e63" alt="Live playground — run in your browser, no install"></a>
   <a href="tests/sgp4_verification.rs"><img src="https://img.shields.io/badge/SGP4-666%2F666%20AIAA%20vectors%20%C2%B7%204.12mm-3fb950" alt="SGP4 validated against all 666 AIAA 2006-6753 vectors, worst 4.12 mm"></a>
+  <a href="https://github.com/ashfordeOU/kshana/actions/workflows/ci.yml"><img src="https://img.shields.io/badge/coverage-~97%25%20line-3fb950" alt="~97% line coverage on src/ (cargo-tarpaulin LLVM engine), gated at 85% in CI"></a>
   <a href="https://github.com/ashfordeOU/kshana/actions/workflows/ci.yml"><img src="https://github.com/ashfordeOU/kshana/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://github.com/ashfordeOU/kshana/releases"><img src="https://img.shields.io/github/v/release/ashfordeOU/kshana?sort=semver" alt="Release"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache-2.0"></a>
@@ -42,7 +43,7 @@ citable table in [`docs/PROVENANCE.md`](docs/PROVENANCE.md).
 *Free and open source under Apache-2.0, professionally developed and maintained by
 Ashforde OÜ — commercial support, integration, and proprietary extensions available.*
 
-> **Status: v0.12.0 · a simulation substrate, not yet a product.** A validated,
+> **Status: v0.13.0 · a simulation substrate, not yet a product.** A validated,
 > fully reproducible engine spanning the PNT stack — orbit geometry and constellation
 > design, a numerical (Cowell) propagator with a six-perturbation force model, maneuver
 > and trajectory design, time systems, inertial navigation (incl. map-aided and
@@ -218,6 +219,10 @@ cargo run -- scenarios/integrity-raim.toml
 
 # Export a propagated constellation to an SP3-c precise-ephemeris file:
 cargo run -- scenarios/orbit-sgp4-gps.toml --export-sp3 gps.sp3
+
+# Export the constellation's mean elements to a CCSDS OMM catalogue (one OMM
+# message per TLE-defined satellite, with its real NORAD id / COSPAR designator):
+cargo run -- scenarios/orbit-sgp4-gps.toml --export-omm gps.omm
 ```
 
 **Interoperability role.** Kshana is the *performance-simulation* layer that sits
@@ -226,7 +231,11 @@ output into RTKLIB or gLAB for a position solution, and use its **SP3** output a
 precise-orbit product for tools like Ginan — Kshana answers *what resilience a given
 PNT architecture buys* before you have real signals, in formats those tools already
 ingest (`--export-sp3`, or `export_sp3 = true` in an `orbit` scenario, writes
-`<scenario>.sp3`).
+`<scenario>.sp3`). The same orbit can be published as standards-track **CCSDS OMM**
+mean elements (`--export-omm`, or `export_omm = true`, writes `<scenario>.omm`) —
+one OMM 502.0 KVN message per TLE-defined satellite, carrying each object's real
+NORAD catalogue number, COSPAR international designator, and epoch, for any
+OMM-aware consumer instead of a bespoke two-line element set.
 
 Example output (clock holdover — note the Integrity and Security figures of merit):
 
@@ -455,8 +464,19 @@ power-law type is identified from its modified-Allan slope, and the χ² interva
 matching NIST SP 1065 effective degrees of freedom). The browser playground renders it as a
 log-log "Clock stability (ADEV)" chart. (MDEV, TDEV, and HDEV are available as library
 estimators; the exported result curve is the overlapping ADEV.) Every field, with units and a
-source pointer, is documented in [`docs/SCHEMA.md`](docs/SCHEMA.md). The figures of
-merit follow the standard operational PNT figures of merit:
+source pointer, is documented in [`docs/SCHEMA.md`](docs/SCHEMA.md).
+
+**Every chart is self-describing.** The browser playground, the CLI's `*.chart.svg`
+export, and the HTML scorecard all stamp each chart image with a footer reading
+`Kshana v<version> · scenario <hash> · kshana.dev`. The `scenario <hash>` is the first
+12 hex characters of the run's **scenario hash** — a SHA-256 over the canonical scenario
+definition (seed, thresholds, model parameters, GNSS windows, …); the integrity and lunar
+reports, which carry no hash of their own, fall back to a SHA-256 of the scenario source.
+It is the **same fingerprint** shown in the one-line summary and the result JSON, so a
+saved or pasted chart always carries its version, the exact scenario that produced it (for
+bit-for-bit reproduction), and the source — change any input and the hash changes.
+
+The figures of merit follow the standard operational PNT figures of merit:
 
 | Figure of merit | How Kshana computes it |
 |-----------------|------------------------|
@@ -472,7 +492,10 @@ New to these terms? Each is defined in plain language in the [glossary](docs/GLO
 
 ## Architecture
 
-One engine; each sensor pack plugs in via a common error-model interface. See
+One engine. The sensor packs plug in via a common error-model interface; alongside
+them sit an astrodynamics/numerical layer (analytic SGP4/SDP4 **and** a numerical
+Cowell propagator with its force model, maneuver design, and orbit determination) and a
+fusion / alt-PNT layer (the GNSS/INS estimators and the gravity-map matcher). See
 [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) for the full set of diagrams.
 
 ```mermaid
@@ -488,30 +511,45 @@ flowchart LR
 
 ```mermaid
 flowchart TD
-    cli["CLI · Python · WebAssembly"] --> api["api — run_toml: dispatch by kind"]
+    cli["CLI · Python · WebAssembly"] --> api["api — run_toml / run_scenario: typed dispatch by kind"]
     subgraph shared["Shared core"]
       types["types"]
       scenario["scenario · GNSS timeline"]
       allan["allan — Allan deviation"]
     end
-    subgraph p1["Pack 1 · Clock"]
-      models["models — ClockModel (+ flicker)"]
-      estimator["estimator — holdover"]
-      kalman["kalman — Integrity bound"]
-      security["security — analytic spoof-detectability bound"]
-      fom["fom · report · run"]
+    subgraph packs["Sensor packs"]
+      p1["Clock — models · estimator · kalman · security · fom"]
+      p2["inertial — strapdown INS + quantum-CAI"]
+      p3["timetransfer (+ _adv) — optical/RF link"]
+      p4["hybrid — fused PNT suite"]
+    end
+    subgraph astro["Astrodynamics & numerical"]
+      orbit["orbit — geometry → GNSS timeline + DOP"]
+      sgp4["sgp4 · tle — SGP4/SDP4"]
+      prop["propagator — Cowell"]
+      forces["forces — J2–J6 · 3rd-body · SRP · drag · relativity"]
+      integ["integrator — RK4 · DOPRI"]
+      ephem["ephem — Sun/Moon"]
+      man["maneuver — burns · Lambert · porkchop"]
+      od["orbit_determination — batch · sequential"]
+    end
+    subgraph fnav["Fusion & alt-PNT"]
+      fus["fusion — EKF · UKF · 17-state · coupled"]
+      grav["gravimeter · mapmatch · particle_filter"]
     end
-    p2["Pack 2 · inertial — accel + gyro"]
-    p3["Pack 3 · timetransfer — optical/RF link"]
-    p4["Pack 4 · hybrid — fused PNT suite"]
-    orbit["orbit — geometry → GNSS timeline + DOP"]
-    api --> p1
-    api --> p2
-    api --> p3
-    api --> p4
-    p1 --> shared
-    p2 --> shared
-    p3 --> shared
+    api --> packs
+    api --> astro
+    api --> fnav
+    packs --> shared
+    orbit --> sgp4
+    prop --> forces
+    prop --> integ
+    forces --> ephem
+    man --> integ
+    od --> forces
+    od --> integ
+    fus --> p2
+    grav --> p2
     orbit --> p1
     p4 -. composes .-> p1
     p4 -. composes .-> p2
@@ -523,27 +561,32 @@ flowchart TD
 ```
 kshana/
 ├── src/
-│   ├── types.rs        # Seconds, TimeGrid, ModelSpec
-│   ├── scenario.rs     # GNSS timeline, clock scenario config
-│   ├── models.rs       # ErrorModel trait, ClockModel (white FM, RWFM, aging)
-│   ├── estimator.rs    # HoldoverEstimator (quadratic offset+aging removal)
-│   ├── fom.rs          # figure-of-merit scoring
-│   ├── allan.rs        # overlapping Allan deviation
-│   ├── kalman.rs       # two-state Kalman clock estimator + integrity bound
-│   ├── report.rs       # result schema, scenario hash, SVG chart (clock)
-│   ├── run.rs          # clock + orbit-clock run pipelines
-│   ├── inertial.rs     # Pack 2: inertial dead-reckoning (accel + gyro) + FoMs
-│   ├── timetransfer.rs # Pack 3: optical/RF time-transfer link
-│   ├── hybrid.rs       # Pack 4: combined PNT suite + ISL clock-aiding
-│   ├── orbit.rs        # orbit propagation + GNSS line-of-sight visibility
-│   ├── api.rs          # scenario dispatch shared by the CLI and bindings
-│   ├── python.rs       # optional PyO3 extension (feature = "python")
-│   ├── wasm.rs         # optional wasm-bindgen module (feature = "wasm")
-│   └── main.rs         # CLI
-├── scenarios/          # cited scenarios (one per pack + a geometry-driven one)
+│   ├── types.rs · scenario.rs · allan.rs   # shared core (time grid, GNSS timeline, Allan)
+│   ├── api.rs · main.rs                     # typed dispatch + CLI
+│   ├── python.rs · wasm.rs                  # optional PyO3 / wasm-bindgen bindings
+│   │
+│   ├── models.rs · estimator.rs · kalman.rs # Pack 1 — clock holdover + integrity
+│   ├── security.rs · detection.rs · spoof.rs · spoof_monitors.rs # spoof detection
+│   ├── filter_health.rs · fom.rs · report.rs · chart.rs · run.rs  # health · scoring · output
+│   ├── inertial/        # Pack 2 — strapdown INS (attitude, mechanization, imu_errors, quantum_imu)
+│   ├── timetransfer.rs · timetransfer_adv.rs · timegeo.rs # Pack 3 — TWSTFT/CV/PPP/optical, Sagnac
+│   ├── hybrid.rs · ensemble.rs · sweep.rs   # Pack 4 — fused PNT suite, Monte-Carlo, trade sweeps
+│   │
+│   ├── orbit.rs · sgp4.rs · tle.rs · walker.rs   # geometry, SGP4/SDP4, TLE, Walker design
+│   ├── propagator.rs · forces.rs · integrator.rs # numerical Cowell propagator + force model + RK4/DOPRI
+│   ├── ephem.rs · precession.rs · frames.rs · timescales.rs · jd2.rs # ephemerides, IAU precession, time/frames
+│   ├── maneuver.rs · batch_ls.rs · orbit_determination.rs # burns/Lambert/porkchop, Gauss-Newton, OD
+│   │
+│   ├── fusion/          # GNSS/INS — EKF, UKF, tightly_coupled, tightly_coupled17, coupled
+│   ├── gravimeter.rs · mapmatch.rs · particle_filter.rs  # gravity-map / alt-PNT navigation
+│   ├── raim.rs · lunar.rs        # ARAIM HPL/VPL, cislunar integrity
+│   ├── gnss_sim.rs · ionex.rs · jamming.rs   # measurement domain, ionosphere maps, jamming
+│   └── rinex.rs · rinex_obs.rs · glonass.rs · sp3.rs · oem.rs · omm.rs · permalink.rs # interop formats
+├── scenarios/          # cited scenarios (one per kind + geometry-driven + GPS-denied)
 ├── scripts/            # reproducibility + repo-hygiene guards
-├── docs/               # CONCEPTS, ARCHITECTURE, VALIDATION, GLOSSARY, assets/
-├── .github/workflows/  # CI gate, release, and wheel-build pipelines
+├── docs/               # CONCEPTS, ARCHITECTURE, CAPABILITY, VALIDATION, PROVENANCE, GLOSSARY, …
+├── web/                # the WebAssembly playground + kshana.dev site
+├── .github/workflows/  # CI gate, release, wheels, publish, and pages pipelines
 ├── pyproject.toml      # Python packaging (maturin)
 ├── CHANGELOG.md        # Keep a Changelog + SemVer
 └── CONTRIBUTING.md
@@ -561,7 +604,7 @@ kshana/
 | [Provenance](docs/PROVENANCE.md) | reviewers / citers | every sensor parameter, model, and dataset traced to its published source, in one citable table |
 | [Reproducibility &amp; provenance](docs/REPRODUCIBILITY.md) | reviewers / packagers | determinism guarantees, golden-pinning, SBOM, build provenance |
 | [Positioning](docs/POSITIONING.md) | evaluators | where Kshana sits vs RTKLIB/gLAB (complementary), and the zero-install browser tier |
-| [SGP4 validation](docs/SGP4-VALIDATION.md) | reviewers / citers | agreement with the AIAA 2006-6753 reference (666 states, ~4 mm) |
+| [SGP4 validation](docs/SGP4-VALIDATION.md) | reviewers / citers | agreement with the AIAA 2006-6753 reference (666 states, ~4 mm) **and** a head-to-head against the independent `sgp4` crate (agree to sub-micron / 4.12 mm) |
 | [Changelog](CHANGELOG.md) | everyone | released history (Keep a Changelog + SemVer) |
 | [Contributing](CONTRIBUTING.md) | contributors | build, guards, test/citation discipline, DCO |
 | [Code of Conduct](CODE_OF_CONDUCT.md) | community | expected conduct (Contributor Covenant) |
@@ -670,7 +713,7 @@ entry for every user-visible change. Participation is governed by our
 
 If you use Kshana in academic or technical work, please cite it. Machine-readable
 metadata is in [`CITATION.cff`](CITATION.cff) (GitHub renders a "Cite this repository"
-button from it); cite the version you used (e.g. `v0.12.0`) together with the
+button from it); cite the version you used (e.g. `v0.13.0`) together with the
 scenario and seed for full reproducibility. Every release is archived on Zenodo with
 a citable DOI — the concept DOI [10.5281/zenodo.20528627](https://doi.org/10.5281/zenodo.20528627)
 always resolves to the latest version.

package/package.json

@@ -5,7 +5,7 @@
     "Chakshu Baweja <contact@ashforde.org>"
   ],
   "description": "Open, reproducible PNT-resilience simulator with quantum-sensor performance models",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",