@descix/frqtl-node 0.6.0-p0.1 → 0.6.0-p0.2

package/dist/shim/registry/walkthrough.js

@@ -1,15 +1,13 @@
 /* Copyright 2023-2026 by Essam Abadir */
 
 /**
- * WALKTHROUGH — the ordered "Walk-through" rung registry
- * (ws-experiments-walkthrough Bite 3a; CEO ruling Q-CEO-2 + architect ruling A/B/C;
- * re-authored to addObject form in Bite 4b — architect ruling 3).
+ * WALKTHROUGH — the ordered "Walk-through" rung registry (rungs in addObject form).
  *
  * An ORDERED array of rung recipes surfaced as a "Walk-through" group in STUDIO's
  * experiment dropdown. Each rung loads via the blank-page load-by-eval path exactly
  * like a saved project — the SAME array is the SINGLE authority for BOTH the
  * dropdown group AND the `walkthrough:<id>` lookup (no parallel id→source map, no
- * switch statement — architect condition B).
+ * switch statement).
  *
  * A rung row carries the PATH of its scene, never its text: each scene is ONE sketch
  * file, `lib/frqtl/scenes/<file>.js` — a dual-mode `buildExperiment(exp)` module that
@@ -40,7 +38,7 @@
  *             walkthrough load path with the effective bag (a reload — the same
  *             pattern as `?engine=`).
  *
- * ── The mode-aware recipe form (S3/W2, CEO-ratified 2026-07-26) ───────────────
+ * ── The mode-aware recipe form (S3/W2) ────────────────────────────────────────
  * A multi-mode rung has exactly ONE `source`. A mode selects the RENDERER the host boots
  * (`renderState.renderer`); the scene reads the booted display once, before its world, and
  * makes the matching world (`three` ⇒ exp.createScene, else exp.createCanvas) — its
@@ -50,7 +48,7 @@
  * `z`/`depth`, ordinary Walls for the z-collimators, camera on the renderState) so
  * a built scene codegens to concrete, mode-PINNED state and survives Restart.
  *
- * ── The recipe form (Bite 4b — addObject, codegen-round-trippable) ────────────
+ * ── The recipe form (addObject, codegen-round-trippable) ──────────────────────
  * Rungs are OBJECT recipes: each body states the WORLD first, in its co-init call
  * (`exp.createCanvas(W, H, setupSphereEmitter3D.worldCfg(SRC))`) and then calls
  * `exp.addObject('SphereEmitter', SRC)` with the SAME bag — a PART never inits the
@@ -63,9 +61,9 @@
  * ── Layer 2: physics behavior ────────────────────────────────────────────────
  * Zero new physics (canonical-bench SU1) — every rung composes already-goldened
  * engine behaviors via the shared sphere-emitter sugar. Each rung un-degenerates ONE
- * already-present input of the previous (theorist Q-THEO-1: strictly compositional).
+ * already-present input of the previous (Q-THEO-1: strictly compositional).
  * The addObject builder forwards the opts VERBATIM to setupSphereEmitter3D, so the
- * physics/visual is BYTE-IDENTICAL to the pre-Bite-4b factory-call rungs.
+ * physics/visual is BYTE-IDENTICAL to the earlier factory-call rungs.
  */
 
 'use strict';
@@ -100,8 +98,8 @@ var THREE_RENDER_STATE = {
     renderer: 'three',
     camera: { orbit: null, preset: 'rooftop' }
 };
