space-data-module-sdk 0.8.19 → 0.8.20

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 (64) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +2 -2
  3. package/docs/assembly.js +190 -0
  4. package/docs/browser-wasmedge-isomorphic.html +6 -1
  5. package/docs/byo-wasm-quickstart.html +6 -1
  6. package/docs/conformance.html +6 -1
  7. package/docs/events-abi.html +6 -1
  8. package/docs/families/analytics.html +7 -2
  9. package/docs/families/attitude.html +7 -2
  10. package/docs/families/behavior.html +7 -2
  11. package/docs/families/breakup.html +7 -2
  12. package/docs/families/conjunction.html +7 -2
  13. package/docs/families/data-source.html +7 -2
  14. package/docs/families/effects.html +7 -2
  15. package/docs/families/environment.html +7 -2
  16. package/docs/families/estimation.html +7 -2
  17. package/docs/families/gnc.html +7 -2
  18. package/docs/families/maneuver.html +7 -2
  19. package/docs/families/obstruction.html +7 -2
  20. package/docs/families/propagator.html +7 -2
  21. package/docs/families/propulsion.html +7 -2
  22. package/docs/families/reentry.html +7 -2
  23. package/docs/families/rf.html +7 -2
  24. package/docs/families/scheduler.html +7 -2
  25. package/docs/families/sensor.html +7 -2
  26. package/docs/families/signature.html +7 -2
  27. package/docs/flatsql-host-contract.html +7 -2
  28. package/docs/flatsql-host-contract.md +2 -2
  29. package/docs/flatsql-streaming-standard.html +6 -1
  30. package/docs/gpu-module-abi.html +6 -1
  31. package/docs/index.html +21 -14
  32. package/docs/isomorphic-pthreads.html +19 -2
  33. package/docs/isomorphic-pthreads.md +59 -1
  34. package/docs/isomorphic-sdn-runtime-plan.html +6 -1
  35. package/docs/language-runtime-matrix.html +6 -1
  36. package/docs/llms.txt +1 -1
  37. package/docs/module-bundle-runtime-plan.html +6 -1
  38. package/docs/module-publication-standard.html +6 -1
  39. package/docs/node-red-default-node-parity.html +6 -1
  40. package/docs/protect-and-sign.html +6 -1
  41. package/docs/protocol-installation.html +6 -1
  42. package/docs/publication-submission.html +6 -1
  43. package/docs/secrets-capability.html +6 -1
  44. package/docs/styles.css +32 -0
  45. package/docs/testing-harness.html +6 -1
  46. package/docs/tri-runtime-parity-gate.html +6 -1
  47. package/docs/tri-runtime-parity.html +6 -1
  48. package/package.json +1 -1
  49. package/src/host/browserModuleHarness.js +39 -35
  50. package/src/host/isomorphicLoader.js +13 -6
  51. package/src/host/wasiShim.js +57 -13
  52. package/src/host/wasiThreadBrowserWorker.mjs +1 -0
  53. package/src/host/wasiThreadHost.js +16 -1
  54. package/src/host/wasiThreadWorker.mjs +2 -1
  55. package/src/host/wasiThreadWorkerRuntime.js +2 -1
  56. package/src/testing/browserModuleHarness.js +2 -0
  57. package/src/testing/buildWasmEdgeRunner.js +147 -4
  58. package/src/testing/docker/wasmedge-parity.Dockerfile +23 -1
  59. package/src/testing/isomorphicHarness.js +5 -0
  60. package/src/testing/native/wasmedge-0.16.4-atomic-wait.patch +111 -0
  61. package/src/testing/native/wasmedge_wasi_threads_runner.c +345 -0
  62. package/src/testing/parityBrowserRunner.js +12 -4
  63. package/src/testing/parityHarness.js +11 -3
  64. package/src/testing/parityLanes.js +29 -5
package/docs/families/rf.html CHANGED
@@ -2,10 +2,12 @@
2
2
  <html lang="en">
3
3
  <head>
4
4
  <meta charset="utf-8" />
5
+ <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
5
6
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
7
  <meta name="description" content="Status: DESIGNED. The RF ABI has been drafted against a real paying" />
7
8
  <title>RF — Space Data Module SDK</title>
8
9
  <link rel="stylesheet" href="../styles.css" />
10
+ <script src="../assembly.js" defer></script>
9
11
  <!-- SDN_CONSUMER_ASSETS_START -->
10
12
  <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">
11
13
  <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 @@
13
15
  <!-- SDN_CONSUMER_ASSETS_END -->
14
16
  </head>
