@nimbus-sh/worker 0.1.2 → 0.1.3

package/dist/vfs/sqlite-vfs.js

@@ -96,11 +96,11 @@ export class SqliteVFS {
      * (deferWrite/clearPendingWritesForPath/flushPendingWrites/
      * cleanupAfterDelete). Read by getStats() so /api/_diag/memory's
      * `heap.breakdown.vfsInFlightBytes` is no longer a hardcoded 0.
-     * (N3, heap-correctness wave.)
+     * (N3, memory accounting cleanup.)
      */
     _pendingWriteBytes = 0;
     /**
-     * N2 (heap-correctness wave). Sum of bytes currently held in the
+     * N2 (memory accounting cleanup). Sum of bytes currently held in the
      * `chunks: []` spool inside writeStream(). Maintained per-chunk so
      * a long-running drain shows live, not the steady-state 0.
      * Reset (or decremented to the drained amount) inside writeStream's
@@ -481,7 +481,7 @@ export class SqliteVFS {
     // ── Deferred batch writes (do86 pattern) ──────────────────────────────
     deferWrite(path, chunkId, data) {
         const key = this.cacheKey(path, chunkId);
-        // SINGLE-OWNERSHIP BOUNDARY (H10 audit, heap-correctness wave).
+        // SINGLE-OWNERSHIP BOUNDARY (H10 audit, memory accounting cleanup).
         //
         // `data` is one of:
         //   - a `subarray` view into the caller's source ArrayBuffer
@@ -497,7 +497,7 @@ export class SqliteVFS {
         // (slice + this) per chunk.
         //
         // _pendingWriteBytes counter is the source-of-truth for N3
-        // (heap-correctness wave): the `vfsInFlightBytes` heap-estimator
+        // (memory accounting cleanup): the `vfsInFlightBytes` heap-estimator
         // contributor reads from it.
         const copy = new Uint8Array(data.length);
         copy.set(data);
@@ -854,7 +854,7 @@ export class SqliteVFS {
         // The deferred write handles persistence; cache entry stays clean
         // to avoid double-writing when the entry is eventually evicted.
         //
-        // H10 (heap-correctness wave) — `data.slice(...)` here used to
+        // H10 (memory accounting cleanup) — `data.slice(...)` here used to
         // allocate a brand-new chunk-sized ArrayBuffer per chunk. Combined
         // with `deferWrite`'s defensive copy at the persistence boundary
         // (sqlite-vfs.ts:_deferWriteCopyForOwnership), the loop transient
@@ -1050,7 +1050,7 @@ export class SqliteVFS {
         const inode = this.inodes.get(oldPath);
         if (!inode)
             throw new Error("ENOENT: " + oldPath);
-        // W-3 (WASI Wave-2): if newPath already exists, unlink it first so the
+        // W-3 (WASI filesystem WASI): if newPath already exists, unlink it first so the
         // SQL UPDATE doesn't conflict on inodes.path uniqueness. POSIX rename(2)
         // overwrites the destination atomically; clang's atomic-write pattern
         // (write tmp + rename → final) depends on this. Without this branch,
@@ -1171,7 +1171,7 @@ export class SqliteVFS {
      * heap estimator. We now maintain `_writeStreamSpoolBytes` that
      * tracks the live spool contents during the drain; the diag's
      * vfsInFlightBytes contributor now sums pendingWriteBytes +
-     * writeStreamSpoolBytes. The N2 RED probe asserts on this sum.
+     * writeStreamSpoolBytes. The N2 failing probe asserts on this sum.
      *
      * Throws on SQLITE_NOMEM (with halve-retry per writeBatch); any
      * iterator-source error propagates unchanged. Atomicity guarantee
@@ -1183,7 +1183,7 @@ export class SqliteVFS {
         // We build the chunks array fully BEFORE entering transactionSync
         // because transactionSync is synchronous (cannot await mid-txn).
         //
-        // N2 (heap-correctness wave): track spool bytes so the diag
+        // N2 (memory accounting cleanup): track spool bytes so the diag
         // estimator's vfsInFlightBytes is no longer a 0 lie. Increment
         // per chunk pushed; reset to 0 immediately before delegating to
         // writeBatch (the bytes are now `pendingWrites' problem if they
@@ -1427,7 +1427,6 @@ export class SqliteVFS {
         //    B3: also maintain running counters in sync. For each payload entry,
         //    compute the delta against any pre-existing inode at that path.
         //
-        // W2.5a (audit/sections/W2.5-plan.md): the children-index call is now
         // OUTSIDE the `prior === undefined` guard. Pre-W2.5a, ~37 of 46 packages
         // per `npm install fastify` accumulated inodes in SQL but never reached
         // the in-memory `this.children` index because some path's `prior` was
@@ -1608,14 +1607,14 @@ export class SqliteVFS {
                 batchWrites: this._batchWrites,
                 batchWriteRows: this._batchWriteRows,
                 pendingWrites: this.pendingWrites.size,
-                // N3 (heap-correctness wave): real byte sum of the
+                // N3 (memory accounting cleanup): real byte sum of the
                 // pendingWrites Map. Source-of-truth for the heap-estimator's
                 // vfsInFlightBytes contributor (was hardcoded 0 at routes.ts:347
                 // pre-fix). Adding this AS WELL AS the entry count above so
                 // ops dashboards that already plot the count don't break, while
                 // memory triage gets the actual byte number.
                 pendingWriteBytes: this._pendingWriteBytes,
-                // N2 (heap-correctness wave): live byte count inside the
+                // N2 (memory accounting cleanup): live byte count inside the
                 // writeStream() drain spool. Non-zero only during the brief
                 // window between the first chunk arriving and writeBatch
                 // returning — bounded by SHARED_RPC_FLUSH_THRESHOLD (4 MiB)

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "@nimbus-sh/worker",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Nimbus runtime package for Cloudflare Workers, re-exported publicly through @nimbus-sh/sdk/worker.",
+  "keywords": [
+    "cloudflare",
+    "workers",
+    "durable-objects",
+    "webassembly",
+    "sandbox",
+    "runtime"
+  ],
   "homepage": "https://github.com/AshishKumar4/Nimbus",
   "repository": {
     "type": "git",
@@ -38,7 +46,9 @@
     "dist",
     "public",
     "scripts",
-    "README.md"
+    "README.md",
+    "LICENSE",
+    "NOTICE.md"
   ],
   "scripts": {
     "bundle:git": "node scripts/bundle-git.mjs",

package/public/s/index.html

@@ -84,7 +84,7 @@
     /* Resize handle */
     .resize-handle { width: 4px; background: #30363d; cursor: col-resize; flex-shrink: 0; }
     .resize-handle:hover { background: #58a6ff; }
-    /* monaco-polish (2026-05-14): vertical resize handle for editor (top) ↔
+    /* Vertical resize handle for editor (top) ↔
        terminal (bottom) inside the editor-stack column. Hidden outside
        editor mode (rule under .main.editor below). */
     .vresize-handle {
@@ -119,12 +119,8 @@
     .main.preview-only .resize-handle { display: none; }
     .main.preview-only .panel-preview { flex: 1; }
 
-    /* monaco-wave-a + Wave-B (2026-05-13/14):
-       Editor layout mode — 4-pane VSCode-style:
+    /* Editor layout mode:
          FILE TREE | editor-stack (editor TOP + terminal BOTTOM) | PREVIEW
-       Single mode: 'editor'. Dropped earlier 'editor-split' (editor+preview
-       without terminal) per user feedback "I don't need 'edit + preview'
-       at all". Renamed 'editor-split-with-term' → 'editor' for clarity.
 
        Editor + terminal live INSIDE .panel-left-stack. In 1D modes
        (terminal-only / split / preview-only) the stack is
@@ -144,7 +140,7 @@
        modes (transparent). flex column in editor mode. */
     .panel-left-stack { display: contents; }
 
-    /* monaco-wave-b: File-tree sidebar. Lives as a FIRST child of
+    /* File-tree sidebar. Lives as a FIRST child of
        .main; visible only in 'editor' mode. ~250px default width,
        resizable via .tree-resize-handle. */
     .panel-tree {
@@ -232,7 +228,7 @@
       font-size: 11px; text-align: center;
     }
 
-    /* Editor layout (single mode, monaco-wave-b): file tree | editor-stack | preview */
+    /* Editor layout: file tree | editor-stack | preview */
     .main.editor .panel-tree { display: flex; }
     .main.editor .tree-resize-handle { display: block; }
     .main.editor .panel-left-stack {
@@ -298,9 +294,8 @@
     <button id="btnTerminal" class="active" title="Terminal">Terminal</button>
     <button id="btnPreview" title="Preview">Preview</button>
     <button id="btnSplit" title="Split view">Split</button>
-    <!-- monaco-wave-b (2026-05-14): single canonical Editor mode.
-         Drops Edit+Preview (per user "I don't need edit+preview at all").
-         Layout: file tree | editor (top) + terminal (bottom) | preview.
+    <!-- Single canonical editor mode:
+         file tree | editor (top) + terminal (bottom) | preview.
          Lazy-loads Monaco + the tree on first click. -->
     <button id="btnEditor" title="Editor (file tree + Monaco + terminal + preview)">Editor</button>
     <div class="sep"></div>
@@ -313,7 +308,7 @@
     <span class="vite-status" id="viteStatus"></span>
   </div>
   <div class="main" id="mainPanel">
-    <!-- monaco-wave-b (2026-05-14): file-tree sidebar. Visible ONLY
+    <!-- File-tree sidebar. Visible ONLY
          in editor mode (CSS toggles display:flex on .main.editor).
          The .tree-resize-handle sits between tree and editor stack;
          dragging it adjusts .panel-tree's width inline. -->
@@ -330,12 +325,11 @@
       <div class="tree-body" id="treeBody"></div>
     </div>
     <div class="tree-resize-handle" id="treeResizeHandle"></div>
-    <!-- monaco-wave-a (2026-05-13, hotfix course-correct):
-         The .panel-left-stack wrapper is display:contents in 1D modes
+    <!-- The .panel-left-stack wrapper is display:contents in 1D modes
          (terminal-only, split, preview-only) — its children act as
-         direct flex children of .main. In editor mode (monaco-wave-b),
-         CSS flips it to display:flex; flex-direction:column so editor
-         and terminal stack vertically in the MIDDLE column. -->
+         direct flex children of .main. In editor mode, CSS flips it to
+         display:flex so editor and terminal stack vertically in the middle
+         column. -->
     <div class="panel-left-stack" id="leftStack">
       <div class="panel-editor" id="editorPanel">
         <div class="editor-bar">
@@ -358,7 +352,7 @@
           <span id="editorStatusEnc">UTF-8</span>
         </div>
       </div>
-      <!-- monaco-polish (2026-05-14): vertical resize handle between
+      <!-- Vertical resize handle between
            editor (top) and terminal (bottom) inside the editor-stack
            column. Visible only in editor mode (.main.editor). -->
       <div class="vresize-handle" id="editorTerminalResizeHandle"></div>
@@ -380,9 +374,8 @@
       <iframe id="preview-frame" src="about:blank"></iframe>
     </div>
   </div>
-  <!-- monaco-wave-a (2026-05-13): Ctrl+P command palette. Lazy-populated
-       fuzzy file finder; fs-list message sent on first open per
-       editor session. -->
+  <!-- Ctrl+P command palette. Lazy-populated fuzzy file finder; fs-list
+       is sent on first open per editor session. -->
   <div class="palette-overlay" id="paletteOverlay">
     <div class="palette-box">
       <input class="palette-input" id="paletteInput" placeholder="Type a file name…" autocomplete="off" spellcheck="false">
@@ -485,11 +478,8 @@
     const mainPanel = document.getElementById('mainPanel');
     const viteStatus = document.getElementById('viteStatus');
     let ws = null, rd = 1000, statsTimer = null;
-    // monaco-wave-b (2026-05-14): single 'editor' mode replaces the
-    // Wave-A duo of 'editor-split' (dropped per user feedback) and
-    // 'editor-split-with-term' (renamed → 'editor'). Layout:
-    //   file tree | editor (top) + terminal (bottom) | preview
-    // Old modes preserved verbatim: 'split', 'terminal-only', 'preview-only'.
+    // Current layout modes. Editor mode keeps the file tree, Monaco,
+    // terminal, and preview visible together.
     let layout = 'split';
 
     // ── Layout controls ──
@@ -511,7 +501,7 @@
         FileTree.ensureLoaded();
       }
       setTimeout(() => {
-        // monaco-polish: re-apply persisted pane dims for this layout.
+        // Re-apply persisted pane dims for this layout.
         // PaneResizer uses inline flex which is mode-specific (split vs
         // editor have different pane structures); onLayoutChange picks
         // the right elements for the active mode.
@@ -532,7 +522,7 @@
     document.getElementById('btnRefresh').onclick = () => reloadPreview();
     document.getElementById('btnReloadPreview').onclick = () => reloadPreview();
 
-    // ── monaco-wave-a (2026-05-13): Editor module ──
+    // ── Editor module ──
     //
     // Lazy-loads Monaco via cdnjs UMD on first call to ensureLoaded().
     // Cold session (terminal-only flow) never pays the ~5MB download.
@@ -541,9 +531,7 @@
     // All fs operations route through the live WS via fs-read /
     // fs-write / fs-list messages → init.ts handler → SqliteVFS.
     //
-    // Perf-invariant: probes assert monaco-* scripts NOT loaded on a
-    // cold terminal-only session (see tests/behavioral/monaco-wave-a/
-    // new/monaco-lazy-not-on-cold.mjs).
+    // Perf-invariant: Monaco is not loaded on cold terminal-only sessions.
     const Editor = (function() {
       // CDN choice: cdnjs hosts Monaco's UMD AMD-loader (`loader.min.js`)
       // which fetches the remaining vs/* chunks on demand. Total cold
@@ -589,11 +577,8 @@
       // Send a fs-* message; await the paired result. Resolves with the
       // result frame; rejects on error or timeout (15s — generous for
       // big trees, tight enough that a hung session surfaces fast).
-      // file-tree-fix (2026-05-14): outbound queue for fs-* frames
-      // sent before ws.onopen fires. User repro: "fs-list failed:
-      // WS not connected" when clicking Editor before terminal prompt.
-      //
-      // Race window: connect() runs at page-load and ws is in CONNECTING
+      // Queue fs-* frames sent before ws.onopen fires. Race window:
+      // connect() runs at page-load and ws is in CONNECTING
       // state (readyState === 0). If the user clicks Editor BEFORE
       // ws.onopen fires, setLayout('editor') invokes Editor.ensureLoaded
       // → eventually fsRequest, which pre-fix rejected synchronously.
@@ -722,10 +707,7 @@
         const ph = document.getElementById('editorPlaceholder');
         if (ph) ph.style.display = 'none';
 
-        // monaco-wave-a hotfix (2026-05-13): full VSCode-like options
-        // (per user feedback "current is useless — make it proper, nice").
-        // This config mirrors VSCode 1.95+ defaults for a TS/JS file.
-        // Verified against actual VSCode source (monaco.IEditorOptions).
+        // VS Code-like editor defaults for TS/JS files.
         editor = window.monaco.editor.create(container, {
           value: '',
           language: 'plaintext',
@@ -843,9 +825,8 @@
 
       async function openFile(path) {
         if (!path) return;
-        // monaco-wave-b: dirty-prompt before switching files. If the
-        // current buffer has unsaved changes, ask the user whether
-        // to (a) save first, (b) discard and switch, or (c) cancel.
+        // Dirty-prompt before switching files. If the current buffer has
+        // unsaved changes, ask the user whether to save or discard.
         // Skip when switching to the SAME file (no-op) or when there
         // is no editor yet.
         if (editor && openPath && openPath !== path) {
@@ -895,8 +876,7 @@
         if (statusLang) statusLang.textContent = lang;
         const statusPos = document.getElementById('editorStatusPos');
         if (statusPos) statusPos.textContent = 'Ln 1, Col 1';
-        // monaco-wave-b: mirror selection into the file tree (so
-        // palette/Ctrl+P opens highlight the row).
+        // Mirror palette/Ctrl+P selection into the file tree.
         if (typeof FileTree !== 'undefined') {
           try { FileTree.setSelected(path); FileTree.markDirty(path, false); } catch {}
         }
@@ -1038,8 +1018,7 @@
         }
       });
 
-      // file-tree-watch (2026-05-15): external invalidation of the
-      // Cmd+P 5s-TTL palette cache. Called by the fs-watch-event
+      // External invalidation of the Cmd+P 5s-TTL palette cache. Called by the fs-watch-event
       // dispatcher in ws.onmessage so a terminal-side write makes
       // the next openPalette re-run fs-list instead of serving
       // stale results.
@@ -1051,7 +1030,7 @@
       return { ensureLoaded, openFile, save, openPalette, tryHandleFsResult, drainFsQueue, invalidateFileListCache };
     })();
 
-    // ── monaco-wave-b (2026-05-14): FileTree module ──
+    // ── FileTree module ──
     //
     // VSCode-style left sidebar showing the user VFS (rooted at
     // /home/user). Lazy-loads on first editor-mode activation. Tree
@@ -1109,8 +1088,8 @@
       const expanded = loadExpandedSet();
       expanded.add(ROOT);
 
-      // file-tree-fix (2026-05-14): outbound queue mirroring Editor's
-      // pattern. See Editor.fsRequest for the race rationale.
+      // Outbound queue mirrors Editor.fsRequest for the same websocket
+      // connection race.
       const outQueue = [];
       function fsRequest(frame, resultType) {
         const reqId = nextReqId++;
@@ -1426,10 +1405,8 @@
       btnRefresh.addEventListener('click', refreshTree);
       searchInput.addEventListener('input', rerender);
 
-      // monaco-polish (2026-05-14): tree-resize handler moved into
-      // PaneResizer (below module def, top-level scope) so all 3
-      // handles share a single persistence layer. Inline width is
-      // restored from localStorage in PaneResizer.restoreDims().
+      // Tree resize is owned by PaneResizer so all handles share one
+      // persistence layer. Inline width is restored from localStorage.
 
       // Mark a path dirty in the tree (called by Editor when buffer
       // diverges from disk).
@@ -1441,7 +1418,7 @@
         rerender();
       }
 
-      // ── file-tree-watch (2026-05-15): subscribe + event apply ─────
+      // ── File-watch subscribe + event apply ─────
       //
       // Server-side fs-watch protocol (src/session/fs-watch.ts):
       //
@@ -1527,7 +1504,7 @@
         }, WATCH_COALESCE_MS);
       }
 
-      // file-tree-watch: dispatch an inbound fs-watch-event frame to
+      // Dispatch an inbound fs-watch-event frame to
       // the tree's incremental refresh pipeline. Returns true if the
       // frame was consumed (caller short-circuits the rest of its
       // onmessage chain), false otherwise.
@@ -1660,7 +1637,7 @@
       }
     }
 
-    // ── monaco-polish (2026-05-14): pane resize manager ──
+    // ── Pane resize manager ──
     //
     // Owns the 3 resize handles in editor mode + 1 in split mode:
     //   H1 tree ↔ editor-stack (col, in editor mode)         — TreeResizeHandle in FileTree IIFE
@@ -1897,17 +1874,12 @@
       ws.onopen = () => {
         setStatus('connected'); rd = 1000;
         ws.send(JSON.stringify({type:'resize',cols:term.cols,rows:term.rows}));
-        // file-tree-fix (2026-05-14): drain any fs-* frames that
-        // Editor / FileTree queued before WS opened. User repro
-        // was a cold session where clicking Editor before the first
-        // ws.onopen produced "fs-list failed: WS not connected".
-        // Drain order doesn't matter — server processes per-reqId.
+        // Drain any fs-* frames that Editor / FileTree queued before WS
+        // opened. Drain order does not matter; the server routes by reqId.
         try { if (typeof Editor !== 'undefined') Editor.drainFsQueue(); } catch {}
         try { if (typeof FileTree !== 'undefined') FileTree.drainFsQueue(); } catch {}
-        // file-tree-watch (2026-05-15): subscribe the FileTree to
-        // server-pushed fs-watch-event frames so terminal-side writes
-        // (e.g. `touch foo.c`) appear in the sidebar within ~150 ms
-        // without needing a manual refresh click.
+        // Subscribe the FileTree to server-pushed fs-watch-event frames so
+        // terminal-side writes appear without a manual refresh click.
         try { if (typeof FileTree !== 'undefined') FileTree.subscribeOnce(); } catch {}
         refreshStats();
         if (statsTimer) clearInterval(statsTimer);
@@ -1924,14 +1896,13 @@
       ws.onmessage = (e) => {
         try {
           const msg = JSON.parse(e.data);
-          // monaco-wave-a (2026-05-13): fs-*-result frames route to
-          // Editor's pending-request resolver. Return early so the
-          // shell-side dispatch doesn't see them as unknown types.
+          // fs-*-result frames route to the editor's pending-request
+          // resolver. Return early so shell dispatch does not see them
+          // as unknown types.
           if (Editor.tryHandleFsResult(msg)) return;
-          // monaco-wave-b: FileTree consumes fs-list results too.
+          // FileTree consumes fs-list results too.
           if (FileTree.tryHandleFsResult(msg)) return;
-          // file-tree-watch (2026-05-15): server-pushed fs-watch-event
-          // frames (no reqId) route to FileTree.applyWatchEvent which
+          // Server-pushed fs-watch-event frames route to FileTree, which
           // coalesces per-parent refreshes on a 100ms window.
           if (FileTree.applyWatchEvent(msg)) return;
           if (msg.type === 'output') {
@@ -2367,9 +2338,7 @@
     // and ProcessTable is populated by then, no arbitrary delay needed.
 
     term.focus();
-    // monaco-polish (2026-05-14): default to editor mode on page load.
-    // Restore any persisted pane dims (tree width, middle/preview ratio,
-    // editor/terminal ratio) BEFORE activating layout so the first paint
+    // Restore persisted pane dims before activating layout so the first paint
     // shows the user's prior arrangement.
     PaneResizer.restoreDims();
     setLayout('editor');

package/scripts/bundle-facet-workers.mjs

@@ -47,6 +47,7 @@ async function bundleAsPreamble(entryPath, label) {
     format: 'esm',
     target: 'esnext',
     platform: 'neutral',
+    absWorkingDir: root,
     write: false,
     logLevel: 'warning',
     legalComments: 'none',
@@ -106,7 +107,6 @@ async function main() {
     ' * W7-frame symbols:   encodeWriteBatchStream, decodeWriteBatchStream,',
     ' *   W7_MAGIC, W7_TRAILER.',
     ' *',
-    ` * Generated at: ${new Date().toISOString()}`,
     ` * Tar size: ${(tarStripped.length / 1024).toFixed(2)} KiB`,
     ` * W7 size:  ${(w7Stripped.length / 1024).toFixed(2)} KiB`,
     ' */',

package/scripts/bundle-git.mjs

@@ -47,6 +47,7 @@ async function main() {
       format: 'esm',
       target: 'esnext',
       platform: 'browser',
+      absWorkingDir: root,
       conditions: ['worker', 'browser', 'import'],
       // Map bare node built-ins → node: prefixed (works with nodejs_compat).
       alias: {
@@ -87,7 +88,6 @@ async function main() {
       ' * Consumed by git-network-facet.ts: passed to LOADER.load()\'s',
       ' * `modules` record so the facet can `import` isomorphic-git.',
       ' *',
-      ` * Generated at: ${new Date().toISOString()}`,
       ` * Size: ${(code.length / 1024).toFixed(1)} KiB`,
       ' */',
       '',