npm - space-data-module-sdk - Versions diffs - 0.8.15 → 0.8.17 - Mend

space-data-module-sdk 0.8.15 → 0.8.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (130) hide show

package/bin/space-data-module.js +24 -6
package/docs/_shell/consumer-assets.html +5 -0
package/docs/browser-wasmedge-isomorphic.html +261 -0
package/docs/byo-wasm-quickstart.html +226 -0
package/docs/byo-wasm-quickstart.md +204 -0
package/docs/conformance.html +162 -0
package/docs/conformance.md +20 -4
package/docs/emception-shared-memory-verdict.md +209 -0
package/docs/events-abi.html +313 -0
package/docs/events-abi.md +530 -0
package/docs/families/analytics.html +178 -0
package/docs/families/analytics.md +104 -0
package/docs/families/attitude.html +157 -0
package/docs/families/attitude.md +36 -0
package/docs/families/behavior.html +157 -0
package/docs/families/behavior.md +36 -0
package/docs/families/breakup.html +157 -0
package/docs/families/breakup.md +36 -0
package/docs/families/conjunction.html +186 -0
package/docs/families/conjunction.md +121 -0
package/docs/families/data-source.html +323 -0
package/docs/families/effects.html +157 -0
package/docs/families/effects.md +36 -0
package/docs/families/environment.html +170 -0
package/docs/families/environment.md +73 -0
package/docs/families/estimation.html +192 -0
package/docs/families/estimation.md +158 -0
package/docs/families/gnc.html +157 -0
package/docs/families/gnc.md +36 -0
package/docs/families/maneuver.html +209 -0
package/docs/families/maneuver.md +206 -0
package/docs/families/obstruction.html +191 -0
package/docs/families/obstruction.md +96 -0
package/docs/families/propagator.html +347 -0
package/docs/families/propulsion.html +157 -0
package/docs/families/propulsion.md +36 -0
package/docs/families/reentry.html +157 -0
package/docs/families/reentry.md +36 -0
package/docs/families/rf.html +193 -0
package/docs/families/rf.md +136 -0
package/docs/families/scheduler.html +157 -0
package/docs/families/scheduler.md +36 -0
package/docs/families/sensor.html +157 -0
package/docs/families/sensor.md +36 -0
package/docs/families/signature.html +157 -0
package/docs/families/signature.md +36 -0
package/docs/flatsql-host-contract.html +176 -0
package/docs/flatsql-streaming-standard.html +375 -0
package/docs/gpu-module-abi.html +233 -0
package/docs/harness-family-matrix.md +135 -0
package/docs/index.html +216 -85
package/docs/isomorphic-pthreads.html +228 -0
package/docs/isomorphic-pthreads.md +84 -0
package/docs/isomorphic-sdn-runtime-plan.html +274 -0
package/docs/language-runtime-matrix.html +182 -0
package/docs/llms.txt +86 -0
package/docs/module-bundle-runtime-plan.html +146 -0
package/docs/module-publication-standard.html +503 -0
package/docs/node-red-default-node-parity.html +201 -0
package/docs/propagator-abi.md +97 -12
package/docs/protect-and-sign.html +181 -0
package/docs/protect-and-sign.md +120 -0
package/docs/protocol-installation.html +296 -0
package/docs/provider-access-abi.md +25 -0
package/docs/publication-submission.html +158 -0
package/docs/publication-submission.md +78 -0
package/docs/secrets-capability.html +206 -0
package/docs/styles.css +860 -167
package/docs/testing-harness.html +408 -0
package/docs/tri-runtime-parity-gate.html +182 -0
package/docs/tri-runtime-parity.html +203 -0
package/include/orbpro/orbpro_estimation_abi.h +883 -0
package/include/orbpro/orbpro_event_runner.h +951 -0
package/include/orbpro/orbpro_events_abi.h +565 -0
package/include/orbpro/orbpro_propagator_abi.h +75 -0
package/package.json +13 -4
package/schemas/orbpro/Estimation.fbs +244 -0
package/schemas/orbpro/Events.fbs +501 -0
package/schemas/orbpro/Propagator.fbs +136 -9
package/schemas/orbpro/reference-frame-crosswalk.json +108 -0
package/schemas/orbpro/reference-frame.lock.json +98 -0
package/src/browser.js +13 -0
package/src/conformance/estimationReference.js +81 -0
package/src/conformance/estimationSuite.js +134 -0
package/src/conformance/index.js +39 -2
package/src/generated/orbpro/events-abi.js +206 -0
package/src/generated/orbpro/events-abi.ts +319 -0
package/src/generated/orbpro/propagator/reference-frame.js +17 -0
package/src/generated/orbpro/propagator/reference-frame.ts +91 -1
package/src/generated/orbpro/propagator-abi.js +38 -0
package/src/generated/orbpro/propagator-abi.ts +67 -0
package/src/generated/spacedatastandards/plg/CCT.d.ts +94 -0
package/src/generated/spacedatastandards/plg/CCT.d.ts.map +1 -0
package/src/generated/spacedatastandards/plg/CCT.js +208 -0
package/src/generated/spacedatastandards/plg/CCT.ts +281 -0
package/src/generated/spacedatastandards/plg/CCTCategory.d.ts +98 -0
package/src/generated/spacedatastandards/plg/CCTCategory.d.ts.map +1 -0
package/src/generated/spacedatastandards/plg/CCTCategory.js +177 -0
package/src/generated/spacedatastandards/plg/CCTCategory.ts +269 -0
package/src/generated/spacedatastandards/plg/CCTCategoryRollup.d.ts +54 -0
package/src/generated/spacedatastandards/plg/CCTCategoryRollup.d.ts.map +1 -0
package/src/generated/spacedatastandards/plg/CCTCategoryRollup.js +106 -0
package/src/generated/spacedatastandards/plg/CCTCategoryRollup.ts +144 -0
package/src/generated/spacedatastandards/plg/PLG.d.ts +46 -2
package/src/generated/spacedatastandards/plg/PLG.d.ts.map +1 -1
package/src/generated/spacedatastandards/plg/PLG.js +78 -5
package/src/generated/spacedatastandards/plg/PLG.ts +90 -5
package/src/generated/spacedatastandards/plg/capabilityClass.d.ts +181 -0
package/src/generated/spacedatastandards/plg/capabilityClass.d.ts.map +1 -0
package/src/generated/spacedatastandards/plg/capabilityClass.js +183 -0
package/src/generated/spacedatastandards/plg/capabilityClass.ts +208 -0
package/src/generated/spacedatastandards/plg/main.d.ts +4 -0
package/src/generated/spacedatastandards/plg/main.d.ts.map +1 -1
package/src/generated/spacedatastandards/plg/main.js +4 -0
package/src/generated/spacedatastandards/plg/main.ts +4 -0
package/src/generated/spacedatastandards/plg/pluginCategory.d.ts +40 -2
package/src/generated/spacedatastandards/plg/pluginCategory.d.ts.map +1 -1
package/src/generated/spacedatastandards/plg/pluginCategory.js +40 -2
package/src/generated/spacedatastandards/plg/pluginCategory.ts +40 -2
package/src/host/browserModuleHarness.js +8 -0
package/src/host/wasiThreadHost.js +189 -14
package/src/index.d.ts +18 -1
package/src/standards/sharedCatalog.js +7 -0
package/src/transport/index.js +16 -0
package/src/transport/records.js +1015 -3
package/templates/estimation-module/README.md +24 -0
package/templates/estimation-module/build.mjs +32 -0
package/templates/estimation-module/package.json +12 -0
package/templates/estimation-module/plugin-manifest.json +34 -0
package/templates/estimation-module/src/reference_estimation.cpp +53 -0