15
17
  <body>
18
+ <canvas id="assembly" aria-hidden="true"></canvas>
16
19
  <a class="skip-link" href="#main">Skip to content</a>
17
20
  <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
18
21
  <header class="site-header">
@@ -22,12 +25,13 @@
22
25
  <a href="../conformance.html">Conformance</a>
23
26
  <a href="https://github.com/DigitalArsenal/space-data-module-sdk">GitHub</a>
24
27
  <a class="stack-button" href="#stack">Stack</a>
28
+ <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>
25
29
  </nav>
26
30
  </header>
27
31
  <div class="shell">
28
32
  <nav class="sidebar" id="sidebar" aria-label="Documentation">
29
33
  <h2>Start here</h2><ul>
30
- <li><a href="../index.html"><span>Harness family matrix</span></a></li>
34
+ <li><a href="../index.html"><span>Module types</span></a></li>
31
35
  <li><a href="../byo-wasm-quickstart.html"><span>BYO-wasm quickstart</span></a></li>
32
36
  <li><a href="../conformance.html"><span>Conformance kit</span></a></li>
33
37
  <li><a href="../protect-and-sign.html"><span>Protect and sign</span></a></li>
@@ -82,7 +86,7 @@
82
86
  </ul>
83
87
  </nav>
84
88
  <main class="doc" id="main">
85
- <p class="breadcrumb"><a href="../index.html">Harness families</a> / Environment and interaction</p>
89
+ <p class="breadcrumb"><a href="../index.html">Module types</a> / Environment and interaction</p>
86
90
  <h1>RF</h1>
87
91
  <p class="doc-meta"><span class="pill pill-designed">designed</span><span>Designed, not ratified. The ABI has been drafted against a real consumer but no generated header, conformance kit, or reference module has landed.</span></p>
88
92
  <p><strong>Status: DESIGNED.</strong> The RF ABI has been drafted against a real paying consumer, and the boundary of what will and will not be a public contract has been ruled. No <code>.fbs</code>, no generated header, no conformance kit and no reference module exist yet. Nothing on this page is a stable ABI.</p>
@@ -188,6 +192,7 @@
188
192
  <footer class="site-footer">
189
193
  Space Data Module SDK — Apache-2.0. Every ABI page renders a Markdown
190
194
  source in <code>docs/</code>; edit the Markdown, never the HTML.
195
+ Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
191
196
  </footer>
192
197
  </body>
193
198
  </html>
package/docs/families/scheduler.html CHANGED
@@ -2,10 +2,12 @@
2
2
  <html lang="en">
3
3
  <head>
4
4
  <meta charset="utf-8" />
5
+ <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
5
6
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
7
  <meta name="description" content="Status: PLANNED. This family is a ratified entry in the harness-family" />
7
8
  <title>Scheduler — Space Data Module SDK</title>
8
9
  <link rel="stylesheet" href="../styles.css" />
10
+ <script src="../assembly.js" defer></script>
9
11
  <!-- SDN_CONSUMER_ASSETS_START -->
10
12
  <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">
11
13
  <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 @@
13
15
  <!-- SDN_CONSUMER_ASSETS_END -->
14
16
  </head>
15
17
  <body>
18
+ <canvas id="assembly" aria-hidden="true"></canvas>
16
19
  <a class="skip-link" href="#main">Skip to content</a>
17
20
  <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
18
21
  <header class="site-header">
@@ -22,12 +25,13 @@
22
25
  <a href="../conformance.html">Conformance</a>
23
26
  <a href="https://github.com/DigitalArsenal/space-data-module-sdk">GitHub</a>
24
27
  <a class="stack-button" href="#stack">Stack</a>
28
+ <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>
25
29
  </nav>
26
30
  </header>
27
31
  <div class="shell">
28
32
  <nav class="sidebar" id="sidebar" aria-label="Documentation">
29
33
  <h2>Start here</h2><ul>
30
- <li><a href="../index.html"><span>Harness family matrix</span></a></li>
34
+ <li><a href="../index.html"><span>Module types</span></a></li>
31
35
  <li><a href="../byo-wasm-quickstart.html"><span>BYO-wasm quickstart</span></a></li>
32
36
  <li><a href="../conformance.html"><span>Conformance kit</span></a></li>
33
37
  <li><a href="../protect-and-sign.html"><span>Protect and sign</span></a></li>
@@ -82,7 +86,7 @@
82
86
  </ul>
83
87
  </nav>
84
88
  <main class="doc" id="main">
