incanto 0.70.0 → 0.72.0

package/dist/{test-iHYVUcDK.js → test-Djuq3Vhq.js}

@@ -1,14 +1,14 @@
 import { n as jsonEquals, t as jsonClone } from "./json-CfTjpvW8.js";
-import { $ as StubBehavior, A as resetMemorySaves, E as resolveViewport, R as HudLayer, it as registerBehavior, p as loadScene, z as HudWidgetBase } from "./save-slots-BXVg148r.js";
-import { v as Engine } from "./register-6DYnKZcy.js";
+import { B as HudLayer, M as resetMemorySaves, O as resolveViewport, V as HudWidgetBase, c as isCloned, h as loadScene, ot as registerBehavior, tt as StubBehavior } from "./save-slots-CEuJPUle.js";
+import { v as Engine } from "./register-5IYfooAN.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-CDOMybym.js";
 import { c as getNodeSchema, d as mergeStaticProps, u as getNodeType } from "./touch-BnCyPA0G.js";
-import { n as startRecording } from "./replay-DjAkAzMq.js";
-import { Z as worldPosition, n as registerGameplayBehaviors } from "./gameplay-BfHkuzVb.js";
-import { t as registerNodes2D } from "./register-Bkk0wSDB.js";
-import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-D6Q5BxeE.js";
-import { a as NetworkManager, c as readSyncKey, i as sanitizeName, n as registerNodesNet, r as NetworkSpawner, s as findOwnerNode, t as createSplitScreen } from "./split-screen-PL78oVXP.js";
+import { n as startRecording } from "./replay-datiAE-b.js";
+import { Q as worldPosition, n as registerGameplayBehaviors } from "./gameplay-BlQe-M07.js";
+import { t as registerNodes2D } from "./register-C8HuRkOf.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-BeHoaGhy.js";
+import { a as NetworkManager, c as readSyncKey, i as sanitizeName, n as registerNodesNet, r as NetworkSpawner, s as findOwnerNode, t as createSplitScreen } from "./split-screen-Bm5DTElG.js";
 import { Box3, Euler, Frustum, Matrix4, PerspectiveCamera, Quaternion, Ray, Vector3 } from "three";
 //#region src/core/asset-urls.ts
 /** Keys inside a `material` object that hold a texture URL. */
@@ -1102,6 +1102,18 @@ const REACH_2D_PX = 32;
 * a platformer that never wrote a physics header still falls, and reading
 * absent as zero would have stopped reporting the pit it fell into.
 */