package/docs/families/estimation.html ADDED Viewed

@@ -0,0 +1,192 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="description" content="Status: RATIFIED. The estimation harness is the measurement-based orbit" />
+    <title>Estimation — Space Data Module SDK</title>
+    <link rel="stylesheet" href="../styles.css" />
+    <!-- SDN_CONSUMER_ASSETS_START -->
+<link rel="stylesheet" href="https://static.spacedatanetwork.org/assets/hd-wallet-ui/2.0.28/sdn-wallet-public-client.c3f68d1cfd88478f10d836a5e829d1dfc6a10157972cf0f7d4d319d0636f2cc4.css" integrity="sha384-fICuhN4I9xqOK1F5vGGzl26opuO+xQIvTZXMSV76lWTBiQ6AfzztMGLLDw8yRT8i" crossorigin="anonymous">
+<script defer src="https://static.spacedatanetwork.org/assets/hd-wallet-ui/2.0.28/sdn-wallet-public-client.f611e7e151a3b5c38384272f8894a4c6634f0a29bf925b0e02e0e27f8db0bfff.js" integrity="sha384-R+QqsKoWJIS7iWrtPmgJ49DVnb1hSGjZokupbLInJd1PLp8RwQhtF/hnaerc33ci" crossorigin="anonymous" data-sdn-wallet-public-client="v1"></script>
+<script defer src="https://static.spacedatanetwork.org/assets/sdn-stack-nav/1.0.0/sdn-stack-nav.52fde607eee38ffa116188201f50258ed50bd18c9f06c1af9678f763147a8fe5.js" integrity="sha384-dgeojhJ8vTszHXIbv7O7nZcEzqD10oUYYJjBmPrV7+kLQEUlXLQD4ek5Q7HOFiO5" crossorigin="anonymous" data-nav-style-url="https://static.spacedatanetwork.org/assets/sdn-stack-nav/1.0.0/sdn-stack-nav.36a36359ce18322185e9ff179f88175bab67d5ad84a14d9c08a54f2ff27267e7.css" data-nav-style-integrity="sha384-c4M8Fg+kYaeOYYtJVr7jJsde24IhSWkWaRyAOHEZU9jozhRck089aw+mnHwxymds" data-wallet-client-url="https://static.spacedatanetwork.org/assets/hd-wallet-ui/2.0.28/sdn-wallet-public-client.f611e7e151a3b5c38384272f8894a4c6634f0a29bf925b0e02e0e27f8db0bfff.js" data-wallet-client-integrity="sha384-R+QqsKoWJIS7iWrtPmgJ49DVnb1hSGjZokupbLInJd1PLp8RwQhtF/hnaerc33ci" data-wallet-style-url="https://static.spacedatanetwork.org/assets/hd-wallet-ui/2.0.28/sdn-wallet-public-client.c3f68d1cfd88478f10d836a5e829d1dfc6a10157972cf0f7d4d319d0636f2cc4.css" data-wallet-style-integrity="sha384-fICuhN4I9xqOK1F5vGGzl26opuO+xQIvTZXMSV76lWTBiQ6AfzztMGLLDw8yRT8i" data-wallet-client-id="sdn-module-sdk-pages-v1" data-wallet-callback-uri="https://digitalarsenal.github.io/space-data-module-sdk/wallet-callback.html" data-wallet-registry-sha256="e1ce6fe903c9700484a8a87d96581c8cad97063dabf63030b4518a31a3bdaa93"></script>
+<!-- SDN_CONSUMER_ASSETS_END -->
+  </head>
+  <body>
+    <a class="skip-link" href="#main">Skip to content</a>
+    <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
+    <header class="site-header">
+      <a class="site-brand" href="../">Space Data Module SDK</a>
+      <nav class="header-links" aria-label="Site">
+        <a href="../byo-wasm-quickstart.html">Quickstart</a>
+        <a href="../conformance.html">Conformance</a>
+        <a href="https://github.com/DigitalArsenal/space-data-module-sdk">GitHub</a>
+        <a class="stack-button" href="#stack">Stack</a>
+      </nav>
+    </header>
+    <div class="shell">
+      <nav class="sidebar" id="sidebar" aria-label="Documentation">
+<h2>Start here</h2><ul>
+<li><a href="../index.html"><span>Harness family matrix</span></a></li>
+<li><a href="../byo-wasm-quickstart.html"><span>BYO-wasm quickstart</span></a></li>
+<li><a href="../conformance.html"><span>Conformance kit</span></a></li>
+<li><a href="../protect-and-sign.html"><span>Protect and sign</span></a></li>
+<li><a href="../publication-submission.html"><span>Publication and listing</span></a></li>
+</ul>
+<h2>Dynamics</h2><ul>
+<li><a href="./propagator.html"><span>Propagator</span><span class="tag tag-shipped">shipped</span></a></li>
+<li><a href="./maneuver.html"><span>Maneuver</span><span class="tag tag-experimental">experimental</span></a></li>
+<li><a href="./propulsion.html"><span>Propulsion</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./attitude.html"><span>Attitude</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./gnc.html"><span>GNC</span><span class="tag tag-planned">planned</span></a></li>
+</ul>
+<h2>Environment and interaction</h2><ul>
+<li><a href="./rf.html"><span>RF</span><span class="tag tag-designed">designed</span></a></li>
+<li><a href="./sensor.html"><span>Sensor</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./signature.html"><span>Signature</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./environment.html"><span>Environment</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./obstruction.html"><span>Obstruction</span><span class="tag tag-designed">designed</span></a></li>
+</ul>
+<h2>Event physics</h2><ul>
+<li><a href="./breakup.html"><span>Breakup</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./reentry.html"><span>Reentry</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./conjunction.html"><span>Conjunction</span><span class="tag tag-designed">designed</span></a></li>
+<li><a href="./effects.html"><span>Effects</span><span class="tag tag-planned">planned</span></a></li>
+</ul>
+<h2>Estimation, data and logic</h2><ul>
+<li><a href="./estimation.html" aria-current="page"><span>Estimation</span><span class="tag tag-shipped">shipped</span></a></li>
+<li><a href="./data-source.html"><span>Data source</span><span class="tag tag-shipped">shipped</span></a></li>
+<li><a href="./analytics.html"><span>Analytics</span><span class="tag tag-experimental">experimental</span></a></li>
+<li><a href="./scheduler.html"><span>Scheduler</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./behavior.html"><span>Behavior</span><span class="tag tag-planned">planned</span></a></li>
+</ul>
+<h2>Runtime contract</h2><ul>
+<li><a href="../events-abi.html"><span>Event locator ABI</span></a></li>
+<li><a href="../module-publication-standard.html"><span>Module publication standard</span></a></li>
+<li><a href="../browser-wasmedge-isomorphic.html"><span>Browser / WasmEdge isomorphism</span></a></li>
+<li><a href="../isomorphic-pthreads.html"><span>Isomorphic pthreads</span></a></li>
+<li><a href="../tri-runtime-parity.html"><span>Tri-runtime parity</span></a></li>
+<li><a href="../tri-runtime-parity-gate.html"><span>Tri-runtime parity gate</span></a></li>
+<li><a href="../testing-harness.html"><span>Testing harness</span></a></li>
+<li><a href="../language-runtime-matrix.html"><span>Language and runtime matrix</span></a></li>
+</ul>
+<h2>Host surfaces</h2><ul>
+<li><a href="../flatsql-host-contract.html"><span>FlatSQL host contract</span></a></li>
+<li><a href="../flatsql-streaming-standard.html"><span>FlatSQL streaming standard</span></a></li>
+<li><a href="../secrets-capability.html"><span>Credential lanes</span></a></li>
+<li><a href="../protocol-installation.html"><span>Protocol installation</span></a></li>
+<li><a href="../gpu-module-abi.html"><span>GPU module ABI</span></a></li>
+<li><a href="../module-bundle-runtime-plan.html"><span>Module bundle runtime</span></a></li>
+<li><a href="../isomorphic-sdn-runtime-plan.html"><span>Isomorphic SDN runtime</span></a></li>
+<li><a href="../node-red-default-node-parity.html"><span>Node-RED node parity</span></a></li>
+</ul>
+      </nav>
+      <main class="doc" id="main">
+      <p class="breadcrumb"><a href="../index.html">Harness families</a> / Estimation, data and logic</p>
+        <h1>Estimation</h1>
+      <p class="doc-meta"><span class="pill pill-shipped">shipped</span><span>Shipped contract. Generated from a ratified .fbs single source, covered by a conformance kit and a reference module.</span></p>
+<p><strong>Status: RATIFIED.</strong> The estimation harness is the measurement-based orbit determination contract. It covers simulation, batch weighted least squares, sequential filtering, smoothing, process noise, media corrections, and initial orbit determination without selecting a propagator implementation.</p>
+<h2 id="result-model-ruling"><a class="anchor" href="#result-model-ruling" aria-hidden="true">#</a>Result-model ruling</h2>
+<p>The result-model decision previously deferred by this family is final:</p>
+<ul>
+<li><code>$ODR</code> is the canonical signed run report. It carries the solver configuration, iteration and editing ledgers, estimated parameters, filter history, residual statistics, and the estimated Cartesian state.</li>
+<li><code>$OCM</code> is the canonical covariance product named by <code>ODR.OCM_CONTENT_ID</code>. Its covariance values are the estimator's computed values; a diagonal placeholder or an <code>N/A</code> solve-for is non-conforming.</li>
+<li><code>Estimation.fbs</code> is the family request/result wire. It may embed the exact <code>$ODR</code> and <code>$OCM</code> bytes for a one-frame invocation result, but it does not replace either standards record.</li>
+<li><code>$MEM</code>, <code>$TRH</code>, and <code>$TDM</code> are supporting input records: measurement error and editing policy, tracking hardware, and observations respectively.</li>
+</ul>
+<p>This split keeps algorithm telemetry out of a covariance interchange record while still giving every reported covariance one immutable run provenance.</p>
+<h2 id="propagator-port"><a class="anchor" href="#propagator-port" aria-hidden="true">#</a>Propagator port</h2>
+<p>The caller supplies <code>propagator_port_id</code> and <code>propagator_capability</code>. The estimator consumes <code>EstimationPropagatorSample</code> values whose states come from <code>plugin_propagate</code> and whose state-transition matrices come from <code>plugin_compute_stm</code>. The STM maps the a-priori epoch to the sample epoch.</p>
+<p>Provider names, provider enums, and a default provider are absent from this family. A host must reject a request whose named port does not provide both capabilities. An estimator that imports or selects a concrete propagator is not an estimation-family module.</p>
+<h2 id="source-of-truth-and-generated-header"><a class="anchor" href="#source-of-truth-and-generated-header" aria-hidden="true">#</a>Source of truth and generated header</h2>
+<p><code>schemas/orbpro/Estimation.fbs</code> is the single layout source. <code>include/orbpro/orbpro_estimation_abi.h</code> is generated from it by the SDK's schema ABI renderer. Its compile-time size and offset assertions are part of conformance; handwritten copies are not.</p>
+<p>All state components use metres and metres per second. Covariance is row-major 6 by 6 in matching SI units. Observation values use their native SI unit: metres, metres per second, hertz, or radians. Epochs use the two-double Julian day representation shared by the propagator family.</p>
+<p>Angular and local-plane observations carry the station's inertial east, north and up unit vectors alongside its inertial position and velocity. A runtime uses that explicit topocentric basis when it is present; deriving latitude and longitude from an inertial position rotates the local frame twice and is non-conformant.</p>
+<p>The fixed layouts are:</p>
+<div class="table-wrap"><table><thead><tr><th>Type</th><th>Bytes</th><th>Alignment</th></tr></thead><tbody><tr><td><code>OrbProEstimationEpoch</code></td><td>16</td><td>8</td></tr><tr><td><code>OrbProEstimationObservation</code></td><td>376</td><td>8</td></tr><tr><td><code>OrbProEstimationErrorModel</code></td><td>72</td><td>8</td></tr><tr><td><code>OrbProEstimationConfig</code></td><td>448</td><td>8</td></tr><tr><td><code>OrbProEstimationState</code></td><td>384</td><td>8</td></tr><tr><td><code>OrbProFilterEpoch</code></td><td>696</td><td>8</td></tr><tr><td><code>OrbProEstimationPropagatorSample</code></td><td>352</td><td>8</td></tr><tr><td><code>OrbProInitialOrbitRequest</code></td><td>240</td><td>8</td></tr><tr><td><code>OrbProInitialOrbitResult</code></td><td>80</td><td>8</td></tr></tbody></table></div>
+<p>Call each generated <code>_init</code> helper before filling a struct. Padding is contractual and must remain zero so browser, native, and WasmEdge runtimes hash the same bytes.</p>
+<h2 id="measurement-and-estimator-roster"><a class="anchor" href="#measurement-and-estimator-roster" aria-hidden="true">#</a>Measurement and estimator roster</h2>
+<p>The measurement roster contains range, range rate and Doppler; azimuth and elevation; XEast/YNorth and XSouth/YEast; right ascension and declination; position vectors; sequential and pseudonoise range; time-correlated phase; relay range, Doppler and differenced Doppler; bistatic, skin and crosslink range/range rate; laser range; TDOA; and FDOA.</p>
+<p><code>EstimatorKind</code> distinguishes batch weighted least squares, a covariance-form extended Kalman filter, a sigma-point unscented Kalman filter, and EKF with Rauch–Tung–Striebel smoothing. Chaining one-observation batch solves is not an EKF or UKF and fails conformance. SNC and DMC are explicit process-noise kinds.</p>
+<p>The initial-orbit entry point exposes Gauss, Laplace, Gibbs, and Herrick–Gibbs. It returns the middle-epoch Cartesian state and a typed status.</p>
+<h2 id="result-and-error-contract"><a class="anchor" href="#result-and-error-contract" aria-hidden="true">#</a>Result and error contract</h2>
+<p>Successful estimation produces a populated <code>OrbProEstimationState</code>. A batch result includes convergence, iteration, accepted and rejected counts, RMS, recovered noise sigma, and covariance. A sequential result includes every filtered covariance and, for the smoother kind, every smoothed covariance.</p>
+<p>Batch result wires also carry <code>iteration_covariances</code> as consecutive row-major 6-by-6 blocks. Each block is the normal-matrix covariance from that exact outer iteration, so a convergence visualization uses solver output rather than an interpolated uncertainty.</p>
+<p>The public status vocabulary is:</p>
+<div class="table-wrap"><table><thead><tr><th>Status</th><th>Meaning</th></tr></thead><tbody><tr><td><code>ORBPRO_ESTIMATION_OK</code></td><td>Result is complete.</td></tr><tr><td><code>ORBPRO_ESTIMATION_NOT_CONFIGURED</code></td><td>Required family or propagator configuration is absent.</td></tr><tr><td><code>ORBPRO_ESTIMATION_NULL_OUTPUT</code></td><td>Caller supplied no result destination.</td></tr><tr><td><code>ORBPRO_ESTIMATION_BAD_INPUT</code></td><td>Shape, unit, enum, sigma, or covariance validation failed.</td></tr><tr><td><code>ORBPRO_ESTIMATION_NOT_CONVERGED</code></td><td>A valid iteration history exists but the declared convergence criteria were not met.</td></tr><tr><td><code>ORBPRO_ESTIMATION_BUFFER_TOO_SMALL</code></td><td>Output storage cannot hold the declared result.</td></tr><tr><td><code>ORBPRO_ESTIMATION_PROPAGATOR_PROTOCOL</code></td><td>State/STM response does not match the request.</td></tr><tr><td><code>ORBPRO_ESTIMATION_INTERNAL</code></td><td>Numerical or invariant failure not attributable to input.</td></tr></tbody></table></div>
+<p>No sentinel means success. NaN, an invalid covariance, or a missing required record is an error. A non-converged batch may be reported only with <code>NOT_CONVERGED</code> and its actual iteration history; it may not be relabelled OK.</p>
+<h2 id="lifetime-and-threading"><a class="anchor" href="#lifetime-and-threading" aria-hidden="true">#</a>Lifetime and threading</h2>
+<p>Request, sample, and result buffers are invocation-owned and remain valid only for the call. Modules copy any state retained between input frames. Family implementations declare their thread model in <code>$PLG</code>; deterministic six-dimensional sequential implementations may use <code>wasi-sequential</code> while still compiling on the sanctioned <code>wasm32-wasip1-threads</code> toolchain. The same artifact and bytes must pass browser, native, and embedded WasmEdge lanes.</p>
+<h2 id="conformance-kit"><a class="anchor" href="#conformance-kit" aria-hidden="true">#</a>Conformance kit</h2>
+<p>The official kit checks:</p>
+<ol>
+<li>generated ABI sizes, offsets, enum values, zeroed padding, and an Estimation.fbs schema-lock regeneration;</li>
+<li>a positive reference module using caller-supplied state and STM samples;</li>
+<li>a negative provider-selection control, which fails if a provider name or a concrete propagator import is introduced;</li>
+<li>batch state, covariance, RMS, recovered sigma, and exact edited-set vectors;</li>
+<li>real EKF and UKF covariance histories, RTS covariance contraction, and SNC/DMC growth;</li>
+<li>the complete measurement roster, light-time and body-rotation corrections, media corrections, hardware delay and turnaround handling;</li>
+<li>deterministic simulation and the four initial-orbit methods; and</li>
+<li>byte-equivalent results in the browser, native, and WasmEdge lanes.</li>
+</ol>
+<p>The kit's reference module is deliberately force-model blind: its propagator fixture arrives through the same required <code>propagator_samples</code> port as a real provider. Replacing that fixture with a compiled-in trajectory is a failing negative control, not a reference implementation.</p>
+<h2 id="manifest-surface"><a class="anchor" href="#manifest-surface" aria-hidden="true">#</a>Manifest surface</h2>
+<p>An estimation module declares the <code>estimation</code> harness family and exposes <code>run_estimation</code>, <code>simulate_tracking</code>, and <code>initial_orbit</code>. <code>run_estimation</code> requires <code>request</code> and <code>propagator_samples</code>; <code>$TDM</code>, <code>$MEM</code>, and <code>$TRH</code> are optional typed ports. It emits the Estimation result wire plus signed <code>$ODR</code> and <code>$OCM</code> records. Signatures are applied by the caller's keyslot capability; private signing material never appears in the estimation module.</p>
+      <section class="playground" id="playground-slot" data-family="estimation" data-playground="pending" aria-labelledby="playground-title">
+        <h2 id="playground-title">Playground</h2>
+        <p>
+          An in-browser build-and-run playground for the <code>estimation</code> harness
+          mounts here. It is being built under the graph task
+          <code>sdk-playground-emception</code>; this slot is its reserved mount
+          point and is intentionally empty until that lands.
+        </p>
+      </section>
+        <p class="doc-footer">
+          Source of truth for this page:
+          <code>docs/families/estimation.md</code>. Regenerate with
+          <code>npm run build:docs</code>.
+        </p>
+      </main>
+<nav class="rail" aria-label="On this page"><h2>On this page</h2><ul><li><a class="depth-2" href="#result-model-ruling">Result-model ruling</a></li>
+<li><a class="depth-2" href="#propagator-port">Propagator port</a></li>
+<li><a class="depth-2" href="#source-of-truth-and-generated-header">Source of truth and generated header</a></li>
+<li><a class="depth-2" href="#measurement-and-estimator-roster">Measurement and estimator roster</a></li>
+<li><a class="depth-2" href="#result-and-error-contract">Result and error contract</a></li>
+<li><a class="depth-2" href="#lifetime-and-threading">Lifetime and threading</a></li>
+<li><a class="depth-2" href="#conformance-kit">Conformance kit</a></li>
+<li><a class="depth-2" href="#manifest-surface">Manifest surface</a></li></ul></nav>
+    </div>
+    <section id="stack" class="section" aria-labelledby="stack-title">
+      <div class="section-head">
+        <p class="eyebrow">SDN Stack</p>
+        <h2 id="stack-title">Connected sites</h2>
+      </div>
+      <div class="link-list">
+        <a href="https://spacedatastandards.org/">
+          <span>Standards</span>
+          <small>Canonical schemas, record contracts, and generated bindings.</small>
+        </a>
+        <a href="https://digitalarsenal.github.io/flatbuffers/">
+          <span>FlatBuffers</span>
+          <small>Binary encoding, schema tooling, and runtime documentation.</small>
+        </a>
+        <a href="https://digitalarsenal.github.io/flatsql/">
+          <span>FlatSQL</span>
+          <small>SQL-style queries over FlatBuffer-backed datasets and streams.</small>
+        </a>
+        <a href="https://spacedatanetwork.org/">
+          <span>SDN</span>
+          <small>Distributed publication, discovery, delivery, and marketplace infrastructure.</small>
+        </a>
+        <a href="https://digitalarsenal.github.io/space-data-module-sdk/" class="active">
+          <span>Module SDK</span>
+          <small>WASM module packaging, validation, and host compatibility tooling.</small>
+        </a>
+      </div>
+    </section>
+    <footer class="site-footer">
+      Space Data Module SDK — Apache-2.0. Every ABI page renders a Markdown
+      source in <code>docs/</code>; edit the Markdown, never the HTML.
+    </footer>
+  </body>
+</html>