85
- <p class="breadcrumb"><a href="../index.html">Harness families</a> / Estimation, data and logic</p>
89
+ <p class="breadcrumb"><a href="../index.html">Module types</a> / Estimation, data and logic</p>
86
90
  <h1>Scheduler</h1>
87
91
  <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>
88
92
  <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>
@@ -152,6 +156,7 @@
152
156
  <footer class="site-footer">
153
157
  Space Data Module SDK — Apache-2.0. Every ABI page renders a Markdown
154
158
  source in <code>docs/</code>; edit the Markdown, never the HTML.
159
+ Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
155
160
  </footer>
156
161
  </body>
157
162
  </html>
package/docs/families/sensor.html CHANGED
@@ -2,10 +2,12 @@
2
2
  <html lang="en">
3
3
  <head>
4
4
  <meta charset="utf-8" />
5
+ <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
5
6
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
7
  <meta name="description" content="Status: PLANNED. This family is a ratified entry in the harness-family" />
7
8
  <title>Sensor — Space Data Module SDK</title>
8
9
  <link rel="stylesheet" href="../styles.css" />
10
+ <script src="../assembly.js" defer></script>
9
11
  <!-- SDN_CONSUMER_ASSETS_START -->
10
12
  <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">
11
13
  <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 @@
13
15
  <!-- SDN_CONSUMER_ASSETS_END -->
14
16
  </head>
15
17
  <body>
18
+ <canvas id="assembly" aria-hidden="true"></canvas>
16
19
  <a class="skip-link" href="#main">Skip to content</a>
17
20
  <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
18
21
  <header class="site-header">
@@ -22,12 +25,13 @@
22
25
  <a href="../conformance.html">Conformance</a>
23
26
  <a href="https://github.com/DigitalArsenal/space-data-module-sdk">GitHub</a>
24
27
  <a class="stack-button" href="#stack">Stack</a>
28
+ <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>
25
29
  </nav>
26
30
  </header>
27
31
  <div class="shell">
28
32
  <nav class="sidebar" id="sidebar" aria-label="Documentation">
29
33
  <h2>Start here</h2><ul>
30
- <li><a href="../index.html"><span>Harness family matrix</span></a></li>
34
+ <li><a href="../index.html"><span>Module types</span></a></li>
31
35
  <li><a href="../byo-wasm-quickstart.html"><span>BYO-wasm quickstart</span></a></li>
32
36
  <li><a href="../conformance.html"><span>Conformance kit</span></a></li>
33
37
  <li><a href="../protect-and-sign.html"><span>Protect and sign</span></a></li>
@@ -82,7 +86,7 @@
82
86
  </ul>
83
87
  </nav>
84
88
  <main class="doc" id="main">
85
- <p class="breadcrumb"><a href="../index.html">Harness families</a> / Environment and interaction</p>
89
+ <p class="breadcrumb"><a href="../index.html">Module types</a> / Environment and interaction</p>
86
90
  <h1>Sensor</h1>
87
91
  <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>
88
92
  <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>
@@ -152,6 +156,7 @@
152
156
  <footer class="site-footer">
153
157
  Space Data Module SDK — Apache-2.0. Every ABI page renders a Markdown
154
158
  source in <code>docs/</code>; edit the Markdown, never the HTML.
159
+ Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
155
160
  </footer>
156
161
  </body>
157
162
  </html>
package/docs/families/signature.html CHANGED
@@ -2,10 +2,12 @@
2
2
  <html lang="en">
3
3
  <head>
4
4
  <meta charset="utf-8" />
5
+ <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
5
6
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
7
  <meta name="description" content="Status: PLANNED. This family is a ratified entry in the harness-family" />
7
8
  <title>Signature — Space Data Module SDK</title>
8
9
  <link rel="stylesheet" href="../styles.css" />
10
+ <script src="../assembly.js" defer></script>
9
11
  <!-- SDN_CONSUMER_ASSETS_START -->
10
12
  <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">
11
13
  <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 @@
13
15
  <!-- SDN_CONSUMER_ASSETS_END -->
14
16
  </head>
15
17
  <body>
18
+ <canvas id="assembly" aria-hidden="true"></canvas>
16
19
  <a class="skip-link" href="#main">Skip to content</a>
17
20
  <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
18
21
  <header class="site-header">
@@ -22,12 +25,13 @@
22
25
  <a href="../conformance.html">Conformance</a>
23
26
  <a href="https://github.com/DigitalArsenal/space-data-module-sdk">GitHub</a>
24
27
  <a class="stack-button" href="#stack">Stack</a>
28
+ <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>
25
29
  </nav>
26
30
  </header>
27
31
  <div class="shell">
