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

package/dist/frqtl/objects/setup/setupSphereEmitter3D.js

@@ -2,8 +2,8 @@
 
 /**
  * setupSphereEmitter3D — a spherical "sun" emitter: uniform-DIRECTION emission
- * via ball-rejected integer velocity sampling (CEO-ratified model, 2026-07-17,
- * corrected same day: speed is ALWAYS 1px/tick (bench M1) — (vx,vy,vz) is
+ * via ball-rejected integer velocity sampling (the model: speed is
+ * ALWAYS 1px/tick (bench M1) — (vx,vy,vz) is
  * DIRECTION ONLY, never a speed knob; only the ratio vx:vy:vz matters,
  * (3,4,0)≡(6,8,0)). Models on `setupConeEmitter3D.js` (same live-knob,
  * host-tick-fn, thin-sugar pattern).
@@ -71,7 +71,7 @@
  *   enough that a SINGLE BURST (before engine-tick temporal averaging kicks
  *   in) doesn't itself read lumpy: a static (no-tick) per-burst octant CV is
  *   ~0.16 at R=9, ~0.09 at R=20, ~0.07 at R=24-25, flattening to ~0.05-0.06 by
- *   R=30-40 (CEO-directed re-check, 2026-07-18, host-RNG measurement) — R=24
+ *   R=30-40 (host-RNG measurement) — R=24
  *   is the new DEFAULT, comfortably past the R=20 knee with headroom below the
  *   R=40 slider ceiling (so the R=9-ish "lumpy" end of the range stays
  *   explorable too).
@@ -90,8 +90,8 @@
  *   ball's 0.082 at R=20,N=4000) because it drops the coarse near-origin
  *   lattice points; optional refinement, not the default.
  * @param {'spherical'|'hemisphere'|'laser'|'drum'|'particle-walk'} [options.preset='spherical'] - Sets the
- *   per-axis velocity RANGES the sampler draws from — the unification the CEO
- *   asked for: sun/laser/drum are the SAME sampler with different ranges.
+ *   per-axis velocity RANGES the sampler draws from — the unification:
+ *   sun/laser/drum are the SAME sampler with different ranges.
  *     'spherical' (DEFAULT, the sun): vx,vy,vz each in [-R,R] -> full ball ->
  *       uniform spherical direction distribution.
  *     'hemisphere' (FORWARD 180° emission — the directed sun): the SAME ball-
@@ -99,7 +99,7 @@
  *       vy,vz in [-R,R]. Conditioning a uniform ball on vx>=0 leaves a uniform
  *       HALF-ball, whose direction marginal is EXACTLY the restriction of
  *       'spherical''s to the forward hemisphere: same physics, pointed one way
- *       (theorist advisory 2026-07-28, measured over 2x10^6 MC samples). BALL
+ *       (measured over 2x10^6 MC samples, 2026-07-28). BALL
  *       REJECTION IS RETAINED and that is load-bearing — a raw box draw
  *       (vx in [0,R], vy in [-R,R], no magnitude clip) measures 1.83:1
  *       anisotropy with 1.45x peaks at +/-45deg, which is exactly the diagonal
@@ -130,7 +130,7 @@
  *       component (this is the historical concentric-ring-emitter-vs-cone
  *       construction's "collimated cylinder" case generalized: here the
  *       DISK is of DIRECTIONS at the source, not ring positions).
- *     'particle-walk' (CEO Phase 1 iteration, 2026-07-18, two rounds — a
+ *     'particle-walk' (a
  *       FAITHFUL reproduction, not just the primitive, GROUND-TRUTHED against
  *       the actual `setupParticleWalk.js`/`setupParticleWalk3D.js` source):
  *       vx PINNED to `[R,R]` (deterministic +X drift, ALWAYS the forward
@@ -162,7 +162,7 @@
  *   `control.setAxisRange('vx', lo, hi)` etc. for custom directional shapes.
  * @param {{x:number,y:number,z:number}} [options.emissionBox] - OPT-IN per-axis
  *   emission-position box (extends the scalar `emissionBoxSide` cube into an
- *   independent size per axis — CEO Phase 1 iteration). Omitted (default) ->
+ *   independent size per axis). Omitted (default) ->
  *   `emissionBox` is DERIVED from `emissionBoxSide` + the current preset
  *   (uniform cube for spherical/laser/drum — BYTE-IDENTICAL to every
  *   pre-existing caller; the flat line shape above for 'particle-walk',
@@ -243,7 +243,7 @@
  *   SOURCE POSITION in ABSOLUTE canvas px — WHERE this emitter seeds its leaves
  *   (the center `cx0/cy0/cz0` that BOTH the volume box AND the surface ring
  *   launch are measured relative to). Wins over `options.offset` when both are
- *   present. z (3rd element) defaults to 0. Pure sugar (Bite 3, 2026-07-20): it
+ *   present. z (3rd element) defaults to 0. Pure sugar: it
  *   ONLY moves the `makeLeafFrame` seed pixel — the velocity-aligned ring launch
  *   (`start = center + innerR×unit(v)`) stays relative to THIS center; zero
  *   engine, no golden moves (SU1). Needed for TWO-SOURCE interference (two
@@ -299,8 +299,7 @@
  *     fewer axis; `is2D` simply narrows `activeAxes` at init and drops vz
  *     from the sampler.
  *
- * MEASURED engine-realized finding (canonical-bench S4/S5,
- * `docs/internal/physics-lab/canonical-bench/bench.cjs`, pkg-node WASM, R=20 N=2000 T=30
+ * MEASURED engine-realized finding (canonical-bench S4/S5, pkg-node WASM, R=20 N=2000 T=30
  * seed=42, bit-reproducible across runs): angular uniformity (equal-solid-
  * angle octant CV + cos(polar) marginal-flatness CV) is NOT distorted toward
  * axes or diagonals by the ±1px/tick per-axis speed cap — S4 measures
@@ -330,10 +329,10 @@
  * is a property of the ALREADY-GOLDENED move-gate rule, not new sugar logic —
  * composing it here (dial mass via the `wavelength` arg, read the resulting
  * oscillation) is exactly the r0/r1 "unique rational wavelength, unchanged
- * speed" demo the intuition guide (`docs/internal/physics-lab/intuition/README.md`) names.
+ * speed" demo the intuition guide names.
  *
  * Sustained emission is a HOST TICK-FN pushed to
- * `universe.experimentTickFunctions` (architect guardrail: no new engine
+ * `universe.experimentTickFunctions` (guardrail: no new engine
  * hook, no native emit-spec). Fast-path regime: no
  * `withInterQuantumCollisions`, no `brownianMotion`, no top-down frame-gen
  * auto-spawn ladder. No sink — leaves drift forever (M5) until they exit
@@ -376,9 +375,9 @@ import { FrqtlWorldInit } from './_worldInit.js';
      * Three names for three layers of one quantity — author knob, universe field,
      * emergent wavelength — so a reader who sees only one of them can find the others.
      * Confirmed by measurement at both sweep points: fWL 64 -> 256, fWL 32 -> 128
-     * (docs/internal/physics-lab/intuition/starter.jsonl, r3-radius-stall-shells).
+     * (the intuition record r3-radius-stall-shells).
      *
-     * ── `stepping` (ws-walk-unification Bite 1) — a WORLD field, PASSED THROUGH ──
+     * ── `stepping` — a WORLD field, PASSED THROUGH ───────────────────────────────
      * The wave-walk STEPPING SAMPLER ('fixed' | 'average') is a per-universe init
      * option, reinit-class exactly like `is2D`/`fundamentalDimension`, so it belongs
      * to the world step rather than to the part. This factory NEITHER validates NOR
@@ -554,7 +553,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
             : (declaresDimension ? 0 : _worldFundamentalDimension(universe));
 
         // `leafDimension` = the dimension THIS emitter births its leaves at (per-emitter
-        // — the CEO's corrected 2026-07-19 model: dimension is an ADDABLE scale layer, and
+        // — the corrected model: dimension is an ADDABLE scale layer, and
         // an emitter creates leaves AT a chosen dimension via makeLeafFrame's explicit
         // `level` + `addDimension` (the SAME pattern scenes/blackbody.js uses: init at a base
         // fundamental, then addDimension for the higher scale layer). Default =
@@ -593,7 +592,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
             universe.addDimension(leafDimension);
         }
 
-        // ── Emission SOURCE POSITION (per-emitter — Bite 3, 2026-07-20) ──────────
+        // ── Emission SOURCE POSITION (per-emitter) ───────────────────────────────
         // cx0/cy0/cz0 = the center this emitter seeds its leaves around (BOTH the
         // volume box AND the surface ring launch are relative to it). Resolved from
         // options.center (ABSOLUTE canvas px, wins) / options.offset (RELATIVE to
@@ -642,7 +641,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
             // = per-leaf ±, exactly reproducing PointSource/emitterProgram.js's
             // `chargeInt = universe.random() < 0.5 ? 0 : 1` (the ONE opt-in extra
             // draw). Required to reproduce the Wave-Interference look from a single
-            // omni source (CEO 2026-07-18).
+            // omni source.
             chargeMode: (options.chargeMode === 'random' || options.chargeMode === 'negative'
                 || options.chargeMode === 'positive') ? options.chargeMode : 'positive',
             // Emission START-POSITION topology (WHERE a leaf is seeded, independent
@@ -652,14 +651,14 @@ import { FrqtlWorldInit } from './_worldInit.js';
             // CIRCLE in 2D / a SPHERE SHELL in 3D). Surface mode reproduces the old
             // PointSource "ring launch": single-occupancy forbids many quanta from
             // starting on the EXACT same pixel, so PointSource seeds them around a
-            // ring — the correct single-source start topology (CEO 2026-07-18).
+            // ring — the correct single-source start topology.
             emissionShell: (options.emissionShell === 'surface') ? 'surface' : 'volume',
             // Shell radius (px) for emissionShell:'surface'. Non-negative integer;
             // 0 collapses the shell back to the center point (so 'surface' with
             // innerR 0 == 'volume' with box 0 — a single pixel). Ignored entirely
             // in 'volume' mode (no draw).
             innerR: (options.innerR !== undefined) ? Math.max(0, Math.round(options.innerR)) : 0,
-            // Per-leaf RENDER COLOR OVERRIDE (render-intent DATA, NOT physics — CEO 2026-07-19).
+            // Per-leaf RENDER COLOR OVERRIDE (render-intent DATA, NOT physics).
             // null (DEFAULT) → leaves are emitted COLORLESS (byte-identical to every pre-existing
             // caller) so the renderer's colorScheme derives color from fullness (LightColor). An
             // [r,g,b] / [r,g,b,a] array → FORCES that color: it is passed to makeLeafFrame's `color`
@@ -670,7 +669,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
             // wavelength→LightColor mapping with ZERO engine field touched. LIVE via
             // control.setRenderColor (affects the NEXT emitted leaf, M5).
             renderColor: Array.isArray(options.renderColor) ? options.renderColor.slice() : null,
-            // Per-leaf RENDER SHAPE OVERRIDE (render-intent DATA, NOT physics — Bite 5b A3).
+            // Per-leaf RENDER SHAPE OVERRIDE (render-intent DATA, NOT physics).
             // null (DEFAULT) → leaves emit with NO render.shape key (byte-identical to every
             // pre-existing caller); the renderer falls back to the render-level "Default Shape"
             // (setRenderOption) then 'ball'. A ball|box|circle|cube|sphere string is stamped as
@@ -693,7 +692,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
             active: true
         };
         // GROUND-TRUTHED against setupParticleWalk.js / setupParticleWalk3D.js
-        // (CEO fullness-tuning pass, 2026-07-18 — read the actual source, not a
+        // (read the actual source, not a
         // paraphrase): both historical experiments use IDENTICAL construction —
         // `sourceRect=[cx,cy,1,10]` (a height-10 vertical LINE, x-width=1, in
         // BOTH 2D and 3D — there is no disk anywhere in the historical code;
@@ -705,7 +704,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
         // canvas, wrap=false so quanta die at the far wall): alive count
         // climbs 1000/2000/4000 at ticks 50/100/200 then PLATEAUS at exactly
         // 5960 by tick~300 (little's-law steady state: 20/tick x ~298-tick
-        // transit time from x~302 to the x=599 wall) — this IS the CEO's
+        // transit time from x~302 to the x=599 wall) — this IS the
         // "~5960 alive, the fuller sheet/beam" density target, reproduced
         // here by matching the SAME three numbers, not by tuning against the
         // number directly.
@@ -719,7 +718,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
         state.burstSize = options.burstSize !== undefined ? options.burstSize
             : (state.preset === 'particle-walk' ? PARTICLE_WALK_DEFAULT_BURST_SIZE : 40);
 
-        // ── Per-axis emission SOURCE SHAPE (CEO Phase 1 iteration, 2026-07-18
+        // ── Per-axis emission SOURCE SHAPE
         //    — the "drum emitter" shape: a flat line source, extending the
         //    scalar emissionBoxSide cube into an opt-in per-axis box).
         //    `explicitEmissionBox`/`explicitSourceShape` (options, FROZEN at
@@ -788,7 +787,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
                     ranges.vz = fwd;
                 }
             } else if (name === 'hemisphere') {
-                // FORWARD 180° emission (D1, CEO 2026-07-28) — the ONE line that
+                // FORWARD 180° emission (D1) — the ONE line that
                 // differs from 'spherical': the forward axis' range is HALVED to
                 // [0,R]. Everything else (the ball rejection below, the isotropy
                 // correction) is shared, which is the whole point: a uniform ball
@@ -805,7 +804,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
                 ranges.vy = [-R, R];
                 ranges.vz = [0, 0];
             } else if (name === 'particle-walk') {
-                // Faithful reproduction (CEO Phase 1 iteration): PURE-FORWARD
+                // Faithful reproduction: PURE-FORWARD
                 // +X momentum, ALWAYS (not is2D-branched like 'laser' — both
                 // historical experiments, 2D and 3D, used vx=1,vy=0 literally).
                 // vy=vz PINNED to 0 — the waviness comes entirely from the
@@ -829,7 +828,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
         // Mulberry32 stream (G-EMIT primitive) — same stream physics draws from, so a
         // fixed seed is fully reproducible.
         //
-        // REJECTION IS PRESET-AWARE (CEO fix, 2026-07-18) — the rejection criterion
+        // REJECTION IS PRESET-AWARE — the rejection criterion
         // must match each preset's INTENDED SHAPE, not a single one-size ball:
         //   'spherical': reject to the BALL |v|<=R (rounds the sampled cube into a
         //     sphere of directions — the mandatory isotropy correction, S4/S5).
@@ -916,8 +915,8 @@ import { FrqtlWorldInit } from './_worldInit.js';
         }
 
         // Circular rejection in the Y-Z plane (the transverse cross-section
-        // perpendicular to 'particle-walk''s +X forward axis — the CEO's
-        // "circular disk source (3D)"). Mirrors sampleVelocity's own
+        // perpendicular to 'particle-walk''s +X forward axis — the
+        // circular disk source (3D)). Mirrors sampleVelocity's own
         // ball-rejection idiom, applied to POSITION instead of direction.
         // Only ever called when state.sourceShape==='disk' (opt-in — never
         // the default path for spherical/laser/drum).
@@ -933,11 +932,11 @@ import { FrqtlWorldInit } from './_worldInit.js';
             return [0, 0]; // safety net (misconfigured box)
         }
 
-        // Emission SHELL SURFACE start-position — VELOCITY-ALIGNED (CEO 2026-07-18).
+        // Emission SHELL SURFACE start-position — VELOCITY-ALIGNED.
         // The old-PointSource "ring launch" seeds each particle ON the ring AT THE
         // ANGLE OF ITS OWN VELOCITY, so its start pixel is COLLINEAR with its outward
-        // trajectory (the CEO's "pixel position is the integer-scaled momentum
-        // vector"). This is what gives a single source an EMPTY CENTER and razor-
+        // trajectory (the pixel position is the integer-scaled momentum
+        // vector). This is what gives a single source an EMPTY CENTER and razor-
         // sharp bands: every particle projects radially outward and NONE cuts across
         // the inner disk. Draws NOTHING itself — it is a deterministic function of
         // the ALREADY-SAMPLED velocity `v` (which is why emitOneLeaf samples velocity
@@ -999,7 +998,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
             // wavelength=state.wavelength -- null by default (mass=capacity, byte-identical);
             // a number sets mass=max(1,capacity/wavelength) for the NEXT emitted leaf (M5:
             // already-emitted leaves keep whatever mass they were stamped with).
-            // 10th arg (Bite 5b A3) = per-leaf render.shape override (null default → no key →
+            // 10th arg = per-leaf render.shape override (null default → no key →
             // byte-identical). Rides the SAME provider render-intent MERGE seam as color.
             var h = universe.makeLeafFrame(lx, ly, leafDimension, state.wavelength, v[0], v[1], false, chg, state.renderColor, state.renderShape);
             if (h === null) { return; } // liveQuantaCap refused the add: no leaf, nothing to stamp
@@ -1031,7 +1030,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
             marker.setRect([cx0 - D / 2, cy0 - D / 2, cz0 - D / 2, D, D, D]);
         }
         var control = {
-            // INVARIANT (CEO fix, 2026-07-18 — "the clamp bug"): emissionBoxSide is
+            // INVARIANT ("the clamp bug"): emissionBoxSide is
             // NEVER larger than the CURRENT R. Construction clamps it once; setR()
             // is the ONLY runtime path that can widen the gap (R shrinking below an
             // already-set box), so it MUST re-clamp every time — this is the single
@@ -1067,7 +1066,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
             getEmitEveryTicks: function () { return emitEveryTicks; },
             setActive: function (v) { state.active = !!v; },
             getIs2D: function () { return is2D; },
-            // Emission SOURCE POSITION (Bite 3, 2026-07-20) — reposition this emitter's
+            // Emission SOURCE POSITION — reposition this emitter's
             // center LIVE (affects the NEXT emitted leaf, M5). Absolute canvas px. z
             // optional (retains the current z when omitted). Pure sugar — only the
             // makeLeafFrame seed pixel moves; the ring launch stays relative to it.
@@ -1113,11 +1112,11 @@ import { FrqtlWorldInit } from './_worldInit.js';
             getWavelength: function () { return state.wavelength !== null ? state.wavelength : 1; },
             getMaxWavelength: function () { return maxWavelength; },
             getFundamentalDimension: function () { return fundamentalDimension; },
-            // The dimension THIS emitter births leaves at (per-emitter — CEO 2026-07-19).
+            // The dimension THIS emitter births leaves at (per-emitter).
             getLeafDimension: function () { return leafDimension; },
-            // LIVE "Emit Dimension" (Bite 5b A2). Host-side addDimension (idempotent) +
+            // LIVE "Emit Dimension". Host-side addDimension (idempotent) +
             // closure-var flip: the NEXT emitted leaf is born at the new dimension (M5, exactly
-            // like wavelength/charge). Theorist CLEARED mid-run addDimension as SAFE (2026-07-22):
+            // like wavelength/charge). Mid-run addDimension is SAFE (cleared 2026-07-22):
             // do_tick snapshots the dim key set fresh each tick, so a between-ticks add is atomic;
             // promotion routes live. SIDE EFFECT (S1): a value BELOW the current fundamental
             // self-lowers the floor UNIVERSE-GLOBALLY and is a ONE-WAY RATCHET (no removeDimension)
@@ -1164,7 +1163,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
 
         // Standardized live knobs (runner.experimentControls-compatible — the SAME
         // shape coneEmitterControl.controls uses). Every
-        // descriptor carries a `get()` accessor (CEO fix, 2026-07-18) so a page can
+        // descriptor carries a `get()` accessor so a page can
         // generically RE-SYNC every slider's displayed value/label from authoritative
         // state after ANY control fires — not just the one the user dragged. This is
         // what makes the emissionBoxSide<=R clamp VISIBLE live: `emissionBoxSide`
@@ -1225,7 +1224,7 @@ import { FrqtlWorldInit } from './_worldInit.js';
         return {
             sphereEmitterControl: control,
             largeObjects: [],
-            // TOP-LEVEL dispose (STACKING-BUG FIX, CEO 2026-07-19): FrqtlApp.setup()
+            // TOP-LEVEL dispose (STACKING-BUG FIX): FrqtlApp.setup()
             // tears down the PREVIOUS setupResult by calling `setupResult.dispose()` IF it
             // exists (canonical teardown, FrqtlApp.js) — but this factory previously
             // exposed dispose ONLY on `sphereEmitterControl`, so the runner's teardown check

package/dist/frqtl/objects/setup/setupTunnelLab.js

@@ -3,8 +3,8 @@
 /**
  * setupTunnelLab — DirectedTunnel ISOLATION (I1, the directed-tunnel composition model
  * §3): ONE `DirectedTunnel`, gun-chamber mechanics (fill / escape / dispersion) at a
- * live-tunable scale — the visual half of the scale-sweep measurement
- * (`docs/internal/physics-lab/directed-tunnel-scale-sweep/`), same methodology, same source shape.
+ * live-tunable scale — the visual half of the scale-sweep measurement, same methodology,
+ * same source shape.
  *
  * ── Layer 1: API contract ────────────────────────────────────────────────────
  *
@@ -22,7 +22,7 @@
  *   `QuantumEmitter` has no wavelength field, which is exactly why this factory hand-
  *   places quanta via a local host tick-fn instead of `DirectedTunnel`'s `options.emitter`
  *   — see the Layer 2 note below). LIVE (`setupResult.sourceState.wavelength`).
- *   **CEILING (CEO drive #2, 2026-07-14 — "the wavelength slider has no effect"
+ *   **CEILING ("the wavelength slider has no effect"
  *   root cause):** Engine Invariant #6 is `mass = max(1, capacity/wavelength)` —
  *   at this factory's `FUNDAMENTAL_DIMENSION=2`, `capacity = (2^2)^2 = 16`
  *   (`setupTunnelLab.CAPACITY`, exported below), so ANY `wavelength >= capacity`
@@ -43,7 +43,7 @@
  * @param {number} [opts.sourceDensity=5] - Quanta hand-placed per burst. LIVE
  *   (`setupResult.sourceState.density`). NOTE: this is the FACTORY's own
  *   omitted-opt default (unchanged, for any headless caller) — `tunnel-lab
- *   /index.html`'s own UI default is 10 (CEO drive #2, 2026-07-14
+ *   /index.html`'s own UI default is 10 (the
  *   population-density fix: the page ALWAYS passes an explicit value read
  *   from its own `<input>` default, so this factory default is never
  *   actually reached by the page — see that file's own docstring for the
@@ -56,15 +56,14 @@
  *   for the same reason.
  * @param {boolean} [opts.sourceActive=true] - Master on/off for the burst source. LIVE
  *   (`setupResult.sourceState.active`).
- * @param {number} [opts.depth] - CEO drive #2 (2026-07-14) 3D toggle. OMITTED
+ * @param {number} [opts.depth] - 3D toggle. OMITTED
  *   (default) -> 2D (byte-identical to every pre-existing caller). A positive
  *   value -> real z-containment (`activeAxes:{x,y,z}` on `universe.init()`,
  *   `DirectedTunnel`'s own `depth`/`z=-depth/2`, hand-placed quanta z-centred)
  *   — the standard `options.depth` recipe. REINIT-CLASS
  *   (only meaningful at construction, like bore/length).
- * @param {'spray'|'beam'} [opts.velocityProfile='spray'] - ws-dse-3d AC3 (CEO
- *   drive #2 round-2 ruling, "tunnel-lab gains the source-profile selection off
- *   the shared surface"): the SAME `SustainedSource.SOURCE_SPEC_FIELDS.
+ * @param {'spray'|'beam'} [opts.velocityProfile='spray'] - tunnel-lab has the
+ *   source-profile selection off the shared surface: the SAME `SustainedSource.SOURCE_SPEC_FIELDS.
  *   velocityProfile` axis `LightSource`'s own `particleWalk` burst always uses
  *   (`'beam'`, hardcoded there) — exposed here so tunnel-lab can be set to
  *   `'beam'` and produce a directly comparable collimated source to
@@ -98,12 +97,11 @@
  *
  * **Gun-chamber convention**: `capNegX:true, capPosX:false` — a CLOSED breech (source
  * fires INTO the bore, quanta bounce/fill) and an OPEN muzzle (quanta escape, then
- * disperse freely with no walls) — the CEO's own Gun-Chamber model ("particles ping-pong
- * in a tube, escape the open end, spread comes from dispersion AFTER escape").
+ * disperse freely with no walls) — the Gun-Chamber model (particles ping-pong
+ * in a tube, escape the open end, spread comes from dispersion AFTER escape).
  *
  * **Fundamental dimension = 2** (matches `setupDoubleSlit.js`'s default AND the scale-
- * sweep's own convention — see `docs/internal/physics-lab/directed-tunnel-scale-sweep/README.md`'s
- * "level 0 pins wavelength to a no-op" note): a level-0 leaf has `capacity=1`, so
+ * sweep's own convention — level 0 pins wavelength to a no-op): a level-0 leaf has `capacity=1`, so
  * `mass=max(1,capacity/wavelength)` is PINNED at 1 for any `wavelength>=2` — the
  * wavelength slider would be a silent no-op at level 0.
  *
@@ -126,14 +124,14 @@ import * as SustainedSource from '../objects/sustainedSource.js';
 
     var FUNDAMENTAL_DIMENSION = 2; // matches setupDoubleSlit.js + the scale-sweep script
 
-    // CEO drive #2 (2026-07-14) — the ONE authority for "what's the largest
+    // The ONE authority for "what's the largest
     // wavelength value that still produces a DISTINCT mass from any larger one"
     // at this factory's FUNDAMENTAL_DIMENSION. Engine Invariant #6:
     // `mass = max(1, capacity/wavelength)` — the floor (mass=1) is reached
     // exactly at `wavelength === capacity`; every wavelength beyond that is
     // indistinguishable. `tunnel-lab/index.html` reads this (never a hand-typed
     // "16" literal) to clamp its wavelength slider's max to the achievable range.
-    // ws-dse-3d: derived from `SustainedSource.capacityAtDimension` — the SAME
+    // Derived from `SustainedSource.capacityAtDimension` — the SAME
     // authority `setupLightSourceLab.js` now also derives its own
     // MAX_USEFUL_WAVELENGTH from (AC4: "same MAX_USEFUL_WAVELENGTH clamp
     // authority" for both labs).
@@ -164,7 +162,7 @@ import * as SustainedSource from '../objects/sustainedSource.js';
         var sourceDensity = opts.sourceDensity !== undefined ? opts.sourceDensity : 5;
         var sourceRate = opts.sourceRate !== undefined ? opts.sourceRate : 10;
         var sourceActive = opts.sourceActive !== undefined ? !!opts.sourceActive : true;
-        // CEO drive #2 item 1 (2026-07-14) — OPT-IN 3D, OMISSION-preserves-2D
+        // OPT-IN 3D, OMISSION-preserves-2D
         // (the "before adding a creation-method parameter" discipline): mirrors
         // the standard `options.depth` recipe — omitted/null ->
         // 2D (zContain:false, byte-identical to every existing caller); a
@@ -172,7 +170,7 @@ import * as SustainedSource from '../objects/sustainedSource.js';
         // `options.depth` already existed on DirectedTunnel, T1; this factory
         // simply now forwards it + arms activeAxes).
         var depth = (opts.depth !== undefined && opts.depth !== null) ? opts.depth : null;
-        // ws-dse-3d AC3 — default 'spray' is byte-identical to every pre-existing
+        // Default 'spray' is byte-identical to every pre-existing
         // caller (this factory's own original hardcoded value below).
         var velocityProfile = opts.velocityProfile !== undefined ? opts.velocityProfile : 'spray';
 
@@ -191,7 +189,7 @@ import * as SustainedSource from '../objects/sustainedSource.js';
         if (depth !== null) { tunnelOpts.depth = depth; tunnelOpts.z = -depth / 2; }
         var tunnel = new DirectedTunnel(universe, tunnelOpts);
 
-        // ws-dse-3d (CEO ruling 2026-07-14, "one source surface"): the recurring
+        // One source surface: the recurring
         // burst injector now routes through `sustainedSource.js`'s ONE
         // `buildSustainedSource` authority — the SAME surface
         // `setupLightSourceLab.js` (via `LightSource`'s own opt-in
@@ -199,7 +197,7 @@ import * as SustainedSource from '../objects/sustainedSource.js';
         // `entranceBias:'top'` reproduce this factory's PRE-EXISTING biased-
         // random-fan shape EXACTLY (the "uniformization visible" demo shape —
         // see the module docstring's "Biased entrance" note); `zIsotropy:true`
-        // (the default) is the 3D-SYMMETRIC EMISSION fix (ws-dse-3d, theorist §4
+        // (the default) is the 3D-SYMMETRIC EMISSION fix (§4
         // option (a)) — when `depth` is armed, every burst now ALSO draws a `vz`
         // symmetric to the `vy` spread, instead of pinning z-momentum at zero
         // forever (the tester-measured z/y=0.23 flatness root cause).
@@ -220,7 +218,7 @@ import * as SustainedSource from '../objects/sustainedSource.js';
             // FrqtlApp.setup() (FrqtlApp.js:528) auto-wires
             // the render list; today the world's own census carries them by construction.
             largeObjects: tunnel.largeObjects,
-            // CANONICAL TEARDOWN (CEO drive #2, 2026-07-14 — the reinit-
+            // CANONICAL TEARDOWN (the reinit-
             // compounding fix): `FrqtlApp.prototype.setup()` calls THIS
             // automatically before installing the NEXT setupResult. Delegates to
             // `src.dispose()` (the ONE `sustainedSource.js` teardown mechanism)

package/dist/frqtl/objects/setup/setupTunnelPointExit.js

@@ -1,7 +1,7 @@
 /* Copyright 2023-2026 by Essam Abadir */
 
 /**
- * setupTunnelPointExit — the TUNNEL POINT-EXIT LAB (D3, CEO 2026-07-29).
+ * setupTunnelPointExit — the TUNNEL POINT-EXIT LAB (D3).
  *
  * ── Layer 1: API contract ────────────────────────────────────────────────────
  *

package/dist/frqtl/objects/setup/setupWaveInterference.js

@@ -26,8 +26,7 @@ import { CollisionTypes } from '../../parts/CollisionTypes.js';
      * Builds two {@link PointSource} emitters separated by `sourceSeparation`, each
      * firing 1px/tick leaf Frames radially, plus two visual-only source circles.
      * The fringe pattern is EMERGENT — no wave equation; it appears where the two
-     * particle streams overlap. (Figure + the knob sweep:
-     * `docs/internal/records/physics-lab/2026-06-16-wave-interference-wavelengthScale.md`.)
+     * particle streams overlap.
      *
      * Two independent "wavelength" knobs — keep them distinct:
      *  - `options.fundamentalWaveLength` → each emitter's `opts.wavelength` → particle
@@ -51,14 +50,14 @@ import { CollisionTypes } from '../../parts/CollisionTypes.js';
      * @param {number} [options.sourceDiameter] - Source circle diameter (default = wavelength).
      * @param {number} [options.quantumLimit] - Max quanta emitted per angle (default: velocity);
      *   the steady-state density ceiling.
-     * @param {number} [options.depth] - WS-DSE-3D Bite B0: total z-extent for a 3D run. OMITTED
+     * @param {number} [options.depth] - total z-extent for a 3D run. OMITTED
      *   (default) → today's 2D behavior, byte-identical (no `activeAxes`/z key touched at all).
      *   When provided: `universe.init()` gains `activeAxes:{x:true,y:true,z:true}` (mirrors
      *   `setupParticleWalk3D`) and BOTH PointSources emit with a uniform z-spread centered on
      *   z=0 (`zMin=-depth/2, zDepth=depth`) — every z-slice sees the same radial illumination,
      *   so the emergent fringe pattern is genuinely 3D rather than a dark volume around one
      *   lit plane (design §2.3/§4.4). This is the SAME emitter option `SlitLightSource`
-     *   consumes (WS-DSE-3D Bite B1) — the z-spread lives in `PointSource`/
+     *   consumes — the z-spread lives in `PointSource`/
      *   `emitterProgram.js`, not here, precisely so both experiments share it.
      * @returns {Object} `{ sources:{source1,source2}, source1Circle, source2Circle,
      *   fundamentalDimension, desiredWaveLength, largeObjects }`.
@@ -84,7 +83,7 @@ import { CollisionTypes } from '../../parts/CollisionTypes.js';
         var fundamentalDimension = options.fundamentalDimension !== undefined ? options.fundamentalDimension : 2;
         var desiredWaveLength = options.fundamentalWaveLength !== undefined ? options.fundamentalWaveLength : 32;
         var wavelengthScale = options.wavelengthScale !== undefined ? options.wavelengthScale : 8;
-        // WS-DSE-3D Bite B0: opt-in 3D depth. undefined/null → 2D, byte-identical.
+        // Opt-in 3D depth. undefined/null → 2D, byte-identical.
         var depth = (options.depth !== undefined && options.depth !== null) ? options.depth : null;
 
         // Init universe: ground-up, brownianMotion:false (the wave-walk). activeAxes is ONLY

package/dist/frqtl/objects/v1-replacements.js

@@ -5,7 +5,6 @@
  * unknown-kind throw TELLS the author what to build instead of leaving them to guess. A LEAF (no
  * imports): ObjectFactory reads it for its unknown-kind refusals, SlitLightSource for its own, and
  * the sketch rule (lib/frqtl/scenes/test/_sketch-rule.mjs) reads the names from here.
- * Rulings: docs/internal/engine/V2_PARTS_CLASSIFICATION.md §4.3/§4.4.
  */
 
 export const V1_REPLACEMENTS = Object.freeze({

package/dist/frqtl/parts/CameraControls.js

@@ -2,7 +2,7 @@
 
 /**
  * CameraControls.js — a REUSABLE first-person-game-style camera-controls sugar
- * object (ws-emitter-wave Bite 3B, CEO 2026-07-20). ANY 3D experiment page drops
+ * object. ANY 3D experiment page drops
  * it in with ONE call; it drives the existing `runner.cameraControl` capability
  * (the camera-as-sugar / BYO-renderer pattern — `getCameraControl()` →
  * `look({spin,pitch})` ROTATES, `move({forward,strafe})` TRANSLATES) with two
@@ -82,7 +82,7 @@
  *   all methods safe) is returned — every caller, including an unconditional
  *   walkthrough-rung attach, is right in 2D by construction.
  *
- * ── Input mapping — the STANDARD FPS SPLIT (CEO-ruled 2026-07-26/07-28) ──────
+ * ── Input mapping — the STANDARD FPS SPLIT ───────────────────────────────────
  *   The two pads are the two halves of a first-person camera and they do NOT
  *   overlap: LOOK rotates, MOVE translates. MOVE never rotates.
  *     LOOK pad (bottom-RIGHT) — ROTATION ONLY, and it is SCREEN-RELATIVE.
@@ -106,7 +106,7 @@
  *   grabbed object follows the camera because the runner carries it on the camera's
  *   own pose notice (`addPoseListener`), not because a stick is routed to it.
  *     Space       → `runner.grabToggle()` — the aim's grab/place key (STUDIO's
- *                   stationary reticle; docs/internal/engine/AIM_GRAB_FEEDBACK_CONTRACT.md).
+ *                   stationary reticle).
  *                   Ignored while typing (INPUT/TEXTAREA/SELECT/contenteditable) and
  *                   on key auto-repeat; a no-op while the runner's aim is off.
  *   A state label above the pads (`data-role="aim-state"`) reads the runner's aim
@@ -166,7 +166,7 @@ import * as OrbitBag from '../compat/renderer/orbit-bag.js';
                 '(RENDERER_CONTRACT §1a.2). (FAIL-LOUD.)');
         }
 
-        // ── IDEMPOTENT per mountEl (F4, CEO 2026-07-23) ──────────────────────
+        // ── IDEMPOTENT per mountEl (F4) ──────────────────────────────────────
         // A second attach() on the SAME container returns the LIVE instance instead of
         // stacking a second pad set + a second window keydown listener. This kills the
         // double-mount race for EVERY caller — a page that wires its own joysticks
@@ -286,7 +286,7 @@ import * as OrbitBag from '../compat/renderer/orbit-bag.js';
             var moveY = clamp(jMove.y + km.y, -1, 1);   // walk   (translation, into the picture)
 
             var o = cam.getOrbit();
-            // ── THE FPS SPLIT (CEO 2026-07-26, screen-relative 2026-07-28) ───
+            // ── THE FPS SPLIT (screen-relative) ──────────────────────────────
             // LOOK = rotation ONLY, and the widget COMPOSES NOTHING: it hands the
             //        provider a screen-relative DELTA (spin about the view axis,
             //        pitch about screen-right) and the ONE camera authority does

package/dist/frqtl/parts/CameraPath.js

@@ -1,7 +1,7 @@
 /* Copyright 2023-2026 by Essam Abadir */
 
 /**
- * CameraPath.js — a declarative, REPRODUCIBLE camera path (CEO-ratified 2026-07-30).
+ * CameraPath.js — a declarative, REPRODUCIBLE camera path.
  *
  * ONE object for both modes. It drives `runner.cameraControl` — the single camera write path —
  * with ABSOLUTE poses derived from waypoints, so the same waypoints and the same tick always

package/dist/frqtl/parts/CollisionActions.js

@@ -4,9 +4,8 @@
  * CollisionActions — Canonical collision action enum for EGPT FRQTL VM.
  * Values are SCREAMING_SNAKE (the JS engine's native vocabulary).
  *
- * Canonical set — exactly what EGPTfrqtl.js lo.collide() action dispatch has.
- * Reference:docs/internal/engine/ENGINE_CONTRACT.md §2.3.
- * ACTIVE_ACTIONS = [ABSORB, COUNT, MARK, DETECT, LOG] (EGPTfrqtl.js line 987).
+ * Canonical set — exactly what the JS reference engine's lo.collide() action dispatch has.
+ * ACTIVE_ACTIONS = [ABSORB, COUNT, MARK, DETECT, LOG].
  * DO NOT add actions not present in the JS reference collide() without first
  * adding them there and updating the conformance suite (§11.3).
  *

package/dist/frqtl/parts/CollisionTypes.js

@@ -4,8 +4,7 @@
  * CollisionTypes — Canonical collision type enum for EGPT FRQTL VM.
  * Values are SCREAMING_SNAKE (the JS engine's native vocabulary).
  *
- * Canonical set — exactly what EGPTfrqtl.js lo.collide() type switch has.
- * Reference:docs/internal/engine/ENGINE_CONTRACT.md §2.2.
+ * Canonical set — exactly what the JS reference engine's lo.collide() type switch has.
  * DO NOT add types not present in the JS reference collide() without first
  * adding them there and updating the conformance suite (§11.3).
  *