-// Sun: 3D + the sun's look. The render VALUES are owned by lib/shim/render/sun-look.js (the CEO's
-// exported FX bag); the camera is this row's own view, verbatim from his exported renderState.
+// Sun: 3D + the sun's look. The render VALUES are owned by lib/shim/render/sun-look.js (an
+// exported FX bag); the camera is this row's own view, verbatim from an exported renderState.
 var SUN_RENDER_STATE = {
     renderer: 'three',
     camera: { orbit: { azimuth: 32.978, elevation: 45, distance: 2873.68 }, preset: null },
@@ -140,7 +138,7 @@ export var WALKTHROUGH = [
         source: 'scenes/self-interference.js'
     },
     {
-        // POSITION IS THE CEO'S CALL (flagged, not decided silently). Placed here because
+        // POSITION (provisional): placed here because
         // Self-Interference is its closest physics sibling — the same banded fan, reached by
         // building an apparatus instead of by launching an omni source. Using the letter-suffix
         // idiom the 6A/6B/6C rungs already establish, so NO existing rung is renumbered.
@@ -213,10 +211,10 @@ export var WALKTHROUGH = [
         source: 'scenes/sun.js',
         renderState: SUN_RENDER_STATE
     },
-    // ── Collision Lab (CEO 2026-07-23, W1 drive) — the wall-collision primitives,
+    // ── Collision Lab (W1) — the wall-collision primitives,
     //    built on the first-class v2 Wall. Scaffolds for interactive tuning (drag /
-    //    rotate / select / save): the CEO drives them to confirm the base object +
-    //    control behaviors work bug-free. SU1 — the Walls add zero physics.
+    //    rotate / select / save) that confirm the base object + control behaviors
+    //    work bug-free. SU1 — the Walls add zero physics.
     {
         id:    'cl1a-mirror',
         title: '1A · Mirror',
@@ -299,7 +297,7 @@ export var WALKTHROUGH = [
             { id: '2d', label: '2D' }
         ]
     },
-    // ── Collision Lab · 3D (Z2, CEO UX-pass 2026-07-24) — 1A/1B/1C driven in a 3D scene:
+    // ── Collision Lab · 3D (Z2) — 1A/1B/1C driven in a 3D scene:
     //    a VOLUMETRIC (is2D:false) emitter + a 3D WALL SLAB (depth → a real z-slab, rendered
     //    as a BoxGeometry) + the THREE renderer/perspective camera (renderState). The walls'
     //    z-slabs CONTAIN z=0 (near<0<far) so the beam/spray — emitted at z=0 — collides. The
@@ -342,8 +340,7 @@ export var WALKTHROUGH = [
         source: 'scenes/counting-wall-3d.js',
         renderState: THREE_RENDER_STATE
     },
-    // ── DSE (CEO 2026-07-24, DSE-rebuild-before-republish; order + titles ruled
-    //    2026-07-26) — THE double-slit (on the Tunnel object, the single canonical
+    // ── DSE — THE double-slit (on the Tunnel object, the single canonical
     //    double-slit) then the photoelectric experiment, both on the full new
     //    component set. Letter prefixes are DROPPED: the group label carries the
     //    family, and the ids are the stable contract.
@@ -384,9 +381,9 @@ export var WALKTHROUGH = [
         modes: [
             {
                 id: '3d', label: '3D',
-                // FIRST-CONTACT FRAMING (CEO 2026-07-26): "standing BEHIND the emitter,
-                // facing the slit wall slightly rotated, so the interference builds up
-                // partially visible and invites you to move the camera."
+                // FIRST-CONTACT FRAMING: the camera stands BEHIND the emitter, facing the
+                // slit wall slightly rotated, so the interference builds up partially
+                // visible and invites the viewer to move the camera.
                 //
                 // DERIVED FROM THE SCENE, not tuned against a picture. The camera sits at
                 //     target + d·(cos el·sin az, sin el, cos el·cos az)
@@ -481,7 +478,7 @@ export var WALKTHROUGH = [
                'absorb/radiate drip (the emergent-probability threshold comes later).',
         source: 'scenes/dse-photoelectric.js'
     },
-    // ── The canonical-leg pair (CEO 2026-08-03). The competence baseline: no
+    // ── The canonical-leg pair. The competence baseline: no
     //    barrier, no slits, the plate ON the leg the ring formula was written for,
     //    and the graph a DSE researcher actually looks at first. 2D only — one
     //    declared world each, no mode strip (a physics variant is a recipe
@@ -627,7 +624,7 @@ export var WALKTHROUGH = [
     }
 ];
 
-// ── The mode contract (S3/W2, CEO-ratified 2026-07-26) ───────────────────────
+// ── The mode contract (S3/W2) ────────────────────────────────────────────────
 
 /**
  * walkthroughModes(rung) — the rung's declared mode list, ALWAYS an array.
@@ -726,7 +723,7 @@ export function effectiveRenderState(rung, modeId) {
     return normalizeSavedRenderState(merged);
 }
 
-// ── First contact (CEO 2026-07-26) ───────────────────────────────────────────
+// ── First contact ────────────────────────────────────────────────────────────
 
 /**
  * FIRST_CONTACT_WALKTHROUGH_ID — the rung STUDIO opens on with no deep link.
@@ -775,7 +772,7 @@ export function walkthroughById(id) {
     }
 });
 
-// ── is3D normalization (E-W0a, CEO 2026-07-23; mode-aware S3/W2) ─────────────
+// ── is3D normalization (E-W0a; mode-aware S3/W2) ─────────────────────────────
 // STUDIO must read ONE `is3D` field for a selection regardless of whether it came
 // from the gallery registry (experiments.js `is3D`) or a walkthrough rung. A rung's
 // 3D-ness is ALREADY declared by its (possibly mode-merged) `renderState.renderer` —

package/dist/shim/render/render-stages.js

@@ -29,7 +29,7 @@
  * transform-plugin registry, that is the failure mode this contract exists to prevent —
  * a new render transform lands as registered data on its stage's EXISTING surface, never
  * as bespoke provider code and never as a new uber-registry
- * (docs/internal/engine/RENDERER_CONTRACT.md §9, the standing veto).
+ * (RENDERER_CONTRACT §9).
  *
  * ── Layer 1: API contract ───────────────────────────────────────────────────
  *
@@ -411,7 +411,7 @@ function _posInt(v, name) {
 // SNAPSHOTS.
 //
 // Snapshotting (rather than ratifying a fresh-per-tick guarantee with the engine-boundary
-// owner) is the ruled choice because it buys the SECOND property too: the snapshot is plain
+// owner) is the chosen design because it buys the SECOND property too: the snapshot is plain
 // data, hence JSON-safe, which is the prerequisite for any on-disk corpus row.
 
 /**

package/dist/shim/render/sun-look.js

@@ -3,9 +3,9 @@
 /**
  * lib/shim/render/sun-look.js — the ONE owner of the SUN's look: its render-option bag.
  *
- * The values are the FINAL FX bag EXACTLY as the CEO played and captured it in his export session
+ * The values are the FINAL FX bag EXACTLY as played and captured in an export session
  * (new_sun.png is the primary oracle; sun.png stays the historical dense reference), verbatim from
- * his exported renderState. They are in the write door's shape — a BAG, what
+ * the exported renderState. They are in the write door's shape — a BAG, what
  * `runner.setRenderOptions(bag)` takes — and every key is a capability the three renderer declares.
  *
  *   SunLook.SUN_RENDER   — the sun's whole look (rung r8-sun's render rows).

package/dist/shim/rpc/index.js

@@ -1,8 +1,8 @@
 /* Copyright 2023-2026 by Essam Abadir */
 
 /**
- * lib/shim/rpc — the request/response call() primitive (WS gym-controls-as-sugar
- * Bite 3 Stage 2, Layer-A follow-up fix-loop; architect gate 5 charter —
+ * lib/shim/rpc — the request/response call() primitive (gym-controls-as-sugar
+ * Layer-A follow-up; gate 5 charter —
  * "the reqId/pending/timeout request/response-call()-over-postMessage pattern
  * is promoted to a SHIM PRIMITIVE the moment a second consumer needs it").
  *

package/dist/shim/runtime/index.js

@@ -71,7 +71,7 @@ var _router = null;
 // The realm's module instances, set when ensureEngine resolves (engine-stack-boot.js REALM_MODULES).
 var _realm = null;
 
-// Single-executor guard (P1 — WS-CODE-SINGLE-RUN).
+// Single-executor guard (P1).
 // Runtime.init() may be called multiple times (StrictMode double-mount,
 // remounts, preset switches).  The Bus 'run:request' executor
 // must be registered EXACTLY ONCE — extra registrations multiply execution count.
@@ -125,7 +125,7 @@ var _renderObj = {
  *   - SUGAR GETTERS (PointSource, LargeObject, CollisionTypes, …) — the library
  *     sugar objects, reached HERE so a user-code setup MODULE never imports
  *     `lib/frqtl/objects` (cross-arrow veto) and never reads window.* itself
- *     (WS-NOTEBOOK-IMPORT B1; architect build-gate ruling B). The module takes
+ *     (B1; build-gate B). The module takes
  *     this object as a passed `frqtl` param and destructures the sugar from it.
  *
  * EVERY member that reads a game-layer global goes through `_sugar(name)` — the ONE
@@ -319,7 +319,7 @@ function init(opts) {
         _eagerMath = _ensureMathSdk();
     }
 
-    // P1 (WS-CODE-SINGLE-RUN): dedup the run:request executor.
+    // P1: dedup the run:request executor.
     // If a previous handler is registered (e.g. StrictMode double-mount or a
     // remount), remove it first so there is
     // always EXACTLY ONE executor on this event — never two.
@@ -373,7 +373,7 @@ function run(opts) {
     }
 }
 
-// P2 (WS-CODE-SINGLE-RUN): one derived backend header per run. Shows WHICH math
+// P2: one derived backend header per run. Shows WHICH math
 // backend executes — derived from MathBackendRegistry, never hardcoded — emitted
 // ONCE per run:request execution so duplicate-execution bugs are immediately
 // visible (N headers = N executions). The math lane emits it after ensureMath
@@ -568,7 +568,7 @@ function _runMathModule(code, sdk, sourceUrl) {
  * This is a DIRECT ASYNC CALL — NOT routed through run()/_runRequestHandler,
  * and it adds ZERO Bus listeners. It emits NO `cell:run`/`cell:result` events.
  * That is THE constraint (binding veto #1) that keeps it clear of the
- * WS-CODE-SINGLE-RUN stacked-handler bug: the single `run:request` executor
+ * The stacked-handler bug: the single `run:request` executor
  * registered in init() is the only Bus execution path; runCell sits beside it
  * as a plain callable the kernel invokes per cell.
  *
@@ -587,7 +587,7 @@ function _runMathModule(code, sdk, sourceUrl) {
  * writes plain statements + a `return { name: value, … }`; resolved `inputs`
  * are injected as a named object and as `caps`.
  *
- * CELL-AS-MODULE (WS-NOTEBOOK-IMPORT B2): when the cell body has a top-level
+ * CELL-AS-MODULE (B2): when the cell body has a top-level
  * `import`, it is instead compiled as a blob ES module whose relative `./x.js`
  * specifiers resolve to the notebook's OWN user-code module cells via the IN-MEMORY
  * blob closure (`spec.modules` = { name → source }, threaded by the kernel). The
@@ -642,7 +642,7 @@ function _cellCaps(lane, sdk, displayFn) {
 
 // Tee console.log/warn/error into the IDE console pane for the duration of a cell
 // run. A notebook js cell's console.log/warn/error must all reach the cell's rich
-// ConsolePane (WS-NOTEBOOK-A5 GAP 2), each at its OWN level — log→info, warn→warn,
+// ConsolePane, each at its OWN level — log→info, warn→warn,
 // error→error — so the ConsolePane's level filters/badges are meaningful.
 //
 // Reentrancy guard (SHARED across all three teed methods) mirrors _runMathModule:
@@ -679,7 +679,7 @@ function _installConsoleTee() {
 
 /* ── cell-as-module: the notebook-local in-memory blob resolver (B2) ──────────
  *
- * THE LOAD-BEARING CHANGE (WS-NOTEBOOK-IMPORT; architect build-gate ruling C +
+ * THE LOAD-BEARING CHANGE (build-gate C +
  * VETO-CLASS constraint #1). When a cell body contains an `import`, it cannot run
  * through `new Function` (module syntax is illegal there). It is compiled as a
  * blob ES module instead. The PURE closure logic (path math, specifier rewrite,
@@ -735,7 +735,7 @@ function _runCellAsModule(code, id, modules, caps, inputs) {
  * @property {Function} [display] — structured-output sink (pane-supplied DOM writer).
  * @property {boolean} [forceModulePath=false]
  *   Force the cell-as-module (blob) routing regardless of what the `hasImport`
- *   text-sniff would decide (WS gym-controls-as-sugar Bite 0a fix-loop #3, C15).
+ *   text-sniff would decide (C15).
  *   The synthesis authorities that KNOW their own template needs the module path
  *   (`setup-builder.js`'s synthesized builder, whose module reference is now a
  *   body-level DYNAMIC `import(...)` the line-start sniff cannot see) set this
@@ -797,7 +797,7 @@ function runCell(spec) {
     // kernel threads per run (fresh — never cached Runtime state). Drives the
     // cell-as-module closure when the cell body imports a notebook-local module.
     var modules         = spec.modules || {};
-    // C15 (WS gym-controls-as-sugar Bite 0a fix-loop #3): an explicit signal from
+    // C15: an explicit signal from
     // a synthesis authority that ALREADY KNOWS its template needs the module-blob
     // path — bypasses the hasImport() text-sniff entirely for this call. See the
     // RunCellSpec.forceModulePath doc above for why the sniff itself is NOT widened.
@@ -926,7 +926,7 @@ function _failMathRealm(err) {
  * entry (sdk/egpt-math-sdk `dist-entry.js`, served at the site's
  * `./pub/<build>/egpt-math-sdk/index.js` in the static build) registers its wasm provider ONLY into its private facade
  * slot (`wasm-facade.js` `_setActiveWasmProvider`). To keep the JS math core OUT
- * of the published bundle (CEO 2026-07-10 WASM-only publish rule) it deliberately
+ * of the published bundle (the WASM-only publish rule) it deliberately
  * NEVER imports `lib/egpt/js/model/backend/*`, so it CANNOT register into the registry
  * this Runtime uses — and in a built app its bundled registry copy would be a
  * DIFFERENT module instance across the dynamic-import boundary anyway. Result:
@@ -934,7 +934,7 @@ function _failMathRealm(err) {
  * "'wasm-math' is not registered", rejecting the eager load so the notebook pane
  * never mounted. (The DEV source entry `sdk-entry.js` registers into the SAME
  * shared source-instance itself, which is why dev never hit this — the dist IDE
- * shell was dead until ws-egpt-frqtl-site-deploy exercised this path.)
+ * shell was dead until the static site exercised this path.)
  *
  * FIX: the sdk EXPOSES its provider (`sdk.mathBackendProvider`, a plain
  * contract-conformant object); the Runtime — the SOLE owner of

package/dist/shim/storage/modules.js

@@ -25,7 +25,7 @@
  *                    (a walk-through rung) resolves that window global. `[]`/absent
  *                    for an ordinary saved project (DX-3, the rung-source ferry).
  *     renderState:   object|null          — v3+. Studio's Save realignment
- *                    (WS Studio Controls Realignment §2.6) capture bag —
+ *                    (Studio Controls Realignment §2.6) capture bag —
  *                    everything the .js recipe itself does NOT round-trip:
  *                    renderer/seed (load-time), render capability
  *                    values + camera + backdrop visibility + bind-backed
@@ -44,10 +44,10 @@
  *   read without error and default to `kind:'frqtl'` (R6 binding: must never
  *   throw on legacy envelopes).  The `kind` field is the ONLY new field (AM-2).
  *
- *   v2 → v3: `renderState` field added (WS Studio Controls Realignment §2.6,
- *   Bite S6). Legacy v1/v2 envelopes (no `renderState` field) are read without
+ *   v2 → v3: `renderState` field added (Studio Controls Realignment §2.6,
+ *   S6). Legacy v1/v2 envelopes (no `renderState` field) are read without
  *   error and default to `renderState: null` (R6 extended) — a saved project
- *   from before this bite simply replays with NO render/camera/page-control
+ *   from before S6 simply replays with NO render/camera/page-control
  *   state (byte-identical to its own pre-S6 behavior), never a throw.
  *
  * ── Namespace ──────────────────────────────────────────────────────────────
@@ -147,12 +147,12 @@ function _validateModule(mod) {
  * v1 → v2: default `kind` to `'frqtl'` when the field is absent.
  *   R6 (binding): this must NEVER throw on legacy v1 envelopes.
  *
- * v2 → v3: default `renderState` to `null` when the field is absent (WS
- *   Studio Controls Realignment §2.6, Bite S6). R6 extended: never throw on
+ * v2 → v3: default `renderState` to `null` when the field is absent
+ *   (Studio Controls Realignment §2.6, S6). R6 extended: never throw on
  *   a legacy v1/v2 envelope with no `renderState` field.
  *
- * v3 → v4: default `scripts` to `[]` when the field is absent (ws-experiments-
- *   walkthrough DX-3 — the rung-source ferry). R6 extended again: never throw on
+ * v3 → v4: default `scripts` to `[]` when the field is absent (DX-3 —
+ *   the rung-source ferry). R6 extended again: never throw on
  *   a legacy envelope with no `scripts` field (an ordinary saved project has none).
  *
  * @param {object} mod  Raw object from storage.

package/llms.txt

@@ -1,12 +1,12 @@
 # @descix/frqtl-node
 
 > The FRQTL physics engine (compiled Rust → WASM) for node: the same modules as @descix/frqtl-web, plus
-> `bootNode` and the hosted eyes. Pre-release 0.6.0-p0.1 on npm dist-tag `next`. Node ≥ 22.12.
+> `bootNode` and the hosted eyes. Pre-release 0.6.0-p0.2 on npm dist-tag `next`. Node ≥ 22.12.
 
 - Install: `npm install @descix/frqtl-node@next`
 - `import { bootNode, Wall } from '@descix/frqtl-node'` (require() works too); `await bootNode()` → the engine handle.
 - `./eyes`: `openHostedEyes({ sceneRecord, sceneSource: { kind: 'project', files, entry }, pageUrl })`.
 - `./project`: `linkProject` links a scene file against this package's own copy.
 - `./register`: `node --import @descix/frqtl-node/register scene.mjs` resolves a scene's `@descix/frqtl-web/...` imports to this package.
-- Full agent guide: https://cdn.jsdelivr.net/npm/@descix/frqtl-node@0.6.0-p0.1/CLAUDE.md
+- Full agent guide: https://cdn.jsdelivr.net/npm/@descix/frqtl-node@0.6.0-p0.2/CLAUDE.md
 - Acceptance is visual; no CLI ships. No account, credits or tokens are needed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@descix/frqtl-node",
-  "version": "0.6.0-p0.1",
+  "version": "0.6.0-p0.2",
   "description": "FRQTL for node \u2014 the discrete fractal physics engine (compiled Rust \u2192 WASM), its parts as ES modules, the node engine door (bootNode) and the hosted eyes.",
   "type": "module",
   "engines": {
@@ -29,7 +29,8 @@
     "dist",
     "README.md",
     "llms.txt",
-    "CLAUDE.md"
+    "CLAUDE.md",
+    "LICENSE.md"
   ],
   "scripts": {
     "build": "node build.js",
@@ -56,7 +57,7 @@
     "descix"
   ],
   "author": "Essam Abadir",
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
     "playwright": "1.61.0"
   },