28
32
  <nav class="sidebar" id="sidebar" aria-label="Documentation">
29
33
  <h2>Start here</h2><ul>
30
- <li><a href="../index.html"><span>Harness family matrix</span></a></li>
34
+ <li><a href="../index.html"><span>Module types</span></a></li>
31
35
  <li><a href="../byo-wasm-quickstart.html"><span>BYO-wasm quickstart</span></a></li>
32
36
  <li><a href="../conformance.html"><span>Conformance kit</span></a></li>
33
37
  <li><a href="../protect-and-sign.html"><span>Protect and sign</span></a></li>
@@ -82,7 +86,7 @@
82
86
  </ul>
83
87
  </nav>
84
88
  <main class="doc" id="main">
85
- <p class="breadcrumb"><a href="../index.html">Harness families</a> / Environment and interaction</p>
89
+ <p class="breadcrumb"><a href="../index.html">Module types</a> / Environment and interaction</p>
86
90
  <h1>Signature</h1>
87
91
  <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>
88
92
  <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>
@@ -152,6 +156,7 @@
152
156
  <footer class="site-footer">
153
157
  Space Data Module SDK — Apache-2.0. Every ABI page renders a Markdown
154
158
  source in <code>docs/</code>; edit the Markdown, never the HTML.
159
+ Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
155
160
  </footer>
156
161
  </body>
157
162
  </html>
package/docs/flatsql-host-contract.html CHANGED
@@ -2,10 +2,12 @@
2
2
  <html lang="en">
3
3
  <head>
4
4
  <meta charset="utf-8" />
5
+ <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
5
6
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
7
  <meta name="description" content="The current floor is ^2.0.0. The 1.x history below is what made the" />
7
8
  <title>FlatSQL host contract — Space Data Module SDK</title>
8
9
  <link rel="stylesheet" href="./styles.css" />
10
+ <script src="./assembly.js" defer></script>
9
11
  <!-- SDN_CONSUMER_ASSETS_START -->
10
12
  <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">
11
13
  <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 @@
13
15
  <!-- SDN_CONSUMER_ASSETS_END -->
14
16
  </head>
15
17
  <body>
18
+ <canvas id="assembly" aria-hidden="true"></canvas>
16
19
  <a class="skip-link" href="#main">Skip to content</a>
17
20
  <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
18
21
  <header class="site-header">
@@ -22,12 +25,13 @@
22
25
  <a href="./conformance.html">Conformance</a>
23
26
  <a href="https://github.com/DigitalArsenal/space-data-module-sdk">GitHub</a>
24
27
  <a class="stack-button" href="#stack">Stack</a>
28
+ <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>
25
29
  </nav>
26
30
  </header>
27
31
  <div class="shell">
28
32
  <nav class="sidebar" id="sidebar" aria-label="Documentation">
29
33
  <h2>Start here</h2><ul>
30
- <li><a href="./index.html"><span>Harness family matrix</span></a></li>
34
+ <li><a href="./index.html"><span>Module types</span></a></li>
31
35
  <li><a href="./byo-wasm-quickstart.html"><span>BYO-wasm quickstart</span></a></li>
32
36
  <li><a href="./conformance.html"><span>Conformance kit</span></a></li>
33
37
  <li><a href="./protect-and-sign.html"><span>Protect and sign</span></a></li>
@@ -124,7 +128,7 @@ README.md licence + contact section</code></pre></div>
124
128
  <p>Two consequences for anyone reading this floor:</p>
125
129
  <ul>
126
130
  <li><strong>Every pre-2.0.0 <code>flatsql</code> is withdrawn from npm.</strong> A pin below <code>^2.0.0</code> resolves to nothing. There is no supported lower floor.</li>
127
- <li><strong>Commercial use of the engine needs a licence</strong> from DigitalArsenal.io, Inc. (<a href="mailto:tj@digitalarsenal.io">tj@digitalarsenal.io</a>). The SDK stays MIT and consumes flatsql through its JS API only, but installing the SDK installs the engine, so the obligation reaches the SDK's consumers.</li>
131
+ <li><strong>Commercial use of the engine needs a licence</strong> from Edgesource Corporation (<a href="mailto:tj@edgesource.com">tj@edgesource.com</a>). The SDK stays MIT and consumes flatsql through its JS API only, but installing the SDK installs the engine, so the obligation reaches the SDK's consumers.</li>
128
132
  </ul>
129
133
 
130
134
  <p class="doc-footer">
@@ -171,6 +175,7 @@ README.md licence + contact section</code></pre></div>
171
175
  <footer class="site-footer">