+/** Is anything in this tree driving the player without a down? */
+function hasTopDownController(root) {
+	const stack = [root];
+	while (stack.length > 0) {
+		const node = stack.pop();
+		if (node.constructor.typeName === "CharacterController2D") {
+			if (node.mode === "topDown") return true;
+		}
+		for (const child of node.children) stack.push(child);
+	}
+	return false;
+}
 function gravityMagnitude(physics) {
 	const g = physics?.gravity;
 	if (g === void 0) return 1;
@@ -1268,9 +1280,19 @@ var Driver = class {
 	* way a player would: the world stopped moving.
 	*/
 	frozeTheGame = /* @__PURE__ */ new Set();
+	/**
+	* Buttons an EARLIER run proved reload the scene, so this one never tries.
+	*
+	* Unlike a pause, a restart cannot be recovered from mid-run — the tree the
+	* driver holds is gone — so the blame has to outlive the run that paid for
+	* it. One run of the ten is spent learning; the other nine play the game.
+	*/
+	avoid = /* @__PURE__ */ new Set();
 	/** What was pressed most recently, so a freeze can be attributed to it. */
 	lastPressed = null;
 	moveAction;
+	/** The button the scene's controller calls its jump — `jump` unless it says otherwise. */
+	jumpButton = "jump";
 	/**
 	* The action vocabulary this driver was bound to, so it can notice a swap.
 	*
@@ -1384,6 +1406,18 @@ var Driver = class {
 				engine.toScreen ??= view.toScreen;
 			}
 		}
+		if (root) {
+			const stack = [root];
+			while (stack.length > 0) {
+				const node = stack.pop();
+				if (CONTROLLERS.has(node.constructor.typeName ?? "")) {
+					const want = node.jumpAction;
+					if (typeof want === "string" && want !== "") this.jumpButton = want;
+					break;
+				}
+				for (const child of node.children) stack.push(child);
+			}
+		}
 		this.readsMouse = asks;
 		const design = engine.scene?.viewport?.design;
 		this.view = [design?.[0] ?? 960, design?.[1] ?? 540];
@@ -1434,6 +1468,14 @@ var Driver = class {
 	paused() {
 		return [...this.frozeTheGame];
 	}
+	/** Never press these — an earlier run watched them reload the scene. */
+	avoidPressing(buttons) {
+		this.avoid = buttons;
+	}
+	/** Whatever was pressed most recently, so a reload can be attributed to it. */
+	blame() {
+		return this.lastPressed;
+	}
 	step(dt, at) {
 		this.rebind();
 		if (this.engine.timeScale === 0) {
@@ -1459,7 +1501,7 @@ var Driver = class {
 		}
 		if (this.moveAction) this.engine.input.setActionVector(this.moveAction, Math.cos(this.heading), Math.sin(this.heading));
 		for (const button of this.buttons) {
-			if (this.frozeTheGame.has(button)) continue;
+			if (this.frozeTheGame.has(button) || this.avoid.has(button)) continue;
 			const left = (this.held.get(button) ?? 0) - dt;
 			if (left > 0) {
 				this.held.set(button, left);
@@ -1470,7 +1512,7 @@ var Driver = class {
 				this.held.set(button, -1);
 				continue;
 			}
-			const chance = button === "jump" ? .06 : .02;
+			const chance = button === this.jumpButton ? .06 : .02;
 			if (this.rand() < chance) {
 				this.engine.input.pressAction(button);
 				this.actionPresses += 1;
@@ -1514,7 +1556,7 @@ var Driver = class {
 		if (widgets.length === 0) return;
 		const target = widgets[Math.floor(this.rand() * widgets.length)];
 		if (!target) return;
-		target._activate(0);
+		target._activate(this.rand() < .5 ? 0 : this.rand() < .5 ? -1 : 1);
 		this.presses += 1;
 	}
 	/** Every widget in the tree that can be picked up, or dropped onto. */
@@ -1678,7 +1720,7 @@ var Driver = class {
 		if (this.moveAction) this.engine.input.setActionVector(this.moveAction, 0, 0);
 	}
 };
-async function runOnce(json, seed, opts) {
+async function runOnce(json, seed, opts, avoid = /* @__PURE__ */ new Set()) {
 	const session = await createPlaySession(json, {
 		seed,
 		...opts.behaviors ? { behaviors: opts.behaviors } : {},
@@ -1745,26 +1787,47 @@ async function runOnce(json, seed, opts) {
 	];
 	const down = scene.dimension === "2d" ? 1 : -1;
 	const pull = gravityMagnitude(scene.physics);
-	const floor = opts.fallBelow ?? (pull > 0 ? start[1] + down * (down > 0 ? FALL_2D_PX : 50) : null);
+	const topDown = hasTopDownController(scene.root);
+	const floor = opts.fallBelow ?? (pull > 0 && !topDown ? start[1] + down * (down > 0 ? FALL_2D_PX : 50) : null);
 	const radius = opts.reachRadius ?? (down > 0 ? REACH_2D_PX : 2);
 	const recorder = startRecording(engine);
 	const botRng = new Rng((seed ^ 2654435769) >>> 0);
 	const rand = () => botRng.next();
 	const driver = new Driver(engine, rand);
+	driver.avoidPressing(avoid);
 	const reached = /* @__PURE__ */ new Set();
 	const stepMs = 1e3 / 60;
 	const deadline = (opts.seconds ?? 60) * 1e3;
 	let outcome = null;
 	let swappedAtMs = null;
+	let restartedBy = null;
 	const heardSoFar = /* @__PURE__ */ new Set();
 	const shownSoFar = /* @__PURE__ */ new Set();
-	const offSwap = engine.sceneChanged.connect(() => {
+	const playing = scene.source.name;
+	const offSwap = engine.sceneChanged.connect((next) => {
 		swappedAtMs ??= session.timeMs;
+		if (next && next.source.name === playing) restartedBy ??= driver.blame();
 	});
 	let at = start;
 	let wentAsFarAs = 0;
 	const travelled = (a, b) => scene.dimension === "2d" ? Math.hypot((a[0] ?? 0) - (b[0] ?? 0), (a[1] ?? 0) - (b[1] ?? 0)) : Math.hypot((a[0] ?? 0) - (b[0] ?? 0), (a[2] ?? 0) - (b[2] ?? 0));
+	const cloneCensus = () => {
+		const out = /* @__PURE__ */ new Map();
+		const walk = (node) => {
+			if (isCloned(node)) {
+				const at2 = node.wiringPath();
+				out.set(at2, (out.get(at2) ?? 0) + 1);
+				return;
+			}
+			for (const child of node.children) walk(child);
+		};
+		const root = engine.scene?.root;
+		if (root) walk(root);
+		return out;
+	};
+	let halfway = null;
 	while (session.timeMs < deadline) {
+		if (halfway === null && session.timeMs >= deadline / 2) halfway = cloneCensus();
 		at = player ? worldOf(player) : start;
 		wentAsFarAs = Math.max(wentAsFarAs, travelled(at, start));
 		driver.step(stepMs / 1e3, at);
@@ -1796,6 +1859,11 @@ async function runOnce(json, seed, opts) {
 	}
 	driver.release();
 	offSwap();
+	const aliveClones = [...cloneCensus()].map(([path, count]) => ({
+		path,
+		count,
+		half: halfway?.get(path) ?? 0
+	})).sort((a, b) => b.count - a.count);
 	const WENT_NOWHERE = scene.dimension === "2d" ? STUCK_2D_PX : STUCK_3D_M;
 	outcome ??= wentAsFarAs > WENT_NOWHERE || driver.clicksLanded > 0 || driver.dragsMade > 0 || driver.widgetsPressed > 0 || driver.slotsDragged > 0 ? "unfinished" : "stuck";
 	for (const path of engine.audio.sources()) heardSoFar.add(path);
@@ -1812,6 +1880,7 @@ async function runOnce(json, seed, opts) {
 		damageTaken: oracle.damage(),
 		errors: engine.stats().errors,
 		errorMessages: logLines(engine, "error"),
+		aliveClones,
 		warnings: logLines(engine, "warn"),
 		replay: bad ? recorder.stop() : null,
 		endedAt: at,
@@ -1836,6 +1905,7 @@ async function runOnce(json, seed, opts) {
 		hazards,
 		hasPlayer: player !== null,
 		froze: driver.paused(),
+		restartedBy,
 		unread: unreadNow
 	};
 }
@@ -1867,6 +1937,7 @@ async function playtest(json, opts = {}) {
 	let hasPlayer = false;
 	let hazards = 0;
 	const froze = /* @__PURE__ */ new Set();
+	const restarted = /* @__PURE__ */ new Set();
 	/**
 	* An action is inert only if NO run read it — one run that took a branch the
 	* others missed is enough to clear it.
@@ -1874,7 +1945,7 @@ async function playtest(json, opts = {}) {
 	let unread = null;
 	for (let i = 0; i < count; i++) {
 		resetMemorySaves();
-		const one = await runOnce(json, base + i, opts);
+		const one = await runOnce(json, base + i, opts, restarted);
 		runs.push(one.run);
 		targets = one.targets;
 		signals = one.signals;
@@ -1882,6 +1953,7 @@ async function playtest(json, opts = {}) {
 		hasPlayer = hasPlayer || one.hasPlayer;
 		hazards = one.hazards;
 		for (const action of one.froze) froze.add(action);
+		if (one.restartedBy) restarted.add(one.restartedBy);
 		unread = unread === null ? one.unread : unread.filter((a) => one.unread.includes(a));
 	}
 	const probe = await createPlaySession(json, {
@@ -1930,6 +2002,7 @@ async function playtest(json, opts = {}) {
 		hasPlayer,
 		hazards,
 		froze: [...froze],
+		restarted: [...restarted],
 		seconds: opts.seconds ?? 60,
 		feedback: {
 			declaredAudio: feedbackNodes.audio,
@@ -1997,6 +2070,33 @@ function playtestText(report) {
 		for (const line of said.slice(1, 3)) lines.push(`  ! ${line}`);
 		if (said.length > 3) lines.push(`  ! … and ${said.length - 3} more`);
 	};
+	/**
+	* What the runs were still holding when they ended, by template.
+	*
+	* The MEDIAN across runs, because one run that happened to end mid-wave says
+	* less than what every run ends with. Reported, never judged: `4 × Tower` is
+	* furniture and `5 × Bolt` is a leak, and the engine cannot tell which of an
+	* author's clones are meant to outlive the run — but the author can, in one
+	* glance, which is exactly what was missing when a shipped game kept every
+	* projectile that missed alive forever.
+	*/
+	const pushAlive = () => {
+		const worst = /* @__PURE__ */ new Map();
+		for (const run of runs) for (const { path, count, half } of run.aliveClones ?? []) {
+			const at = worst.get(path);
+			if (!at || count > at.end) worst.set(path, {
+				end: count,
+				half
+			});
+		}
+		const named = [...worst].filter(([, x]) => x.end >= 4).map(([path, x]) => ({
+			path,
+			...x
+		})).sort((a, b) => b.end - a.end);
+		if (named.length === 0) return;
+		const shown = named.slice(0, 3).map((x) => `${x.end} × ${x.path} (${x.half} at halfway)`);
+		lines.push(`  · made and still held: ${shown.join(", ")}` + (named.length > 3 ? ` (+${named.length - 3} more)` : "") + " — clones alive when the run ended, and how many there were at the halfway mark. Furniture holds steady; a leak climbs.");
+	};
 	const pushOutcomes = () => {
 		for (const bad of [
 			"error",
@@ -2041,6 +2141,8 @@ function playtestText(report) {
 		pushOutcomes();
 		pushWarnings();
 		if (report.froze.length > 0) lines.push(`  · the bot stopped pressing ${report.froze.map((x) => `\`${x}\``).join(", ")} — pressing it stopped the clock, and a run spent inside a pause menu measures nothing. Your game is fine; this is the bot getting out of its own way.`);
+		if (report.restarted.length > 0) lines.push(`  · the bot stopped pressing ${report.restarted.map((x) => `\`${x}\``).join(", ")} — pressing it reloaded the scene, which ends the run: the bot is bound to the tree it started in. One run paid for that; the rest played the game.`);
+		pushAlive();
 		return lines.join("\n");
 	}
 	pushOutcomes();
@@ -2069,6 +2171,11 @@ function playtestText(report) {
 		lines.push("");
 		lines.push(`  · the bot stopped pressing ${report.froze.map((a) => `\`${a}\``).join(", ")} — pressing it stopped the clock, and a run spent inside a pause menu measures nothing. Your game is fine; this is the bot getting out of its own way.`);
 	}
+	if (report.restarted.length > 0) {
+		lines.push("");
+		lines.push(`  · the bot stopped pressing ${report.restarted.map((a) => `\`${a}\``).join(", ")} — pressing it reloaded the scene, which ends the run: the bot is bound to the tree it started in. One run paid for that; the rest played the game.`);
+	}
+	pushAlive();
 	if (report.inertActions.length > 0) {
 		lines.push("");
 		lines.push(`  · declared and never read: ${report.inertActions.map((a) => `\`${a}\``).join(", ")} — the scene binds a key for it and no code asks whether it is pressed, so the control list promises something the game does not do. Read it, or drop it from \`input\`. (An action only polled on a screen no run reached is a false alarm.)`);
@@ -2646,8 +2753,12 @@ async function makeProbe(json, opts) {
 	const player = findPlayer(session.scene.root);
 	const declared = session.engine.input.declaredActions();
 	const moveOptions = declared.filter((a) => a.type === "vector2").map((a) => a.name);
-	const move = opts.moveAction ?? moveOptions[0] ?? null;
-	const jump = opts.jumpAction ?? (declared.some((a) => a.name === "jump" && a.type === "button") ? "jump" : null);
+	const named = (prop, type) => {
+		const want = controllerProp(session.scene.root, prop);
+		return want && declared.some((a) => a.name === want && a.type === type) ? want : null;
+	};
+	const move = opts.moveAction ?? named("moveAction", "vector2") ?? moveOptions[0] ?? null;
+	const jump = opts.jumpAction ?? named("jumpAction", "button") ?? (declared.some((a) => a.name === "jump" && a.type === "button") ? "jump" : null);
 	if (!player) {
 		session.dispose();
 		return {
@@ -3181,6 +3292,20 @@ function feelText(report) {
 	}
 	return lines.join("\n");
 }
+/** The action name a `CharacterController2D/3D` in this tree says it reads. */
+function controllerProp(root, prop) {
+	const stack = [root];
+	while (stack.length > 0) {
+		const node = stack.pop();
+		const type = node.constructor.typeName ?? "";
+		if (type === "CharacterController2D" || type === "CharacterController3D") {
+			const value = node[prop];
+			return typeof value === "string" && value !== "" ? value : null;
+		}
+		for (const child of node.children) stack.push(child);
+	}
+	return null;
+}
 //#endregion
 //#region src/test/multiplay.ts
 /** Run a whole match headlessly and report what the clients ended up sharing. */
@@ -3264,8 +3389,8 @@ async function playMultiplayer(opts) {
 */
 async function joinLate(server, first, opts) {
 	try {
-		const { Engine } = await import("./register-6DYnKZcy.js").then((n) => n.y);
-		const { loadScene } = await import("./save-slots-BXVg148r.js").then((n) => n.m);
+		const { Engine } = await import("./register-5IYfooAN.js").then((n) => n.y);
+		const { loadScene } = await import("./save-slots-CEuJPUle.js").then((n) => n.g);
 		const { jsonClone } = await import("./json-CfTjpvW8.js").then((n) => n.i);
 		const engine = new Engine(opts.seed !== void 0 ? { seed: opts.seed + 999 } : {});
 		engine.setScene(loadScene(jsonClone(opts.scene), opts.load));
@@ -3466,6 +3591,106 @@ function saysRung(report) {
 		...warnings.length > 3 ? { fix: "the rest are in `incanto-logs`" } : {}
 	};
 }
+/**
+* What to say when the bot could not WALK — which is not the same as could not
+* play.
+*
+* This branch was "nobody to move", said about games the bot had played for
+* eight runs. The MOUSE half was fixed when a flip puzzle whose every tile the
+* bot clicked was told to add a character controller; the KEYBOARD half was
+* found the same way, one genre along: a sokoban declares `move`, `undo` and
+* `restart`, a behaviour reads them every frame and moves plain nodes, and the
+* bot pressed them 989 times across eight runs — while the rung said
+*
+*   ? plays — nothing here is drivable — 8 runs had nobody to move and
+*     nothing to click
+*
+* Both halves of that sentence were false. A whole class — sokoban, snake,
+* tetris, roguelikes, typing games, anything on a grid — has no character to
+* add, and the advice was to add one anyway.
+*
+* PRESSED and READ, not merely declared: `inertActions` is the report's own
+* list of actions nothing asks about, and a scene where every one of them is
+* inert really does have nothing driving it.
+*
+* Pure, so the wording can be tested without running a game.
+*/
+function unmeasuredPlays(report) {
+	const runs = report.runs ?? [];
+	const total = runs.length;
+	const clicks = runs.reduce((n, r) => n + (r.clicks ?? 0), 0);
+	const keyed = runs.reduce((n, r) => n + (r.actionPresses ?? 0), 0);
+	const live = (report.actions ?? []).filter((a) => !(report.inertActions ?? []).includes(a));
+	const ending = report.declaresWin ? "and no run reached the win" : "and no win to reach";
+	if (clicks > 0) return {
+		summary: `played with the MOUSE — ${clicks} click(s) across ${total} runs, ${ending}`,
+		fix: "a mouse game is played, not walked — emit `won`/`lost` and this rung can pass"
+	};
+	if (keyed > 0 && live.length > 0) return {
+		summary: `played with the KEYBOARD — ${keyed} press(es) of ${live.length} declared action(s) (${live.slice(0, 4).join(", ")}) across ${total} runs, ${ending}`,
+		fix: "a game played by KEYS is played, not walked — emit `won`/`lost` and this rung can pass. (A random presser will not solve a puzzle: drive the solution in a scripted `runScript` harness, and let this rung tell you about crashes.)"
+	};
+	if (report.hasPlayer === false) return {
+		summary: `nothing here is drivable — ${total} runs had nobody to move and nothing to click`,
+		fix: "give the player a character controller, the `player` group, or the name Player — or `Clickable` on what the cursor drives"
+	};
+	return {
+		summary: `${total} runs went nowhere, and your behaviours were not loaded — that is most of what moves a character`,
+		fix: `name them: \`incanto-verify ${report.scene ?? "src/game.scene.json"} --behaviors src/behaviors.ts\``
+	};
+}
+/**
+* What the run HEARD and SHOWED, as one rung.
+*
+* Pure, like `saysRung` and `unmeasuredPlays`: the bin owns running the
+* playtest, this owns what its feedback log means. Extracted when the
+* all-silent branch was found printing a COUNT with nothing beside it —
+* `racing-3d` reports 20 emitters and its scene declares none of them (they are
+* a pool of `new Particles3D()` built in `onReady`), so an author counted
+* twenty in a message and found zero in their JSON.
+*/
+function feelsRung(fb, opts = {}) {
+	if (!fb) return {
+		name: "feels",
+		status: "skipped",
+		summary: "not run — the playtest did not report"
+	};
+	const declaredPaths = [...fb.declaredAudio ?? [], ...fb.declaredEffects ?? []];
+	const declared = declaredPaths.length;
+	const fired = new Set([...fb.heard ?? [], ...fb.shown ?? []]);
+	if (declared === 0) return {
+		name: "feels",
+		status: "skipped",
+		summary: "this game declares no sound and no effects"
+	};
+	const some = (list) => `${list.slice(0, 3).join(", ")}${list.length > 3 ? ` +${list.length - 3}` : ""}`;
+	if (fired.size === 0) {
+		if (opts.played === false) return {
+			name: "feels",
+			status: "unmeasured",
+			summary: `${declared} sound/effect node(s) in the tree and none fired — but no run got the game moving, so nothing here was measured — ${some(declaredPaths)}`,
+			fix: "drive it in a scripted run (`runScript` from `incanto/test`): a sustained throttle, a real fight, the actual verb. A random bot that never gets going triggers nothing, and that is a fact about the bot."
+		};
+		return {
+			name: "feels",
+			status: "fail",
+			summary: `${declared} sound/effect node(s) in the tree, and not one fired in any run — ${some(declaredPaths)}`,
+			fix: "connect them — a signal to `play` on an AudioPlayer, or `replay()` on a one-shot; `engine.audio.recent()` and `engine.effects.recent()` say what did fire"
+		};
+	}
+	const silent = declaredPaths.filter((path) => !fired.has(path));
+	if (silent.length === 0) return {
+		name: "feels",
+		status: "pass",
+		summary: `every one of the ${declared} sound/effect nodes fired`
+	};
+	return {
+		name: "feels",
+		status: "unmeasured",
+		summary: `${declared - silent.length} of ${declared} fired — silent: ${some(silent)}`,
+		fix: "a silent emitter is either a broken wire or a moment random play never reached — the two look identical from here. Reach it in a scripted run (`runScript` from `incanto/test`), and this rung can tell you which."
+	};
+}
 function ladderVerdict(rungs, ctx = {}) {
 	const failed = rungs.find((r) => r.status === "fail");
 	const unmeasured = rungs.filter((r) => r.status === "unmeasured");
@@ -3556,7 +3781,10 @@ function findFloatingProps(json, opts = {}) {
 	const types = new Set(opts.types ?? GROUNDED_TYPES);
 	let scene;
 	try {
-		scene = loadScene(json, { stubMissingBehaviors: true });
+		scene = loadScene(json, {
+			stubMissingBehaviors: true,
+			engine: new Engine({ scheduler: () => () => {} })
+		});
 	} catch (error) {
 		throw new IncantoError("BAD_FORMAT", `findFloatingProps: the scene does not load, so nothing could be measured. ${error?.message ?? String(error)}`);
 	}
@@ -3760,10 +3988,10 @@ async function runScript(json, opts) {
 	if (opts.locale) engine.locale.locale = opts.locale;
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-CE0Qvy3V.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-DrIgTlLk.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-CpH-2gn5.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-BzOCw1VS.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -3990,10 +4218,10 @@ async function createPlaySession(json, opts = {}) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-CE0Qvy3V.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-DrIgTlLk.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-CpH-2gn5.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-BzOCw1VS.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);
@@ -4033,4 +4261,4 @@ async function createPlaySession(json, opts = {}) {
 	};
 }
 //#endregion
-export { pointAtNode as A, failingReplays as C, playtestText as D, playtestFailed as E, framingText as M, sceneAssetUrls as N, geometricPicker as O, facingText as S, playtest as T, takeAgreementSnapshots as _, registerAllNodes as a, collectionProblems as b, firstLine as c, saysRung as d, multiplayProblems as f, feelText as g, feelReport as h, findFloatingProps as i, describeFraming as j, geometricView as k, ladderText as l, playMultiplayer as m, createPlaySession as n, runScript as o, multiplayText as p, describeCapture as r, validateScene as s, captureScene as t, ladderVerdict as u, takeCollectionSnapshots as v, findPlayer as w, facingReport as x, agreementProblems as y };
+export { geometricPicker as A, facingReport as C, playtest as D, findPlayer as E, sceneAssetUrls as F, pointAtNode as M, describeFraming as N, playtestFailed as O, framingText as P, collectionProblems as S, failingReplays as T, feelReport as _, registerAllNodes as a, takeCollectionSnapshots as b, feelsRung as c, ladderVerdict as d, saysRung as f, playMultiplayer as g, multiplayText as h, findFloatingProps as i, geometricView as j, playtestText as k, firstLine as l, multiplayProblems as m, createPlaySession as n, runScript as o, unmeasuredPlays as p, describeCapture as r, validateScene as s, captureScene as t, ladderText as u, feelText as v, facingText as w, agreementProblems as x, takeAgreementSnapshots as y };

package/dist/test.d.ts

@@ -1,8 +1,8 @@
-import { P as Scene$1, Pt as LogEntry, b as Engine, jt as Node, n as BehaviorCtor } from "./behavior-DZExDn9o.js";
+import { P as Scene$1, Pt as LogEntry, b as Engine, jt as Node, n as BehaviorCtor } from "./behavior-Bf9P9oB2.js";
 import { a as SceneJson, c as JsonValue, s as JsonObject } from "./rng-Bb-IutXB.js";
-import { t as LoadSceneOptions } from "./loader-Cff09LMm.js";
-import { l as auditScene, o as IncantoError, r as ReplayJson, u as instancedScenes } from "./replay-Dmw-PKQu.js";
-import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen--k-XpBjr.js";
+import { t as LoadSceneOptions } from "./loader-CBfQzB6S.js";
+import { l as auditScene, o as IncantoError, r as ReplayJson, u as instancedScenes } from "./replay-CBEChqXq.js";
+import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-DkqLng6q.js";
 import { Matrix4, Vector3 } from "three";
 
 //#region src/core/asset-urls.d.ts
@@ -639,6 +639,24 @@ interface PlaytestRun {
   * said `✗ error in 2/2` and nothing an author could act on.
   */
   errorMessages: string[];
+  /**
+  * What this run MADE and was still holding when it ended, by template.
+  *
+  * A shipped tower defense kept every projectile that MISSED alive forever —
+  * its `Lifetime` had been left asleep on the prefab shelf — and no instrument
+  * said so: the playtest reported the game as fine, the audit passed, the
+  * harness passed, every rung was green. Total node count is too blunt to be
+  * the answer, because a tower defense legitimately ENDS with four towers
+  * standing and a survivor with a swarm. Grouped by the AUTHORED template
+  * (`Node.wiringPath`), the two read differently at a glance: `4 × Tower` is
+  * furniture and `5 × Bolt` is a leak, and only the author can tell them
+  * apart — so this is reported and never judged.
+  */
+  aliveClones: {
+    path: string;
+    count: number;
+    half: number;
+  }[];
   /** Only for a run worth watching — replay it with `incanto-play`. */
   replay: ReplayJson | null;
   /** Where the player ended up, for the fall report. */
@@ -753,6 +771,23 @@ interface PlaytestReport {
   */
   froze: string[];
   /**
+  * Actions the bot stopped pressing because they STARTED THE LEVEL OVER.
+  *
+  * The sibling of `froze`, and it hid behind it: a run inside a pause menu
+  * measures nothing, and a run that reloads the scene measures nothing EITHER
+  * — except that one is over, because the bot is bound to the tree it began
+  * in. Measured on one losable scene, ten runs: `lost 10/10` without a
+  * mid-play restart, `lost 0/10 · swapped 10/10` with one, and the rung read
+  * `? 10 runs played without reaching a win (10 changed scene)`.
+  *
+  * Mid-run retry is ordinary — puzzle, racing, tower defense — and the
+  * engine's own `GameFlow` restarts only from a terminal state, so the games
+  * this ruined are the ones that wired `restartScene` themselves, exactly as
+  * the skills tell them to. Observed, never read off the word "restart": the
+  * scene being played was replaced by that same scene.
+  */
+  restarted: string[];
+  /**
   * Did `findPlayer` find anyone to drive?
   *
   * `findPlayer`'s own comment says a scene it cannot drive "says so rather
@@ -941,6 +976,79 @@ declare function saysRung(report: {
     errors?: number;
   };
 } | null): RungResult;
+/**
+* What to say when the bot could not WALK — which is not the same as could not
+* play.
+*
+* This branch was "nobody to move", said about games the bot had played for
+* eight runs. The MOUSE half was fixed when a flip puzzle whose every tile the
+* bot clicked was told to add a character controller; the KEYBOARD half was
+* found the same way, one genre along: a sokoban declares `move`, `undo` and
+* `restart`, a behaviour reads them every frame and moves plain nodes, and the
+* bot pressed them 989 times across eight runs — while the rung said
+*
+*   ? plays — nothing here is drivable — 8 runs had nobody to move and
+*     nothing to click
+*
+* Both halves of that sentence were false. A whole class — sokoban, snake,
+* tetris, roguelikes, typing games, anything on a grid — has no character to
+* add, and the advice was to add one anyway.
+*
+* PRESSED and READ, not merely declared: `inertActions` is the report's own
+* list of actions nothing asks about, and a scene where every one of them is
+* inert really does have nothing driving it.
+*
+* Pure, so the wording can be tested without running a game.
+*/
+declare function unmeasuredPlays(report: {
+  runs?: readonly {
+    clicks?: number;
+    actionPresses?: number;
+  }[];
+  actions?: readonly string[];
+  inertActions?: readonly string[];
+  hasPlayer?: boolean;
+  declaresWin?: boolean;
+  behaviorsLoaded?: boolean;
+  scene?: string;
+}): {
+  summary: string;
+  fix: string;
+};
+/**
+* What the run HEARD and SHOWED, as one rung.
+*
+* Pure, like `saysRung` and `unmeasuredPlays`: the bin owns running the
+* playtest, this owns what its feedback log means. Extracted when the
+* all-silent branch was found printing a COUNT with nothing beside it —
+* `racing-3d` reports 20 emitters and its scene declares none of them (they are
+* a pool of `new Particles3D()` built in `onReady`), so an author counted
+* twenty in a message and found zero in their JSON.
+*/
+declare function feelsRung(fb: {
+  declaredAudio?: readonly string[];
+  declaredEffects?: readonly string[];
+  heard?: readonly string[];
+  shown?: readonly string[];
+} | null | undefined, opts?: {
+  /**
+  * Did the bot get the game MOVING at all?
+  *
+  * Zero emitters firing is a broken wire only if something was played. On
+  * `racing-3d` — 20 pooled `Particles3D`, a car that needs a SUSTAINED
+  * throttle — a random presser never gets it rolling, every run comes back
+  * `stuck`, and this rung printed `✗ 20 … and not one fired in any run`
+  * about a game whose emitters all fire the moment anyone drives it
+  * (measured: hold throttle + steer for 12s, all 20 fire).
+  *
+  * The partial case beside it has always said the two are indistinguishable
+  * — "either a broken wire or a moment random play never reached" — and the
+  * zero case has exactly the same ambiguity when nothing was driven. Same
+  * flag the `plays` rung uses, so the two never disagree about whether the
+  * bot played.
+  */
+  played?: boolean;
+}): RungResult;
 declare function ladderVerdict(rungs: RungResult[], ctx?: LadderContext): LadderVerdict;
 /** The ladder as a person or an agent reads it: every rung, then the one action. */
 declare function ladderText(v: LadderVerdict): string;
@@ -1201,4 +1309,4 @@ interface PlaySession {
 */
 declare function createPlaySession(json: unknown, opts?: PlaySessionOptions): Promise<PlaySession>;
 //#endregion
-export { type AgreementSnapshot, type CollectionSnapshot, type Disagreement, type DisagreementKind, type FacingOptions, type FacingReport, type FeelOptions, type FeelReport, type FramingEntry, type FramingOptions, type FramingReport, GroundingIssue, GroundingOptions, type LadderVerdict, type MultiplayOptions, type MultiplayPlayer, type MultiplayReport, NodeCapture, type Outcome, type PickerOptions, PlaySession, PlaySessionOptions, type PlaytestOptions, type PlaytestReport, type PlaytestRun, RunContext, RunFailure, RunResult, RunScriptOptions, type RungResult, type RungStatus, type SceneAssetUrl, SceneCapture, ScriptStep, ValidateSceneOptions, ValidationResult, type Where, agreementProblems, auditScene, captureScene, collectionProblems, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, firstLine, framingText, geometricPicker, geometricView, instancedScenes, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestFailed, playtestText, pointAtNode, registerAllNodes, runScript, saysRung, sceneAssetUrls, takeAgreementSnapshots, takeCollectionSnapshots, validateScene };
+export { type AgreementSnapshot, type CollectionSnapshot, type Disagreement, type DisagreementKind, type FacingOptions, type FacingReport, type FeelOptions, type FeelReport, type FramingEntry, type FramingOptions, type FramingReport, GroundingIssue, GroundingOptions, type LadderVerdict, type MultiplayOptions, type MultiplayPlayer, type MultiplayReport, NodeCapture, type Outcome, type PickerOptions, PlaySession, PlaySessionOptions, type PlaytestOptions, type PlaytestReport, type PlaytestRun, RunContext, RunFailure, RunResult, RunScriptOptions, type RungResult, type RungStatus, type SceneAssetUrl, SceneCapture, ScriptStep, ValidateSceneOptions, ValidationResult, type Where, agreementProblems, auditScene, captureScene, collectionProblems, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, feelsRung, findFloatingProps, findPlayer, firstLine, framingText, geometricPicker, geometricView, instancedScenes, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestFailed, playtestText, pointAtNode, registerAllNodes, runScript, saysRung, sceneAssetUrls, takeAgreementSnapshots, takeCollectionSnapshots, unmeasuredPlays, validateScene };

package/dist/test.js

@@ -1,3 +1,3 @@
-import { i as instancedScenes, r as auditScene } from "./replay-DjAkAzMq.js";
-import { A as pointAtNode, C as failingReplays, D as playtestText, E as playtestFailed, M as framingText, N as sceneAssetUrls, O as geometricPicker, S as facingText, T as playtest, _ as takeAgreementSnapshots, a as registerAllNodes, b as collectionProblems, c as firstLine, d as saysRung, f as multiplayProblems, g as feelText, h as feelReport, i as findFloatingProps, j as describeFraming, k as geometricView, l as ladderText, m as playMultiplayer, n as createPlaySession, o as runScript, p as multiplayText, r as describeCapture, s as validateScene, t as captureScene, u as ladderVerdict, v as takeCollectionSnapshots, w as findPlayer, x as facingReport, y as agreementProblems } from "./test-iHYVUcDK.js";
-export { agreementProblems, auditScene, captureScene, collectionProblems, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, firstLine, framingText, geometricPicker, geometricView, instancedScenes, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestFailed, playtestText, pointAtNode, registerAllNodes, runScript, saysRung, sceneAssetUrls, takeAgreementSnapshots, takeCollectionSnapshots, validateScene };
+import { i as instancedScenes, r as auditScene } from "./replay-datiAE-b.js";
+import { A as geometricPicker, C as facingReport, D as playtest, E as findPlayer, F as sceneAssetUrls, M as pointAtNode, N as describeFraming, O as playtestFailed, P as framingText, S as collectionProblems, T as failingReplays, _ as feelReport, a as registerAllNodes, b as takeCollectionSnapshots, c as feelsRung, d as ladderVerdict, f as saysRung, g as playMultiplayer, h as multiplayText, i as findFloatingProps, j as geometricView, k as playtestText, l as firstLine, m as multiplayProblems, n as createPlaySession, o as runScript, p as unmeasuredPlays, r as describeCapture, s as validateScene, t as captureScene, u as ladderText, v as feelText, w as facingText, x as agreementProblems, y as takeAgreementSnapshots } from "./test-Djuq3Vhq.js";
+export { agreementProblems, auditScene, captureScene, collectionProblems, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, feelsRung, findFloatingProps, findPlayer, firstLine, framingText, geometricPicker, geometricView, instancedScenes, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestFailed, playtestText, pointAtNode, registerAllNodes, runScript, saysRung, sceneAssetUrls, takeAgreementSnapshots, takeCollectionSnapshots, unmeasuredPlays, validateScene };