chore(booter): complete P2P/POSIX roadmap — ctx 1.48, VFS, shell, docs

- Bump bareOsCtxApiVersion to 1.48.0; sync CHANGELOG, compatibility matrix, syscalls.example.json, ctx d.ts, generated ctx-client helper - POSIX: getconf _SC_NPROCESSORS_ONLN; shell set -o pipefail + BARE_OS_PIPESTATUS; posix_utilities schema v2 + JSON Schema; generated dashboard refresh - Host/subprocess: bare-subprocess then Node child_process spawn; optional backend on ctx.bareOsTrySpawnHostSubprocess; bin-worker WASM wall budget - VFS: BARE_OS_VFS_SYSTEM_IMAGE_WRITE for system image writes + warm-cache eviction path; guest /.bare/account EACCES test; environ TOKEN redaction test - Docs: corestore snapshot non-goal in package-bare-os-booter; PEAR-RUN links → docs/PEAR-RUN.md; POSIX pretest matrix in scripts/README + dev guide; environment appendix (PIPESTATUS, WASM_MS, system image write) - Seeder: keep kernel/ mirror in sync after bundle + coreutils builds Verified: npm test -w bare-os-booter, npm run pretest
2026-04-05 12:52:06 -04:00
parent c4781e02c0
commit e89c55da25
69 changed files with 2909 additions and 596 deletions
@@ -40,7 +40,7 @@ At boot the booter runs **drive bundles first**, then (unless **`BARE_OS_BARE_HO
 The authoritative list is in the [environment appendix](../../../docs/reference/environment-and-posix-appendix.md). Names that operators mention most often alongside **`/lib/bare`**:

 - **`BARE_OS_BARE_HOST_IMPORTS`** — Set to **`0`** / **`false`** to forbid host **`import()`** fallback (drive-only resolution).
- Related Pear **`ctx.bare`** toggles and HTTP allow lists are documented in **[PEAR-RUN.md](../../../PEAR-RUN.md)** and the booter package reference.
+- Related Pear **`ctx.bare`** toggles and HTTP allow lists are documented in **[PEAR-RUN.md](../../../docs/PEAR-RUN.md)** and the booter package reference.

 ---

@@ -1,12 +1,6 @@
 {
  "version": 1,
  "bundles": [
-    {
-      "path": "/lib/bare/bundles/safetyCatch.js",
-      "keys": [
-        "safetyCatch"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/b4a.js",
      "keys": [
@@ -14,15 +8,15 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/hypercoreIdEncoding.js",
+      "path": "/lib/bare/bundles/safetyCatch.js",
      "keys": [
-        "hypercoreIdEncoding"
+        "safetyCatch"
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareUrl.js",
+      "path": "/lib/bare/bundles/hypercoreIdEncoding.js",
      "keys": [
-        "bareUrl"
+        "hypercoreIdEncoding"
      ]
    },
    {
@@ -44,9 +38,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareEncoding.js",
+      "path": "/lib/bare/bundles/bareUrl.js",
      "keys": [
-        "bareEncoding"
+        "bareUrl"
      ]
    },
    {
@@ -56,15 +50,15 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareAbort.js",
+      "path": "/lib/bare/bundles/bareEncoding.js",
      "keys": [
-        "bareAbort"
+        "bareEncoding"
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareReadline.js",
+      "path": "/lib/bare/bundles/bareAbort.js",
      "keys": [
-        "bareReadline"
+        "bareAbort"
      ]
    },
    {
@@ -80,9 +74,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareAddonResolve.js",
+      "path": "/lib/bare/bundles/bareReadline.js",
      "keys": [
-        "bareAddonResolve"
+        "bareReadline"
      ]
    },
    {
@@ -92,21 +86,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/fetch.js",
+      "path": "/lib/bare/bundles/bareAddonResolve.js",
      "keys": [
-        "fetch"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareAsyncHooks.js",
-      "keys": [
-        "bareAsyncHooks"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareAtomics.js",
-      "keys": [
-        "bareAtomics"
+        "bareAddonResolve"
      ]
    },
    {
@@ -121,12 +103,24 @@
        "bareApk"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareAsyncHooks.js",
+      "keys": [
+        "bareAsyncHooks"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareAssert.js",
      "keys": [
        "bareAssert"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareAtomics.js",
+      "keys": [
+        "bareAtomics"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareBmp.js",
      "keys": [
@@ -134,21 +128,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareBundleCompile.js",
+      "path": "/lib/bare/bundles/fetch.js",
      "keys": [
-        "bareBundleCompile"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareBundle.js",
-      "keys": [
-        "bareBundle"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareBluetoothApple.js",
-      "keys": [
-        "bareBluetoothApple"
+        "fetch"
      ]
    },
    {
@@ -158,15 +140,27 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareBundleEvaluate.js",
+      "path": "/lib/bare/bundles/bareBundleCompile.js",
      "keys": [
-        "bareBundleEvaluate"
+        "bareBundleCompile"
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareBoot.js",
+      "path": "/lib/bare/bundles/bareBluetoothApple.js",
      "keys": [
-        "bareBoot"
+        "bareBluetoothApple"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareBundle.js",
+      "keys": [
+        "bareBundle"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareBundleEvaluate.js",
+      "keys": [
+        "bareBundleEvaluate"
      ]
    },
    {
@@ -176,9 +170,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareDebugLog.js",
+      "path": "/lib/bare/bundles/bareBoot.js",
      "keys": [
-        "bareDebugLog"
+        "bareBoot"
      ]
    },
    {
@@ -187,12 +181,6 @@
        "bareBundleId"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/bareDaemon.js",
-      "keys": [
-        "bareDaemon"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/bareChannel.js",
      "keys": [
@@ -205,6 +193,18 @@
        "bareDelta"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareDebugLog.js",
+      "keys": [
+        "bareDebugLog"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareDaemon.js",
+      "keys": [
+        "bareDaemon"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareDns.js",
      "keys": [
@@ -217,18 +217,18 @@
        "bareDiagnosticsChannel"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/bareEnv.js",
-      "keys": [
-        "bareEnv"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/bareCov.js",
      "keys": [
        "bareCov"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareEnv.js",
+      "keys": [
+        "bareEnv"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareExif.js",
      "keys": [
@@ -259,12 +259,6 @@
        "bareFormat"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/bareFormData.js",
-      "keys": [
-        "bareFormData"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/bareGif.js",
      "keys": [
@@ -272,21 +266,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareHrtime.js",
+      "path": "/lib/bare/bundles/bareFormData.js",
      "keys": [
-        "bareHrtime"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareGtk.js",
-      "keys": [
-        "bareGtk"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareHeif.js",
-      "keys": [
-        "bareHeif"
+        "bareFormData"
      ]
    },
    {
@@ -296,15 +278,27 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareHttpParser.js",
+      "path": "/lib/bare/bundles/bareHeif.js",
      "keys": [
-        "bareHttpParser"
+        "bareHeif"
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareIco.js",
+      "path": "/lib/bare/bundles/bareGtk.js",
      "keys": [
-        "bareIco"
+        "bareGtk"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareHrtime.js",
+      "keys": [
+        "bareHrtime"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareHttpParser.js",
+      "keys": [
+        "bareHttpParser"
      ]
    },
    {
@@ -314,15 +308,15 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareImageResample.js",
+      "path": "/lib/bare/bundles/bareIco.js",
      "keys": [
-        "bareImageResample"
+        "bareIco"
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareHttp1.js",
+      "path": "/lib/bare/bundles/bareImageResample.js",
      "keys": [
-        "bareHttp1"
+        "bareImageResample"
      ]
    },
    {
@@ -337,6 +331,12 @@
        "bareHttps"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareHttp1.js",
+      "keys": [
+        "bareHttp1"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareJpeg.js",
      "keys": [
@@ -349,6 +349,12 @@
        "bareIpc"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareIntl.js",
+      "keys": [
+        "bareIntl"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareLief.js",
      "keys": [
@@ -356,9 +362,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareIntl.js",
+      "path": "/lib/bare/bundles/bareInspector.js",
      "keys": [
-        "bareIntl"
+        "bareInspector"
      ]
    },
    {
@@ -373,48 +379,48 @@
        "bareLink"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/bareInspector.js",
-      "keys": [
-        "bareInspector"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/bareMake.js",
      "keys": [
        "bareMake"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/bareModuleLexer.js",
-      "keys": [
-        "bareModuleLexer"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareModule.js",
-      "keys": [
-        "bareModule"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/bareModuleResolve.js",
      "keys": [
        "bareModuleResolve"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareModuleLexer.js",
+      "keys": [
+        "bareModuleLexer"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareNdk.js",
      "keys": [
        "bareNdk"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareModule.js",
+      "keys": [
+        "bareModule"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareNative.js",
      "keys": [
        "bareNative"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareMedia.js",
+      "keys": [
+        "bareMedia"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareModuleTraverse.js",
      "keys": [
@@ -422,9 +428,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareNodeFetch.js",
+      "path": "/lib/bare/bundles/bareOs.js",
      "keys": [
-        "bareNodeFetch"
+        "bareOs"
      ]
    },
    {
@@ -440,15 +446,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareOs.js",
+      "path": "/lib/bare/bundles/bareNodeFetch.js",
      "keys": [
-        "bareOs"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareMedia.js",
-      "keys": [
-        "bareMedia"
+        "bareNodeFetch"
      ]
    },
    {
@@ -457,6 +457,12 @@
        "barePerformance"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/barePng.js",
+      "keys": [
+        "barePng"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/barePackDrive.js",
      "keys": [
@@ -469,12 +475,6 @@
        "barePack"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/bareDev.js",
-      "keys": [
-        "bareDev"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/barePipe.js",
      "keys": [
@@ -482,9 +482,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/barePng.js",
+      "path": "/lib/bare/bundles/barePrebuild.js",
      "keys": [
-        "barePng"
+        "barePrebuild"
      ]
    },
    {
@@ -505,24 +505,12 @@
        "bareQuerystring"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/barePrebuild.js",
-      "keys": [
-        "barePrebuild"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/bareQueueMicrotask.js",
      "keys": [
        "bareQueueMicrotask"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/bareRealm.js",
-      "keys": [
-        "bareRealm"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/bareProcess.js",
      "keys": [
@@ -530,21 +518,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareRuntime.js",
+      "path": "/lib/bare/bundles/bareDev.js",
      "keys": [
-        "bareRuntime"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareSdl.js",
-      "keys": [
-        "bareSdl"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareRpc.js",
-      "keys": [
-        "bareRpc"
+        "bareDev"
      ]
    },
    {
@@ -554,9 +530,15 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareSemver.js",
+      "path": "/lib/bare/bundles/bareRealm.js",
      "keys": [
-        "bareSemver"
+        "bareRealm"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareRuntime.js",
+      "keys": [
+        "bareRuntime"
      ]
    },
    {
@@ -566,9 +548,15 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareRun.js",
+      "path": "/lib/bare/bundles/bareSemver.js",
      "keys": [
-        "bareRun"
+        "bareSemver"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareSdl.js",
+      "keys": [
+        "bareSdl"
      ]
    },
    {
@@ -584,9 +572,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareStringDecoder.js",
+      "path": "/lib/bare/bundles/bareRpc.js",
      "keys": [
-        "bareStringDecoder"
+        "bareRpc"
      ]
    },
    {
@@ -595,18 +583,30 @@
        "bareStorage"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/bareStream.js",
-      "keys": [
-        "bareStream"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/bareStdio.js",
      "keys": [
        "bareStdio"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareRun.js",
+      "keys": [
+        "bareRun"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareStringDecoder.js",
+      "keys": [
+        "bareStringDecoder"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareStream.js",
+      "keys": [
+        "bareStream"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareSvg.js",
      "keys": [
@@ -614,9 +614,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareTap.js",
+      "path": "/lib/bare/bundles/bareStructuredClone.js",
      "keys": [
-        "bareTap"
+        "bareStructuredClone"
      ]
    },
    {
@@ -626,9 +626,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareStructuredClone.js",
+      "path": "/lib/bare/bundles/bareTap.js",
      "keys": [
-        "bareStructuredClone"
+        "bareTap"
      ]
    },
    {
@@ -643,6 +643,12 @@
        "bareTiff"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareTimers.js",
+      "keys": [
+        "bareTimers"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareTcp.js",
      "keys": [
@@ -661,12 +667,6 @@
        "bareTpl"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/bareTimers.js",
-      "keys": [
-        "bareTimers"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/bareType.js",
      "keys": [
@@ -691,12 +691,6 @@
        "bareTty"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/bareUnpack.js",
-      "keys": [
-        "bareUnpack"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/bareV8.js",
      "keys": [
@@ -704,21 +698,9 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareWalkHandles.js",
+      "path": "/lib/bare/bundles/bareUnpack.js",
      "keys": [
-        "bareWalkHandles"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareVm.js",
-      "keys": [
-        "bareVm"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareWebKit.js",
-      "keys": [
-        "bareWebKit"
+        "bareUnpack"
      ]
    },
    {
@@ -727,30 +709,30 @@
        "bareUnionBundle"
      ]
    },
+    {
+      "path": "/lib/bare/bundles/bareVm.js",
+      "keys": [
+        "bareVm"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareWalkHandles.js",
+      "keys": [
+        "bareWalkHandles"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareWebKit.js",
+      "keys": [
+        "bareWebKit"
+      ]
+    },
    {
      "path": "/lib/bare/bundles/bareWebp.js",
      "keys": [
        "bareWebp"
      ]
    },
-    {
-      "path": "/lib/bare/bundles/bareV8ToIstanbul.js",
-      "keys": [
-        "bareV8ToIstanbul"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareWebKitGtk.js",
-      "keys": [
-        "bareWebKitGtk"
-      ]
-    },
-    {
-      "path": "/lib/bare/bundles/bareUtils.js",
-      "keys": [
-        "bareUtils"
-      ]
-    },
    {
      "path": "/lib/bare/bundles/bareWhich.js",
      "keys": [
@@ -758,9 +740,21 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareXdiff.js",
+      "path": "/lib/bare/bundles/bareWebKitGtk.js",
      "keys": [
-        "bareXdiff"
+        "bareWebKitGtk"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareV8ToIstanbul.js",
+      "keys": [
+        "bareV8ToIstanbul"
+      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareUtils.js",
+      "keys": [
+        "bareUtils"
      ]
    },
    {
@@ -770,15 +764,15 @@
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareZlib.js",
+      "path": "/lib/bare/bundles/bareXdiff.js",
      "keys": [
-        "bareZlib"
+        "bareXdiff"
      ]
    },
    {
-      "path": "/lib/bare/bundles/bareWorker.js",
+      "path": "/lib/bare/bundles/bareZlib.js",
      "keys": [
-        "bareWorker"
+        "bareZlib"
      ]
    },
    {
@@ -792,6 +786,12 @@
      "keys": [
        "bareWs"
      ]
+    },
+    {
+      "path": "/lib/bare/bundles/bareWorker.js",
+      "keys": [
+        "bareWorker"
+      ]
    }
  ],
  "bundleStats": {
@@ -1595,8 +1595,8 @@
  ],
  "bundleProvenance": {
    "schemaVersion": 1,
-    "generatedAt": "2026-04-05T08:36:49.836Z",
-    "gitCommit": "904ad7e7fd453ed4a8daaa3f949dfe4af8df5d91",
+    "generatedAt": "2026-04-05T16:50:02.874Z",
+    "gitCommit": "c4781e02c0730f182d3eccdbd7f49ae7e10dbe53",
    "nodeVersion": "v22.22.0",
    "bundleTier": "all",
    "normativeManifest": "packages/bare-os-booter/lib/bare-module-manifest.json",
@@ -1,6 +1,6 @@
 {
  "schema": 1,
-  "atMs": 1775378209185,
+  "atMs": 1775407801982,
  "commands": [
    "arch",
    "awk",