172
176
  Space Data Module SDK — Apache-2.0. Every ABI page renders a Markdown
173
177
  source in <code>docs/</code>; edit the Markdown, never the HTML.
178
+ Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
174
179
  </footer>
175
180
  </body>
176
181
  </html>
package/docs/flatsql-host-contract.md CHANGED
@@ -122,7 +122,7 @@ Two consequences for anyone reading this floor:
122
122
 
123
123
  - **Every pre-2.0.0 `flatsql` is withdrawn from npm.** A pin below `^2.0.0`
124
124
  resolves to nothing. There is no supported lower floor.
125
- - **Commercial use of the engine needs a licence** from DigitalArsenal.io, Inc.
126
- ([tj@digitalarsenal.io](mailto:tj@digitalarsenal.io)). The SDK stays MIT and
125
+ - **Commercial use of the engine needs a licence** from Edgesource Corporation
126
+ ([tj@edgesource.com](mailto:tj@edgesource.com)). The SDK stays MIT and
127
127
  consumes flatsql through its JS API only, but installing the SDK installs the
128
128
  engine, so the obligation reaches the SDK's consumers.
package/docs/flatsql-streaming-standard.html CHANGED
@@ -2,10 +2,12 @@
2
2
  <html lang="en">
3
3
  <head>
4
4
  <meta charset="utf-8" />
5
+ <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
5
6
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
7
  <meta name="description" content="This document defines the recommended standard for getting streamed" />
7
8
  <title>FlatSQL streaming standard — Space Data Module SDK</title>
8
9
  <link rel="stylesheet" href="./styles.css" />
10
+ <script src="./assembly.js" defer></script>
9
11
  <!-- SDN_CONSUMER_ASSETS_START -->
10
12
  <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">
11
13
  <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 @@
13
15
  <!-- SDN_CONSUMER_ASSETS_END -->
14
16
  </head>
15
17
  <body>
18
+ <canvas id="assembly" aria-hidden="true"></canvas>
16
19
  <a class="skip-link" href="#main">Skip to content</a>
17
20
  <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
18
21
  <header class="site-header">
@@ -22,12 +25,13 @@
22
25
  <a href="./conformance.html">Conformance</a>
23
26
  <a href="https://github.com/DigitalArsenal/space-data-module-sdk">GitHub</a>
24
27
  <a class="stack-button" href="#stack">Stack</a>
28
+ <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>
25
29
  </nav>
26
30
  </header>
27
31
  <div class="shell">
28
32
  <nav class="sidebar" id="sidebar" aria-label="Documentation">
29
33
  <h2>Start here</h2><ul>
30
- <li><a href="./index.html"><span>Harness family matrix</span></a></li>
34
+ <li><a href="./index.html"><span>Module types</span></a></li>
31
35
  <li><a href="./byo-wasm-quickstart.html"><span>BYO-wasm quickstart</span></a></li>
32
36
  <li><a href="./conformance.html"><span>Conformance kit</span></a></li>
33
37
  <li><a href="./protect-and-sign.html"><span>Protect and sign</span></a></li>
@@ -370,6 +374,7 @@ npm run benchmark:module-stream-1gib</code></pre></div>
370
374
  <footer class="site-footer">
371
375
  Space Data Module SDK — Apache-2.0. Every ABI page renders a Markdown
372
376
  source in <code>docs/</code>; edit the Markdown, never the HTML.
377
+ Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
373
378
  </footer>
374
379
  </body>
375
380
  </html>
package/docs/gpu-module-abi.html CHANGED
@@ -2,10 +2,12 @@
2
2
  <html lang="en">
3
3
  <head>
4
4
  <meta charset="utf-8" />
5
+ <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
5
6
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
7
  <meta name="description" content="This document defines the SDK-level standard for modules that can use GPU" />
7
8
  <title>GPU module ABI — Space Data Module SDK</title>
8
9
  <link rel="stylesheet" href="./styles.css" />
10
+ <script src="./assembly.js" defer></script>
9
11
  <!-- SDN_CONSUMER_ASSETS_START -->
10
12
  <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">
11
13
  <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 @@
13
15
  <!-- SDN_CONSUMER_ASSETS_END -->
14
16
  </head>
15
17
  <body>
18
+ <canvas id="assembly" aria-hidden="true"></canvas>
16
19
  <a class="skip-link" href="#main">Skip to content</a>
17
20
  <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
18
21
  <header class="site-header">
@@ -22,12 +25,13 @@
22
25
  <a href="./conformance.html">Conformance</a>
