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

package/dist/frqtl/compat/vendor.js

@@ -27,7 +27,7 @@
  *
  * three loads through the classic path because the vendored r128 is the UMD build only; moving it to
  * three.module.js + the jsm loaders is a change inside this file, owned by the p5 instance-mode / renderer
- * bite (unscheduled).
+ * change (unscheduled).
  *
  * Zero physics: vendors draw; nothing here reads or writes a frame.
  */
@@ -39,7 +39,7 @@ const VENDOR_DIR = new URL('../assets/vendor/', import.meta.url);
  * hook (called every frame). They are p5's contract, not FRQTL surfaces, so the page door's retired-
  * name refusal (experiments/_shared/page-door.js) installs no throwing accessor on them — it subtracts
  * this table from the census. This file is their one writer.
- * Deleter: the bite that moves p5 to instance mode (not yet scheduled; not P0c).
+ * Deleter: the change that moves p5 to instance mode (not yet scheduled; not P0c).
  */
 export const P5_GLOBAL_MODE_HOOKS = Object.freeze(['setup', 'draw']);
 

package/dist/frqtl/objects/FrqtlApp.js

@@ -24,7 +24,7 @@
  *     NO LONGER used. window.draw is no longer set.
  *   - The renderer is obtained from THE DISPLAY SLOT (compat/renderer/display-slot.js, set by
  *     the boot module, experiments/_shared/boot.js). If the slot is empty when the draw loop first fires, the app
- *     FAILS LOUD (paintBootFailure) — no silent P5Renderer fallback (Phase 1, WS-RENDERER).
+ *     FAILS LOUD (paintBootFailure) — no silent P5Renderer fallback (Phase 1).
  *   - Fixed-timestep accumulator decouples physics ticks from draw frames:
  *       tickHz:  physics ticks per second    (default: lock to drawHz → 1:1 as today)
  *       drawHz:  draw frames per second cap  (default: display refresh)
@@ -33,7 +33,7 @@
  *   - stepsPerFrame is kept as a back-compat alias: sets tickHz = drawHz * stepsPerFrame.
  *   - Spiral-of-death guard: accumulated time clamped + ticks-per-frame capped.
  *   - Determinism preserved: physics only ever advances in whole doTick() steps;
- *     the headless run.js orchestrators (no RAF, no rendering) are unaffected.
+ *     the headless run.js drivers (no RAF, no rendering) are unaffected.
  *
  * Usage (unchanged from before):
  *
@@ -242,7 +242,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
         this._declaredTicks   = new Map();
         this._setupResult  = null;
         this._sceneReplay  = null;   // retainSceneReplay(fn) — what restart() replays
-        // Design-mode signal (Bite 4b) — DEFAULT false (Run / standalone bundles /
+        // Design-mode signal — DEFAULT false (Run / standalone bundles /
         // experiment pages). When true (STUDIO authoring), the renderer DRAWS the
         // Design-only markers (a manipulable emitter's visual circle, `lo._designMarker`).
         // A render toggle at the output boundary (zero physics): it filters ONLY the
@@ -339,9 +339,9 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
     });
 
     /**
-     * runner.controlHost — THE door a scene's on-canvas chrome mounts through (CEO #136:
-     * "approve: host-owned control mount through the runner's one door; scenes stop naming DOM
-     * ids"). Read: the element a HOSTING PANE set, else the element the scene canvas is mounted
+     * runner.controlHost — THE door a scene's on-canvas chrome mounts through (host-owned
+     * control mount through the runner's one door; scenes do not name DOM
+     * ids). Read: the element a HOSTING PANE set, else the element the scene canvas is mounted
      * in (its wrapper), else null (no canvas yet — a notebook pane before its mount: the chrome
      * stays in the exposed registry only). Write: a hosting pane (STUDIO) hands an element it
      * owns ABOVE its own overlays; every chrome already mounted through the door (a knob overlay
@@ -380,7 +380,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
     };
 
     /**
-     * Toggle Design mode (Bite 4b). STUDIO calls setDesignMode(true) while authoring
+     * Toggle Design mode. STUDIO calls setDesignMode(true) while authoring
      * (MODE_DESIGN) so the manipulable emitter markers (`lo._designMarker`) render as
      * visible circles, and false during Run / Pause so they are suppressed (you see
      * the emission, not the source marker). Standalone bundles + experiment pages
@@ -393,13 +393,13 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
     };
 
     /**
-     * Effective shellRender mode for a LargeObject (Bite 5b A6) — the SINGLE
+     * Effective shellRender mode for a LargeObject — the SINGLE
      * suppression authority. Precedence:
      *   1. per-instance `lo.shellRender` (a valid 'design'|'run'|'never' string) —
      *      the live override the Inspector / a game sets via updateObjectProperty
      *      (the "red light bulb" flips a marker to 'run').
      *   2. kind default: a manipulable marker (`lo._designMarker === true`) defaults
-     *      'design' (Bite-4b: invisible during Run); every ordinary LO defaults
+     *      'design' (invisible during Run); every ordinary LO defaults
      *      'run' (always visible). This keeps every pre-existing scene byte-identical.
      * @returns {'design'|'run'|'never'}
      */