package/docs/families/estimation.md ADDED Viewed

@@ -0,0 +1,158 @@
+# Estimation
+**Status: RATIFIED.** The estimation harness is the measurement-based orbit
+determination contract. It covers simulation, batch weighted least squares,
+sequential filtering, smoothing, process noise, media corrections, and initial
+orbit determination without selecting a propagator implementation.
+## Result-model ruling
+The result-model decision previously deferred by this family is final:
+- `$ODR` is the canonical signed run report. It carries the solver
+  configuration, iteration and editing ledgers, estimated parameters, filter
+  history, residual statistics, and the estimated Cartesian state.
+- `$OCM` is the canonical covariance product named by `ODR.OCM_CONTENT_ID`.
+  Its covariance values are the estimator's computed values; a diagonal
+  placeholder or an `N/A` solve-for is non-conforming.
+- `Estimation.fbs` is the family request/result wire. It may embed the exact
+  `$ODR` and `$OCM` bytes for a one-frame invocation result, but it does not
+  replace either standards record.
+- `$MEM`, `$TRH`, and `$TDM` are supporting input records: measurement error
+  and editing policy, tracking hardware, and observations respectively.
+This split keeps algorithm telemetry out of a covariance interchange record
+while still giving every reported covariance one immutable run provenance.
+## Propagator port
+The caller supplies `propagator_port_id` and `propagator_capability`. The
+estimator consumes `EstimationPropagatorSample` values whose states come from
+`plugin_propagate` and whose state-transition matrices come from
+`plugin_compute_stm`. The STM maps the a-priori epoch to the sample epoch.
+Provider names, provider enums, and a default provider are absent from this
+family. A host must reject a request whose named port does not provide both
+capabilities. An estimator that imports or selects a concrete propagator is not
+an estimation-family module.
+## Source of truth and generated header
+`schemas/orbpro/Estimation.fbs` is the single layout source.
+`include/orbpro/orbpro_estimation_abi.h` is generated from it by the SDK's
+schema ABI renderer. Its compile-time size and offset assertions are part of
+conformance; handwritten copies are not.
+All state components use metres and metres per second. Covariance is row-major
+6 by 6 in matching SI units. Observation values use their native SI unit:
+metres, metres per second, hertz, or radians. Epochs use the two-double Julian
+day representation shared by the propagator family.
+Angular and local-plane observations carry the station's inertial east,
+north and up unit vectors alongside its inertial position and velocity. A
+runtime uses that explicit topocentric basis when it is present; deriving
+latitude and longitude from an inertial position rotates the local frame twice
+and is non-conformant.
+The fixed layouts are:
+| Type | Bytes | Alignment |
+| --- | ---: | ---: |
+| `OrbProEstimationEpoch` | 16 | 8 |
+| `OrbProEstimationObservation` | 376 | 8 |
+| `OrbProEstimationErrorModel` | 72 | 8 |
+| `OrbProEstimationConfig` | 448 | 8 |
+| `OrbProEstimationState` | 384 | 8 |
+| `OrbProFilterEpoch` | 696 | 8 |
+| `OrbProEstimationPropagatorSample` | 352 | 8 |
+| `OrbProInitialOrbitRequest` | 240 | 8 |
+| `OrbProInitialOrbitResult` | 80 | 8 |
+Call each generated `_init` helper before filling a struct. Padding is
+contractual and must remain zero so browser, native, and WasmEdge runtimes hash
+the same bytes.
+## Measurement and estimator roster
+The measurement roster contains range, range rate and Doppler; azimuth and
+elevation; XEast/YNorth and XSouth/YEast; right ascension and declination;
+position vectors; sequential and pseudonoise range; time-correlated phase;
+relay range, Doppler and differenced Doppler; bistatic, skin and crosslink
+range/range rate; laser range; TDOA; and FDOA.
+`EstimatorKind` distinguishes batch weighted least squares, a covariance-form
+extended Kalman filter, a sigma-point unscented Kalman filter, and EKF with
+Rauch–Tung–Striebel smoothing. Chaining one-observation batch solves is not an
+EKF or UKF and fails conformance. SNC and DMC are explicit process-noise kinds.
+The initial-orbit entry point exposes Gauss, Laplace, Gibbs, and
+Herrick–Gibbs. It returns the middle-epoch Cartesian state and a typed status.
+## Result and error contract
+Successful estimation produces a populated `OrbProEstimationState`. A batch
+result includes convergence, iteration, accepted and rejected counts, RMS,
+recovered noise sigma, and covariance. A sequential result includes every
+filtered covariance and, for the smoother kind, every smoothed covariance.
+Batch result wires also carry `iteration_covariances` as consecutive row-major
+6-by-6 blocks. Each block is the normal-matrix covariance from that exact
+outer iteration, so a convergence visualization uses solver output rather
+than an interpolated uncertainty.
+The public status vocabulary is:
+| Status | Meaning |
+| --- | --- |
+| `ORBPRO_ESTIMATION_OK` | Result is complete. |
+| `ORBPRO_ESTIMATION_NOT_CONFIGURED` | Required family or propagator configuration is absent. |
+| `ORBPRO_ESTIMATION_NULL_OUTPUT` | Caller supplied no result destination. |
+| `ORBPRO_ESTIMATION_BAD_INPUT` | Shape, unit, enum, sigma, or covariance validation failed. |
+| `ORBPRO_ESTIMATION_NOT_CONVERGED` | A valid iteration history exists but the declared convergence criteria were not met. |
+| `ORBPRO_ESTIMATION_BUFFER_TOO_SMALL` | Output storage cannot hold the declared result. |
+| `ORBPRO_ESTIMATION_PROPAGATOR_PROTOCOL` | State/STM response does not match the request. |
+| `ORBPRO_ESTIMATION_INTERNAL` | Numerical or invariant failure not attributable to input. |
+No sentinel means success. NaN, an invalid covariance, or a missing required
+record is an error. A non-converged batch may be reported only with
+`NOT_CONVERGED` and its actual iteration history; it may not be relabelled OK.
+## Lifetime and threading
+Request, sample, and result buffers are invocation-owned and remain valid only
+for the call. Modules copy any state retained between input frames. Family
+implementations declare their thread model in `$PLG`; deterministic
+six-dimensional sequential implementations may use `wasi-sequential` while
+still compiling on the sanctioned `wasm32-wasip1-threads` toolchain. The same
+artifact and bytes must pass browser, native, and embedded WasmEdge lanes.
+## Conformance kit
+The official kit checks:
+1. generated ABI sizes, offsets, enum values, zeroed padding, and an
+   Estimation.fbs schema-lock regeneration;
+2. a positive reference module using caller-supplied state and STM samples;
+3. a negative provider-selection control, which fails if a provider name or a
+   concrete propagator import is introduced;
+4. batch state, covariance, RMS, recovered sigma, and exact edited-set vectors;
+5. real EKF and UKF covariance histories, RTS covariance contraction, and
+   SNC/DMC growth;
+6. the complete measurement roster, light-time and body-rotation corrections,
+   media corrections, hardware delay and turnaround handling;
+7. deterministic simulation and the four initial-orbit methods; and
+8. byte-equivalent results in the browser, native, and WasmEdge lanes.
+The kit's reference module is deliberately force-model blind: its propagator
+fixture arrives through the same required `propagator_samples` port as a real
+provider. Replacing that fixture with a compiled-in trajectory is a failing
+negative control, not a reference implementation.
+## Manifest surface
+An estimation module declares the `estimation` harness family and exposes
+`run_estimation`, `simulate_tracking`, and `initial_orbit`. `run_estimation`
+requires `request` and `propagator_samples`; `$TDM`, `$MEM`, and `$TRH` are
+optional typed ports. It emits the Estimation result wire plus signed `$ODR`
+and `$OCM` records. Signatures are applied by the caller's keyslot capability;
+private signing material never appears in the estimation module.