23
26
  <a href="https://github.com/DigitalArsenal/space-data-module-sdk">GitHub</a>
24
27
  <a class="stack-button" href="#stack">Stack</a>
28
+ <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>
25
29
  </nav>
26
30
  </header>
27
31
  <div class="shell">
28
32
  <nav class="sidebar" id="sidebar" aria-label="Documentation">
29
33
  <h2>Start here</h2><ul>
30
- <li><a href="./index.html"><span>Harness family matrix</span></a></li>
34
+ <li><a href="./index.html"><span>Module types</span></a></li>
31
35
  <li><a href="./byo-wasm-quickstart.html"><span>BYO-wasm quickstart</span></a></li>
32
36
  <li><a href="./conformance.html"><span>Conformance kit</span></a></li>
33
37
  <li><a href="./protect-and-sign.html"><span>Protect and sign</span></a></li>
@@ -228,6 +232,7 @@ lo = f32(value - f64(hi))</code></pre></div>
228
232
  <footer class="site-footer">
229
233
  Space Data Module SDK — Apache-2.0. Every ABI page renders a Markdown
230
234
  source in <code>docs/</code>; edit the Markdown, never the HTML.
235
+ Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
231
236
  </footer>
232
237
  </body>
233
238
  </html>
package/docs/index.html CHANGED
@@ -2,17 +2,20 @@
2
2
  <html lang="en">
3
3
  <head>
4
4
  <meta charset="utf-8" />
5
+ <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
5
6
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
- <meta name="description" content="The nineteen harness families of the Space Data Module SDK — uniform WASM plugin contracts for every kind of scenario behavior." />
7
- <title>Harness family matrix — Space Data Module SDK</title>
7
+ <meta name="description" content="Build once, run on every node. The Space Data Module SDK packages space software as digitally signed WebAssembly modules that run in browsers, on servers and on every Space Data Network node." />
8
+ <title>Space Data Module SDK — Build once. Run on every node.</title>
8
9
  <link rel="stylesheet" href="./styles.css" />
10
+ <script src="./assembly.js" defer></script>
9
11
  <!-- SDN_CONSUMER_ASSETS_START -->
10
12
  <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">
11
13
  <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>
12
14
  <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>
13
15
  <!-- SDN_CONSUMER_ASSETS_END -->
14
16
  </head>
15
- <body>
17
+ <body data-assembly="scroll">
18
+ <canvas id="assembly" aria-hidden="true"></canvas>
16
19
  <a class="skip-link" href="#main">Skip to content</a>
17
20
  <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
18
21
  <header class="site-header">
@@ -22,17 +25,18 @@
22
25
  <a href="./conformance.html">Conformance</a>
23
26
  <a href="https://github.com/DigitalArsenal/space-data-module-sdk">GitHub</a>
24
27
  <a class="stack-button" href="#stack">Stack</a>
28
+ <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>
25
29
  </nav>
26
30
  </header>
27
31
  <main id="main">
28
32
  <section class="hero">
29
- <p class="eyebrow">Space Data Network</p>
30
- <h1>Harness families</h1>
33
+ <p class="eyebrow">Space Data Module SDK</p>
34
+ <h1>Build once. Run on every node.</h1>
31
35
  <p class="lede">
32
- One uniform WASM plugin contract per kind of scenario behavior. Point
33
- an LLM at your codebase and at this site, build a module, host it on
34
- the SDN, and any consumer loads it — with no modification to the
35
- rendering engine.
36
+ Package propagators, sensor models, data connectors and analytics as
37
+ digitally signed WebAssembly modules. The same file runs in a browser,
38
+ on a server and on every Space Data Network node, and any app loads it
39
+ without changes.
36
40
  </p>
37
41
  <div class="actions">
38
42
  <a class="button primary" href="./byo-wasm-quickstart.html">Build a module</a>
@@ -43,12 +47,14 @@
43
47
 
44
48
  <section class="section" aria-labelledby="families-title">
45
49
  <div class="section-head">
46
- <p class="eyebrow">The matrix</p>
47
- <h2 id="families-title">Nineteen families, one spine</h2>
50
+ <p class="eyebrow">Module types</p>
51
+ <h2 id="families-title">Nineteen module types, one interface each</h2>
48
52
  <p>
49
- Every family is documented against the same thirteen-section spine.
50
- Status is stated honestly: only families marked Shipped have a
51
- ratified generated header, a conformance kit, and a reference module.
53
+ Each kind of module, from a propagator to a sensor to a data
54
+ connector, has one standard interface. The specifications call these
55
+ harness families. Every one is documented against the same
56
+ thirteen-section outline, and only those marked Shipped have a
57
+ ratified generated header, a conformance kit and a reference module.
52
58
  </p>
