diff --git a/CLAUDE-index.md b/CLAUDE-index.md
new file mode 100644
index 00000000..dbd3f29e
--- /dev/null
+++ b/CLAUDE-index.md
@@ -0,0 +1,636 @@
+# CLAUDE-index.md — where things are in CLAUDE.md
+
+Generated by `node scripts/claude-index.cjs` (never edit; on a merge conflict, run it again).
+Grep this file for a word, then read CLAUDE.md from that line (`Read CLAUDE.md offset=<line> limit=60`).
+7059 lines indexed.
+
+    1  # CLAUDE.md — theprototype.app
+
+   12  ## Architecture map
+   14  - `src/stores/` — `appStore` (UI panels + `openSceneSection(label)`/`inspectorScrollTo`
+   25  - `src/lib/peerHandler.svelte.js` — PeerConnection class; **all incoming messages**
+   35  - Open-core seams (#13 M1 + #14 PM, contract in committed `OPEN-CORE.md`): a closed
+   77  - `src/lib/triggerSync.js` (DEVX #18, the gameSync/hudSync shape — data in the leaf
+  105  - `src/lib/sim/` (36-sim, 1.22): buoyancy, jiggle, fluid tanks. ONE per-frame entry
+  128  - `src/lib/spawner.js` + `src/lib/transientObjects.js` (21-B B7): mid-sim body creation,
+  147  - `src/lib/sharedLibrary.js` + `src/lib/transferLedger.js` + `components/editors/
+  204  - `src/lib/mountedVolumes.js` (R22 round 13, a LEAF: svelte/store + idb + toast; `sessions`
+  228  - `src/lib/storageUsage.js` + `components/menu/StorageModal.svelte` (R22 round 13, a
+  246  - `src/lib/explorerView.js` (R22 round 9, a LEAF — stores + arithmetic, imports NOTHING
+  252      · THE MODE IS GLOBAL; COLUMNS AND SORT ARE PER VIEW.
+  264      · THE SORT IS APPLIED IN `gridEntries`
+  281      · R22 ROUND 11 — THE HEADER BECOMES A REAL ONE
+  290      · THE SPACER CELL, and why a resizable table needs one.
+  305  - R22 ROUND 36 — DELETED KEEPS ITS STRUCTURE
+  394  - R22 ROUND 36 (ROOMS) — THE UNNAMED WORLD IS A ROOM WITH AN IDENTITY
+  430  - `src/lib/filePreview.js` + `components/editors/FilePreviewWindow.svelte` +
+  435      · THE SIBLING LIST IS PUBLISHED, NOT DERIVED.
+  446      · PASSTHROUGH STANDS THE PANEL DOWN, NOT THE BODY
+  463      · R22 ROUND 12 — MULTIPLE WINDOWS, AND THE 3D FACE.
+  481      · R22 ROUND 13 — THE MODEL IS THE SWITCH, AND THE VIEW IS NAVIGABLE.
+  498      · R22 ROUND 15 — THE PREVIEW PLAYS ANIMATIONS
+  523      · "TYPING" IS NOT "FOCUS IS ON A CONTROL"
+  528      · R22 ROUNDS 19-28 — THE CORNER, THE HEADER, AND THE TRANSPORTS.
+  547  - `src/lib/saveAs.js` (R22 round 11) — "SAVE AS…", AND WHAT A PREFAB IS MADE OF. A prefab
+  549      · A PREFAB RECORD MAY NOW CARRY A `format` AND THE FILE'S OWN `bytes`
+  553      · THE BYTES RIDE BESIDE THE SNAPSHOT, NEVER INSTEAD OF IT.
+  571  - WINDOW CHROME, R22 ROUNDS 20/25/26/28
+  579  - ROOMS ARE CONTENT PARTITIONS (R22 round 30, the whole arc)
+  594      · THE RE-SYNC that makes the gate safe
+  604      · getgame was measured INERT and removed
+  607      · ROUND 32: THE ARRIVING REPLY HEALS
+  621      · ROUND 32: THE ASK HOLDS BOTH DIRECTIONS
+  638      · ROUND 33: THE CONNECT DECISION
+  663      · ROUND 34: A SAVE NAMES THE ROOM
+  673      · ROUND 35: PRIVATE SCENES
+  703      · THE CONNECT CONTRACT
+  727      · THE MANIFEST
+  740      · THE LIBRARY'S FIRST CONTACT
+  751  - `src/lib/objectPermissions.js` (#14, store-only) — viewer object permissions, ONLY
+  765  - `src/lib/connectionState.js` (store-only) — `sessionHost` (peer that approved OUR
+  771  - `src/components/menu/Connect.svelte` — a 3-state pill (`data-state`
+  792  - `src/lib/commandsHandler.svelte.js` — receive-side scene appliers + `sendObjects`
+  794  - Domain modules in `src/lib/`: `objectActions`, `geometries.svelte.js`,
+  822      · The mesh is a triangle soup, but the face TOPOLOGY IS STORED NOW
+ 1016      · CL-A colliders v2
+ 1043      · THE LOWER PEER ID KEEPS THE WORLD
+ 1272      · SHADER GRAPHS
+ 1351      · SH5
+ 1371      · THE HUD
+ 1384      · The anchor is the 9-GRID plus PIXEL offsets, never 0..1 fractions
+ 1390      · **GOLDEN RULE 8, the decision that matters: the authored DOCUMENT replicates
+ 1424      · 21-D — THE HUD BECOMES INTERACTIVE, AND THE GAME SHELL
+ 1492      · 21-E — GAME HARDENING
+ 1538      · E7 HUD content
+ 1553      · 21-F — LEVELS, COLLECTIBLES v2, HUD EDITOR POLISH
+ 1626      · 21-G1 — SCENES NOT LEVELS; RECIPE RE-HOMING
+ 1651      · 21-G2..G5 — PROJECTS, PER-PLAYER PROGRESS, CROSS-SCENE PRESENCE.
+ 1665      · R22 ROUND 11 CORRECTS THE "PROVEN STABLE" CLAIM
+ 1901      · SCOPE, settled after C4 shipped and worth not re-litigating:
+ 1990      · R22 round 12
+ 2004      · R22 round 11
+ 2014  - `src/modules/` — core modules (hello = the smallest complete example, button =
+ 2019      · 17-A moved piano/avatar/essentials/car/DUNGEON OUT to `theprototype-app/modules`
+ 2029  - UI: `components/menu/*` (drawers/modals; visibility via stores + `hidePanels/
+ 2104  - `tests/e2e/` — committed Playwright suites (`npm run e2e`, subset by name);
+ 2106  - Docs (2026-07-24 split): SDK authoring docs live on the PUBLIC docs site
+ 2112  - `src/lib/knock.js` + `knockMath.js` (24-A) — A HAND KNOCKS A BODY. `knockMath` is the pure
+ 2126  - `src/lib/lookPresence.js` (P2) — a peer's LOOK as PRESENCE, in the `campreview` shape:
+ 2131  - `src/lib/postGraphs.js` + `postGraphPresets.js` (P4) — a shader graph whose output IS a
+ 2136  - `src/lib/materialSharing.js` (D2) — two objects, ONE material, by id. The id is scene data
+ 2143  - `src/lib/flowPrefs.js` (114) — the node editor's mouse bindings as a LOCAL pref leaf
+ 2146  - `docking.js` (81.4) — an edge holds TWO stacked panels: `docked` is
+ 2150  - `meshEdit.js` (F1/F3) — a proportional drag ends in ONE whole-geometry `meshgeo` commit
+ 2157  - THE VOCABULARY (roadmap 22 R4, locked):
+ 2160      · room
+ 2162  - `src/lib/sceneRename.js` (R22 R5, a LEAF, imports nothing): `manifest.renames = {from:{to,at}}`
+ 2181  - `peerScenes.peersAtScene(map, scene, mine, host)` (R22 R4) — the per-scene session roster,
+ 2188  - `src/lib/sceneLoader.js` (33 L1, a LEAF: svelte/store only) — A SCENE LOAD MAY TAKE TIME; IT
+ 2220      · The autosave writes pristine kit pieces as STUBS
+ 2229  - `src/lib/flowLayout.js` + `src/lib/coalesce.js` (R29 S1/S2, both LEAVES, vitest-covered):
+ 2235  - `scripts/templates/` — ONE FILE PER TEMPLATE (34 R4 A3).
+ 2241  - `scripts/author-templates.cjs` (21-C C6-b): a `MODULE_DEFS` LOADER region (now in `templates/index.cjs`; …
+ 2253  - `playMode.js` `embedMode` / `embedSceneId` / `embedOpenUrl()` (R29 fork 4): the additive
+ 2261  - ROADMAP 30 — EDIT / INTERACT, AND THE SELECTION THAT FINDS THINGS
+ 2277      · THE POINTER-CAPTURE THROW (P0)
+ 2283      · SELECT-THROUGH
+ 2292      · MODULE CONTENT IN THE OBJECT LIST
+ 2304  - ROADMAP 30 — GAMES START ON START
+ 2316      · FREE-CURSOR GAMES
+ 2325      · STORAGE
+ 2332      · CONSOLE HYGIENE
+ 2337  - ROADMAP 30 — THE AUTHOR KIT
+ 2357  - ROADMAP 30b — THE QUEST ROUND (games in a headset)
+ 2395  - ROADMAP 30c — THE MESHY ASSET ROUND
+ 2408  - ROADMAP 31 — TOWERS BECOMES A GAME
+ 2437  - ROADMAP 31 — THE SECOND QUEST ROUND
+ 2469      · 34 R5:
+ 2474      · 34 PF/R1 — `src/lib/perf/`
+ 2481      · 36 (1.21) — export, touch, loading, theme tokens.
+ 2498  - ROADMAP 33 — MODULES ACROSS A SCENE SWITCH (33-scene-switch, L2/L3/L4)
+ 2542  - ROADMAP 33 — LOD GROUPS (33-lod-editor, contract P1)
+ 2557  - ROADMAP 33 — FUNCTIONAL PACK ITEMS (33-anim-core, contract P2)
+ 2558      · NOTHING AUTOPLAYS
+ 2568      · `animRef` (33-scenes)
+ 2570  - ROADMAP 33 — KIT INSTANCING (33-scenes)
+ 2579  - ROADMAP 34 — THE GAME KIT, part 1 (34-kit-core, contract T3)
+ 2605  - ROADMAP 34 R3 — BEHAVIOURS, code-first game logic with a DERIVED live node view (34-behaviours, D1+D2)
+ 2638  - ROADMAP 33 — EDITOR UI + GAMES (33-editor-ui, 33-games, 33-untangle-core)
+
+ 2652  ## UI design system (redesign epic)
+ 2654  - All UI follows the redesign spec kept in the `cloud` repo: `docs/design/redesign/SPEC.md`
+ 2657  - Build UI only from `src/components/ui` primitives (WindowChrome, Tabs, Segmented, Chips,
+ 2660  - Colours, radii, spacing and type come from the semantic tokens in `app.css` only — no raw
+ 2662  - Every icon goes through `ui/Icon.svelte` (sizes 16 or 20 only; custom glyphs as `tool:<name>`; enforced by …
+ 2663  - A redesign change must not alter behaviour: DragRow scrubbing, modifiers, click-to-type,
+
+ 2667  ## Replication golden rules
+
+ 2759  ## Hard-won gotchas (do not rediscover)
+ 2761  - RAPIER'S KinematicCharacterController COLLIDES WITH SENSORS unless the query passes `EXCLUDE_SENSORS`
+ 2765  - HEADLESS GPU SCREENSHOTS ON THIS MACHINE (ANGLE/Vulkan, RADV) CAN MISS TEXTURED KIT MESHES
+ 2768  - A LEVEL WITH NO DYNAMIC BODY STARTS NO SIMULATION, so its walker collides with nothing
+ 2770  - A sliced load changes what "right after" means.
+ 2773  - A two-page "in phase" check must compare CLOCKS, not poses
+ 2776  - A HEADSET'S EYE BUFFER IS NEVER LOWERED
+ 2780  - AN INSTALLED USER MODULE NEVER UPDATES ITSELF.
+ 2784  - A VITE STARTED INSIDE `e2e-slot` INHERITS FDS 8/9 AND HOLDS BOTH MACHINE-WIDE E2E LOCKS
+ 2787  - A LEGACY-MODE TEMPLATE CALL `fn(x)` IS UNTRACKED BEYOND ITS ARGUMENTS
+ 2790  - A `$state` (deep) PROXY OVER THREE OBJECTS IS A PER-FRAME COST
+ 2793  - `a ?? b + '/'` IS `a ?? (b + '/')`
+ 2796  - **HELPER_LAYER MUST NEVER BE 1 OR 2: three's WebXRManager gives the LEFT eye layer 1 and the
+ 2800  - three's `Euler.toArray()` IS `[x, y, z, 'XYZ']`
+ 2804  - A BLANKET SHAPE RENAME HITS EVERY KEY OF THAT SHAPE.
+ 2808  - A rapier collider with no body is FIXED AND SOLID.
+ 2813  - A THIRD SOFTWARE-GL PAGE BOOTS PAST setupPage's 30 s ON THE 1.17 UNION
+ 2818  - An ADDITIVE burst vanishes against a bright sky
+ 2821  - A module effect/click on a Quest cannot rely on the DOM HUD
+ 2824  - Known, not fixed (30c pack lanes):
+ 2828  - `TubeGeometry` HANDED A 2D `Shape` BUILDS EVERY VERTEX AS NaN
+ 2833  - A rAF TIMESTAMP IS THE FRAME'S START, WHICH CAN PRECEDE THE CALL THAT SCHEDULED IT.
+ 2838  - A HUD TEXT BOX IS A FLEX ROW, SO `text-align` ALONE NEVER CENTRED A SINGLE LINE.
+ 2842  - A perRound LATCH READS UN-SET THE INSTANT THE ROUND ENDS
+ 2845  - PARTICLE EMITTERS ARE COUNTED PER PAIR
+ 2848  - `--use-angle=gl` IS SWIFTSHADER ON LINUX.
+ 2851  - **EVERY TOP-LEVEL OBJECT IN objectsGroup BECOMES A FIXED PHYSICS BODY, and a decoration GROUP's
+ 2854  - DESKTOP PLAY SPAWNS AT Scene.svelte's FIXED `<Player position={[0, 2, 3]}>`
+ 2856  - THE EDITOR GRID DRAWS AT y = 0
+ 2859  - A FLAT GROUND DISC ENDS IN A BAND, NOT A HORIZON
+ 2862  - THREE LANES NUMBERING ONE LIST FROM THE SAME BASE COLLIDE.
+ 2865  - jsDelivr PARSES `@v2` AS A SEMVER VERSION, AND A VERSION IS NEVER RE-RESOLVED.
+ 2874      · 29f CLOSED IT BY MEASUREMENT
+ 2888  - A jsDelivr BRANCH ref is `max-age=604800` IN THE BROWSER
+ 2895  - flowbite-svelte's `Button` FREEZES its class string at mount.
+ 2904  - An INVALIDATION KEY must name the thing whose change should invalidate.
+ 2910  - TWO LANES CAN EACH BE CORRECT AND COMPOSE WRONG — the enumerated-roots edition.
+ 2918  - A guard that saves INTO a store the guarded action then WIPES is a lie.
+ 2926  - A movement keydown guard must include ALT.
+ 2931  - e2e: the runner kills a suite at 8 minutes
+ 2940  - SessionsManager test hooks
+ 2948  - Vite watches `tests/`
+ 2954  - **A mount SAVE is several awaits long, so an edit made DURING one is not in the bytes
+ 2959  - ConfirmModal RESTORES FOCUS AFTER the thing you open next mounts.
+ 2964  - A SUITE THAT PASSES WITH SECONDS OF HEADROOM AGAINST THE 480s RUNNER CAP IS A COIN.
+ 2968  - CONSENT MUST BE RECORDED BEFORE THE WRITE THAT PUBLISHES IT.
+ 2974  - **A HASH IN `currentLevel` MEANS "THESE ARE THE BYTES I LOADED", and adoption must not
+ 2982  - A RE-SYNC REQUEST IS NOT A JOIN, and the receiver cannot tell unless it is told.
+ 2988  - FORK 3'S CARRY SEMANTICS MAKE A PULLED gameState ALWAYS LOSE.
+ 2994  - **WHEN A FLEX ROW OVERFLOWS, WHAT FALLS OFF THE END IS WHATEVER IS LAST IN THE MARKUP —
+ 3005  - A GROUPED WINDOW IS PLACED BY ITS GROUP, AND `dragWindow` HAS TO BE TOLD.
+ 3020  - ZERO IS NOT A WIDTH.
+ 3025  - A TAB GROUP'S MINIMUM IS THE WORST CASE ACROSS ITS MEMBERS, not a constant.
+ 3032  - A GATE THAT DISABLES THE GESTURE THAT WOULD UNDO ITS OWN STATE STRANDS THE USER.
+ 3038  - **A COUNTER THAT GAINS A DIGIT MOVES EVERYTHING AFTER IT, and `tabular-nums` alone does
+ 3045  - **A FRAME -> SECONDS -> FRAME ROUND TRIP IS NOT THE IDENTITY, and the first casualty is
+ 3056  - **DUPLICATE DOM ids ACROSS COMPONENT INSTANCES ARE HARMLESS UNTIL A `<label for>` MEETS
+ 3066  - **A FUNCTION CALLED SYNCHRONOUSLY INSIDE AN `$effect` REGISTERS ITS READS AS
+ 3076  - A CANVAS ELEMENT OUTLIVES ITS CONTEXT, so checking the element proves nothing.
+ 3080  - **`opacity` ON AN ANCESTOR APPLIES TO ITS WHOLE SUBTREE AND CANNOT BE UNDONE LOWER
+ 3088  - FADING A CHILD AGAINST ITS OWN OPAQUE PARENT CAN ONLY DARKEN IT.
+ 3096  - CLICK-THROUGH AND FADING ARE THE SAME MISTAKE TWICE
+ 3101  - A SVELTE ACTION WITH NO PARAMETER NEVER HAS ITS `update` CALLED
+ 3109  - A CLICK ON A BUTTON IS NOT A CLICK ON THE ROW.
+ 3115  - **A DIALOG LEFT OPEN SHIELDS EVERY LATER CLICK, and moving a panel INTO a dialog makes
+ 3122  - A NON-MODAL `<dialog>` CARRIES NO `role` ATTRIBUTE.
+ 3127  - **REPLICATION BOOKKEEPING IS NOT CONTENT, AND A CONTENT SIGNATURE THAT INCLUDES IT
+ 3140  - A CHECK CANNOT SEE A LEAK THE FIXTURE DOES NOT CONTAIN.
+ 3148  - **`table-layout: fixed` SHARES THE SURPLUS OUT, so a column drag is undone by the
+ 3155  - CLICK-THROUGH MUST STAND THE PANEL DOWN, NOT ITS BODY.
+ 3163  - A SVELTE ACTION WITH NO PARAMETER NEVER HAS ITS `update` CALLED.
+ 3169  - `Number(v) || 1` READS A SLIDER DRAGGED TO ZERO AS "no value".
+ 3173  - THE OFFSCREEN THUMBNAIL RITUAL HAS TWO SILENT FAILURE MODES, AND ONE OF THEM IS REAL.
+ 3186  - **`addItemFromBytes` IS CONTENT-HASH ADDRESSED, so a fixture that seeds the same bytes
+ 3190  - A DOUBLE-CLICK ON A TREE ROW ALSO FIRES TWO CLICKS.
+ 3194  - A WINDOW MADE TALLER PUSHES ITS OWN CONTROLS UNDER THE Controls HUD.
+ 3199  - EVERY SOURCE FILE IN THIS REPO IS CRLF, AND `cat -A` WILL LIE IF YOU POST-PROCESS IT.
+ 3207  - **AN INVALID ICE SERVER DOES NOT DEGRADE — IT THROWS, AND TAKES ALL CONNECTIVITY WITH
+ 3216  - A REGRESSION CAN BE A LATENT DEFECT FINALLY REACHING THE LIGHT.
+ 3223  - A DRAG PAYLOAD CAN CARRY MORE THAN THE DROP READS.
+ 3228  - `absolute inset-0` INSIDE A SCROLLER PINS TO THE CONTENT, NOT THE VIEWPORT.
+ 3236  - A CLASS WITH NO CSS CAN STILL BE LOAD-BEARING.
+ 3244  - A `$derived` can track the wrong store and look perfect.
+ 3252  - A HOSTNAME SNIFF BEAT `.env`, and no suite could see it.
+ 3260  - An owner stamp can be EMPTY, and reading it as a peer names nobody.
+ 3265  - **`ContextMenu` documents `checked?` and `ContextMenuItems` renders it as BOLD + a tinted
+ 3273  - A build-time env var is inlined into whatever the dev server serves
+ 3276  - A modal left open is a full-viewport click shield
+ 3280  - A batch-scoped aggregate is the only honest progress percentage.
+ 3282  - THE PALETTE HAS A RULE NOW, and it is two halves.
+ 3295  - A PORT CAN BE SHADOWED BY A LANE THAT DID NOT ASK FOR IT.
+ 3303  - KILLING A BACKGROUND `npm run dev` DOES NOT KILL VITE.
+ 3308  - A CHECK THAT PINS A LITERAL PINS A SECOND, SILENT PREMISE.
+ 3316  - A MODULE THAT COUNTS ON A STAMP EDGE MUST HAVE ITS OWN FIRST-SIGHT RULE.
+ 3324  - A SURFACE WHOSE OWN DOCS PROMISE AN API THAT DOES NOT EXIST.
+ 3331  - KILLING THE npm TASK DOES NOT KILL VITE.
+ 3338  - A CHECK CANNOT DRIVE A UI THAT ONLY EXISTS FOR REAL RECORDS.
+ 3345  - A NEW NODE TYPE HAS TWO REGISTRIES, AND ONLY ONE COMPLAINS.
+ 3352  - A field that HAND-LISTS what it sends will drop the next field somebody adds.
+ 3357  - A helper that reads stores with `get()` registers NO svelte dependency.
+ 3362  - **A per-camera or per-viewpoint feature does nothing until that viewpoint is ACTIVE,
+ 3368  - Never run `npm run build` while the lane's `vite dev` watches the same worktree
+ 3371  - TWO PLAY PRESSES INSIDE THE SIM'S START-UP WINDOW START TWO SIMULATORS.
+ 3389  - **A HELD body's `lastWritten` is stale by definition, so every release must
+ 3398  - **A warm-up that counts COMPOSER frames deadlocks the moment a direct render
+ 3404  - **`flowGraphs` and `flowNodes` are mirrored BOTH ways, so a writer that sets
+ 3410  - An edge id that is not the canonical shape does not survive a reconcile.
+ 3414  - **An action node must resolve its TARGET before it touches the rising-edge
+ 3418  - **A physics write with no simulation running is a silent no-op, and silence
+ 3424  - The Object Selector had no OUTPUT handle for 200 phases.
+ 3433  - A named socket needs a LABELLED ROW, not a computed offset.
+ 3439  - `GLTFExporter` OPTIONS ARE THE FOURTH ARGUMENT OF `parse()`, NOT THE CONSTRUCTOR
+ 3449  - A fresh trigger-edge action node ADOPTS a stale stamp and fires on creation.
+ 3457  - A count cannot converge for a late joiner; a stamp can.
+ 3463  - Two lanes can each be correct and compose wrong.
+ 3468  - A registry that renders {#each} rows must assert key uniqueness over itself.
+ 3473  - **`/create box` re-seats the object after the call returns AND stamps
+ 3477  - A peer cannot approve a connection request while in play mode
+ 3479  - **THE DEBUG HOOK IS ONE TABLE (34 R4 A2): `src/lib/debugHooks.js`, one row per hook,
+ 3488  - A derived cutoff consulted on both the READ and the MUTATE side needs TWO rules.
+ 3495  - Never source a Delay from a node whose consumption DELETES the log entry.
+ 3501  - **A stamp minted between a node's arrival on a peer and that peer's NEXT TICK is
+ 3509  - A layout artboard full of TEXT needs `user-select: none`.
+ 3515  - **A canvas `fillStyle` cannot take a `var()` chain, so a colour rule split between
+ 3521  - **`h.connect(from, to)` dials FROM the first arg — and a connected peer's pill has no
+ 3524  - `setvariable` `add` is a per-peer read-modify-write
+ 3529  - A LATCH guarding an idempotent call must be set on SUCCESS, never on intent.
+ 3536  - A reference field must accept a NAME as well as an id.
+ 3542  - `interactive` stops meaning "fires a press" the moment inputs exist.
+ 3547  - **A suite that compares an editor against its RUNTIME breaks when the runtime is
+ 3553  - A history KIND handler reads its direction by IDENTITY, not from a flag.
+ 3562  - **A `$derived` cannot see a `get()`, and the comma-operator workaround fails
+ 3571  - A child measured FROM its parent must not be able to size that parent.
+ 3580  - `isLocked` is a THREE-state store, not a boolean
+ 3585  - **`NodeWrapper`'s `ACCENTS` map is keyed by GROUP NAME, so a new palette group is
+ 3589  - `flowNodes.set()` / `flowEdges.set()` do NOT broadcast.
+ 3594  - **`setNodeData` is not throttled, but its write chain is heavy enough to look like it
+ 3598  - `saveSnapshot` REFUSES to write an empty snapshot
+ 3602  - **(historical) The debug hook's `Promise.all` array order had to match its destructure
+ 3607  - `renderer.toneMapping` NEVER REACHES A COMPOSED FRAME.
+ 3620  - **A registration seam whose `register()` re-applies SYNCHRONOUSLY must sit BELOW
+ 3626  - An asset that arrives LATER needs a WATCH, not a rebuild.
+ 3635  - `LookupTexture.from` tests `image instanceof Image`
+ 3638  - A leftover portaled ThemedSelect popup can COVER the thing under test.
+ 3644  - A `ThemedSelect` cannot shrink below its longest option
+ 3652  - **Never run `npm run build` while the lane's `vite dev` is watching the same
+ 3655  - In a FLEX container every element child is its own flex item, on its own line.
+ 3661  - Placing chrome by a width BREAKPOINT is a guess; measure the neighbour instead.
+ 3670  - A gizmo seated by the CLICK path is not seated by a new selection path.
+ 3674  - `edgeKey` takes two welded VERTEX KEYS, not two positions
+ 3678  - `faceEditObject`, `editingObject` and `sculptObject` all hold a UUID STRING
+ 3681  - A hook that READS state must know the caller's write ORDER.
+ 3690  - An "immediately visible" edit belongs at the CHOKE POINT, not per control.
+ 3696  - A CACHED "starting pose" must notice the object moved under it.
+ 3706  - A relative-value system needs the INVERSE at every write.
+ 3711  - A per-frame hot path cannot afford a find-then-scan.
+ 3717  - A minimum-size CLICK target is not a fix if nobody can find it.
+ 3722  - An overlay that coincides with the real thing is not an overlay.
+ 3732  - `node.material = x` gated on isMesh/isLine/isPoints misses Sprites
+ 3736  - Poking a store does not help a `$derived` that returns the same object.
+ 3743  - **A number that keeps COUNTING must be folded before anything reads it as a
+ 3752  - **A per-frame map REBUILT from the active set silently deletes everything that
+ 3758  - A "make it visible" default can be out of RANGE.
+ 3765  - `emissiveIntensity` is a MULTIPLIER on the emissive COLOUR
+ 3771  - **A PROP READ INSIDE AN `$effect` RE-RUNS IT ON EVERY PARENT RENDER, and for a
+ 3781  - AN INCOMPLETE `node_modules` MOVES THE svelte-check BASELINE AND KILLS THE APP.
+ 3787  - A NAME-BASED MIGRATION MUST BE WRITER-ONLY.
+ 3796  - A GATE ON BYTES IS NOT A GATE ON THE DOCUMENT.
+ 3802  - A SUITE SECTION THAT SAVES OR ADDS OBJECTS PERTURBS ITS NEIGHBOURS.
+ 3808  - MEASURE THE LIMIT BEFORE BUILDING THE WORKAROUND.
+ 3815  - One cap can hide another.
+ 3820  - A uniform's VALUE must be runtime-ready, not the authored form.
+ 3825  - three's varyings are CONDITIONAL, so a generated shader must ask for them.
+ 3830  - The FIRST render after installing a material is where three builds its program
+ 3833  - **`palette.js` derives each object's colour from its uuid, so any pixel threshold
+ 3840  - Two things a planned optimisation was FOR can already be true.
+ 3849  - A CACHE that nothing pokes is invisible to every derived.
+ 3854  - **A RESTORE that leaves the SOURCE in place is undone by the thing that reconciles
+ 3862  - A fallback belongs in the REGISTRY, not in the disable path.
+ 3868  - **A RAW NUL byte in a source file makes it BINARY to every text tool, and msys hides
+ 3877  - A MULTI-OUTPUT node cannot be typed by the output that happens to be read first.
+ 3882  - A stage-specific value that EXISTS in the other stage fails silently.
+ 3888  - A sampler with nothing in it is BLACK, not neutral.
+ 3893  - A plain Map read gives a `$derived` no signal.
+ 3897  - A feature with no ENTRY POINT is invisible to a suite that supplies its own.
+ 3902  - xyflow dereferences `node.position` while adopting nodes
+ 3906  - A latest-wins stamp must be MONOTONIC per key.
+ 3911  - A document can arrive BEFORE the object it targets.
+ 3916  - `ObjectLoader` cannot rebuild a `WireframeGeometry`
+ 3921  - **An SVG sibling drawn AFTER your hit target steals the press, and bubbling
+ 3928  - A crash on mount is invisible to a suite that only reads STORES.
+ 3936  - A SYNTHETIC event does not travel the path a real one does.
+ 3943  - Re-identifying moved items by their VALUE after a sort is not tracking them.
+ 3951  - A window derived from the two ends you are writing feeds back on itself.
+ 3956  - A value axis derived from the data cannot be live while you drag the data.
+ 3961  - A parked playhead must not be read through the loop wrap.
+ 3965  - Whatever else changes the current clip must move the TRANSPORT too.
+ 3970  - A "length" field that silently retimes is a bug, not a convenience.
+ 3974  - A modal move needs a way out.
+ 3980  - A menu opens on the button RELEASE, and `contextmenu` is dispatched AFTER mouseup
+ 3989  - An overlay handle drawn AFTER the thing it belongs to steals its press.
+ 3995  - A pair of editors on the same numbers must agree on their RANGES.
+ 3999  - A LOOP WRAP inverts an interval test.
+ 4008  - A resize grip capped by a CONSTANT escapes a short pane.
+ 4013  - `updateKey` only PATCHES a key that exists; `addKey` is what inserts.
+ 4019  - A brief keystroke cannot be caught by a settled store read.
+ 4024  - Counting the undo stack is not a safe way to assert "one entry per gesture"
+ 4028  - Any op that turns a SCREEN gesture into geometry has two traps.
+ 4034  - Splitting a triangle: WALK THE BOUNDARY to pair the remaining polygon.
+ 4040  - Classifying a straddling triangle by its CENTROID is not clipping.
+ 4046  - `Scene.svelte` is `lang="ts"`
+ 4049  - BEVEL means three different operations, and only one of them is cheap.
+ 4060  - `commitMeshGeoSnapshot` is POSITIONS-ONLY.
+ 4064  - A geometric assertion has to measure the part that MOVES.
+ 4070  - A helper that indexes SESSION state cannot be reused outside that session.
+ 4079  - A CONSTRAINED gizmo drag must re-seat the proxy when it ends.
+ 4084  - An editor HANDLE that lives in world space needs a SCREEN-space size.
+ 4096  - The gizmo is ONE control, so its prefs belong to the session, not to a mode.
+ 4104  - A BRIDGE's walls face inward or outward depending on what the tunnel IS.
+ 4112  - `highlightFaceByTriangle` heals a stale selection by CLEARING it
+ 4119  - State attached to a geometry must survive the LIVE PREVIEW, not just the commit.
+ 4128  - A guard whose adversarial case isn't adversarial proves nothing.
+ 4136  - PERSISTENCE has the same GLTF hole the wire had, and it hides better.
+ 4147  - Measure a rotation from the CENTROID, never the bounding-box centre.
+ 4153  - A HANDLE that wins the press will win a test's press too.
+ 4159  - **A ROTATION guard needs an angle; every invariant a rotation preserves is also
+ 4168  - **A RELATIVE check cannot see a stale selection: it reads through the same stale
+ 4174  - **A grip for a synthesized gesture must be a point that EXISTS, and its pixel must
+ 4182  - A capability gate copied from the WRITE path silently disables READ.
+ 4189  - Texture sampler state is NOT part of a texture swap.
+ 4200  - threlte's context stores are READ-ONLY now
+ 4211  - **A document-level `pointerlockchange` listener must ignore locks it does not
+ 4217  - **An async `on:change`/`on:click` must capture `e.currentTarget` BEFORE
+ 4220  - Backticks inside a double-quoted bash string are COMMAND SUBSTITUTION
+ 4224  - **flowbite `Button disabled` styling can go stale until the component
+ 4231  - #14 file-shape traps
+ 4252  - Connection "connected" state = `$peers.openedPeers`, NOT `userdata.length`
+ 4257  - A fixed overlay anchored under the Connect pill can't use a `position:fixed`
+ 4263  - Headless e2e can't reach a signaling server (peer.open stays false, `peer.connect`
+ 4266  - Svelte 5.5x runes-mode: a MULTI-CODE `svelte-ignore` comment only honors the FIRST
+ 4272  - Svelte 5 forbids mixing `on:click` and `onclick` **per component** — match the file's
+ 4279  - a11y warnings count against the baseline too. A `<div>` you make keyboard-focusable
+ 4287  - Editing svelte files by exact-match is whitespace-sensitive; the files use TABS.
+ 4291  - Module-level `store.subscribe(cb)` runs cb SYNCHRONOUSLY at module eval — any
+ 4301  - svelte-awesome-color-picker 4.x (runes rewrite, #15-C)
+ 4309  - Toasts (#15-L/P)
+ 4319  - PWA (#15-N)
+ 4327  - **A component's scoped `<style>` is UNLAYERED, so it beats EVERY Tailwind
+ 4336  - **`@apply`-built utilities are compiled onto the CLASS, so the theme remap never
+ 4341  - An AUTO-APPLYING tool makes the DEFAULT armed op a behavioural decision.
+ 4347  - `prefers-reduced-motion` suppresses `animationend`
+ 4351  - `$effect` tracks EVERY store read synchronously inside it — side reads (userdata,
+ 4355  - No `bind:value` ping-pong with store round-trips — widgets render from data and write
+ 4357  - Media elements: `muted`/`volume` set as properties in an action, not attributes.
+ 4358  - The Threlte Canvas wrapper swallows **pointerup AND pointermove** mid-gesture —
+ 4360  - Threlte `<T>` `oncreate` passes the ref **DIRECTLY** (`CreateEvent<T> = (ref) => void`),
+ 4364  - svelte-awesome-color-picker v4 fires `onInput` ONCE ON MOUNT
+ 4374  - Never write through a DERIVED store
+ 4384  - **The op TARGET in the mesh/face tools is `opTargetFace()`, never
+ 4396  - Mesh ops must survive a CLOSED region and a MULTI-SHELL pick.
+ 4404  - New geometry needs its UVs authored, not copied.
+ 4412  - AO is a fullscreen pass and mobile GPUs mis-compile it
+ 4419  - **A DOM overlay that must AGREE with a threlte frame may not own a
+ 4429  - **`OrbitControls.update()` re-derives the camera position from its own spherical
+ 4437  - An **`<svg>` is a REPLACED element**: `position: fixed; inset: 0` still leaves it
+ 4440  - **flowbite's plugin emits `[type='checkbox']:checked { background-color:
+ 4444  - Anything drawn with **`depthWrite: false` loses the postprocessing passes**: the
+ 4447  - **A projected world point at y = 0 is UNDER a terrain, so the ray through its pixel
+ 4457  - A section that measures CHANGE must re-seed what earlier sections consumed.
+ 4462  - **THE MESHGEO CHANNEL CARRIES A TRIANGLE SOUP, so any op committing through it must
+ 4470  - A BUFFER-LEVEL check cannot see a shattered mesh, and this one shipped.
+ 4474      · for any op that rebuilds geometry, assert the TRIANGLES
+ 4477  - **Two different situations both produce "nothing moved", and reporting the wrong one
+ 4482  - A repeat carve is NOT idempotent, and a test that claims it is passes vacuously.
+ 4488  - A first click that loads its module dynamically feels broken.
+ 4494  - **`toJSON` ALWAYS writes the vertex buffer, so "ship it parametric" does not make a
+ 4504  - A CARVE is a mesh edit, so it LOCKS the parametric rows
+ 4507  - Grid/pattern FOLLOW must snap by the **section period** (`cell × sectionEvery`),
+ 4510  - A three.js XR controller cannot be hand-posed in a test
+ 4517  - WebXR hand joints: read them from threlte's `useHand('left'/'right')` store
+ 4523  - Shared THREE temp vectors corrupt values across helper calls — clone before reuse.
+ 4524  - Never write a store from inside its own subscriber (infinite flush loop) — read refs
+ 4526  - Vite HMR module identity
+ 4530  - flowbite: Modal has no `onopen` (react to the bound store); Dropdown anchors to its
+ 4532  - `event.code` (`Digit1`) for digit shortcuts — `event.key` breaks with Shift.
+ 4533  - Stores initialized `writable(null)`/`writable([])` infer `never` — annotate with
+ 4535  - Runtime = node >= 24
+ 4541  - Release ritual (V6)
+ 4547  - BVH picking (17-D3)
+ 4562  - Deps policy (2026-08-01, post-migrations)
+ 4570  - Modal gotcha (flowbite 1.x)
+ 4580  - PowerShell mangles emoji AND em-dashes when rewriting files, and inline `node -e`
+ 4584  - CSS `transform` makes an element the containing block for `position: fixed`
+ 4601  - Configure Scene DEEP LINKS
+ 4610  - `backdrop-filter`/`filter` ALSO make an element the containing block for
+ 4615  - The camera PiP frame deliberately sits BELOW the tiers (z-index 2): it is a
+ 4618  - z-index: ONE SCALE (41 G3b), `ui.css` `:root`, lowest first
+ 4629  - flowbite 1.x Dropdowns are TOP-LAYER popovers
+ 4644  - `(pointer: coarse)` CAN be emulated after all
+ 4651  - Unlayered global CSS silently beats EVERY Tailwind utility
+ 4659  - A **`position: absolute`** floating window parked past the right/bottom edge joins the
+ 4665  - Menus opened by a LONG PRESS need press-and-click backdrops
+ 4670  - Mobile/touch
+ 4679  - Responsive layout CSS-var bus (`fix/ui-polish-connect-settings`)
+ 4692  - A window bigger than the screen can never be shrunk again
+ 4711  - **A floating/absolute element off the RIGHT or BOTTOM edge grows the document (scrollbars
+ 4718  - `@threlte/xr` 1.0.0-next.15 crashes on XR session end/inputsourceschange
+ 4724      · `guardThrelteXr` Vite transform plugin in vite.config.ts
+ 4734  - Nothing in the app disables OrbitControls during a transform-gizmo drag
+ 4744  - A check that cannot fail is not a check
+ 4749  - **A viewport point probed while a floating panel is CLOSED is not a viewport
+ 4757  - A change you cannot make FAIL is a guess, so either prove it or drop it.
+ 4764  - A threlte component that REMOUNTS comes back with its prop defaults
+ 4769  - Mid-session HMR churn makes e2e runs LIE
+ 4776      · 19-A escalation — a DAY-LIVED server serves stale DUAL MODULE INSTANCES
+ 4786  - Svelte 5 DELEGATES `onkeydown`/`onpointerdown`/`onclick` attributes
+ 4794  - A `derived` store that reads anything off `userData` must list `objectsGroup` in
+ 4798  - An INSET viewport (camera PiP) is `setScissorTest(true)` + `setScissor` +
+ 4803  - Threlte's `camera.current` is a PLAIN PROPERTY
+ 4810  - `Object3D.lookAt` faces **+Z** for plain meshes but **-Z** for cameras/lights
+ 4816  - A context menu RESIZES while open (#16-P1 filter row, #16-P2 match list), so its
+ 4820  - THREE color management: `setHSL()` works in the LINEAR working space — pass
+ 4824  - Reference-space convention in vrControls: `getOffsetReferenceSpace` offset =
+ 4825      · -(viewer displacement)
+ 4826  - Resolve a VR controller BY HANDEDNESS via `controllerIndexFor` (reads
+ 4836  - VR presence broadcasts in the shared CONTENT frame (worldRig-local, `worldToContentPose`)
+ 4842  - VR live face-adjust amount clamps are PER-OP: inset `[0.02,0.9]` (a signed `[-5,5]`
+ 4848  - Locks: `lockedObjects` holds REMOTE locks only — "we hold X" = X is our selection;
+ 4850  - vite re-optimizes new deps on first page load (one reload) — rerun once; lazy wasm
+ 4852  - Postprocessing composers (Outline) do NOT render in WebXR — VR indicators are
+ 4855  - Module cycles: a static import that closes a loop back into `history` (via
+ 4862  - The TDZ-cycle family around history.js
+ 4870  - Node cards (flow editor)
+ 4877  - Autosave restore re-uuid'd every object
+ 4883  - `selectedObject` is `writable([])` and KEEPS the last object after deselect (the
+ 4897  - The Bash tool's `cd` leaks into the shared shell cwd — `Set-Location` back to the
+ 4899  - Never `git stash pop` to undo a `git stash push -- <file>`
+ 4904  - Connect dance (#12 fix)
+ 4910  - Physics ↔ rapier traps (#12)
+ 4924  - Explorer `addItemFromBytes` TIME-BOXES its decorative thumbnail (Promise.race 4s) —
+ 4926  - Static-import cycle map grew in #12: objectActions now imports geometries
+ 4931  - The dungeon module publishes gameplay data on its group's `userData.play`
+ 4933  - Local-model tool calls (AI assistant)
+ 4947  - Re-seating the transform gizmo (17-D)
+ 4957  - meshEdit has TWO vertex-selection notions
+ 4963  - The Inspector edits the SELECTION SET, not one object (17-D1)
+ 4976  - Inspector.svelte is a plain `<script>` (NOT lang="ts")
+ 4980  - Icons = `@lucide/svelte` SVG components
+ 5000  - **`git checkout --theirs -- <file>` during a merge discards the WHOLE ours side of that
+ 5006  - **An attribute INDEX recorded before a `meshgeo` commit addresses a DIFFERENT vertex after
+ 5009  - A handle hung past a docked window's edge is clipped away and takes no pointer events
+ 5012  - Chromium fires `contextmenu` on the PRESS
+ 5014  - The node pane's empty bottom-right corner is the MINIMAP
+ 5016  - `.peer-watch` is worn by TWO buttons
+ 5020  - A type check cannot tell a shader-driven material from its base
+ 5022  - A guard that is redundant on the happy path is not proven by the happy path
+ 5024  - A constant in a shader graph must be a Float node
+ 5026  - A perRound latch count reads 0 the instant the round ends
+ 5030  - A MESH NAME WITH A SPACE ARRIVES UNDERSCORED ON THE PEER
+ 5033  - THE MODULES MANAGER'S USER TAB LABEL GROWS A COUNT AFTER AN INSTALL
+ 5038  - A MODULE'S NODE-DATA WRITES WERE NOT UNDOABLE AT ALL.
+ 5046  - A MODULE EFFECT NODE PINS ITS TARGET'S POSE
+ 5052  - A SPAWNED COPY IS A TRANSIENT CLONE WITH NO FLOW NODES
+ 5057  - **A SAME-SPOT APPEND FROM TWO LANES MERGES AS A CONFLICT WHOSE UNION IS RIGHT — EXCEPT WHERE
+
+ 5064  ## Verification (mandatory before commit)
+
+ 5094  ## Workflow preferences (user)
+ 5096  - One commit per phase/feature; message style: `[feat]/[fix] lowercase summary` + body
+ 5098  - Plan documents live in the PRIVATE cloud repo: `cloud/plans/core/` (local …
+ 5106  - Roadmap ritual: user drops notes → ask 3-4 targeted AskUserQuestion forks (offer a
+ 5109  - Design work: screenshot-driven. (Toasts/Connect/Controls were long "keep as-is" but
+ 5113  - VR phases: verify math/state headlessly, state clearly that on-device feel is the
+ 5115  - Shipping flow (since 2026-07-20): branch-per-batch off `main` → one commit per
+ 5118  - Repos (org move 2026-07-21, github.com/theprototype-app)
+ 5129  - Status (2026-08-30, latest): **ROUNDS 34+35 — A SAVE NAMES THE ROOM, AND PRIVATE
+ 5146  - Status (2026-08-29): **ROUND 33 — THE CONNECT DECISION (49984d9, one commit,
+ 5163  - Status (2026-08-29): **ROUND 32 — four reports triaged, three fixed, one ruled**
+ 5180      · BASELINE RATCHETED 383/62 -> 363/62
+ 5187  - Status (2026-08-29): **ROUND 31 — three reported fixes on top of round 30**
+ 5198  - Status (2026-08-28): **ROADMAP 22 ROUND 30 — ROOMS THAT HOLD, AND A LIBRARY THAT
+ 5221      · OWED ON DEVICE
+ 5224      · FOLLOW-UPS RECORDED
+ 5227  - Status (2026-08-27, latest): **ROADMAP 22 ROUNDS 19-28 — THE PREVIEW'S CORNER, WINDOW
+ 5229      · 383/62
+ 5232      · R19/R21
+ 5236      · R20
+ 5238      · R24
+ 5241      · THE METHOD NOTE WORTH KEEPING
+ 5246      · R29 CLOSED THE ONE THAT KEPT COMING BACK
+ 5250      · NOT REPRODUCED
+ 5253      · OWED
+ 5254  - Status (2026-08-27): **ROADMAP 22 ROUNDS 14-18 — PREVIEW SETTINGS SCOPE, AND THE
+ 5258      · R14 — WHICH SETTINGS BELONG TO A WINDOW.
+ 5266      · R15 — the preview plays animations
+ 5268      · R16/R17 — the keyboard.
+ 5270      · R18 — two reported bugs, both reproduced first
+ 5274      · OWED
+ 5276  - Status (2026-08-26, latest): **ROADMAP 22 ROUND 13 — THE 3D PREVIEW'S CONTROLS.** One
+ 5280      · THE REPORTED BUG WAS REAL AND IS THE ONE TO REMEMBER
+ 5302      · OWED
+ 5303  - Status (2026-08-26, later): **ROADMAP 22 ROUND 12 — PREVIEW-WINDOW MATURITY + THE
+ 5322      · THE BUG THIS ROUND FOUND, and it is the one worth remembering
+ 5342      · OWED
+ 5345  - Status (2026-08-26): **ROADMAP 22 ROUND 11 — THE EXPLORER/PREVIEW/SESSIONS BATCH.
+ 5357      · THE ROOT CAUSE WORTH REMEMBERING
+ 5368      · THE BRIEF'S THUMBNAIL PREMISE DID NOT REPRODUCE
+ 5372      · DESIGN DECISIONS I OWNED, stated so they are not re-litigated
+ 5382      · OWED, because headless cannot judge it
+ 5387  - Status (2026-08-23): **v1.7.0 RELEASED — "Make a game, keep a project"**.
+ 5394      · THE LOOSE-SCENES BATCH
+ 5415      · ONLY ON EVIDENCE is the rule everywhere
+ 5424  - Status (2026-10-02): **1.19.0 "Doors that open, scenes that load, games that switch" — ROADMAP 33, …
+ 5437  - Status (2026-10-01): **1.18.0 PREVIEW — ROADMAP 31 "the second Quest round", integrated on `feat/1.18`
+ 5449  - Status (2026-09-24): **1.17.0 round 2 + 3 — THE QUEST ROUND AND THE MESHY ASSETS, integrated
+ 5461  - Status (2026-09-23): **1.17.0 "Games that look finished" — ROADMAP 30, integrated on `feat/1.17`
+ 5475  - Status (2026-09-22): **1.16.0 "Waves, and one world to keep" — ROADMAP 29 ROUND 3, the follow-up
+ 5492  - Status (2026-09-20): **1.15.1 "Knock, and a key you never typed" — ROADMAP 29 ROUND 2, the two
+ 5511  - Status (2026-09-19): **1.15.0 "Where everyone is" — ROADMAP 29's finished lanes INTEGRATED.**
+ 5525  - Status (2026-09-03): **R22 ROUND 36 — DELETED KEEPS ITS STRUCTURE, on lane `core-lane-bin`
+ 5554  - Status (2026-09-02): **R22 ROUND 13 SHIPPED — PRs #186 and #188 MERGED to release/next
+ 5581  - Status (2026-08-25): **ROADMAP 22 — THE SHARED EXPLORER LIBRARY. R1/R2/R3/R7 + R8 and
+ 5596  - Status (2026-08-22, later): **B7 SPAWNER MERGED; DEVX #18, THE PALETTE RULE AND THE
+ 5603      · feat/collectible-toolbox-v2
+ 5620  - Status (2026-08-22, latest): **21-G ROUND 3 — COLLECTIBLES v3 IS A MODULE. R3a (core
+ 5653  - Status (2026-08-21, latest): **ROADMAP 21-G — PROJECTS, CROSS-SCENE PRESENCE,
+ 5654  - Status (2026-08-22, latest): **21-G ROUND 2 — DCC-STANDARD PROJECTS (G7-G10 + docs)
+ 5678  - Status (2026-08-21): **ROADMAP 21-G — PROJECTS, CROSS-SCENE PRESENCE,
+ 5684      · feat/21g-editor
+ 5691      · feat/21g-peervars
+ 5705  - Status (2026-08-21, later): **ROADMAP 21-F — LEVELS, COLLECTIBLES v2, HUD EDITOR
+ 5736  - Status (2026-08-21): **ROADMAP 21-E — GAME HARDENING, ALL EIGHT PHASES EXECUTED AND
+ 5760  - Status (2026-08-19): **ROADMAP #21-A IS COMPLETE — A6+A7 (PR #152) and A8 (PR #153)
+ 5791  - Status (2026-08-18, latest): **ROADMAP #21-D — HUD INTERACTION + THE GAME SHELL,
+ 5817      · GLTFExporter options being `parse()`'s 4th argument
+ 5827  - Status (2026-08-18, later): **ROADMAP #21-A — lanes L1 and L2 MERGED, PRs #149 (L1) and
+ 5861  - Status (2026-08-18): **ROADMAP #20 MERGED + v1.6.0 — PRs #146 and #147 to
+ 5866      · P1
+ 5874      · P4
+ 5880      · P7b IS THE ONE PLANNED PHASE NOT DONE
+ 5885  - Status (2026-08-14, later): **UV TRANSFORM TOOLS — branch `feat/uv-transform-tools`**
+ 5912  - Status (2026-08-14): **17-E ANIMATION KEYFRAMES — branch `feat/17e-animation-curves`,
+ 5940      · step
+ 5954      · **FOLLOW-UP DROP (2026-08-14, plan `plans/core/pending/17-e-animation-followups.md`,
+ 5956      · Ctrl+V fires push-to-talk
+ 5974      · box + lasso selection of keys
+ 5991  - Status (2026-08-17): **THE MESH-EDIT ROUND IS MERGED TO release/next — PRs #132
+ 6016  - Status (2026-08-19): **21-C1..C4 TERRAIN + SPLINES — branch `feat/21-terrain-road`
+ 6027      · C4
+ 6034      · 387/62
+ 6048  - Status (2026-08-19): **PER-CAMERA LOOKS — branch `feat/camera-looks` (lane
+ 6065  - Status (2026-08-18): **SCENE LOOK / POST-PROCESSING — branch `feat/scene-post-stack`
+ 6069      · L1
+ 6070      · L2
+ 6077      · **the visibility model corrected — the look is DEFAULT-ON for everyone, with
+ 6080      · LEFT BEFORE THE PR: the user's visual/feel pass, and a decision on L8
+ 6087  - Status (2026-08-19): **21-B PHYSICS PLAY — B1-B6 + A8 EXECUTED**, lane
+ 6110      · **STANDING PRE-EXISTING REDS, A/B'd against base 803d040 and NOT from this
+ 6115      · ONE UNEXPLAINED, reproducible
+ 6122  - Status (2026-08-18, later): **SH6b CLOSED BY MEASUREMENT** — `shader-scene-default`
+ 6131  - Status (2026-08-18): **SHADER GRAPHS — SH5/SH6/SH7 + the node MANUAL** (same lane,
+ 6136      · SH6
+ 6137      · SH7
+ 6138      · DOCS
+ 6146  - Status (2026-08-17, later): **SHADER GRAPHS — the three OWED items EXECUTED** on the
+ 6162  - Status (2026-08-17): **SHADER GRAPH EDITOR — SH0 through SH4 EXECUTED**, lane
+ 6166      · 391/62
+ 6184  - Status (2026-08-17, later): **v1.5.0 CYCLE — the R-line MERGED, two PRs open.**
+ 6212  - Status (2026-08-17): **v1.4.0 RELEASED + four follow-up PRs.** `main` @2d68fdb
+ 6237  - Status (2026-08-17, before the 1.5.0 tag): **PR #141 MERGED (animation polish) and
+ 6255      · 391/62
+ 6258  - Status (2026-08-16): **19-A READY TO PR — P0–P5b + P7a + P7b COMMITTED (12 commits,
+ 6298  - Status (2026-08-15, superseded by the entry above): **ROADMAP #19-A IN FLIGHT — the mesh tool …
+ 6308      · P2
+ 6325  - Status (2026-08-14): **ROADMAP #18 EXECUTED — settings polish, window sizing, Edit Mesh
+ 6343      · 391/62
+ 6352  - Status (2026-08-11, fifth drop): **knife RUBBER BAND + the P12 wasm question ANSWERED —
+ 6367  - Status (2026-08-11, fourth drop): **M9b KNIFE + M7 SYMMETRIZE — PRs #117 + #118 MERGED
+ 6380  - Status (2026-08-11, third drop): **BEVEL in all three modes + M8 proportional —
+ 6397  - Status (2026-08-11): **MESH PRO TOOLS started — core PR #112 (draft), M4 + M5 in.**
+ 6399      · M4 completion = the EDGE GIZMO
+ 6419  - Status (2026-08-11): **MESH TOPOLOGY IS STORED DATA — core PR #111** (branch
+ 6437  - Status (2026-08-11): **UV EDITOR shipped across five PRs; UV4 unblocked.** #106
+ 6457  - Status (2026-08-10): **MESH HARDENING — branch `feat/mesh-hardening`** (off
+ 6474      · **NEXT WORKSTREAM (user-approved, ahead of M4 gizmo/M5/M9): stored face
+ 6479  - Status (2026-08-10): **17-A MODULE PLATFORM SHIPPED — core PR #101** (branch
+ 6490      · MODULE MOVE
+ 6505  - Status (2026-08-10): **mesh-editing roadmap M0-M4 + M6 EXECUTED** (plan: cloud
+ 6532  - Status (2026-08-06, release): **1.2.0 SHIPPED** — PR #88 (`release/next` → `main`)
+ 6546  - Status (2026-08-05, release): **`release/next` ASSEMBLED for 1.2.0** — PRs #86 →
+ 6558  - Status (2026-08-05): **15-H scene notes v2/v3 COMPLETE** — branch
+ 6577  - Status (2026-08-02): **Roadmap #15 in flight — A+J → PR #81, B+C → PR #82,
+ 6590  - Status (2026-08-04, drop 3): **#16 Q5 on the SAME PR #86** — the reported
+ 6604  - Status (2026-08-04, drop 2): **#16 follow-ups on the SAME PR #86** — [fix] camera
+ 6616  - Status (2026-08-04): **Roadmap #16 (menus, grid & scene cameras) EXECUTED →
+ 6629  - Status (2026-08-01): **VR sleeve palette (K1+K2) MERGED to release/next (PR #75)**
+ 6640      · AI assistant v3 flow+physics tools: PR #76 OPEN against release/next
+ 6661  - Status (2026-08-01): **Colliders v2 + Edit Mesh Pro MERGED to release/next (PR
+ 6671      · CL-C
+ 6679  - Status (2026-07-28): **v1.0.0 RELEASED** (PR #56 merge-commit → `npm version 1.0.0`
+ 6698  - Status (2026-07-26): **Mobile/responsive UI polish — branch
+ 6708      · Settings
+ 6725      · Logo click
+ 6738  - Status (2026-07-25): **Roadmap #14 continuing — open-core cloud MATURED.** cloudApi
+ 6748  - Status (2026-07-24): **Roadmap #14 (Connect UX + open-core cloud) IN FLIGHT.**
+ 6857      · Roadmap #6 (211-220) ALL SHIPPED
+
+ 6869  ## Module SDK (implemented — extend, don't fork)
diff --git a/CLAUDE.md b/CLAUDE.md
index a1a120aa..ade5d067 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -5,6 +5,10 @@ Threlte 8 + three.js, peerjs mesh networking (no server beyond PeerJS signaling)
 node/flow editor (@xyflow/svelte 0.1.x) driving scene behavior, and a module SDK for
 loadable play content. Everything a user does must be visible to connected peers.
 
+**This file is ~7,000 lines; you are shown only its start.** `CLAUDE-index.md` lists every section, entry and
+sub-entry with its line: grep the index for a word, then read this file from that line. After editing this file
+(or on a merge conflict in the index), run `node scripts/claude-index.cjs`.
+
 ## Architecture map
 
 - `src/stores/` — `appStore` (UI panels + `openSceneSection(label)`/`inspectorScrollTo`
diff --git a/RELEASING.md b/RELEASING.md
index 768e5289..517873ee 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -85,6 +85,22 @@ released version instead of drifting (it carried a stale 1.8.0 before 1.11.0).
   ```
   (plus every changed module file; the same three lines with `scenes`/`format-2` and
   `packs`/`format-1`). A modules merge alone no longer reaches production's gallery.
+- **Record the release's known reds** (the desk battery's baseline, pipeline-1): right after the tag, run the
+  battery once ON THE TAG — two halves, each on a pc slot where the e2e-slot setup has them — and save it:
+  ```sh
+  bash scripts/ci/battery-snapshot.sh vX.Y.Z <dir>     # git archive + .env + certs + the desk tool (NOT archive alone)
+  cd <dir> && BATTERY_COMMIT=vX.Y.Z node scripts/ci/battery-desk.cjs run --half A --out test-results/bl --name blA   # and --half B
+  node scripts/ci/battery-desk.cjs baseline save vX.Y.Z <dir>
+  ```
+  The next integrator runs the same halves on its union and calls `battery-desk.cjs diff --baseline vX.Y.Z <dir>`:
+  a red whose every twice-red check is red on the tag too is PRE-EXISTING (no A/B run), a red that went green on
+  the end-of-half retry is FLAKY (logged; `battery-desk.cjs flakes` prints the rates), and only NEW reds need a look.
+  No pc slot for the tag run? Save the releasing union's OWN last battery as the tag's baseline instead (it is the
+  released code, run the way the next integrator will run it): `battery-desk.cjs import <u1A.txt> --logs <dir>
+  [--retry <rerun.txt>]` per half, then `baseline save vX.Y.Z <dirs>`. Measured on 1.43 (51-int) against 50-int's 1.42
+  battery imported that way: 50 reds -> 33 pre-existing, 11 NEW after the retry.
+  A new `tests/e2e/*.test.cjs` goes into `tests/e2e/battery.json` (suites, or `exclude` with a reason) —
+  `tests/unit/batteryDesk.test.js` fails on a file in neither.
 - The peers warn (never block) on version mismatches, and `.tpscene`/`.tpmodule`
   files confirm before loading a NEWER format int — older files always load
   silently. Bump `SESSION_FORMAT`/`MODULE_FORMAT` only when the shape actually
diff --git a/scripts/ci/battery-desk.cjs b/scripts/ci/battery-desk.cjs
new file mode 100644
index 00000000..50cd474a
--- /dev/null
+++ b/scripts/ci/battery-desk.cjs
@@ -0,0 +1,496 @@
+#!/usr/bin/env node
+// THE INTEGRATORS' BATTERY ON A DESK, AGAINST A BASELINE OF THE LAST RELEASE.
+//
+// battery.cjs runs tests/e2e/battery.json in shards on GitHub runners. This is the same list run the
+// way an integrator runs it before a release: one half at a time on an e2e slot, against a dev server
+// the slot started, with the suites a public runner skips (the self-hosted signaling box, the
+// production hostname mapped here, the modules repo's flights). What it adds over a plain loop:
+//
+//  - EVERY RED RUNS ONCE MORE, AT THE END OF THE HALF, not straight after. A red that came from the
+//    moment (a sibling's build filling the box, a cold vite pre-bundle) meets a different moment the
+//    second time. Green then = flaky: logged with its checks, never handed to the integrator.
+//  - EVERY FAILED CHECK GETS A FINGERPRINT (suite + the FAIL line with numbers, JSON and paths taken
+//    out), so "the same red as on the release" is a set lookup, not an A/B run.
+//  - A BASELINE per release tag: the battery once on the tag right after the release (`baseline`).
+//    `diff` sorts a run's reds into pre-existing (every check red in both runs is red on the tag too),
+//    flaky (no check red twice) and NEW — the only ones that need the integrator.
+//  - ONE SUMMARY LINE at the end (stdout, and <out>/<name>.done), so a lane that started this in the
+//    background is woken by the exit, not by polling.
+//
+//   node scripts/ci/battery-desk.cjs run --half A [--of 2] [--out dir] [--name u1A] [--root tree] [--no-retry]
+//   node scripts/ci/battery-desk.cjs run --only a,b,MOD:untangle ...
+//   node scripts/ci/battery-desk.cjs baseline save <tag> <out-dir>...      # record a tag's runs
+//   node scripts/ci/battery-desk.cjs diff [--baseline tag|file] <out-dir>...  # exit 1 when anything is NEW
+//   node scripts/ci/battery-desk.cjs flakes [--days 30]                    # flake rate per suite
+//   node scripts/ci/battery-desk.cjs coverage                              # every e2e file listed or excluded
+//   node scripts/ci/battery-desk.cjs import u1A.txt --logs e2e/ [--retry r2.txt]  # an old battery.sh run, for diff
+//
+// State (baselines, the outcome log) lives in $BATTERY_STATE, default ~/.local/state/theprototype/battery.
+// The environment a suite reads (APP_URL, MODULES_REPO, the *_TPSCENE paths, PEER_CONFIG_SELF) is the
+// caller's: source the integrator's env file first, exactly as for the old battery.sh.
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawn } = require('child_process');
+const { load, assign, counts } = require('./battery.cjs');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const STATE = process.env.BATTERY_STATE || path.join(process.env.XDG_STATE_HOME || path.join(os.homedir(), '.local', 'state'), 'theprototype', 'battery');
+
+/**
+ * @typedef {import('./battery.cjs').Battery & { modules?: Record<string, number>, desk?: { 'prod-host'?: string[], 'peer-self'?: string[], gpu?: string[] },
+ *   exclude?: Record<string, string[]> }} DeskBattery
+ * @typedef {{ rc: number|null, secs: number, pass: number, fail: number, last: string, fps: string[] }} Attempt
+ * @typedef {{ name: string, status: 'pass'|'flaky'|'red'|'gone', first: Attempt, retry?: Attempt, fps: string[] }} DeskResult
+ * @typedef {{ name: string, root: string, commit: string, slot: string, started: string, secs: number, results: DeskResult[] }} DeskRun
+ * @typedef {{ tag: string, commit: string, made: string, runs: string[], suites: Record<string, { status: string, fps: string[] }> }} Baseline
+ */
+
+// ---------------------------------------------------------------- fingerprints
+
+/**
+ * One failed check as a stable key: the line a suite printed for it, without what changes from run to
+ * run — numbers (ms, px, counts, line:col), JSON details, absolute paths, colour codes. "dock resize
+ * widens (320 → 440)" and "(318 → 437)" are the same check failing; "the Cut button could not be
+ * clicked" and "the Cut button is disabled" are not.
+ * @param {string} line
+ */
+function normalise(line) {
+	return line
+		.replace(/\x1b\[[0-9;]*m/g, '')
+		.replace(/^\s*(✗|FAIL|not ok)\s*:?\s*/, '')
+		.replace(/\{.*\}/g, '{…}')
+		.replace(/(?:\/[\w.@+-]+)+\/([\w.@+-]+)/g, '$1')
+		.replace(/0x[0-9a-f]+/gi, '#')
+		.replace(/\d+(?:\.\d+)?/g, '#')
+		.replace(/\s+/g, ' ')
+		.trim()
+		.slice(0, 200);
+}
+
+/**
+ * The fingerprints of one suite's log: one per FAIL line, the SCRIPT FAILED message, a timeout, and —
+ * when a red log names none of those (a crash before the first check) — its last line.
+ * @param {string} suite @param {string} log @param {number|null} rc
+ * @returns {string[]}
+ */
+function fingerprints(suite, log, rc) {
+	if (rc === 0) return [];
+	const out = new Set();
+	for (const l of log.split('\n')) {
+		if (/^\s*(?:✗|FAIL\b|not ok\b)/.test(l)) out.add(`${suite} :: ${normalise(l)}`);
+		else if (/^\s*SCRIPT FAILED/.test(l)) out.add(`${suite} :: ${normalise(l)}`);
+	}
+	if (/\[battery\] TIMEOUT/.test(log)) out.add(`${suite} :: TIMEOUT`);
+	if (!out.size) out.add(`${suite} :: rc=${rc} ${normalise((log.split('\n').filter((l) => l.trim()).pop() || '').slice(0, 200))}`);
+	return [...out].sort();
+}
+
+// ---------------------------------------------------------------- the run
+
+/** the desk set: every listed suite (skip is about public runners) and the modules flights @param {DeskBattery} b */
+function deskEntries(b) {
+	return /** @type {[string, number][]} */ ([...Object.entries(b.suites), ...Object.entries(b.modules || {}).map(([m, s]) => [`MOD:${m}`, s])]);
+}
+
+/** @param {DeskBattery} b @param {string} half @param {number} of */
+function half(b, half, of) {
+	const i = half.toUpperCase().charCodeAt(0) - 65;
+	const shards = assign({ ...b, skip: {}, suites: Object.fromEntries(deskEntries(b)) }, of);
+	if (!(i >= 0 && i < of)) throw new Error(`--half ${half}: there are ${of} halves (A..${String.fromCharCode(64 + of)})`);
+	return shards[i].suites;
+}
+
+/**
+ * the dev server answers. `vite --host localhost` may listen on ::1 only while node resolves localhost
+ * to 127.0.0.1, so both loopbacks are asked (battery.cjs's reachable, with the request's own host header).
+ * @param {string} url @returns {Promise<boolean>}
+ */
+async function reachable(url) {
+	const u = new URL(url);
+	/** @param {string} host @returns {Promise<boolean>} */
+	const ask = (host) =>
+		new Promise((resolve) => {
+			const req = require('https').get({ host, port: u.port, path: u.pathname, headers: { host: u.host }, servername: u.hostname, rejectUnauthorized: false, timeout: 300000 }, (res) => {
+				res.resume();
+				res.on('end', () => resolve((res.statusCode || 0) < 500));
+			});
+			req.on('timeout', () => req.destroy());
+			req.on('error', () => resolve(false));
+		});
+	if (u.hostname !== 'localhost') return ask(u.hostname);
+	return (await ask('::1')) || (await ask('127.0.0.1'));
+}
+
+/**
+ * One suite, the way battery.sh ran it: node in the tree, the caller's environment, the per-suite
+ * cases the list names (desk.prod-host: APP_URL on the production hostname, which /etc/hosts maps
+ * here; desk.peer-self: the self-hosted signaling box; MOD:x: the modules repo's runner, GPU ones
+ * with E2E_GPU=1).
+ * @param {DeskBattery} b @param {string} name @param {string} root @param {string} logFile
+ * @returns {Promise<Attempt>}
+ */
+function attempt(b, name, root, logFile) {
+	const env = { ...process.env };
+	let cmd = ['node', path.join(root, 'tests', 'e2e', `${name}.test.cjs`)];
+	let cwd = root;
+	let limit = 1500;
+	if (name.startsWith('MOD:')) {
+		const m = name.slice(4);
+		cwd = process.env.MOD_REPO || process.env.MODULES_REPO || '';
+		cmd = ['node', 'tests/run.cjs', m];
+		if (b.desk?.gpu?.includes(name)) env.E2E_GPU = '1';
+		else limit = 1200;
+	} else if (b.desk?.['prod-host']?.includes(name)) env.APP_URL = (env.APP_URL || '').replace('localhost', 'theprototype.app');
+	else if (b.desk?.['peer-self']?.includes(name)) env.PEER_CONFIG = env.PEER_CONFIG_SELF || '';
+	const fd = fs.openSync(logFile, 'w');
+	const t0 = Date.now();
+	return new Promise((resolve) => {
+		const child = spawn(cmd[0], cmd.slice(1), { cwd: cwd || root, env, stdio: ['ignore', fd, fd], detached: true });
+		let timedOut = false;
+		const timer = setTimeout(() => {
+			timedOut = true;
+			try {
+				process.kill(-(child.pid || 0), 'SIGKILL');
+			} catch {}
+		}, limit * 1000);
+		const done = (/** @type {number|null} */ code) => {
+			clearTimeout(timer);
+			fs.closeSync(fd);
+			if (timedOut) fs.appendFileSync(logFile, `\n[battery] TIMEOUT after ${limit}s\n`);
+			const text = fs.readFileSync(logFile, 'utf8');
+			const rc = timedOut ? null : code;
+			resolve({ rc, secs: Math.round((Date.now() - t0) / 1000), ...counts(text), fps: fingerprints(name, text, rc) });
+		};
+		child.on('exit', done);
+		child.on('error', () => done(127));
+	});
+}
+
+/** battery.sh's summary line, so the integrators' greps and `battery.cjs refresh --summary` still read it @param {string} name @param {Attempt} a */
+function line(name, a) {
+	return `${name} rc=${a.rc} pass~${a.pass} fail~${a.fail} ${a.secs}s :: ${a.last.slice(0, 140)}`;
+}
+
+/** @param {string} root */
+function commitOf(root) {
+	// a snapshot (rsync of a checkout, no .git) says what it is through the environment
+	if (process.env.BATTERY_COMMIT) return process.env.BATTERY_COMMIT;
+	try {
+		return require('child_process').execFileSync('git', ['-C', root, 'describe', '--tags', '--always', '--dirty'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+	} catch {
+		return '?';
+	}
+}
+
+/** @param {object} row */
+function logOutcome(row) {
+	try {
+		fs.mkdirSync(STATE, { recursive: true });
+		fs.appendFileSync(path.join(STATE, 'outcomes.jsonl'), JSON.stringify(row) + '\n');
+	} catch {}
+}
+
+/** @param {string[]} argv @param {string} flag */
+function opt(argv, flag) {
+	const i = argv.indexOf(flag);
+	return i >= 0 ? argv[i + 1] : undefined;
+}
+
+/** @param {string[]} argv */
+async function run(argv) {
+	const b = /** @type {DeskBattery} */ (load(opt(argv, '--battery')));
+	const root = path.resolve(opt(argv, '--root') || ROOT);
+	const of = Number(opt(argv, '--of') || 2);
+	const h = opt(argv, '--half');
+	const only = opt(argv, '--only');
+	const list = opt(argv, '--list');
+	const names = only ? only.split(',') : list ? fs.readFileSync(list, 'utf8').split(/\s+/).filter(Boolean) : h ? half(b, h, of) : deskEntries(b).map(([n]) => n);
+	const name = opt(argv, '--name') || (h ? `half${h.toUpperCase()}` : 'run');
+	const out = path.resolve(opt(argv, '--out') || process.env.BATTERY_OUT || path.join(root, 'test-results', 'battery'));
+	const retry = !argv.includes('--no-retry');
+	const url = process.env.APP_URL || '';
+	fs.mkdirSync(path.join(out, 'logs'), { recursive: true });
+	const sumFile = path.join(out, `${name}.txt`);
+	const slot = process.env.E2E_SLOT_PC ? `pc:${process.env.E2E_SLOT_PC}` : process.env.E2E_SLOT_REMOTE ? 'remote' : process.env.E2E_SLOT ? 'local' : 'none';
+	const commit = commitOf(root);
+	const started = new Date().toISOString();
+	const t0 = Date.now();
+	fs.writeFileSync(sumFile, `snapshot: ${commit} root=${root} url=${url} slot=${slot} suites=${names.length}\n`);
+	const say = (/** @type {string} */ s) => {
+		console.log(s);
+		fs.appendFileSync(sumFile, s + '\n');
+	};
+	/** @type {Map<string, DeskResult>} */
+	const results = new Map();
+	// the dev server's first SSR + client graph is the slow load; one warm-up so the first suite does not pay it
+	if (url) await reachable(url);
+	for (const n of names) {
+		if (!n.startsWith('MOD:') && !fs.existsSync(path.join(root, 'tests', 'e2e', `${n}.test.cjs`))) {
+			const a = { rc: null, secs: 0, pass: 0, fail: 0, last: 'no such suite in this tree', fps: [] };
+			results.set(n, { name: n, status: 'gone', first: a, fps: [] });
+			say(`${n} rc=gone :: no such suite in this tree`);
+			continue;
+		}
+		// a dead dev server turns every later suite red for the wrong reason: wait for it, say so
+		if (url && !n.startsWith('MOD:') && !(await reachable(url))) say(`[battery] dev server unreachable before ${n}`);
+		const a = await attempt(b, n, root, path.join(out, 'logs', `${n.replace(':', '-')}.log`));
+		results.set(n, { name: n, status: a.rc === 0 ? 'pass' : 'red', first: a, fps: a.fps });
+		say(line(n, a));
+		for (const f of a.fps) fs.appendFileSync(sumFile, `    ${f.split(' :: ')[1]}\n`);
+	}
+	const reds = [...results.values()].filter((r) => r.status === 'red');
+	if (retry && reds.length) {
+		say(`[battery] retry: ${reds.length} red suite(s) once more, at the end of the half`);
+		for (const r of reds) {
+			const a = await attempt(b, r.name, root, path.join(out, 'logs', `${r.name.replace(':', '-')}.retry.log`));
+			r.retry = a;
+			if (a.rc === 0) {
+				r.status = 'flaky';
+				r.fps = [];
+			} else {
+				// a check red in BOTH runs is the real one; checks red once are the moment's
+				const both = r.first.fps.filter((f) => a.fps.includes(f));
+				r.fps = both.length ? both : a.fps;
+			}
+			say(`retry ${line(r.name, a)}${a.rc === 0 ? ' -> FLAKY' : ''}`);
+		}
+	}
+	for (const r of results.values()) {
+		logOutcome({ t: started, commit, slot, suite: r.name, status: r.status, first: r.first.fps, retry: r.retry?.fps });
+	}
+	/** @type {DeskRun} */
+	const rec = { name, root, commit, slot, started, secs: Math.round((Date.now() - t0) / 1000), results: [...results.values()] };
+	fs.writeFileSync(path.join(out, `${name}.json`), JSON.stringify(rec, null, 1));
+	const all = [...results.values()];
+	const n = (/** @type {string} */ s) => all.filter((r) => r.status === s).length;
+	const redNames = all.filter((r) => r.status === 'red').map((r) => r.name);
+	const summary = `BATTERY-DONE ${name} @${commit} ${slot}: ${all.length} suites, ${n('pass')} green, ${n('flaky')} flaky, ${redNames.length} red${redNames.length ? ` (${redNames.join(' ')})` : ''}, ${n('gone')} gone, ${Math.round(rec.secs / 60)} min -> ${path.join(out, name + '.json')}`;
+	say(summary);
+	fs.writeFileSync(path.join(out, `${name}.done`), summary + '\n');
+	process.exit(redNames.length ? 1 : 0);
+}
+
+// ---------------------------------------------------------------- baselines and the diff
+
+/** @param {string[]} dirs @returns {DeskRun[]} */
+function readRuns(dirs) {
+	/** @type {DeskRun[]} */
+	const runs = [];
+	for (const d of dirs) {
+		const st = fs.statSync(d);
+		const files = st.isDirectory() ? fs.readdirSync(d).filter((f) => f.endsWith('.json')).map((f) => path.join(d, f)) : [d];
+		for (const f of files) {
+			const j = JSON.parse(fs.readFileSync(f, 'utf8'));
+			if (Array.isArray(j.results) && j.started) runs.push(j);
+		}
+	}
+	return runs;
+}
+
+/** @param {string} tag @param {string[]} dirs */
+function baselineSave(tag, dirs) {
+	const runs = readRuns(dirs);
+	if (!runs.length) throw new Error(`no desk runs (<name>.json) in ${dirs.join(' ')}`);
+	/** @type {Baseline} */
+	const bl = { tag, commit: runs[0].commit, made: new Date().toISOString(), runs: runs.map((r) => `${r.name} ${r.slot} ${r.started}`), suites: {} };
+	for (const r of runs) {
+		for (const s of r.results) {
+			// a baseline remembers EVERY check it saw red, on either attempt: a flaky check on the tag is
+			// a known one on the union too
+			const fps = [...new Set([...s.first.fps, ...(s.retry?.fps || [])])].sort();
+			bl.suites[s.name] = { status: s.status, fps };
+		}
+	}
+	const dir = path.join(STATE, 'baselines');
+	fs.mkdirSync(dir, { recursive: true });
+	const file = path.join(dir, `${tag}.json`);
+	fs.writeFileSync(file, JSON.stringify(bl, null, 1));
+	const by = (/** @type {string} */ s) => Object.values(bl.suites).filter((v) => v.status === s).length;
+	console.log(`baseline ${tag} @${bl.commit}: ${Object.keys(bl.suites).length} suites (${by('pass')} green, ${by('flaky')} flaky, ${by('red')} red, ${by('gone')} gone) -> ${file}`);
+}
+
+/** the newest saved baseline, by file time, when the caller names none */
+function latestBaseline() {
+	const dir = path.join(STATE, 'baselines');
+	const files = fs.existsSync(dir) ? fs.readdirSync(dir).filter((f) => f.endsWith('.json')) : [];
+	files.sort((x, y) => fs.statSync(path.join(dir, y)).mtimeMs - fs.statSync(path.join(dir, x)).mtimeMs);
+	return files[0] ? path.join(dir, files[0]) : '';
+}
+
+/**
+ * @param {Baseline} bl @param {DeskRun[]} runs
+ * @returns {{ green: string[], flaky: string[], known: string[], fresh: { name: string, fps: string[], why: string }[], gone: string[] }}
+ */
+function classify(bl, runs) {
+	/** @type {ReturnType<typeof classify>} */
+	const out = { green: [], flaky: [], known: [], fresh: [], gone: [] };
+	for (const r of runs) {
+		for (const s of r.results) {
+			if (s.status === 'pass') out.green.push(s.name);
+			else if (s.status === 'flaky') out.flaky.push(s.name);
+			else if (s.status === 'gone') out.gone.push(s.name);
+			else {
+				const base = bl.suites[s.name];
+				const unknown = s.fps.filter((f) => !base?.fps.includes(f));
+				if (!unknown.length) out.known.push(s.name);
+				else out.fresh.push({ name: s.name, fps: unknown, why: !base ? 'not in the baseline' : base.status === 'pass' ? 'green on the baseline' : 'a check the baseline did not fail' });
+			}
+		}
+	}
+	return out;
+}
+
+/** @param {string[]} argv */
+function diff(argv) {
+	const named = opt(argv, '--baseline');
+	const file = !named ? latestBaseline() : named.endsWith('.json') ? named : path.join(STATE, 'baselines', `${named}.json`);
+	if (!file || !fs.existsSync(file)) throw new Error(`no baseline ${named || '(none saved)'} — run the battery on the release tag and \`baseline save\` it`);
+	const dirs = argv.filter((a, i) => !a.startsWith('--') && argv[i - 1] !== '--baseline');
+	/** @type {Baseline} */
+	const bl = JSON.parse(fs.readFileSync(file, 'utf8'));
+	const c = classify(bl, readRuns(dirs));
+	console.log(`vs baseline ${bl.tag} @${bl.commit}: ${c.green.length} green, ${c.flaky.length} flaky (green on the retry), ${c.known.length} pre-existing, ${c.fresh.length} NEW, ${c.gone.length} gone`);
+	if (c.flaky.length) console.log(`  flaky: ${c.flaky.join(' ')}`);
+	if (c.known.length) console.log(`  pre-existing (same checks red on ${bl.tag}; no A/B needed): ${c.known.join(' ')}`);
+	for (const f of c.fresh) {
+		console.log(`  NEW ${f.name} — ${f.why}`);
+		for (const fp of f.fps) console.log(`      ${fp.split(' :: ')[1]}`);
+	}
+	process.exit(c.fresh.length ? 1 : 0);
+}
+
+/** @param {string[]} argv */
+function flakes(argv) {
+	const days = Number(opt(argv, '--days') || 30);
+	const since = Date.now() - days * 86400e3;
+	const file = path.join(STATE, 'outcomes.jsonl');
+	/** @type {Record<string, { runs: number, flaky: number, red: number }>} */
+	const per = {};
+	const rows = fs.existsSync(file) ? fs.readFileSync(file, 'utf8').split('\n').filter(Boolean) : [];
+	for (const l of rows) {
+		const r = JSON.parse(l);
+		if (Date.parse(r.t) < since || r.status === 'gone') continue;
+		const p = (per[r.suite] ||= { runs: 0, flaky: 0, red: 0 });
+		p.runs++;
+		if (r.status === 'flaky') p.flaky++;
+		if (r.status === 'red') p.red++;
+	}
+	const list = Object.entries(per).filter(([, p]) => p.flaky).sort((x, y) => y[1].flaky / y[1].runs - x[1].flaky / x[1].runs || (x[0] < y[0] ? -1 : 1));
+	const runs = Object.values(per).reduce((t, p) => t + p.runs, 0);
+	const flaky = Object.values(per).reduce((t, p) => t + p.flaky, 0);
+	console.log(`last ${days} days: ${runs} suite runs, ${flaky} flaky (${runs ? ((100 * flaky) / runs).toFixed(1) : 0} %), ${list.length} suites ever flaky`);
+	for (const [n, p] of list) console.log(`  ${((100 * p.flaky) / p.runs).toFixed(0).padStart(3)} %  ${n}  (${p.flaky} of ${p.runs} runs flaky, ${p.red} red twice)`);
+}
+
+// ---------------------------------------------------------------- import (an old battery.sh run)
+
+/**
+ * A run of the integrators' old battery.sh (its summary lines + one <suite>.log each) as a desk run, so it can
+ * be diffed against a baseline. battery.sh never retried, so a red stays red unless `--retry <summary>` names a
+ * later rerun of the same suites (green there = flaky; red there = the checks red in both).
+ * @param {string[]} argv
+ */
+function importRun(argv) {
+	const logs = path.resolve(opt(argv, '--logs') || '.');
+	const retryFile = opt(argv, '--retry');
+	const summary = argv.filter((a, i) => !a.startsWith('--') && !['--logs', '--retry', '--name', '--out'].includes(argv[i - 1]))[0];
+	if (!summary) throw new Error('import: name the summary file');
+	const name = opt(argv, '--name') || path.basename(summary, '.txt');
+	/** @param {string} file @param {string} dir */
+	const parse = (file, dir) => {
+		/** @type {Map<string, Attempt>} */
+		const m = new Map();
+		// battery.sh writes the run's own FAIL / SCRIPT FAILED lines indented under its row: those are the evidence.
+		// A <suite>.log is read only when the row has none AND the log is not newer than the summary -- a later
+		// rerun into the same folder overwrites the log (MEASURED: 51-int's r2-r7 rewrote half its u1 logs).
+		const lines = fs.readFileSync(file, 'utf8').split('\n');
+		const when = fs.statSync(file).mtimeMs;
+		lines.forEach((l, i) => {
+			const r = /^(\S+) rc=(\S+) pass~(\d+) fail~(\d+) (\d+)s :: ?(.*)$/.exec(l);
+			if (!r) return;
+			const rc = r[2] === 'gone' ? null : Number(r[2]);
+			/** @type {string[]} */
+			const under = [];
+			for (let j = i + 1; j < lines.length && /^\s{4}\S/.test(lines[j]); j++) under.push(lines[j].trim());
+			const logFile = path.join(dir, `${r[1].startsWith('MOD:') ? 'mod-' + r[1].slice(4) : r[1]}.log`);
+			const fresh = fs.existsSync(logFile) && fs.statSync(logFile).mtimeMs <= when + 60000;
+			const log = under.length ? under.join('\n') : fresh ? fs.readFileSync(logFile, 'utf8') : r[6];
+			m.set(r[1], { rc, secs: Number(r[5]), pass: Number(r[3]), fail: Number(r[4]), last: r[6], fps: fingerprints(r[1], log, rc) });
+		});
+		return m;
+	};
+	const first = parse(summary, logs);
+	const again = retryFile ? parse(retryFile, path.resolve(opt(argv, '--retry-logs') || path.dirname(retryFile))) : new Map();
+	/** @type {DeskResult[]} */
+	const results = [];
+	for (const [n, a] of first) {
+		const r = again.get(n);
+		if (a.rc === 0) results.push({ name: n, status: 'pass', first: a, fps: [] });
+		else if (r && r.rc === 0) results.push({ name: n, status: 'flaky', first: a, retry: r, fps: [] });
+		else {
+			const both = r ? a.fps.filter((f) => r.fps.includes(f)) : a.fps;
+			results.push({ name: n, status: 'red', first: a, retry: r, fps: both.length ? both : r ? r.fps : a.fps });
+		}
+	}
+	const out = path.resolve(opt(argv, '--out') || path.dirname(summary));
+	/** @type {DeskRun} */
+	const rec = { name, root: '', commit: (fs.readFileSync(summary, 'utf8').split('\n')[0] || '').replace(/^snapshot: /, ''), slot: 'imported', started: fs.statSync(summary).mtime.toISOString(), secs: 0, results };
+	fs.writeFileSync(path.join(out, `${name}.json`), JSON.stringify(rec, null, 1));
+	console.log(`imported ${results.length} suites (${results.filter((r) => r.status === 'red').length} red, ${results.filter((r) => r.status === 'flaky').length} flaky) -> ${path.join(out, name + '.json')}`);
+}
+
+// ---------------------------------------------------------------- coverage
+
+/**
+ * Every tests/e2e/*.test.cjs is in the battery or excluded with a reason, and nothing listed is
+ * missing. A suite nobody listed is a suite no release ever runs — the reason this check exists.
+ * @param {DeskBattery} b @param {string[]} files suite names on disk
+ */
+function coverage(b, files) {
+	const excluded = new Set(Object.values(b.exclude || {}).flat());
+	const listed = new Set([...Object.keys(b.suites), ...excluded]);
+	return {
+		unlisted: files.filter((f) => !listed.has(f)),
+		missing: [...listed].filter((n) => !files.includes(n)),
+		both: Object.keys(b.suites).filter((n) => excluded.has(n))
+	};
+}
+
+function e2eFiles(root = ROOT) {
+	return fs
+		.readdirSync(path.join(root, 'tests', 'e2e'))
+		.filter((f) => f.endsWith('.test.cjs'))
+		.map((f) => f.slice(0, -'.test.cjs'.length))
+		.sort();
+}
+
+if (require.main === module) {
+	const [cmd, ...argv] = process.argv.slice(2);
+	try {
+		if (cmd === 'run') run(argv);
+		else if (cmd === 'baseline' && argv[0] === 'save' && argv[1]) baselineSave(argv[1], argv.slice(2));
+		else if (cmd === 'diff') diff(argv);
+		else if (cmd === 'flakes') flakes(argv);
+		else if (cmd === 'import') importRun(argv);
+		else if (cmd === 'coverage') {
+			const c = coverage(/** @type {DeskBattery} */ (load()), e2eFiles());
+			for (const n of c.unlisted) console.log(`unlisted: ${n} — add it to tests/e2e/battery.json suites, or to exclude with a reason`);
+			// listed-but-absent is information, not a failure: a feat branch carries the list of a
+			// release whose suites have not merged into it yet, and both runners report them as gone
+			for (const n of c.missing) console.log(`(listed, no file here: ${n})`);
+			for (const n of c.both) console.log(`both: ${n} is a suite AND excluded`);
+			process.exit(c.unlisted.length + c.both.length ? 1 : 0);
+		} else {
+			console.error('usage: battery-desk.cjs run --half A|B [--of N] [--only a,b] [--list f] [--out d] [--name n] [--root tree] [--no-retry]\n' + '       | baseline save <tag> <out-dir>... | diff [--baseline tag|file] <out-dir>... | flakes [--days N] | coverage\n' +
+					'       | import <battery.sh summary.txt> --logs <dir> [--retry <summary.txt> [--retry-logs dir]] [--name n] [--out dir]');
+			process.exit(2);
+		}
+	} catch (e) {
+		console.error(`battery-desk: ${/** @type {Error} */ (e).message}`);
+		process.exit(2);
+	}
+}
+
+module.exports = { normalise, fingerprints, classify, coverage, e2eFiles, deskEntries, half };
diff --git a/scripts/ci/battery-snapshot.sh b/scripts/ci/battery-snapshot.sh
new file mode 100755
index 00000000..76d0dd7a
--- /dev/null
+++ b/scripts/ci/battery-snapshot.sh
@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# battery-snapshot.sh <tag> <dir> — a tree of a release tag to run the desk battery's baseline on.
+#
+# `git archive <tag>` alone is NOT enough, and the difference is silent: MEASURED (pipeline-1, 2026-10-24) a v1.42.0
+# archive without the gitignored `.env` booted on the public PeerJS cloud instead of the self-hosted signaling box,
+# and every two-peer suite failed at "connect: could not fill the peer id" on the PC slot while the pages would not
+# boot at all on the Deck -- 67 of 228 suites red for a reason no integrator's union shares. So the snapshot takes
+# this checkout's `.env` and `certs/localhost.*` too (the dev server's TLS), and the desk tool from THIS tree
+# (a tag older than it has no scripts/ci/battery-desk.cjs). node_modules: a pc slot installs it by lockfile; for a
+# local run, `npm ci` in <dir> (or hard-link a checkout's whose package-lock.json is identical).
+set -euo pipefail
+tag="${1:?usage: battery-snapshot.sh <tag> <dir>}"; dir="${2:?usage: battery-snapshot.sh <tag> <dir>}"
+here="$(cd "$(dirname "$0")/../.." && pwd)"
+[ ! -e "$dir" ] || [ -z "$(ls -A "$dir")" ] || { echo "battery-snapshot: $dir is not empty" >&2; exit 2; }
+mkdir -p "$dir"
+git -C "$here" archive "$tag" | tar -x -C "$dir"
+for f in .env certs/localhost.crt certs/localhost.key; do
+  if [ -f "$here/$f" ]; then mkdir -p "$dir/$(dirname "$f")"; cp "$here/$f" "$dir/$f"; else echo "battery-snapshot: no $f in $here (the run may differ from a lane's)" >&2; fi
+done
+mkdir -p "$dir/scripts/ci" "$dir/tests/e2e"
+cp "$here/scripts/ci/battery-desk.cjs" "$here/scripts/ci/battery.cjs" "$dir/scripts/ci/"
+cp "$here/tests/e2e/battery.json" "$dir/tests/e2e/"
+if git -C "$here" diff --quiet "$tag" HEAD -- package-lock.json; then lock=same; else lock=differs; fi
+echo "$tag $(git -C "$here" rev-parse --short "$tag^{commit}") (package-lock vs this tree: $lock)" > "$dir/.snap"
+echo "battery-snapshot: $dir = $tag + .env + certs + the desk tool; run it with BATTERY_COMMIT=$tag"
diff --git a/scripts/ci/battery.cjs b/scripts/ci/battery.cjs
index f994cf22..4e5c7dd8 100755
--- a/scripts/ci/battery.cjs
+++ b/scripts/ci/battery.cjs
@@ -27,7 +27,7 @@ const BATTERY = path.join(ROOT, 'tests', 'e2e', 'battery.json');
 /**
  * @typedef {{ comment?: string, refs: Record<string, {repo: string, ref: string}>, shards: {target_minutes: number, max: number, min: number},
  *   pc?: {games: string[], levels: string[]}, skip: Record<string, string>, optional: Record<string, string>, setup: Record<string, string>,
- *   suites: Record<string, number> }} Battery
+ *   suites: Record<string, number>, modules?: Record<string, number>, desk?: Record<string, string[]>, exclude?: Record<string, string[]> }} Battery
  * @typedef {{ name: string, status: 'pass'|'flaky'|'fail'|'timeout'|'gone', required: boolean, rc: number|null, secs: number,
  *   retrySecs?: number, pass: number, fail: number, last: string, shard: number }} SuiteResult
  */
@@ -300,6 +300,10 @@ function write(b) {
 		`\t"setup": ${obj(b.setup, '\t')}`,
 		`\t"suites": ${obj(b.suites, '\t')}`
 	];
+	// the desk battery's keys (battery-desk.cjs): written only when present, so a file without them stays byte-identical
+	if (b.modules) body.push(`\t"modules": ${obj(b.modules, '\t')}`);
+	if (b.desk) body.push(`\t"desk": ${obj(b.desk, '\t')}`);
+	if (b.exclude) body.push(`\t"exclude": ${obj(Object.fromEntries(Object.entries(b.exclude).map(([k, v]) => [k, [...v].sort()])), '\t')}`);
 	fs.writeFileSync(BATTERY, `{\n${body.join(',\n')}\n}\n`);
 }
 
@@ -309,8 +313,14 @@ function refresh(argv) {
 	const lists = opts(argv, '--list');
 	if (lists.length) {
 		// the integrator's battery lists ARE the battery: names not in them leave, new ones arrive at 120 s
-		const names = new Set(lists.flatMap((f) => fs.readFileSync(f, 'utf8').split(/\s+/).filter((n) => n && !n.startsWith('MOD:'))));
+		const all = lists.flatMap((f) => fs.readFileSync(f, 'utf8').split(/\s+/).filter(Boolean));
+		const names = new Set(all.filter((n) => !n.startsWith('MOD:')));
 		b.suites = Object.fromEntries([...names].map((n) => [n, b.suites[n] ?? 120]));
+		// the modules repo's flights (MOD:x) are the desk battery's, never a runner's
+		const mods = all.filter((n) => n.startsWith('MOD:')).map((n) => n.slice(4));
+		if (mods.length) b.modules = Object.fromEntries(mods.map((m) => [m, b.modules?.[m] ?? 600]));
+		// a suite that joined the battery is no longer excluded
+		if (b.exclude) for (const k of Object.keys(b.exclude)) b.exclude[k] = b.exclude[k].filter((/** @type {string} */ n) => !names.has(n));
 	}
 	/** @type {Record<string, number[]>} */
 	const desk = {};
diff --git a/scripts/claude-index.cjs b/scripts/claude-index.cjs
new file mode 100644
index 00000000..f662c487
--- /dev/null
+++ b/scripts/claude-index.cjs
@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+// CLAUDE-index.md — A TABLE OF CONTENTS FOR CLAUDE.md, BY LINE.
+//
+// CLAUDE.md is ~7,000 lines (500 KB) of architecture map and gotchas, and an agent is shown only its
+// first screen. Nobody reads it whole, so what it knows is found by luck or by an expensive grep across
+// the whole file. The index is one line per entry — every `## ` section, every top-level `- ` bullet and
+// every bold sub-entry (`  · **…**`, `  **…**`) — with the line it starts on, so a reader greps the
+// index for a word, then reads CLAUDE.md at that offset.
+//
+//   node scripts/claude-index.cjs           # write CLAUDE-index.md
+//   node scripts/claude-index.cjs --check   # exit 1 when CLAUDE-index.md is not what this would write
+//
+// Generated, never edited: a merge conflict in it is resolved by running this again.
+
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.resolve(__dirname, '..');
+const SRC = path.join(ROOT, 'CLAUDE.md');
+const OUT = path.join(ROOT, 'CLAUDE-index.md');
+
+/** the entry's name: its bold lead if it has one, else its first words @param {string} text */
+function title(text) {
+	const bold = /^\*\*(.+?)\*\*/.exec(text);
+	const t = bold ? bold[1] : text;
+	const flat = t.replace(/\s+/g, ' ').trim();
+	return flat.length > 110 ? flat.slice(0, 107).replace(/\s+\S*$/, '') + ' …' : flat;
+}
+
+/** @param {string} md @returns {string} */
+function build(md) {
+	const lines = md.split('\n');
+	const out = [
+		'# CLAUDE-index.md — where things are in CLAUDE.md',
+		'',
+		'Generated by `node scripts/claude-index.cjs` (never edit; on a merge conflict, run it again).',
+		'Grep this file for a word, then read CLAUDE.md from that line (`Read CLAUDE.md offset=<line> limit=60`).',
+		`${lines.length} lines indexed.`,
+		''
+	];
+	lines.forEach((l, i) => {
+		const n = String(i + 1).padStart(5);
+		let m;
+		if ((m = /^(#{1,3}) (.+)/.exec(l))) out.push(`${m[1].length === 1 ? '' : '\n'}${n}  ${m[1]} ${m[2].trim()}`);
+		else if ((m = /^- (.+)/.exec(l))) out.push(`${n}  - ${title(m[1])}`);
+		else if ((m = /^ {2}(?:· )?(\*\*.+)/.exec(l))) out.push(`${n}      · ${title(m[1])}`);
+	});
+	return out.join('\n') + '\n';
+}
+
+if (require.main === module) {
+	const want = build(fs.readFileSync(SRC, 'utf8'));
+	if (process.argv.includes('--check')) {
+		const have = fs.existsSync(OUT) ? fs.readFileSync(OUT, 'utf8') : '';
+		if (have !== want) {
+			console.error('CLAUDE-index.md is stale: run node scripts/claude-index.cjs');
+			process.exit(1);
+		}
+		console.log('CLAUDE-index.md is current');
+	} else {
+		fs.writeFileSync(OUT, want);
+		console.log(`CLAUDE-index.md: ${want.split('\n').length} lines for ${mdLines()} lines of CLAUDE.md`);
+	}
+}
+
+function mdLines() {
+	return fs.readFileSync(SRC, 'utf8').split('\n').length;
+}
+
+module.exports = { build, title };
diff --git a/tests/e2e/battery.json b/tests/e2e/battery.json
index 5d5d9725..b3eed92e 100644
--- a/tests/e2e/battery.json
+++ b/tests/e2e/battery.json
@@ -1,5 +1,5 @@
 {
-	"comment": "deps-auto: the e2e battery deps.yml runs in shards on GitHub-hosted runners (scripts/ci/battery.cjs). suites = name -> seconds on a runner (2x the desk time until a runner has measured it); skip = cannot run on a public runner (the reason); optional = runs and reports, does not gate (the reason); setup = extra install a suite needs. Refresh after an integrator battery: node scripts/ci/battery.cjs refresh --list <listA> --list <listB> --summary <summary.txt>... (RELEASING.md, Dependency updates). pc = the games (fps) and levels (shots) scripts/ci/pc-battery.sh measures on a desktop GPU.",
+	"comment": "deps-auto: the e2e battery deps.yml runs in shards on GitHub-hosted runners (scripts/ci/battery.cjs). suites = name -> seconds on a runner (2x the desk time until a runner has measured it); skip = cannot run on a public runner (the reason); optional = runs and reports, does not gate (the reason); setup = extra install a suite needs. Refresh after an integrator battery: node scripts/ci/battery.cjs refresh --list <listA> --list <listB> --summary <summary.txt>... (RELEASING.md, Dependency updates). pc = the games (fps) and levels (shots) scripts/ci/pc-battery.sh measures on a desktop GPU. Desk battery (scripts/ci/battery-desk.cjs): modules = the modules repo flights (MOD:x) with desk seconds; desk = per-suite cases (gpu: E2E_GPU=1, peer-self: PEER_CONFIG=$PEER_CONFIG_SELF, prod-host: APP_URL on the production hostname); exclude = reason -> e2e files that are deliberately NOT in the battery (tests/unit/batteryCoverage.test.js fails on a file in neither).",
 	"refs": {
 		"modules": {"repo":"theprototype-app/modules","ref":"80fca17f7cd963cf698d6b5f29beaff14f28f9e1"},
 		"packs": {"repo":"theprototype-app/packs","ref":"360f31686652f0f9c7e240ff09785c6b6c60d678"},
@@ -17,37 +17,66 @@
 	},
 	"optional": {
 		"animation-sync": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
+		"ar-table": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
 		"behaviours": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"char-controller": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
+		"checkpoint-clean": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"code-popout": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
 		"collider-live": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"context-menu-redesign": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"edit-move-games": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
+		"explorer-files": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
 		"fb-water": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
+		"flow-code": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"flow-code-text": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
 		"flow-physics-actions": "flaky on every app/driver pair (deps-1 ab3, 2026-10-23)",
 		"flow-physics-nodes": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"game-loop-v4": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"game-sky-run": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
+		"helpers-in-play": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"hud-editor": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"hud-persist": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"hud-screen-model": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
 		"kit-instancing": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"lock-search": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"mesh-toolbox-redesign": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"model-preview": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
+		"net-handshake": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"net-reconnect": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
 		"net-stress": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"panels": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"phone-sheets": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"physics-discoverability": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"physics-kinematic": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
+		"play-exits": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"play-reentry": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"pointer-capture-play": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"post-play-mode": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
 		"scene-budget": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"scene-post": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"scene-post-effects": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
+		"scene-versions": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"script-node-v2": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
 		"search-menus": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"select-41": "G4 flick timing flake (deps-1 ab3: 12/12 green on --local, red under load)",
+		"session-scenes": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"sessions": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
 		"settings-layout": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"shader-sync": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
+		"shared-text": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"shared-text-doc": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
 		"sound-node": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"themes": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"timeline-export": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
 		"touch-actions": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
-		"water-migration": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)"
+		"touch-play": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"union-50": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"vr-locomotion-flags": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"vr-mode-spawn": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"vr-passthrough": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"vr-walk-interact": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green",
+		"water-migration": "red on the unchanged base too (deps-1 A/B on 1f3b9dd5, 2026-10-23)",
+		"workspace-restore": "joined from the 1.43 desk battery (pipeline-1): not yet measured on a GitHub runner, so it reports and does not gate until a deps run has seen it green"
 	},
 	"setup": {
 		"agent-bridge": "agent"
@@ -65,6 +94,7 @@
 		"animation-sync": 120,
 		"animation-window": 28,
 		"aquarium-reef": 48,
+		"ar-table": 120,
 		"arch-primitives": 98,
 		"auto-quality-notice": 60,
 		"autosave-object-flows": 28,
@@ -83,7 +113,9 @@
 		"char-controller": 116,
 		"character-studio": 86,
 		"chat-v2": 70,
+		"checkpoint-clean": 132,
 		"code-node": 64,
+		"code-popout": 120,
 		"code-sidebars": 118,
 		"collider-custom": 30,
 		"collider-decompose": 244,
@@ -136,6 +168,7 @@
 		"explorer-delete-confirm": 216,
 		"explorer-drag-fixes": 274,
 		"explorer-drop": 168,
+		"explorer-files": 120,
 		"explorer-header-panels": 52,
 		"explorer-keyboard": 34,
 		"explorer-multiselect": 366,
@@ -152,6 +185,8 @@
 		"file-preview": 640,
 		"files-format-row": 276,
 		"floating-window-focus": 106,
+		"flow-code": 120,
+		"flow-code-text": 360,
 		"flow-debugger": 74,
 		"flow-dock-toggle": 32,
 		"flow-impact-static": 30,
@@ -197,12 +232,16 @@
 		"gltf-export-selection": 24,
 		"hdri": 54,
 		"heic-import": 284,
+		"helpers-in-play": 48,
 		"hotkeys-layout": 26,
 		"hud-core": 72,
+		"hud-editor": 46,
 		"hud-editor-wysiwyg": 60,
 		"hud-kinds": 28,
+		"hud-persist": 120,
 		"hud-picker": 34,
 		"hud-play-keyboard": 50,
+		"hud-screen-model": 70,
 		"hud-sync": 286,
 		"image-editor": 140,
 		"import-button": 52,
@@ -262,8 +301,10 @@
 		"modules-phone-jobs": 38,
 		"move-wire-shape": 150,
 		"multiselect-v2": 706,
+		"net-handshake": 120,
 		"net-mesh": 30,
 		"net-peer-id": 120,
+		"net-reconnect": 494,
 		"net-stress": 120,
 		"network-disconnect": 158,
 		"node-breadcrumb": 76,
@@ -310,12 +351,16 @@
 		"place-drag-cache": 44,
 		"place-drag-extras": 22,
 		"placeholders": 98,
+		"play-exits": 42,
 		"play-interact": 188,
 		"play-menu-mode": 74,
 		"play-mode-menu": 54,
+		"play-reentry": 120,
 		"player-access": 124,
+		"pointer-capture-play": 120,
 		"pool-toys-waterline": 32,
 		"post-backends": 22,
+		"post-play-mode": 120,
 		"prefabs": 286,
 		"profiler-sidebars": 148,
 		"profiler-themes": 46,
@@ -343,12 +388,16 @@
 		"scene-post-effects": 120,
 		"scene-post-ui": 156,
 		"scene-switch-keep": 626,
+		"scene-versions": 120,
 		"scene-versions-in-file": 32,
+		"script-node-v2": 120,
 		"script-nodes": 448,
 		"scrub-undo": 116,
 		"search-menus": 120,
 		"select-41": 114,
 		"select-inside-36": 38,
+		"session-scenes": 560,
+		"sessions": 120,
 		"settings-autorestore-colors": 150,
 		"settings-inventory": 32,
 		"settings-inventory-b": 36,
@@ -368,6 +417,8 @@
 		"shader-post-domain": 98,
 		"shader-sync": 120,
 		"shader-window": 126,
+		"shared-text": 120,
+		"shared-text-doc": 372,
 		"sheet-handoff": 214,
 		"shortcut-rebind": 146,
 		"shortcut-warnings": 44,
@@ -424,6 +475,7 @@
 		"toolbar-topright-43": 214,
 		"toolbox-window": 78,
 		"touch-actions": 154,
+		"touch-play": 194,
 		"touch-tools": 332,
 		"tours": 424,
 		"tpscene": 98,
@@ -436,6 +488,7 @@
 		"union-47": 46,
 		"union-48": 120,
 		"union-49": 22,
+		"union-50": 432,
 		"union-53": 74,
 		"unsaved-toast-stable": 214,
 		"user-modules": 184,
@@ -450,14 +503,18 @@
 		"vr-inset-confirm": 18,
 		"vr-iwer": 22,
 		"vr-locomotion": 32,
+		"vr-locomotion-flags": 30,
+		"vr-mode-spawn": 120,
 		"vr-panel-sharpness": 12,
 		"vr-panels-v3": 28,
+		"vr-passthrough": 120,
 		"vr-radial-menu": 32,
 		"vr-settings-36": 154,
 		"vr-settings-immediacy": 14,
 		"vr-settings-panel": 18,
 		"vr-snapturn-mirror": 28,
 		"vr-teleport": 18,
+		"vr-walk-interact": 120,
 		"vr-world": 36,
 		"water": 68,
 		"water-migration": 72,
@@ -478,6 +535,25 @@
 		"window-tabs-move": 30,
 		"wire-hardening": 22,
 		"workspace-layouts": 214,
+		"workspace-restore": 52,
 		"z-scale-layering": 104
+	},
+	"modules": {
+		"dungeon-realms": 458,
+		"football": 200,
+		"fx-car-blocks": 60,
+		"untangle": 146
+	},
+	"desk": {
+		"gpu": ["MOD:fx-car-blocks","MOD:untangle"],
+		"peer-self": ["arch-primitives","game-race"],
+		"prod-host": ["error-reports"]
+	},
+	"exclude": {
+		"a VR (IWER) editing suite not in the 1.43 integrator battery: triage owed (test-health-1)": ["music-vr-patch","novr-inset","play-here-iwer","vr-ai-panel","vr-ai-voice","vr-bounded-teleport","vr-box-select","vr-chat","vr-collider-edit","vr-controller-handedness","vr-create-face","vr-create-face-facing","vr-edit-caps","vr-edit-menu","vr-editmenu-reposition","vr-editmenu-tabs","vr-editmode-persist","vr-face-correctness","vr-face-edit","vr-face-live-adjust","vr-face-manip","vr-face-move-fix","vr-face-polygon","vr-face-weld","vr-grips-by-mode","vr-helper-eyes","vr-hz-pinch","vr-keyboard","vr-keyboard-search","vr-laser-panels","vr-mesh-undo","vr-multi-prefab","vr-multiselect-ring","vr-nav-suppression","vr-objects-groups","vr-objects-panel","vr-palette","vr-panel-sharpness-all","vr-panels-on-top","vr-peer-approve","vr-peer-hands","vr-peer-hands-net","vr-ping-accuracy","vr-prefabs","vr-props-panel","vr-ptt","vr-radial-stick","vr-ray-hover","vr-reticle-v2","vr-sleeve","vr-snap-menu","vr-source-rebind","vr-stats","vr-stretch","vr-stretch-fix","vr-stretch-sliders","vr-sweep","vr-teleport-handedness","vr-teleport-toggle","vr-two-hand-grab","vr-ungroup","vr-vertex-edit","vr-vertex-handle-bounds","vr-vertex-hold","vr-vertex-polish","vr-vertex-ray","vr-vertex-trigger","vr-window-grab","vr-world-grab","vr-world-reel","vr-worldgrab-presence"],
+		"a docs / screenshot generator, not a gate": ["flow-node-docs","shader-node-docs","vr-eye-shots"],
+		"a frame-rate / timing measurement: run by hand on an --exclusive slot, never in a battery half": ["avatar-knocked-perf","avatars-budget","import-budget","mesh-budget","perf-detailed","perf-live","perf-moment","perf-stale-modules","perf-stutter","place-drag-perf"],
+		"not in the 1.43 integrator battery (listA5/listB5): kept for focused runs, triage owed (test-health-1)": ["add-menu","add-menu-cursor","advanced-mode","ai-assistant","ai-local-model","ai-presets","ai-reference","anim-pack-refs","animated-base","animation-autokey","animation-autokey-material","animation-bake","animation-look-channels","animation-loop-pause","animation-markers","animation-marquee","animation-node","animation-onion","animation-persist","animation-relative-motion","annotation-anchor","approval-timeout","asset-cache-opfs","audio-devices","audio-engine","audio-harness","audio-pack","audio-patch","audio-sdk","author-kit","avatar-fly","avatar-v2","button","camera-bookmarks","camera-clipping","camera-looks","camera-objects","camera-preview-control","checkpoints","clear-scene","code-workspace","collectibles-v2","collision-groups","colocation-anchor","colocation-ar-mode","colocation-calibrate","colocation-core","colocation-nudge","colocation-presence","connect-pin-slide-43","content-index-cache","contest-starters","controls-state","controls-transform-tint","convert-to-mesh","deleted-folders","deselect-unlock","desktop-face-gizmo","dial-metadata","drawing","dungeon","dungeon-play","duplicate-after-create","duplicate-parity","edit-overlay-gaps","editmesh-focus","editmesh-mode-memory","env-fog-sticks","environment-v2","explorer-columns","explorer-duplicate","explorer-duplicate-scene-folder","explorer-expandable","explorer-inline-input","explorer-menu-icons","explorer-mount-open-peers","explorer-mounts","explorer-mounts-edit","explorer-rename","explorer-tree-floor","faces-nested-toolbar","faces-toolbar","far-clipping","fast-channel-fallback","fast-channel-loss","fb-input","fbx-mtl-import","file-windows-esc","flow-adjustable-params","flow-audit","flow-background","flow-contact-filter","flow-curvy-edges","flow-customnode-io","flow-explorer-floating","flow-input-moddefs","flow-mouse-bindings","flow-new-nodes","flow-node-duplicate","flow-node-undocked","flow-nodes-extended","flow-object-embed","flow-palette","flow-palette-reflow","flow-particle","flow-properties","flow-spawner","flow-window-mobile","gallery-submit","game-editor-flow","game-effects","game-feel-nodes","game-haptics","game-loop","game-loop-v2","game-loop-v3","game-presence","geometry-lock","geometry-params","gizmo-orbit-leak","gizmo-recall","grab-key","graph-games-lint","graph-tidy","graph-tree","grid-snapping","hand-models","hud-actions","hud-content","hud-editor-tools","hud-inputs","hud-nodes","hud-visibility","import-duplicates","import-reduce-gate","kit-entities","launch-inbox","level-templates","level-templates-33","light-aim","light-catalog","llms-txt","load-primitives-first-36","load-supersede-36","material-sharing","material-types","mesh-adjust","mesh-advanced-ops","mesh-bevel","mesh-bridge-normals","mesh-cleanup","mesh-edge-bevel","mesh-edge-gizmo","mesh-edge-mode","mesh-edge-vertex-ops","mesh-edit-display","mesh-edit-materials","mesh-edit-popup","mesh-falloff-rotate-scale","mesh-falloff-sync","mesh-fixes-round2","mesh-fixes-round3","mesh-generation","mesh-gizmo-modes","mesh-grab-uv","mesh-inset-move","mesh-loop-cut","mesh-loop-hardening","mesh-loop-select","mesh-multishell-ops","mesh-ops","mesh-ops-p5b","mesh-pivot-gizmo","mesh-proportional","mesh-quad-select","mesh-selection-undo","mesh-session-undo","mesh-symmetrize","mesh-symmetry-live","mesh-uv-preserve","mesh-vertex-bevel","mesh-vertex-slide","model-preview-controls","module-lifecycle-repo","module-node-io","module-pointer-seam","module-sdk","module-sdk-world","module-seed-graph","module-storage","module-update-on-load","module-world-root","modules-discoverability","multi-select","multiselect-menu","music-clock","music-flow-nodes","music-prefabs","music-sampling","music-template","music-toolbox","net-backoff","net-locks","network-quality","node-editor-open-view","node-search","node-ux-library","note-replies","object-list-drag","object-list-raise","object-list-size","object-origin","object-properties","object-search","object-sync","objectlist-hidden-icon","objectlist-search","open-core-m1","origin-rows","outline-scene-swap","pack-behavior","pack-undo","packs-explorer","palette","palette-groups","particles","path-node","peer-ice-config","peer-variables","pick-tiny-objects","ping","ping-highlights","ping-v2","placeholders-peers","play-free-cursor","play-here","play-reach-jump","pong","possess","prefab-explorer","prefab-library","prefab-propagation","preview-animation","private-scene","problem-report","project-file","project-manifest","race-touch-vr","recording","resync-converge","roadmap-13-notifications-notes","roadmap-13-viewport-camera","save-as-formats","scene-adopt","scene-assets","scene-default-material","scene-duplicate","scene-folders","scene-identity","scene-isolation","scene-levels","scene-load","scene-music","scene-poke","scene-presence","scene-rename","scene-rooms","scene-rooms-matrix","scene-rooms-truth","scene-stress","scene-switch","scene-switch-clear","scene-switch-games","script-guard","sdk-game-seams","sdk-input","sdk-pointer-ray","select-through","selection-extras","session-clock","session-download-formats","session-scene-data","session-zip","sessions-open","sessions-open-peers","sessions-packs","shader-editor","shader-inspector","shader-module-flow","shader-persist","shader-scene-default","shadows","share-gate-defer","share-stash","shared-library","shared-library-copies","sidebar-toggle","small-fixes-37","snap-advanced","spatial-voice","spline-tool","stars-clap","start-view","start-view-hold","stroke-streaming","switcher-mux","template-modules","terrain","topo-channel","towers-levels","trackpad-nav","trackpad-pinch","ui-fixes-15b","underlay","uv-dense","uv-live-faces","uv-materials","uv-pen-pressure","uv-slots","uv-slots-persist","uv-smart-unwrap","uv-target","uv-texture-params","uv-texture-tools","uv-transform","uv-unwrap","uv-unwrap-module","value-graph","variadic-nodes","version","vertices-create-face","view-mode","viewport-selection","viewport-tools-menu","walker-sensors","watch-look","waypoint-viz","wheel-classify"],
+		"the 38 R1 behaviour lock: npm run e2e -- @lock (tests/e2e/lock.json), not the release battery": ["dock-tabs-coexist","flow-dock-mixed","flow-dock-tabs","flow-explorer-dock","inspector-multi-edit","node-drag-fields","units"]
 	}
 }
diff --git a/tests/unit/batteryDesk.test.js b/tests/unit/batteryDesk.test.js
new file mode 100644
index 00000000..2ac0d032
--- /dev/null
+++ b/tests/unit/batteryDesk.test.js
@@ -0,0 +1,100 @@
+// pipeline-1: the desk battery (scripts/ci/battery-desk.cjs) — check fingerprints, the baseline diff, and
+// the guard that every tests/e2e file is in tests/e2e/battery.json or excluded with a reason.
+import { describe, it, expect } from 'vitest';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const { normalise, fingerprints, classify, coverage, e2eFiles, half } = require('../../scripts/ci/battery-desk.cjs');
+const battery = require('../../tests/e2e/battery.json');
+
+/** @param {string} name @param {'pass'|'flaky'|'red'|'gone'} status @param {string[]} fps */
+const res = (name, status, fps = []) => ({ name, status, first: { rc: status === 'pass' ? 0 : 1, secs: 1, pass: 1, fail: fps.length, last: '', fps }, fps });
+
+describe('battery-desk: a failed check is the same check on another run', () => {
+	it('drops numbers, JSON details, paths and colour codes', () => {
+		expect(normalise('FAIL dock resize widens (320 → 440)')).toBe(normalise('FAIL dock resize widens (318 → 437)'));
+		expect(normalise('FAIL an occupied edge takes a tab ({"flow":"right","listShown":false})')).toBe('an occupied edge takes a tab ({…})');
+		expect(normalise('    at /home/x/run-50-int/tests/e2e/touch-actions.test.cjs:235:92')).toBe('at touch-actions.test.cjs:#:#');
+		expect(normalise('\x1b[31mFAIL\x1b[0m the Cut button could not be clicked')).toBe('the Cut button could not be clicked');
+	});
+	it('keeps different checks apart', () => {
+		expect(normalise('FAIL the Cut button could not be clicked')).not.toBe(normalise('FAIL the Cut button is disabled'));
+	});
+	it('fingerprints FAIL lines, SCRIPT FAILED and timeouts; a green log has none', () => {
+		const log = 'PASS a\nFAIL b took 1200 ms\nSCRIPT FAILED: locator.click: Timeout 30000ms exceeded.\n1 FAILURES\n';
+		expect(fingerprints('s', log, 1)).toEqual(['s :: SCRIPT FAILED: locator.click: Timeout #ms exceeded.', 's :: b took # ms']);
+		expect(fingerprints('s', log, 0)).toEqual([]);
+		expect(fingerprints('s', '✓ a\n✗ b is red\n', 1)).toEqual(['s :: b is red']);
+		expect(fingerprints('s', 'PASS a\n[battery] TIMEOUT after 1500s\n', null)).toContain('s :: TIMEOUT');
+		expect(fingerprints('s', 'booting\nError: listen EADDRINUSE :5480\n', 1)).toEqual(['s :: rc=1 Error: listen EADDRINUSE :#']);
+	});
+});
+
+describe('battery-desk: a run against the release baseline', () => {
+	const baseline = {
+		tag: 'v1.0.0',
+		commit: 'abc',
+		made: '',
+		runs: [],
+		suites: { old: { status: 'red', fps: ['old :: x'] }, mixed: { status: 'red', fps: ['mixed :: x'] }, fine: { status: 'pass', fps: [] } }
+	};
+	it('same checks red on the tag = pre-existing; a new check or a suite green on the tag = NEW', () => {
+		const run = {
+			name: 'u1A',
+			root: '',
+			commit: '',
+			slot: '',
+			started: '',
+			secs: 0,
+			results: [res('old', 'red', ['old :: x']), res('mixed', 'red', ['mixed :: x', 'mixed :: y']), res('fine', 'red', ['fine :: z']), res('fresh', 'red', ['fresh :: q']), res('wobbly', 'flaky'), res('ok', 'pass')]
+		};
+		const c = classify(baseline, [run]);
+		expect(c.known).toEqual(['old']);
+		expect(c.flaky).toEqual(['wobbly']);
+		expect(c.green).toEqual(['ok']);
+		expect(c.fresh.map((/** @type {{name: string}} */ f) => f.name)).toEqual(['mixed', 'fine', 'fresh']);
+		expect(c.fresh[0].fps).toEqual(['mixed :: y']);
+		expect(c.fresh[1].why).toBe('green on the baseline');
+		expect(c.fresh[2].why).toBe('not in the baseline');
+	});
+});
+
+describe('battery-desk: every e2e file is in the battery or excluded', () => {
+	it('tests/e2e/battery.json lists or excludes every *.test.cjs', () => {
+		const c = coverage(battery, e2eFiles());
+		expect(c.unlisted, 'add these to tests/e2e/battery.json suites (a measured time) or to exclude with a reason').toEqual([]);
+		expect(c.both).toEqual([]);
+	});
+	it('the guard notices a new file', () => {
+		expect(coverage({ ...battery, exclude: {} }, ['brand-new-suite']).unlisted).toEqual(['brand-new-suite']);
+	});
+	it('the two halves split the desk set (suites + modules flights) with nothing lost', () => {
+		const a = half(battery, 'A', 2);
+		const b = half(battery, 'B', 2);
+		expect(a.length + b.length).toBe(Object.keys(battery.suites).length + Object.keys(battery.modules || {}).length);
+		expect(a.filter((/** @type {string} */ n) => b.includes(n))).toEqual([]);
+	});
+});
+
+describe('battery-desk import: an old battery.sh run', () => {
+	it('takes the FAIL lines written under each row, and a rerun as the retry', () => {
+		const fs = require('node:fs');
+		const os = require('node:os');
+		const path = require('node:path');
+		const { execFileSync } = require('node:child_process');
+		const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'bd-'));
+		fs.writeFileSync(path.join(dir, 'u1.txt'), 'snapshot: x\nok-suite rc=0 pass~3 fail~0 9s :: ALL PASS\nred rc=1 pass~2 fail~1 9s :: 1 FAILURES\n    FAIL the toast hides after 1200 ms\nwobbly rc=1 pass~1 fail~1 5s :: 1 FAILURES\n    FAIL a flaky check\nBATTERY-DONE\n');
+		fs.writeFileSync(path.join(dir, 'r2.txt'), 'snapshot: x\nwobbly rc=0 pass~2 fail~0 5s :: ALL PASS\n');
+		// a later rerun's green log in the same folder must not hide the red row's own lines
+		fs.writeFileSync(path.join(dir, 'red.log'), 'PASS everything\nALL PASS\n');
+		const cli = path.resolve('scripts/ci/battery-desk.cjs');
+		execFileSync('node', [cli, 'import', path.join(dir, 'u1.txt'), '--logs', dir, '--retry', path.join(dir, 'r2.txt'), '--name', 'u1', '--out', dir]);
+		const run = JSON.parse(fs.readFileSync(path.join(dir, 'u1.json'), 'utf8'));
+		const by = Object.fromEntries(run.results.map((/** @type {{name: string}} */ r) => [r.name, r]));
+		expect(by['ok-suite'].status).toBe('pass');
+		expect(by.red.status).toBe('red');
+		expect(by.red.fps).toEqual(['red :: the toast hides after # ms']);
+		expect(by.wobbly.status).toBe('flaky');
+		fs.rmSync(dir, { recursive: true, force: true });
+	});
+});
diff --git a/tests/unit/claudeIndex.test.js b/tests/unit/claudeIndex.test.js
new file mode 100644
index 00000000..0234fab1
--- /dev/null
+++ b/tests/unit/claudeIndex.test.js
@@ -0,0 +1,20 @@
+// pipeline-1: CLAUDE-index.md (the line index of CLAUDE.md) is what scripts/claude-index.cjs writes.
+import { describe, it, expect } from 'vitest';
+import { createRequire } from 'node:module';
+import fs from 'node:fs';
+
+const require = createRequire(import.meta.url);
+const { build, title } = require('../../scripts/claude-index.cjs');
+const root = new URL('../../', import.meta.url).pathname;
+
+describe('claude-index', () => {
+	it('CLAUDE-index.md is current', () => {
+		const fresh = build(fs.readFileSync(root + 'CLAUDE.md', 'utf8')) === fs.readFileSync(root + 'CLAUDE-index.md', 'utf8');
+		expect(fresh, 'CLAUDE-index.md is stale: run `node scripts/claude-index.cjs` (after editing CLAUDE.md, or on a merge conflict in the index)').toBe(true);
+	});
+	it('names an entry by its bold lead, else its first words', () => {
+		expect(title('**`git checkout --theirs`** discards the ours side')).toBe('`git checkout --theirs`');
+		expect(title('`src/lib/sim/` (36-sim): buoyancy')).toBe('`src/lib/sim/` (36-sim): buoyancy');
+		expect(build('# T\n\n## S\n- **A** b\n  · **C** d\n')).toContain('    4  - A\n    5      · C');
+	});
+});