package/docs/families/gnc.html ADDED Viewed

@@ -0,0 +1,157 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="description" content="Status: PLANNED. This family is a ratified entry in the harness-family" />
+    <title>GNC — Space Data Module SDK</title>
+    <link rel="stylesheet" href="../styles.css" />
+    <!-- SDN_CONSUMER_ASSETS_START -->
+<link rel="stylesheet" href="https://static.spacedatanetwork.org/assets/hd-wallet-ui/2.0.28/sdn-wallet-public-client.c3f68d1cfd88478f10d836a5e829d1dfc6a10157972cf0f7d4d319d0636f2cc4.css" integrity="sha384-fICuhN4I9xqOK1F5vGGzl26opuO+xQIvTZXMSV76lWTBiQ6AfzztMGLLDw8yRT8i" crossorigin="anonymous">
+<script defer src="https://static.spacedatanetwork.org/assets/hd-wallet-ui/2.0.28/sdn-wallet-public-client.f611e7e151a3b5c38384272f8894a4c6634f0a29bf925b0e02e0e27f8db0bfff.js" integrity="sha384-R+QqsKoWJIS7iWrtPmgJ49DVnb1hSGjZokupbLInJd1PLp8RwQhtF/hnaerc33ci" crossorigin="anonymous" data-sdn-wallet-public-client="v1"></script>
+<script defer src="https://static.spacedatanetwork.org/assets/sdn-stack-nav/1.0.0/sdn-stack-nav.52fde607eee38ffa116188201f50258ed50bd18c9f06c1af9678f763147a8fe5.js" integrity="sha384-dgeojhJ8vTszHXIbv7O7nZcEzqD10oUYYJjBmPrV7+kLQEUlXLQD4ek5Q7HOFiO5" crossorigin="anonymous" data-nav-style-url="https://static.spacedatanetwork.org/assets/sdn-stack-nav/1.0.0/sdn-stack-nav.36a36359ce18322185e9ff179f88175bab67d5ad84a14d9c08a54f2ff27267e7.css" data-nav-style-integrity="sha384-c4M8Fg+kYaeOYYtJVr7jJsde24IhSWkWaRyAOHEZU9jozhRck089aw+mnHwxymds" data-wallet-client-url="https://static.spacedatanetwork.org/assets/hd-wallet-ui/2.0.28/sdn-wallet-public-client.f611e7e151a3b5c38384272f8894a4c6634f0a29bf925b0e02e0e27f8db0bfff.js" data-wallet-client-integrity="sha384-R+QqsKoWJIS7iWrtPmgJ49DVnb1hSGjZokupbLInJd1PLp8RwQhtF/hnaerc33ci" data-wallet-style-url="https://static.spacedatanetwork.org/assets/hd-wallet-ui/2.0.28/sdn-wallet-public-client.c3f68d1cfd88478f10d836a5e829d1dfc6a10157972cf0f7d4d319d0636f2cc4.css" data-wallet-style-integrity="sha384-fICuhN4I9xqOK1F5vGGzl26opuO+xQIvTZXMSV76lWTBiQ6AfzztMGLLDw8yRT8i" data-wallet-client-id="sdn-module-sdk-pages-v1" data-wallet-callback-uri="https://digitalarsenal.github.io/space-data-module-sdk/wallet-callback.html" data-wallet-registry-sha256="e1ce6fe903c9700484a8a87d96581c8cad97063dabf63030b4518a31a3bdaa93"></script>
+<!-- SDN_CONSUMER_ASSETS_END -->
+  </head>
+  <body>
+    <a class="skip-link" href="#main">Skip to content</a>
+    <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
+    <header class="site-header">
+      <a class="site-brand" href="../">Space Data Module SDK</a>
+      <nav class="header-links" aria-label="Site">
+        <a href="../byo-wasm-quickstart.html">Quickstart</a>
+        <a href="../conformance.html">Conformance</a>
+        <a href="https://github.com/DigitalArsenal/space-data-module-sdk">GitHub</a>
+        <a class="stack-button" href="#stack">Stack</a>
+      </nav>
+    </header>
+    <div class="shell">
+      <nav class="sidebar" id="sidebar" aria-label="Documentation">
+<h2>Start here</h2><ul>
+<li><a href="../index.html"><span>Harness family matrix</span></a></li>
+<li><a href="../byo-wasm-quickstart.html"><span>BYO-wasm quickstart</span></a></li>
+<li><a href="../conformance.html"><span>Conformance kit</span></a></li>
+<li><a href="../protect-and-sign.html"><span>Protect and sign</span></a></li>
+<li><a href="../publication-submission.html"><span>Publication and listing</span></a></li>
+</ul>
+<h2>Dynamics</h2><ul>
+<li><a href="./propagator.html"><span>Propagator</span><span class="tag tag-shipped">shipped</span></a></li>
+<li><a href="./maneuver.html"><span>Maneuver</span><span class="tag tag-experimental">experimental</span></a></li>
+<li><a href="./propulsion.html"><span>Propulsion</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./attitude.html"><span>Attitude</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./gnc.html" aria-current="page"><span>GNC</span><span class="tag tag-planned">planned</span></a></li>
+</ul>
+<h2>Environment and interaction</h2><ul>
+<li><a href="./rf.html"><span>RF</span><span class="tag tag-designed">designed</span></a></li>
+<li><a href="./sensor.html"><span>Sensor</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./signature.html"><span>Signature</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./environment.html"><span>Environment</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./obstruction.html"><span>Obstruction</span><span class="tag tag-designed">designed</span></a></li>
+</ul>
+<h2>Event physics</h2><ul>
+<li><a href="./breakup.html"><span>Breakup</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./reentry.html"><span>Reentry</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./conjunction.html"><span>Conjunction</span><span class="tag tag-designed">designed</span></a></li>
+<li><a href="./effects.html"><span>Effects</span><span class="tag tag-planned">planned</span></a></li>
+</ul>
+<h2>Estimation, data and logic</h2><ul>
+<li><a href="./estimation.html"><span>Estimation</span><span class="tag tag-shipped">shipped</span></a></li>
+<li><a href="./data-source.html"><span>Data source</span><span class="tag tag-shipped">shipped</span></a></li>
+<li><a href="./analytics.html"><span>Analytics</span><span class="tag tag-experimental">experimental</span></a></li>
+<li><a href="./scheduler.html"><span>Scheduler</span><span class="tag tag-planned">planned</span></a></li>
+<li><a href="./behavior.html"><span>Behavior</span><span class="tag tag-planned">planned</span></a></li>
+</ul>
+<h2>Runtime contract</h2><ul>
+<li><a href="../events-abi.html"><span>Event locator ABI</span></a></li>
+<li><a href="../module-publication-standard.html"><span>Module publication standard</span></a></li>
+<li><a href="../browser-wasmedge-isomorphic.html"><span>Browser / WasmEdge isomorphism</span></a></li>
+<li><a href="../isomorphic-pthreads.html"><span>Isomorphic pthreads</span></a></li>
+<li><a href="../tri-runtime-parity.html"><span>Tri-runtime parity</span></a></li>
+<li><a href="../tri-runtime-parity-gate.html"><span>Tri-runtime parity gate</span></a></li>
+<li><a href="../testing-harness.html"><span>Testing harness</span></a></li>
+<li><a href="../language-runtime-matrix.html"><span>Language and runtime matrix</span></a></li>
+</ul>
+<h2>Host surfaces</h2><ul>
+<li><a href="../flatsql-host-contract.html"><span>FlatSQL host contract</span></a></li>
+<li><a href="../flatsql-streaming-standard.html"><span>FlatSQL streaming standard</span></a></li>
+<li><a href="../secrets-capability.html"><span>Credential lanes</span></a></li>
+<li><a href="../protocol-installation.html"><span>Protocol installation</span></a></li>
+<li><a href="../gpu-module-abi.html"><span>GPU module ABI</span></a></li>
+<li><a href="../module-bundle-runtime-plan.html"><span>Module bundle runtime</span></a></li>
+<li><a href="../isomorphic-sdn-runtime-plan.html"><span>Isomorphic SDN runtime</span></a></li>
+<li><a href="../node-red-default-node-parity.html"><span>Node-RED node parity</span></a></li>
+</ul>
+      </nav>
+      <main class="doc" id="main">
+      <p class="breadcrumb"><a href="../index.html">Harness families</a> / Dynamics</p>
+        <h1>GNC</h1>
+      <p class="doc-meta"><span class="pill pill-planned">planned</span><span>Planned. This family is a ratified entry in the harness-family taxonomy; its individual shape has not been ratified and nothing is implemented.</span></p>
+<p><strong>Status: PLANNED.</strong> This family is a ratified entry in the harness-family taxonomy. Its individual shape has not been ratified, and nothing is implemented. This page states scope and status; it is not a contract, and it does not imply parity with the Designed tier.</p>
+<h2 id="scope"><a class="anchor" href="#scope" aria-hidden="true">#</a>Scope</h2>
+<p>Closed-loop guidance, navigation and control. A GNC module observes estimated state, decides what the vehicle should do, and commands the maneuver and attitude families. It is the only family in the dynamics group that is allowed to be stateful across a scenario timeline, because a controller without memory is not a controller.</p>
+<h2 id="what-exists-today"><a class="anchor" href="#what-exists-today" aria-hidden="true">#</a>What exists today</h2>
+<p>Nothing. No schema, no header, no module, no open design task.</p>
+<p>GNC is the family most likely to need a scheduler and behavior contract to exist first, since a control loop is defined as much by when it runs as by what it computes.</p>
+<h2 id="what-ratification-requires"><a class="anchor" href="#what-ratification-requires" aria-hidden="true">#</a>What ratification requires</h2>
+<p>A family reaches Designed when an ABI has been drafted against a real consumer, and Shipped only when all of the following exist:</p>
+<ul>
+<li>A single <code>.fbs</code> schema as the source of the wire layout.</li>
+<li>A generated ABI header with size and offset locks, plus a drift gate that fails when the schema and the committed header disagree.</li>
+<li>Declared units and frames per field, named sentinels, and named negative error codes.</li>
+<li>A conformance kit carrying its own negative control, and a reference module.</li>
+<li>A stated tri-runtime parity envelope.</li>
+<li>Exactly one generic consumer port.</li>
+</ul>
+<p>Until then, do not build against this family. If your work falls in this scope and cannot wait, build a records-in, records-out module through the <a href="../byo-wasm-quickstart.html">BYO-wasm quickstart</a> — that path needs no harness and is available now — and expect to migrate to the family ABI when it is ratified.</p>
+      <section class="playground" id="playground-slot" data-family="gnc" data-playground="pending" aria-labelledby="playground-title">
+        <h2 id="playground-title">Playground</h2>
+        <p>
+          An in-browser build-and-run playground for the <code>gnc</code> harness
+          mounts here. It is being built under the graph task
+          <code>sdk-playground-emception</code>; this slot is its reserved mount
+          point and is intentionally empty until that lands.
+        </p>
+      </section>
+        <p class="doc-footer">
+          Source of truth for this page:
+          <code>docs/families/gnc.md</code>. Regenerate with
+          <code>npm run build:docs</code>.
+        </p>
+      </main>
+<nav class="rail" aria-label="On this page"><h2>On this page</h2><ul><li><a class="depth-2" href="#scope">Scope</a></li>
+<li><a class="depth-2" href="#what-exists-today">What exists today</a></li>
+<li><a class="depth-2" href="#what-ratification-requires">What ratification requires</a></li></ul></nav>
+    </div>
+    <section id="stack" class="section" aria-labelledby="stack-title">
+      <div class="section-head">
+        <p class="eyebrow">SDN Stack</p>
+        <h2 id="stack-title">Connected sites</h2>
+      </div>
+      <div class="link-list">
+        <a href="https://spacedatastandards.org/">
+          <span>Standards</span>
+          <small>Canonical schemas, record contracts, and generated bindings.</small>
+        </a>
+        <a href="https://digitalarsenal.github.io/flatbuffers/">
+          <span>FlatBuffers</span>
+          <small>Binary encoding, schema tooling, and runtime documentation.</small>
+        </a>
+        <a href="https://digitalarsenal.github.io/flatsql/">
+          <span>FlatSQL</span>
+          <small>SQL-style queries over FlatBuffer-backed datasets and streams.</small>
+        </a>
+        <a href="https://spacedatanetwork.org/">
+          <span>SDN</span>
+          <small>Distributed publication, discovery, delivery, and marketplace infrastructure.</small>
+        </a>
+        <a href="https://digitalarsenal.github.io/space-data-module-sdk/" class="active">
+          <span>Module SDK</span>
+          <small>WASM module packaging, validation, and host compatibility tooling.</small>
+        </a>
+      </div>
+    </section>
+    <footer class="site-footer">
+      Space Data Module SDK — Apache-2.0. Every ABI page renders a Markdown
+      source in <code>docs/</code>; edit the Markdown, never the HTML.
+    </footer>
+  </body>
+</html>