53
59
  </div>
54
60
  <div class="family-group">
@@ -251,6 +257,7 @@
251
257
  <footer class="site-footer">
252
258
  Space Data Module SDK — Apache-2.0. Every ABI page renders a Markdown
253
259
  source in <code>docs/</code>; edit the Markdown, never the HTML.
260
+ Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
254
261
  </footer>
255
262
  </body>
256
263
  </html>
package/docs/isomorphic-pthreads.html CHANGED
@@ -2,10 +2,12 @@
2
2
  <html lang="en">
3
3
  <head>
4
4
  <meta charset="utf-8" />
5
+ <script>try{var t=localStorage.getItem("sdn-theme");if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t)}catch(e){}</script>
5
6
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
7
  <meta name="description" content="space-data-module-sdk is the enforced source of truth for isomorphic" />
7
8
  <title>Isomorphic pthreads — Space Data Module SDK</title>
8
9
  <link rel="stylesheet" href="./styles.css" />
10
+ <script src="./assembly.js" defer></script>
9
11
  <!-- SDN_CONSUMER_ASSETS_START -->
10
12
  <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">
11
13
  <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 @@
13
15
  <!-- SDN_CONSUMER_ASSETS_END -->
14
16
  </head>
15
17
  <body>
18
+ <canvas id="assembly" aria-hidden="true"></canvas>
16
19
  <a class="skip-link" href="#main">Skip to content</a>
17
20
  <sdn-stack-nav active="module-sdk"></sdn-stack-nav>
18
21
  <header class="site-header">
@@ -22,12 +25,13 @@
22
25
  <a href="./conformance.html">Conformance</a>
23
26
  <a href="https://github.com/DigitalArsenal/space-data-module-sdk">GitHub</a>
24
27
  <a class="stack-button" href="#stack">Stack</a>
28
+ <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>
25
29
  </nav>
26
30
  </header>
27
31
  <div class="shell">
28
32
  <nav class="sidebar" id="sidebar" aria-label="Documentation">
29
33
  <h2>Start here</h2><ul>
30
- <li><a href="./index.html"><span>Harness family matrix</span></a></li>
34
+ <li><a href="./index.html"><span>Module types</span></a></li>
31
35
  <li><a href="./byo-wasm-quickstart.html"><span>BYO-wasm quickstart</span></a></li>
32
36
  <li><a href="./conformance.html"><span>Conformance kit</span></a></li>
33
37
  <li><a href="./protect-and-sign.html"><span>Protect and sign</span></a></li>
@@ -130,8 +134,19 @@
130
134
  <p>The emitted <code>symbolPrefix</code> and the per-method <code>methodSymbols</code> map are recorded in the guest-link <strong>metadata</strong> (<code>sds.guest-link</code>). <strong>That metadata is the sole authoritative source consumers read at compose time</strong> — <code>generateFlowTables</code> in <code>src/flow/flowCompiler.js</code> declares and calls <code>dependency.guestLink.metadata.methodSymbols[methodId]</code> and never re-derives the prefix from the pluginId. This keeps already-committed artifacts compatible: an object that shipped with a legacy (e.g. truncated) prefix still composes, because its own metadata carries the exact symbol names its object bytes define.</p>
131
135
  <h2 id="3-compile-time-vs-runtime-an-honest-boundary"><a class="anchor" href="#3-compile-time-vs-runtime-an-honest-boundary" aria-hidden="true">#</a>3. Compile-Time vs. Runtime: an honest boundary</h2>
132
136
  <p>Passing this guardrail proves the <strong>artifact</strong> is a valid wasi-threads shared-memory/atomics wasm. It does <strong>not</strong> prove that a given WasmEdge build actually spawns and runs guest threads.</p>
133
- <blockquote><p><strong>Rule:</strong> 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.</p></blockquote>
137
+ <blockquote><p><strong>Rule:</strong> 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 must exercise the actual host and linked runtime used in deployment.</p></blockquote>
134
138
  <p>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.</p>
