@genex-ai/cli-demo 1.2.3-dev.337 → 1.2.4-dev.342

package/dist/index.js

@@ -933,6 +933,7 @@ async function runAuth(opts) {
 }
 
 // src/commands/init.ts
+import fs10 from "fs/promises";
 import path10 from "path";
 
 // src/lib/copy-templates.ts
@@ -1010,6 +1011,7 @@ Your capabilities (all via \`npx genex \u2026\`): generate \`model\` \xB7 \`skyb
 16. Never add debug-only code to the game to check your own work \u2014 no hidden test modes, no special URL parameters, no forced-visible flags, no auth mocks, no pixel-sampling hooks. \`?genex_local_test=1\` is the platform's own supported mode and is fine; your own bypass is not. (The multiplayer skill's small build identifier, token-free status line, and connected-quorum watchdog are production supportability, not a bypass \u2014 keep those.)
 17. Input directions match their labels: A/\u2190 moves or turns the player screen-LEFT, D/\u2192 screen-RIGHT, mouse-up looks up, and drag-pan axes share ONE convention. The cursor is either the gameplay tool (RTS, card, builder) or locked away during play \u2014 keyboard-only games included. Check it in every milestone's smoke pass.
 18. v0 is a milestone, not the destination. When the ask was bigger than one loop, every milestone after v0 grows back toward the FULL ask with DESIGN.md's content lines as the checklist \u2014 a slice that previewed well never quietly becomes the game. Cosmetics never jump the queue past promised content.
+19. NEVER delete, empty, move, rename, or overwrite anything you did not create yourself. This folder may hold the player's own reference images, notes, sketches, or an earlier attempt \u2014 files that exist nowhere else and have no undo, no trash, no backup. A non-empty folder is normal and is NEVER something to clean up, and "start clean" is never a reason. That rules out \`rm\`/\`rm -rf\`, \`git clean\`, \`git checkout -- .\`, \`git reset --hard\` over their work, deleting to resolve a conflict or a stuck interactive prompt, and every setup tool's offer to empty a directory (\`--force\`, \`--overwrite\`, "Remove existing files") \u2014 scaffold into a fresh subfolder and copy in instead. You may add files and edit the ones you wrote. If a step genuinely cannot continue without removing something of theirs, STOP and ask, naming the exact files, and wait for a yes \u2014 "it looks like junk" is never that yes. This binds hardest during setup, where it runs fast and automatically before the player has asked for anything at all.
 ${CONTRACT_END}
 `;
 var CLAUDE_IMPORT_LINE = "@AGENTS.md";
@@ -1598,10 +1600,39 @@ async function writeGameConfigFiles(meta, log, cwd = process.cwd()) {
 }
 
 // src/commands/init.ts
+var TOOLING_ENTRIES = /* @__PURE__ */ new Set([
+  ".git",
+  ".genex",
+  ".claude",
+  ".codex",
+  ".cursor",
+  ".DS_Store",
+  "node_modules"
+]);
+async function listPreexistingEntries(dir) {
+  try {
+    return (await fs10.readdir(dir)).filter((name) => !TOOLING_ENTRIES.has(name)).sort();
+  } catch {
+    return [];
+  }
+}
+function warnPreexisting(log, entries) {
+  if (entries.length === 0) return;
+  const shown = entries.slice(0, 6).join(", ");
+  const more = entries.length > 6 ? `, \u2026+${entries.length - 6} more` : "";
+  log.plain("");
+  log.warn(`This folder already had files in it before setup \u2014 they are the player's, not yours:`);
+  log.dim(`  ${shown}${more}`);
+  log.dim("  Never clear or overwrite them to start clean. A reference image or note here may");
+  log.dim("  exist nowhere else, and deleting it has no undo \u2014 ask before removing anything.");
+  log.dim('  Answer any "directory is not empty" prompt with Ignore/continue \u2014 never --force,');
+  log.dim('  --overwrite, or "Remove existing files", which empty the whole folder.');
+}
 async function runInit(opts) {
   const log = createLogger({ quiet: opts.quiet });
   log.plain(c.bold("genex init"));
   log.plain("");
+  const preexisting = await listPreexistingEntries(process.cwd());
   await cleanupLegacyGlobalSkills(log);
   const templatesDir = getTemplatesDir();
   const targets = resolveAgentTargets({ dir: opts.dir, agents: opts.agents });
@@ -1715,12 +1746,13 @@ async function runInit(opts) {
   const { path: metaPath } = await writeProject(meta);
   log.dim(`  saved ${c.cyan(metaPath)}`);
   await writeGameConfigFiles(meta, log);
+  warnPreexisting(log, preexisting);
   log.plain("");
   log.success("All set. \u{1F680}");
 }
 
 // src/commands/link.ts
-import fs10 from "fs/promises";
+import fs11 from "fs/promises";
 import path11 from "path";
 async function runLink(opts) {
   const log = createLogger({ quiet: opts.quiet });
@@ -1793,20 +1825,20 @@ async function ensureSlugEnv(slug, log, cwd = process.cwd()) {
   const file = path11.join(cwd, ".env");
   let content;
   try {
-    content = await fs10.readFile(file, "utf8");
+    content = await fs11.readFile(file, "utf8");
   } catch {
     return;
   }
   const re = /^(\s*VITE_GENEX_SLUG=)(.*)$/m;
   const m = content.match(re);
   if (!m) {
-    await fs10.appendFile(file, `${content.endsWith("\n") ? "" : "\n"}VITE_GENEX_SLUG=${slug}
+    await fs11.appendFile(file, `${content.endsWith("\n") ? "" : "\n"}VITE_GENEX_SLUG=${slug}
 `);
     log.dim(`  added VITE_GENEX_SLUG=${slug} to .env`);
     return;
   }
   if (m[2].trim() === slug) return;
-  await fs10.writeFile(file, content.replace(re, `$1${slug}`));
+  await fs11.writeFile(file, content.replace(re, `$1${slug}`));
   log.dim(`  updated .env: VITE_GENEX_SLUG=${slug} (was ${m[2].trim()})`);
 }
 async function fetchOwnProject(apiUrl, token, slug, log) {
@@ -1985,7 +2017,7 @@ function relTime(iso) {
 // src/lib/deploy.ts
 import { spawn as spawn3 } from "child_process";
 import crypto3 from "crypto";
-import fs13 from "fs/promises";
+import fs14 from "fs/promises";
 import os5 from "os";
 import path13 from "path";
 
@@ -2250,12 +2282,12 @@ function tierFor(estVramMb) {
 }
 
 // src/commands/ui.ts
-import fs12 from "fs/promises";
+import fs13 from "fs/promises";
 import path12 from "path";
 import { PNG as PNG2 } from "pngjs";
 
 // src/lib/png-tools.ts
-import fs11 from "fs/promises";
+import fs12 from "fs/promises";
 import { PNG } from "pngjs";
 var ALPHA_TRANSPARENT_MAX = 16;
 var isHttpUrl = (s) => /^https?:\/\//i.test(s);
@@ -2266,12 +2298,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 fs11.readFile(input);
+    buf = await fs12.readFile(input);
   }
   return PNG.sync.read(buf);
 }
 async function writePng(file, png) {
-  await fs11.writeFile(file, PNG.sync.write(png));
+  await fs12.writeFile(file, PNG.sync.write(png));
 }
 function cropPng(image, box) {
   const out = new PNG({ width: box.w, height: box.h });
@@ -2571,7 +2603,7 @@ async function uiExtract(opts, log) {
   const dilatePx = opts.dilate ?? 0;
   const sheet = await loadPng(input);
   const { width: W, height: H, data } = sheet;
-  await fs12.mkdir(outDir, { recursive: true });
+  await fs13.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;
@@ -2819,7 +2851,7 @@ async function uiExtract(opts, log) {
       defringed
     };
     const { name: _n, out: _o, ...sidecarBody } = sidecar;
-    await fs12.writeFile(
+    await fs13.writeFile(
       outPath.replace(/\.png$/i, "") + ".bbox.json",
       JSON.stringify(sidecarBody, null, 2)
     );
@@ -2829,7 +2861,7 @@ async function uiExtract(opts, log) {
     );
   }
   const debugPath = path12.join(outDir, "extract-debug.json");
-  await fs12.writeFile(
+  await fs13.writeFile(
     debugPath,
     JSON.stringify(
       {
@@ -3291,7 +3323,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 fs12.mkdir(outDir, { recursive: true });
+  await fs13.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);
@@ -3395,7 +3427,7 @@ async function uiMasks(opts, log) {
       },
       overlay: overlayPath
     };
-    await fs12.writeFile(metaPath, `${JSON.stringify(meta, null, 2)}
+    await fs13.writeFile(metaPath, `${JSON.stringify(meta, null, 2)}
 `);
     results.push(meta);
     const fb = converted.bbox;
@@ -3412,7 +3444,7 @@ async function uiMasks(opts, log) {
     }
   }
   const indexPath = path12.join(outDir, "annotated-progress.json");
-  await fs12.writeFile(indexPath, `${JSON.stringify({ input, loosened, pairs: results }, null, 2)}
+  await fs13.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}).`);
@@ -3538,7 +3570,7 @@ async function uiTextColor(opts, log) {
   };
   process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
-  if (opts.out) await fs12.writeFile(opts.out, `${JSON.stringify(result, null, 2)}
+  if (opts.out) await fs13.writeFile(opts.out, `${JSON.stringify(result, null, 2)}
 `);
   if (opts.cropPath) log.dim(`  crop \u2192 ${opts.cropPath}`);
 }
@@ -3570,7 +3602,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 fs12.writeFile(
+  await fs13.writeFile(
     sidecarPath,
     JSON.stringify(speckleAllowed ? { ...sidecar, speckleAllowed: true } : sidecar, null, 2)
   );
@@ -3842,7 +3874,7 @@ async function walkFiles(dir) {
   const out = [];
   let entries;
   try {
-    entries = await fs12.readdir(dir, { withFileTypes: true });
+    entries = await fs13.readdir(dir, { withFileTypes: true });
   } catch {
     return out;
   }
@@ -3857,7 +3889,7 @@ async function walkFiles(dir) {
 async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   const viewportFindings = [];
   try {
-    const indexHtml = await fs12.readFile(path12.join(cwd, "index.html"), "utf8");
+    const indexHtml = await fs13.readFile(path12.join(cwd, "index.html"), "utf8");
     if (!/<meta[^>]+name=["']viewport["']/i.test(indexHtml)) {
       viewportFindings.push({
         kind: "viewport-meta",
@@ -3873,7 +3905,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   }
   const absAssets = path12.resolve(cwd, assetDir);
   try {
-    if (!(await fs12.stat(absAssets)).isDirectory()) {
+    if (!(await fs13.stat(absAssets)).isDirectory()) {
       return viewportFindings.length > 0 ? viewportFindings : null;
     }
   } catch {
@@ -3883,7 +3915,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     (p) => AUDIT_SRC_EXTS.has(path12.extname(p).toLowerCase())
   );
   try {
-    for (const name of await fs12.readdir(cwd)) {
+    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));
     }
@@ -3892,7 +3924,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   const sources = [];
   for (const p of srcFiles) {
     try {
-      sources.push({ rel: path12.relative(cwd, p), text: await fs12.readFile(p, "utf8") });
+      sources.push({ rel: path12.relative(cwd, p), text: await fs13.readFile(p, "utf8") });
     } catch {
     }
   }
@@ -3906,7 +3938,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     const metaMatch = /^(.+)\.annotated-progress\.json$/.exec(base);
     if (metaMatch) {
       try {
-        const meta = JSON.parse(await fs12.readFile(p, "utf8"));
+        const meta = JSON.parse(await fs13.readFile(p, "utf8"));
         metaByName.set(metaMatch[1], {
           cleanCrop: meta.clean?.crop ?? null,
           loosened: meta.loosened === true
@@ -3917,7 +3949,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     }
     if (base.endsWith(".bbox.json")) {
       try {
-        const sidecar = JSON.parse(await fs12.readFile(p, "utf8"));
+        const sidecar = JSON.parse(await fs13.readFile(p, "utf8"));
         if (sidecar.sheetBBox) bboxByPng.set(base.replace(/\.bbox\.json$/, ".png"), sidecar.sheetBBox);
       } catch {
       }
@@ -3963,8 +3995,8 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
       let frame;
       let mask;
       try {
-        frame = PNG2.sync.read(await fs12.readFile(framePath));
-        mask = PNG2.sync.read(await fs12.readFile(maskPath));
+        frame = PNG2.sync.read(await fs13.readFile(framePath));
+        mask = PNG2.sync.read(await fs13.readFile(maskPath));
       } catch {
         continue;
       }
@@ -3983,7 +4015,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     if (!referenced(base)) continue;
     let png;
     try {
-      png = PNG2.sync.read(await fs12.readFile(p));
+      png = PNG2.sync.read(await fs13.readFile(p));
     } catch {
       continue;
     }
@@ -4156,7 +4188,7 @@ async function printUiAuditPreflight(log) {
 }
 async function printPipelineStatePreflight(log, cwd = process.cwd()) {
   try {
-    const design = await fs13.readFile(path13.join(cwd, "DESIGN.md"), "utf8").catch(() => "");
+    const design = await fs14.readFile(path13.join(cwd, "DESIGN.md"), "utf8").catch(() => "");
     const warnings = [];
     if (design.length > 0 && !/##\s*build plan & status/i.test(design)) {
       warnings.push(
@@ -4164,7 +4196,7 @@ async function printPipelineStatePreflight(log, cwd = process.cwd()) {
       );
     }
     if (!/player character:/i.test(design)) {
-      const hasCharacter = await fs13.access(path13.join(cwd, "public", "assets", "meshy-character.json")).then(() => true, () => false);
+      const hasCharacter = await fs14.access(path13.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).`
@@ -4178,12 +4210,12 @@ async function printPipelineStatePreflight(log, cwd = process.cwd()) {
 async function loadsPlayerBody(cwd) {
   const BODY_LOADERS = /\bloadPlayerCharacter\s*\(|\bloadVrm(?:Clone)?\s*\(/;
   try {
-    const entries = await fs13.readdir(path13.join(cwd, "src"), { recursive: true });
+    const entries = await fs14.readdir(path13.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 (!/\.(ts|tsx|js|jsx)$/.test(rel)) continue;
-      const text = await fs13.readFile(path13.join(cwd, "src", rel), "utf8").catch(() => "");
+      const text = await fs14.readFile(path13.join(cwd, "src", rel), "utf8").catch(() => "");
       if (BODY_LOADERS.test(text)) return true;
     }
   } catch {
@@ -4276,7 +4308,7 @@ async function deployGame(ctx, opts, log) {
 }
 async function hasBuildScript(cwd) {
   try {
-    const pkg = JSON.parse(await fs13.readFile(path13.join(cwd, "package.json"), "utf8"));
+    const pkg = JSON.parse(await fs14.readFile(path13.join(cwd, "package.json"), "utf8"));
     return Boolean(pkg.scripts?.build);
   } catch {
     return false;
@@ -4285,12 +4317,12 @@ async function hasBuildScript(cwd) {
 async function collectFiles(root) {
   const out = [];
   const walk2 = async (dir, prefix) => {
-    for (const e of await fs13.readdir(dir, { withFileTypes: true })) {
+    for (const e of await fs14.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);
       } else if (e.isFile() && !isSecretEnvFile(e.name)) {
-        out.push({ relPath, bytes: await fs13.readFile(path13.join(dir, e.name)) });
+        out.push({ relPath, bytes: await fs14.readFile(path13.join(dir, e.name)) });
       }
     }
   };
@@ -4528,7 +4560,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 fs13.mkdtemp(path13.join(os5.tmpdir(), "genex-source-"));
+  const gitDir = await fs14.mkdtemp(path13.join(os5.tmpdir(), "genex-source-"));
   const base = { GIT_DIR: gitDir };
   if (urlHasEmbeddedCredentials(pushUrl)) {
     base.GIT_CONFIG_COUNT = "1";
@@ -4543,7 +4575,7 @@ async function pushWorktree(cwd, pushUrl, managed, log, branch = "main") {
   };
   try {
     if ((await run("git", ["init", "-q"], base)).code !== 0) return failed();
-    await fs13.writeFile(
+    await fs14.writeFile(
       path13.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")
@@ -4599,7 +4631,7 @@ async function pushWorktree(cwd, pushUrl, managed, log, branch = "main") {
   } catch {
     return failed();
   } finally {
-    await fs13.rm(gitDir, { recursive: true, force: true }).catch(() => {
+    await fs14.rm(gitDir, { recursive: true, force: true }).catch(() => {
     });
   }
 }
@@ -4635,7 +4667,7 @@ async function fetchPushUrl(ctx, log) {
 }
 async function isDir2(p) {
   try {
-    return (await fs13.stat(p)).isDirectory();
+    return (await fs14.stat(p)).isDirectory();
   } catch {
     return false;
   }
@@ -4770,17 +4802,17 @@ async function promoteBuild(apiUrl, projectId, token, log) {
 }
 
 // src/lib/detect-features.ts
-import fs15 from "fs/promises";
+import fs16 from "fs/promises";
 import path15 from "path";
 
 // src/lib/generation-ledger.ts
-import fs14 from "fs/promises";
+import fs15 from "fs/promises";
 import path14 from "path";
 var ledgerPath = (cwd) => path14.join(cwd, ".genex", "generations.ndjson");
 async function append(cwd, event) {
   try {
-    await fs14.access(path14.join(cwd, ".genex"));
-    await fs14.appendFile(ledgerPath(cwd), `${JSON.stringify(event)}
+    await fs15.access(path14.join(cwd, ".genex"));
+    await fs15.appendFile(ledgerPath(cwd), `${JSON.stringify(event)}
 `, "utf8");
   } catch {
   }
@@ -4788,7 +4820,7 @@ async function append(cwd, event) {
 async function readLedger(cwd = process.cwd()) {
   let raw;
   try {
-    raw = await fs14.readFile(ledgerPath(cwd), "utf8");
+    raw = await fs15.readFile(ledgerPath(cwd), "utf8");
   } catch {
     return [];
   }
@@ -4842,7 +4874,7 @@ async function countFailed(kind, cwd = process.cwd()) {
 // src/lib/detect-features.ts
 async function detectEmbedSdkVersion(cwd = process.cwd()) {
   try {
-    const raw = await fs15.readFile(path15.join(cwd, "package.json"), "utf8");
+    const raw = await fs16.readFile(path15.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;
@@ -4852,7 +4884,7 @@ async function detectEmbedSdkVersion(cwd = process.cwd()) {
 }
 async function detectMultiplayer(cwd = process.cwd()) {
   try {
-    const raw = await fs15.readFile(path15.join(cwd, "package.json"), "utf8");
+    const raw = await fs16.readFile(path15.join(cwd, "package.json"), "utf8");
     const pkg = JSON.parse(raw);
     return Boolean(
       pkg.dependencies?.["@genex-ai/multiplayer"] ?? pkg.devDependencies?.["@genex-ai/multiplayer"]
@@ -4864,7 +4896,7 @@ async function detectMultiplayer(cwd = process.cwd()) {
 async function detectMatchmaking(log, cwd = process.cwd()) {
   let pkg;
   try {
-    pkg = JSON.parse(await fs15.readFile(path15.join(cwd, "package.json"), "utf8"));
+    pkg = JSON.parse(await fs16.readFile(path15.join(cwd, "package.json"), "utf8"));
   } catch (err) {
     log.dim(`  (skipping matchmaking \u2014 couldn't read package.json: ${String(err)})`);
     return null;
@@ -4882,7 +4914,7 @@ 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 fs15.readFile(path15.join(cwd, "package.json"), "utf8");
+    const raw = await fs16.readFile(path15.join(cwd, "package.json"), "utf8");
     const pkg = JSON.parse(raw);
     if (pkg.genex?.mobileControls === true) return true;
   } catch {
@@ -4890,7 +4922,7 @@ async function detectMobileControls(cwd = process.cwd()) {
   const srcDir = path15.join(cwd, "src");
   let entries;
   try {
-    entries = await fs15.readdir(srcDir, { recursive: true });
+    entries = await fs16.readdir(srcDir, { recursive: true });
   } catch {
     return false;
   }
@@ -4898,7 +4930,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 fs15.readFile(path15.join(srcDir, rel), "utf8");
+      const content = await fs16.readFile(path15.join(srcDir, rel), "utf8");
       if (TOUCH_KIT_MARKERS.test(content)) return true;
     } catch {
     }
@@ -4910,7 +4942,7 @@ async function detectGameStateUsage(cwd = process.cwd()) {
   const srcDir = path15.join(cwd, "src");
   let entries;
   try {
-    entries = await fs15.readdir(srcDir, { recursive: true });
+    entries = await fs16.readdir(srcDir, { recursive: true });
   } catch {
     return false;
   }
@@ -4918,7 +4950,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 fs15.readFile(path15.join(srcDir, rel), "utf8");
+      const content = await fs16.readFile(path15.join(srcDir, rel), "utf8");
       if (GAME_STATE_CALLS.test(content)) return true;
     } catch {
     }
@@ -4970,14 +5002,14 @@ async function detectSurfaceScan(cwd = process.cwd()) {
   const srcDir = path15.join(cwd, "src");
   let entries;
   try {
-    entries = await fs15.readdir(srcDir, { recursive: true });
+    entries = await fs16.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 fs15.readFile(path15.join(srcDir, nativeRel), "utf8").catch(() => "");
+    const raw = await fs16.readFile(path15.join(srcDir, nativeRel), "utf8").catch(() => "");
     if (!raw) continue;
     const rel = nativeRel.split(path15.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));
@@ -5037,12 +5069,12 @@ async function detectGenerationAudit(cwd = process.cwd()) {
   let haystack = "";
   const read = async (file) => {
     try {
-      haystack += await fs15.readFile(file, "utf8");
+      haystack += await fs16.readFile(file, "utf8");
     } catch {
     }
   };
   try {
-    for (const entry of await fs15.readdir(cwd, { withFileTypes: true })) {
+    for (const entry of await fs16.readdir(cwd, { withFileTypes: true })) {
       if (entry.isFile() && /\.(ts|tsx|js|jsx|css|html|json)$/.test(entry.name)) {
         await read(path15.join(cwd, entry.name));
       }
@@ -5051,7 +5083,7 @@ async function detectGenerationAudit(cwd = process.cwd()) {
   }
   for (const sub of ["src", "public"]) {
     try {
-      const entries = await fs15.readdir(path15.join(cwd, sub), { recursive: true });
+      const entries = await fs16.readdir(path15.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;
@@ -5187,7 +5219,7 @@ async function borrowEvidence(meta, cwd) {
   } catch {
     return true;
   }
-  const gitConfig = await fs15.readFile(path15.join(cwd, ".git", "config"), "utf8").catch(() => "");
+  const gitConfig = await fs16.readFile(path15.join(cwd, ".git", "config"), "utf8").catch(() => "");
   for (const m of gitConfig.matchAll(/url\s*=\s*(\S+)/g)) {
     try {
       const u = new URL(m[1]);
@@ -5195,7 +5227,7 @@ async function borrowEvidence(meta, cwd) {
     } catch {
     }
   }
-  const readme = await fs15.readFile(path15.join(cwd, "README.md"), "utf8").catch(() => "");
+  const readme = await fs16.readFile(path15.join(cwd, "README.md"), "utf8").catch(() => "");
   return readme.includes(host) || /\b(upstream|originally by|ported from|borrowed from)\b/i.test(readme);
 }
 
@@ -5445,7 +5477,7 @@ async function runPromote(opts) {
 }
 
 // src/commands/generate.ts
-import fs16 from "fs/promises";
+import fs17 from "fs/promises";
 import path16 from "path";
 import { PNG as PNG4 } from "pngjs";
 
@@ -5616,7 +5648,7 @@ var isRemoteRef = (value) => /^(https?:\/\/|data:)/i.test(value);
 async function inlineLocalImage(filePath, flag) {
   let bytes;
   try {
-    bytes = await fs16.readFile(filePath);
+    bytes = await fs17.readFile(filePath);
   } catch {
     return { ok: false, error: `Couldn't read the ${flag} file at ${filePath}.` };
   }
@@ -5822,7 +5854,7 @@ async function runGenerate(kind, opts) {
       return;
     }
     try {
-      const bytes = await fs16.readFile(opts.inpaintUrl);
+      const bytes = await fs17.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}.`);
@@ -5946,7 +5978,7 @@ async function reportGlassTerminal(view, outDir, log, json) {
     return;
   }
   await recordTerminal(view.id, "completed", files.map((f) => f.url));
-  await fs16.mkdir(outDir, { recursive: true });
+  await fs17.mkdir(outDir, { recursive: true });
   const solved = [];
   for (let i = 0; i < files.length; i++) {
     const f = files[i];
@@ -5979,7 +6011,7 @@ async function reportGlassTerminal(view, outDir, log, json) {
       continue;
     }
     const outPath = path16.join(outDir, `glass-${i + 1}.png`);
-    await fs16.writeFile(outPath, PNG4.sync.write(r.png));
+    await fs17.writeFile(outPath, PNG4.sync.write(r.png));
     solved.push({
       path: outPath,
       url: f.url,
@@ -6573,7 +6605,7 @@ async function toRow(e, v, cwd) {
 }
 
 // src/commands/controller.ts
-import fs18 from "fs/promises";
+import fs19 from "fs/promises";
 import path18 from "path";
 
 // ../../packages/meshy-animation-catalog/src/index.ts
@@ -15704,7 +15736,7 @@ function searchMeshyAnimations(query, options = {}) {
 }
 
 // src/lib/anims.ts
-import fs17 from "fs/promises";
+import fs18 from "fs/promises";
 import path17 from "path";
 var ANIMS_DEST = path17.join("public", "assets", "anims");
 var HIDDEN_TAG = "reference";
@@ -15734,7 +15766,7 @@ async function runAnims(opts) {
   const destDir = path17.join(root, ANIMS_DEST);
   const gameManifestPath = path17.join(destDir, "manifest.json");
   if (opts.reset) {
-    await fs17.rm(destDir, { recursive: true, force: true });
+    await fs18.rm(destDir, { recursive: true, force: true });
     log.step(`Cleared ${c.cyan(ANIMS_DEST + path17.sep)} (--reset)`);
   }
   if (selectors.length === 0) {
@@ -15777,8 +15809,8 @@ async function runAnims(opts) {
     opts.cacheDir ?? getAnimsCacheDir(),
     `${manifest.library}-v${manifest.version}`
   );
-  await fs17.mkdir(cacheDir, { recursive: true });
-  await fs17.mkdir(destDir, { recursive: true });
+  await fs18.mkdir(cacheDir, { recursive: true });
+  await fs18.mkdir(destDir, { recursive: true });
   const base = getAnimsBase(opts.animsBase);
   let installedCount = 0;
   let presentCount = 0;
@@ -15796,9 +15828,9 @@ async function runAnims(opts) {
         const res = await fetch(base + entry.file);
         if (!res.ok) throw new Error(`HTTP ${res.status}`);
         const buf = Buffer.from(await res.arrayBuffer());
-        await fs17.writeFile(cached, buf);
+        await fs18.writeFile(cached, buf);
       }
-      await fs17.copyFile(cached, dest);
+      await fs18.copyFile(cached, dest);
       installedCount++;
       addedBytes += entry.bytes;
       log.dim(`  ${path17.join(ANIMS_DEST, entry.file)} (${formatMb(entry.bytes)})`);
@@ -15817,7 +15849,7 @@ async function runAnims(opts) {
     version: manifest.version,
     clips: [...union].sort((a, b) => a.localeCompare(b))
   };
-  await fs17.writeFile(gameManifestPath, JSON.stringify(gameManifest, null, 2) + "\n");
+  await fs18.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`);
@@ -15856,7 +15888,7 @@ async function loadManifest(baseOverride) {
   } catch {
   }
   const snapshotPath = path17.join(getTemplatesDir(), "controllers", "assets", "anims-manifest.json");
-  const manifest = JSON.parse(await fs17.readFile(snapshotPath, "utf8"));
+  const manifest = JSON.parse(await fs18.readFile(snapshotPath, "utf8"));
   return { manifest, source: "snapshot" };
 }
 function resolveSelectors(manifest, selectors) {
@@ -15974,21 +16006,21 @@ function printCatalog(log, manifest, selectors) {
 }
 async function readGameManifest(file) {
   try {
-    return JSON.parse(await fs17.readFile(file, "utf8"));
+    return JSON.parse(await fs18.readFile(file, "utf8"));
   } catch {
     return null;
   }
 }
 async function hasSize(file, bytes) {
   try {
-    return (await fs17.stat(file)).size === bytes;
+    return (await fs18.stat(file)).size === bytes;
   } catch {
     return false;
   }
 }
 async function exists2(p) {
   try {
-    await fs17.access(p);
+    await fs18.access(p);
     return true;
   } catch {
     return false;
@@ -16198,8 +16230,8 @@ async function runController(opts) {
         log.dim(`  skipped ${file.rel} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs18.mkdir(path18.dirname(dest), { recursive: true });
-      await fs18.copyFile(path18.join(srcDir, file.from), dest);
+      await fs19.mkdir(path18.dirname(dest), { recursive: true });
+      await fs19.copyFile(path18.join(srcDir, file.from), dest);
       copied++;
       log.dim(`  ${file.rel}`);
     }
@@ -16285,8 +16317,8 @@ async function installMeshyCharacterManifest(args) {
   }
   assertCompleteMeshyControllerPack(manifest);
   const destination = path18.join(args.root, ASSETS_DEST, "meshy-character.json");
-  await fs18.mkdir(path18.dirname(destination), { recursive: true });
-  await fs18.writeFile(
+  await fs19.mkdir(path18.dirname(destination), { recursive: true });
+  await fs19.writeFile(
     destination,
     `${JSON.stringify(manifest, null, 2)}
 `
@@ -16425,13 +16457,13 @@ function assertCompleteMeshyControllerPack(manifest) {
 async function installFallbackAvatar(args) {
   const { root, srcDir, log } = args;
   const dest = path18.join(root, ASSETS_DEST, "avatar.vrm");
-  await fs18.mkdir(path18.dirname(dest), { recursive: true });
-  await fs18.copyFile(path18.join(srcDir, "assets", "default-avatar.vrm"), dest);
+  await fs19.mkdir(path18.dirname(dest), { recursive: true });
+  await fs19.copyFile(path18.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 fs18.access(p);
+    await fs19.access(p);
     return true;
   } catch {
     return false;
@@ -17271,7 +17303,7 @@ function rank(items, query) {
 }
 
 // src/commands/motion.ts
-import fs19 from "fs/promises";
+import fs20 from "fs/promises";
 import path19 from "path";
 
 // src/lib/motion/npz.ts
@@ -18523,7 +18555,7 @@ async function motionGen(opts, log) {
   }
   if (opts.constraintsPath !== void 0) {
     try {
-      const raw = await fs19.readFile(opts.constraintsPath, "utf8");
+      const raw = await fs20.readFile(opts.constraintsPath, "utf8");
       generationOptions.constraints = JSON.parse(raw);
     } catch {
       log.error(`Couldn't read the --constraints JSON at ${opts.constraintsPath}.`);
@@ -18547,9 +18579,9 @@ async function motionGen(opts, log) {
 async function expandTakes(selectors) {
   const out = [];
   for (const sel of selectors) {
-    const st = await fs19.stat(sel).catch(() => null);
+    const st = await fs20.stat(sel).catch(() => null);
     if (st?.isDirectory()) {
-      const names = await fs19.readdir(sel);
+      const names = await fs20.readdir(sel);
       for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path19.join(sel, n));
     } else if (st?.isFile()) {
       out.push(sel);
@@ -18585,7 +18617,7 @@ async function motionVerify(opts, log) {
   let gates = DEFAULT_GATES;
   if (opts.gatesPath) {
     try {
-      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs19.readFile(opts.gatesPath, "utf8")));
+      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs20.readFile(opts.gatesPath, "utf8")));
     } catch {
       log.error(`Couldn't read the --gates JSON at ${opts.gatesPath}.`);
       process.exitCode = 1;
@@ -18609,7 +18641,7 @@ async function motionVerify(opts, log) {
   for (const file of files) {
     const stem = path19.basename(file).replace(/\.npz$/, "");
     try {
-      reports.push(analyzeTake(stem, await fs19.readFile(file), gates));
+      reports.push(analyzeTake(stem, await fs20.readFile(file), gates));
     } catch (err) {
       reports.push({
         take: stem,
@@ -18647,7 +18679,7 @@ async function motionCompile(opts, log) {
   let cfg = DEFAULT_MOTION_CONFIG;
   if (opts.configPath) {
     try {
-      const patch = JSON.parse(await fs19.readFile(opts.configPath, "utf8"));
+      const patch = JSON.parse(await fs20.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}.`);
@@ -18667,7 +18699,7 @@ async function motionCompile(opts, log) {
   for (const file of files) {
     const stem = path19.basename(file).replace(/\.npz$/, "");
     try {
-      inputs.push({ stem, take: loadTake(await fs19.readFile(file)) });
+      inputs.push({ stem, take: loadTake(await fs20.readFile(file)) });
     } catch (err) {
       log.error(`${stem}: ${err instanceof Error ? err.message : String(err)}`);
       process.exitCode = 1;
@@ -18689,9 +18721,9 @@ async function motionCompile(opts, log) {
     process.exitCode = 1;
     return;
   }
-  await fs19.mkdir(path19.dirname(path19.resolve(opts.out)), { recursive: true });
+  await fs20.mkdir(path19.dirname(path19.resolve(opts.out)), { recursive: true });
   const json = JSON.stringify(result.data);
-  await fs19.writeFile(opts.out, json);
+  await fs20.writeFile(opts.out, json);
   if (opts.json) {
     writeJson({ out: opts.out, set: setName, tracks: Object.keys(result.data.gaits), bytes: json.length });
     return;
@@ -18727,14 +18759,14 @@ async function motionInstall(opts, log) {
   try {
     for (const rel of files) {
       const dest = path19.join(root, MOTION_DEST, rel);
-      const exists4 = await fs19.access(dest).then(() => true, () => false);
+      const exists4 = await fs20.access(dest).then(() => true, () => false);
       if (!opts.force && exists4) {
         skipped++;
         log.dim(`  skipped ${path19.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs19.mkdir(path19.dirname(dest), { recursive: true });
-      await fs19.copyFile(path19.join(srcDir, rel), dest);
+      await fs20.mkdir(path19.dirname(dest), { recursive: true });
+      await fs20.copyFile(path19.join(srcDir, rel), dest);
       copied++;
       log.dim(`  ${path19.join(MOTION_DEST, rel)}`);
     }
@@ -18777,7 +18809,7 @@ async function motionConstraints(opts, log) {
   }
   const doc = directionConstraint(dir, speed, duration);
   const out = opts.out ?? "constraints.json";
-  await fs19.writeFile(out, JSON.stringify(doc));
+  await fs20.writeFile(out, JSON.stringify(doc));
   if (opts.json) {
     writeJson({ out, dir: dirName, speed, duration, waypoints: doc[0].frame_indices.length });
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.2.3-dev.337",
+  "version": "1.2.4-dev.342",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/skills/genex-getting-started/SKILL.md

@@ -74,6 +74,23 @@ the game is ready — players should never stare at a black screen. This is a
 recommendation, not a rule: even a one-line "Loading…" overlay over the dark
 page background is enough.
 
+## The folder's existing files are the user's
+
+Whatever was in this folder before setup belongs to the user — reference
+images, notes, sketches, an earlier attempt, files an agent won't recognize.
+They may exist nowhere else, and deleting one has no undo. So: add files, edit
+the ones you created, and never delete, empty, move, rename, or overwrite
+anything you didn't. A non-empty folder is normal and is never something to
+fix, and "start clean" is never a reason.
+
+That rules out `rm -rf`, `git clean`, `git checkout -- .`, `git reset --hard`
+over the user's work, and every scaffolder's offer to empty the directory
+(`--force`, `--overwrite`, "Remove existing files") — answer a "directory is
+not empty" prompt with Ignore/continue, or scaffold into a fresh subfolder and
+copy across what's missing. If a step genuinely cannot continue without
+removing something of theirs, stop and ask, naming the exact files, and wait
+for a yes. This is law 19 of the build contract in the project's `AGENTS.md`.
+
 ## Remixing an existing game
 
 If the project folder already contains a game (a remix or any existing