space-data-module-sdk 0.8.18 → 0.8.20

package/docs/isomorphic-pthreads.md

@@ -156,12 +156,70 @@ actually spawns and runs guest threads.
 > **Rule:** Do not claim WasmEdge thread support until a real runtime invocation
 > spawns threads and runs. Compile-time validation (wasi-threads contract +
 > shared memory + atomics) is necessary but not sufficient; runtime thread-spawn
-> verification is owned by the deploy/benchmark node, not by this SDK.
+> verification must exercise the actual host and linked runtime used in deployment.
 
 Record any WasmEdge runtime limitation honestly. An artifact that validates here
 but only compiles — and does not instantiate/spawn threads under the target
 runtime — must be reported as such.
 
+### SDK 0.8.20 command hosts
+
+WasmEdge 0.16.4's CLI enables atomics with `--enable-threads` but does not
+provide `wasi.thread-spawn`. For artifacts importing that function, the SDK's
+native parity lane and `createStandaloneHarness("wasmedge", ...)` automatically
+build and cache the C API command runner from
+`src/testing/native/wasmedge_wasi_threads_runner.c`. The runner links against
+WasmEdge **0.16.4**, uses one executor and shared imported memory, and creates a
+fresh module instance for each `wasi_thread_start(tid, arg)`. It limits live
+workers to 32 and cancels the command group on a worker trap. Guest arguments,
+environment, stdin, stdout and stderr use WASI preview1.
+
+The automatic build requires Git, CMake, Ninja, and a C/C++ compiler. It builds
+an isolated, cached WasmEdge 0.16.4 runtime with the SDN atomic-wait correction:
+unmodified 0.16.4 can lose a notification between comparing memory and sleeping,
+and does not correctly wake on notification without a memory store. The patch
+also preserves waiter iterators when other waiters register. The installed
+`~/.wasmedge` SDK and CLI are unchanged.
+
+Set both `WASMEDGE_INCLUDE_DIR` and `WASMEDGE_LIB_DIR` to supply an operator-built
+runtime with the same correction. An explicit `wasmEdgeRunnerBinary` selects a
+prebuilt command runner. The builder is
+`buildWasmEdgeWasiThreadsRunner` in `src/testing/buildWasmEdgeRunner.js`.
+The Docker parity image builds the same corrected runtime and runner for threaded
+artifacts; modules without `wasi.thread-spawn` keep the ordinary CLI path.
+The Docker runner image includes a source digest in its tag to avoid stale
+runner reuse.
+
+Direct-only threaded reactors have no `_start`. For those artifacts the runner
+calls `_initialize`, stages the raw request through `plugin_alloc`, and invokes
+`plugin_invoke_stream`. The parity harness selects the browser direct surface
+automatically as well. This is one request per process; the legacy resident
+runner's framing protocol remains separate. Module-owned external memory regions
+are not materialized by this one-shot transport; outputs containing pointers
+into guest memory are not portable byte-level parity results.
+
+The browser command harness runs `_start` exactly once per request, after
+installing stdin. Pthreads share one process input cursor and output buffers,
+as well as argv and environment. Each command owns and terminates its workers.
+The real-browser parity lane runs in an owning worker with a warmed pthread
+pool, enabling blocking `pthread_join` outside the browser's main thread.
+Parity reports include `spawnCount`; requested thread counts alone are not
+evidence of actual spawning.
+
+The regression compiles a real pthread guest, validates distinct binary
+requests, and checks command/direct output and actual spawn counts at 1, 2, 4
+and 8 workers through the SDK parity CLI:
+
+```sh
+SPACE_DATA_MODULE_SDK_ENABLE_WASMEDGE_PARITY=1 \
+SPACE_DATA_MODULE_SDK_ENABLE_TRI_RUNTIME_PARITY=1 \
+node --test test/wasi-threads-command.test.js
+```
+
+The old source path `src/testing/browserModuleHarness.js` remains a pure
+compatibility re-export. New browser consumers should use the public
+`space-data-module-sdk/host/browser-module` entry point.
+
 ## 4. Integrators: the browser worker anchor (REQUIRED when you bundle)
 
 The browser leg of the wasi-threads host runs each guest pthread on a pooled

package/docs/isomorphic-sdn-runtime-plan.html

