npm - frogoe - Versions diffs - 0.3.2 → 0.5.5 - Mend

frogoe 0.3.2 → 0.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md +19 -2
package/dist/cli.js +2920 -1358
package/dist/injected-runtime.js +247 -0
package/dist/templates/_shared/AGENTS.md +18 -12
package/dist/templates/_shared/CLAUDE.md +18 -12
package/package.json +1 -1

package/dist/cli.js CHANGED Viewed

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+// frogoe CLI — BUNDLED CODE (esbuild). Reading this wastes tokens.
+// Source: github.com/frogoe/engine/tree/main/packages/cli/src/
+// How-to: frogoe --help, or skills/frogoe-creative/references/art.md
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __esm = (fn, res) => function __init() {
@@ -82,9 +85,28 @@ TODO \u2014 two lines: what the player does, and what ends the run.
 </html>
 `;
     gameTemplate = `/** My Game \u2014 the whole simulation in one closure. Replace everything
- *  below with your game; the four nouns are the entire platform. */
+ *  below with your game; the four nouns are the entire platform.
+ *  Keep the palette exported: the identity scenes (assets/) draw with
+ *  it, so key art stays 1:1 with the shipped game. */
 import { defineGame } from "frogoe";
+export const C = { bg: "#101418", fg: "#fffdf7", accent: "#ffd166" };
+/** SPRITES \u2014 the frogoe vision workbench registry: each object
+ *  rendered in isolation and ASCII-mapped by 'frogoe vision'. TODO:
+ *  add one entry per drawable as your sprites take shape. */
+export const SPRITES = {
+  ball: {
+    w: 120, h: 120,
+    draw: (ctx) => {
+      ctx.fillStyle = C.fg;
+      ctx.beginPath();
+      ctx.arc(60, 60, 34, 0, 7);
+      ctx.fill();
+    },
+  },
+};
 defineGame(({ stage, input, loop, finish }) => {
   let t = 0;
   let x = stage.play.center;
@@ -100,7 +122,7 @@ defineGame(({ stage, input, loop, finish }) => {
   loop.render = (ctx) => {
     ctx.clearRect(0, 0, stage.width, stage.height);
-    ctx.fillStyle = "#fffdf7";
+    ctx.fillStyle = C.fg;
     ctx.beginPath();
     ctx.arc(x, stage.height / 2, 14 + Math.sin(t * 3) * 3, 0, 7);
     ctx.fill();
@@ -198,10 +220,25 @@ var init_add = __esm({
       const styleOpen = source.indexOf("<style>");
       const styleClose = source.indexOf("</style>");
       const css = styleOpen === -1 || styleClose === -1 || styleClose < styleOpen ? null : source.slice(styleOpen + "<style>".length, styleClose);
-      return {
-        css: css?.trim() ?? null,
-        markup: (styleClose === -1 ? "" : source.slice(styleClose + "</style>".length)).trim()
-      };
+      const fromMarker = source.indexOf("COPY FROM HERE");
+      const toMarker = source.indexOf("COPY TO HERE");
+      let markup;
+      if (fromMarker !== -1 && toMarker !== -1 && toMarker > fromMarker) {
+        const afterFrom = source.indexOf("-->", fromMarker);
+        const beforeTo = source.lastIndexOf("<!--", toMarker);
+        markup = afterFrom !== -1 && beforeTo !== -1 && beforeTo > afterFrom ? source.slice(afterFrom + 3, beforeTo).trim() : "";
+      } else {
+        markup = (styleClose === -1 ? "" : source.slice(styleClose + "</style>".length)).trim();
+        for (const closer of ["</body>", "</html>"]) {
+          const idx = markup.lastIndexOf(closer);
+          if (idx !== -1) markup = markup.slice(0, idx).trim();
+        }
+        for (const opener of ["</head>", "<body>", "<html...>"]) {
+          const idx = markup.toLowerCase().indexOf(opener.toLowerCase());
+          if (idx === 0) markup = markup.slice(opener.length).trim();
+        }
+      }
+      return { css: css?.trim() ?? null, markup };
     };
     blockMarker = (name) => `<!-- frogoe:block:${name} -->`;
     injectIntoHtml = (html, name, css, markup, placement) => {
@@ -532,9 +569,9 @@ var init_bundle = __esm({
       });
       const seen = /* @__PURE__ */ new Map();
       const resolveFont = async (url) => {
-        const cached = seen.get(url);
-        if (cached) {
-          return cached;
+        const cached2 = seen.get(url);
+        if (cached2) {
+          return cached2;
         }
         assertAllowedRemote(url, options.extraAllowedHosts);
         const res = options.fetchImpl ? await options.fetchImpl(url, { headers: { "user-agent": FONT_UA } }) : await fetch(url, { headers: { "user-agent": FONT_UA } });
@@ -670,63 +707,6 @@ ${css}
   }
 });
-// src/commands/bundle.ts
-var bundle_exports = {};
-__export(bundle_exports, {
-  command: () => command2
-});
-import { defineCommand as defineCommand2 } from "citty";
-import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
-import path4 from "path";
-var command2;
-var init_bundle2 = __esm({
-  "src/commands/bundle.ts"() {
-    "use strict";
-    init_bundle();
-    command2 = defineCommand2({
-      args: {
-        dir: { type: "positional", required: false, description: "game folder (default: cwd)" },
-        json: { type: "boolean", description: "machine-readable report" },
-        out: { type: "string", description: "output path (default: dist/index.html)" }
-      },
-      async run({ args }) {
-        const dir = args.dir ? String(args.dir) : process.cwd();
-        const report = await bundle({ dir });
-        const outPath = args.out ? path4.resolve(String(args.out)) : path4.join(dir, "dist", "index.html");
-        mkdirSync3(path4.dirname(outPath), { recursive: true });
-        writeFileSync3(outPath, report.artifact, "utf-8");
-        for (const warning of report.warnings) {
-          console.log(`  \u26A0 ${warning}`);
-        }
-        if (args.json) {
-          console.log(
-            JSON.stringify(
-              {
-                artifact: outPath,
-                assets: report.assets,
-                bytes: report.bytes,
-                sha256: report.sha256,
-                warnings: report.warnings
-              },
-              null,
-              2
-            )
-          );
-        } else {
-          console.log(`  frogoe bundle \u2192 ${outPath}`);
-          console.log(
-            `  ${report.bytes} bytes \xB7 ${report.assets.length} dissolved asset(s) \xB7 sha256 ${report.sha256.slice(0, 12)}`
-          );
-          for (const asset of report.assets) {
-            console.log(`    ${asset.kind.padEnd(5)} ${asset.source}`);
-          }
-        }
-      },
-      meta: { description: "dissolve externals into one self-contained HTML" }
-    });
-  }
-});
 // ../lint/src/brief.ts
 var KEY_PATTERN, WS, stripComment, parseLine, parseBrief;
 var init_brief = __esm({
@@ -786,6 +766,177 @@ var init_brief = __esm({
   }
 });
+// ../lint/src/art.ts
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
+import path4 from "path";
+var SPECS, MIN_DRAW_CALLS, DRAW_CALL, SPRITE_CALL, checkArt, checkScene, hexColorsOf, stripComments;
+var init_art = __esm({
+  "../lint/src/art.ts"() {
+    "use strict";
+    init_brief();
+    SPECS = [
+      { draw: "drawPoster", file: "assets/poster.js" },
+      { draw: "drawIcon", file: "assets/icon.js" }
+    ];
+    MIN_DRAW_CALLS = 2;
+    DRAW_CALL = /(?:fillRect|strokeRect|clearRect|beginPath|closePath|arc|ellipse|moveTo|lineTo|quadraticCurveTo|bezierCurveTo|fillText|strokeText|drawImage|roundRect|fill|stroke)\s*\(/gu;
+    SPRITE_CALL = /\bdraw[A-Z]\w*\s*\(/gu;
+    checkArt = (dir, findings) => {
+      const briefPath = path4.join(dir, "BRIEF.md");
+      const brief = existsSync4(briefPath) ? parseBrief(readFileSync4(briefPath, "utf-8")) : void 0;
+      const briefFonts = (brief?.fonts ?? "").split(",").map((token) => token.trim().toLowerCase()).filter((token) => token.length > 0);
+      const gamePath = path4.join(dir, "game.js");
+      const gameSource = existsSync4(gamePath) ? readFileSync4(gamePath, "utf-8") : "";
+      const gameColors = hexColorsOf(stripComments(gameSource));
+      const htmlSource = existsSync4(path4.join(dir, "index.html")) ? readFileSync4(path4.join(dir, "index.html"), "utf-8") : "";
+      for (const spec of SPECS) {
+        const scenePath = path4.join(dir, spec.file);
+        if (!existsSync4(scenePath)) {
+          findings.push({
+            code: "art/missing",
+            file: spec.file,
+            fix: "author the scene \u2014 a canvas composition importing the game's own sprites (frogoe-creative \u2192 references/art.md)",
+            message: `${spec.file} is missing \u2014 poster and icon are authored art, not generated`,
+            recipe: "frogoe-creative \u2192 references/art.md",
+            severity: "error"
+          });
+          continue;
+        }
+        const source = stripComments(readFileSync4(scenePath, "utf-8"));
+        checkScene(source, spec, gameColors, briefFonts, htmlSource, findings);
+      }
+    };
+    checkScene = (source, spec, gameColors, briefFonts, htmlSource, findings) => {
+      if (!new RegExp(`export\\s+(?:async\\s+)?(?:function|const)\\s+${spec.draw}\\b`, "u").test(source)) {
+        findings.push({
+          code: "art/scene-export",
+          file: spec.file,
+          fix: `export the entry the rasterizer calls \u2014 export function ${spec.draw}(ctx, w, h)`,
+          message: `${spec.file} does not export ${spec.draw}()`,
+          severity: "error"
+        });
+      }
+      if (!/from\s+["']\.\.\/game\.js["']/u.test(source)) {
+        findings.push({
+          code: "art/scene-source",
+          file: spec.file,
+          fix: 'import the sprites/palette from the game \u2014 `import { \u2026 } from "../game.js"` \u2014 identity art renders with the game\'s own code',
+          message: `${spec.file} does not import from ../game.js (the art must be 1:1 by construction)`,
+          severity: "error"
+        });
+      }
+      for (const hex of hexColorsOf(source)) {
+        if (!gameColors.has(hex)) {
+          findings.push({
+            code: "art/color-drift",
+            file: spec.file,
+            fix: `use the game's own color for "${hex}" \u2014 import the palette from ../game.js; a color the game never draws has no business in its key art`,
+            message: `${spec.file} uses "${hex}", which game.js never draws`,
+            severity: "error"
+          });
+        }
+      }
+      const fontStrings = [
+        ...source.matchAll(/\.font\s*=\s*'([^']+)'/gu),
+        ...source.matchAll(/\.font\s*=\s*"([^"]+)"/gu)
+      ].map((match) => match[1] ?? "").filter((value) => value.length > 0);
+      for (const font of fontStrings) {
+        const lower = font.toLowerCase();
+        if (!briefFonts.some((family2) => lower.includes(family2))) {
+          findings.push({
+            code: "art/text-font",
+            file: spec.file,
+            fix: briefFonts.length > 0 ? `lettering must use the BRIEF font (${briefFonts.join(", ")}) \u2014 ctx.font = \`700 96px ${briefFonts[0]}\` \u2014 or drop the text` : "this BRIEF declares no fonts \u2014 the poster carries no canvas lettering",
+            message: `canvas font "${font.slice(0, 40)}" is not the game's typography`,
+            severity: "error"
+          });
+          continue;
+        }
+        const family = briefFonts.find((name) => lower.includes(name)) ?? "";
+        const haystack = htmlSource.toLowerCase().replaceAll("+", " ").replaceAll("%20", " ");
+        if (!haystack.includes(family)) {
+          findings.push({
+            code: "art/text-font",
+            file: spec.file,
+            fix: `index.html never loads "${family}" \u2014 add the Google Fonts <link> (the rasterizer dissolves the same stylesheet)`,
+            message: `font "${family}" is used in the art but the game never loads it`,
+            severity: "error"
+          });
+        }
+      }
+      const entryCalls = /* @__PURE__ */ new Set([`drawPoster(`, `drawIcon(`]);
+      const spriteCalls = [...source.matchAll(SPRITE_CALL)].map((match) => match[0] ?? "").filter((call) => !entryCalls.has(call)).length;
+      const drawCalls = [...source.matchAll(DRAW_CALL)].length + spriteCalls;
+      if (drawCalls < MIN_DRAW_CALLS) {
+        findings.push({
+          code: "art/empty",
+          file: spec.file,
+          fix: `compose the scene with real draw calls (found ${drawCalls}) \u2014 an empty or placeholder scene is not key art`,
+          message: `${spec.file} barely draws anything`,
+          severity: "error"
+        });
+      }
+      if (spec.draw === "drawPoster" && !source.includes("__frogoeTitleBand")) {
+        findings.push({
+          code: "art/title-band",
+          file: spec.file,
+          fix: "declare the lettering block from the layout variables \u2014 ctx.__frogoeTitleBand = [x0, y0, x1, y1] (never hand-typed: the render is the only truth)",
+          message: "the poster declares no title band \u2014 bundle's safe-zone collision check stays off",
+          recipe: "frogoe-creative \u2192 references/art.md",
+          severity: "warning"
+        });
+      }
+      if (spec.draw === "drawPoster" && !/fillText|strokeText/u.test(source)) {
+        findings.push({
+          code: "art/title-presence",
+          file: spec.file,
+          fix: "draw the logotype \u2014 ctx.font with the BRIEF font, strokeText outline first (frogoe-creative \u2192 references/art.md); shape-drawn lettering is the legal alternative",
+          message: "the poster has no canvas lettering \u2014 Steam's capsule rules require a readable logotype",
+          recipe: "frogoe-creative \u2192 references/art.md",
+          severity: "warning"
+        });
+      }
+    };
+    hexColorsOf = (source) => {
+      const colors = /* @__PURE__ */ new Set();
+      for (const match of source.matchAll(/#[0-9a-fA-F]{3}\b|#[0-9a-fA-F]{6}\b/gu)) {
+        const hex = (match[0] ?? "").toLowerCase();
+        colors.add(hex.length === 4 ? `#${hex[1]}${hex[1]}${hex[2]}${hex[2]}${hex[3]}${hex[3]}` : hex);
+      }
+      return colors;
+    };
+    stripComments = (source) => {
+      let out = "";
+      let i = 0;
+      while (i < source.length) {
+        const line = source.indexOf("//", i);
+        const block = source.indexOf("/*", i);
+        if (line === -1 && block === -1) {
+          out += source.slice(i);
+          break;
+        }
+        const at = block !== -1 && (line === -1 || block < line) ? block : line !== -1 ? line : -1;
+        if (at === block) {
+          out += source.slice(i, at);
+          const end = source.indexOf("*/", at + 2);
+          i = end === -1 ? source.length : end + 2;
+        } else {
+          const isProtocol = at > 0 && source[at - 1] === ":";
+          if (isProtocol) {
+            out += source.slice(i, at + 2);
+            i = at + 2;
+          } else {
+            out += source.slice(i, at);
+            const end = source.indexOf("\n", at);
+            i = end === -1 ? source.length : end;
+          }
+        }
+      }
+      return out;
+    };
+  }
+});
 // ../lint/src/contrast.ts
 var HEX, isHex, contrastRatio;
 var init_contrast = __esm({
@@ -812,7 +963,7 @@ var init_contrast = __esm({
 });
 // ../lint/src/check.ts
-import { existsSync as existsSync4, readdirSync, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync5, readdirSync, readFileSync as readFileSync5 } from "fs";
 import path5 from "path";
 var VERBS, read, linesOf, findLine, checkBrief, checkFolder, checkPin, checkProject;
 var init_check = __esm({
@@ -820,10 +971,11 @@ var init_check = __esm({
     "use strict";
     init_brief();
     init_contrast();
+    init_art();
     VERBS = /* @__PURE__ */ new Set(["tap", "hold", "steer", "aim"]);
     read = (file) => {
       try {
-        return readFileSync4(file, "utf-8");
+        return readFileSync5(file, "utf-8");
       } catch {
         return "";
       }
@@ -835,7 +987,7 @@ var init_check = __esm({
     };
     checkBrief = (dir, findings) => {
       const file = path5.join(dir, "BRIEF.md");
-      if (!existsSync4(file)) {
+      if (!existsSync5(file)) {
         findings.push({
           code: "brief/missing",
           file: "BRIEF.md",
@@ -1068,7 +1220,7 @@ var init_check = __esm({
       }
       const blocksDir = path5.join(dir, "blocks");
       let markup = index;
-      if (existsSync4(blocksDir)) {
+      if (existsSync5(blocksDir)) {
         for (const f of readdirSync(blocksDir)) {
           if (f.endsWith(".html")) {
             markup += read(path5.join(blocksDir, f));
@@ -1092,7 +1244,7 @@ var init_check = __esm({
     };
     checkPin = (dir, findings) => {
       const pinFile = path5.join(dir, "frogoe.json");
-      if (!existsSync4(pinFile)) {
+      if (!existsSync5(pinFile)) {
         findings.push({
           code: "folder/contract-pin",
           file: "frogoe.json",
@@ -1129,6 +1281,7 @@ var init_check = __esm({
     };
     checkProject = (dir) => {
       const findings = [];
+      checkArt(dir, findings);
       checkBrief(dir, findings);
       checkFolder(dir, findings);
       checkPin(dir, findings);
@@ -1146,1305 +1299,1831 @@ var init_check = __esm({
 var init_src = __esm({
   "../lint/src/index.ts"() {
     "use strict";
+    init_art();
     init_brief();
     init_contrast();
     init_check();
   }
 });
-// src/check.ts
-var formatFindings;
-var init_check2 = __esm({
-  "src/check.ts"() {
+// src/runtime-source.ts
+import { readFileSync as readFileSync6 } from "fs";
+import path6 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var here2, cached, runtimeSource, functions, runtimeFunctions;
+var init_runtime_source = __esm({
+  "src/runtime-source.ts"() {
     "use strict";
-    init_src();
-    init_src();
-    init_src();
-    formatFindings = (result) => result.findings.map((f) => {
-      const at = f.line !== void 0 ? `:${f.line}` : "";
-      const head = `${f.severity === "error" ? "\u2716" : "\u26A0"} ${f.code}  ${f.file}${at}`;
-      return `${head}
-    ${f.message}
-    fix: ${f.fix}`;
-    }).join("\n") || "clean \u2014 0 findings";
+    here2 = path6.dirname(fileURLToPath2(import.meta.url));
+    cached = null;
+    runtimeSource = () => {
+      if (cached !== null) return cached;
+      const candidates = [
+        path6.join(here2, "injected-runtime.js"),
+        // source mode (src/ dir)
+        path6.join(here2, "dist", "injected-runtime.js"),
+        // dist mode
+        path6.join(here2, "..", "dist", "injected-runtime.js")
+        // dist/cli.js sibling
+      ];
+      for (const p of candidates) {
+        try {
+          cached = readFileSync6(p, "utf-8");
+          return cached;
+        } catch {
+        }
+      }
+      throw new Error("injected-runtime.js not found (looked in src/, dist/) \u2014 run `bun run build`");
+    };
+    functions = null;
+    runtimeFunctions = () => {
+      if (functions !== null) return functions;
+      const src = runtimeSource();
+      const factory = new Function(
+        `${src}
+return { luminance, contrastRatio, compositionMetrics, analyzeTitleBand, analyzeIconCorners, findTitleZoneCollision };`
+      );
+      functions = factory();
+      return functions;
+    };
   }
 });
-// src/live/sampler.ts
-var PROBE_SCRIPT, DOM_PROBE_SCRIPT, CANVAS_PAINTED_SCRIPT, CANVAS_HASH_SCRIPT, GAME_STATE_SCRIPT, FINISH_EVENTS_SCRIPT, FPS_MARK_SCRIPT, FPS_SINCE_SCRIPT, fpsSinceScript, HUD_MEASURE_SCRIPT, RETRY_PRESENCE_SCRIPT, INTERRUPT_AUDIO_SCRIPT, AUDIO_STATES_SCRIPT;
-var init_sampler = __esm({
-  "src/live/sampler.ts"() {
+// src/art-verify.ts
+var luminance, contrastRatio2, analyzeTitleBand, analyzeIconCorners, MIN_INK_SHARE, EDGE_MARGIN, verifyTitleReadability, findTitleZoneCollision, CORNER_DISTANCE, verifyIconFullbleed;
+var init_art_verify = __esm({
+  "src/art-verify.ts"() {
     "use strict";
-    PROBE_SCRIPT = `(() => {
-  if (window.__frogoeProbe) return;
-  const probe = { audioContexts: [], audioEverRan: false, finish: [], fps: [] };
-  Object.defineProperty(window, "__frogoeProbe", { value: probe });
-  document.addEventListener("frogoe:finish", (e) => {
-    const d = e && e.detail;
-    const score = d && typeof d.score === "number" ? d.score : null;
-    probe.finish.push({ at: Math.round(performance.now()), score });
-  });
-  const wrap = (Native) => class extends Native {
-    constructor(...args) {
-      super(...args);
-      probe.audioContexts.push(this);
-      this.addEventListener("statechange", () => {
-        if (this.state === "running") probe.audioEverRan = true;
-      });
-    }
-  };
-  const AC = window.AudioContext;
-  if (AC && !AC.__frogoeHooked) {
-    Object.defineProperty(wrap(AC), "__frogoeHooked", { value: true });
-    window.AudioContext = wrap(AC);
-  }
-  if (window.webkitAudioContext) {
-    window.webkitAudioContext = wrap(window.webkitAudioContext);
-  }
-  let count = 0;
-  let secStart = performance.now();
-  const tick = () => {
-    count++;
-    const now = performance.now();
-    if (now - secStart >= 1000) {
-      probe.fps.push(count);
-      count = 0;
-      secStart = now;
-    }
-    requestAnimationFrame(tick);
-  };
-  requestAnimationFrame(tick);
-})()`;
-    DOM_PROBE_SCRIPT = `(() => {
-  return {
-    canvasPresent: Boolean(document.querySelector("#c")),
-    hudPresent: Boolean(document.querySelector(".hud")),
-    state: window.__frogoe?.state ?? "(missing)",
-  };
-})()`;
-    CANVAS_PAINTED_SCRIPT = `(() => {
-  const c = document.querySelector("#c");
-  if (!c) return false;
-  const g = c.getContext("2d");
-  if (!g) return false;
-  const px = Math.floor(c.width * 0.25), py = Math.floor(c.height * 0.25);
-  const pw = Math.floor(c.width * 0.5), ph = Math.floor(c.height * 0.5);
-  const s = g.getImageData(px, py, pw, ph).data;
-  for (let i = 3; i < s.length; i += 4) { if (s[i] !== 0) return true; }
-  return false;
-})()`;
-    CANVAS_HASH_SCRIPT = `(() => {
-  const c = document.querySelector("#c");
-  if (!c) return null;
-  const g = c.getContext("2d");
-  if (!g) return null;
-  const cx = Math.floor(c.width * 0.25), cy = Math.floor(c.height * 0.25);
-  const cw = Math.floor(c.width * 0.5), ch = Math.floor(c.height * 0.5);
-  const d = g.getImageData(cx, cy, cw, ch).data;
-  let hash = 0;
-  for (let i = 0; i < d.length; i += 4) {
-    hash = (hash * 31 + d[i] + d[i + 1] * 7 + d[i + 2] * 13) | 0;
-  }
-  return hash;
-})()`;
-    GAME_STATE_SCRIPT = `window.__frogoe?.state ?? "(missing)"`;
-    FINISH_EVENTS_SCRIPT = `(() => {
-  const p = window.__frogoeProbe;
-  return p ? p.finish.slice() : [];
-})()`;
-    FPS_MARK_SCRIPT = `window.__frogoeProbe ? window.__frogoeProbe.fps.length : 0`;
-    FPS_SINCE_SCRIPT = `(() => {
-  const p = window.__frogoeProbe;
-  const mark = __MARK__;
-  return p ? p.fps.slice(mark) : [];
-})()`;
-    fpsSinceScript = (mark) => FPS_SINCE_SCRIPT.replaceAll("__MARK__", String(mark));
-    HUD_MEASURE_SCRIPT = `(() => {
-  const out = [];
-  for (const el of document.querySelectorAll(".hud *")) {
-    const own = [...el.childNodes].some((n) => n.nodeType === 3 && n.nodeValue.trim());
-    if (!own) continue;
-    const text = el.textContent ?? "";
-    const s = getComputedStyle(el);
-    const hasOutline =
-      (s.webkitTextStroke && s.webkitTextStrokeWidth !== "0px") ||
-      (s.textShadow && s.textShadow !== "none");
-    const r = el.getBoundingClientRect();
-    out.push({ hasOutline, height: r.height, label: text.trim().slice(0, 24), width: r.width });
-  }
-  return out;
-})()`;
-    RETRY_PRESENCE_SCRIPT = `(() => ({
-  gameover: Boolean(document.querySelector("[data-block-gameover]")),
-  retry: Boolean(document.querySelector("[data-block-retry]")),
-}))()`;
-    INTERRUPT_AUDIO_SCRIPT = `(() => {
-  const p = window.__frogoeProbe;
-  if (!p) return false;
-  for (const c of p.audioContexts) {
-    try { void c.suspend(); } catch (e) {}
-  }
-  return true;
-})()`;
-    AUDIO_STATES_SCRIPT = `(() => {
-  const p = window.__frogoeProbe;
-  if (!p) return { count: 0, everRan: false, running: 0 };
-  let running = 0;
-  for (const c of p.audioContexts) {
-    if (c.state === "running") running++;
-  }
-  return { count: p.audioContexts.length, everRan: p.audioEverRan === true, running };
-})()`;
+    luminance = (r, g, b) => {
+      const channel = (c) => {
+        const s = c / 255;
+        return s <= 0.03928 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
+      };
+      return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b);
+    };
+    contrastRatio2 = (a, b) => (Math.max(a, b) + 0.05) / (Math.min(a, b) + 0.05);
+    analyzeTitleBand = (data, width, height) => {
+      const fieldHeight = Math.floor(height * 0.65);
+      const fieldBuckets = /* @__PURE__ */ new Map();
+      for (let y = 0; y < fieldHeight; y += 2) {
+        for (let x = 0; x < width; x += 2) {
+          const at = (y * width + x) * 4;
+          const key = (data[at] ?? 0) >> 4 << 8 | (data[at + 1] ?? 0) >> 4 << 4 | (data[at + 2] ?? 0) >> 4;
+          fieldBuckets.set(key, (fieldBuckets.get(key) ?? 0) + 1);
+        }
+      }
+      let groundKey = 0;
+      let groundHits = -1;
+      for (const [key, hits] of fieldBuckets) {
+        if (hits > groundHits) {
+          groundHits = hits;
+          groundKey = key;
+        }
+      }
+      const ground = [
+        (groundKey >> 8 & 15) * 17,
+        (groundKey >> 4 & 15) * 17,
+        (groundKey & 15) * 17
+      ];
+      const groundLum = luminance(ground[0], ground[1], ground[2]);
+      const isInk = (x, y) => {
+        const at = (y * width + x) * 4;
+        return contrastRatio2(luminance(data[at] ?? 0, data[at + 1] ?? 0, data[at + 2] ?? 0), groundLum) >= 3;
+      };
+      const rowInkMin = Math.ceil(width / 2 * 0.15);
+      const wideRowMin = Math.ceil(width / 2 * 0.4);
+      let inkCount = 0;
+      let inkTotal = 0;
+      let textBottom = -1;
+      let bbox = null;
+      for (let y = 0; y < fieldHeight; y += 2) {
+        let rowInk = 0;
+        for (let x = 0; x < width; x += 2) {
+          if (isInk(x, y)) {
+            rowInk++;
+          }
+        }
+        inkTotal += Math.ceil(width / 2);
+        if (rowInk >= wideRowMin) {
+          textBottom = y;
+        }
+        if (rowInk >= rowInkMin) {
+          inkCount += Math.ceil(width / 2);
+          if (bbox === null) {
+            bbox = [width, y, 0, y];
+          }
+          bbox = [bbox[0], bbox[1], bbox[2], y];
+        }
+      }
+      if (bbox !== null) {
+        const bins = /* @__PURE__ */ new Map();
+        for (let y = bbox[1]; y <= bbox[3]; y += 2) {
+          for (let x = 0; x < width; x += 2) {
+            if (isInk(x, y)) {
+              const bin = x >> 2;
+              bins.set(bin, (bins.get(bin) ?? 0) + 1);
+            }
+          }
+        }
+        const sorted = [...bins.keys()].sort((a, b) => a - b);
+        const GAP_BINS = 6;
+        let best = null;
+        let runFrom = -1;
+        let runTo = -1;
+        let runInk = 0;
+        for (let i = 0; i <= sorted.length; i++) {
+          const bin = sorted[i] ?? Number.MAX_SAFE_INTEGER;
+          const prev = sorted[i - 1] ?? bin;
+          const starts = i === 0 || bin - prev > GAP_BINS;
+          if (starts && runFrom !== -1) {
+            if (best === null || runInk > best[2]) {
+              best = [runFrom, runTo, runInk];
+            }
+            runFrom = -1;
+            runInk = 0;
+          }
+          if (i === sorted.length) break;
+          if (runFrom === -1) {
+            runFrom = bin;
+          }
+          runTo = bin;
+          runInk += bins.get(bin) ?? 0;
+        }
+        if (best !== null) {
+          bbox = [best[0] * 4, bbox[1], best[1] * 4 + 2, bbox[3]];
+        } else {
+          bbox = null;
+        }
+      }
+      return { bandHeight: fieldHeight, ground, inkBBox: bbox, inkCount, inkTotal, textBottom };
+    };
+    analyzeIconCorners = (data, width, _height) => {
+      const read2 = (x, y) => {
+        let r = 0;
+        let g = 0;
+        let b = 0;
+        let a = 0;
+        for (let dy = 0; dy < 4; dy++) {
+          for (let dx = 0; dx < 4; dx++) {
+            const at = ((y + dy) * width + (x + dx)) * 4;
+            r += data[at] ?? 0;
+            g += data[at + 1] ?? 0;
+            b += data[at + 2] ?? 0;
+            a += data[at + 3] ?? 0;
+          }
+        }
+        return [Math.round(r / 16), Math.round(g / 16), Math.round(b / 16), Math.round(a / 16)];
+      };
+      const last = width - 4;
+      return {
+        corners: [read2(0, 0), read2(last, 0), read2(0, last), read2(last, last)]
+      };
+    };
+    MIN_INK_SHARE = 8e-3;
+    EDGE_MARGIN = 8;
+    verifyTitleReadability = (report, width) => {
+      const share = report.inkTotal > 0 ? report.inkCount / report.inkTotal : 0;
+      if (share < MIN_INK_SHARE) {
+        return `bundle/art-title-readability \u2014 the poster's upper field carries almost no readable ink (${(share * 100).toFixed(2)}% \u22653:1 pixels): draw the logotype there (BRIEF font, strokeText outline), or add the stepped scrim if the world is busy \u2014 frogoe-creative \u2192 references/art.md`;
+      }
+      const box = report.inkBBox;
+      if (box === null) {
+        return "bundle/art-title-readability \u2014 no ink bbox";
+      }
+      const [x0, , x1] = box;
+      if (x0 < EDGE_MARGIN || x1 > width - 1 - EDGE_MARGIN) {
+        return `bundle/art-title-readability \u2014 the logotype runs to the canvas edge (bbox ${x0}..${x1} of ${width}): measure-fit the line to \u226486% of the stage width \u2014 frogoe-creative \u2192 references/art.md`;
+      }
+      return null;
+    };
+    findTitleZoneCollision = (data, width, height, band) => {
+      if (band === null) return null;
+      const x0 = Math.max(0, Math.round(band[0]));
+      const y0 = Math.max(0, Math.round(band[1]));
+      const x1 = Math.min(width - 1, Math.round(band[2]));
+      const y1 = Math.min(height - 1, Math.round(band[3]));
+      const lumOf = (x, y) => {
+        const at = (y * width + x) * 4;
+        return luminance(data[at] ?? 0, data[at + 1] ?? 0, data[at + 2] ?? 0);
+      };
+      const buckets = /* @__PURE__ */ new Map();
+      for (let y = y0; y <= y1; y += 2) {
+        for (let x = 0; x < width; x += 2) {
+          const at = (y * width + x) * 4;
+          const key = (data[at] ?? 0) >> 4 << 8 | (data[at + 1] ?? 0) >> 4 << 4 | (data[at + 2] ?? 0) >> 4;
+          buckets.set(key, (buckets.get(key) ?? 0) + 1);
+        }
+      }
+      let gk = 0;
+      let gh = -1;
+      for (const [k, h] of buckets) {
+        if (h > gh) {
+          gh = h;
+          gk = k;
+        }
+      }
+      const groundLum = luminance((gk >> 8 & 15) * 17, (gk >> 4 & 15) * 17, (gk & 15) * 17);
+      const isLnk = (x, y) => contrastRatio2(lumOf(x, y), groundLum) >= 3;
+      const ceiling = [];
+      for (let x = 0; x < width; x += 4) {
+        for (let y = 0; y < 6; y += 2) {
+          if (isLnk(x, y)) {
+            ceiling.push(x);
+            break;
+          }
+        }
+      }
+      const nearCeiling = (x) => {
+        for (const c of ceiling) {
+          if (Math.abs(x - c) <= 8) return true;
+        }
+        return false;
+      };
+      const unit = width / 540;
+      const margin = Math.round(24 * unit);
+      const blobMin = Math.round(12 * unit);
+      const countMin = Math.round(30 * (unit / 2));
+      let floaters = 0;
+      let widest = 0;
+      const windowBottom = Math.min(height - 1, y1 + margin);
+      for (let y = y1 + 2; y <= windowBottom; y += 2) {
+        let run2 = 0;
+        for (let x = x0; x <= x1 + 2; x += 2) {
+          if (x <= x1 && isLnk(x, y) && !nearCeiling(x)) {
+            run2 += 2;
+            floaters++;
+          } else {
+            if (run2 > widest) widest = run2;
+            run2 = 0;
+          }
+        }
+      }
+      if (floaters >= countMin && widest >= blobMin) {
+        return `bundle/art-title-collision \u2014 a free-floating blob (${String(widest)}px wide) parks in the clearance margin under the lettering block (rows ${String(y1 + 2)}..${String(windowBottom)}): free world must clear the block by ~its own radius \u2014 relocate below or compose around it (ceiling-hung world is the one legal crosser) \u2014 frogoe-creative \u2192 references/art.md`;
+      }
+      return null;
+    };
+    CORNER_DISTANCE = 60;
+    verifyIconFullbleed = (report, gameColors) => {
+      const palette = gameColors.map((hex) => [
+        Number.parseInt(hex.slice(1, 3) ?? "0", 16),
+        Number.parseInt(hex.slice(3, 5) ?? "0", 16),
+        Number.parseInt(hex.slice(5, 7) ?? "0", 16)
+      ]);
+      for (const [r, g, b, a] of report.corners) {
+        if (a < 255) {
+          return "bundle/art-icon-fullbleed \u2014 the icon has non-opaque corners: fill the whole square with the plate color (stores mask corners themselves; pre-rounding ships the alpha Apple rejects)";
+        }
+        const near = palette.some(
+          ([pr, pg, pb]) => Math.abs(r - (pr ?? 0)) + Math.abs(g - (pg ?? 0)) + Math.abs(b - (pb ?? 0)) <= CORNER_DISTANCE
+        );
+        if (!near) {
+          return `bundle/art-icon-fullbleed \u2014 corner color rgb(${r},${g},${b}) is not a game palette color: draw the plate as a full-bleed rect of a game color before the mark`;
+        }
+      }
+      return null;
+    };
   }
 });
-// src/live/driver.ts
-var createPuppeteerDriver;
-var init_driver = __esm({
-  "src/live/driver.ts"() {
+// src/browser.ts
+import path7 from "path";
+var browserPath, ensureBrowser;
+var init_browser = __esm({
+  "src/browser.ts"() {
     "use strict";
-    init_sampler();
-    createPuppeteerDriver = ({ page, size }) => {
-      const pageErrors = [];
-      const consoleErrors = [];
-      page.on("pageerror", (error) => {
-        pageErrors.push(String(error));
-      });
-      page.on("console", (message2) => {
-        if (message2.type() === "error") {
-          consoleErrors.push(message2.text());
-        }
-      });
-      page.evaluateOnNewDocument(PROBE_SCRIPT);
-      const read2 = async (script) => await page.evaluate(script);
-      return {
-        errors: () => pageErrors,
-        consoleErrors: () => consoleErrors,
-        async audioStates() {
-          return await read2(AUDIO_STATES_SCRIPT);
-        },
-        async interruptAudio() {
-          await read2(INTERRUPT_AUDIO_SCRIPT);
-        },
-        async domProbe() {
-          return await read2(DOM_PROBE_SCRIPT);
-        },
-        async canvasPainted() {
-          return await read2(CANVAS_PAINTED_SCRIPT);
-        },
-        async canvasHash() {
-          return await read2(CANVAS_HASH_SCRIPT);
-        },
-        async gameState() {
-          return await read2(GAME_STATE_SCRIPT);
-        },
-        async finishEvents() {
-          return await read2(FINISH_EVENTS_SCRIPT);
-        },
-        async fpsMark() {
-          return await read2(FPS_MARK_SCRIPT);
-        },
-        async fpsSince(mark) {
-          return await read2(fpsSinceScript(mark));
-        },
-        async hudMeasures() {
-          return await read2(HUD_MEASURE_SCRIPT);
-        },
-        async retryPresence() {
-          return await read2(RETRY_PRESENCE_SCRIPT);
-        },
-        async tap(x, y) {
-          await page.mouse.click(x, y);
-        },
-        async hold(x, y, ms) {
-          await page.mouse.move(x, y);
-          await page.mouse.down();
-          await new Promise((resolve2) => {
-            setTimeout(resolve2, ms);
-          });
-          await page.mouse.up();
-        },
-        async drag(x1, y1, x2, y2) {
-          await page.mouse.move(x1, y1);
-          await page.mouse.down();
-          await page.mouse.move(x2, y2, { steps: 6 });
-          await new Promise((resolve2) => {
-            setTimeout(resolve2, 80);
-          });
-          await page.mouse.up();
-        },
-        async clickRetryAwaitReload(timeoutMs) {
-          const interactable = `(() => {
-        const b = document.querySelector("[data-block-retry]");
-        if (!b) return false;
-        const s = getComputedStyle(b);
-        if (s.pointerEvents === "none" || s.visibility === "hidden" || s.display === "none") {
-          return false;
-        }
-        const r = b.getBoundingClientRect();
-        if (r.width < 4 || r.height < 4) return false;
-        const hit = document.elementFromPoint(r.x + r.width / 2, r.y + r.height / 2);
-        return Boolean(hit && (hit === b || b.contains(hit)));
-      })()`;
-          const grace = 3e3;
-          const started = Date.now();
-          for (; ; ) {
-            if (await page.evaluate(interactable) === true) {
-              break;
-            }
-            if (Date.now() - started > grace) {
-              return false;
-            }
-            await new Promise((resolve2) => {
-              setTimeout(resolve2, 100);
-            });
-          }
-          const navigated = page.waitForNavigation({ timeout: timeoutMs, waitUntil: "domcontentloaded" }).then(() => true).catch(() => false);
-          const button = await page.$("[data-block-retry]");
-          if (!button) {
-            return false;
-          }
-          await button.click();
-          return await navigated;
-        },
-        async setCpuThrottling(rate) {
-          await page.emulateCPUThrottling(rate === 1 ? null : rate);
-        },
-        async screenshot() {
-          return await page.screenshot({ encoding: "binary" });
-        },
-        viewport: () => size
-      };
+    ensureBrowser = async () => {
+      if (browserPath) {
+        return browserPath;
+      }
+      const { Browser, getInstalledBrowsers, install } = await import("@puppeteer/browsers");
+      const cacheDir = path7.resolve(process.cwd(), "node_modules/.frogoe-browser");
+      const installed = await getInstalledBrowsers({ cacheDir });
+      const existing = installed.find((b) => b.browser === Browser.CHROMEHEADLESSSHELL);
+      browserPath = existing?.executablePath ?? (await install({
+        browser: Browser.CHROMEHEADLESSSHELL,
+        buildId: "131.0.6778.204",
+        cacheDir,
+        unpack: true
+      })).executablePath;
+      return browserPath;
     };
   }
 });
-// src/live/types.ts
-var finding;
-var init_types = __esm({
-  "src/live/types.ts"() {
-    "use strict";
-    finding = (shape) => shape;
-  }
-});
-// src/live/decisions.ts
-var FPS_FLOOR, FPS_SUSTAINED_WINDOW, FROZEN_STREAK, outlineFinding, collapseFinding, pageErrorFinding, consoleErrorFinding, canvasMissingFinding, canvasUnpaintedFinding, contractMissingFinding, stateStuckFinding, earlyDeathFinding, fpsFinding, fpsSustainedFinding, frozenFrameFinding, pausedFinding, stateCorruptFinding, playabilityFinding, finishEventFinding, neverEndsFinding, audioLockedFinding, noGameoverCardFinding, THROTTLE_RATE, THROTTLED_FPS_FLOOR, fpsThrottledFinding, noRetryFinding, retryDeadFinding, rebootFinding;
-var init_decisions = __esm({
-  "src/live/decisions.ts"() {
+// src/net/ip.ts
+import { execSync } from "child_process";
+import os from "os";
+var VIRTUAL, isPrivateV4, isLoopback, selfAddresses, pickLanIp, interfaceFromRouteOutput, ROUTE_PROBES, routedInterfaceName, resolveLan;
+var init_ip = __esm({
+  "src/net/ip.ts"() {
     "use strict";
-    init_types();
-    FPS_FLOOR = 30;
-    FPS_SUSTAINED_WINDOW = 3;
-    FROZEN_STREAK = 3;
-    outlineFinding = (measures) => {
-      const bare = measures.filter((m) => !m.hasOutline);
-      if (bare.length === 0 || !bare[0]) {
-        return null;
+    VIRTUAL = /^(?:utun|awdl|llw|bridge|vboxnet|veth|docker|zd|zt|tailscale|tap|tun|anpi|ipsec|gif|stf|vethernet|virtualbox|vmware|vmnet|wsl|loopback|bluetooth)/u;
+    isPrivateV4 = (ip) => {
+      const octets = ip.split(".").map(Number);
+      if (octets.length !== 4 || octets.some((n) => !Number.isInteger(n) || n < 0 || n > 255)) {
+        return false;
       }
-      return finding({
-        code: "live/hud-outline",
-        file: "index.html",
-        fix: `"${bare[0].label}" has no text-shadow or -webkit-text-stroke \u2014 game HUD text needs an outline to read on ANY background (registry blocks ship one; custom HUD must add it)`,
-        message: `${bare.length} HUD text element(s) have no outline`,
-        phase: "boot",
-        recipe: "frogoe-registry \u2192 block authoring (sticker depth pattern)",
-        severity: "error"
-      });
+      const [a = -1, b = -1] = octets;
+      if (a === 10) return true;
+      if (a === 172 && b >= 16 && b <= 31) return true;
+      if (a === 192 && b === 168) return true;
+      return false;
     };
-    collapseFinding = (measures) => {
-      const collapsed = measures.filter((m) => m.width < 4 || m.height < 4);
-      if (collapsed.length === 0 || !collapsed[0]) {
-        return null;
-      }
-      const first = collapsed[0];
-      return finding({
-        code: "live/layout-collapse",
-        file: "index.html",
-        fix: `"${first.label}" has content but renders ${Math.round(first.width)}\xD7${Math.round(first.height)} \u2014 an element collapsed to zero (missing display, zero-size font, or an ancestor hiding it)`,
-        message: `${collapsed.length} HUD element(s) collapsed to zero size`,
-        phase: "boot",
-        severity: "error"
-      });
-    };
-    pageErrorFinding = (errors, viewport) => {
-      const first = errors[0];
-      if (first === void 0) {
-        return null;
-      }
-      return finding({
-        code: "live/page-error",
-        file: "game.js",
-        fix: `uncaught: ${first.slice(0, 140)}`,
-        message: `${errors.length} uncaught page error(s) [${viewport}]`,
-        phase: "boot",
-        severity: "error"
-      });
-    };
-    consoleErrorFinding = (entries, pageErrors, viewport) => {
-      const unique = entries.filter((entry) => !pageErrors.some((e) => e.includes(entry.slice(0, 60))));
-      const first = unique[0];
-      if (first === void 0) {
-        return null;
-      }
-      return finding({
-        code: "live/console-error",
-        file: "game.js",
-        fix: `console.error: ${first.slice(0, 140)} \u2014 recoverable failures should be handled, not logged`,
-        message: `${unique.length} console.error(s) [${viewport}]`,
-        phase: "boot",
-        severity: "warning"
-      });
-    };
-    canvasMissingFinding = (viewport) => finding({
-      code: "live/canvas-missing",
-      file: "index.html",
-      fix: 'the contract boots on <canvas id="c">',
-      message: `canvas missing [${viewport}]`,
-      phase: "boot",
-      severity: "error"
-    });
-    canvasUnpaintedFinding = (viewport, phase = "boot") => finding({
-      code: "live/canvas-unpainted",
-      file: "game.js",
-      fix: "loop.render never drew \u2014 fill loop.render = (ctx) => {...}",
-      message: `canvas stayed blank [${viewport}]`,
-      phase,
-      severity: "error"
-    });
-    contractMissingFinding = (viewport) => finding({
-      code: "live/contract-missing",
-      file: "index.html",
-      fix: 'import { defineGame } from "frogoe" \u2014 the runtime publishes window.__frogoe at boot',
-      message: `window.__frogoe absent [${viewport}]`,
-      phase: "boot",
-      severity: "error"
-    });
-    stateStuckFinding = (state, viewport, phase = "boot") => {
-      if (state !== "loading") {
-        return null;
-      }
-      return finding({
-        code: "live/state-stuck",
-        file: "game.js",
-        fix: 'state never left "loading" \u2014 defineGame() threw before start() or start() was never called',
-        message: `state stuck in "loading" [${viewport}]`,
-        phase,
-        severity: "error"
-      });
+    isLoopback = (addr) => {
+      if (!addr) return false;
+      return addr === "::1" || addr.startsWith("127.") || addr.startsWith("::ffff:127.");
     };
-    earlyDeathFinding = (viewport, phase = "boot") => finding({
-      code: "live/early-death",
-      file: "game.js",
-      fix: 'state reached "over" before any input \u2014 the game kills itself on the ready screen; gate death (and the physics that cause it) behind the first input.on("down")',
-      message: `game ended before the first input [${viewport}]`,
-      phase,
-      severity: "error"
-    });
-    fpsFinding = (fps, viewport) => {
-      if (fps === void 0 || fps >= FPS_FLOOR) {
-        return null;
+    selfAddresses = (interfaces) => {
+      const own = /* @__PURE__ */ new Set();
+      for (const entries of Object.values(interfaces)) {
+        for (const entry of entries ?? []) {
+          if (entry.family === "IPv4") {
+            own.add(entry.address);
+            own.add(`::ffff:${entry.address}`);
+          } else if (entry.family === "IPv6") {
+            own.add(entry.address);
+          }
+        }
       }
-      return finding({
-        code: "live/fps",
-        file: "game.js",
-        fix: `${fps.toFixed(0)} fps on ${viewport} (floor ${FPS_FLOOR}) \u2014 heavy per-frame work: cache gradients, cut particle counts, avoid shadowBlur on big shapes`,
-        message: `frame rate below the playability floor [${viewport}]`,
-        phase: "play",
-        recipe: "frogoe-creative \u2192 game-feel (motion rules)",
-        severity: "warning"
-      });
+      return own;
     };
-    fpsSustainedFinding = (buckets, viewport) => {
-      if (buckets.length < FPS_SUSTAINED_WINDOW) {
-        return null;
+    pickLanIp = (interfaces, routedName) => {
+      const physical = [];
+      const virtual = [];
+      for (const [name, entries] of Object.entries(interfaces)) {
+        for (const entry of entries ?? []) {
+          if (entry.family !== "IPv4" || entry.internal || !isPrivateV4(entry.address)) continue;
+          const item = { ip: entry.address, name };
+          if (VIRTUAL.test(name.toLowerCase())) virtual.push(item);
+          else physical.push(item);
+        }
       }
-      let worst = Number.POSITIVE_INFINITY;
-      for (let i = 0; i + FPS_SUSTAINED_WINDOW <= buckets.length; i++) {
-        const window = buckets.slice(i, i + FPS_SUSTAINED_WINDOW);
-        const avg = window.reduce((a, b) => a + b, 0) / window.length;
-        if (avg < worst) {
-          worst = avg;
+      physical.sort((a, b) => a.name.localeCompare(b.name));
+      virtual.sort((a, b) => a.name.localeCompare(b.name));
+      if (routedName) {
+        const routed = physical.find((p) => p.name === routedName) ?? virtual.find((v) => v.name === routedName);
+        if (routed) {
+          return {
+            candidates: [routed.ip],
+            confidence: "routed",
+            ip: routed.ip,
+            virtual: !physical.includes(routed)
+          };
         }
       }
-      if (worst >= FPS_FLOOR) {
-        return null;
+      const chosen = physical[0] ?? virtual[0];
+      if (!chosen) {
+        return { candidates: [], confidence: "none", virtual: false };
       }
-      const mean = buckets.reduce((a, b) => a + b, 0) / buckets.length;
       return {
-        finding: finding({
-          code: "live/fps-sustained",
-          file: "game.js",
-          fix: `${worst.toFixed(0)} fps held for ${FPS_SUSTAINED_WINDOW}s+ on ${viewport} (floor ${FPS_FLOOR}) \u2014 the game is consistently slow, not jittering: cut per-frame allocations, shrink offscreen canvases, reduce draw calls`,
-          message: `sustained low frame rate [${viewport}]`,
-          phase: "play",
-          recipe: "frogoe-creative \u2192 game-feel (motion rules)",
-          severity: "error"
-        }),
-        mean
+        candidates: physical.length > 0 ? physical.map((p) => p.ip) : virtual.map((v) => v.ip),
+        confidence: "heuristic",
+        ip: chosen.ip,
+        virtual: !physical.includes(chosen)
       };
     };
-    frozenFrameFinding = (streak) => {
-      if (streak < FROZEN_STREAK) {
-        return null;
-      }
-      return finding({
-        code: "live/frozen-frame",
-        file: "game.js",
-        fix: `canvas held the same frame for ${streak} samples while playing \u2014 loop.render may have stopped or draws a static scene`,
-        message: "canvas froze during play",
-        phase: "play",
-        severity: "warning"
-      });
+    interfaceFromRouteOutput = (output, style) => {
+      if (style === "bsd") return /interface:\s*(\S+)/u.exec(output)?.[1];
+      if (style === "linux") return /dev\s+(\S+)/u.exec(output)?.[1];
+      return output.split(/\r?\n/u).map((line) => line.trim()).find((line) => line.length > 0);
     };
-    pausedFinding = () => finding({
-      code: "live/paused",
-      file: "game.js",
-      fix: 'state read "paused" during scripted play \u2014 pause() ran without a matching resume(); check document.hidden handling and blur listeners',
-      message: "game paused itself during play",
-      phase: "play",
-      severity: "warning"
-    });
-    stateCorruptFinding = (state) => finding({
-      code: "live/state-corrupt",
-      file: "game.js",
-      fix: `state read "${state}" \u2014 outside the contract's set (loading/playing/paused/over); game code is mutating window.__frogoe directly`,
-      message: `state left the contract's state machine ("${state}")`,
-      phase: "play",
-      severity: "error"
-    });
-    playabilityFinding = (result) => {
-      if (result === "pass") {
-        return null;
-      }
-      if (result === "no-input") {
-        return finding({
-          code: "live/no-input",
-          file: "game.js",
-          fix: 'the game never registered input.on("down", ...) \u2014 wire the core verb before shipping',
-          message: "game has no input handler",
-          phase: "play",
-          severity: "error"
-        });
+    ROUTE_PROBES = [
+      { cmd: "route -n get default", style: "bsd" },
+      // darwin/bsd; usage-errors elsewhere
+      { cmd: "ip route show default", style: "linux" },
+      // linux; absent on darwin/win
+      {
+        cmd: `powershell -NoProfile -Command "(Get-NetRoute -DestinationPrefix '0.0.0.0/0' | Sort-Object RouteMetric | Select-Object -First 1).InterfaceAlias"`,
+        style: "windows"
       }
-      return finding({
-        code: "live/not-playable",
-        file: "game.js",
-        fix: "scripted taps produced no canvas change \u2014 loop.update/loop.render may be wired but the game logic never runs",
-        message: "game did not respond to scripted input",
-        phase: "play",
-        severity: "error"
-      });
-    };
-    finishEventFinding = (stateOver, finishCount) => {
-      if (stateOver === finishCount > 0) {
-        return null;
+    ];
+    routedInterfaceName = () => {
+      for (const probe of ROUTE_PROBES) {
+        try {
+          const out = execSync(probe.cmd, {
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 3e3
+          });
+          const name = interfaceFromRouteOutput(out, probe.style);
+          if (name) return name;
+        } catch {
+        }
       }
-      return finding({
-        code: "live/finish-event-missing",
-        file: "game.js",
-        fix: stateOver ? 'state reached "over" but frogoe:finish never fired \u2014 call finish(score) on death, never write __frogoe.state directly' : 'frogoe:finish fired but state is not "over" \u2014 the event was dispatched outside finish()',
-        message: "state/event mismatch at game over",
-        phase: "end",
-        severity: "error"
-      });
-    };
-    neverEndsFinding = (budgetMs) => finding({
-      code: "live/never-ends",
-      file: "game.js",
-      fix: `no death within ${Math.round(budgetMs / 1e3)}s of passive play \u2014 fine for endless/sandbox games, but feed games are short replayable loops; most deaths should arrive in seconds`,
-      message: "game never reached the over state",
-      phase: "end",
-      severity: "warning"
-    });
-    audioLockedFinding = (audio) => {
-      if (audio.count === 0 || audio.running > 0) {
-        return null;
-      }
-      return finding({
-        code: "live/audio-locked",
-        file: "game.js",
-        fix: 'audio contexts exist but stayed suspended after an interruption + real input \u2014 resume inside a user gesture: Sfx.init() in input.on("down") AND ("up"), plus the 1-sample silent-buffer unlock (frogoe-core \u2192 references/audio.md)',
-        message: "audio never recovers \u2014 every phone interruption plays this game silent",
-        phase: "play",
-        recipe: "frogoe-core \u2192 references/audio.md",
-        severity: "error"
-      });
-    };
-    noGameoverCardFinding = () => finding({
-      code: "live/no-gameover-card",
-      file: "index.html",
-      fix: "no [data-block-gameover] overlay when the game ended \u2014 install the game-over-card block so death has a screen",
-      message: "game over has no overlay",
-      phase: "end",
-      recipe: "frogoe-registry \u2192 game-over-card",
-      severity: "warning"
-    });
-    THROTTLE_RATE = 4;
-    THROTTLED_FPS_FLOOR = 15;
-    fpsThrottledFinding = (buckets, viewport) => {
-      if (buckets.length === 0) return null;
-      const mean = buckets.reduce((a, b) => a + b, 0) / buckets.length;
-      if (mean >= THROTTLED_FPS_FLOOR) return null;
-      return finding({
-        code: "live/fps-throttled",
-        file: "game.js",
-        fix: `fps ${mean.toFixed(0)} under ${THROTTLE_RATE}x cpu throttle (${viewport}) \u2014 mid-range phones will feel this: cache gradients/patterns, cut per-frame allocations, shrink offscreen canvases, cap particles`,
-        message: "cpu-bound collapse under phone-class throttle",
-        phase: "play",
-        severity: "warning"
-      });
-    };
-    noRetryFinding = () => finding({
-      code: "live/no-retry",
-      file: "index.html",
-      fix: "no [data-block-retry] button anywhere \u2014 the player is hard-stuck after death; the retry affordance is the loop's exit",
-      message: "no retry affordance after game over",
-      phase: "end",
-      recipe: "frogoe-registry \u2192 game-over-card",
-      severity: "error"
-    });
-    retryDeadFinding = () => finding({
-      code: "live/retry-dead",
-      file: "game.js",
-      fix: 'clicking retry produced no reload \u2014 wire it: retry.addEventListener("click", () => location.reload())',
-      message: "retry button did not reload the page",
-      phase: "retry",
-      severity: "error"
-    });
-    rebootFinding = (state) => {
-      if (state === "playing") {
-        return null;
-      }
-      return finding({
-        code: "live/state-stuck",
-        file: "game.js",
-        fix: `after retry reloaded the page the state read "${state}" \u2014 the second boot is not healthy (check localStorage parsing and one-time init paths)`,
-        message: `retry boot stuck in "${state}"`,
-        phase: "retry",
-        severity: "error"
-      });
+      return null;
     };
+    resolveLan = () => pickLanIp(os.networkInterfaces(), routedInterfaceName());
   }
 });
-// src/live/phases.ts
-var END_BUDGET_MS, RETRY_NAV_MS, PLAY_STEPS, PLAY_STEP_MS, HOLD_STEP_INDEX, DRAG_STEP_INDEX, DRAG_SPAN, HOLD_MS, POLL_MS, GRACE_MS, STABILITY_CYCLES, START_BURST_TAPS, DESKTOP_FPS_MS, sleep2, jitterX, jitterY, hasError, runBootChecks, runDesktopPass, overShotName, retryShotName, waitForOver, runStartBurst, verifyDeath, runLifecycle;
-var init_phases = __esm({
-  "src/live/phases.ts"() {
+// src/telemetry/records.ts
+var FPS_FLOOR, formatClock, dipSpans, beaconToRecords, summarizeRecords;
+var init_records = __esm({
+  "src/telemetry/records.ts"() {
     "use strict";
-    init_decisions();
-    END_BUDGET_MS = 45e3;
-    RETRY_NAV_MS = 8e3;
-    PLAY_STEPS = 7;
-    PLAY_STEP_MS = 850;
-    HOLD_STEP_INDEX = 3;
-    DRAG_STEP_INDEX = 5;
-    DRAG_SPAN = 90;
-    HOLD_MS = 400;
-    POLL_MS = 400;
-    GRACE_MS = 150;
-    STABILITY_CYCLES = 2;
-    START_BURST_TAPS = 3;
-    DESKTOP_FPS_MS = 2e3;
-    sleep2 = (ms) => new Promise((resolve2) => {
-      setTimeout(resolve2, ms);
-    });
-    jitterX = (step) => step * 37 % 121 - 60;
-    jitterY = (step) => step * 53 % 181 - 90;
-    hasError = (findings) => findings.some((f) => f.severity === "error");
-    runBootChecks = async (driver, ctx) => {
-      const findings = [];
-      const name = ctx.viewport.name;
-      const pageErr = pageErrorFinding(driver.errors(), name);
-      if (pageErr) {
-        findings.push(pageErr);
-      }
-      const conErr = consoleErrorFinding(driver.consoleErrors(), driver.errors(), name);
-      if (conErr) {
-        findings.push(conErr);
-      }
-      const probe = await driver.domProbe();
-      if (!probe.canvasPresent) {
-        findings.push(canvasMissingFinding(name));
-      } else if (!await driver.canvasPainted()) {
-        findings.push(canvasUnpaintedFinding(name));
-      }
-      if (probe.state === "(missing)") {
-        findings.push(contractMissingFinding(name));
-      } else if (probe.state === "over") {
-        findings.push(earlyDeathFinding(name));
-      } else {
-        const stuck = stateStuckFinding(probe.state, name);
-        if (stuck) {
-          findings.push(stuck);
-        }
-      }
-      if (probe.hudPresent) {
-        const measures = await driver.hudMeasures();
-        const outline = outlineFinding(measures);
-        if (outline) {
-          findings.push(outline);
-        }
-        const collapse = collapseFinding(measures);
-        if (collapse) {
-          findings.push(collapse);
-        }
-      }
-      return findings;
+    FPS_FLOOR = 30;
+    formatClock = (wall) => {
+      const d = new Date(wall);
+      const p = (n) => String(n).padStart(2, "0");
+      return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
     };
-    runDesktopPass = async (driver, ctx) => {
-      const doSleep = ctx.sleep ?? sleep2;
-      const findings = await runBootChecks(driver, ctx);
-      if (hasError(findings)) {
-        return { findings };
-      }
-      const mark = await driver.fpsMark();
-      await doSleep(DESKTOP_FPS_MS);
-      const buckets = await driver.fpsSince(mark);
-      if (buckets.length === 0) {
-        return { findings };
-      }
-      const mean = buckets.reduce((a, b) => a + b, 0) / buckets.length;
-      const warn = fpsFinding(mean, ctx.viewport.name);
-      if (warn) {
-        findings.push(warn);
+    dipSpans = (buckets) => {
+      const spans = [];
+      let start = -1;
+      let worst = 0;
+      for (let i = 0; i <= buckets.length; i++) {
+        const low = i < buckets.length && (buckets[i] ?? 0) > 0 && (buckets[i] ?? 0) < FPS_FLOOR;
+        if (low && start === -1) {
+          start = i;
+          worst = buckets[i] ?? 0;
+        } else if (low) {
+          worst = Math.min(worst, buckets[i] ?? 0);
+        } else if (start !== -1) {
+          spans.push({ fps: worst, len: i - start, start });
+          start = -1;
+        }
       }
-      await ctx.shot?.("live-desktop.png");
-      return { findings, fps: Math.round(mean) };
+      return spans;
     };
-    overShotName = (cycle) => cycle === 0 ? "live-mobile-over.png" : `live-mobile-over-${cycle + 1}.png`;
-    retryShotName = (cycle) => cycle === 0 ? "live-mobile-retry.png" : `live-mobile-retry-${cycle + 1}.png`;
-    waitForOver = async (driver, doSleep) => {
-      for (let waited = 0; waited < END_BUDGET_MS; waited += POLL_MS) {
-        await doSleep(POLL_MS);
-        if (await driver.gameState() === "over") {
-          return true;
+    beaconToRecords = (payload, arrivalWall) => {
+      const out = [];
+      const arrivalUp = payload.up;
+      const wallAt = (up) => arrivalWall - Math.max(0, arrivalUp - up) * 1e3;
+      const buckets = payload.fps ?? [];
+      const spans = dipSpans(buckets);
+      const spanEnd = new Map(spans.map((s) => [s.start + s.len - 1, s]));
+      for (let i = 0; i < buckets.length; i++) {
+        const fps = buckets[i] ?? 0;
+        const up = Math.max(0, arrivalUp - (buckets.length - 1 - i));
+        const wall = wallAt(up);
+        const time = formatClock(wall);
+        out.push({
+          record: { fps, time, type: "fps", up, wall },
+          text: ""
+        });
+        const span = spanEnd.get(i);
+        if (span) {
+          out.push({
+            record: { fps: span.fps, time, type: "fps", up, wall },
+            text: `\u26A0 ${time}  fps ${span.fps} \u2014 dip ${span.len}s`
+          });
         }
       }
-      return false;
-    };
-    runStartBurst = async (driver, ctx) => {
-      const doSleep = ctx.sleep ?? sleep2;
-      for (let step = 0; step < START_BURST_TAPS; step++) {
-        const x = Math.round(ctx.viewport.width / 2 + jitterX(step));
-        const y = Math.round(ctx.viewport.height / 2 + jitterY(step));
-        await driver.tap(x, y);
-        await doSleep(PLAY_STEP_MS);
+      for (const event of payload.events ?? []) {
+        const wall = wallAt(event.up);
+        const time = formatClock(wall);
+        const type = event.type === "error" || event.type === "rejection" || event.type === "hidden" || event.type === "visible" ? event.type : "error";
+        const msg = (event.msg ?? "").slice(0, 160);
+        const text = type === "hidden" ? `\xB7 ${time}  phone hidden` : type === "visible" ? `\xB7 ${time}  phone visible` : `\u2716 ${time}  ${type === "rejection" ? "unhandled rejection" : "page error"}: ${msg}`;
+        out.push({ record: { msg, time, type, up: event.up, wall }, text });
       }
+      return out;
     };
-    verifyDeath = async (driver, ctx, findings, cycle) => {
-      const doSleep = ctx.sleep ?? sleep2;
-      let events = await driver.finishEvents();
-      if (events.length === 0) {
-        await doSleep(GRACE_MS);
-        events = await driver.finishEvents();
-      }
-      const mismatch = finishEventFinding(true, events.length);
-      if (mismatch) {
-        findings.push(mismatch);
+    summarizeRecords = (records) => {
+      const fps = records.filter((r) => r.type === "fps" && typeof r.fps === "number");
+      const buckets = fps.map((r) => r.fps ?? 0).filter((n) => n > 0);
+      const spans = dipSpans(buckets);
+      const orderKey = (r) => typeof r.wall === "number" ? r.wall : r.up * 1e3;
+      let hiddenS = 0;
+      let pendingHidden;
+      for (const r of records) {
+        if (pendingHidden !== void 0) {
+          hiddenS += Math.max(0, orderKey(r) - pendingHidden) / 1e3;
+          pendingHidden = void 0;
+        }
+        if (r.type === "hidden") {
+          pendingHidden = orderKey(r);
+        }
       }
-      const presence = await driver.retryPresence();
-      if (!presence.gameover) {
-        findings.push(noGameoverCardFinding());
+      const worstSpan = spans.reduce(
+        (acc, s) => acc === void 0 || s.len > acc.len ? s : acc,
+        void 0
+      );
+      const worst = worstSpan ? {
+        fps: worstSpan.fps,
+        len: worstSpan.len,
+        time: fps[worstSpan.start + worstSpan.len - 1]?.time ?? "?"
+      } : void 0;
+      let pageLoads = records.length > 0 ? 1 : 0;
+      let prevUp = -1;
+      for (const r of records) {
+        if (prevUp !== -1 && r.up + 2 < prevUp) pageLoads += 1;
+        prevUp = r.up;
       }
-      if (!presence.retry) {
-        findings.push(noRetryFinding());
+      const first = records[0];
+      const last = records[records.length - 1];
+      const durationS = first && last && typeof first.wall === "number" && typeof last.wall === "number" ? (
+        // +1s: the first bucket already covers one second of play
+        Math.round((last.wall - first.wall + 1e3) / 1e3)
+      ) : Math.round(last?.up ?? 0);
+      return {
+        buckets: buckets.length,
+        dips: spans.length,
+        durationS,
+        errors: records.filter((r) => r.type === "error" || r.type === "rejection").length,
+        hiddenS: Math.round(hiddenS),
+        meanFps: buckets.length > 0 ? Math.round(buckets.reduce((a, b) => a + b, 0) / buckets.length) : void 0,
+        pageLoads,
+        worst
+      };
+    };
+  }
+});
+// src/telemetry/session.ts
+import { appendFileSync, mkdirSync as mkdirSync3, readdirSync as readdirSync2 } from "fs";
+import path8 from "path";
+var pad, sessionStamp, createSessionStore, latestSessionFile;
+var init_session = __esm({
+  "src/telemetry/session.ts"() {
+    "use strict";
+    pad = (n) => String(n).padStart(2, "0");
+    sessionStamp = (wall) => {
+      const d = new Date(wall);
+      return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
+    };
+    createSessionStore = (gameDir, startedWall) => {
+      const dir = path8.join(gameDir, ".frogoe", "sessions");
+      let file;
+      return {
+        file: () => file,
+        write: (records) => {
+          if (records.length === 0) return;
+          if (!file) {
+            mkdirSync3(dir, { recursive: true });
+            file = path8.join(dir, `${sessionStamp(startedWall)}.jsonl`);
+          }
+          appendFileSync(file, records.map((r) => JSON.stringify(r)).join("\n") + "\n", "utf-8");
+        }
+      };
+    };
+    latestSessionFile = (gameDir) => {
+      const dir = path8.join(gameDir, ".frogoe", "sessions");
+      try {
+        const files = readdirSync2(dir).filter((f) => f.endsWith(".jsonl")).sort();
+        return files.length > 0 ? path8.join(dir, files[files.length - 1] ?? "") : null;
+      } catch {
+        return null;
       }
-      await ctx.shot?.(overShotName(cycle));
-      return presence.retry;
     };
-    runLifecycle = async (driver, ctx) => {
-      const doSleep = ctx.sleep ?? sleep2;
-      const settle = ctx.settleMs ?? 2e3;
-      const name = ctx.viewport.name;
-      const findings = [];
-      const boot = await runBootChecks(driver, ctx);
-      findings.push(...boot);
-      await ctx.shot?.("live-mobile.png");
-      if (hasError(boot)) {
-        return { findings, lifecycle: { ends: false, retryReloads: 0 }, playability: "no-input" };
+  }
+});
+// src/run.ts
+var run_exports = {};
+__export(run_exports, {
+  startServer: () => startServer
+});
+import { existsSync as existsSync6, readFileSync as readFileSync7, statSync, watch } from "fs";
+import os2 from "os";
+import path9 from "path";
+import { createAdaptorServer } from "@hono/node-server";
+import { getConnInfo } from "@hono/node-server/conninfo";
+import { Hono } from "hono";
+var buildDevScript, MIME2, startServer;
+var init_run = __esm({
+  "src/run.ts"() {
+    "use strict";
+    init_ip();
+    init_records();
+    init_session();
+    buildDevScript = (version) => `<script>(function(){var v="${String(version)}";try{var es=new EventSource("/__frogoe/reload");es.onmessage=function(){location.reload()};es.onerror=function(){es.close()};}catch(e){}setInterval(function(){fetch("/__frogoe/version",{cache:"no-store"}).then(function(r){return r.text()}).then(function(t){if(t!==v)location.reload()}).catch(function(){})},2000);var fps=[],cnt=0,sec=performance.now(),evs=[],up0=performance.now();function up(){return (performance.now()-up0)/1000}function tick(){cnt++;var n=performance.now();if(n-sec>=1000){fps.push(cnt);cnt=0;sec=n}requestAnimationFrame(tick)}requestAnimationFrame(tick);addEventListener("error",function(e){evs.push({type:"error",msg:String(e.message||e).slice(0,200),up:up()})});addEventListener("unhandledrejection",function(e){evs.push({type:"rejection",msg:String(e.reason).slice(0,200),up:up()})});document.addEventListener("visibilitychange",function(){evs.push({type:document.hidden?"hidden":"visible",up:up()})});function flush(beacon){var p={v:1,up:up(),fps:fps.splice(0),events:evs.splice(0)};if(performance.memory)p.mem=Math.round(performance.memory.usedJSHeapSize/1048576);var b=JSON.stringify(p);if(beacon&&navigator.sendBeacon){navigator.sendBeacon("/__frogoe/metrics",new Blob([b],{type:"application/json"}));return}fetch("/__frogoe/metrics",{method:"POST",body:b,headers:{"content-type":"application/json"},keepalive:true}).catch(function(){});}document.addEventListener("visibilitychange",function(){if(document.hidden)flush(true)});addEventListener("pagehide",function(){flush(true)});setInterval(function(){flush(false)},5000);})();</script>`;
+    MIME2 = {
+      css: "text/css; charset=utf-8",
+      htm: "text/html; charset=utf-8",
+      html: "text/html; charset=utf-8",
+      ico: "image/x-icon",
+      jpeg: "image/jpeg",
+      js: "text/javascript; charset=utf-8",
+      json: "application/json; charset=utf-8",
+      mjs: "text/javascript; charset=utf-8",
+      png: "image/png",
+      svg: "image/svg+xml",
+      txt: "text/plain; charset=utf-8",
+      webp: "image/webp",
+      woff2: "font/woff2"
+    };
+    startServer = async (dir, requestedPort = 0, telemetry) => {
+      const root = path9.resolve(dir);
+      if (!existsSync6(path9.join(root, "index.html"))) {
+        throw new Error(`frogoe run: no index.html in ${root} \u2014 is this a game folder?`);
       }
-      const mark = await driver.fpsMark();
-      const hashes = [];
-      let streak = 0;
-      let maxStreak = 0;
-      let sawOver = false;
-      let sawPaused = false;
-      let sawStuck = false;
-      let corrupt = null;
-      for (let step = 0; step < PLAY_STEPS; step++) {
-        const x = Math.round(ctx.viewport.width / 2 + jitterX(step));
-        const y = Math.round(ctx.viewport.height / 2 + jitterY(step));
-        if (step === HOLD_STEP_INDEX) {
-          await driver.hold(x, y, HOLD_MS);
-        } else if (step === DRAG_STEP_INDEX) {
-          await driver.drag(x - DRAG_SPAN, y, x + DRAG_SPAN, y);
-        } else {
-          await driver.tap(x, y);
+      const clients = /* @__PURE__ */ new Set();
+      let version = 0;
+      let remoteSeen = false;
+      let lastRemote = "";
+      const own = selfAddresses(os2.networkInterfaces());
+      const session = telemetry ? createSessionStore(root, Date.now()) : void 0;
+      const app = new Hono();
+      app.use("*", async (c, next) => {
+        try {
+          const address2 = getConnInfo(c).remote.address;
+          if (address2 && !isLoopback(address2) && !own.has(address2)) {
+            remoteSeen = true;
+            lastRemote = address2;
+          }
+        } catch {
         }
-        await doSleep(PLAY_STEP_MS);
-        const state = await driver.gameState();
-        if (state === "over") {
-          sawOver = true;
-          break;
+        await next();
+      });
+      app.get("/__frogoe/reload", (c) => {
+        const stream = new ReadableStream({
+          cancel() {
+          },
+          start(controller) {
+            clients.add(controller);
+            controller.enqueue(new TextEncoder().encode("retry: 3000\n\n"));
+          }
+        });
+        return c.body(stream, {
+          headers: {
+            "cache-control": "no-store",
+            connection: "keep-alive",
+            "content-type": "text/event-stream"
+          }
+        });
+      });
+      app.get(
+        "/__frogoe/version",
+        (c) => c.text(String(version), 200, { "cache-control": "no-store" })
+      );
+      app.post("/__frogoe/metrics", async (c) => {
+        try {
+          const payload = JSON.parse(await c.req.text());
+          if (!session) return c.body(null, 204);
+          const lines = beaconToRecords(payload, Date.now());
+          session.write(lines.map((l) => l.record));
+          for (const line of lines) {
+            if (line.text) telemetry?.onEvent?.(line.text);
+          }
+          return c.body(null, 204);
+        } catch {
+          return c.body(null, 400);
         }
-        if (state === "paused") {
-          sawPaused = true;
-        } else if (state === "loading") {
-          sawStuck = true;
-        } else if (state !== "playing" && state !== "(missing)") {
-          corrupt ??= state;
+      });
+      app.get("*", (c) => {
+        const raw = decodeURIComponent(new URL(c.req.url).pathname);
+        const safe = path9.normalize(raw).replaceAll("\\", "/");
+        let file = path9.join(root, safe === "/" ? "index.html" : safe);
+        if (!file.startsWith(root)) {
+          return c.text("forbidden", 403);
         }
-        const hash = await driver.canvasHash();
-        if (hash !== null) {
-          if (hashes.length > 0 && hash === hashes[hashes.length - 1] && state === "playing") {
-            streak += 1;
-            maxStreak = Math.max(maxStreak, streak);
-          } else {
-            streak = 0;
-          }
-          hashes.push(hash);
+        if (existsSync6(file) && statSync(file).isDirectory()) {
+          file = path9.join(file, "index.html");
         }
-      }
-      const buckets = await driver.fpsSince(mark);
-      const mean = buckets.length > 0 ? buckets.reduce((a, b) => a + b, 0) / buckets.length : void 0;
-      if (corrupt !== null) {
-        findings.push(stateCorruptFinding(corrupt));
-      }
-      if (sawStuck) {
-        const stuck = stateStuckFinding("loading", name, "play");
-        if (stuck) {
-          findings.push(stuck);
+        if (!existsSync6(file)) {
+          return c.text(`frogoe run: not found: ${raw}`, 404);
         }
-      }
-      if (sawPaused) {
-        findings.push(pausedFinding());
-      }
-      const frozen = frozenFrameFinding(maxStreak);
-      if (frozen) {
-        findings.push(frozen);
-      }
-      const sustained = fpsSustainedFinding(buckets, name);
-      if (sustained) {
-        findings.push(sustained.finding);
-      } else {
-        const warn = fpsFinding(mean, name);
-        if (warn) {
-          findings.push(warn);
+        const body = readFileSync7(file);
+        const ext = path9.extname(file).slice(1).toLowerCase();
+        const type = MIME2[ext] ?? "application/octet-stream";
+        if (ext === "html" || ext === "htm") {
+          const html = body.toString("utf-8");
+          const injected = /<\/body>/iu.test(html) ? html.replace(/<\/body>/iu, `${buildDevScript(version)}</body>`) : html + buildDevScript(version);
+          return c.body(injected, 200, {
+            "cache-control": "no-store",
+            "content-type": type
+          });
         }
+        return c.body(body, 200, { "content-type": type });
+      });
+      const server = createAdaptorServer({ fetch: app.fetch });
+      await new Promise((resolve2, reject) => {
+        server.once("error", reject);
+        server.listen(requestedPort, "0.0.0.0", () => resolve2());
+      });
+      const address = server.address();
+      const port = typeof address === "object" && address ? address.port : 0;
+      if (!port) {
+        server.closeAllConnections?.();
+        server.close();
+        throw new Error("frogoe run: server failed to bind a port");
       }
-      const responded = new Set(hashes).size > 1 || sawOver;
-      const playability = responded ? "pass" : "fail";
-      const play = playabilityFinding(playability);
-      if (play) {
-        findings.push(play);
-      }
-      const audioBefore = await driver.audioStates();
-      if (audioBefore.count > 0) {
-        await driver.interruptAudio();
-        await runStartBurst(driver, ctx);
-        await doSleep(600);
-        const audioFinding = audioLockedFinding(await driver.audioStates());
-        if (audioFinding) {
-          findings.push(audioFinding);
+      const local = `http://localhost:${port}`;
+      const lanInfo = resolveLan();
+      const lan = lanInfo.ip ? `http://${lanInfo.ip}:${port}` : void 0;
+      let timer;
+      const watcher = watch(root, { recursive: true }, (_event, file) => {
+        const first = file?.split(path9.sep)[0];
+        if (first === "snapshots" || first === ".frogoe" || first === "dist") {
+          return;
+        }
+        clearTimeout(timer);
+        timer = setTimeout(() => {
+          version += 1;
+          const payload = new TextEncoder().encode("data: reload\n\n");
+          for (const client of clients) {
+            try {
+              client.enqueue(payload);
+            } catch {
+              clients.delete(client);
+            }
+          }
+        }, 100);
+      });
+      return {
+        port,
+        sawRemote: () => remoteSeen,
+        remote: () => remoteSeen ? lastRemote : void 0,
+        stop() {
+          clearTimeout(timer);
+          watcher.close();
+          server.closeAllConnections?.();
+          server.close();
+        },
+        urls: { lan, local }
+      };
+    };
+  }
+});
+// src/raster.ts
+import { existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync8, statSync as statSync2 } from "fs";
+import path10 from "path";
+var SCENES, sleep2, rasterScriptFor, rasterizeArt;
+var init_raster = __esm({
+  "src/raster.ts"() {
+    "use strict";
+    init_src();
+    init_runtime_source();
+    init_art_verify();
+    init_runtime_source();
+    init_browser();
+    SCENES = [
+      {
+        draw: "drawPoster",
+        height: 1920,
+        out: path10.join("dist", "assets", "poster.png"),
+        size: "w, h",
+        source: path10.join("assets", "poster.js"),
+        width: 1080
+      },
+      {
+        draw: "drawIcon",
+        height: 1024,
+        out: path10.join("dist", "assets", "icon.png"),
+        size: "size",
+        source: path10.join("assets", "icon.js"),
+        width: 1024
+      }
+    ];
+    sleep2 = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
+    rasterScriptFor = (scene, palette) => {
+      const sizeArg = scene.draw === "drawIcon" ? String(scene.width) : `${String(scene.width)}, ${String(scene.height)}`;
+      const analyze = scene.draw === "drawIcon" ? "analyzeIconCorners" : "analyzeTitleBand";
+      return `(async () => {
+  ${runtimeSource()}
+  const mod = await import("./assets/${path10.basename(scene.source)}");
+  const canvas = document.createElement("canvas");
+  canvas.id = "__frogoe_raster";
+  canvas.width = ${String(scene.width)};
+  canvas.height = ${String(scene.height)};
+  canvas.style.cssText =
+    "position:fixed;left:0;top:0;width:${String(scene.width)}px;height:${String(scene.height)}px;z-index:2147483647;pointer-events:none;";
+  document.body.append(canvas);
+  try {
+    const ctx = canvas.getContext("2d", { willReadFrequently: true });
+    await document.fonts.ready;
+    mod.${scene.draw}(ctx, ${sizeArg});
+    const pixels = ctx.getImageData(0, 0, canvas.width, canvas.height).data;
+    window.__frogoeArtReport = ${analyze}(pixels, canvas.width, canvas.height);
+    try { window.__frogoeTitleBand = ctx.__frogoeTitleBand ?? null; } catch (e) { window.__frogoeTitleBand = null; }
+    window.__frogoeArtMetrics = compositionMetrics(
+      pixels, canvas.width, canvas.height,
+      ${String(scene.draw === "drawIcon" ? 10 : 21)},
+      ${JSON.stringify(palette)},
+    );
+    window.__frogoeRaster = true;
+  } catch (error) {
+    window.__frogoeRasterError = String(error);
+  }
+})()`;
+    };
+    rasterizeArt = async (options) => {
+      const dir = path10.resolve(options.dir);
+      const missing = SCENES.filter((scene) => !existsSync7(path10.join(dir, scene.source)));
+      if (missing.length > 0) {
+        throw new Error(
+          `bundle/art-missing \u2014 author the identity scenes first (${missing.map((scene) => scene.source).join(", ")}); run \`frogoe check\` and see frogoe-creative \u2192 references/art.md`
+        );
+      }
+      const { startServer: startServer2 } = await Promise.resolve().then(() => (init_run(), run_exports));
+      const server = await startServer2(dir);
+      const { default: puppeteer } = await import("puppeteer-core");
+      const executablePath = await ensureBrowser();
+      const browser = await puppeteer.launch({
+        args: ["--no-sandbox", "--disable-gpu"],
+        defaultViewport: null,
+        executablePath,
+        headless: true
+      });
+      try {
+        const base = server.urls.local.replace(/\/$/u, "");
+        const brief = parseBrief(readFileSync8(path10.join(dir, "BRIEF.md"), "utf-8"));
+        const palette = {
+          accent: brief?.accent ?? "#ff3b3b",
+          bg: brief?.bg ?? "#101418",
+          fg: brief?.fg ?? "#ffffff",
+          ...brief?.outline ? { outline: brief.outline } : {}
+        };
+        const files = [];
+        const warnings = [];
+        for (const scene of SCENES) {
+          const page = await browser.newPage();
+          try {
+            await page.setViewport({ height: scene.height, width: scene.width });
+            await page.goto(base, { timeout: 15e3, waitUntil: "domcontentloaded" });
+            await page.waitForFunction("window.__frogoe !== undefined", { timeout: 15e3 });
+            await page.evaluate(rasterScriptFor(scene, palette));
+            await page.waitForFunction("window.__frogoeRaster === true", { timeout: 2e4 });
+            const failed = await page.evaluate("window.__frogoeRasterError ?? null");
+            if (failed !== null) {
+              throw new Error(`bundle/art-crash \u2014 ${scene.source}: ${failed.slice(0, 160)}`);
+            }
+            const metrics = await page.evaluate("window.__frogoeArtMetrics");
+            if (scene.draw === "drawPoster") {
+              const report = await page.evaluate("window.__frogoeArtReport");
+              const verdict = verifyTitleReadability(report, scene.width);
+              if (verdict !== null) throw new Error(verdict);
+              const band = await page.evaluate("window.__frogoeTitleBand ?? null");
+              if (band !== null) {
+                const dpr = scene.width / 540;
+                const collision = runtimeFunctions().findTitleZoneCollision(
+                  await page.evaluate(
+                    `(() => { const c = document.getElementById("__frogoe_raster"); return c.getContext("2d").getImageData(0, 0, c.width, c.height).data; })()`
+                  ),
+                  scene.width,
+                  scene.height,
+                  [band[0] * dpr, band[1] * dpr, band[2] * dpr, band[3] * dpr]
+                );
+                if (collision !== null) warnings.push(collision);
+              }
+              if (metrics.deadRows / Math.max(1, metrics.rows) > 0.7) {
+                warnings.push(
+                  `bundle/art-dead-bands \u2014 ${metrics.deadRows}/${metrics.rows} of the poster's upper-field rows are empty: compose a moment with density (storm column, flight line), see \`frogoe vision\` \u2014 frogoe-creative \u2192 references/art.md`
+                );
+              }
+            } else {
+              const report = await page.evaluate("window.__frogoeArtReport");
+              const gameSource = readFileSync8(path10.join(dir, "game.js"), "utf-8");
+              const verdict = verifyIconFullbleed(report, [...hexColorsOf(gameSource)]);
+              if (verdict !== null) throw new Error(verdict);
+              if (metrics.coverage < 0.08) {
+                warnings.push(
+                  `bundle/art-icon-fill \u2014 the mark covers only ${(metrics.coverage * 100).toFixed(1)}% of the icon: let it nearly fill the plate (55-70%), see \`frogoe vision\` \u2014 frogoe-creative \u2192 references/art.md`
+                );
+              }
+            }
+            await sleep2(80);
+            const canvas = await page.$("#__frogoe_raster");
+            if (canvas === null) throw new Error(`bundle/art-crash \u2014 ${scene.source}: no canvas`);
+            const outPath = path10.join(dir, scene.out);
+            mkdirSync4(path10.dirname(outPath), { recursive: true });
+            await canvas.screenshot({ omitBackground: true, path: outPath, type: "png" });
+            files.push({ bytes: statSync2(outPath).size, file: scene.out });
+          } finally {
+            await page.close();
+          }
+        }
+        return { files, warnings };
+      } finally {
+        await browser.close();
+        server.stop();
+      }
+    };
+  }
+});
+// src/commands/bundle.ts
+var bundle_exports = {};
+__export(bundle_exports, {
+  command: () => command2
+});
+import { defineCommand as defineCommand2 } from "citty";
+import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync3 } from "fs";
+import path11 from "path";
+var command2;
+var init_bundle2 = __esm({
+  "src/commands/bundle.ts"() {
+    "use strict";
+    init_bundle();
+    init_raster();
+    command2 = defineCommand2({
+      args: {
+        dir: { type: "positional", required: false, description: "game folder (default: cwd)" },
+        json: { type: "boolean", description: "machine-readable report" },
+        out: { type: "string", description: "output path (default: dist/index.html)" }
+      },
+      async run({ args }) {
+        const dir = args.dir ? String(args.dir) : process.cwd();
+        const report = await bundle({ dir });
+        const outPath = args.out ? path11.resolve(String(args.out)) : path11.join(dir, "dist", "index.html");
+        mkdirSync5(path11.dirname(outPath), { recursive: true });
+        writeFileSync3(outPath, report.artifact, "utf-8");
+        const art = await rasterizeArt({ dir });
+        for (const warning of [...report.warnings, ...art.warnings]) {
+          console.log(`  \u26A0 ${warning}`);
+        }
+        if (args.json) {
+          console.log(
+            JSON.stringify(
+              {
+                art: art.files,
+                artifact: outPath,
+                assets: report.assets,
+                bytes: report.bytes,
+                sha256: report.sha256,
+                warnings: report.warnings
+              },
+              null,
+              2
+            )
+          );
+        } else {
+          console.log(`  frogoe bundle \u2192 ${outPath}`);
+          console.log(
+            `  ${report.bytes} bytes \xB7 ${report.assets.length} dissolved asset(s) \xB7 sha256 ${report.sha256.slice(0, 12)}`
+          );
+          for (const asset of report.assets) {
+            console.log(`    ${asset.kind.padEnd(5)} ${asset.source}`);
+          }
+          for (const file of art.files) {
+            console.log(`    art   ${file.file} (${file.bytes} bytes)`);
+          }
+        }
+      },
+      meta: { description: "dissolve externals into one self-contained HTML" }
+    });
+  }
+});
+// src/check.ts
+var formatFindings;
+var init_check2 = __esm({
+  "src/check.ts"() {
+    "use strict";
+    init_src();
+    init_src();
+    init_src();
+    formatFindings = (result) => result.findings.map((f) => {
+      const at = f.line !== void 0 ? `:${f.line}` : "";
+      const head = `${f.severity === "error" ? "\u2716" : "\u26A0"} ${f.code}  ${f.file}${at}`;
+      return `${head}
+    ${f.message}
+    fix: ${f.fix}`;
+    }).join("\n") || "clean \u2014 0 findings";
+  }
+});
+// src/live/sampler.ts
+var PROBE_SCRIPT, DOM_PROBE_SCRIPT, CANVAS_PAINTED_SCRIPT, CANVAS_HASH_SCRIPT, GAME_STATE_SCRIPT, FINISH_EVENTS_SCRIPT, FPS_MARK_SCRIPT, FPS_SINCE_SCRIPT, fpsSinceScript, HUD_MEASURE_SCRIPT, RETRY_PRESENCE_SCRIPT, INTERRUPT_AUDIO_SCRIPT, AUDIO_STATES_SCRIPT;
+var init_sampler = __esm({
+  "src/live/sampler.ts"() {
+    "use strict";
+    PROBE_SCRIPT = `(() => {
+  if (window.__frogoeProbe) return;
+  const probe = { audioContexts: [], audioEverRan: false, finish: [], fps: [] };
+  Object.defineProperty(window, "__frogoeProbe", { value: probe });
+  document.addEventListener("frogoe:finish", (e) => {
+    const d = e && e.detail;
+    const score = d && typeof d.score === "number" ? d.score : null;
+    probe.finish.push({ at: Math.round(performance.now()), score });
+  });
+  const wrap = (Native) => class extends Native {
+    constructor(...args) {
+      super(...args);
+      probe.audioContexts.push(this);
+      this.addEventListener("statechange", () => {
+        if (this.state === "running") probe.audioEverRan = true;
+      });
+    }
+  };
+  const AC = window.AudioContext;
+  if (AC && !AC.__frogoeHooked) {
+    Object.defineProperty(wrap(AC), "__frogoeHooked", { value: true });
+    window.AudioContext = wrap(AC);
+  }
+  if (window.webkitAudioContext) {
+    window.webkitAudioContext = wrap(window.webkitAudioContext);
+  }
+  let count = 0;
+  let secStart = performance.now();
+  const tick = () => {
+    count++;
+    const now = performance.now();
+    if (now - secStart >= 1000) {
+      probe.fps.push(count);
+      count = 0;
+      secStart = now;
+    }
+    requestAnimationFrame(tick);
+  };
+  requestAnimationFrame(tick);
+})()`;
+    DOM_PROBE_SCRIPT = `(() => {
+  return {
+    canvasPresent: Boolean(document.querySelector("#c")),
+    hudPresent: Boolean(document.querySelector(".hud")),
+    state: window.__frogoe?.state ?? "(missing)",
+  };
+})()`;
+    CANVAS_PAINTED_SCRIPT = `(() => {
+  const c = document.querySelector("#c");
+  if (!c) return false;
+  const g = c.getContext("2d");
+  if (!g) return false;
+  const px = Math.floor(c.width * 0.25), py = Math.floor(c.height * 0.25);
+  const pw = Math.floor(c.width * 0.5), ph = Math.floor(c.height * 0.5);
+  const s = g.getImageData(px, py, pw, ph).data;
+  for (let i = 3; i < s.length; i += 4) { if (s[i] !== 0) return true; }
+  return false;
+})()`;
+    CANVAS_HASH_SCRIPT = `(() => {
+  const c = document.querySelector("#c");
+  if (!c) return null;
+  const g = c.getContext("2d");
+  if (!g) return null;
+  const cx = Math.floor(c.width * 0.25), cy = Math.floor(c.height * 0.25);
+  const cw = Math.floor(c.width * 0.5), ch = Math.floor(c.height * 0.5);
+  const d = g.getImageData(cx, cy, cw, ch).data;
+  let hash = 0;
+  for (let i = 0; i < d.length; i += 4) {
+    hash = (hash * 31 + d[i] + d[i + 1] * 7 + d[i + 2] * 13) | 0;
+  }
+  return hash;
+})()`;
+    GAME_STATE_SCRIPT = `window.__frogoe?.state ?? "(missing)"`;
+    FINISH_EVENTS_SCRIPT = `(() => {
+  const p = window.__frogoeProbe;
+  return p ? p.finish.slice() : [];
+})()`;
+    FPS_MARK_SCRIPT = `window.__frogoeProbe ? window.__frogoeProbe.fps.length : 0`;
+    FPS_SINCE_SCRIPT = `(() => {
+  const p = window.__frogoeProbe;
+  const mark = __MARK__;
+  return p ? p.fps.slice(mark) : [];
+})()`;
+    fpsSinceScript = (mark) => FPS_SINCE_SCRIPT.replaceAll("__MARK__", String(mark));
+    HUD_MEASURE_SCRIPT = `(() => {
+  const out = [];
+  for (const el of document.querySelectorAll(".hud *")) {
+    const own = [...el.childNodes].some((n) => n.nodeType === 3 && n.nodeValue.trim());
+    if (!own) continue;
+    const text = el.textContent ?? "";
+    const s = getComputedStyle(el);
+    const hasOutline =
+      (s.webkitTextStroke && s.webkitTextStrokeWidth !== "0px") ||
+      (s.textShadow && s.textShadow !== "none");
+    const r = el.getBoundingClientRect();
+    out.push({ hasOutline, height: r.height, label: text.trim().slice(0, 24), width: r.width });
+  }
+  return out;
+})()`;
+    RETRY_PRESENCE_SCRIPT = `(() => ({
+  gameover: Boolean(document.querySelector("[data-block-gameover]")),
+  retry: Boolean(document.querySelector("[data-block-retry]")),
+}))()`;
+    INTERRUPT_AUDIO_SCRIPT = `(() => {
+  const p = window.__frogoeProbe;
+  if (!p) return false;
+  for (const c of p.audioContexts) {
+    try { void c.suspend(); } catch (e) {}
+  }
+  return true;
+})()`;
+    AUDIO_STATES_SCRIPT = `(() => {
+  const p = window.__frogoeProbe;
+  if (!p) return { count: 0, everRan: false, running: 0 };
+  let running = 0;
+  for (const c of p.audioContexts) {
+    if (c.state === "running") running++;
+  }
+  return { count: p.audioContexts.length, everRan: p.audioEverRan === true, running };
+})()`;
+  }
+});
+// src/live/driver.ts
+var createPuppeteerDriver;
+var init_driver = __esm({
+  "src/live/driver.ts"() {
+    "use strict";
+    init_sampler();
+    createPuppeteerDriver = ({ page, size }) => {
+      const pageErrors = [];
+      const consoleErrors = [];
+      page.on("pageerror", (error) => {
+        pageErrors.push(String(error));
+      });
+      page.on("console", (message2) => {
+        if (message2.type() === "error") {
+          consoleErrors.push(message2.text());
+        }
+      });
+      page.evaluateOnNewDocument(PROBE_SCRIPT);
+      const read2 = async (script) => await page.evaluate(script);
+      return {
+        errors: () => pageErrors,
+        consoleErrors: () => consoleErrors,
+        async audioStates() {
+          return await read2(AUDIO_STATES_SCRIPT);
+        },
+        async interruptAudio() {
+          await read2(INTERRUPT_AUDIO_SCRIPT);
+        },
+        async domProbe() {
+          return await read2(DOM_PROBE_SCRIPT);
+        },
+        async canvasPainted() {
+          return await read2(CANVAS_PAINTED_SCRIPT);
+        },
+        async canvasHash() {
+          return await read2(CANVAS_HASH_SCRIPT);
+        },
+        async gameState() {
+          return await read2(GAME_STATE_SCRIPT);
+        },
+        async finishEvents() {
+          return await read2(FINISH_EVENTS_SCRIPT);
+        },
+        async fpsMark() {
+          return await read2(FPS_MARK_SCRIPT);
+        },
+        async fpsSince(mark) {
+          return await read2(fpsSinceScript(mark));
+        },
+        async hudMeasures() {
+          return await read2(HUD_MEASURE_SCRIPT);
+        },
+        async retryPresence() {
+          return await read2(RETRY_PRESENCE_SCRIPT);
+        },
+        async tap(x, y) {
+          await page.mouse.click(x, y);
+        },
+        async hold(x, y, ms) {
+          await page.mouse.move(x, y);
+          await page.mouse.down();
+          await new Promise((resolve2) => {
+            setTimeout(resolve2, ms);
+          });
+          await page.mouse.up();
+        },
+        async drag(x1, y1, x2, y2) {
+          await page.mouse.move(x1, y1);
+          await page.mouse.down();
+          await page.mouse.move(x2, y2, { steps: 6 });
+          await new Promise((resolve2) => {
+            setTimeout(resolve2, 80);
+          });
+          await page.mouse.up();
+        },
+        async clickRetryAwaitReload(timeoutMs) {
+          const interactable = `(() => {
+        const b = document.querySelector("[data-block-retry]");
+        if (!b) return false;
+        const s = getComputedStyle(b);
+        if (s.pointerEvents === "none" || s.visibility === "hidden" || s.display === "none") {
+          return false;
         }
-      }
-      let ends = false;
-      let retryReloads = 0;
-      if (!sawOver) {
-        sawOver = await waitForOver(driver, doSleep);
-      }
-      if (!sawOver) {
-        findings.push(neverEndsFinding(END_BUDGET_MS));
-      } else {
-        ends = true;
-        let canRetry = await verifyDeath(driver, ctx, findings, 0);
-        for (let cycle = 0; cycle < STABILITY_CYCLES && canRetry; cycle++) {
-          const reloaded = await driver.clickRetryAwaitReload(RETRY_NAV_MS);
-          if (!reloaded) {
-            findings.push(retryDeadFinding());
-            break;
-          }
-          retryReloads += 1;
-          await doSleep(settle);
-          const rebootState = await driver.gameState();
-          if (rebootState === "over") {
-            findings.push(earlyDeathFinding(name, "retry"));
-          } else {
-            const reboot = rebootFinding(rebootState);
-            if (reboot) {
-              findings.push(reboot);
-            }
-          }
-          if (!await driver.canvasPainted()) {
-            findings.push(canvasUnpaintedFinding(name, "retry"));
-          }
-          await ctx.shot?.(retryShotName(cycle));
-          if (cycle < STABILITY_CYCLES - 1) {
-            await runStartBurst(driver, ctx);
-            const overAgain = await waitForOver(driver, doSleep);
-            if (!overAgain) {
-              findings.push(neverEndsFinding(END_BUDGET_MS));
+        const r = b.getBoundingClientRect();
+        if (r.width < 4 || r.height < 4) return false;
+        const hit = document.elementFromPoint(r.x + r.width / 2, r.y + r.height / 2);
+        return Boolean(hit && (hit === b || b.contains(hit)));
+      })()`;
+          const grace = 3e3;
+          const started = Date.now();
+          for (; ; ) {
+            if (await page.evaluate(interactable) === true) {
               break;
             }
-            canRetry = await verifyDeath(driver, ctx, findings, cycle + 1);
+            if (Date.now() - started > grace) {
+              return false;
+            }
+            await new Promise((resolve2) => {
+              setTimeout(resolve2, 100);
+            });
           }
-        }
-      }
-      const throttleMark = await driver.fpsMark();
-      await driver.setCpuThrottling(THROTTLE_RATE);
-      await runStartBurst(driver, ctx);
-      for (let step = 0; step < PLAY_STEPS; step++) {
-        const x = Math.round(ctx.viewport.width / 2 + jitterX(step));
-        const y = Math.round(ctx.viewport.height / 2 + jitterY(step));
-        if (step === HOLD_STEP_INDEX) {
-          await driver.hold(x, y, HOLD_MS);
-        } else if (step === DRAG_STEP_INDEX) {
-          await driver.drag(x - DRAG_SPAN, y, x + DRAG_SPAN, y);
-        } else {
-          await driver.tap(x, y);
-        }
-        await doSleep(PLAY_STEP_MS);
-      }
-      const throttledBuckets = await driver.fpsSince(throttleMark);
-      await driver.setCpuThrottling(1);
-      const throttled = fpsThrottledFinding(throttledBuckets, name);
-      if (throttled) {
-        findings.push(throttled);
-      }
-      return {
-        findings,
-        lifecycle: { ends, retryReloads },
-        mobileFps: mean !== void 0 ? Math.round(mean) : void 0,
-        playability
+          const navigated = page.waitForNavigation({ timeout: timeoutMs, waitUntil: "domcontentloaded" }).then(() => true).catch(() => false);
+          const button = await page.$("[data-block-retry]");
+          if (!button) {
+            return false;
+          }
+          await button.click();
+          return await navigated;
+        },
+        async setCpuThrottling(rate) {
+          await page.emulateCPUThrottling(rate === 1 ? null : rate);
+        },
+        async screenshot() {
+          return await page.screenshot({ encoding: "binary" });
+        },
+        viewport: () => size
       };
     };
   }
 });
-// src/net/ip.ts
-import { execSync } from "child_process";
-import os from "os";
-var VIRTUAL, isPrivateV4, isLoopback, selfAddresses, pickLanIp, interfaceFromRouteOutput, ROUTE_PROBES, routedInterfaceName, resolveLan;
-var init_ip = __esm({
-  "src/net/ip.ts"() {
+// src/live/types.ts
+var finding;
+var init_types = __esm({
+  "src/live/types.ts"() {
     "use strict";
-    VIRTUAL = /^(?:utun|awdl|llw|bridge|vboxnet|veth|docker|zd|zt|tailscale|tap|tun|anpi|ipsec|gif|stf|vethernet|virtualbox|vmware|vmnet|wsl|loopback|bluetooth)/u;
-    isPrivateV4 = (ip) => {
-      const octets = ip.split(".").map(Number);
-      if (octets.length !== 4 || octets.some((n) => !Number.isInteger(n) || n < 0 || n > 255)) {
-        return false;
+    finding = (shape) => shape;
+  }
+});
+// src/live/decisions.ts
+var FPS_FLOOR2, FPS_SUSTAINED_WINDOW, FROZEN_STREAK, outlineFinding, collapseFinding, pageErrorFinding, consoleErrorFinding, canvasMissingFinding, canvasUnpaintedFinding, contractMissingFinding, stateStuckFinding, earlyDeathFinding, fpsFinding, fpsSustainedFinding, frozenFrameFinding, pausedFinding, stateCorruptFinding, playabilityFinding, finishEventFinding, neverEndsFinding, audioLockedFinding, noGameoverCardFinding, THROTTLE_RATE, THROTTLED_FPS_FLOOR, fpsThrottledFinding, noRetryFinding, retryDeadFinding, rebootFinding;
+var init_decisions = __esm({
+  "src/live/decisions.ts"() {
+    "use strict";
+    init_types();
+    FPS_FLOOR2 = 30;
+    FPS_SUSTAINED_WINDOW = 3;
+    FROZEN_STREAK = 3;
+    outlineFinding = (measures) => {
+      const bare = measures.filter((m) => !m.hasOutline);
+      if (bare.length === 0 || !bare[0]) {
+        return null;
       }
-      const [a = -1, b = -1] = octets;
-      if (a === 10) return true;
-      if (a === 172 && b >= 16 && b <= 31) return true;
-      if (a === 192 && b === 168) return true;
-      return false;
+      return finding({
+        code: "live/hud-outline",
+        file: "index.html",
+        fix: `"${bare[0].label}" has no text-shadow or -webkit-text-stroke \u2014 game HUD text needs an outline to read on ANY background (registry blocks ship one; custom HUD must add it)`,
+        message: `${bare.length} HUD text element(s) have no outline`,
+        phase: "boot",
+        recipe: "frogoe-registry \u2192 block authoring (sticker depth pattern)",
+        severity: "error"
+      });
     };
-    isLoopback = (addr) => {
-      if (!addr) return false;
-      return addr === "::1" || addr.startsWith("127.") || addr.startsWith("::ffff:127.");
+    collapseFinding = (measures) => {
+      const collapsed = measures.filter((m) => m.width < 4 || m.height < 4);
+      if (collapsed.length === 0 || !collapsed[0]) {
+        return null;
+      }
+      const first = collapsed[0];
+      return finding({
+        code: "live/layout-collapse",
+        file: "index.html",
+        fix: `"${first.label}" has content but renders ${Math.round(first.width)}\xD7${Math.round(first.height)} \u2014 an element collapsed to zero (missing display, zero-size font, or an ancestor hiding it)`,
+        message: `${collapsed.length} HUD element(s) collapsed to zero size`,
+        phase: "boot",
+        severity: "error"
+      });
     };
-    selfAddresses = (interfaces) => {
-      const own = /* @__PURE__ */ new Set();
-      for (const entries of Object.values(interfaces)) {
-        for (const entry of entries ?? []) {
-          if (entry.family === "IPv4") {
-            own.add(entry.address);
-            own.add(`::ffff:${entry.address}`);
-          } else if (entry.family === "IPv6") {
-            own.add(entry.address);
-          }
-        }
+    pageErrorFinding = (errors, viewport) => {
+      const first = errors[0];
+      if (first === void 0) {
+        return null;
       }
-      return own;
+      return finding({
+        code: "live/page-error",
+        file: "game.js",
+        fix: `uncaught: ${first.slice(0, 140)}`,
+        message: `${errors.length} uncaught page error(s) [${viewport}]`,
+        phase: "boot",
+        severity: "error"
+      });
+    };
+    consoleErrorFinding = (entries, pageErrors, viewport) => {
+      const unique = entries.filter((entry) => !pageErrors.some((e) => e.includes(entry.slice(0, 60))));
+      const first = unique[0];
+      if (first === void 0) {
+        return null;
+      }
+      return finding({
+        code: "live/console-error",
+        file: "game.js",
+        fix: `console.error: ${first.slice(0, 140)} \u2014 recoverable failures should be handled, not logged`,
+        message: `${unique.length} console.error(s) [${viewport}]`,
+        phase: "boot",
+        severity: "warning"
+      });
+    };
+    canvasMissingFinding = (viewport) => finding({
+      code: "live/canvas-missing",
+      file: "index.html",
+      fix: 'the contract boots on <canvas id="c">',
+      message: `canvas missing [${viewport}]`,
+      phase: "boot",
+      severity: "error"
+    });
+    canvasUnpaintedFinding = (viewport, phase = "boot") => finding({
+      code: "live/canvas-unpainted",
+      file: "game.js",
+      fix: "loop.render never drew \u2014 fill loop.render = (ctx) => {...}",
+      message: `canvas stayed blank [${viewport}]`,
+      phase,
+      severity: "error"
+    });
+    contractMissingFinding = (viewport) => finding({
+      code: "live/contract-missing",
+      file: "index.html",
+      fix: 'import { defineGame } from "frogoe" \u2014 the runtime publishes window.__frogoe at boot',
+      message: `window.__frogoe absent [${viewport}]`,
+      phase: "boot",
+      severity: "error"
+    });
+    stateStuckFinding = (state, viewport, phase = "boot") => {
+      if (state !== "loading") {
+        return null;
+      }
+      return finding({
+        code: "live/state-stuck",
+        file: "game.js",
+        fix: 'state never left "loading" \u2014 defineGame() threw before start() or start() was never called',
+        message: `state stuck in "loading" [${viewport}]`,
+        phase,
+        severity: "error"
+      });
+    };
+    earlyDeathFinding = (viewport, phase = "boot") => finding({
+      code: "live/early-death",
+      file: "game.js",
+      fix: 'state reached "over" before any input \u2014 the game kills itself on the ready screen; gate death (and the physics that cause it) behind the first input.on("down")',
+      message: `game ended before the first input [${viewport}]`,
+      phase,
+      severity: "error"
+    });
+    fpsFinding = (fps, viewport) => {
+      if (fps === void 0 || fps >= FPS_FLOOR2) {
+        return null;
+      }
+      return finding({
+        code: "live/fps",
+        file: "game.js",
+        fix: `${fps.toFixed(0)} fps on ${viewport} (floor ${FPS_FLOOR2}) \u2014 heavy per-frame work: cache gradients, cut particle counts, avoid shadowBlur on big shapes`,
+        message: `frame rate below the playability floor [${viewport}]`,
+        phase: "play",
+        recipe: "frogoe-creative \u2192 game-feel (motion rules)",
+        severity: "warning"
+      });
     };
-    pickLanIp = (interfaces, routedName) => {
-      const physical = [];
-      const virtual = [];
-      for (const [name, entries] of Object.entries(interfaces)) {
-        for (const entry of entries ?? []) {
-          if (entry.family !== "IPv4" || entry.internal || !isPrivateV4(entry.address)) continue;
-          const item = { ip: entry.address, name };
-          if (VIRTUAL.test(name.toLowerCase())) virtual.push(item);
-          else physical.push(item);
-        }
+    fpsSustainedFinding = (buckets, viewport) => {
+      if (buckets.length < FPS_SUSTAINED_WINDOW) {
+        return null;
       }
-      physical.sort((a, b) => a.name.localeCompare(b.name));
-      virtual.sort((a, b) => a.name.localeCompare(b.name));
-      if (routedName) {
-        const routed = physical.find((p) => p.name === routedName) ?? virtual.find((v) => v.name === routedName);
-        if (routed) {
-          return {
-            candidates: [routed.ip],
-            confidence: "routed",
-            ip: routed.ip,
-            virtual: !physical.includes(routed)
-          };
+      let worst = Number.POSITIVE_INFINITY;
+      for (let i = 0; i + FPS_SUSTAINED_WINDOW <= buckets.length; i++) {
+        const window = buckets.slice(i, i + FPS_SUSTAINED_WINDOW);
+        const avg = window.reduce((a, b) => a + b, 0) / window.length;
+        if (avg < worst) {
+          worst = avg;
         }
       }
-      const chosen = physical[0] ?? virtual[0];
-      if (!chosen) {
-        return { candidates: [], confidence: "none", virtual: false };
+      if (worst >= FPS_FLOOR2) {
+        return null;
       }
+      const mean = buckets.reduce((a, b) => a + b, 0) / buckets.length;
       return {
-        candidates: physical.length > 0 ? physical.map((p) => p.ip) : virtual.map((v) => v.ip),
-        confidence: "heuristic",
-        ip: chosen.ip,
-        virtual: !physical.includes(chosen)
+        finding: finding({
+          code: "live/fps-sustained",
+          file: "game.js",
+          fix: `${worst.toFixed(0)} fps held for ${FPS_SUSTAINED_WINDOW}s+ on ${viewport} (floor ${FPS_FLOOR2}) \u2014 the game is consistently slow, not jittering: cut per-frame allocations, shrink offscreen canvases, reduce draw calls`,
+          message: `sustained low frame rate [${viewport}]`,
+          phase: "play",
+          recipe: "frogoe-creative \u2192 game-feel (motion rules)",
+          severity: "error"
+        }),
+        mean
       };
     };
-    interfaceFromRouteOutput = (output, style) => {
-      if (style === "bsd") return /interface:\s*(\S+)/u.exec(output)?.[1];
-      if (style === "linux") return /dev\s+(\S+)/u.exec(output)?.[1];
-      return output.split(/\r?\n/u).map((line) => line.trim()).find((line) => line.length > 0);
+    frozenFrameFinding = (streak) => {
+      if (streak < FROZEN_STREAK) {
+        return null;
+      }
+      return finding({
+        code: "live/frozen-frame",
+        file: "game.js",
+        fix: `canvas held the same frame for ${streak} samples while playing \u2014 loop.render may have stopped or draws a static scene`,
+        message: "canvas froze during play",
+        phase: "play",
+        severity: "warning"
+      });
     };
-    ROUTE_PROBES = [
-      { cmd: "route -n get default", style: "bsd" },
-      // darwin/bsd; usage-errors elsewhere
-      { cmd: "ip route show default", style: "linux" },
-      // linux; absent on darwin/win
-      {
-        cmd: `powershell -NoProfile -Command "(Get-NetRoute -DestinationPrefix '0.0.0.0/0' | Sort-Object RouteMetric | Select-Object -First 1).InterfaceAlias"`,
-        style: "windows"
+    pausedFinding = () => finding({
+      code: "live/paused",
+      file: "game.js",
+      fix: 'state read "paused" during scripted play \u2014 pause() ran without a matching resume(); check document.hidden handling and blur listeners',
+      message: "game paused itself during play",
+      phase: "play",
+      severity: "warning"
+    });
+    stateCorruptFinding = (state) => finding({
+      code: "live/state-corrupt",
+      file: "game.js",
+      fix: `state read "${state}" \u2014 outside the contract's set (loading/playing/paused/over); game code is mutating window.__frogoe directly`,
+      message: `state left the contract's state machine ("${state}")`,
+      phase: "play",
+      severity: "error"
+    });
+    playabilityFinding = (result) => {
+      if (result === "pass") {
+        return null;
       }
-    ];
-    routedInterfaceName = () => {
-      for (const probe of ROUTE_PROBES) {
-        try {
-          const out = execSync(probe.cmd, {
-            encoding: "utf-8",
-            stdio: ["ignore", "pipe", "ignore"],
-            timeout: 3e3
-          });
-          const name = interfaceFromRouteOutput(out, probe.style);
-          if (name) return name;
-        } catch {
-        }
+      if (result === "no-input") {
+        return finding({
+          code: "live/no-input",
+          file: "game.js",
+          fix: 'the game never registered input.on("down", ...) \u2014 wire the core verb before shipping',
+          message: "game has no input handler",
+          phase: "play",
+          severity: "error"
+        });
       }
-      return null;
+      return finding({
+        code: "live/not-playable",
+        file: "game.js",
+        fix: "scripted taps produced no canvas change \u2014 loop.update/loop.render may be wired but the game logic never runs",
+        message: "game did not respond to scripted input",
+        phase: "play",
+        severity: "error"
+      });
+    };
+    finishEventFinding = (stateOver, finishCount) => {
+      if (stateOver === finishCount > 0) {
+        return null;
+      }
+      return finding({
+        code: "live/finish-event-missing",
+        file: "game.js",
+        fix: stateOver ? 'state reached "over" but frogoe:finish never fired \u2014 call finish(score) on death, never write __frogoe.state directly' : 'frogoe:finish fired but state is not "over" \u2014 the event was dispatched outside finish()',
+        message: "state/event mismatch at game over",
+        phase: "end",
+        severity: "error"
+      });
+    };
+    neverEndsFinding = (budgetMs) => finding({
+      code: "live/never-ends",
+      file: "game.js",
+      fix: `no death within ${Math.round(budgetMs / 1e3)}s of passive play \u2014 fine for endless/sandbox games, but feed games are short replayable loops; most deaths should arrive in seconds`,
+      message: "game never reached the over state",
+      phase: "end",
+      severity: "warning"
+    });
+    audioLockedFinding = (audio) => {
+      if (audio.count === 0 || audio.running > 0) {
+        return null;
+      }
+      return finding({
+        code: "live/audio-locked",
+        file: "game.js",
+        fix: 'audio contexts exist but stayed suspended after an interruption + real input \u2014 resume inside a user gesture: Sfx.init() in input.on("down") AND ("up"), plus the 1-sample silent-buffer unlock (frogoe-core \u2192 references/audio.md)',
+        message: "audio never recovers \u2014 every phone interruption plays this game silent",
+        phase: "play",
+        recipe: "frogoe-core \u2192 references/audio.md",
+        severity: "error"
+      });
+    };
+    noGameoverCardFinding = () => finding({
+      code: "live/no-gameover-card",
+      file: "index.html",
+      fix: "no [data-block-gameover] overlay when the game ended \u2014 install the game-over-card block so death has a screen",
+      message: "game over has no overlay",
+      phase: "end",
+      recipe: "frogoe-registry \u2192 game-over-card",
+      severity: "warning"
+    });
+    THROTTLE_RATE = 4;
+    THROTTLED_FPS_FLOOR = 15;
+    fpsThrottledFinding = (buckets, viewport) => {
+      if (buckets.length === 0) return null;
+      const mean = buckets.reduce((a, b) => a + b, 0) / buckets.length;
+      if (mean >= THROTTLED_FPS_FLOOR) return null;
+      return finding({
+        code: "live/fps-throttled",
+        file: "game.js",
+        fix: `fps ${mean.toFixed(0)} under ${THROTTLE_RATE}x cpu throttle (${viewport}) \u2014 mid-range phones will feel this: cache gradients/patterns, cut per-frame allocations, shrink offscreen canvases, cap particles`,
+        message: "cpu-bound collapse under phone-class throttle",
+        phase: "play",
+        severity: "warning"
+      });
+    };
+    noRetryFinding = () => finding({
+      code: "live/no-retry",
+      file: "index.html",
+      fix: "no [data-block-retry] button anywhere \u2014 the player is hard-stuck after death; the retry affordance is the loop's exit",
+      message: "no retry affordance after game over",
+      phase: "end",
+      recipe: "frogoe-registry \u2192 game-over-card",
+      severity: "error"
+    });
+    retryDeadFinding = () => finding({
+      code: "live/retry-dead",
+      file: "game.js",
+      fix: 'clicking retry produced no reload \u2014 wire it: retry.addEventListener("click", () => location.reload())',
+      message: "retry button did not reload the page",
+      phase: "retry",
+      severity: "error"
+    });
+    rebootFinding = (state) => {
+      if (state === "playing") {
+        return null;
+      }
+      return finding({
+        code: "live/state-stuck",
+        file: "game.js",
+        fix: `after retry reloaded the page the state read "${state}" \u2014 the second boot is not healthy (check localStorage parsing and one-time init paths)`,
+        message: `retry boot stuck in "${state}"`,
+        phase: "retry",
+        severity: "error"
+      });
     };
-    resolveLan = () => pickLanIp(os.networkInterfaces(), routedInterfaceName());
   }
 });
-// src/telemetry/records.ts
-var FPS_FLOOR2, formatClock, dipSpans, beaconToRecords, summarizeRecords;
-var init_records = __esm({
-  "src/telemetry/records.ts"() {
+// src/live/phases.ts
+var END_BUDGET_MS, RETRY_NAV_MS, PLAY_STEPS, PLAY_STEP_MS, HOLD_STEP_INDEX, DRAG_STEP_INDEX, DRAG_SPAN, HOLD_MS, POLL_MS, GRACE_MS, STABILITY_CYCLES, START_BURST_TAPS, DESKTOP_FPS_MS, sleep3, jitterX, jitterY, hasError, runBootChecks, runDesktopPass, overShotName, retryShotName, waitForOver, runStartBurst, verifyDeath, runLifecycle;
+var init_phases = __esm({
+  "src/live/phases.ts"() {
     "use strict";
-    FPS_FLOOR2 = 30;
-    formatClock = (wall) => {
-      const d = new Date(wall);
-      const p = (n) => String(n).padStart(2, "0");
-      return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
-    };
-    dipSpans = (buckets) => {
-      const spans = [];
-      let start = -1;
-      let worst = 0;
-      for (let i = 0; i <= buckets.length; i++) {
-        const low = i < buckets.length && (buckets[i] ?? 0) > 0 && (buckets[i] ?? 0) < FPS_FLOOR2;
-        if (low && start === -1) {
-          start = i;
-          worst = buckets[i] ?? 0;
-        } else if (low) {
-          worst = Math.min(worst, buckets[i] ?? 0);
-        } else if (start !== -1) {
-          spans.push({ fps: worst, len: i - start, start });
-          start = -1;
-        }
+    init_decisions();
+    END_BUDGET_MS = 45e3;
+    RETRY_NAV_MS = 8e3;
+    PLAY_STEPS = 7;
+    PLAY_STEP_MS = 850;
+    HOLD_STEP_INDEX = 3;
+    DRAG_STEP_INDEX = 5;
+    DRAG_SPAN = 90;
+    HOLD_MS = 400;
+    POLL_MS = 400;
+    GRACE_MS = 150;
+    STABILITY_CYCLES = 2;
+    START_BURST_TAPS = 3;
+    DESKTOP_FPS_MS = 2e3;
+    sleep3 = (ms) => new Promise((resolve2) => {
+      setTimeout(resolve2, ms);
+    });
+    jitterX = (step) => step * 37 % 121 - 60;
+    jitterY = (step) => step * 53 % 181 - 90;
+    hasError = (findings) => findings.some((f) => f.severity === "error");
+    runBootChecks = async (driver, ctx) => {
+      const findings = [];
+      const name = ctx.viewport.name;
+      const pageErr = pageErrorFinding(driver.errors(), name);
+      if (pageErr) {
+        findings.push(pageErr);
       }
-      return spans;
-    };
-    beaconToRecords = (payload, arrivalWall) => {
-      const out = [];
-      const arrivalUp = payload.up;
-      const wallAt = (up) => arrivalWall - Math.max(0, arrivalUp - up) * 1e3;
-      const buckets = payload.fps ?? [];
-      const spans = dipSpans(buckets);
-      const spanEnd = new Map(spans.map((s) => [s.start + s.len - 1, s]));
-      for (let i = 0; i < buckets.length; i++) {
-        const fps = buckets[i] ?? 0;
-        const up = Math.max(0, arrivalUp - (buckets.length - 1 - i));
-        const wall = wallAt(up);
-        const time = formatClock(wall);
-        out.push({
-          record: { fps, time, type: "fps", up, wall },
-          text: ""
-        });
-        const span = spanEnd.get(i);
-        if (span) {
-          out.push({
-            record: { fps: span.fps, time, type: "fps", up, wall },
-            text: `\u26A0 ${time}  fps ${span.fps} \u2014 dip ${span.len}s`
-          });
-        }
+      const conErr = consoleErrorFinding(driver.consoleErrors(), driver.errors(), name);
+      if (conErr) {
+        findings.push(conErr);
       }
-      for (const event of payload.events ?? []) {
-        const wall = wallAt(event.up);
-        const time = formatClock(wall);
-        const type = event.type === "error" || event.type === "rejection" || event.type === "hidden" || event.type === "visible" ? event.type : "error";
-        const msg = (event.msg ?? "").slice(0, 160);
-        const text = type === "hidden" ? `\xB7 ${time}  phone hidden` : type === "visible" ? `\xB7 ${time}  phone visible` : `\u2716 ${time}  ${type === "rejection" ? "unhandled rejection" : "page error"}: ${msg}`;
-        out.push({ record: { msg, time, type, up: event.up, wall }, text });
+      const probe = await driver.domProbe();
+      if (!probe.canvasPresent) {
+        findings.push(canvasMissingFinding(name));
+      } else if (!await driver.canvasPainted()) {
+        findings.push(canvasUnpaintedFinding(name));
       }
-      return out;
-    };
-    summarizeRecords = (records) => {
-      const fps = records.filter((r) => r.type === "fps" && typeof r.fps === "number");
-      const buckets = fps.map((r) => r.fps ?? 0).filter((n) => n > 0);
-      const spans = dipSpans(buckets);
-      const orderKey = (r) => typeof r.wall === "number" ? r.wall : r.up * 1e3;
-      let hiddenS = 0;
-      let pendingHidden;
-      for (const r of records) {
-        if (pendingHidden !== void 0) {
-          hiddenS += Math.max(0, orderKey(r) - pendingHidden) / 1e3;
-          pendingHidden = void 0;
-        }
-        if (r.type === "hidden") {
-          pendingHidden = orderKey(r);
+      if (probe.state === "(missing)") {
+        findings.push(contractMissingFinding(name));
+      } else if (probe.state === "over") {
+        findings.push(earlyDeathFinding(name));
+      } else {
+        const stuck = stateStuckFinding(probe.state, name);
+        if (stuck) {
+          findings.push(stuck);
         }
       }
-      const worstSpan = spans.reduce(
-        (acc, s) => acc === void 0 || s.len > acc.len ? s : acc,
-        void 0
-      );
-      const worst = worstSpan ? {
-        fps: worstSpan.fps,
-        len: worstSpan.len,
-        time: fps[worstSpan.start + worstSpan.len - 1]?.time ?? "?"
-      } : void 0;
-      let pageLoads = records.length > 0 ? 1 : 0;
-      let prevUp = -1;
-      for (const r of records) {
-        if (prevUp !== -1 && r.up + 2 < prevUp) pageLoads += 1;
-        prevUp = r.up;
+      if (probe.hudPresent) {
+        const measures = await driver.hudMeasures();
+        const outline = outlineFinding(measures);
+        if (outline) {
+          findings.push(outline);
+        }
+        const collapse = collapseFinding(measures);
+        if (collapse) {
+          findings.push(collapse);
+        }
       }
-      const first = records[0];
-      const last = records[records.length - 1];
-      const durationS = first && last && typeof first.wall === "number" && typeof last.wall === "number" ? (
-        // +1s: the first bucket already covers one second of play
-        Math.round((last.wall - first.wall + 1e3) / 1e3)
-      ) : Math.round(last?.up ?? 0);
-      return {
-        buckets: buckets.length,
-        dips: spans.length,
-        durationS,
-        errors: records.filter((r) => r.type === "error" || r.type === "rejection").length,
-        hiddenS: Math.round(hiddenS),
-        meanFps: buckets.length > 0 ? Math.round(buckets.reduce((a, b) => a + b, 0) / buckets.length) : void 0,
-        pageLoads,
-        worst
-      };
+      return findings;
     };
-  }
-});
-// src/telemetry/session.ts
-import { appendFileSync, mkdirSync as mkdirSync4, readdirSync as readdirSync2 } from "fs";
-import path6 from "path";
-var pad, sessionStamp, createSessionStore, latestSessionFile;
-var init_session = __esm({
-  "src/telemetry/session.ts"() {
-    "use strict";
-    pad = (n) => String(n).padStart(2, "0");
-    sessionStamp = (wall) => {
-      const d = new Date(wall);
-      return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
+    runDesktopPass = async (driver, ctx) => {
+      const doSleep = ctx.sleep ?? sleep3;
+      const findings = await runBootChecks(driver, ctx);
+      if (hasError(findings)) {
+        return { findings };
+      }
+      const mark = await driver.fpsMark();
+      await doSleep(DESKTOP_FPS_MS);
+      const buckets = await driver.fpsSince(mark);
+      if (buckets.length === 0) {
+        return { findings };
+      }
+      const mean = buckets.reduce((a, b) => a + b, 0) / buckets.length;
+      const warn = fpsFinding(mean, ctx.viewport.name);
+      if (warn) {
+        findings.push(warn);
+      }
+      await ctx.shot?.("live-desktop.png");
+      return { findings, fps: Math.round(mean) };
     };
-    createSessionStore = (gameDir, startedWall) => {
-      const dir = path6.join(gameDir, ".frogoe", "sessions");
-      let file;
-      return {
-        file: () => file,
-        write: (records) => {
-          if (records.length === 0) return;
-          if (!file) {
-            mkdirSync4(dir, { recursive: true });
-            file = path6.join(dir, `${sessionStamp(startedWall)}.jsonl`);
-          }
-          appendFileSync(file, records.map((r) => JSON.stringify(r)).join("\n") + "\n", "utf-8");
+    overShotName = (cycle) => cycle === 0 ? "live-mobile-over.png" : `live-mobile-over-${cycle + 1}.png`;
+    retryShotName = (cycle) => cycle === 0 ? "live-mobile-retry.png" : `live-mobile-retry-${cycle + 1}.png`;
+    waitForOver = async (driver, doSleep) => {
+      for (let waited = 0; waited < END_BUDGET_MS; waited += POLL_MS) {
+        await doSleep(POLL_MS);
+        if (await driver.gameState() === "over") {
+          return true;
         }
-      };
-    };
-    latestSessionFile = (gameDir) => {
-      const dir = path6.join(gameDir, ".frogoe", "sessions");
-      try {
-        const files = readdirSync2(dir).filter((f) => f.endsWith(".jsonl")).sort();
-        return files.length > 0 ? path6.join(dir, files[files.length - 1] ?? "") : null;
-      } catch {
-        return null;
       }
+      return false;
     };
-  }
-});
-// src/run.ts
-var run_exports = {};
-__export(run_exports, {
-  startServer: () => startServer
-});
-import { existsSync as existsSync5, readFileSync as readFileSync5, statSync, watch } from "fs";
-import os2 from "os";
-import path7 from "path";
-import { createAdaptorServer } from "@hono/node-server";
-import { getConnInfo } from "@hono/node-server/conninfo";
-import { Hono } from "hono";
-var buildDevScript, MIME2, startServer;
-var init_run = __esm({
-  "src/run.ts"() {
-    "use strict";
-    init_ip();
-    init_records();
-    init_session();
-    buildDevScript = (version) => `<script>(function(){var v="${String(version)}";try{var es=new EventSource("/__frogoe/reload");es.onmessage=function(){location.reload()};es.onerror=function(){es.close()};}catch(e){}setInterval(function(){fetch("/__frogoe/version",{cache:"no-store"}).then(function(r){return r.text()}).then(function(t){if(t!==v)location.reload()}).catch(function(){})},2000);var fps=[],cnt=0,sec=performance.now(),evs=[],up0=performance.now();function up(){return (performance.now()-up0)/1000}function tick(){cnt++;var n=performance.now();if(n-sec>=1000){fps.push(cnt);cnt=0;sec=n}requestAnimationFrame(tick)}requestAnimationFrame(tick);addEventListener("error",function(e){evs.push({type:"error",msg:String(e.message||e).slice(0,200),up:up()})});addEventListener("unhandledrejection",function(e){evs.push({type:"rejection",msg:String(e.reason).slice(0,200),up:up()})});document.addEventListener("visibilitychange",function(){evs.push({type:document.hidden?"hidden":"visible",up:up()})});function flush(beacon){var p={v:1,up:up(),fps:fps.splice(0),events:evs.splice(0)};if(performance.memory)p.mem=Math.round(performance.memory.usedJSHeapSize/1048576);var b=JSON.stringify(p);if(beacon&&navigator.sendBeacon){navigator.sendBeacon("/__frogoe/metrics",new Blob([b],{type:"application/json"}));return}fetch("/__frogoe/metrics",{method:"POST",body:b,headers:{"content-type":"application/json"},keepalive:true}).catch(function(){});}document.addEventListener("visibilitychange",function(){if(document.hidden)flush(true)});addEventListener("pagehide",function(){flush(true)});setInterval(function(){flush(false)},5000);})();</script>`;
-    MIME2 = {
-      css: "text/css; charset=utf-8",
-      htm: "text/html; charset=utf-8",
-      html: "text/html; charset=utf-8",
-      ico: "image/x-icon",
-      jpeg: "image/jpeg",
-      js: "text/javascript; charset=utf-8",
-      json: "application/json; charset=utf-8",
-      mjs: "text/javascript; charset=utf-8",
-      png: "image/png",
-      svg: "image/svg+xml",
-      txt: "text/plain; charset=utf-8",
-      webp: "image/webp",
-      woff2: "font/woff2"
+    runStartBurst = async (driver, ctx) => {
+      const doSleep = ctx.sleep ?? sleep3;
+      for (let step = 0; step < START_BURST_TAPS; step++) {
+        const x = Math.round(ctx.viewport.width / 2 + jitterX(step));
+        const y = Math.round(ctx.viewport.height / 2 + jitterY(step));
+        await driver.tap(x, y);
+        await doSleep(PLAY_STEP_MS);
+      }
     };
-    startServer = async (dir, requestedPort = 0, telemetry) => {
-      const root = path7.resolve(dir);
-      if (!existsSync5(path7.join(root, "index.html"))) {
-        throw new Error(`frogoe run: no index.html in ${root} \u2014 is this a game folder?`);
+    verifyDeath = async (driver, ctx, findings, cycle) => {
+      const doSleep = ctx.sleep ?? sleep3;
+      let events = await driver.finishEvents();
+      if (events.length === 0) {
+        await doSleep(GRACE_MS);
+        events = await driver.finishEvents();
       }
-      const clients = /* @__PURE__ */ new Set();
-      let version = 0;
-      let remoteSeen = false;
-      let lastRemote = "";
-      const own = selfAddresses(os2.networkInterfaces());
-      const session = telemetry ? createSessionStore(root, Date.now()) : void 0;
-      const app = new Hono();
-      app.use("*", async (c, next) => {
-        try {
-          const address2 = getConnInfo(c).remote.address;
-          if (address2 && !isLoopback(address2) && !own.has(address2)) {
-            remoteSeen = true;
-            lastRemote = address2;
-          }
-        } catch {
+      const mismatch = finishEventFinding(true, events.length);
+      if (mismatch) {
+        findings.push(mismatch);
+      }
+      const presence = await driver.retryPresence();
+      if (!presence.gameover) {
+        findings.push(noGameoverCardFinding());
+      }
+      if (!presence.retry) {
+        findings.push(noRetryFinding());
+      }
+      await ctx.shot?.(overShotName(cycle));
+      return presence.retry;
+    };
+    runLifecycle = async (driver, ctx) => {
+      const doSleep = ctx.sleep ?? sleep3;
+      const settle = ctx.settleMs ?? 2e3;
+      const name = ctx.viewport.name;
+      const findings = [];
+      const boot = await runBootChecks(driver, ctx);
+      findings.push(...boot);
+      await ctx.shot?.("live-mobile.png");
+      if (hasError(boot)) {
+        return { findings, lifecycle: { ends: false, retryReloads: 0 }, playability: "no-input" };
+      }
+      const mark = await driver.fpsMark();
+      const hashes = [];
+      let streak = 0;
+      let maxStreak = 0;
+      let sawOver = false;
+      let sawPaused = false;
+      let sawStuck = false;
+      let corrupt = null;
+      for (let step = 0; step < PLAY_STEPS; step++) {
+        const x = Math.round(ctx.viewport.width / 2 + jitterX(step));
+        const y = Math.round(ctx.viewport.height / 2 + jitterY(step));
+        if (step === HOLD_STEP_INDEX) {
+          await driver.hold(x, y, HOLD_MS);
+        } else if (step === DRAG_STEP_INDEX) {
+          await driver.drag(x - DRAG_SPAN, y, x + DRAG_SPAN, y);
+        } else {
+          await driver.tap(x, y);
         }
-        await next();
-      });
-      app.get("/__frogoe/reload", (c) => {
-        const stream = new ReadableStream({
-          cancel() {
-          },
-          start(controller) {
-            clients.add(controller);
-            controller.enqueue(new TextEncoder().encode("retry: 3000\n\n"));
-          }
-        });
-        return c.body(stream, {
-          headers: {
-            "cache-control": "no-store",
-            connection: "keep-alive",
-            "content-type": "text/event-stream"
-          }
-        });
-      });
-      app.get(
-        "/__frogoe/version",
-        (c) => c.text(String(version), 200, { "cache-control": "no-store" })
-      );
-      app.post("/__frogoe/metrics", async (c) => {
-        try {
-          const payload = JSON.parse(await c.req.text());
-          if (!session) return c.body(null, 204);
-          const lines = beaconToRecords(payload, Date.now());
-          session.write(lines.map((l) => l.record));
-          for (const line of lines) {
-            if (line.text) telemetry?.onEvent?.(line.text);
-          }
-          return c.body(null, 204);
-        } catch {
-          return c.body(null, 400);
+        await doSleep(PLAY_STEP_MS);
+        const state = await driver.gameState();
+        if (state === "over") {
+          sawOver = true;
+          break;
         }
-      });
-      app.get("*", (c) => {
-        const raw = decodeURIComponent(new URL(c.req.url).pathname);
-        const safe = path7.normalize(raw).replaceAll("\\", "/");
-        let file = path7.join(root, safe === "/" ? "index.html" : safe);
-        if (!file.startsWith(root)) {
-          return c.text("forbidden", 403);
+        if (state === "paused") {
+          sawPaused = true;
+        } else if (state === "loading") {
+          sawStuck = true;
+        } else if (state !== "playing" && state !== "(missing)") {
+          corrupt ??= state;
         }
-        if (existsSync5(file) && statSync(file).isDirectory()) {
-          file = path7.join(file, "index.html");
+        const hash = await driver.canvasHash();
+        if (hash !== null) {
+          if (hashes.length > 0 && hash === hashes[hashes.length - 1] && state === "playing") {
+            streak += 1;
+            maxStreak = Math.max(maxStreak, streak);
+          } else {
+            streak = 0;
+          }
+          hashes.push(hash);
         }
-        if (!existsSync5(file)) {
-          return c.text(`frogoe run: not found: ${raw}`, 404);
+      }
+      const buckets = await driver.fpsSince(mark);
+      const mean = buckets.length > 0 ? buckets.reduce((a, b) => a + b, 0) / buckets.length : void 0;
+      if (corrupt !== null) {
+        findings.push(stateCorruptFinding(corrupt));
+      }
+      if (sawStuck) {
+        const stuck = stateStuckFinding("loading", name, "play");
+        if (stuck) {
+          findings.push(stuck);
         }
-        const body = readFileSync5(file);
-        const ext = path7.extname(file).slice(1).toLowerCase();
-        const type = MIME2[ext] ?? "application/octet-stream";
-        if (ext === "html" || ext === "htm") {
-          const html = body.toString("utf-8");
-          const injected = /<\/body>/iu.test(html) ? html.replace(/<\/body>/iu, `${buildDevScript(version)}</body>`) : html + buildDevScript(version);
-          return c.body(injected, 200, {
-            "cache-control": "no-store",
-            "content-type": type
-          });
+      }
+      if (sawPaused) {
+        findings.push(pausedFinding());
+      }
+      const frozen = frozenFrameFinding(maxStreak);
+      if (frozen) {
+        findings.push(frozen);
+      }
+      const sustained = fpsSustainedFinding(buckets, name);
+      if (sustained) {
+        findings.push(sustained.finding);
+      } else {
+        const warn = fpsFinding(mean, name);
+        if (warn) {
+          findings.push(warn);
         }
-        return c.body(body, 200, { "content-type": type });
-      });
-      const server = createAdaptorServer({ fetch: app.fetch });
-      await new Promise((resolve2, reject) => {
-        server.once("error", reject);
-        server.listen(requestedPort, "0.0.0.0", () => resolve2());
-      });
-      const address = server.address();
-      const port = typeof address === "object" && address ? address.port : 0;
-      if (!port) {
-        server.closeAllConnections?.();
-        server.close();
-        throw new Error("frogoe run: server failed to bind a port");
       }
-      const local = `http://localhost:${port}`;
-      const lanInfo = resolveLan();
-      const lan = lanInfo.ip ? `http://${lanInfo.ip}:${port}` : void 0;
-      let timer;
-      const watcher = watch(root, { recursive: true }, (_event, file) => {
-        const first = file?.split(path7.sep)[0];
-        if (first === "snapshots" || first === ".frogoe") {
-          return;
+      const responded = new Set(hashes).size > 1 || sawOver;
+      const playability = responded ? "pass" : "fail";
+      const play = playabilityFinding(playability);
+      if (play) {
+        findings.push(play);
+      }
+      const audioBefore = await driver.audioStates();
+      if (audioBefore.count > 0) {
+        await driver.interruptAudio();
+        await runStartBurst(driver, ctx);
+        await doSleep(600);
+        const audioFinding = audioLockedFinding(await driver.audioStates());
+        if (audioFinding) {
+          findings.push(audioFinding);
         }
-        clearTimeout(timer);
-        timer = setTimeout(() => {
-          version += 1;
-          const payload = new TextEncoder().encode("data: reload\n\n");
-          for (const client of clients) {
-            try {
-              client.enqueue(payload);
-            } catch {
-              clients.delete(client);
+      }
+      let ends = false;
+      let retryReloads = 0;
+      if (!sawOver) {
+        sawOver = await waitForOver(driver, doSleep);
+      }
+      if (!sawOver) {
+        findings.push(neverEndsFinding(END_BUDGET_MS));
+      } else {
+        ends = true;
+        let canRetry = await verifyDeath(driver, ctx, findings, 0);
+        for (let cycle = 0; cycle < STABILITY_CYCLES && canRetry; cycle++) {
+          const reloaded = await driver.clickRetryAwaitReload(RETRY_NAV_MS);
+          if (!reloaded) {
+            findings.push(retryDeadFinding());
+            break;
+          }
+          retryReloads += 1;
+          await doSleep(settle);
+          const rebootState = await driver.gameState();
+          if (rebootState === "over") {
+            findings.push(earlyDeathFinding(name, "retry"));
+          } else {
+            const reboot = rebootFinding(rebootState);
+            if (reboot) {
+              findings.push(reboot);
             }
           }
-        }, 100);
-      });
+          if (!await driver.canvasPainted()) {
+            findings.push(canvasUnpaintedFinding(name, "retry"));
+          }
+          await ctx.shot?.(retryShotName(cycle));
+          if (cycle < STABILITY_CYCLES - 1) {
+            await runStartBurst(driver, ctx);
+            const overAgain = await waitForOver(driver, doSleep);
+            if (!overAgain) {
+              findings.push(neverEndsFinding(END_BUDGET_MS));
+              break;
+            }
+            canRetry = await verifyDeath(driver, ctx, findings, cycle + 1);
+          }
+        }
+      }
+      const throttleMark = await driver.fpsMark();
+      await driver.setCpuThrottling(THROTTLE_RATE);
+      await runStartBurst(driver, ctx);
+      for (let step = 0; step < PLAY_STEPS; step++) {
+        const x = Math.round(ctx.viewport.width / 2 + jitterX(step));
+        const y = Math.round(ctx.viewport.height / 2 + jitterY(step));
+        if (step === HOLD_STEP_INDEX) {
+          await driver.hold(x, y, HOLD_MS);
+        } else if (step === DRAG_STEP_INDEX) {
+          await driver.drag(x - DRAG_SPAN, y, x + DRAG_SPAN, y);
+        } else {
+          await driver.tap(x, y);
+        }
+        await doSleep(PLAY_STEP_MS);
+      }
+      const throttledBuckets = await driver.fpsSince(throttleMark);
+      await driver.setCpuThrottling(1);
+      const throttled = fpsThrottledFinding(throttledBuckets, name);
+      if (throttled) {
+        findings.push(throttled);
+      }
       return {
-        port,
-        sawRemote: () => remoteSeen,
-        remote: () => remoteSeen ? lastRemote : void 0,
-        stop() {
-          clearTimeout(timer);
-          watcher.close();
-          server.closeAllConnections?.();
-          server.close();
-        },
-        urls: { lan, local }
+        findings,
+        lifecycle: { ends, retryReloads },
+        mobileFps: mean !== void 0 ? Math.round(mean) : void 0,
+        playability
       };
     };
   }
@@ -2455,34 +3134,19 @@ var live_exports = {};
 __export(live_exports, {
   collectLive: () => collectLive
 });
-import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync4 } from "fs";
-import path8 from "path";
-var VIEWPORTS, browserPath, ensureBrowser, waitForServer, collectLive;
+import { mkdirSync as mkdirSync6, writeFileSync as writeFileSync4 } from "fs";
+import path12 from "path";
+var VIEWPORTS, waitForServer, collectLive;
 var init_live = __esm({
   "src/live/index.ts"() {
-    "use strict";
-    init_driver();
-    init_phases();
-    VIEWPORTS = [
-      { height: 844, name: "mobile", width: 390 },
-      { height: 800, name: "desktop", width: 1280 }
-    ];
-    ensureBrowser = async () => {
-      if (browserPath) {
-        return browserPath;
-      }
-      const { Browser, getInstalledBrowsers, install } = await import("@puppeteer/browsers");
-      const cacheDir = path8.resolve(process.cwd(), "node_modules/.frogoe-browser");
-      const installed = await getInstalledBrowsers({ cacheDir });
-      const existing = installed.find((b) => b.browser === Browser.CHROMEHEADLESSSHELL);
-      browserPath = existing?.executablePath ?? (await install({
-        browser: Browser.CHROMEHEADLESSSHELL,
-        buildId: "131.0.6778.204",
-        cacheDir,
-        unpack: true
-      })).executablePath;
-      return browserPath;
-    };
+    "use strict";
+    init_browser();
+    init_driver();
+    init_phases();
+    VIEWPORTS = [
+      { height: 844, name: "mobile", width: 390 },
+      { height: 800, name: "desktop", width: 1280 }
+    ];
     waitForServer = async (url) => {
       for (let attempt = 0; attempt < 10; attempt++) {
         try {
@@ -2492,11 +3156,11 @@ var init_live = __esm({
           }
         } catch {
         }
-        await sleep2(500);
+        await sleep3(500);
       }
     };
     collectLive = async (options) => {
-      const dir = path8.resolve(options.dir);
+      const dir = path12.resolve(options.dir);
       const settle = options.settleMs ?? 2e3;
       const findings = [];
       const screenshots = [];
@@ -2506,8 +3170,8 @@ var init_live = __esm({
       };
       const { startServer: startServer2 } = await Promise.resolve().then(() => (init_run(), run_exports));
       const server = await startServer2(dir);
-      const snapshotDir = path8.join(dir, "snapshots");
-      mkdirSync5(snapshotDir, { recursive: true });
+      const snapshotDir = path12.join(dir, "snapshots");
+      mkdirSync6(snapshotDir, { recursive: true });
       const { default: puppeteer } = await import("puppeteer-core");
       const executablePath = await ensureBrowser();
       const browser = await puppeteer.launch({
@@ -2527,15 +3191,15 @@ var init_live = __esm({
               size: { height: viewport2.height, width: viewport2.width }
             });
             const shot = async (name) => {
-              writeFileSync4(path8.join(snapshotDir, name), await driver.screenshot());
-              screenshots.push(path8.join("snapshots", name));
+              writeFileSync4(path12.join(snapshotDir, name), await driver.screenshot());
+              screenshots.push(path12.join("snapshots", name));
             };
             if (!serverReady) {
               await waitForServer(server.urls.local);
               serverReady = true;
             }
             await page.goto(server.urls.local, { timeout: 15e3, waitUntil: "domcontentloaded" });
-            await sleep2(settle);
+            await sleep3(settle);
             if (viewport2.name === "mobile") {
               const outcome = await runLifecycle(driver, {
                 settleMs: settle,
@@ -2594,6 +3258,7 @@ var init_check3 = __esm({
       args: {
         dir: { type: "positional", required: false, description: "game folder (default: cwd)" },
         json: { type: "boolean", description: "machine-readable findings" },
+        fast: { type: "boolean", description: "static only, no Chrome (quick iteration)" },
         live: {
           type: "boolean",
           description: "deprecated no-op \u2014 the live sandbox always runs now"
@@ -2605,16 +3270,22 @@ var init_check3 = __esm({
         }
         const dir = args.dir ? String(args.dir) : process.cwd();
         const result = checkProject(dir);
-        const { collectLive: collectLive2 } = await Promise.resolve().then(() => (init_live(), live_exports));
-        console.log("  live pass: boot \u2192 play \u2192 end \u2192 retry (headless chrome)\u2026");
-        const live = await collectLive2({ dir });
-        result.findings = [...result.findings, ...live.findings].sort(
-          (a, b) => a.file.localeCompare(b.file) || (a.line ?? 0) - (b.line ?? 0)
-        );
-        result.errors = result.findings.filter((f) => f.severity === "error").length;
-        result.warnings = result.findings.filter((f) => f.severity === "warning").length;
-        if (live.screenshots.length > 0) {
-          console.log(`  snapshots: ${live.screenshots.join(", ")}`);
+        if (args.fast === true) {
+          if (!args.json) {
+            console.log("  (fast: static only \u2014 run full `frogoe check` before shipping)");
+          }
+        } else {
+          const { collectLive: collectLive2 } = await Promise.resolve().then(() => (init_live(), live_exports));
+          console.log("  live pass: boot \u2192 play \u2192 end \u2192 retry (headless chrome)\u2026");
+          const live = await collectLive2({ dir });
+          result.findings = [...result.findings, ...live.findings].sort(
+            (a, b) => a.file.localeCompare(b.file) || (a.line ?? 0) - (b.line ?? 0)
+          );
+          result.errors = result.findings.filter((f) => f.severity === "error").length;
+          result.warnings = result.findings.filter((f) => f.severity === "warning").length;
+          if (live.screenshots.length > 0) {
+            console.log(`  snapshots: ${live.screenshots.join(", ")}`);
+          }
         }
         if (args.json) {
           console.log(JSON.stringify(result, null, 2));
@@ -2634,18 +3305,825 @@ var init_check3 = __esm({
   }
 });
+// src/embed/card.ts
+var BOOT_TIMEOUT_MS, LOADING_TIMEOUT_MS, CARD_ELEMENT_SCRIPT, composeEmbedHtml, safeJson, escapeHtml;
+var init_card = __esm({
+  "src/embed/card.ts"() {
+    "use strict";
+    BOOT_TIMEOUT_MS = 1e4;
+    LOADING_TIMEOUT_MS = 45e3;
+    CARD_ELEMENT_SCRIPT = `
+if (!customElements.get("frogoe-card")) {
+  customElements.define("frogoe-card", class FrogoeCard extends HTMLElement {
+    static get observedAttributes() {
+      return ["src", "width", "height", "poster", "payload"];
+    }
+    constructor() {
+      super();
+      this._frame = null;
+      this._card = null;
+      this._bootTimer = null;
+      this._loadingTimer = null;
+      this._state = "loading";
+      this._score = null;
+      this._manifest = null;
+    }
+    connectedCallback() { this._build(); }
+    disconnectedCallback() { this._destroy(); }
+    attributeChangedCallback(name, oldVal, newVal) {
+      if (oldVal === newVal) return;
+      if (name === "src" && this._frame) this._frame.src = newVal;
+      if (name === "width") this.style.width = newVal + "px";
+      if (name === "height") this.style.height = newVal + "px";
+      if ((name === "poster" || name === "payload") && this._frame) this._build();
+    }
+    get state() { return this._state; }
+    get score() { return this._score; }
+    get manifest() { return this._manifest; }
+    get cardWindow() { return this._card ? this._card.__frogoeCard : null; }
+    pause() { if (this._card) this._card.__frogoeCard.pause(); }
+    resume() { if (this._card) this._card.__frogoeCard.resume(); }
+    mute(m) { if (this._card) this._card.__frogoeCard.mute(m); }
+    restart() { if (this._card) this._card.__frogoeCard.restart(); }
+    _build() {
+      this._destroy();
+      const shadow = this.shadowRoot || this.attachShadow({ mode: "open" });
+      shadow.innerHTML = "";
+      const frame = document.createElement("iframe");
+      frame.style.cssText = "border:0;display:block;width:100%;height:100%";
+      frame.sandbox = "allow-scripts allow-same-origin";
+      frame.referrerPolicy = "no-referrer";
+      frame.title = "frogoe game";
+      const src = this.getAttribute("src");
+      if (src) frame.src = src;
+      shadow.appendChild(frame);
+      this._frame = frame;
+      frame.addEventListener("load", () => {
+        try {
+          const card = frame.contentWindow;
+          if (card && card.__frogoeCard) {
+            this._card = card;
+            card.addEventListener("frogoe:card-state", (e) => {
+              this._state = e.detail.state;
+              this._score = e.detail.score;
+              this.dispatchEvent(new CustomEvent("frogoe:card-state", { detail: e.detail, bubbles: true }));
+            });
+          }
+        } catch (e) { /* cross-origin */ }
+      });
+    }
+    _destroy() {
+      if (this._frame) {
+        this._frame.remove();
+        this._frame = null;
+      }
+      this._card = null;
+      this._state = "loading";
+      this._score = null;
+    }
+  });
+}
+`;
+    composeEmbedHtml = (options) => {
+      const { manifest, payloadB64, posterDataUri, iconDataUri } = options;
+      const p = manifest.palette;
+      return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+<title>${escapeHtml(manifest.title)}</title>
+<meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data:; font-src data:; media-src data:; connect-src 'none'">
+${iconDataUri ? `<link rel="icon" href="${iconDataUri}">` : ""}
+<style>
+html,body{margin:0;height:100%;overflow:hidden;background:${p.bg || "#111"};}
+iframe{border:0;display:block;width:100%;height:100%}
+.p{position:absolute;inset:0;z-index:2;background:${posterDataUri ? `url("${posterDataUri}") center / cover no-repeat` : p.bg || "#111"};transition:opacity 500ms ease}
+.p.off{opacity:0;pointer-events:none}
+@media (prefers-reduced-motion: reduce){.p{transition:none}}
+</style>
+</head>
+<body>
+<script type="application/octet-stream" id="frogoe-game">${payloadB64}</script>
+<iframe id="frame" title="${escapeHtml(manifest.title)}" sandbox="allow-scripts" referrerpolicy="no-referrer"></iframe>
+<div class="p" id="poster"></div>
+<script>
+(function () {
+  var frame = document.getElementById("frame");
+  var poster = document.getElementById("poster");
+  var BOOT_TIMEOUT = ${String(BOOT_TIMEOUT_MS)};
+  var LOADING_TIMEOUT = ${String(LOADING_TIMEOUT_MS)};
+  var bootTimer, loadingTimer;
+  var postControl = function (payload) {
+    try {
+      frame.contentWindow.postMessage(
+        Object.assign({ source: "frogoe-card-host", v: 1, type: "control" }, payload),
+        "*"
+      );
+    } catch (e) {}
+  };
+  window.__frogoeCard = { state: "loading", score: null,
+    restart: function () { boot(); },
+    pause: function () { postControl({ action: "pause" }); },
+    resume: function () { postControl({ action: "resume" }); },
+    mute: function (m) { muted = m === true; postControl({ action: "mute", muted: m === true }); },
+    destroy: function () {
+      clearTimeout(bootTimer); clearTimeout(loadingTimer);
+      postControl({ action: "pause" });
+      try { frame.srcdoc = ""; } catch (e) {}
+      frame.remove();
+      poster.remove();
+      var carrier = document.getElementById("frogoe-game");
+      if (carrier) carrier.remove();
+      window.__frogoeCard.state = "destroyed";
+    } };
+  window.__frogoeManifest = ${safeJson(manifest)};
+  function setState(state, score) {
+    window.__frogoeCard.state = state;
+    if (state === "over") window.__frogoeCard.score = score === undefined ? 0 : score;
+    if (state === "running") {
+      poster.classList.add("off");
+      try { frame.contentWindow?.focus(); } catch (e) {}
+      if (muted) postControl({ action: "mute", muted: true });
+    }
+    document.dispatchEvent(new CustomEvent("frogoe:card-state", {
+      detail: { state: state, score: window.__frogoeCard.score }
+    }));
+  }
+  function fail() { setState("error"); }
+  var muted = false;
+  function boot() {
+    clearTimeout(bootTimer); clearTimeout(loadingTimer);
+    poster.classList.remove("off");
+    window.__frogoeCard.state = "loading"; window.__frogoeCard.score = null;
+    var b64 = document.getElementById("frogoe-game").textContent;
+    var bytes = Uint8Array.from(atob(b64), function (c) { return c.charCodeAt(0); });
+    frame.srcdoc = new TextDecoder().decode(bytes);
+    bootTimer = setTimeout(function () { if (window.__frogoeCard.state === "loading") fail(); }, BOOT_TIMEOUT);
+    loadingTimer = setTimeout(function () {
+      if (window.__frogoeCard.state === "loading") fail();
+    }, LOADING_TIMEOUT);
+  }
+  function parseMsg(data) {
+    if (typeof data !== "object" || data === null) return null;
+    if (data.v !== 1 || data.source !== "frogoe-card") return null;
+    if (data.type === "error") return { type: "error" };
+    if (data.type !== "state") return null;
+    var s = data.state;
+    if (s !== "loading" && s !== "running" && s !== "over") return null;
+    if (s === "over") {
+      if (typeof data.score !== "number" || !isFinite(data.score)) return null;
+      return { type: "state", state: "over", score: data.score };
+    }
+    if ("score" in data) return null;
+    return { type: "state", state: s };
+  }
+  window.addEventListener("message", function (event) {
+    if (event.source !== frame.contentWindow) return;
+    var parsed = parseMsg(event.data);
+    if (!parsed) return;
+    clearTimeout(bootTimer); clearTimeout(loadingTimer);
+    if (parsed.type === "error") { fail(); return; }
+    if (parsed.state === "loading") return;
+    setState(parsed.state, parsed.score);
+    try { parent.postMessage(event.data, "*"); } catch (e) {}
+  });
+  boot();
+})();
+</script>
+<script>
+${CARD_ELEMENT_SCRIPT}
+</script>
+</body>
+</html>`;
+    };
+    safeJson = (value) => JSON.stringify(value).replaceAll("<", "\\u003c").replaceAll(">", "\\u003e").replaceAll("&", "\\u0026").replaceAll("\u2028", "\\u2028").replaceAll("\u2029", "\\u2029");
+    escapeHtml = (s) => s.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+  }
+});
+// src/embed/protocol.ts
+var CARD_PROTOCOL_VERSION, CARD_SOURCE_TAG, HOST_SOURCE_TAG, parseHostControl;
+var init_protocol = __esm({
+  "src/embed/protocol.ts"() {
+    "use strict";
+    CARD_PROTOCOL_VERSION = 1;
+    CARD_SOURCE_TAG = "frogoe-card";
+    HOST_SOURCE_TAG = "frogoe-card-host";
+    parseHostControl = (data) => {
+      if (typeof data !== "object" || data === null) return null;
+      const message2 = data;
+      if (message2.v !== CARD_PROTOCOL_VERSION) return null;
+      if (message2.source !== HOST_SOURCE_TAG) return null;
+      if (message2.type !== "control") return null;
+      const action = message2.action;
+      if (action === "pause" || action === "resume") return { action };
+      if (action === "mute") {
+        if (typeof message2.muted !== "boolean") return null;
+        return { action: "mute", muted: message2.muted };
+      }
+      return null;
+    };
+  }
+});
+// src/embed/relay.ts
+var RELAY_SCRIPT;
+var init_relay = __esm({
+  "src/embed/relay.ts"() {
+    "use strict";
+    init_protocol();
+    RELAY_SCRIPT = `<script>
+(function () {
+  // the pure protocol validator, injected as source \u2014 the tested code IS
+  // the shipped code (same pattern as the raster/vision analyzers)
+  var parseHostControl = ${parseHostControl.toString()};
+  var post = function (payload) {
+    try {
+      window.parent.postMessage(
+        Object.assign({ source: "${CARD_SOURCE_TAG}", v: ${String(CARD_PROTOCOL_VERSION)} }, payload),
+        "*"
+      );
+    } catch (e) { /* parent gone \u2014 sandbox lifecycle, not a crash */ }
+  };
+  var score = 0;
+  var last = "";
+  var map = function (state) {
+    if (state === "over") return "over";
+    if (state === "playing" || state === "paused") return "running";
+    return "loading";
+  };
+  var emit = function (card) {
+    if (card === last) return;
+    last = card;
+    if (card === "over") post({ type: "state", state: "over", score: score });
+    else post({ type: "state", state: card });
+  };
+  // The embed context mark: this relay exists ONLY inside embed cards,
+  // so the class is the truthful "you are embedded" signal \u2014 games use
+  // it to surface touch controls (iframes cannot rely on keyboards).
+  try { document.documentElement.classList.add("frogoe-embed"); } catch (e) {}
+  document.addEventListener("frogoe:finish", function (event) {
+    var detail = event && event.detail;
+    score = detail && typeof detail.score === "number" && isFinite(detail.score)
+      ? detail.score
+      : 0;
+    emit("over");
+  });
+  window.addEventListener("error", function () {
+    post({ type: "error" });
+  });
+  // host \u2192 game control (play/pause/mute parity): validated by version,
+  // source tag AND frame identity (event.source must be the parent) \u2014
+  // the relay only ever calls the contract's own handle, never game code
+  window.addEventListener("message", function (event) {
+    if (event.source !== window.parent) return;
+    var control = parseHostControl(event.data);
+    if (!control) return;
+    try {
+      var api = window.__frogoe;
+      if (!api) return;
+      if (control.action === "pause" && typeof api.pause === "function") api.pause();
+      if (control.action === "resume" && typeof api.resume === "function") api.resume();
+      if (control.action === "mute" && typeof api.mute === "function") api.mute(control.muted);
+    } catch (e) { /* control is best-effort \u2014 never kills the game */ }
+  });
+  emit("loading"); // alive-signal: the host may have booted before us
+  setInterval(function () {
+    var api = window.__frogoe;
+    if (!api || typeof api.state !== "string") return;
+    emit(map(api.state));
+  }, 200);
+})();
+</script>`;
+  }
+});
+// src/embed/compose.ts
+var injectRelay, composePayload;
+var init_compose = __esm({
+  "src/embed/compose.ts"() {
+    "use strict";
+    init_relay();
+    injectRelay = (gameHtml, relayScript) => {
+      const at = gameHtml.lastIndexOf("</body>");
+      if (at === -1) {
+        return `${gameHtml}${relayScript}`;
+      }
+      return `${gameHtml.slice(0, at)}${relayScript}${gameHtml.slice(at)}`;
+    };
+    composePayload = (gameHtml) => {
+      const srcdoc = injectRelay(gameHtml, RELAY_SCRIPT);
+      return { payloadB64: Buffer.from(srcdoc, "utf-8").toString("base64"), srcdoc };
+    };
+  }
+});
+// src/manifest.ts
+import { createHash as createHash2 } from "crypto";
+import { existsSync as existsSync8, readFileSync as readFileSync9 } from "fs";
+import path13 from "path";
+var DESCRIPTION_CAP, descriptionFrom, buildManifest;
+var init_manifest = __esm({
+  "src/manifest.ts"() {
+    "use strict";
+    init_src();
+    DESCRIPTION_CAP = 280;
+    descriptionFrom = (source) => {
+      const split = source.split(/^---\r?\n[\s\S]*?\r?\n---/u);
+      const body = split[1] ?? split[0] ?? "";
+      for (const block of body.split(/\n\s*\n/u)) {
+        const text = block.replaceAll(/\s+/gu, " ").trim();
+        if (text.length > 0) {
+          return text.length > DESCRIPTION_CAP ? `${text.slice(0, DESCRIPTION_CAP - 1).trimEnd()}\u2026` : text;
+        }
+      }
+      return null;
+    };
+    buildManifest = (options) => {
+      const dir = path13.resolve(options.dir);
+      const briefSource = readFileSync9(path13.join(dir, "BRIEF.md"), "utf-8");
+      const brief = parseBrief(briefSource);
+      if (!brief?.title) return null;
+      const pin = existsSync8(path13.join(dir, "frogoe.json")) ? JSON.parse(readFileSync9(path13.join(dir, "frogoe.json"), "utf-8")).contract ?? "0.1.0" : "0.1.0";
+      const artifact = options.artifactHtml ?? readFileSync9(path13.join(dir, "dist", "index.html"), "utf-8");
+      const sha2562 = createHash2("sha256").update(artifact, "utf-8").digest("hex");
+      const mediaSha = (file) => {
+        const full = path13.join(dir, "dist", "assets", file);
+        return existsSync8(full) ? createHash2("sha256").update(readFileSync9(full)).digest("hex") : null;
+      };
+      return {
+        artifact: "index.html",
+        artifactSha256: sha2562,
+        contract: pin,
+        description: descriptionFrom(briefSource),
+        entry: "index.html",
+        fonts: brief.fonts ?? null,
+        icon: existsSync8(path13.join(dir, "dist", "assets", "icon.png")) ? "assets/icon.png" : null,
+        iconSha256: mediaSha("icon.png"),
+        mood: brief.mood ?? null,
+        palette: {
+          accent: brief.accent ?? "",
+          bg: brief.bg ?? "",
+          fg: brief.fg ?? "",
+          ...brief.outline ? { outline: brief.outline } : {}
+        },
+        poster: existsSync8(path13.join(dir, "dist", "assets", "poster.png")) ? "assets/poster.png" : null,
+        posterSha256: mediaSha("poster.png"),
+        title: brief.title,
+        verb: brief.verb ?? "tap"
+      };
+    };
+  }
+});
+// src/commands/embed.ts
+var embed_exports = {};
+__export(embed_exports, {
+  command: () => command4
+});
+import { existsSync as existsSync9, mkdirSync as mkdirSync7, readFileSync as readFileSync10, writeFileSync as writeFileSync5 } from "fs";
+import path14 from "path";
+import { defineCommand as defineCommand4 } from "citty";
+var dataUri2, command4;
+var init_embed = __esm({
+  "src/commands/embed.ts"() {
+    "use strict";
+    init_src();
+    init_card();
+    init_compose();
+    init_manifest();
+    dataUri2 = (file) => existsSync9(file) ? `data:image/png;base64,${readFileSync10(file).toString("base64")}` : null;
+    command4 = defineCommand4({
+      args: {
+        dir: { type: "positional", required: false, description: "game folder (default: cwd)" }
+      },
+      async run({ args }) {
+        const dir = args.dir ? String(args.dir) : process.cwd();
+        const artifactPath = path14.join(dir, "dist", "index.html");
+        if (!existsSync9(artifactPath)) {
+          throw new Error(
+            "frogoe embed: no dist/index.html \u2014 run `frogoe bundle` first (and `frogoe check` before it: check \u2192 bundle \u2192 embed)"
+          );
+        }
+        const staticResult = checkProject(dir);
+        if (staticResult.errors > 0) {
+          const first = staticResult.findings.find((f) => f.severity === "error");
+          throw new Error(
+            `frogoe embed: project is not gate-clean (${first?.code ?? "unknown"} at ${first?.file ?? "?"}) \u2014 run \`frogoe check\` first`
+          );
+        }
+        const manifest = buildManifest({ dir });
+        if (!manifest) {
+          throw new Error("frogoe embed: could not build the manifest from BRIEF.md");
+        }
+        const posterDataUri = dataUri2(path14.join(dir, "dist", "assets", "poster.png"));
+        const iconDataUri = dataUri2(path14.join(dir, "dist", "assets", "icon.png"));
+        const gameHtml = readFileSync10(artifactPath, "utf-8");
+        const { payloadB64 } = composePayload(gameHtml);
+        const html = composeEmbedHtml({ iconDataUri, manifest, payloadB64, posterDataUri });
+        mkdirSync7(path14.join(dir, "dist"), { recursive: true });
+        writeFileSync5(
+          path14.join(dir, "dist", "manifest.json"),
+          `${JSON.stringify(manifest, null, 2)}
+`,
+          "utf-8"
+        );
+        const outPath = path14.join(dir, "dist", "embed.html");
+        writeFileSync5(outPath, html, "utf-8");
+        console.log(`  frogoe embed \u2192 ${outPath}`);
+        console.log(
+          `  ${html.length.toLocaleString("en-US")} bytes \xB7 sandbox allow-scripts \xB7 sha256 ${manifest.artifactSha256.slice(0, 12)}`
+        );
+        console.log(
+          `  poster: ${manifest.poster ? "authored art (rasterized)" : "MISSING \u2014 run frogoe bundle"} \xB7 icon: ${manifest.icon ? "authored art (rasterized)" : "MISSING \u2014 run frogoe bundle"}`
+        );
+      },
+      meta: {
+        description: "wrap the bundle in a card (poster loading state + manifest)"
+      }
+    });
+  }
+});
+// src/art-eyes.ts
+var charFor, mapToChars, mapToPretty, compositionMetrics;
+var init_art_eyes = __esm({
+  "src/art-eyes.ts"() {
+    "use strict";
+    charFor = (r, g, b, palette) => {
+      const entries = [
+        [palette.bg ?? "", "."],
+        [palette.fg ?? "", "O"],
+        [palette.accent ?? "", "X"],
+        [palette.outline ?? "", "#"]
+      ];
+      let bestGlyph = "";
+      let bestDist = 90;
+      for (const [hex, glyph] of entries) {
+        if (hex.length !== 7) continue;
+        const pr = Number.parseInt(hex.slice(1, 3) ?? "0", 16);
+        const pg = Number.parseInt(hex.slice(3, 5) ?? "0", 16);
+        const pb = Number.parseInt(hex.slice(5, 7) ?? "0", 16);
+        const dist = Math.abs(r - pr) + Math.abs(g - pg) + Math.abs(b - pb);
+        if (dist < bestDist) {
+          bestDist = dist;
+          bestGlyph = glyph;
+        }
+      }
+      if (bestGlyph !== "") return bestGlyph;
+      const lum = (r * 299 + g * 587 + b * 114) / 1e3;
+      return "@%&*8=+~;:,-^`' "[Math.min(15, Math.max(0, Math.round(lum / 255 * 15)))] ?? " ";
+    };
+    mapToChars = (data, width, height, cols, rows, palette) => {
+      const lines = [];
+      for (let gy = 0; gy < rows; gy++) {
+        let line = "";
+        for (let gx = 0; gx < cols; gx++) {
+          const x0 = Math.floor(gx * width / cols);
+          const x1 = Math.max(x0 + 1, Math.floor((gx + 1) * width / cols));
+          const y0 = Math.floor(gy * height / rows);
+          const y1 = Math.max(y0 + 1, Math.floor((gy + 1) * height / rows));
+          let ar = 0;
+          let ag = 0;
+          let ab = 0;
+          let n = 0;
+          for (let y = y0; y < y1 && y < height; y++) {
+            for (let x = x0; x < x1 && x < width; x++) {
+              const at = (y * width + x) * 4;
+              ar += data[at] ?? 0;
+              ag += data[at + 1] ?? 0;
+              ab += data[at + 2] ?? 0;
+              n++;
+            }
+          }
+          line += charFor(Math.round(ar / n), Math.round(ag / n), Math.round(ab / n), palette);
+        }
+        lines.push(line);
+      }
+      return lines.join("\n");
+    };
+    mapToPretty = (data, width, height, cols, rows) => {
+      const lines = [];
+      for (let gy = 0; gy < rows; gy++) {
+        let line = "";
+        for (let gx = 0; gx < cols; gx++) {
+          const px = (fy) => {
+            const x = Math.min(width - 1, Math.floor((gx + 0.5) * width / cols));
+            const y = Math.min(height - 1, Math.floor((gy + fy) * height / rows));
+            const at = (y * width + x) * 4;
+            return [data[at] ?? 0, data[at + 1] ?? 0, data[at + 2] ?? 0];
+          };
+          const [tr, tg, tb] = px(0.25);
+          const [br, bg, bb] = px(0.75);
+          line += `\x1B[38;2;${String(tr)};${String(tg)};${String(tb)}m\x1B[48;2;${String(br)};${String(bg)};${String(bb)}m\u2580`;
+        }
+        lines.push(`${line}\x1B[0m`);
+      }
+      return lines.join("\n");
+    };
+    compositionMetrics = (data, width, height, rows, palette) => {
+      const hex = palette.bg ?? "#000000";
+      const pr = Number.parseInt(hex.slice(1, 3) ?? "0", 16);
+      const pg = Number.parseInt(hex.slice(3, 5) ?? "0", 16);
+      const pb = Number.parseInt(hex.slice(5, 7) ?? "0", 16);
+      let ink = 0;
+      let total = 0;
+      let deadRows = 0;
+      for (let gy = 0; gy < rows; gy++) {
+        let rowInk = 0;
+        let rowTotal = 0;
+        const y0 = Math.floor(gy * height / rows);
+        const y1 = Math.floor((gy + 1) * height / rows);
+        for (let y = y0; y < y1; y += 2) {
+          for (let x = 0; x < width; x += 2) {
+            const at = (y * width + x) * 4;
+            const isBg = Math.abs((data[at] ?? 0) - pr) + Math.abs((data[at + 1] ?? 0) - pg) + Math.abs((data[at + 2] ?? 0) - pb) < 60;
+            rowTotal++;
+            rowInk += isBg ? 0 : 1;
+          }
+        }
+        if (rowTotal > 0 && rowInk / rowTotal < 0.08) deadRows++;
+        ink += rowInk;
+        total += rowTotal;
+      }
+      return { coverage: total > 0 ? ink / total : 0, deadRows, rows };
+    };
+  }
+});
+// src/commands/vision.ts
+var vision_exports = {};
+__export(vision_exports, {
+  command: () => command5
+});
+import { existsSync as existsSync10, readFileSync as readFileSync11 } from "fs";
+import path15 from "path";
+import { defineCommand as defineCommand5 } from "citty";
+var HELPERS, PAGE_SCRIPT, show, metricLine, command5;
+var init_vision = __esm({
+  "src/commands/vision.ts"() {
+    "use strict";
+    init_src();
+    init_art_eyes();
+    init_art_verify();
+    init_browser();
+    HELPERS = [
+      luminance,
+      contrastRatio2,
+      charFor,
+      mapToChars,
+      mapToPretty,
+      compositionMetrics,
+      analyzeTitleBand,
+      analyzeIconCorners,
+      findTitleZoneCollision
+    ].map((fn) => `const ${fn.name} = ${String(fn)};`).join("\n");
+    PAGE_SCRIPT = (palette, cols = 96) => `(async () => {
+  ${HELPERS}
+  const PAL = ${JSON.stringify(palette)};
+  const map = (d, w, h, useCols) => {
+    const rows = Math.max(1, Math.round((useCols * (h / w)) / 2));
+    return {
+      cols: useCols, rows,
+      plain: mapToChars(d, w, h, useCols, rows, PAL),
+      pretty: mapToPretty(d, w, h, useCols, rows),
+      metrics: compositionMetrics(d, w, h, Math.max(4, Math.round(rows / 4)), PAL),
+    };
+  };
+  const grab = (canvas) => {
+    const ctx = canvas.getContext("2d", { willReadFrequently: true });
+    return { d: ctx.getImageData(0, 0, canvas.width, canvas.height).data, w: canvas.width, h: canvas.height };
+  };
+  const render = (w, h, draw) => {
+    const c = document.createElement("canvas");
+    c.width = w; c.height = h;
+    const ctx = c.getContext("2d", { willReadFrequently: true });
+    ctx.fillStyle = PAL.bg;
+    ctx.fillRect(0, 0, w, h);
+    draw(ctx, c);
+    return grab(c);
+  };
+  const out = { objects: null, gameplay: [], identity: {} };
+  // gameplay frames come from Node-side page.screenshot (full page:
+  // canvas + DOM HUD \u2014 the HUD is half the composition); this maps them
+  window.__frogoeMapShot = async (b64) => {
+    const img = new Image();
+    img.src = "data:image/png;base64," + b64;
+    await img.decode();
+    const c = document.createElement("canvas");
+    c.width = img.naturalWidth; c.height = img.naturalHeight;
+    const ctx = c.getContext("2d", { willReadFrequently: true });
+    ctx.drawImage(img, 0, 0);
+    const d = ctx.getImageData(0, 0, c.width, c.height).data;
+    return map(d, c.width, c.height, 96);
+  };
+  // \u2500\u2500 OBJECTS \u2014 every SPRITES entry, isolated on the palette ground \u2500
+  try {
+    const game = await import("./game.js");
+    if (game.SPRITES) {
+      out.objects = [];
+      for (const [name, sp] of Object.entries(game.SPRITES)) {
+        try {
+          const w = sp.w ?? 200, h = sp.h ?? 200;
+          const { d } = render(w, h, (ctx) => sp.draw(ctx));
+          out.objects.push({ name, ...map(d, w, h, ${String(Math.min(48, cols))}), error: null });
+        } catch (error) {
+          out.objects.push({ name, error: String(error) });
+        }
+      }
+    }
+  } catch (_) { /* game import issues surface in GAMEPLAY */ }
+  // \u2500\u2500 IDENTITY \u2014 the authored scenes + tier-2 verdicts \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  try {
+    const poster = await import("./assets/poster.js");
+    const { d, w, h } = render(540, 960, (ctx) => poster.drawPoster(ctx, 540, 960));
+    const titleReport = analyzeTitleBand(d, w, h);
+    let band = null;
+    try { band = ctx.__frogoeTitleBand ?? null; } catch (e) { band = null; }
+    out.identity.poster = {
+      ...map(d, w, h, ${String(cols)}),
+      titleReport,
+      titleCollision: findTitleZoneCollision(d, w, h, band),
+      titleBandDeclared: band !== null,
+    };
+  } catch (error) {
+    out.identity.poster = { error: String(error) };
+  }
+  try {
+    const icon = await import("./assets/icon.js");
+    const { d, w, h } = render(512, 512, (ctx) => icon.drawIcon(ctx, 512));
+    out.identity.icon = { ...map(d, w, h, 32), cornerReport: analyzeIconCorners(d, w, h) };
+  } catch (error) {
+    out.identity.icon = { error: String(error) };
+  }
+  return out;
+})()`;
+    show = (view, pretty) => pretty ? view.pretty : view.plain;
+    metricLine = (view) => `coverage ${(view.metrics.coverage * 100).toFixed(0)}% \xB7 dead-rows ${view.metrics.deadRows}/${view.metrics.rows}`;
+    command5 = defineCommand5({
+      args: {
+        dir: { type: "positional", required: false, description: "game folder (default: cwd)" },
+        pretty: { type: "boolean", description: "truecolor half-block maps (human eyes)" },
+        full: {
+          type: "boolean",
+          description: "all windows at full resolution (default: poster + gameplay, compact)"
+        },
+        poster: { type: "boolean", description: "poster map only" },
+        icon: { type: "boolean", description: "icon map only" },
+        gameplay: { type: "boolean", description: "gameplay frames only" },
+        objects: { type: "boolean", description: "SPRITES objects only" }
+      },
+      async run({ args }) {
+        const dir = path15.resolve(args.dir ? String(args.dir) : process.cwd());
+        const briefPath = path15.join(dir, "BRIEF.md");
+        if (!existsSync10(briefPath)) {
+          throw new Error(
+            "frogoe vision: no BRIEF.md in this folder \u2014 run this from a game (frogoe init)"
+          );
+        }
+        const brief = parseBrief(readFileSync11(briefPath, "utf-8"));
+        if (!brief) {
+          throw new Error("frogoe vision: BRIEF.md is present but unparsable \u2014 fill the frontmatter");
+        }
+        const palette = {
+          accent: brief.accent ?? "#ff3b3b",
+          bg: brief.bg ?? "#101418",
+          fg: brief.fg ?? "#ffffff",
+          ...brief.outline ? { outline: brief.outline } : {}
+        };
+        const pretty = args.pretty === true;
+        const wantAll = args.full === true;
+        const wantPoster = args.poster === true || wantAll;
+        const wantIcon = args.icon === true || wantAll;
+        const wantGameplay = args.gameplay === true || !args.poster && !args.icon && !args.objects || wantAll;
+        const wantObjects = args.objects === true || wantAll;
+        const targeted = args.poster === true || args.icon === true || args.gameplay === true || args.objects === true;
+        const compact = !wantAll;
+        const { startServer: startServer2 } = await Promise.resolve().then(() => (init_run(), run_exports));
+        const server = await startServer2(dir);
+        const { default: puppeteer } = await import("puppeteer-core");
+        const browser = await puppeteer.launch({
+          args: ["--no-sandbox", "--disable-gpu"],
+          defaultViewport: { height: 844, width: 390 },
+          executablePath: await ensureBrowser(),
+          headless: true
+        });
+        let report;
+        try {
+          const page = await browser.newPage();
+          await page.goto(server.urls.local, { timeout: 15e3, waitUntil: "domcontentloaded" });
+          await page.waitForFunction("window.__frogoe !== undefined", { timeout: 15e3 });
+          report = await page.evaluate(PAGE_SCRIPT(palette, compact ? 48 : 96));
+          const frame = async (label) => {
+            const b64 = await page.screenshot({ encoding: "base64", type: "png" });
+            const view = await page.evaluate(`__frogoeMapShot(${JSON.stringify(b64)})`);
+            report.gameplay.push({ label, ...view });
+          };
+          await new Promise((resolve2) => setTimeout(resolve2, 1200));
+          await frame("ready");
+          await page.evaluate(
+            '(() => { const cx = innerWidth / 2, cy = innerHeight / 2; for (const t of ["pointerdown", "pointerup"]) window.dispatchEvent(new PointerEvent(t, { clientX: cx, clientY: cy, bubbles: true })); })()'
+          );
+          await new Promise((resolve2) => setTimeout(resolve2, 800));
+          await frame("action");
+        } finally {
+          await browser.close();
+          server.stop();
+        }
+        const legend = `bg '${palette.bg}' \u2192 .   fg '${palette.fg}' \u2192 O   accent '${palette.accent}' \u2192 X${palette.outline ? `   outline '${palette.outline}' \u2192 #` : ""}   ramp @%&*8=+~;:,-^\`' (dark\u2192light)`;
+        console.log(`frogoe vision \u2014 ${dir}`);
+        console.log(`palette: ${legend}
+`);
+        if (wantObjects) {
+          console.log("\u2500\u2500 OBJECTS (SPRITES) " + "\u2500".repeat(28));
+          if (report.objects === null) {
+            console.log("  (none \u2014 export SPRITES from game.js to see each object)\n");
+          } else {
+            for (const obj of report.objects) {
+              if (obj.error !== null && obj.error !== void 0) {
+                console.log(`${obj.name}: ERROR ${obj.error.slice(0, 120)}`);
+                continue;
+              }
+              console.log(`${obj.name} (${obj.cols}\xD7${obj.rows} map) \u2014 ${metricLine(obj)}`);
+              console.log(show(obj, pretty));
+              console.log();
+            }
+          }
+        }
+        if (wantGameplay) {
+          console.log("\u2500\u2500 GAMEPLAY (full page: world + HUD) " + "\u2500".repeat(16));
+          for (const frame of report.gameplay) {
+            console.log(`${frame.label} \u2014 ${metricLine(frame)}`);
+            console.log(show(frame, pretty));
+            console.log();
+          }
+        }
+        if (wantPoster || wantIcon) {
+          console.log("\u2500\u2500 IDENTITY " + "\u2500".repeat(38));
+        }
+        if (wantPoster) {
+          const poster = report.identity.poster;
+          if (poster === void 0 || "error" in poster) {
+            console.log(
+              `poster: MISSING (${String(poster?.error ?? "assets/poster.js not found").slice(0, 90)})`
+            );
+          } else {
+            const verdict = verifyTitleReadability(poster.titleReport, 540);
+            const share = poster.titleReport.inkTotal > 0 ? poster.titleReport.inkCount / poster.titleReport.inkTotal : 0;
+            console.log(
+              `poster \u2014 ${metricLine(poster)} \xB7 title ${verdict === null ? "\u2713" : `\u2717 ${verdict.slice(0, 100)}`} \xB7 ink ${(share * 100).toFixed(1)}%`
+            );
+            console.log(show(poster, pretty));
+          }
+        }
+        if (wantIcon) {
+          const icon = report.identity.icon;
+          if (icon === void 0 || "error" in icon) {
+            console.log(
+              `icon: MISSING (${String(icon?.error ?? "assets/icon.js not found").slice(0, 90)})`
+            );
+          } else {
+            const hexes = [palette.bg, palette.fg, palette.accent, palette.outline ?? palette.bg];
+            const verdict = verifyIconFullbleed(icon.cornerReport, hexes);
+            console.log(
+              `icon \u2014 ${metricLine(icon)} \xB7 fullbleed ${verdict === null ? "\u2713" : `\u2717 ${verdict.slice(0, 100)}`}`
+            );
+            console.log(show(icon, pretty));
+          }
+        }
+        if (!targeted && !existsSync10(path15.join(dir, "assets", "poster.js"))) {
+          console.log("\n(note: run `frogoe check` first \u2014 vision only looks, it never gates)");
+        }
+      },
+      meta: {
+        description: "eyes for draw code: objects, gameplay frames, and identity art as ASCII maps"
+      }
+    });
+  }
+});
 // src/commands/init.ts
 var init_exports = {};
 __export(init_exports, {
-  command: () => command4
+  command: () => command6
 });
-import { defineCommand as defineCommand4 } from "citty";
-var command4;
+import { defineCommand as defineCommand6 } from "citty";
+var command6;
 var init_init2 = __esm({
   "src/commands/init.ts"() {
     "use strict";
     init_init();
-    command4 = defineCommand4({
+    command6 = defineCommand6({
       args: {
         force: { type: "boolean", description: "rematerialize over an existing game" },
         name: { type: "positional", description: "folder to create" }
@@ -2668,15 +4146,15 @@ var init_init2 = __esm({
 // src/commands/lint.ts
 var lint_exports = {};
 __export(lint_exports, {
-  command: () => command5
+  command: () => command7
 });
-import { defineCommand as defineCommand5 } from "citty";
-var command5;
+import { defineCommand as defineCommand7 } from "citty";
+var command7;
 var init_lint = __esm({
   "src/commands/lint.ts"() {
     "use strict";
     init_check2();
-    command5 = defineCommand5({
+    command7 = defineCommand7({
       args: {
         dir: { type: "positional", required: false, description: "game folder (default: cwd)" },
         json: { type: "boolean", description: "machine-readable findings" }
@@ -2703,17 +4181,17 @@ var init_lint = __esm({
 // src/commands/report.ts
 var report_exports = {};
 __export(report_exports, {
-  command: () => command6
+  command: () => command8
 });
-import { readFileSync as readFileSync6 } from "fs";
-import { defineCommand as defineCommand6 } from "citty";
-var command6;
+import { readFileSync as readFileSync12 } from "fs";
+import { defineCommand as defineCommand8 } from "citty";
+var command8;
 var init_report = __esm({
   "src/commands/report.ts"() {
     "use strict";
     init_records();
     init_session();
-    command6 = defineCommand6({
+    command8 = defineCommand8({
       args: {
         dir: { type: "positional", required: false, description: "game folder (default: cwd)" }
       },
@@ -2724,7 +4202,7 @@ var init_report = __esm({
           console.log(`frogoe report: no sessions in ${dir} \u2014 play a run under \`frogoe run\` first`);
           return;
         }
-        const records = readFileSync6(file, "utf-8").split("\n").filter((line) => line.trim().length > 0).map((line) => JSON.parse(line));
+        const records = readFileSync12(file, "utf-8").split("\n").filter((line) => line.trim().length > 0).map((line) => JSON.parse(line));
         const s = summarizeRecords(records);
         console.log(`
   frogoe report \u2014 ${file}`);
@@ -2762,8 +4240,8 @@ var init_firewall = __esm({
         return null;
       }
     };
-    binaryBlocked = (path10) => {
-      const out = run(`--getappblocked "${path10}"`);
+    binaryBlocked = (path17) => {
+      const out = run(`--getappblocked "${path17}"`);
       if (out === null) return null;
       if (/blocked/iu.test(out)) return true;
       if (/allowed/iu.test(out)) return false;
@@ -2821,9 +4299,9 @@ var init_plan = __esm({
 // src/net/tunnel.ts
 import { spawn, spawnSync } from "child_process";
-import { existsSync as existsSync6, mkdirSync as mkdirSync6, chmodSync, writeFileSync as writeFileSync5 } from "fs";
+import { existsSync as existsSync11, mkdirSync as mkdirSync8, chmodSync, writeFileSync as writeFileSync6 } from "fs";
 import os3 from "os";
-import path9 from "path";
+import path16 from "path";
 import { gunzipSync } from "zlib";
 var URL_PATTERN, parseTunnelUrl, TAG_PATTERN, assertSafeTag, octalAt, extractSingleFile, ENV_PIN, assetName, binaryFileName, cacheBase, resolveLatestTag, mb, downloadWithProgress, binaryEchoes, resolveBinary, startTunnel;
 var init_tunnel = __esm({
@@ -2880,9 +4358,9 @@ var init_tunnel = __esm({
     };
     binaryFileName = (platform) => platform === "win32" ? "cloudflared.exe" : "cloudflared";
     cacheBase = (platform, env, home) => {
-      if (platform === "darwin") return path9.join(home, "Library", "Caches");
-      if (platform === "win32") return env.LOCALAPPDATA ?? path9.join(home, "AppData", "Local");
-      return path9.join(home, ".cache");
+      if (platform === "darwin") return path16.join(home, "Library", "Caches");
+      if (platform === "win32") return env.LOCALAPPDATA ?? path16.join(home, "AppData", "Local");
+      return path16.join(home, ".cache");
     };
     resolveLatestTag = async () => {
       const res = await fetch("https://api.github.com/repos/cloudflare/cloudflared/releases/latest", {
@@ -2933,15 +4411,15 @@ var init_tunnel = __esm({
         );
       }
       const tag = process.env[ENV_PIN] ? assertSafeTag(process.env[ENV_PIN]) : assertSafeTag(await resolveLatestTag());
-      const root = path9.join(cacheBase(platform, process.env, os3.homedir()), "frogoe", "cloudflared");
-      const dir = path9.join(root, tag);
-      const bin = path9.join(dir, binaryFileName(platform));
-      const rootResolved = path9.resolve(root);
-      const binResolved = path9.resolve(bin);
-      if (!binResolved.startsWith(rootResolved + path9.sep)) {
+      const root = path16.join(cacheBase(platform, process.env, os3.homedir()), "frogoe", "cloudflared");
+      const dir = path16.join(root, tag);
+      const bin = path16.join(dir, binaryFileName(platform));
+      const rootResolved = path16.resolve(root);
+      const binResolved = path16.resolve(bin);
+      if (!binResolved.startsWith(rootResolved + path16.sep)) {
         throw new Error("cloudflared binary path escaped the frogoe cache \u2014 refusing to execute");
       }
-      if (existsSync6(bin) && binaryEchoes(bin, tag)) return { downloaded: false, path: bin };
+      if (existsSync11(bin) && binaryEchoes(bin, tag)) return { downloaded: false, path: bin };
       onProgress?.(`downloading cloudflared ${tag} (~25 MB, once)\u2026`);
       const res = await fetch(
         `https://github.com/cloudflare/cloudflared/releases/download/${tag}/${asset}`
@@ -2952,8 +4430,8 @@ var init_tunnel = __esm({
       });
       const binary = asset.endsWith(".tgz") ? extractSingleFile(gunzipSync(raw), "cloudflared") : raw;
       if (!binary) throw new Error("cloudflared archive did not contain the binary");
-      mkdirSync6(dir, { recursive: true });
-      writeFileSync5(bin, binary);
+      mkdirSync8(dir, { recursive: true });
+      writeFileSync6(bin, binary);
       if (platform !== "win32") chmodSync(bin, 493);
       if (!binaryEchoes(bin, tag)) {
         throw new Error(
@@ -3040,10 +4518,10 @@ var init_tunnel = __esm({
 // src/commands/run.ts
 var run_exports2 = {};
 __export(run_exports2, {
-  command: () => command7
+  command: () => command9
 });
-import { defineCommand as defineCommand7 } from "citty";
-var NUDGE_MS, printQr, message, command7;
+import { defineCommand as defineCommand9 } from "citty";
+var NUDGE_MS, printQr, message, command9;
 var init_run2 = __esm({
   "src/commands/run.ts"() {
     "use strict";
@@ -3054,6 +4532,7 @@ var init_run2 = __esm({
     init_run();
     NUDGE_MS = 1e4;
     printQr = (url) => {
+      if (!process.stdout.isTTY) return;
       void import("qrcode-terminal").then((mod) => {
         const qrcode = mod.default ?? mod;
         qrcode.generate(url, { small: true }, (qr) => console.log(qr));
@@ -3062,7 +4541,7 @@ var init_run2 = __esm({
       });
     };
     message = (error) => error instanceof Error ? error.message : String(error);
-    command7 = defineCommand7({
+    command9 = defineCommand9({
       args: {
         dir: { type: "positional", required: false, description: "game folder (default: cwd)" },
         port: { type: "string", description: "port (default: random free)" },
@@ -3164,8 +4643,8 @@ var init_run2 = __esm({
 // src/utils/skillsManifest.ts
 import { execFile } from "child_process";
-import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync7, readdirSync as readdirSync3, readFileSync as readFileSync7, statSync as statSync2 } from "fs";
+import { createHash as createHash3 } from "crypto";
+import { existsSync as existsSync12, readdirSync as readdirSync3, readFileSync as readFileSync13, statSync as statSync3 } from "fs";
 import { homedir } from "os";
 import { isAbsolute, join, relative, resolve, sep } from "path";
 import { promisify } from "util";
@@ -3178,7 +4657,7 @@ function listFilesSorted(dir) {
     for (const name of readdirSync3(d)) {
       if (name === ".DS_Store") continue;
       const p = join(d, name);
-      if (statSync2(p).isDirectory()) walk(p);
+      if (statSync3(p).isDirectory()) walk(p);
       else out.push(p);
     }
   };
@@ -3187,21 +4666,21 @@ function listFilesSorted(dir) {
 }
 function hashSkillBundle(skillDir) {
   const files = listFilesSorted(skillDir);
-  const h = createHash2("sha256");
+  const h = createHash3("sha256");
   for (const f of files) {
     const rel = relative(skillDir, f).split(sep).join("/");
     h.update(rel);
     h.update("\0");
     const ext = rel.slice(rel.lastIndexOf("."));
-    const buf = readFileSync7(f);
+    const buf = readFileSync13(f);
     if (TEXT_EXT.has(ext)) h.update(buf.toString("utf8").replace(/\r\n/g, "\n"), "utf8");
     else h.update(buf);
     h.update("\0");
   }
   return { hash: h.digest("hex").slice(0, 16), files: files.length };
 }
-function buildManifest(skillsRoot, meta) {
-  const names = readdirSync3(skillsRoot).filter((n) => existsSync7(join(skillsRoot, n, "SKILL.md"))).sort();
+function buildManifest2(skillsRoot, meta) {
+  const names = readdirSync3(skillsRoot).filter((n) => existsSync12(join(skillsRoot, n, "SKILL.md"))).sort();
   const skills = {};
   for (const name of names) skills[name] = hashSkillBundle(join(skillsRoot, name));
   return { source: meta.source, skills };
@@ -3226,7 +4705,7 @@ function discoverSkillRoots(base, scope) {
   const candidates = [];
   const add = (hostBase, host) => {
     const dir = join(hostBase, host, "skills");
-    if (existsSync7(dir) && statSync2(dir).isDirectory())
+    if (existsSync12(dir) && statSync3(dir).isDirectory())
       candidates.push({ dir, agent: agentLabel(host), scope });
   };
   for (const host of listSubdirs(base)) add(base, host);
@@ -3253,7 +4732,7 @@ function scopeForDir(dir, home, cwd) {
 }
 function locateInstall(skillNames, opts = {}) {
   if (opts.dir) {
-    return existsSync7(opts.dir) ? {
+    return existsSync12(opts.dir) ? {
       dir: opts.dir,
       agent: agentFromDir(opts.dir),
       scope: scopeForDir(opts.dir, opts.home ?? homedir(), opts.cwd ?? process.cwd())
@@ -3264,7 +4743,7 @@ function locateInstall(skillNames, opts = {}) {
     ...discoverSkillRoots(opts.cwd ?? process.cwd(), "project")
   ];
   for (const root of roots) {
-    if (skillNames.some((n) => existsSync7(join(root.dir, n, "SKILL.md")))) return root;
+    if (skillNames.some((n) => existsSync12(join(root.dir, n, "SKILL.md")))) return root;
   }
   return null;
 }
@@ -3272,7 +4751,7 @@ function hashInstalled(root, skillNames) {
   const out = {};
   for (const name of skillNames) {
     const skillDir = join(root.dir, name);
-    if (existsSync7(join(skillDir, "SKILL.md"))) out[name] = hashSkillBundle(skillDir);
+    if (existsSync12(join(skillDir, "SKILL.md"))) out[name] = hashSkillBundle(skillDir);
   }
   return out;
 }
@@ -3309,7 +4788,7 @@ function findRepoManifest(cwd = process.cwd()) {
   let dir = cwd;
   for (let i = 0; i < 16; i++) {
     const p = join(dir, MANIFEST_FILE);
-    if (existsSync7(p)) return p;
+    if (existsSync12(p)) return p;
     const parent = join(dir, "..");
     if (parent === dir) break;
     dir = parent;
@@ -3349,9 +4828,9 @@ async function remoteHeadSha(repoSlug) {
 }
 function resolveLocalManifest(source) {
   const direct = source.endsWith(".json") ? source : join(source, MANIFEST_FILE);
-  if (existsSync7(direct)) return JSON.parse(readFileSync7(direct, "utf8"));
+  if (existsSync12(direct)) return JSON.parse(readFileSync13(direct, "utf8"));
   const skillsRoot = source.endsWith("skills") ? source : join(source, "skills");
-  if (existsSync7(skillsRoot)) return buildManifest(skillsRoot, { source: skillsRoot });
+  if (existsSync12(skillsRoot)) return buildManifest2(skillsRoot, { source: skillsRoot });
   throw new Error(`No skills manifest found at: ${source}`);
 }
 async function fetchRemoteManifest(source) {
@@ -3374,7 +4853,7 @@ async function resolveLatestManifest(source, cwd = process.cwd(), opts = {}) {
   }
   if (!source && !opts.canonical) {
     const repoManifest = findRepoManifest(cwd);
-    if (repoManifest) return JSON.parse(readFileSync7(repoManifest, "utf8"));
+    if (repoManifest) return JSON.parse(readFileSync13(repoManifest, "utf8"));
   }
   return fetchRemoteManifest(source);
 }
@@ -3425,9 +4904,9 @@ var init_skillsManifest = __esm({
 // src/commands/skills.ts
 var skills_exports = {};
 __export(skills_exports, {
-  command: () => command8
+  command: () => command10
 });
-import { defineCommand as defineCommand8 } from "citty";
+import { defineCommand as defineCommand10 } from "citty";
 import { execFileSync, spawn as spawn2 } from "child_process";
 function hasNpx() {
   try {
@@ -3519,7 +4998,7 @@ function renderCheck(result) {
   }
   console.log();
 }
-var GLOBAL_INSTALL_ARGS_TAIL, SOURCE_URL, checkCommand, updateCommand, command8;
+var GLOBAL_INSTALL_ARGS_TAIL, SOURCE_URL, checkCommand, updateCommand, command10;
 var init_skills = __esm({
   "src/commands/skills.ts"() {
     "use strict";
@@ -3534,7 +5013,7 @@ var init_skills = __esm({
       "--yes"
     ];
     SOURCE_URL = "https://github.com/frogoe/engine";
-    checkCommand = defineCommand8({
+    checkCommand = defineCommand10({
       meta: { name: "check", description: "Check whether installed skills are the latest version" },
       args: {
         json: { type: "boolean", description: "Output as JSON", default: false },
@@ -3566,7 +5045,7 @@ var init_skills = __esm({
         }
       }
     });
-    updateCommand = defineCommand8({
+    updateCommand = defineCommand10({
       meta: {
         name: "update",
         description: "Update frogoe skills to the latest (core + installed). Pass names to also install them."
@@ -3613,7 +5092,7 @@ var init_skills = __esm({
         }
       }
     });
-    command8 = defineCommand8({
+    command10 = defineCommand10({
       meta: {
         name: "skills",
         description: "Install, check, and update frogoe skills for AI coding tools"
@@ -3636,12 +5115,12 @@ var init_skills = __esm({
 });
 // src/cli.ts
-import { defineCommand as defineCommand9, runMain } from "citty";
+import { defineCommand as defineCommand11, runMain } from "citty";
 // package.json
 var package_default = {
   name: "frogoe",
-  version: "0.3.2",
+  version: "0.5.5",
   description: "froge CLI \u2014 the agent's hands: init, add, run, check, bundle",
   homepage: "https://github.com/frogoe/engine#readme",
   bugs: "https://github.com/frogoe/engine/issues",
@@ -3704,6 +5183,16 @@ if (process.argv.includes("--version") || process.argv.includes("-v")) {
   console.log(VERSION);
   process.exit(0);
 }
+if (process.argv.includes("--source")) {
+  console.log("# frogoe CLI source of truth");
+  console.log("# repo:   https://github.com/frogoe/engine");
+  console.log("# cli:    packages/cli/src/");
+  console.log("# skills: skills/");
+  console.log("# Never read the installed dist/ \u2014 it is bundled/minified.");
+  console.log("# Clone the repo to read the readable source:");
+  console.log("#   git clone https://github.com/frogoe/engine");
+  process.exit(0);
+}
 var HELP = `frogoe ${VERSION} \u2014 write a closure, ship a game
 Commands:
@@ -3712,17 +5201,90 @@ Commands:
   run [dir]                serve with live reload + phone QR (--tunnel: any network)
   lint [dir]               static contract lint \u2014 fast iteration (stable codes; --json)
   check [dir]              full gate: lint + live Chrome sandbox (FPS, HUD outline)
+                           --fast: static only, no Chrome (quick iteration)
   report [dir]             last playtest session: fps dips, errors, when
   bundle [dir]             dissolve externals \u2192 one self-contained HTML
+  embed [dir]              wrap the bundle in a card (poster + manifest)
+  vision [dir]             see the game: objects, frames, art as ASCII maps
+                           --poster/--icon/--gameplay/--objects: one window only
+                           --full: all windows (default is poster + gameplay)
   skills [check|update]    skill freshness \u2014 check or update via npx skills add
 Docs: skills/frogoe-core \u2014 the whole contract in five references.`;
-var main = defineCommand9({
+var TEACHING_ERROR_PATTERNS = [
+  /^frogoe /u,
+  // "frogoe add: unknown block..."
+  /^bundle\//u,
+  // "bundle/art-missing — ..."
+  /^art-/u,
+  // "art-crash — ..."
+  /— run /u,
+  // "— run `frogoe check` first"
+  /— see /u,
+  // "— see frogoe-creative → references/art.md"
+  /Available: /u,
+  // "Available: score-card, fuel-gauge, ..."
+  /fix: /u,
+  // lint findings carry fix:
+  /recipe: /u
+  // lint findings carry recipe:
+];
+var isTeachingError = (message2) => TEACHING_ERROR_PATTERNS.some((pattern) => pattern.test(message2));
+var ORIGINAL_CONSOLE_ERROR = console.error;
+console.error = (...args) => {
+  const first = args[0];
+  if (first instanceof Error && process.env.FROGOE_DEBUG !== "1") {
+    const msg = first.message;
+    if (isTeachingError(msg)) {
+      ORIGINAL_CONSOLE_ERROR(`
+  ${msg}
+`);
+      ORIGINAL_CONSOLE_ERROR(
+        `  (self-resolving: apply the fix above. This CLI is open-source \u2014
+   readable code at packages/cli/src/, never read dist/.)
+`
+      );
+      return;
+    }
+  }
+  ORIGINAL_CONSOLE_ERROR(...args);
+};
+var KNOWN_FLAGS = /* @__PURE__ */ new Set([
+  "--json",
+  "--fast",
+  "--force",
+  "--out",
+  "--tunnel",
+  "--port",
+  "--pretty",
+  "--full",
+  "--poster",
+  "--icon",
+  "--gameplay",
+  "--objects",
+  "--check",
+  "--update",
+  "--verbose"
+]);
+var UNKNOWN_FLAG = /^--[a-z][a-z0-9-]*$/u;
+var unknownFlags = process.argv.filter(
+  (arg) => UNKNOWN_FLAG.test(arg) && !KNOWN_FLAGS.has(arg) && arg !== "--version" && arg !== "-v" && arg !== "--help" && arg !== "-h"
+);
+if (unknownFlags.length > 0 && process.env.FROGOE_DEBUG !== "1") {
+  ORIGINAL_CONSOLE_ERROR(`
+  frogoe: unknown flag ${unknownFlags[0]} \u2014 did you mean --json?`);
+  ORIGINAL_CONSOLE_ERROR(`  (this fails loudly so a typo can't silently produce wrong output.)
+`);
+  process.exit(1);
+}
+var main = defineCommand11({
   meta: { description: HELP },
   subCommands: {
     add: () => Promise.resolve().then(() => (init_add2(), add_exports)).then((m) => m.command),
     bundle: () => Promise.resolve().then(() => (init_bundle2(), bundle_exports)).then((m) => m.command),
     check: () => Promise.resolve().then(() => (init_check3(), check_exports)).then((m) => m.command),
+    embed: () => Promise.resolve().then(() => (init_embed(), embed_exports)).then((m) => m.command),
+    vision: () => Promise.resolve().then(() => (init_vision(), vision_exports)).then((m) => m.command),
     init: () => Promise.resolve().then(() => (init_init2(), init_exports)).then((m) => m.command),
     lint: () => Promise.resolve().then(() => (init_lint(), lint_exports)).then((m) => m.command),
     report: () => Promise.resolve().then(() => (init_report(), report_exports)).then((m) => m.command),