package/docs/families/gnc.md ADDED Viewed

@@ -0,0 +1,36 @@
+# GNC
+**Status: PLANNED.** This family is a ratified entry in the harness-family
+taxonomy. Its individual shape has not been ratified, and nothing is
+implemented. This page states scope and status; it is not a contract, and it
+does not imply parity with the Designed tier.
+## Scope
+Closed-loop guidance, navigation and control. A GNC module observes estimated state, decides what the vehicle should do, and commands the maneuver and attitude families. It is the only family in the dynamics group that is allowed to be stateful across a scenario timeline, because a controller without memory is not a controller.
+## What exists today
+Nothing. No schema, no header, no module, no open design task.
+GNC is the family most likely to need a scheduler and behavior contract to exist first, since a control loop is defined as much by when it runs as by what it computes.
+## What ratification requires
+A family reaches Designed when an ABI has been drafted against a real consumer,
+and Shipped only when all of the following exist:
+- A single `.fbs` schema as the source of the wire layout.
+- A generated ABI header with size and offset locks, plus a drift gate that
+  fails when the schema and the committed header disagree.
+- Declared units and frames per field, named sentinels, and named negative error
+  codes.
+- A conformance kit carrying its own negative control, and a reference module.
+- A stated tri-runtime parity envelope.
+- Exactly one generic consumer port.
+Until then, do not build against this family. If your work falls in this scope
+and cannot wait, build a records-in, records-out module through the
+[BYO-wasm quickstart](../byo-wasm-quickstart.html) — that path needs no harness
+and is available now — and expect to migrate to the family ABI when it is
+ratified.