frogoe 0.3.1 → 0.5.5

package/dist/cli.js

@@ -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();
@@ -119,13 +141,18 @@ node_modules/
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
-var here, CONTRACT_SOURCE, scaffold, registryRoot;
+var here, contractSourceFor, CONTRACT_SOURCE, scaffold, registryRootFor, registryRoot;
 var init_init = __esm({
   "src/init.ts"() {
     "use strict";
     init_templates();
     here = path.dirname(fileURLToPath(import.meta.url));
-    CONTRACT_SOURCE = existsSync(path.join(here, "../../contract/src/contract.js")) ? path.join(here, "../../contract/src/contract.js") : path.join(here, "../contract/contract.js");
+    contractSourceFor = (base) => {
+      const repo = path.join(base, "../../contract/src/contract.js");
+      if (existsSync(repo)) return repo;
+      return path.join(base, "contract/contract.js");
+    };
+    CONTRACT_SOURCE = contractSourceFor(here);
     scaffold = (name, options) => {
       const root = options?.dir ?? process.cwd();
       const target = path.resolve(root, name);
@@ -161,12 +188,12 @@ var init_init = __esm({
       }
       return { dir: target, files: files.map(([rel]) => rel) };
     };
-    registryRoot = () => {
+    registryRootFor = (base) => {
       const candidates = [
-        path.resolve(here, "../../../registry"),
+        path.resolve(base, "../../../registry"),
         // repo source mode
-        path.resolve(here, "../registry")
-        // dist mode (build:copy)
+        path.resolve(base, "registry")
+        // dist mode: beside the bundle
       ];
       for (const candidate of candidates) {
         if (existsSync(path.join(candidate, "registry.json"))) {
@@ -174,9 +201,10 @@ var init_init = __esm({
         }
       }
       throw new Error(
-        "frogoe: registry not found (expected ../registry or packaged copy). Run from the repo or install @frogoe/cli fully."
+        "frogoe: registry not found (expected the repo registry or the packaged copy beside the CLI). Run from the repo or reinstall frogoe."
       );
     };
+    registryRoot = () => registryRootFor(here);
   }
 });
 
@@ -192,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) => {
@@ -526,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 } });
@@ -664,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({
@@ -780,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({
@@ -806,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({
@@ -814,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 "";
       }
@@ -829,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",
@@ -1062,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));
@@ -1086,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",
@@ -1123,6 +1281,7 @@ var init_check = __esm({
     };
     checkProject = (dir) => {
       const findings = [];
+      checkArt(dir, findings);
       checkBrief(dir, findings);
       checkFolder(dir, findings);
       checkPin(dir, findings);
@@ -1140,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"
-      });
-    };
-    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"
-      });
+      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;
     };
-    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();
+    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 mismatch = finishEventFinding(true, events.length);
-      if (mismatch) {
-        findings.push(mismatch);
+      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;
       }
-      const presence = await driver.retryPresence();
-      if (!presence.gameover) {
-        findings.push(noGameoverCardFinding());
-      }
-      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
       };
     };
   }
@@ -2449,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 {
@@ -2486,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 = [];
@@ -2500,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({
@@ -2521,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,
@@ -2588,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"
@@ -2599,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));
@@ -2628,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" }
@@ -2662,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" }
@@ -2697,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)" }
       },
@@ -2718,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}`);
@@ -2756,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;
@@ -2815,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({
@@ -2874,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", {
@@ -2927,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}`
@@ -2946,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(
@@ -3034,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";
@@ -3048,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));
@@ -3056,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)" },
@@ -3158,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";
@@ -3172,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);
     }
   };
@@ -3181,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 };
@@ -3220,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);
@@ -3247,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())
@@ -3258,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;
 }
@@ -3266,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;
 }
@@ -3303,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;
@@ -3343,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) {
@@ -3368,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);
 }
@@ -3419,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 {
@@ -3513,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";
@@ -3528,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 },
@@ -3560,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."
@@ -3607,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"
@@ -3630,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.1",
+  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",
@@ -3698,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:
@@ -3706,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),