@@ -410,7 +410,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
     };
 
     /**
-     * The largeObjects VIEW passed to the renderer each frame (Bite 5b A6): each LO
+     * The largeObjects VIEW passed to the renderer each frame: each LO
      * is shown per its effective `shellRender` (see _shellRenderOf) — 'run' always,
      * 'design' only while `_designMode` is on, 'never' hidden.
      *
@@ -433,7 +433,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
         return los.filter(function (lo) { return self._isShellVisible(lo); });
     };
 
-    /** Whether a LO's shell paints in the CURRENT mode (Bite 5b A6). */
+    /** Whether a LO's shell paints in the CURRENT mode. */
     FrqtlApp.prototype._isShellVisible = function (lo) {
         var sr = this._shellRenderOf(lo);
         if (sr === 'run')   { return true; }
@@ -669,7 +669,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
     //
     // The stage vocabulary stays with its owner, `lib/shim/render/render-stages` (the shim
     // owns cross-layer vocabularies — peer of frame-data's RENDER_INTENT_KEYS); the
-    // instrument ferries it. Contract: docs/internal/engine/RENDERER_CONTRACT.md §1a.4 + §10.
+    // instrument ferries it.
 
     /**
      * runner.setSourceRef(ref) — register the experiment/rung identity for the SceneRecord.
@@ -762,7 +762,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
     };
 
     /**
-     * Add a background-image under-layer (shared backdrop helper — Phase 2, WS-RENDERER).
+     * Add a background-image under-layer (shared backdrop helper — Phase 2).
      *
      * Creates and registers a NON-COLLIDING LargeObject that the renderer draws as the
      * bottom-most layer via _layerBackdrop (under particles and large objects).
@@ -808,9 +808,8 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
 
     // ── THE DECLARED-OBJECT REGISTRY ─────────────────────────────────────────────────────────
     //
-    // CEO 2026-10-01: "From STUDIO's point of view only the declared sugar object in code (not's
-    // its sub objects) should be manipulable - so only what is proactively declared by the user
-    // should be registered."
+    // From STUDIO's point of view only the declared sugar object in code (not its sub objects)
+    // is manipulable, so only what the user proactively declares is registered.
     //
     // `declared` is the ordered list of the handles the user's DECLARING calls produced
     // (`exp.addObject`, a palette drop, a codegen replay — all three funnel through
@@ -1139,7 +1138,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
             // far away. Throw-or-apply, one call, every caller.
             value = schema.normalizeValue(fieldDef, value, kind);
 
-            // ── SphereEmitter (Bite 4b) — sugar; no engine handle ─────────────
+            // ── SphereEmitter — sugar; no engine handle ───────────────────────
             // A SphereEmitter's real state lives in the setupSphereEmitter3D control
             // closure (a host emit tick-fn), not on any engine object. Route EVERY
             // editable/adapter prop to the matching control setter via the facade's
@@ -1231,7 +1230,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
             // Mutate the JS-side wrapper object directly. The renderer reads from it
             // on the next draw frame. No engine ABI — physics is not affected.
             if (!fieldDef.engineVisible) {
-                // WS Studio Controls Realignment S4 (design §2.3.5 / CEO §4 call #7):
+                // Studio Controls Realignment S4:
                 // collision_type/actions are SUGAR-INPUT fields compiled to an
                 // op-program at REGISTRATION (actionCompiler.js) — a bare mirror-write
                 // (what every OTHER engineVisible:false prop gets) would only update
@@ -1537,7 +1536,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
     };
 
     // ── THE AIM: a stationary reticle, a center-ray hover, a SPACEBAR grab ──────────────────
-    // (docs/internal/engine/AIM_GRAB_FEEDBACK_CONTRACT.md.) The reticle sits at screen centre
+    // The reticle sits at screen centre
     // and the sticks fly the CAMERA in every state. The first visible object on the camera's
     // centre ray is GRAB-READY; SPACE grabs it; a grabbed object HOLDS its camera-relative pose
     // (position + heading) under every camera motion, so it is placed by moving the world and
@@ -1972,7 +1971,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
 
     /**
      * Uniform schema-driven mutation entry point for the live UNIVERSE singleton
-     * (WS Studio Controls Realignment S1, design §2.3.2 / gap-census #10).
+     * (Studio Controls Realignment S1, design §2.3.2 / gap-census #10).
      *
      * Mirrors `updateObjectProperty`'s throw-or-apply discipline for the ONE other
      * object every experiment page has exactly one of: the universe itself. Unlike
@@ -2126,7 +2125,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
      * A factory carrying the deleted `RATE_LIMITS` static THROWS here; pacing is
      * `runner.setRateLimits(...)` (a scene: `exp.runner.setRateLimits(...)`).
      *
-     * CANONICAL TEARDOWN (CEO drive #2, 2026-07-14 — the S4 dispose discipline,
+     * CANONICAL TEARDOWN (the S4 dispose discipline,
      * generalized to setup-level reinit): `universe.init()` (called by the world step
      * below) resets the WASM instance's physics state but does NOT
      * clear the JS-side `universe.experimentTickFunctions` array — a fact
@@ -2197,7 +2196,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
 
     /**
      * restart() — the PAGE-LEVEL restart primitive (presentation pass Item 2,
-     * CEO-ratified E-P2b): stop → replay the RETAINED scene (`retainSceneReplay` — a setup
+     * E-P2b): stop → replay the RETAINED scene (`retainSceneReplay` — a setup
      * factory's world + part steps with its ORIGINAL opts, or a sketch's `exp.build(sketch)`
      * on the same runner and canvas) → start. The scene returns to tick 0 IN-PAGE: no reload,
      * so the camera orbit, render options and any host wiring survive. The declared `restart`
@@ -2240,8 +2239,7 @@ import { paintBootFailure } from '../experiments/_shared/boot-failure.js';
      *     "which provider owns the display", written by whichever boot ran the selection.
      *
      * The bare `window._egptActiveRenderer` global this used to read is DELETED: a slot
-     * plus a global would be two truths about one fact (RENDERER_CONTRACT §9, architect
-     * finding d.1).
+     * plus a global would be two truths about one fact (RENDERER_CONTRACT §9).
      *
      * FAIL-LOUD: if neither is set when rendering is requested, this is a boot
      * configuration error — the boot must select a renderer before the draw loop starts

package/dist/frqtl/objects/ObjectFactory.js

@@ -220,8 +220,7 @@ import { V1_REPLACEMENTS } from './v1-replacements.js';
                 var msg = '[ObjectFactory] create: unknown kind "' + kind + '". Registered kinds: ' +
                     ObjectFactory.kinds().slice().sort().join(', ') + '. The ' + unregisteredKindMessage(kind) + '.';
                 if (Object.prototype.hasOwnProperty.call(V1_REPLACEMENTS, kind)) {
-                    msg += ' "' + kind + '" is a retired V1 part, not a published part — compose ' + V1_REPLACEMENTS[kind] + ' instead ' +
-                        '(docs/internal/engine/V2_PARTS_CLASSIFICATION.md).';
+                    msg += ' "' + kind + '" is a retired V1 part, not a published part — compose ' + V1_REPLACEMENTS[kind] + ' instead.';
                 }
                 throw new Error(msg + ' (FAIL-LOUD.)');
             }

package/dist/frqtl/objects/constants/WallBehaviors.js

@@ -5,7 +5,7 @@
  * vocabulary (`collisionBehavior` × `bounceDirection` × composable hooks × presets)
  * and the structured resolver that turns a wall spec into a compiled op-program.
  *
- * ── Schema-mirror discipline (architect W1(ii)/(iv) guard) ───────────────────
+ * ── Schema-mirror discipline (W1(ii)/(iv) guard) ─────────────────────────────
  * The hook table FERRIES the frozen `CollisionActions` constant set BY REFERENCE —
  * it NEVER re-types a SCREAMING_SNAKE string. The vocabulary keys ARE the enum: the
  * `Wall` descriptor's enum fields read these maps (never a hand-listed enum),
@@ -33,7 +33,7 @@ import { compileWallV2 } from '../objects/actionCompiler.js';
 
 
     // ═══════════════════════════════════════════════════════════════════════
-    // Collision LEXICON v2 (CEO 3e2016aa) — the STUDIO/palette surface and the ONLY
+    // Collision LEXICON v2 — the STUDIO/palette surface and the ONLY
     // wall vocabulary. Three ferried vocab tables + a structured resolver that
     // delegates to the ONE compiler authority (compileWallV2 in actionCompiler.js).
     // ═══════════════════════════════════════════════════════════════════════
@@ -112,12 +112,12 @@ import { compileWallV2 } from '../objects/actionCompiler.js';
             // + closest3d eject). Derived from the caller (Wall.js reads it off the rect);
             // omitted/false ⇒ the 2D path (byte-identical, SU1).
             is3D: props.is3D === true,
-            // MIRROR ruling — the TRUE slab dims (Wall reads them off the rect) so a tilted 2D
+            // MIRROR rule — the TRUE slab dims (Wall reads them off the rect) so a tilted 2D
             // reflect wall can bake the OBB-NORMAL eject (perpendicular to the drawn face) instead
             // of the beam-scattering AABB 'closest'. Omitted ⇒ the AABB eject (byte-identical, SU1).
             slabW: props.slabW,
             slabH: props.slabH,
-            // R2AX (CEO two-axis ruling 2026-07-26) — the plate's up/down tilt + z-depth,
+            // R2AX (two-axis mirror) — the plate's up/down tilt + z-depth,
             // ferried so a pitched plate compiles the 3-space reflection about SlabFace's
             // plate3.n. Omitted ⇒ byte-identical un-pitched programs (SU1).
             pitchDeg: props.pitchDeg,
@@ -130,7 +130,7 @@ import { compileWallV2 } from '../objects/actionCompiler.js';
     // ── Presets (B6) — pure CONSTRUCTION sugar expanding to the v2 descriptor fields.
     // The recipe/codegen round-trips the EXPANDED fields (never the preset name).
     //
-    // THE NAMING RULE (CEO ruling, 2026-07-31): a preset's NAME MUST ASSERT ITS BEHAVIOR.
+    // THE NAMING RULE: a preset's NAME MUST ASSERT ITS BEHAVIOR.
     // `collisionBehavior:'nothing'` (pass-through) belongs ONLY on a preset whose name SAYS
     // it passes through — `transparent-probe` is the one that earns it. A palette entry
     // labelled "Wall" that particles walk through is the same defect class as mistaking

package/dist/frqtl/objects/geometry/SlabFace.js

@@ -3,7 +3,7 @@
 /**
  * SlabFace.js — the SOLE face / OBB / convention authority for a rotated Wall slab.
  *
- * ## Why this file exists (the DRY crux — architect Gate-2 ruling, circulation §1)
+ * ## Why this file exists (the DRY crux — Gate-2, circulation §1)
  *
  * A Wall mirror's reflecting FACE is derived from its `orientationDeg` in what USED to be
  * three independent, hand-authored places, each re-writing the SAME "tall slab, y-DOWN
@@ -13,8 +13,8 @@
  *      (the drawn-tall-face reflection line);
  *   3. the engine swept-OBB narrow-phase needs the slab's rotated collision region.
  *
- * A hand-mirrored sign in ANY of the three re-creates the off-face deflection bug the CEO
- * saw when rotating a mirror (the "1A/1D" class). This module is the ONE place the
+ * A hand-mirrored sign in ANY of the three re-creates the off-face deflection bug seen
+ * when rotating a mirror (the "1A/1D" class). This module is the ONE place the
  * convention is written: `orientationDeg (+ slab aspect, z-slab) → canonical face geometry`.
  * `_buildReflectOps` reads `reflectBaseDeg` from here; `Wall.compileWallV2` reads `obb` from
  * here for the engine `region` field. The renderer consumes the RAW `orientationDeg` (the
@@ -72,7 +72,7 @@
  *     [-90,90]; 3D wall REQUIRED). ≠0 ⇒ the PITCHED result shape: `{ pitched:true, obb:null,
  *     plate3:{ n,u,v, hw,hh,hz, aabb } }` — the true 3-space plate basis; NO engine region
  *     (z-theta-only contract; the in-op guard is the narrow phase). 0/absent ⇒ byte-identical
- *     un-pitched behavior (this whole block is opt-in — CEO two-axis ruling 2026-07-26).
+ *     un-pitched behavior (this whole block is opt-in).
  *
  * ## Layer 2 — physics behavior
  * ZERO physics of its own (SU1). This is a pure geometry derivation consumed by the reflect
@@ -100,7 +100,7 @@
         var h = +spec.h;
         var o = (typeof spec.orientationDeg === 'number' && isFinite(spec.orientationDeg))
             ? spec.orientationDeg : 0;
-        // ── PITCH (two-axis mirror, CEO ruling 2026-07-26) ─────────────────────────
+        // ── PITCH (two-axis mirror) ────────────────────────────────────────────────
         // `pitchDeg` rotates the plate about its OWN in-plane LONG axis (the drawn face
         // line), tipping the face normal out of the xy-plane: positive pitch tips the
         // normal toward +z. The TRUE 3-space plate basis:
@@ -224,7 +224,7 @@
     }
 
     /**
-     * BROAD-PHASE SUPERSET (CEO/architect MIRROR ruling, 2026-07-25 — the sugar-half
+     * BROAD-PHASE SUPERSET (the MIRROR rule — the sugar-half
      * broad-phase-rect flag closed here). The engine's spatial index is an AABB broad
      * phase over the LO's registered rect (`octree.rs`); a tilted TALL slab's raw
      * un-rotated rect is NARROWER in x than the rotated slab, so a beam aimed at the

package/dist/frqtl/objects/instruments/capture-host.js

@@ -11,10 +11,10 @@
  * the ONE boundary codec, and the verification that proves the two processes are
  * talking about the SAME scene.
  *
- * Contract text: docs/internal/engine/RENDERER_CONTRACT.md §9 (the capture-host KIND) and
+ * Contract: RENDERER_CONTRACT §9 (the capture-host KIND) and
  * §10.3 (the normalized format this ferries).
  *
- * ── Why a distinct KIND and not a provider-shaped adapter (architect ruling, V3) ──
+ * ── Why a distinct KIND and not a provider-shaped adapter (V3) ──────────────────
  *
  * A `RendererProvider` adapter would have been the tempting shape: implement
  * `captureStill()` in node, forward to the browser, let the local dispatcher stamp the

package/dist/frqtl/objects/instruments/capture.js

@@ -2,12 +2,11 @@
 
 /**
  * capture.js — THE render-pipeline tap MECHANISM, as an INSTRUMENT on the primitive
- * surface (THE_MINIMAL_SIM.md §4; CEO ruling 2026-08-01, home = the primitive surface).
+ * surface (THE_MINIMAL_SIM.md §4; home = the primitive surface).
  *
  * `capture(stage)` is the ONE generic read-at-a-named-stage mechanism; `captureStill()` is
  * its last-stage CONVENIENCE; `sceneRecord()` is the run-invariant half of the normalized
  * format. All dispatch, all throw rules and ALL provenance stamping live HERE and nowhere
- * else. Contract text: docs/internal/engine/RENDERER_CONTRACT.md §1a.4 + §10.
  *
  * ── Why this is not on the host ──────────────────────────────────────────────
  *
@@ -42,7 +41,7 @@
  * `tick` and `field` are backend-independent, so a bare node process taps them with no
  * renderer at all. `composite` is different in kind: it IS the render stack's output, and
  * re-drawing it with a node raster library would show the agent a different picture than
- * the user sees (CEO ruling, V3 — a god-rays shader turns particles into A SUN, and the
+ * the user sees (V3 — a god-rays shader turns particles into A SUN, and the
  * shader is part of the experiment, not decoration). So `composite` is executed by a
  * CAPTURE HOST — a remote stage executor running the real stack in a managed headless
  * browser — attached via `attachCaptureHost()`. The KIND, its boundary codec and its
@@ -98,7 +97,7 @@ import * as FrqtlDisplay from '../../compat/renderer/display-slot.js';
     /**
      * The RASTER PATH pin — which GL backend this browser actually rasters with.
      *
-     * Measured, not assumed (`docs/internal/physics-lab/composite-determinism/`): a
+     * Measured, not assumed: a
      * `composite` still is bit-reproducible run-to-run WITHIN a pinned (machine, driver,
      * browser build) — under software SwiftShader AND under hardware ANGLE/Metal alike —
      * but the software and hardware pictures differ (0.42% of pixels raw, 1.75% with a
@@ -672,7 +671,7 @@ import * as FrqtlDisplay from '../../compat/renderer/display-slot.js';
 
     /**
      * captureStill() — the LAST-STAGE CONVENIENCE. Capturing the canvas is capturing the
-     * fully composed stack of transforms (CEO-ratified 2026-07-29).
+     * fully composed stack of transforms.
      *
      * PURE DELEGATION: it contains no capture logic, no provider call and no provenance
      * stamping of its own — it resolves the final stage name and calls the mechanism. The

package/dist/frqtl/objects/instruments/hosted-eyes.js

@@ -18,7 +18,7 @@
  * **The browser is the ENGINE ROOM, never the interface.** Nothing above this file mentions
  * a page, a selector or a screenshot: a consumer opens a handle, drives it, and reads the
  * same normalized still bags `FrqtlVision` hands out everywhere else. That is the whole
- * point of the ruling that produced this file — a raster backend that RE-DREW the scene in
+ * point of this file — a raster backend that RE-DREW the scene in
  * node would have shown the agent a different picture than the end user sees, which defeats
  * the purpose (a god-rays shader turns a bunch of particles into A SUN, and the shader is
  * part of the experiment, not decoration).
@@ -78,8 +78,7 @@
  *
  * ── The raster path is RECORDED, never assumed ───────────────────────────────
  *
- * The default launch flags select HARDWARE GL, per the measured policy
- * (`docs/internal/physics-lab/composite-determinism/`): hardware is bit-reproducible on a
+ * The default launch flags select HARDWARE GL, per the measured policy: hardware is bit-reproducible on a
  * pinned machine/driver/build, so a software default would trade V3's premise for a
  * property we measured we already have. But the flags are a REQUEST — headless chromium
  * silently falls back to SwiftShader, which is how a naive rig measures the software path
@@ -287,7 +286,7 @@ import { projectIdentity, projectBytes } from '../../../shim/project/identity.js
      * The caller's `build`/`projection` are an EXPECTATION, never a request.
      *
      * They are boot RESULTS, so a caller who states them is asserting what the source will
-     * resolve to. Agreement is silent; a disagreement THROWS naming BOTH sides — the CEO's
+     * resolve to. Agreement is silent; a disagreement THROWS naming BOTH sides — the
      * "caller forces 2D onto a 3D source" case. The one thing never allowed is the third
      * outcome: quietly running the caller's display over the source's world.
      * @private

package/dist/frqtl/objects/objects/DirectedTunnel.js

@@ -49,7 +49,7 @@
  *     false) is the SAME orthogonal axis `slitLinerScatter.js` already defines.
  *   - Unknown string — throws (FAIL-LOUD, never a silent no-op).
  *
- * ── `options.orientation` — v1 semantics (CEO-pending, dispatched; DOCUMENT LOUDLY) ──
+ * ── `options.orientation` — v1 semantics (open; DOCUMENT LOUDLY) ──────────────────────
  *
  * `orientation` (degrees) is the direction the tunnel DIRECTS TOWARDS — it drives
  * the DIRECTION machinery EXACTLY, at ANY angle, NEVER snapped:
@@ -65,7 +65,7 @@
  * nearest axis-aligned orientation" trivially resolves to X (the only axis Tube
  * can cap) for EVERY input angle. A genuine Y/Z-long BODY (a real closed breech
  * positioned at a Y or Z extreme) is NOT achievable without new Tube geometry
- * (adding `capNegY`/`capPosY`) and is explicitly OUT OF SCOPE for this bite — it
+ * (adding `capNegY`/`capPosY`) and is explicitly OUT OF SCOPE here — it
  * is sugar-layer work, not engine work, but it is a materially larger addition
  * than "opt-in default-off params," so it is deliberately deferred, not silently
  * claimed. The DIRECTION (redirect angle / exit vector / emitter velocity) is the
@@ -107,8 +107,7 @@
  * @property {Object} tube - the underlying `Tube` instance (walls/sinks/innerRect).
  * @property {Array<LargeObject>} walls - alias for `this.tube.walls`.
  * @property {Object|null} emitter - alias for `this.tube.emitter`.
- * @property {Function} applyRedirect - ALWAYS present (C1 fix, 2026-07-13,
- *   ruling_directed_tunnel_lightsource.md), regardless of the current `behavior`
+ * @property {Function} applyRedirect - ALWAYS present (C1 fix), regardless of the current `behavior`
  *   — a redirect applier is cheap to build and this lets a LIVE `updateBehavior`
  *   switch INTO 'option1' work without reconstruction. Prefer
  *   `applyRedirectIfActive(tickData)` (below) over calling this directly — it
@@ -157,7 +156,7 @@ import { CollisionTypes } from '../../parts/CollisionTypes.js';
         var hasDepth = (options.depth !== undefined && options.depth !== null);
         var depth = hasDepth ? options.depth : width; // placeholder — Tube requires interiorDepth > 0 even when zContain:false
         var zContain = hasDepth;
-        // ws-dse-3d AC2 (CEO drive #2 round-2 ruling): the SAME N1-fix-precedent
+        // The SAME N1-fix-precedent
         // gate `hasRealDepth` uses elsewhere in this file (polarSpreadRad) — stored
         // for `_applyBehaviorToWalls`'s composable-behavior branch below, which
         // threads it into `SlitLinerScatter.applyLinerScatter`'s new `hasRealDepth`
@@ -234,7 +233,7 @@ import { CollisionTypes } from '../../parts/CollisionTypes.js';
         this._topWall = this.walls.filter(function (w) { return w.name === 'TOP'; })[0];
         this._bottomWall = this.walls.filter(function (w) { return w.name === 'BOTTOM'; })[0];
 
-        // C1 FIX (architect gate, 2026-07-13): the host redirect applier is ALWAYS
+        // C1 FIX: the host redirect applier is ALWAYS
         // built (regardless of the INITIAL behavior) — mirrors the DSE-lab tunnels'
         // OWN "always collectCollided:true + always an applyRedirect fallback" design
         // (needed so a LIVE switch INTO option1 works with no reconstruction). Kept
@@ -248,7 +247,7 @@ import { CollisionTypes } from '../../parts/CollisionTypes.js';
             angleRad: orientationRad,
             spreadRad: redirectSpreadDeg * Math.PI / 180,
             speed: redirectSpeed,
-            // 3D EXTENSION (ws-dse-3d, theorist §4 option (c)): when this tunnel
+            // 3D EXTENSION (§4 option (c)): when this tunnel
             // has REAL z-containment armed (zContain, the SAME N1-fix-precedent
             // gate `hasRealDepth` uses elsewhere — never innerRect.d, always a
             // positive placeholder), mirror the azimuth spread's own magnitude
@@ -299,7 +298,7 @@ import { CollisionTypes } from '../../parts/CollisionTypes.js';
             if (topWall) { topWall.recompileActions({ collisionType: 'BOUNCE', actions: [] }); }
             if (bottomWall) { bottomWall.recompileActions({ collisionType: 'BOUNCE', actions: [] }); }
         } else if (SlitLinerScatter.BEHAVIORS.indexOf(behavior) !== -1) {
-            // ws-dse-3d AC2: hasRealDepth threads THIS tunnel's own zContain (set
+            // hasRealDepth threads THIS tunnel's own zContain (set
             // at construction, never re-derived) into the composable scatter
             // behaviors — a randomXY/symmetric switch on a real-depth tunnel now
             // scatters all 3 axes, matching option2's (native BOUNCE) own
@@ -334,7 +333,7 @@ import { CollisionTypes } from '../../parts/CollisionTypes.js';
     };
 
     /**
-     * C1 FIX (architect gate, 2026-07-13) — the redirect applier is a plain
+     * C1 FIX — the redirect applier is a plain
      * function the CALLER invokes once per tick with that tick's `tickData`
      * (directedRedirectProgram.js's own docstring explains why this can never be
      * a self-registering `experimentTickFunctions` push: it needs THIS tick's
@@ -363,8 +362,8 @@ import { CollisionTypes } from '../../parts/CollisionTypes.js';
     // that needs to enumerate the full set — never hand-typed (T3, 2026-07-13).
     DirectedTunnel.BEHAVIORS = [OPTION1, OPTION2].concat(SlitLinerScatter.BEHAVIORS);
 
-    // BEHAVIOR_META (CEO drive #2, 2026-07-14 — "option1/option2 are non-descript,
-    // I forgot what option1 does"): a DISPLAY-ONLY label/description per canonical
+    // BEHAVIOR_META (option1/option2 are non-descript names): a DISPLAY-ONLY
+    // label/description per canonical
     // `options.behavior` VALUE — the wire value ('option1'/'option2'/composable
     // name) is UNCHANGED (every existing caller — the tunnel/lightsource labs and
     // every test — keeps passing/reading the

package/dist/frqtl/objects/objects/LightSource.js

@@ -13,12 +13,12 @@
  * side-by-side `this.bulletHandle` (hand-placed) / `this.emitter` (auto-wired)
  * duality:
  *
- *   - `options.source = 'particleWalk'` (DEFAULT, I2 — the CEO's PRIMARY
+ *   - `options.source = 'particleWalk'` (DEFAULT, I2 — the PRIMARY
  *     REFERENCE source) — one or more HAND-PLACED leaf frames in the bore (the
  *     hand-placed-projectile pattern, generalized to
  *     `options.particleCount` quanta — I1's own scale-sweep validated technique
  *     for building a stochastic ensemble from IDENTICAL start conditions:
- *     `docs/internal/physics-lab/directed-tunnel-scale-sweep/sweep.cjs` places its whole
+ *     the scale sweep places its whole
  *     N-quantum population at ONE shared entrance pixel per seed and still
  *     measures genuine per-quantum variance at exit — each frame's OWN
  *     move-gate/wavelength-oscillator RNG draws diverge it from its siblings
@@ -34,13 +34,13 @@
  *     `orientation`-derived `vx/vy`). Requires `capNegX` (defaults to `true` for
  *     THIS source type — a LightSource with no wall to emit from is meaningless).
  *
- * **I2 default flip (CEO ruling, directed-tunnel composition model §3 row 2):
+ * **I2 default flip (directed-tunnel composition model §3 row 2):
  * `options.source` now DEFAULTS to `'particleWalk'`** (was `'emitter'` in T2) —
  * "the PRIMARY reference source." The one production caller
  * (the DSE-lab tunnels) always passes `source:'emitter'` explicitly, so this
  * default flip is byte-identical for every existing caller in the tree; it only
  * changes behavior for a hypothetical caller that OMITTED `source` entirely (none
- * exist yet). `docs/internal/physics-lab/directed-tunnel-scale-sweep/README.md`'s companion
+ * exist yet). The scale sweep's companion
  * source-invariance harness (I2) quantifies particleWalk vs emitter exit-ensemble
  * equivalence — the empirical justification for treating them as interchangeable
  * defaults at all.
@@ -50,20 +50,20 @@
  * ~16px length"):** `options.tunnel.width`/`options.tunnel.length` now default to
  * `8`/`16` when the caller omits them (previously REQUIRED — `DirectedTunnel`
  * itself still throws on non-positive values, so a caller could not omit them
- * before this bite). `left`/`top`/`z` remain caller-required (position is always
+ * before). `left`/`top`/`z` remain caller-required (position is always
  * scene-specific) — DIRECTLY passed through, byte-identical.
  *
  * `options.polarization` ('random'|'positive'|'negative', default 'random') —
- * "lasers are just light sources which are polarized and have smaller widths"
- * (CEO). Maps DIRECTLY onto the SAME charge vocabulary `PointSource`/
+ * lasers are light sources which are polarized and have smaller widths.
+ * Maps DIRECTLY onto the SAME charge vocabulary `PointSource`/
  * `QuantumEmitter`'s own `chargeMode` already use — no new charge concept:
  *   'random' -> null (charge draw per particle — the DEFAULT, matches every
  *     existing DSE/WI emitter's un-polarized behavior)
  *   'positive' -> 0 ('POSITIVE'), 'negative' -> 1 ('NEGATIVE') (a FIXED charge —
  *     every emitted/placed quantum gets the SAME charge: a polarized beam).
  *
- * **`LightSource.laser(universe, options)`** — the Laser preset/factory (CEO:
- * "a Laser is a LightSource preset... not a separate class" — report §4.4 point
+ * **`LightSource.laser(universe, options)`** — the Laser preset/factory (a Laser
+ * is a LightSource preset, not a separate class — report §4.4 point
  * 3: "A thin Laser wrapper is legitimately separate... mirroring
  * the fx-* factories layering thin convenience over
  * Tube.js"). A STATIC FACTORY, not a subclass: pre-fills `polarization` (default
@@ -112,7 +112,7 @@
  * @property {number|null} particleQid - DEPRECATED alias for `particleQids[0]`
  *   (see above).
  * @property {Function} applyRedirect - alias for `this.tunnel.applyRedirect`,
- *   ALWAYS present (C1 fix, 2026-07-13, ruling_directed_tunnel_lightsource.md)
+ *   ALWAYS present (C1 fix)
  *   — prefer `this.tunnel.applyRedirectIfActive(tickData)` over calling this
  *   directly (self-gates on the tunnel's current `behavior`).
  *
@@ -125,11 +125,9 @@
  * every particle-walk/Gun-bullet experiment already uses, looped). The laser's
  * "collimated, phase-locked beam" IS free (report §4.3): skipping the
  * random-direction draw means every quantum gets IDENTICAL `vx,vy`, and a fresh
- * emission is already phase-locked at `local_time=0` (theorist-established) — no
- * new mechanism. Source-invariance (I2, `docs/internal/physics-lab/directed-tunnel-scale-
- * sweep/source-invariance.cjs`): particleWalk and emitter sourcing at IDENTICAL
- * tunnel params produce statistically comparable exit-face ensembles (see that
- * script's README section for the measured numbers and the metric used).
+ * emission is already phase-locked at `local_time=0` (established) — no
+ * new mechanism. Source-invariance (I2): particleWalk and emitter sourcing at IDENTICAL
+ * tunnel params produce statistically comparable exit-face ensembles.
  */
 
 import { DirectedTunnel } from './DirectedTunnel.js';
@@ -156,9 +154,9 @@ import * as SustainedSource from './sustainedSource.js';
         this.universe = universe;
         this._schemaKind = 'LightSource';
 
-        // I2 default flip (directed-tunnel composition model §3 row 2, CEO
-        // ruling): 'particleWalk' is now the DEFAULT ("the PRIMARY reference
-        // source") — was 'emitter' in T2. The one production caller
+        // I2 default flip (directed-tunnel composition model §3 row 2):
+        // 'particleWalk' is now the DEFAULT (the PRIMARY reference
+        // source) — was 'emitter' in T2. The one production caller
         // (the DSE-lab tunnels) always passes source:'emitter' explicitly, so
         // this is byte-identical for every existing caller in the tree.
         var source = options.source !== undefined ? options.source : 'particleWalk';
@@ -234,14 +232,13 @@ import * as SustainedSource from './sustainedSource.js';
             // the emitter's own aperture placement), or at the bore's geometric
             // X-centre when open on both ends (no breech to anchor to). ALL
             // `particleCount` quanta share the SAME entrance pixel — the I1
-            // scale-sweep's own validated ensemble-building technique
-            // (docs/internal/physics-lab/directed-tunnel-scale-sweep/sweep.cjs): a shared
+            // scale-sweep's own validated ensemble-building technique: a shared
             // injection-time position does not merge same-tick frames, and each
             // leaf's OWN move-gate/wavelength-oscillator RNG draws diverge it
             // from its siblings over subsequent ticks — a genuine stochastic
             // ensemble from an identical start, not degenerate.
             //
-            // ws-dse-3d (CEO ruling 2026-07-14, "one source surface"): this burst
+            // One source surface: this burst
             // now routes through `sustainedSource.js`'s ONE `placeSourceQuanta`
             // primitive — the SAME entrance-formula/velocity-draw/z-centring code
             // `setupTunnelLab.js`'s and `setupLightSourceLab.js`'s own independently
@@ -273,8 +270,8 @@ import * as SustainedSource from './sustainedSource.js';
             this.particleHandle = this.particleHandles.length ? this.particleHandles[0] : null;
             this.particleQid = this.particleQids.length ? this.particleQids[0] : null;
 
-            // ws-dse-3d AC1 (CEO ruling, "LightSource itself should gain the
-            // sustain capability through the SAME single authority"): OPT-IN —
+            // LightSource itself has the sustain capability through the SAME
+            // single authority: OPT-IN —
             // `options.sustain` omitted (default) is byte-identical to every
             // pre-existing caller (a genuine one-shot construction, DSE Lab's own
             // usage untouched). When supplied (truthy — `true` for "use the SAME
@@ -311,8 +308,8 @@ import * as SustainedSource from './sustainedSource.js';
     };
 
     /**
-     * The Laser preset/factory (CEO: "a Laser is a LightSource preset ... not a
-     * separate class"). Pre-fills a FIXED polarization (default 'positive' — a
+     * The Laser preset/factory (a Laser is a LightSource preset, not a
+     * separate class). Pre-fills a FIXED polarization (default 'positive' — a
      * polarized beam, matching "lasers are ... polarized"), a NARROWER default
      * width (report §4.3 — collimation/geometry convenience, zero new physics),
      * and `source:'emitter'` (I2: a laser is "a collimated, phase-locked BEAM" —