139
+ <h3 id="sdk-0820-command-hosts"><a class="anchor" href="#sdk-0820-command-hosts" aria-hidden="true">#</a>SDK 0.8.20 command hosts</h3>
140
+ <p>WasmEdge 0.16.4's CLI enables atomics with <code>--enable-threads</code> but does not provide <code>wasi.thread-spawn</code>. For artifacts importing that function, the SDK's native parity lane and <code>createStandaloneHarness(&quot;wasmedge&quot;, ...)</code> automatically build and cache the C API command runner from <code>src/testing/native/wasmedge_wasi_threads_runner.c</code>. The runner links against WasmEdge <strong>0.16.4</strong>, uses one executor and shared imported memory, and creates a fresh module instance for each <code>wasi_thread_start(tid, arg)</code>. 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.</p>
141
+ <p>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 <code>~/.wasmedge</code> SDK and CLI are unchanged.</p>
142
+ <p>Set both <code>WASMEDGE_INCLUDE_DIR</code> and <code>WASMEDGE_LIB_DIR</code> to supply an operator-built runtime with the same correction. An explicit <code>wasmEdgeRunnerBinary</code> selects a prebuilt command runner. The builder is <code>buildWasmEdgeWasiThreadsRunner</code> in <code>src/testing/buildWasmEdgeRunner.js</code>. The Docker parity image builds the same corrected runtime and runner for threaded artifacts; modules without <code>wasi.thread-spawn</code> keep the ordinary CLI path. The Docker runner image includes a source digest in its tag to avoid stale runner reuse.</p>
143
+ <p>Direct-only threaded reactors have no <code>_start</code>. For those artifacts the runner calls <code>_initialize</code>, stages the raw request through <code>plugin_alloc</code>, and invokes <code>plugin_invoke_stream</code>. 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.</p>
144
+ <p>The browser command harness runs <code>_start</code> 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 <code>pthread_join</code> outside the browser's main thread. Parity reports include <code>spawnCount</code>; requested thread counts alone are not evidence of actual spawning.</p>
145
+ <p>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:</p>
146
+ <div class="codeblock"><div class="codeblock-head">sh</div><pre><code>SPACE_DATA_MODULE_SDK_ENABLE_WASMEDGE_PARITY=1 \
147
+ SPACE_DATA_MODULE_SDK_ENABLE_TRI_RUNTIME_PARITY=1 \
148
+ node --test test/wasi-threads-command.test.js</code></pre></div>
149
+ <p>The old source path <code>src/testing/browserModuleHarness.js</code> remains a pure compatibility re-export. New browser consumers should use the public <code>space-data-module-sdk/host/browser-module</code> entry point.</p>
135
150
  <h2 id="4-integrators-the-browser-worker-anchor-required-when-you-bundle"><a class="anchor" href="#4-integrators-the-browser-worker-anchor-required-when-you-bundle" aria-hidden="true">#</a>4. Integrators: the browser worker anchor (REQUIRED when you bundle)</h2>
136
151
  <p>The browser leg of the wasi-threads host runs each guest pthread on a pooled module <code>Worker</code>. That worker is a <strong>served asset</strong>, and the SDK cannot guess where your build published it.</p>
137
152
  <p>By default the host anchors the worker to its own package layout:</p>
@@ -188,6 +203,7 @@ setBrowserWasiThreadWorkerBase(&quot;js/vendor/space-data-module-sdk/src/host/&q
188
203
  <li><a class="depth-2" href="#2-validated-artifact-the-part-that-matters-most">2. Validated Artifact (the part that matters most)</a></li>
189
204
  <li><a class="depth-2" href="#guest-link-symbol-namespacing-collision-proof-metadata-authoritative">Guest-link symbol namespacing (collision-proof, metadata-authoritative)</a></li>
190
205
  <li><a class="depth-2" href="#3-compile-time-vs-runtime-an-honest-boundary">3. Compile-Time vs. Runtime: an honest boundary</a></li>
206
+ <li><a class="depth-3" href="#sdk-0820-command-hosts">SDK 0.8.20 command hosts</a></li>
191
207
  <li><a class="depth-2" href="#4-integrators-the-browser-worker-anchor-required-when-you-bundle">4. Integrators: the browser worker anchor (REQUIRED when you bundle)</a></li>
192
208
  <li><a class="depth-2" href="#tests">Tests</a></li>
193
209
  <li><a class="depth-2" href="#see-also">See also</a></li></ul></nav>
@@ -223,6 +239,7 @@ setBrowserWasiThreadWorkerBase(&quot;js/vendor/space-data-module-sdk/src/host/&q
223
239
  <footer class="site-footer">
224
240
  Space Data Module SDK — Apache-2.0. Every ABI page renders a Markdown
225
241
  source in <code>docs/</code>; edit the Markdown, never the HTML.
242
+ Contact <a href="mailto:tj@edgesource.com">tj@edgesource.com</a>.
226
243
  </footer>
227
244
  </body>
228
245
  </html>