@@ -2,10 +2,12 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />
+    <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="description" content="Run the same signed Space Data modules across browser, server, OrbPro, and" />
     <title>Isomorphic SDN runtime — Space Data Module SDK</title>
     <link rel="stylesheet" href="./styles.css" />
+    <script src="./assembly.js" defer></script>
     <!-- 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>
@@ -13,6 +15,7 @@
 <!-- SDN_CONSUMER_ASSETS_END -->
   </head>
   <body>
+    <canvas id="assembly" aria-hidden="true"></canvas>
     <a class="skip-link" href="#main">Skip to content</a>
     <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
     <header class="site-header">
@@ -22,12 +25,13 @@
         <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>
+        <button class="theme-toggle" type="button" aria-label="Switch between light and dark theme" title="Light or dark theme"><svg class="sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg><svg class="moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5z"/></svg></button>
       </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="./index.html"><span>Module types</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>
@@ -269,6 +273,7 @@
     <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.
+      Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
     </footer>
   </body>
 </html>

package/docs/language-runtime-matrix.html

@@ -2,10 +2,12 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />
+    <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="description" content="Status: WS12.1 deliverable. Section 1 is the definitive language/runtime matrix. Section 2 is the per-file port/dedupe plan that WS12.2 executes. All source paths verified again..." />
     <title>Language and runtime matrix — Space Data Module SDK</title>
     <link rel="stylesheet" href="./styles.css" />
+    <script src="./assembly.js" defer></script>
     <!-- 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>
@@ -13,6 +15,7 @@
 <!-- SDN_CONSUMER_ASSETS_END -->
   </head>
   <body>
+    <canvas id="assembly" aria-hidden="true"></canvas>
     <a class="skip-link" href="#main">Skip to content</a>
     <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
     <header class="site-header">
@@ -22,12 +25,13 @@
         <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>
+        <button class="theme-toggle" type="button" aria-label="Switch between light and dark theme" title="Light or dark theme"><svg class="sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg><svg class="moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5z"/></svg></button>
       </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="./index.html"><span>Module types</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>
@@ -177,6 +181,7 @@
     <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.
+      Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
     </footer>
   </body>
 </html>

package/docs/llms.txt

@@ -13,7 +13,7 @@ WasmEdge, which breaks tri-runtime isomorphism. Modules must be EH-free.
 
 ## Start here
 
