@genex-ai/cli-demo 1.2.4-dev.363 → 1.3.0-dev.372

package/dist/index.js

@@ -991,7 +991,7 @@ var CONTRACT_END = "<!-- genex:contract:end -->";
 var GENEX_CONTRACT_BLOCK = `${CONTRACT_BEGIN}
 # Genex build contract (always in effect for this game)
 
-Your capabilities (all via \`npx genex \u2026\`): generate \`model\` \xB7 \`skybox\` \xB7 \`sfx\` \xB7 \`music\` \xB7 \`voice\` \xB7 \`texture\` \xB7 \`image\` (\`--edit\` \xB7 \`--inpaint\` \xB7 \`--glass\` \xB7 \`--clean\` \xB7 \`--upscale\`) \xB7 \`video\` \xB7 rigged \`character\` / \`creature\` \xB7 \`character animate <id> "<verb>"\` (also \`creature animate\`; \`--locomotion\` for the 8-way movement set, \`--video\` for your own footage) \xB7 the pixel toolbox \`ui extract|masks|plate|text-color|trim|audit\` \xB7 vendored \`controller character|car|drone|touch|quality\` \xB7 \`animations search\` \xB7 \`wait <id>\` / \`wait --all\` \xB7 \`preview\` / \`publish\`. Full options: \`npx genex --help\`. Task\u2192lane routing lives in the \`genex-game-director\` skill's routing map \u2014 re-load it whenever you're unsure which lane owns a task.
+Your capabilities (all via \`npx genex \u2026\`): generate \`model\` \xB7 \`skybox\` \xB7 \`sfx\` \xB7 \`music\` \xB7 \`voice\` \xB7 \`texture\` \xB7 \`image\` (\`--edit\` \xB7 \`--inpaint\` \xB7 \`--glass\` \xB7 \`--clean\` \xB7 \`--upscale\`) \xB7 \`video\` \xB7 rigged \`character\` / \`creature\` \xB7 \`character animate <id> "<verb>"\` (also \`creature animate\`; \`--locomotion\` for the 8-way movement set, \`--video\` for your own footage) \xB7 the pixel toolbox \`ui extract|masks|plate|text-color|trim|audit\` \xB7 vendored \`controller character|car|drone|touch|quality|chat\` \xB7 \`animations search\` \xB7 \`wait <id>\` / \`wait --all\` \xB7 \`preview\` / \`publish\` \xB7 \`rename <name>\` (move the game to a new address \u2014 keeps its plays and likes, kills the old link, needs \`--yes\` once published, and the game must be rebuilt after). Full options: \`npx genex --help\`. Task\u2192lane routing lives in the \`genex-game-director\` skill's routing map \u2014 re-load it whenever you're unsure which lane owns a task.
 
 1. Load the \`genex-game-director\` skill before starting the requested work. Route from the player's latest clear request: a focused request starts directly without replaying discovery or commissioning unrelated lanes. After ANY context compaction or session resume, re-read this file and \`DESIGN.md\`, re-load the skill for the stage you are executing, and continue from the Build plan's \`Now:\` line \u2014 never from memory alone.
 2. Ask only when one unresolved answer materially changes the work. If the request is clear, do not repeat an interview, confirm the pitch, force a concept round, or ask whole-game-vs-one-part again. For a genuinely broad new game, ask one decision: whole coordinated build or one request-relevant part first. If there is no clear request \u2014 a setup prompt pasted with nothing of their own \u2014 ask in PLAIN CHAT what they want to make, in their own words, and never fill the blank by pitching concepts. That opening question stays in chat on purpose: their reply carries the whole request, including anything they say about HOW you should work, and a menu of options answers a narrower question than the one they need to answer. Once you know what you are building, ask one decision at a time with your built-in question tool with clickable answer options when you have one; use a short plain-chat question otherwise. If the player stays silent after a necessary question, proceed on stated assumptions where reasonable and record each as "assumed \u2014 player didn't answer" in DESIGN.md \u2192 Decisions.
@@ -1891,6 +1891,124 @@ async function listOwnSlugs(apiUrl, token, log) {
   }
 }
 
+// src/commands/rename.ts
+import fs12 from "fs/promises";
+import path12 from "path";
+async function runRename(opts) {
+  const log = createLogger({ quiet: opts.quiet });
+  log.plain(c.bold("genex rename"));
+  log.plain("");
+  const name = opts.name?.trim();
+  if (!name) {
+    log.error("Rename it to what? Usage: genex rename <name>");
+    process.exitCode = 1;
+    return;
+  }
+  const meta = await readProject();
+  if (!meta) {
+    log.error("No genex project here. Run `genex init` in this directory first.");
+    process.exitCode = 1;
+    return;
+  }
+  const token = await readUserToken(opts.envPath);
+  if (!token) {
+    log.error("Not signed in. Run `genex auth` first.");
+    process.exitCode = 1;
+    return;
+  }
+  const apiUrl = getApiUrl(opts.apiUrl ?? meta.apiUrl);
+  const from = meta.slug;
+  if (meta.status === "published" && !opts.yes) {
+    log.warn(`This retires ${c.cyan(`https://${from}.genex.technology/`)} \u2014 links already shared to it will stop working.`);
+    log.dim("  Plays, likes, and comments move with the game. Re-run with --yes to go ahead.");
+    process.exitCode = 1;
+    return;
+  }
+  log.step(`Renaming ${c.cyan(from)}\u2026`);
+  let res;
+  try {
+    res = await apiFetch(`${apiUrl}/api/projects/${meta.id}/rename`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+      body: JSON.stringify({ name })
+    });
+  } catch (err) {
+    log.error(`Couldn't reach the API at ${apiUrl}.`);
+    log.dim(`  ${String(err)}`);
+    process.exitCode = 1;
+    return;
+  }
+  if (res.status === 409) {
+    log.error("That name is taken \u2014 every game needs its own address. Try another.");
+    process.exitCode = 1;
+    return;
+  }
+  if (res.status === 404) {
+    log.error("That project isn't yours (or no longer exists).");
+    process.exitCode = 1;
+    return;
+  }
+  if (!res.ok) {
+    log.error(`Rename failed (HTTP ${res.status}). Your game is untouched at ${c.cyan(from)}.`);
+    process.exitCode = 1;
+    return;
+  }
+  const data = await res.json().catch(() => null);
+  const project = data?.project;
+  if (!project) {
+    log.error("Unexpected API response \u2014 rename may not have applied. Check `genex list`.");
+    process.exitCode = 1;
+    return;
+  }
+  await writeProject({
+    ...meta,
+    slug: project.slug,
+    cloneUrl: project.cloneUrl ?? meta.cloneUrl,
+    playUrl: project.playUrl ?? meta.playUrl
+  });
+  await rewriteSlugEnv(from, project.slug, log);
+  await rewriteBakedSlug(from, project.slug, log);
+  log.plain("");
+  log.success(`Renamed to ${c.cyan(project.slug)}.`);
+  if (project.playUrl) log.dim(`  play: ${project.playUrl}`);
+  if (meta.status === "published") {
+    const dashboard = meta.dashboardOrigins?.[0];
+    if (dashboard) log.dim(`  world page: ${dashboard}/world/${project.slug}`);
+  }
+  log.plain("");
+  log.info("Run `genex preview` (or `publish`) to rebuild \u2014 the new slug is baked into the bundle.");
+}
+async function rewriteSlugEnv(from, to, log, cwd = process.cwd()) {
+  const file = path12.join(cwd, ".env");
+  let content;
+  try {
+    content = await fs12.readFile(file, "utf8");
+  } catch {
+    return;
+  }
+  const re = /^(\s*VITE_GENEX_SLUG=)(.*)$/m;
+  if (!re.test(content)) return;
+  await fs12.writeFile(file, content.replace(re, `$1${to}`));
+  log.dim(`  .env: VITE_GENEX_SLUG=${to} (was ${from})`);
+}
+async function rewriteBakedSlug(from, to, log, cwd = process.cwd()) {
+  const file = path12.join(cwd, "src", "genex.config.ts");
+  let content;
+  try {
+    content = await fs12.readFile(file, "utf8");
+  } catch {
+    return;
+  }
+  const quoted = new RegExp(`(["'])${from.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\1`, "g");
+  const hits = content.match(quoted)?.length ?? 0;
+  if (hits === 0) {
+    log.warn(`  src/genex.config.ts has no "${from}" literal \u2014 check its slug by hand.`);
+    return;
+  }
+  await fs12.writeFile(file, content.replace(quoted, `"${to}"`));
+  log.dim(`  src/genex.config.ts: baked slug -> ${to}`);
+}
+
 // src/commands/list.ts
 async function runList(opts) {
   const log = createLogger({ quiet: opts.quiet });
@@ -2017,9 +2135,9 @@ function relTime(iso) {
 // src/lib/deploy.ts
 import { spawn as spawn3 } from "child_process";
 import crypto3 from "crypto";
-import fs14 from "fs/promises";
+import fs15 from "fs/promises";
 import os5 from "os";
-import path13 from "path";
+import path14 from "path";
 
 // ../../packages/mobile-scan/src/image-dims.ts
 function u32be(b, o) {
@@ -2189,7 +2307,8 @@ function scanBundle(files) {
     ktx2Loader: text.includes("KTX2Loader") || text.includes(".ktx2"),
     touchHints: /joystick/i.test(text) || text.includes("touchstart") && text.includes("touch-action"),
     adaptiveQuality: text.includes("__GENEX_QUALITY__"),
-    modelRungs: text.includes("__GENEX_MODEL_RUNGS__")
+    modelRungs: text.includes("__GENEX_MODEL_RUNGS__"),
+    voice: text.includes("__GENEX_VOICE__")
   };
   return {
     images,
@@ -2282,12 +2401,12 @@ function tierFor(estVramMb) {
 }
 
 // src/commands/ui.ts
-import fs13 from "fs/promises";
-import path12 from "path";
+import fs14 from "fs/promises";
+import path13 from "path";
 import { PNG as PNG2 } from "pngjs";
 
 // src/lib/png-tools.ts
-import fs12 from "fs/promises";
+import fs13 from "fs/promises";
 import { PNG } from "pngjs";
 var ALPHA_TRANSPARENT_MAX = 16;
 var isHttpUrl = (s) => /^https?:\/\//i.test(s);
@@ -2298,12 +2417,12 @@ async function loadPng(input) {
     if (!res.ok) throw new Error(`Couldn't fetch ${input} (HTTP ${res.status}).`);
     buf = Buffer.from(await res.arrayBuffer());
   } else {
-    buf = await fs12.readFile(input);
+    buf = await fs13.readFile(input);
   }
   return PNG.sync.read(buf);
 }
 async function writePng(file, png) {
-  await fs12.writeFile(file, PNG.sync.write(png));
+  await fs13.writeFile(file, PNG.sync.write(png));
 }
 function cropPng(image, box) {
   const out = new PNG({ width: box.w, height: box.h });
@@ -2603,7 +2722,7 @@ async function uiExtract(opts, log) {
   const dilatePx = opts.dilate ?? 0;
   const sheet = await loadPng(input);
   const { width: W, height: H, data } = sheet;
-  await fs13.mkdir(outDir, { recursive: true });
+  await fs14.mkdir(outDir, { recursive: true });
   log.plain(c.bold("genex ui extract"));
   log.dim(`  ${input} (${W}x${H}) \u2192 ${outDir}, ${names.length} names`);
   let hasTransparency = false;
@@ -2832,7 +2951,7 @@ async function uiExtract(opts, log) {
         rimPixels: speckle.sampled
       });
     }
-    const outPath = path12.join(outDir, `${name}.png`);
+    const outPath = path13.join(outDir, `${name}.png`);
     await writePng(outPath, out);
     const sidecar = {
       name,
@@ -2851,7 +2970,7 @@ async function uiExtract(opts, log) {
       defringed
     };
     const { name: _n, out: _o, ...sidecarBody } = sidecar;
-    await fs13.writeFile(
+    await fs14.writeFile(
       outPath.replace(/\.png$/i, "") + ".bbox.json",
       JSON.stringify(sidecarBody, null, 2)
     );
@@ -2860,8 +2979,8 @@ async function uiExtract(opts, log) {
       `${name}.png  ${cropW}x${cropH} (ar ${sidecar.aspectRatio}) at sheet ${padX0},${padY0}`
     );
   }
-  const debugPath = path12.join(outDir, "extract-debug.json");
-  await fs13.writeFile(
+  const debugPath = path13.join(outDir, "extract-debug.json");
+  await fs14.writeFile(
     debugPath,
     JSON.stringify(
       {
@@ -3323,7 +3442,7 @@ async function uiMasks(opts, log) {
   const registrationTolerance = opts.registrationTolerance ?? 0.04;
   const edgeFlushMax = opts.edgeFlushMax ?? 0.04;
   const loosened = registrationTolerance > 0.04 || edgeFlushMax > 0.04 || minCoverage < 0.01 || maxCoverage > 0.85;
-  await fs13.mkdir(outDir, { recursive: true });
+  await fs14.mkdir(outDir, { recursive: true });
   log.plain(c.bold("genex ui masks"));
   log.dim(`  ${input} (${image.width}x${image.height}), ${pairs.length} pair(s) \u2192 ${outDir}`);
   const sheetComponents = detectSheetComponents(image, opts.minPixels ?? 2e3);
@@ -3376,11 +3495,11 @@ async function uiMasks(opts, log) {
       });
     }
     const overlay = makeOverlay(clean2, converted.png);
-    const framePath = path12.join(outDir, `${pair.name}-frame.png`);
-    const maskPath = path12.join(outDir, `${pair.name}-mask.png`);
-    const annotatedPath = path12.join(outDir, `${pair.name}-annotated-source.png`);
-    const overlayPath = path12.join(outDir, `${pair.name}-overlay.png`);
-    const metaPath = path12.join(outDir, `${pair.name}.annotated-progress.json`);
+    const framePath = path13.join(outDir, `${pair.name}-frame.png`);
+    const maskPath = path13.join(outDir, `${pair.name}-mask.png`);
+    const annotatedPath = path13.join(outDir, `${pair.name}-annotated-source.png`);
+    const overlayPath = path13.join(outDir, `${pair.name}-overlay.png`);
+    const metaPath = path13.join(outDir, `${pair.name}.annotated-progress.json`);
     await writePng(framePath, clean2);
     await writePng(maskPath, converted.png);
     await writePng(annotatedPath, annotated);
@@ -3427,7 +3546,7 @@ async function uiMasks(opts, log) {
       },
       overlay: overlayPath
     };
-    await fs13.writeFile(metaPath, `${JSON.stringify(meta, null, 2)}
+    await fs14.writeFile(metaPath, `${JSON.stringify(meta, null, 2)}
 `);
     results.push(meta);
     const fb = converted.bbox;
@@ -3443,8 +3562,8 @@ async function uiMasks(opts, log) {
       );
     }
   }
-  const indexPath = path12.join(outDir, "annotated-progress.json");
-  await fs13.writeFile(indexPath, `${JSON.stringify({ input, loosened, pairs: results }, null, 2)}
+  const indexPath = path13.join(outDir, "annotated-progress.json");
+  await fs14.writeFile(indexPath, `${JSON.stringify({ input, loosened, pairs: results }, null, 2)}
 `);
   log.plain("");
   log.success(`Wrote ${pairs.length} frame+mask pair(s) \u2192 ${outDir} (index: ${indexPath}).`);
@@ -3570,7 +3689,7 @@ async function uiTextColor(opts, log) {
   };
   process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
-  if (opts.out) await fs13.writeFile(opts.out, `${JSON.stringify(result, null, 2)}
+  if (opts.out) await fs14.writeFile(opts.out, `${JSON.stringify(result, null, 2)}
 `);
   if (opts.cropPath) log.dim(`  crop \u2192 ${opts.cropPath}`);
 }
@@ -3602,7 +3721,7 @@ async function uiTrim(opts, log) {
   const sidecar = computeBBoxes(trimmed);
   const speckleAllowed = !!(speckle && speckle.ratio > SPECKLE_MAX_RATIO);
   const sidecarPath = outPath.replace(/\.png$/i, "") + ".bbox.json";
-  await fs13.writeFile(
+  await fs14.writeFile(
     sidecarPath,
     JSON.stringify(speckleAllowed ? { ...sidecar, speckleAllowed: true } : sidecar, null, 2)
   );
@@ -3709,7 +3828,7 @@ async function uiPlate(opts, log) {
     fail("No interior found \u2014 the image is fully transparent (or erode ate everything). Check --in / lower --erode.");
   }
   await writePng(outPath, out);
-  const name = path12.basename(outPath);
+  const name = path13.basename(outPath);
   log.plain(c.bold("genex ui plate"));
   log.success(`${outPath}  ${W}x${H}, interior ${(count / (W * H) * 100).toFixed(1)}% (erode ${erode}px)`);
   log.dim("  Wire it as the plate's silhouette (same box as the frame <img>, plate UNDER the art):");
@@ -3874,13 +3993,13 @@ async function walkFiles(dir) {
   const out = [];
   let entries;
   try {
-    entries = await fs13.readdir(dir, { withFileTypes: true });
+    entries = await fs14.readdir(dir, { withFileTypes: true });
   } catch {
     return out;
   }
   for (const entry of entries) {
     if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
-    const p = path12.join(dir, entry.name);
+    const p = path13.join(dir, entry.name);
     if (entry.isDirectory()) out.push(...await walkFiles(p));
     else out.push(p);
   }
@@ -3889,7 +4008,7 @@ async function walkFiles(dir) {
 async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   const viewportFindings = [];
   try {
-    const indexHtml = await fs13.readFile(path12.join(cwd, "index.html"), "utf8");
+    const indexHtml = await fs14.readFile(path13.join(cwd, "index.html"), "utf8");
     if (!/<meta[^>]+name=["']viewport["']/i.test(indexHtml)) {
       viewportFindings.push({
         kind: "viewport-meta",
@@ -3903,28 +4022,28 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     }
   } catch {
   }
-  const absAssets = path12.resolve(cwd, assetDir);
+  const absAssets = path13.resolve(cwd, assetDir);
   try {
-    if (!(await fs13.stat(absAssets)).isDirectory()) {
+    if (!(await fs14.stat(absAssets)).isDirectory()) {
       return viewportFindings.length > 0 ? viewportFindings : null;
     }
   } catch {
     return viewportFindings.length > 0 ? viewportFindings : null;
   }
-  const srcFiles = (await walkFiles(path12.resolve(cwd, srcDir))).filter(
-    (p) => AUDIT_SRC_EXTS.has(path12.extname(p).toLowerCase())
+  const srcFiles = (await walkFiles(path13.resolve(cwd, srcDir))).filter(
+    (p) => AUDIT_SRC_EXTS.has(path13.extname(p).toLowerCase())
   );
   try {
-    for (const name of await fs13.readdir(cwd)) {
-      const ext = path12.extname(name).toLowerCase();
-      if (ext === ".html" || ext === ".css") srcFiles.push(path12.join(cwd, name));
+    for (const name of await fs14.readdir(cwd)) {
+      const ext = path13.extname(name).toLowerCase();
+      if (ext === ".html" || ext === ".css") srcFiles.push(path13.join(cwd, name));
     }
   } catch {
   }
   const sources = [];
   for (const p of srcFiles) {
     try {
-      sources.push({ rel: path12.relative(cwd, p), text: await fs13.readFile(p, "utf8") });
+      sources.push({ rel: path13.relative(cwd, p), text: await fs14.readFile(p, "utf8") });
     } catch {
     }
   }
@@ -3934,11 +4053,11 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   const metaByName = /* @__PURE__ */ new Map();
   const bboxByPng = /* @__PURE__ */ new Map();
   for (const p of assetFiles) {
-    const base = path12.basename(p);
+    const base = path13.basename(p);
     const metaMatch = /^(.+)\.annotated-progress\.json$/.exec(base);
     if (metaMatch) {
       try {
-        const meta = JSON.parse(await fs13.readFile(p, "utf8"));
+        const meta = JSON.parse(await fs14.readFile(p, "utf8"));
         metaByName.set(metaMatch[1], {
           cleanCrop: meta.clean?.crop ?? null,
           loosened: meta.loosened === true
@@ -3949,7 +4068,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     }
     if (base.endsWith(".bbox.json")) {
       try {
-        const sidecar = JSON.parse(await fs13.readFile(p, "utf8"));
+        const sidecar = JSON.parse(await fs14.readFile(p, "utf8"));
         if (sidecar.sheetBBox) bboxByPng.set(base.replace(/\.bbox\.json$/, ".png"), sidecar.sheetBBox);
       } catch {
       }
@@ -3958,7 +4077,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   for (const [name, meta] of metaByName) {
     if (!meta.cleanCrop || !referenced(`${name}-mask.png`)) continue;
     for (const p of assetFiles) {
-      const base = path12.basename(p);
+      const base = path13.basename(p);
       if (!base.toLowerCase().endsWith(".png")) continue;
       if (base !== `${name}.png` && !base.startsWith(`${name}-`)) continue;
       if (/-mask\.png$|-frame\.png$|-overlay\.png$|-annotated-source\.png$/.test(base)) continue;
@@ -3982,7 +4101,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   }
   const pngByBase = /* @__PURE__ */ new Map();
   for (const p of assetFiles) {
-    const base = path12.basename(p);
+    const base = path13.basename(p);
     if (base.toLowerCase().endsWith(".png")) pngByBase.set(base, p);
   }
   for (const [maskBase, maskPath] of pngByBase) {
@@ -3995,8 +4114,8 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
       let frame;
       let mask;
       try {
-        frame = PNG2.sync.read(await fs13.readFile(framePath));
-        mask = PNG2.sync.read(await fs13.readFile(maskPath));
+        frame = PNG2.sync.read(await fs14.readFile(framePath));
+        mask = PNG2.sync.read(await fs14.readFile(maskPath));
       } catch {
         continue;
       }
@@ -4015,7 +4134,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     if (!referenced(base)) continue;
     let png;
     try {
-      png = PNG2.sync.read(await fs13.readFile(p));
+      png = PNG2.sync.read(await fs14.readFile(p));
     } catch {
       continue;
     }
@@ -4035,7 +4154,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   }
   const maskReported = /* @__PURE__ */ new Set();
   for (const p of assetFiles) {
-    const m = /^(.+)\.annotated-progress\.json$/.exec(path12.basename(p));
+    const m = /^(.+)\.annotated-progress\.json$/.exec(path13.basename(p));
     if (!m) continue;
     const maskBase = `${m[1]}-mask.png`;
     if (!referenced(maskBase)) {
@@ -4047,14 +4166,14 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     }
   }
   for (const p of assetFiles) {
-    const base = path12.basename(p);
+    const base = path13.basename(p);
     if (!base.toLowerCase().endsWith(".png")) continue;
     if (/-annotated-source\.png$|-overlay\.png$/.test(base)) continue;
     if (maskReported.has(base)) continue;
     if (!referenced(base)) {
       findings.push({
         kind: "unwired-sprite",
-        message: `${path12.relative(cwd, p)} is on disk but never referenced in ${srcDir}/index.html/CSS \u2014 wire it, or record the one-line reason it was cut. (Computed-string references are invisible here \u2014 check.)`
+        message: `${path13.relative(cwd, p)} is on disk but never referenced in ${srcDir}/index.html/CSS \u2014 wire it, or record the one-line reason it was cut. (Computed-string references are invisible here \u2014 check.)`
       });
     }
   }
@@ -4188,7 +4307,7 @@ async function printUiAuditPreflight(log) {
 }
 async function printPipelineStatePreflight(log, cwd = process.cwd()) {
   try {
-    const design = await fs14.readFile(path13.join(cwd, "DESIGN.md"), "utf8").catch(() => "");
+    const design = await fs15.readFile(path14.join(cwd, "DESIGN.md"), "utf8").catch(() => "");
     const warnings = [];
     if (design.length > 0 && !/##\s*build plan & status/i.test(design)) {
       warnings.push(
@@ -4196,7 +4315,7 @@ async function printPipelineStatePreflight(log, cwd = process.cwd()) {
       );
     }
     if (!/player character:/i.test(design)) {
-      const hasCharacter = await fs14.access(path13.join(cwd, "public", "assets", "meshy-character.json")).then(() => true, () => false);
+      const hasCharacter = await fs15.access(path14.join(cwd, "public", "assets", "meshy-character.json")).then(() => true, () => false);
       if (!hasCharacter && await loadsPlayerBody(cwd)) {
         warnings.push(
           `Player character is the stock avatar \u2014 no generated character is wired. The game's own generated character is the player's body wherever a human body appears on screen, first-person included (genex-ai-character). Generate it, or record "Player character: VRM \u2014 <reason>" in DESIGN.md (no human body in this game / out of credits / player declined).`
@@ -4210,12 +4329,12 @@ async function printPipelineStatePreflight(log, cwd = process.cwd()) {
 async function loadsPlayerBody(cwd) {
   const BODY_LOADERS = /\bloadPlayerCharacter\s*\(|\bloadVrm(?:Clone)?\s*\(/;
   try {
-    const entries = await fs14.readdir(path13.join(cwd, "src"), { recursive: true });
+    const entries = await fs15.readdir(path14.join(cwd, "src"), { recursive: true });
     for (const rel of entries) {
       if (rel.includes("node_modules")) continue;
-      if (rel.split(path13.sep)[0] === "controllers" || rel.startsWith("controllers/")) continue;
+      if (rel.split(path14.sep)[0] === "controllers" || rel.startsWith("controllers/")) continue;
       if (!/\.(ts|tsx|js|jsx)$/.test(rel)) continue;
-      const text = await fs14.readFile(path13.join(cwd, "src", rel), "utf8").catch(() => "");
+      const text = await fs15.readFile(path14.join(cwd, "src", rel), "utf8").catch(() => "");
       if (BODY_LOADERS.test(text)) return true;
     }
   } catch {
@@ -4239,9 +4358,9 @@ async function deployGame(ctx, opts, log) {
     }
     log.success("Built.");
   }
-  const distDir = path13.join(cwd, "dist");
+  const distDir = path14.join(cwd, "dist");
   const siteDir = await isDir2(distDir) ? distDir : cwd;
-  const rel = path13.relative(cwd, siteDir) || ".";
+  const rel = path14.relative(cwd, siteDir) || ".";
   if (siteDir === cwd) await writeGitignore(cwd, log);
   const files = await collectFiles(siteDir);
   if (files.length === 0) {
@@ -4308,7 +4427,7 @@ async function deployGame(ctx, opts, log) {
 }
 async function hasBuildScript(cwd) {
   try {
-    const pkg = JSON.parse(await fs14.readFile(path13.join(cwd, "package.json"), "utf8"));
+    const pkg = JSON.parse(await fs15.readFile(path14.join(cwd, "package.json"), "utf8"));
     return Boolean(pkg.scripts?.build);
   } catch {
     return false;
@@ -4317,12 +4436,12 @@ async function hasBuildScript(cwd) {
 async function collectFiles(root) {
   const out = [];
   const walk2 = async (dir, prefix) => {
-    for (const e of await fs14.readdir(dir, { withFileTypes: true })) {
+    for (const e of await fs15.readdir(dir, { withFileTypes: true })) {
       const relPath = prefix ? `${prefix}/${e.name}` : e.name;
       if (e.isDirectory()) {
-        if (!EXCLUDE_DIRS.has(e.name)) await walk2(path13.join(dir, e.name), relPath);
+        if (!EXCLUDE_DIRS.has(e.name)) await walk2(path14.join(dir, e.name), relPath);
       } else if (e.isFile() && !isSecretEnvFile(e.name)) {
-        out.push({ relPath, bytes: await fs14.readFile(path13.join(dir, e.name)) });
+        out.push({ relPath, bytes: await fs15.readFile(path14.join(dir, e.name)) });
       }
     }
   };
@@ -4560,7 +4679,7 @@ async function pushWorktree(cwd, pushUrl, managed, log, branch = "main") {
     log.error("Couldn't save your game's source \u2014 please try again.");
     return false;
   };
-  const gitDir = await fs14.mkdtemp(path13.join(os5.tmpdir(), "genex-source-"));
+  const gitDir = await fs15.mkdtemp(path14.join(os5.tmpdir(), "genex-source-"));
   const base = { GIT_DIR: gitDir };
   if (urlHasEmbeddedCredentials(pushUrl)) {
     base.GIT_CONFIG_COUNT = "1";
@@ -4575,12 +4694,12 @@ async function pushWorktree(cwd, pushUrl, managed, log, branch = "main") {
   };
   try {
     if ((await run("git", ["init", "-q"], base)).code !== 0) return failed();
-    await fs14.writeFile(
-      path13.join(gitDir, "info", "exclude"),
+    await fs15.writeFile(
+      path14.join(gitDir, "info", "exclude"),
       // .env* are secrets — never publish them; `!` keeps the non-secret template.
       ["node_modules/", "dist/", ".git/", ".genex/", ".env", ".env.*", "!.env.example", ""].join("\n")
     );
-    const env = { ...base, GIT_WORK_TREE: cwd, GIT_INDEX_FILE: path13.join(gitDir, "index-source") };
+    const env = { ...base, GIT_WORK_TREE: cwd, GIT_INDEX_FILE: path14.join(gitDir, "index-source") };
     let lfs = (await run("git", ["lfs", "version"], base)).code !== 0 ? false : true;
     if (!lfs) {
       log.step("Installing git-lfs (keeps large binary assets out of the source push)\u2026");
@@ -4631,7 +4750,7 @@ async function pushWorktree(cwd, pushUrl, managed, log, branch = "main") {
   } catch {
     return failed();
   } finally {
-    await fs14.rm(gitDir, { recursive: true, force: true }).catch(() => {
+    await fs15.rm(gitDir, { recursive: true, force: true }).catch(() => {
     });
   }
 }
@@ -4667,7 +4786,7 @@ async function fetchPushUrl(ctx, log) {
 }
 async function isDir2(p) {
   try {
-    return (await fs14.stat(p)).isDirectory();
+    return (await fs15.stat(p)).isDirectory();
   } catch {
     return false;
   }
@@ -4802,17 +4921,17 @@ async function promoteBuild(apiUrl, projectId, token, log) {
 }
 
 // src/lib/detect-features.ts
-import fs16 from "fs/promises";
-import path15 from "path";
+import fs17 from "fs/promises";
+import path16 from "path";
 
 // src/lib/generation-ledger.ts
-import fs15 from "fs/promises";
-import path14 from "path";
-var ledgerPath = (cwd) => path14.join(cwd, ".genex", "generations.ndjson");
+import fs16 from "fs/promises";
+import path15 from "path";
+var ledgerPath = (cwd) => path15.join(cwd, ".genex", "generations.ndjson");
 async function append(cwd, event) {
   try {
-    await fs15.access(path14.join(cwd, ".genex"));
-    await fs15.appendFile(ledgerPath(cwd), `${JSON.stringify(event)}
+    await fs16.access(path15.join(cwd, ".genex"));
+    await fs16.appendFile(ledgerPath(cwd), `${JSON.stringify(event)}
 `, "utf8");
   } catch {
   }
@@ -4820,7 +4939,7 @@ async function append(cwd, event) {
 async function readLedger(cwd = process.cwd()) {
   let raw;
   try {
-    raw = await fs15.readFile(ledgerPath(cwd), "utf8");
+    raw = await fs16.readFile(ledgerPath(cwd), "utf8");
   } catch {
     return [];
   }
@@ -4874,7 +4993,7 @@ async function countFailed(kind, cwd = process.cwd()) {
 // src/lib/detect-features.ts
 async function detectEmbedSdkVersion(cwd = process.cwd()) {
   try {
-    const raw = await fs16.readFile(path15.join(cwd, "package.json"), "utf8");
+    const raw = await fs17.readFile(path16.join(cwd, "package.json"), "utf8");
     const pkg = JSON.parse(raw);
     const version = pkg.dependencies?.["@genex-ai/embed-sdk"] ?? pkg.devDependencies?.["@genex-ai/embed-sdk"];
     return typeof version === "string" && version ? version : null;
@@ -4884,7 +5003,7 @@ async function detectEmbedSdkVersion(cwd = process.cwd()) {
 }
 async function detectMultiplayer(cwd = process.cwd()) {
   try {
-    const raw = await fs16.readFile(path15.join(cwd, "package.json"), "utf8");
+    const raw = await fs17.readFile(path16.join(cwd, "package.json"), "utf8");
     const pkg = JSON.parse(raw);
     return Boolean(
       pkg.dependencies?.["@genex-ai/multiplayer"] ?? pkg.devDependencies?.["@genex-ai/multiplayer"]
@@ -4896,7 +5015,7 @@ async function detectMultiplayer(cwd = process.cwd()) {
 async function detectMatchmaking(log, cwd = process.cwd()) {
   let pkg;
   try {
-    pkg = JSON.parse(await fs16.readFile(path15.join(cwd, "package.json"), "utf8"));
+    pkg = JSON.parse(await fs17.readFile(path16.join(cwd, "package.json"), "utf8"));
   } catch (err) {
     log.dim(`  (skipping matchmaking \u2014 couldn't read package.json: ${String(err)})`);
     return null;
@@ -4914,15 +5033,15 @@ async function detectMatchmaking(log, cwd = process.cwd()) {
 var TOUCH_KIT_MARKERS = /controllers\/touch\/|controllers\/character\/touch-joystick|TouchJoystick|VirtualButton|DragZone|RotateOverlay/;
 async function detectMobileControls(cwd = process.cwd()) {
   try {
-    const raw = await fs16.readFile(path15.join(cwd, "package.json"), "utf8");
+    const raw = await fs17.readFile(path16.join(cwd, "package.json"), "utf8");
     const pkg = JSON.parse(raw);
     if (pkg.genex?.mobileControls === true) return true;
   } catch {
   }
-  const srcDir = path15.join(cwd, "src");
+  const srcDir = path16.join(cwd, "src");
   let entries;
   try {
-    entries = await fs16.readdir(srcDir, { recursive: true });
+    entries = await fs17.readdir(srcDir, { recursive: true });
   } catch {
     return false;
   }
@@ -4930,7 +5049,7 @@ async function detectMobileControls(cwd = process.cwd()) {
     if (rel.includes("node_modules")) continue;
     if (!/\.(ts|js|mts|mjs|tsx|jsx)$/.test(rel)) continue;
     try {
-      const content = await fs16.readFile(path15.join(srcDir, rel), "utf8");
+      const content = await fs17.readFile(path16.join(srcDir, rel), "utf8");
       if (TOUCH_KIT_MARKERS.test(content)) return true;
     } catch {
     }
@@ -4939,10 +5058,10 @@ async function detectMobileControls(cwd = process.cwd()) {
 }
 var GAME_STATE_CALLS = /savePlayerState|saveWorldState|submitScore/;
 async function detectGameStateUsage(cwd = process.cwd()) {
-  const srcDir = path15.join(cwd, "src");
+  const srcDir = path16.join(cwd, "src");
   let entries;
   try {
-    entries = await fs16.readdir(srcDir, { recursive: true });
+    entries = await fs17.readdir(srcDir, { recursive: true });
   } catch {
     return false;
   }
@@ -4950,7 +5069,7 @@ async function detectGameStateUsage(cwd = process.cwd()) {
     if (rel.includes("node_modules")) continue;
     if (!/\.(ts|js|mts|mjs|tsx|jsx)$/.test(rel)) continue;
     try {
-      const content = await fs16.readFile(path15.join(srcDir, rel), "utf8");
+      const content = await fs17.readFile(path16.join(srcDir, rel), "utf8");
       if (GAME_STATE_CALLS.test(content)) return true;
     } catch {
     }
@@ -4999,19 +5118,19 @@ async function detectSurfaceScan(cwd = process.cwd()) {
     depthRange: [],
     mediaElementAudio: []
   };
-  const srcDir = path15.join(cwd, "src");
+  const srcDir = path16.join(cwd, "src");
   let entries;
   try {
-    entries = await fs16.readdir(srcDir, { recursive: true });
+    entries = await fs17.readdir(srcDir, { recursive: true });
   } catch {
     return found;
   }
   for (const nativeRel of entries) {
     if (nativeRel.includes("node_modules")) continue;
     if (!/\.(ts|js|mts|mjs|tsx|jsx)$/.test(nativeRel)) continue;
-    const raw = await fs16.readFile(path15.join(srcDir, nativeRel), "utf8").catch(() => "");
+    const raw = await fs17.readFile(path16.join(srcDir, nativeRel), "utf8").catch(() => "");
     if (!raw) continue;
-    const rel = nativeRel.split(path15.sep).join("/");
+    const rel = nativeRel.split(path16.sep).join("/");
     const content = raw.replace(/\/\*[\s\S]*?\*\//g, (m2) => m2.replace(/[^\n]/g, " ")).replace(/(^|[^:])\/\/[^\n]*/gm, (m2, p1) => p1 + " ".repeat(m2.length - p1.length));
     const repeatRe = /\.repeat\.set\(\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)\s*\)/g;
     let m;
@@ -5069,25 +5188,25 @@ async function detectGenerationAudit(cwd = process.cwd()) {
   let haystack = "";
   const read = async (file) => {
     try {
-      haystack += await fs16.readFile(file, "utf8");
+      haystack += await fs17.readFile(file, "utf8");
     } catch {
     }
   };
   try {
-    for (const entry of await fs16.readdir(cwd, { withFileTypes: true })) {
+    for (const entry of await fs17.readdir(cwd, { withFileTypes: true })) {
       if (entry.isFile() && /\.(ts|tsx|js|jsx|css|html|json)$/.test(entry.name)) {
-        await read(path15.join(cwd, entry.name));
+        await read(path16.join(cwd, entry.name));
       }
     }
   } catch {
   }
   for (const sub of ["src", "public"]) {
     try {
-      const entries = await fs16.readdir(path15.join(cwd, sub), { recursive: true });
+      const entries = await fs17.readdir(path16.join(cwd, sub), { recursive: true });
       for (const rel of entries) {
         if (rel.includes("node_modules")) continue;
         if (!/\.(ts|tsx|js|jsx|css|html|json|txt)$/.test(rel)) continue;
-        await read(path15.join(cwd, sub, rel));
+        await read(path16.join(cwd, sub, rel));
       }
     } catch {
     }
@@ -5219,7 +5338,7 @@ async function borrowEvidence(meta, cwd) {
   } catch {
     return true;
   }
-  const gitConfig = await fs16.readFile(path15.join(cwd, ".git", "config"), "utf8").catch(() => "");
+  const gitConfig = await fs17.readFile(path16.join(cwd, ".git", "config"), "utf8").catch(() => "");
   for (const m of gitConfig.matchAll(/url\s*=\s*(\S+)/g)) {
     try {
       const u = new URL(m[1]);
@@ -5227,7 +5346,7 @@ async function borrowEvidence(meta, cwd) {
     } catch {
     }
   }
-  const readme = await fs16.readFile(path15.join(cwd, "README.md"), "utf8").catch(() => "");
+  const readme = await fs17.readFile(path16.join(cwd, "README.md"), "utf8").catch(() => "");
   return readme.includes(host) || /\b(upstream|originally by|ported from|borrowed from)\b/i.test(readme);
 }
 
@@ -5477,8 +5596,8 @@ async function runPromote(opts) {
 }
 
 // src/commands/generate.ts
-import fs17 from "fs/promises";
-import path16 from "path";
+import fs18 from "fs/promises";
+import path17 from "path";
 import { PNG as PNG4 } from "pngjs";
 
 // src/lib/glass.ts
@@ -5648,7 +5767,7 @@ var isRemoteRef = (value) => /^(https?:\/\/|data:)/i.test(value);
 async function inlineLocalImage(filePath, flag) {
   let bytes;
   try {
-    bytes = await fs17.readFile(filePath);
+    bytes = await fs18.readFile(filePath);
   } catch {
     return { ok: false, error: `Couldn't read the ${flag} file at ${filePath}.` };
   }
@@ -5658,7 +5777,7 @@ async function inlineLocalImage(filePath, flag) {
       error: `${flag} file is ${(bytes.length / 1048576).toFixed(1)} MB \u2014 over the ~4 MB inline limit. Downscale/compress it first, or pass an asset URL instead.`
     };
   }
-  const mime = IMAGE_MIME_BY_EXT[path16.extname(filePath).toLowerCase()] ?? "image/png";
+  const mime = IMAGE_MIME_BY_EXT[path17.extname(filePath).toLowerCase()] ?? "image/png";
   return { ok: true, dataUri: `data:${mime};base64,${bytes.toString("base64")}` };
 }
 var SKYBOX_ENVIRONMENT_SUFFIX = ". The image contains ONLY sky: cloud, atmosphere, light, weather and distant haze at the horizon. Every structure, object, plant and ground surface is outside the frame.";
@@ -5854,7 +5973,7 @@ async function runGenerate(kind, opts) {
       return;
     }
     try {
-      const bytes = await fs17.readFile(opts.inpaintUrl);
+      const bytes = await fs18.readFile(opts.inpaintUrl);
       opts = { ...opts, inpaintUrl: `data:image/png;base64,${bytes.toString("base64")}` };
     } catch {
       log.error(`Couldn't read the --inpaint mask at ${opts.inpaintUrl}.`);
@@ -5978,7 +6097,7 @@ async function reportGlassTerminal(view, outDir, log, json) {
     return;
   }
   await recordTerminal(view.id, "completed", files.map((f) => f.url));
-  await fs17.mkdir(outDir, { recursive: true });
+  await fs18.mkdir(outDir, { recursive: true });
   const solved = [];
   for (let i = 0; i < files.length; i++) {
     const f = files[i];
@@ -6010,8 +6129,8 @@ async function reportGlassTerminal(view, outDir, log, json) {
       });
       continue;
     }
-    const outPath = path16.join(outDir, `glass-${i + 1}.png`);
-    await fs17.writeFile(outPath, PNG4.sync.write(r.png));
+    const outPath = path17.join(outDir, `glass-${i + 1}.png`);
+    await fs18.writeFile(outPath, PNG4.sync.write(r.png));
     solved.push({
       path: outPath,
       url: f.url,
@@ -6605,8 +6724,8 @@ async function toRow(e, v, cwd) {
 }
 
 // src/commands/controller.ts
-import fs19 from "fs/promises";
-import path18 from "path";
+import fs20 from "fs/promises";
+import path19 from "path";
 
 // ../../packages/meshy-animation-catalog/src/index.ts
 import { createHash } from "crypto";
@@ -15736,9 +15855,9 @@ function searchMeshyAnimations(query, options = {}) {
 }
 
 // src/lib/anims.ts
-import fs18 from "fs/promises";
-import path17 from "path";
-var ANIMS_DEST = path17.join("public", "assets", "anims");
+import fs19 from "fs/promises";
+import path18 from "path";
+var ANIMS_DEST = path18.join("public", "assets", "anims");
 var HIDDEN_TAG = "reference";
 async function runAnims(opts) {
   const log = createLogger({ quiet: opts.quiet });
@@ -15754,7 +15873,7 @@ async function runAnims(opts) {
     printCatalog(log, manifest, selectors);
     return;
   }
-  const controllerMarker = path17.join(root, "src", "controllers", "character");
+  const controllerMarker = path18.join(root, "src", "controllers", "character");
   if (!await exists2(controllerMarker)) {
     log.error(
       `No character controller in this game (missing ${c.cyan("src/controllers/character/")}).`
@@ -15763,11 +15882,11 @@ async function runAnims(opts) {
     process.exitCode = 1;
     return;
   }
-  const destDir = path17.join(root, ANIMS_DEST);
-  const gameManifestPath = path17.join(destDir, "manifest.json");
+  const destDir = path18.join(root, ANIMS_DEST);
+  const gameManifestPath = path18.join(destDir, "manifest.json");
   if (opts.reset) {
-    await fs18.rm(destDir, { recursive: true, force: true });
-    log.step(`Cleared ${c.cyan(ANIMS_DEST + path17.sep)} (--reset)`);
+    await fs19.rm(destDir, { recursive: true, force: true });
+    log.step(`Cleared ${c.cyan(ANIMS_DEST + path18.sep)} (--reset)`);
   }
   if (selectors.length === 0) {
     const installed = await readGameManifest(gameManifestPath);
@@ -15805,35 +15924,35 @@ async function runAnims(opts) {
     }
   }
   const wanted = [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
-  const cacheDir = path17.join(
+  const cacheDir = path18.join(
     opts.cacheDir ?? getAnimsCacheDir(),
     `${manifest.library}-v${manifest.version}`
   );
-  await fs18.mkdir(cacheDir, { recursive: true });
-  await fs18.mkdir(destDir, { recursive: true });
+  await fs19.mkdir(cacheDir, { recursive: true });
+  await fs19.mkdir(destDir, { recursive: true });
   const base = getAnimsBase(opts.animsBase);
   let installedCount = 0;
   let presentCount = 0;
   let addedBytes = 0;
   const failures = [];
   for (const entry of wanted) {
-    const dest = path17.join(destDir, entry.file);
+    const dest = path18.join(destDir, entry.file);
     if (await hasSize(dest, entry.bytes)) {
       presentCount++;
       continue;
     }
     try {
-      const cached = path17.join(cacheDir, entry.file);
+      const cached = path18.join(cacheDir, entry.file);
       if (!await hasSize(cached, entry.bytes)) {
         const res = await fetch(base + entry.file);
         if (!res.ok) throw new Error(`HTTP ${res.status}`);
         const buf = Buffer.from(await res.arrayBuffer());
-        await fs18.writeFile(cached, buf);
+        await fs19.writeFile(cached, buf);
       }
-      await fs18.copyFile(cached, dest);
+      await fs19.copyFile(cached, dest);
       installedCount++;
       addedBytes += entry.bytes;
-      log.dim(`  ${path17.join(ANIMS_DEST, entry.file)} (${formatMb(entry.bytes)})`);
+      log.dim(`  ${path18.join(ANIMS_DEST, entry.file)} (${formatMb(entry.bytes)})`);
     } catch (err) {
       failures.push(`${entry.name} (${err instanceof Error ? err.message : String(err)})`);
     }
@@ -15849,13 +15968,13 @@ async function runAnims(opts) {
     version: manifest.version,
     clips: [...union].sort((a, b) => a.localeCompare(b))
   };
-  await fs18.writeFile(gameManifestPath, JSON.stringify(gameManifest, null, 2) + "\n");
+  await fs19.writeFile(gameManifestPath, JSON.stringify(gameManifest, null, 2) + "\n");
   log.plain("");
   const parts = [`${installedCount} clip${installedCount === 1 ? "" : "s"} installed`];
   if (presentCount > 0) parts.push(`${presentCount} already present`);
   if (bundledSkips > 0) parts.push(`${bundledSkips} already bundled in animation-library.glb`);
   log.success(
-    `${parts.join(", ")} \u2192 ${c.cyan(ANIMS_DEST + path17.sep)}${addedBytes > 0 ? ` (+${formatMb(addedBytes)})` : ""}`
+    `${parts.join(", ")} \u2192 ${c.cyan(ANIMS_DEST + path18.sep)}${addedBytes > 0 ? ` (+${formatMb(addedBytes)})` : ""}`
   );
   for (const [selector, entries] of resolved) {
     const names = entries.filter((e) => !coreNames.has(e.name)).map((e) => e.name);
@@ -15887,8 +16006,8 @@ async function loadManifest(baseOverride) {
     }
   } catch {
   }
-  const snapshotPath = path17.join(getTemplatesDir(), "controllers", "assets", "anims-manifest.json");
-  const manifest = JSON.parse(await fs18.readFile(snapshotPath, "utf8"));
+  const snapshotPath = path18.join(getTemplatesDir(), "controllers", "assets", "anims-manifest.json");
+  const manifest = JSON.parse(await fs19.readFile(snapshotPath, "utf8"));
   return { manifest, source: "snapshot" };
 }
 function resolveSelectors(manifest, selectors) {
@@ -16006,21 +16125,21 @@ function printCatalog(log, manifest, selectors) {
 }
 async function readGameManifest(file) {
   try {
-    return JSON.parse(await fs18.readFile(file, "utf8"));
+    return JSON.parse(await fs19.readFile(file, "utf8"));
   } catch {
     return null;
   }
 }
 async function hasSize(file, bytes) {
   try {
-    return (await fs18.stat(file)).size === bytes;
+    return (await fs19.stat(file)).size === bytes;
   } catch {
     return false;
   }
 }
 async function exists2(p) {
   try {
-    await fs18.access(p);
+    await fs19.access(p);
     return true;
   } catch {
     return false;
@@ -16037,7 +16156,9 @@ var CONTROLLER_KINDS = [
   "drone",
   "touch",
   "networked-physics",
-  "quality"
+  "quality",
+  "chat",
+  "voice"
 ];
 var SHARED = [
   "shared/math.ts",
@@ -16160,6 +16281,26 @@ var CONTROLLER_FILE_SETS = {
       `const gov = new QualityGovernor(tier, { setDprScale: (m) => renderer.setPixelRatio(Math.min(window.devicePixelRatio, tier.dprCap * m)), setShadowQuality: (l) => sun.shadow.mapSize.setScalar(l === 'full' ? tier.shadowMapSize : tier.shadowMapSize / 2) }, renderer);`
     ]
   },
+  voice: {
+    code: ["voice/voice-proximity.ts", NOTICE],
+    assets: [],
+    skill: "genex-threejs-multiplayer",
+    sketch: [
+      `const voice = new ProximityVoice({ room, listener: camera.children.find(c => c.type === "AudioListener") });`,
+      `await voice.join(); // MUST be inside a click/tap handler \u2014 browsers gate the mic prompt on a gesture`,
+      `// per frame: voice.update((id) => remoteBodies.get(id)?.position ?? null)`
+    ]
+  },
+  chat: {
+    code: ["chat/chat-overlay.ts", NOTICE],
+    assets: [],
+    skill: "genex-threejs-multiplayer",
+    sketch: [
+      `const room = await connect({ gameId: "<slug>", auth: getColyseusAuth }); // @genex-ai/multiplayer`,
+      `const chat = new ChatOverlay({ room, onTypingChange: (t) => { keyboard.enabled = !t; } });`,
+      `// that onTypingChange is REQUIRED \u2014 without it "w" walks the player while someone types`
+    ]
+  },
   touch: {
     code: [...TOUCH_KIT, NOTICE],
     assets: [],
@@ -16189,8 +16330,8 @@ var CONTROLLER_FILE_SETS = {
     ]
   }
 };
-var CODE_DEST = path18.join("src", "controllers");
-var ASSETS_DEST = path18.join("public", "assets");
+var CODE_DEST = path19.join("src", "controllers");
+var ASSETS_DEST = path19.join("public", "assets");
 async function runController(opts) {
   const log = createLogger({ quiet: opts.quiet });
   if (opts.kind?.trim() === "anims") {
@@ -16207,31 +16348,31 @@ async function runController(opts) {
     process.exitCode = 1;
     return;
   }
-  const srcDir = path18.join(getTemplatesDir(), "controllers");
+  const srcDir = path19.join(getTemplatesDir(), "controllers");
   const root = opts.cwd ?? process.cwd();
   const set = CONTROLLER_FILE_SETS[kind];
   log.plain(c.bold(`genex controller ${kind}`));
   log.plain("");
-  log.step(`Installing the ${kind} controller into ${c.cyan(CODE_DEST + path18.sep)}`);
+  log.step(`Installing the ${kind} controller into ${c.cyan(CODE_DEST + path19.sep)}`);
   const plan = [
-    ...set.code.map((rel) => ({ from: rel, rel: path18.join(CODE_DEST, rel) })),
+    ...set.code.map((rel) => ({ from: rel, rel: path19.join(CODE_DEST, rel) })),
     ...set.assets.map((rel) => ({
       from: rel,
-      rel: path18.join(ASSETS_DEST, path18.basename(rel))
+      rel: path19.join(ASSETS_DEST, path19.basename(rel))
     }))
   ];
   let copied = 0;
   let skipped = 0;
   try {
     for (const file of plan) {
-      const dest = path18.join(root, file.rel);
+      const dest = path19.join(root, file.rel);
       if (!opts.force && await exists3(dest)) {
         skipped++;
         log.dim(`  skipped ${file.rel} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs19.mkdir(path18.dirname(dest), { recursive: true });
-      await fs19.copyFile(path18.join(srcDir, file.from), dest);
+      await fs20.mkdir(path19.dirname(dest), { recursive: true });
+      await fs20.copyFile(path19.join(srcDir, file.from), dest);
       copied++;
       log.dim(`  ${file.rel}`);
     }
@@ -16284,7 +16425,7 @@ async function runController(opts) {
   for (const line of set.sketch) {
     log.dim(`       ${line}`);
   }
-  if (kind === "character" && !await exists3(path18.join(root, ASSETS_DEST, "meshy-character.json"))) {
+  if (kind === "character" && !await exists3(path19.join(root, ASSETS_DEST, "meshy-character.json"))) {
     log.plain("");
     log.plain(
       `  ${stepOffset + 3}. This game has no generated character yet \u2014 ${c.cyan(
@@ -16316,9 +16457,9 @@ async function installMeshyCharacterManifest(args) {
     throw new Error("The API returned an invalid Meshy character manifest.");
   }
   assertCompleteMeshyControllerPack(manifest);
-  const destination = path18.join(args.root, ASSETS_DEST, "meshy-character.json");
-  await fs19.mkdir(path18.dirname(destination), { recursive: true });
-  await fs19.writeFile(
+  const destination = path19.join(args.root, ASSETS_DEST, "meshy-character.json");
+  await fs20.mkdir(path19.dirname(destination), { recursive: true });
+  await fs20.writeFile(
     destination,
     `${JSON.stringify(manifest, null, 2)}
 `
@@ -16456,14 +16597,14 @@ function assertCompleteMeshyControllerPack(manifest) {
 }
 async function installFallbackAvatar(args) {
   const { root, srcDir, log } = args;
-  const dest = path18.join(root, ASSETS_DEST, "avatar.vrm");
-  await fs19.mkdir(path18.dirname(dest), { recursive: true });
-  await fs19.copyFile(path18.join(srcDir, "assets", "default-avatar.vrm"), dest);
+  const dest = path19.join(root, ASSETS_DEST, "avatar.vrm");
+  await fs20.mkdir(path19.dirname(dest), { recursive: true });
+  await fs20.copyFile(path19.join(srcDir, "assets", "default-avatar.vrm"), dest);
   log.dim("  public/assets/avatar.vrm (fallback avatar \u2014 bundled CC0 default)");
 }
 async function exists3(p) {
   try {
-    await fs19.access(p);
+    await fs20.access(p);
     return true;
   } catch {
     return false;
@@ -16957,22 +17098,22 @@ async function context2(opts) {
   const project = await readProject();
   return { token, apiUrl: getApiUrl(opts.apiUrl ?? project?.apiUrl) };
 }
-async function readVideo(path20, log) {
+async function readVideo(path21, log) {
   let bytes;
   try {
-    bytes = await readFile(path20);
+    bytes = await readFile(path21);
   } catch {
-    log.error(`Can't read ${path20}.`);
+    log.error(`Can't read ${path21}.`);
     return null;
   }
   if (bytes.byteLength > MAX_VIDEO_BYTES) {
-    log.error(`${basename(path20)} is ${(bytes.byteLength / 1e6).toFixed(0)} MB \u2014 the limit is ${MAX_VIDEO_BYTES / 1e6} MB.`);
+    log.error(`${basename(path21)} is ${(bytes.byteLength / 1e6).toFixed(0)} MB \u2014 the limit is ${MAX_VIDEO_BYTES / 1e6} MB.`);
     return null;
   }
   return bytes;
 }
-async function uploadVideo(apiUrl, token, characterId, path20, bytes, log) {
-  const contentType = /\.mov$/i.test(path20) ? "video/quicktime" : "video/mp4";
+async function uploadVideo(apiUrl, token, characterId, path21, bytes, log) {
+  const contentType = /\.mov$/i.test(path21) ? "video/quicktime" : "video/mp4";
   const minted = await apiFetch(
     `${apiUrl}/api/characters/${encodeURIComponent(characterId)}/motions/video-url`,
     {
@@ -16987,7 +17128,7 @@ async function uploadVideo(apiUrl, token, characterId, path20, bytes, log) {
     return null;
   }
   const { uploadUrl, videoUrl } = await minted.json();
-  log.dim(`  uploading ${basename(path20)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
+  log.dim(`  uploading ${basename(path21)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
   const put = await fetch(uploadUrl, {
     method: "PUT",
     headers: { "Content-Type": contentType, "Content-Length": String(bytes.byteLength) },
@@ -17303,8 +17444,8 @@ function rank(items, query) {
 }
 
 // src/commands/motion.ts
-import fs20 from "fs/promises";
-import path19 from "path";
+import fs21 from "fs/promises";
+import path20 from "path";
 
 // src/lib/motion/npz.ts
 import zlib from "zlib";
@@ -18555,7 +18696,7 @@ async function motionGen(opts, log) {
   }
   if (opts.constraintsPath !== void 0) {
     try {
-      const raw = await fs20.readFile(opts.constraintsPath, "utf8");
+      const raw = await fs21.readFile(opts.constraintsPath, "utf8");
       generationOptions.constraints = JSON.parse(raw);
     } catch {
       log.error(`Couldn't read the --constraints JSON at ${opts.constraintsPath}.`);
@@ -18579,10 +18720,10 @@ async function motionGen(opts, log) {
 async function expandTakes(selectors) {
   const out = [];
   for (const sel of selectors) {
-    const st = await fs20.stat(sel).catch(() => null);
+    const st = await fs21.stat(sel).catch(() => null);
     if (st?.isDirectory()) {
-      const names = await fs20.readdir(sel);
-      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path19.join(sel, n));
+      const names = await fs21.readdir(sel);
+      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path20.join(sel, n));
     } else if (st?.isFile()) {
       out.push(sel);
     } else {
@@ -18617,7 +18758,7 @@ async function motionVerify(opts, log) {
   let gates = DEFAULT_GATES;
   if (opts.gatesPath) {
     try {
-      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs20.readFile(opts.gatesPath, "utf8")));
+      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs21.readFile(opts.gatesPath, "utf8")));
     } catch {
       log.error(`Couldn't read the --gates JSON at ${opts.gatesPath}.`);
       process.exitCode = 1;
@@ -18639,9 +18780,9 @@ async function motionVerify(opts, log) {
   }
   const reports = [];
   for (const file of files) {
-    const stem = path19.basename(file).replace(/\.npz$/, "");
+    const stem = path20.basename(file).replace(/\.npz$/, "");
     try {
-      reports.push(analyzeTake(stem, await fs20.readFile(file), gates));
+      reports.push(analyzeTake(stem, await fs21.readFile(file), gates));
     } catch (err) {
       reports.push({
         take: stem,
@@ -18679,7 +18820,7 @@ async function motionCompile(opts, log) {
   let cfg = DEFAULT_MOTION_CONFIG;
   if (opts.configPath) {
     try {
-      const patch = JSON.parse(await fs20.readFile(opts.configPath, "utf8"));
+      const patch = JSON.parse(await fs21.readFile(opts.configPath, "utf8"));
       cfg = { ...DEFAULT_MOTION_CONFIG, ...patch, idleLoop: { ...DEFAULT_MOTION_CONFIG.idleLoop, ...patch.idleLoop } };
     } catch {
       log.error(`Couldn't read the --config JSON at ${opts.configPath}.`);
@@ -18697,16 +18838,16 @@ async function motionCompile(opts, log) {
   }
   const inputs = [];
   for (const file of files) {
-    const stem = path19.basename(file).replace(/\.npz$/, "");
+    const stem = path20.basename(file).replace(/\.npz$/, "");
     try {
-      inputs.push({ stem, take: loadTake(await fs20.readFile(file)) });
+      inputs.push({ stem, take: loadTake(await fs21.readFile(file)) });
     } catch (err) {
       log.error(`${stem}: ${err instanceof Error ? err.message : String(err)}`);
       process.exitCode = 1;
       return;
     }
   }
-  const setName = opts.set ?? path19.basename(opts.out).replace(/\.json$/, "");
+  const setName = opts.set ?? path20.basename(opts.out).replace(/\.json$/, "");
   let result;
   try {
     result = compileSet(inputs, setName, cfg);
@@ -18721,9 +18862,9 @@ async function motionCompile(opts, log) {
     process.exitCode = 1;
     return;
   }
-  await fs20.mkdir(path19.dirname(path19.resolve(opts.out)), { recursive: true });
+  await fs21.mkdir(path20.dirname(path20.resolve(opts.out)), { recursive: true });
   const json = JSON.stringify(result.data);
-  await fs20.writeFile(opts.out, json);
+  await fs21.writeFile(opts.out, json);
   if (opts.json) {
     writeJson({ out: opts.out, set: setName, tracks: Object.keys(result.data.gaits), bytes: json.length });
     return;
@@ -18741,9 +18882,9 @@ var MOTION_RUNTIME_FILES = [
 var MOTION_PRESETS = {
   rifle: ["sets/rifle.json", "sets/jumps.json"]
 };
-var MOTION_DEST = path19.join("src", "motion");
+var MOTION_DEST = path20.join("src", "motion");
 async function motionInstall(opts, log) {
-  const srcDir = path19.join(getTemplatesDir(), "motion");
+  const srcDir = path20.join(getTemplatesDir(), "motion");
   const root = opts.cwd ?? process.cwd();
   const preset = opts.set;
   if (preset !== void 0 && !MOTION_PRESETS[preset]) {
@@ -18754,21 +18895,21 @@ async function motionInstall(opts, log) {
   const files = [...MOTION_RUNTIME_FILES, ...preset ? MOTION_PRESETS[preset] : []];
   log.plain(c.bold(`genex motion install${preset ? ` --set ${preset}` : ""}`));
   log.plain("");
-  log.step(`Vendoring the motion runtime into ${c.cyan(MOTION_DEST + path19.sep)}`);
+  log.step(`Vendoring the motion runtime into ${c.cyan(MOTION_DEST + path20.sep)}`);
   let copied = 0, skipped = 0;
   try {
     for (const rel of files) {
-      const dest = path19.join(root, MOTION_DEST, rel);
-      const exists4 = await fs20.access(dest).then(() => true, () => false);
+      const dest = path20.join(root, MOTION_DEST, rel);
+      const exists4 = await fs21.access(dest).then(() => true, () => false);
       if (!opts.force && exists4) {
         skipped++;
-        log.dim(`  skipped ${path19.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
+        log.dim(`  skipped ${path20.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs20.mkdir(path19.dirname(dest), { recursive: true });
-      await fs20.copyFile(path19.join(srcDir, rel), dest);
+      await fs21.mkdir(path20.dirname(dest), { recursive: true });
+      await fs21.copyFile(path20.join(srcDir, rel), dest);
       copied++;
-      log.dim(`  ${path19.join(MOTION_DEST, rel)}`);
+      log.dim(`  ${path20.join(MOTION_DEST, rel)}`);
     }
   } catch (err) {
     log.error(`Copy failed: ${String(err)}`);
@@ -18809,7 +18950,7 @@ async function motionConstraints(opts, log) {
   }
   const doc = directionConstraint(dir, speed, duration);
   const out = opts.out ?? "constraints.json";
-  await fs20.writeFile(out, JSON.stringify(doc));
+  await fs21.writeFile(out, JSON.stringify(doc));
   if (opts.json) {
     writeJson({ out, dir: dirName, speed, duration, waypoints: doc[0].frame_indices.length });
     return;
@@ -18859,6 +19000,11 @@ ${c.bold("Usage")}
   genex link <slug> [options]        Re-link THIS folder to an existing game of yours
                                      (lost folder / new machine); preview/publish then
                                      update the same live game. Never creates a project.
+  genex rename <name> [options]      Rename THIS game \u2014 its play address, its source repo,
+                                     and its gallery name. Keeps the game (plays, likes,
+                                     comments); the OLD address stops working, so a
+                                     published game needs --yes. Rebuild after with
+                                     'genex preview'/'publish'.
   genex list [options]               List your games \u2014 slug, status, and page link for
                                      each. Signs you in if needed; --json for raw data.
                                      Find the slug to reconnect with 'genex link' here.
@@ -18916,13 +19062,18 @@ ${c.bold("Usage")}
                                      enqueued (done/running/queued/failed) \u2014 a single
                                      API refresh, never blocks, never bills.
   genex controller <type> [--force]  Install a bundled controller
-                                     (character|car|drone|touch|networked-physics|quality)
-                                     into src/controllers (+ assets into public/assets).
+                                     (character|car|drone|touch|networked-physics|
+                                     quality|chat|voice) into src/controllers (+ assets
+                                     into public/assets).
                                      "touch" = the standalone mobile touch kit (joystick,
                                      buttons, drag zone, rotate overlay) for games
                                      without a physics controller. "quality" = the
                                      adaptive-quality kit (device tier, runtime governor,
                                      per-tier asset rungs) every game wires at boot.
+                                     "chat" = the room text-chat overlay for multiplayer
+                                     games (transport is room.chat in the SDK).
+                                     "voice" = proximity voice for multiplayer games
+                                     (mesh WebRTC via room.voice; party-sized, max 6).
                                      Character's player body is the game's own generated
                                      character, with a VRM avatar as the fallback.
   genex controller character --character <id>
@@ -19025,6 +19176,12 @@ ${c.bold("Options for `link`")}
                        off to 'genex auth' (default: 100). The code itself stays
                        valid for 15 minutes either way.
 
+${c.bold("Options for `rename`")}
+  <name>               The new name (positional). Slugified the same way init does it.
+  --yes                Confirm retiring the current address (required once published).
+  --env <path>         Token env file (default: ~/.genex/env).
+  --api-url <url>      Override the API base URL.
+
 ${c.bold("Options for `preview` / `publish`")}
   --no-build           Skip the build step; deploy whatever is already built.
   --no-push            (publish) Skip build + push; only flip the gallery flag.
@@ -19132,6 +19289,8 @@ ${c.bold("Examples")}
   genex controller anims sword pistol
   genex controller touch
   genex controller networked-physics
+  genex controller chat
+  genex controller voice
 `;
 function parseArgs(argv) {
   const parsed = {
@@ -19283,6 +19442,9 @@ function parseArgs(argv) {
       case "--force":
         parsed.options.force = true;
         break;
+      case "--yes":
+        parsed.options.yes = true;
+        break;
       case "--list":
         parsed.options.list = true;
         break;
@@ -19677,6 +19839,9 @@ async function main() {
       case "link":
         await runLink(parsed.options);
         break;
+      case "rename":
+        await runRename(parsed.options);
+        break;
       case "list":
         await runList(parsed.options);
         break;