-- [Harness family matrix](https://digitalarsenal.github.io/space-data-module-sdk/): every family and its status.
+- [Module types](https://digitalarsenal.github.io/space-data-module-sdk/): every harness family and its status.
 - [BYO-wasm quickstart](https://digitalarsenal.github.io/space-data-module-sdk/byo-wasm-quickstart.html): multi-TU C++ to a loadable artifact.
 - [Conformance kit](https://digitalarsenal.github.io/space-data-module-sdk/conformance.html): self-test commands and what each asserts.
 - [Protect and sign](https://digitalarsenal.github.io/space-data-module-sdk/protect-and-sign.html): artifact protection and signing.

package/docs/module-bundle-runtime-plan.html

@@ -2,10 +2,12 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />
+    <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="description" content="This document is superseded by:" />
     <title>Module bundle runtime — Space Data Module SDK</title>
     <link rel="stylesheet" href="./styles.css" />
+    <script src="./assembly.js" defer></script>
     <!-- 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>
@@ -13,6 +15,7 @@
 <!-- SDN_CONSUMER_ASSETS_END -->
   </head>
   <body>
+    <canvas id="assembly" aria-hidden="true"></canvas>
     <a class="skip-link" href="#main">Skip to content</a>
     <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
     <header class="site-header">
@@ -22,12 +25,13 @@
         <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>
+        <button class="theme-toggle" type="button" aria-label="Switch between light and dark theme" title="Light or dark theme"><svg class="sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg><svg class="moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5z"/></svg></button>
       </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="./index.html"><span>Module types</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>
@@ -141,6 +145,7 @@
     <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.
+      Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
     </footer>
   </body>
 </html>

package/docs/module-publication-standard.html

@@ -2,10 +2,12 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />
+    <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="description" content="This document defines how a compliant Space Data module is published through the" />
     <title>Module publication standard — Space Data Module SDK</title>
     <link rel="stylesheet" href="./styles.css" />
+    <script src="./assembly.js" defer></script>
     <!-- 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>
@@ -13,6 +15,7 @@
 <!-- SDN_CONSUMER_ASSETS_END -->
   </head>
   <body>
+    <canvas id="assembly" aria-hidden="true"></canvas>
     <a class="skip-link" href="#main">Skip to content</a>
     <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
     <header class="site-header">
@@ -22,12 +25,13 @@
         <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>
+        <button class="theme-toggle" type="button" aria-label="Switch between light and dark theme" title="Light or dark theme"><svg class="sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg><svg class="moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5z"/></svg></button>
       </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="./index.html"><span>Module types</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>
@@ -498,6 +502,7 @@ manifestSizeSymbol = &quot;plugin_get_manifest_flatbuffer_size&quot;</code></pre
     <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.
+      Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
     </footer>
   </body>
 </html>

package/docs/node-red-default-node-parity.html

@@ -2,10 +2,12 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />
+    <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="description" content="This matrix defines the deployment intent for compiled hosted-runtime artifacts." />
     <title>Node-RED node parity — Space Data Module SDK</title>
     <link rel="stylesheet" href="./styles.css" />
+    <script src="./assembly.js" defer></script>
     <!-- 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>
@@ -13,6 +15,7 @@
 <!-- SDN_CONSUMER_ASSETS_END -->
   </head>
   <body>
+    <canvas id="assembly" aria-hidden="true"></canvas>
     <a class="skip-link" href="#main">Skip to content</a>
     <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
     <header class="site-header">
@@ -22,12 +25,13 @@
         <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>
+        <button class="theme-toggle" type="button" aria-label="Switch between light and dark theme" title="Light or dark theme"><svg class="sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg><svg class="moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5z"/></svg></button>
       </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="./index.html"><span>Module types</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>
@@ -196,6 +200,7 @@
     <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.
+      Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
     </footer>
   </body>
 </html>

package/docs/protect-and-sign.html

@@ -2,10 +2,12 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />
+    <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="description" content="Once a module passes conformance and the parity gate, it is protected" />
     <title>Protect and sign — Space Data Module SDK</title>
     <link rel="stylesheet" href="./styles.css" />
+    <script src="./assembly.js" defer></script>
     <!-- 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>
@@ -13,6 +15,7 @@
 <!-- SDN_CONSUMER_ASSETS_END -->
   </head>
   <body>
+    <canvas id="assembly" aria-hidden="true"></canvas>
     <a class="skip-link" href="#main">Skip to content</a>
     <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
     <header class="site-header">
@@ -22,12 +25,13 @@
         <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>
+        <button class="theme-toggle" type="button" aria-label="Switch between light and dark theme" title="Light or dark theme"><svg class="sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg><svg class="moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5z"/></svg></button>
       </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="./index.html"><span>Module types</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" aria-current="page"><span>Protect and sign</span></a></li>
@@ -176,6 +180,7 @@ space-data-module protect \
     <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.
+      Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
     </footer>
   </body>
 </html>

package/docs/protocol-installation.html

@@ -2,10 +2,12 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />
+    <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="description" content="This SDK now separates protocol identity from deployment-time routing." />
     <title>Protocol installation — Space Data Module SDK</title>
     <link rel="stylesheet" href="./styles.css" />
+    <script src="./assembly.js" defer></script>
     <!-- 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>
@@ -13,6 +15,7 @@
 <!-- SDN_CONSUMER_ASSETS_END -->
   </head>
   <body>
+    <canvas id="assembly" aria-hidden="true"></canvas>
     <a class="skip-link" href="#main">Skip to content</a>
     <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
     <header class="site-header">
@@ -22,12 +25,13 @@
         <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>
+        <button class="theme-toggle" type="button" aria-label="Switch between light and dark theme" title="Light or dark theme"><svg class="sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg><svg class="moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5z"/></svg></button>
       </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="./index.html"><span>Module types</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>
@@ -291,6 +295,7 @@
     <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.
+      Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
     </footer>
   </body>
 </html>

package/docs/publication-submission.html

@@ -2,10 +2,12 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />
+    <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="description" content="The last step of the integrator path: turn a signed artifact into something a" />
     <title>Publication and listing — Space Data Module SDK</title>
     <link rel="stylesheet" href="./styles.css" />
+    <script src="./assembly.js" defer></script>
     <!-- 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>
@@ -13,6 +15,7 @@
 <!-- SDN_CONSUMER_ASSETS_END -->
   </head>
   <body>
+    <canvas id="assembly" aria-hidden="true"></canvas>
     <a class="skip-link" href="#main">Skip to content</a>
     <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
     <header class="site-header">
@@ -22,12 +25,13 @@
         <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>
+        <button class="theme-toggle" type="button" aria-label="Switch between light and dark theme" title="Light or dark theme"><svg class="sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg><svg class="moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5z"/></svg></button>
       </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="./index.html"><span>Module types</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>
@@ -153,6 +157,7 @@
     <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.
+      Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
     </footer>
   </body>
 </html>

package/docs/secrets-capability.html

@@ -2,10 +2,12 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />
+    <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="description" content="A module often needs an operator's third-party credential: a Space-Track login," />
     <title>Credential lanes — Space Data Module SDK</title>
     <link rel="stylesheet" href="./styles.css" />
+    <script src="./assembly.js" defer></script>
     <!-- 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>
@@ -13,6 +15,7 @@
 <!-- SDN_CONSUMER_ASSETS_END -->
   </head>
   <body>
+    <canvas id="assembly" aria-hidden="true"></canvas>
     <a class="skip-link" href="#main">Skip to content</a>
     <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
     <header class="site-header">
@@ -22,12 +25,13 @@
         <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>
+        <button class="theme-toggle" type="button" aria-label="Switch between light and dark theme" title="Light or dark theme"><svg class="sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg><svg class="moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5z"/></svg></button>
       </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="./index.html"><span>Module types</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>
@@ -201,6 +205,7 @@ secrets.status  -&gt; {&quot;id&quot;:&quot;&lt;lane&gt;&quot;}
     <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.
+      Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
     </footer>
   </body>
 </html>

package/docs/styles.css

@@ -979,3 +979,35 @@ a.card:hover {
     transition: none !important;
   }
 }
+
+/* ------------------------------------------------------------ background */
+
+/* "Assembly" (assembly.js): module tiles that settle into a lattice and
+   connect into flows. Faded under the reading column so text stays clear. */
+#assembly {
+  position: fixed;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  z-index: -1;
+  pointer-events: none;
+  -webkit-mask-image: radial-gradient(ellipse 48% 62% at 50% 46%, rgba(0, 0, 0, 0.14), #000 82%);
+  mask-image: radial-gradient(ellipse 48% 62% at 50% 46%, rgba(0, 0, 0, 0.14), #000 82%);
+}
+
+/* Reading pages keep the lattice quieter than the landing page. */
+body:not([data-assembly="scroll"]) #assembly {
+  opacity: 0.45;
+}
+
+/* Theme switcher: follows the system until the reader picks; the choice is remembered. */
+.theme-toggle { display: inline-grid; place-items: center; width: 32px; height: 32px; border-radius: 50%; border: 1px solid var(--hairline-strong); background: transparent; color: var(--ink); cursor: pointer; }
+.theme-toggle:hover { background: var(--surface-hover); }
+.theme-toggle svg { width: 16px; height: 16px; }
+.theme-toggle .moon { display: none; }
+:root[data-theme="light"] .theme-toggle .moon { display: block; }
+:root[data-theme="light"] .theme-toggle .sun { display: none; }
+@media (prefers-color-scheme: light) {
+  :root:not([data-theme]) .theme-toggle .moon { display: block; }
+  :root:not([data-theme]) .theme-toggle .sun { display: none; }
+}

package/docs/testing-harness.html

@@ -2,10 +2,12 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />
+    <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="description" content="This repo now includes two related testing/runtime surfaces in" />
     <title>Testing harness — Space Data Module SDK</title>
     <link rel="stylesheet" href="./styles.css" />
+    <script src="./assembly.js" defer></script>
     <!-- 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>
@@ -13,6 +15,7 @@
 <!-- SDN_CONSUMER_ASSETS_END -->
   </head>
   <body>
+    <canvas id="assembly" aria-hidden="true"></canvas>
     <a class="skip-link" href="#main">Skip to content</a>
     <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
     <header class="site-header">
@@ -22,12 +25,13 @@
         <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>
+        <button class="theme-toggle" type="button" aria-label="Switch between light and dark theme" title="Light or dark theme"><svg class="sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg><svg class="moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5z"/></svg></button>
       </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="./index.html"><span>Module types</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>
@@ -403,6 +407,7 @@ npm run benchmark:module-stream-1gib</code></pre></div>
     <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.
+      Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
     </footer>
   </body>
 </html>