@genex-ai/cli-demo 1.24.0-dev.615 → 1.25.1-dev.617

package/dist/index.js

@@ -5774,11 +5774,87 @@ async function promoteBuild(apiUrl, projectId, token, log) {
 }
 
 // src/lib/detect-features.ts
+import fs16 from "fs/promises";
+import path15 from "path";
+
+// src/lib/download-assets.ts
 import fs15 from "fs/promises";
 import path14 from "path";
+var RUNG_ROLE = /@\d+$/;
+function isPrimaryRole(role) {
+  return !RUNG_ROLE.test(role);
+}
+function primaryFiles(files) {
+  return files.filter((f) => isPrimaryRole(f.role));
+}
+function localAssetStem(kind, prompt, id) {
+  const slug = prompt.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40).replace(/-+$/, "");
+  return `${slug || kind}-${id.slice(0, 8)}`;
+}
+function localAssetName(kind, prompt, id, file, multi) {
+  const base = localAssetStem(kind, prompt, id);
+  const role = multi ? `-${file.role.replace(/^(texture|image|character|model|model_anim|model-anim)-/, "")}` : "";
+  const ext = file.ext.replace(/^\./, "") || "bin";
+  return `${base}${role}.${ext}`;
+}
+async function downloadAssets(files, opts) {
+  const wanted = primaryFiles(files);
+  const result = { saved: [], failures: [] };
+  if (wanted.length === 0) return result;
+  try {
+    await fs15.mkdir(opts.outDir, { recursive: true });
+  } catch (err) {
+    result.failures.push(
+      `couldn't create ${opts.outDir} (${err instanceof Error ? err.message : String(err)})`
+    );
+    return result;
+  }
+  const multi = wanted.length > 1;
+  for (const file of wanted) {
+    const dest = path14.join(opts.outDir, localAssetName(opts.kind, opts.prompt, opts.id, file, multi));
+    try {
+      const res = await fetch(file.url);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      const buf = Buffer.from(await res.arrayBuffer());
+      await fs15.writeFile(dest, buf);
+      result.saved.push({ role: file.role, path: dest, url: file.url, bytes: buf.byteLength });
+    } catch (err) {
+      result.failures.push(
+        `${file.role}: ${err instanceof Error ? err.message : String(err)} \u2014 the asset is still live at ${file.url}`
+      );
+    }
+  }
+  return result;
+}
+function formatBytes(bytes) {
+  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+  if (bytes >= 1024) return `${Math.round(bytes / 1024)} KB`;
+  return `${bytes} B`;
+}
+var DEFAULT_ASSET_DIR = "./assets";
+function localDeliveryFor(mode, opts, prompt) {
+  if (mode !== "tools" || opts.noDownload) return void 0;
+  return { outDir: opts.outDir ?? DEFAULT_ASSET_DIR, prompt };
+}
+async function undeliveredFiles(files, opts) {
+  const wanted = primaryFiles(files);
+  const multi = wanted.length > 1;
+  const missing = [];
+  for (const file of wanted) {
+    const dest = path14.join(opts.outDir, localAssetName(opts.kind, opts.prompt, opts.id, file, multi));
+    try {
+      await fs15.access(dest);
+    } catch {
+      missing.push(file);
+    }
+  }
+  return missing;
+}
+
+// src/lib/detect-features.ts
 async function detectEmbedSdkVersion(cwd = process.cwd()) {
   try {
-    const raw = await fs15.readFile(path14.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;
@@ -5788,7 +5864,7 @@ async function detectEmbedSdkVersion(cwd = process.cwd()) {
 }
 async function detectMultiplayer(cwd = process.cwd()) {
   try {
-    const raw = await fs15.readFile(path14.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"]
@@ -5800,7 +5876,7 @@ async function detectMultiplayer(cwd = process.cwd()) {
 async function detectMatchmaking(log, cwd = process.cwd()) {
   let pkg;
   try {
-    pkg = JSON.parse(await fs15.readFile(path14.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;
@@ -5818,15 +5894,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 fs15.readFile(path14.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 {
   }
-  const srcDir = path14.join(cwd, "src");
+  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;
   }
@@ -5834,7 +5910,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(path14.join(srcDir, rel), "utf8");
+      const content = await fs16.readFile(path15.join(srcDir, rel), "utf8");
       if (TOUCH_KIT_MARKERS.test(content)) return true;
     } catch {
     }
@@ -5843,10 +5919,10 @@ async function detectMobileControls(cwd = process.cwd()) {
 }
 var GAME_STATE_CALLS = /savePlayerState|saveWorldState|submitScore/;
 async function detectGameStateUsage(cwd = process.cwd()) {
-  const srcDir = path14.join(cwd, "src");
+  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;
   }
@@ -5854,7 +5930,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(path14.join(srcDir, rel), "utf8");
+      const content = await fs16.readFile(path15.join(srcDir, rel), "utf8");
       if (GAME_STATE_CALLS.test(content)) return true;
     } catch {
     }
@@ -5904,20 +5980,20 @@ var LOOP_START = /\b(?:requestAnimationFrame|setAnimationLoop)\s*\((?!\s*null\b)
 var INIT_EMBED_CALL = /\binitEmbed\s*\(/;
 async function detectEmbedBoot(cwd = process.cwd()) {
   const found = { awaitsIdentity: [], callsInitEmbed: false, rendererAfterAwait: [], loopAfterAwait: [] };
-  const srcDir = path14.join(cwd, "src");
+  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 (nativeRel.split(path14.sep)[0] === "controllers") continue;
+    if (nativeRel.split(path15.sep)[0] === "controllers") continue;
     if (!/\.(ts|js|mts|mjs|tsx|jsx)$/.test(nativeRel)) continue;
-    const raw = await fs15.readFile(path14.join(srcDir, nativeRel), "utf8").catch(() => "");
+    const raw = await fs16.readFile(path15.join(srcDir, nativeRel), "utf8").catch(() => "");
     if (!raw) continue;
-    const rel = nativeRel.split(path14.sep).join("/");
+    const rel = nativeRel.split(path15.sep).join("/");
     const content = blankComments(raw);
     if (INIT_EMBED_CALL.test(content)) found.callsInitEmbed = true;
     const awaits = [];
@@ -6012,19 +6088,19 @@ async function detectSurfaceScan(cwd = process.cwd()) {
     deferredAudioContext: [],
     usesThree: false
   };
-  const srcDir = path14.join(cwd, "src");
+  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(path14.join(srcDir, nativeRel), "utf8").catch(() => "");
+    const raw = await fs16.readFile(path15.join(srcDir, nativeRel), "utf8").catch(() => "");
     if (!raw) continue;
-    const rel = nativeRel.split(path14.sep).join("/");
+    const rel = nativeRel.split(path15.sep).join("/");
     const content = blankComments(raw);
     const repeatRe = /\.repeat\.set\(\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)\s*\)/g;
     let m;
@@ -6116,28 +6192,28 @@ async function detectGenerationAudit(cwd = process.cwd()) {
   let haystack = "";
   const read = async (file) => {
     try {
-      const raw = await fs15.readFile(file, "utf8");
-      const ext = path14.extname(file).toLowerCase();
+      const raw = await fs16.readFile(file, "utf8");
+      const ext = path15.extname(file).toLowerCase();
       if (ext === ".txt") return;
       haystack += ext === ".ts" || ext === ".tsx" || ext === ".js" || ext === ".jsx" || ext === ".css" ? blankComments(raw) : ext === ".html" ? raw.replace(/<!--[\s\S]*?-->/g, (m) => m.replace(/[^\n]/g, " ")) : raw;
     } 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(path14.join(cwd, entry.name));
+        await read(path15.join(cwd, entry.name));
       }
     }
   } catch {
   }
   for (const sub of ["src", "public"]) {
     try {
-      const entries = await fs15.readdir(path14.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;
-        await read(path14.join(cwd, sub, rel));
+        await read(path15.join(cwd, sub, rel));
       }
     } catch {
     }
@@ -6149,20 +6225,21 @@ async function detectGenerationAudit(cwd = process.cwd()) {
   });
   const now = Date.now();
   const stale = (e) => e.status === "queued" && now - Date.parse(e.queuedAt) > UNPICKED_AFTER_MS;
+  const wired = (e) => haystack.includes(e.id) || haystack.includes(localAssetStem(e.kind, e.prompt, e.id));
   return {
-    unwired: audited.filter((e) => e.status === "completed" && !haystack.includes(e.id)).map(ref),
-    unpicked: audited.filter((e) => stale(e) && !haystack.includes(e.id)).map(ref),
+    unwired: audited.filter((e) => e.status === "completed" && !wired(e)).map(ref),
+    unpicked: audited.filter((e) => stale(e) && !wired(e)).map(ref),
     // Wired in but never picked up: the deterministic URL let the agent wire
     // the asset before it finished, so nobody ever learned whether it DID
     // finish — a provider-side failure (credits, moderation) leaves a dead URL
     // that renders as a silently missing asset. Kept separate from `unpicked`
     // because the fix is a status check, not wiring.
-    unresolved: audited.filter((e) => stale(e) && haystack.includes(e.id)).map(ref),
+    unresolved: audited.filter((e) => stale(e) && wired(e)).map(ref),
     // Known-failed AND still wired: the worst case, and it must keep firing
     // AFTER the status check converges the ledger to "failed" (otherwise the
     // audit self-erases the moment the agent runs the recommended command and
     // the dead URL ships silently anyway).
-    deadWired: audited.filter((e) => e.status === "failed" && haystack.includes(e.id)).map(ref),
+    deadWired: audited.filter((e) => e.status === "failed" && wired(e)).map(ref),
     // One regex covers the HTML/JSX attribute and the DOM-built input alike,
     // since `.type = "range"` contains `type = "range"`.
     musicNoSlider: audited.some((e) => e.kind === "music" && e.status === "completed") && !/type\s*=\s*["'`]range["'`]/.test(haystack)
@@ -6307,7 +6384,7 @@ async function borrowEvidence(meta, cwd) {
   } catch {
     return true;
   }
-  const gitConfig = await fs15.readFile(path14.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]);
@@ -6315,7 +6392,7 @@ async function borrowEvidence(meta, cwd) {
     } catch {
     }
   }
-  const readme = await fs15.readFile(path14.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);
 }
 
@@ -6964,63 +7041,6 @@ function ceilingVerdict(input) {
   return { allow: true };
 }
 
-// src/lib/download-assets.ts
-import fs16 from "fs/promises";
-import path15 from "path";
-var RUNG_ROLE = /@\d+$/;
-function isPrimaryRole(role) {
-  return !RUNG_ROLE.test(role);
-}
-function primaryFiles(files) {
-  return files.filter((f) => isPrimaryRole(f.role));
-}
-function localAssetName(kind, prompt, id, file, multi) {
-  const slug = prompt.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40).replace(/-+$/, "");
-  const base = `${slug || kind}-${id.slice(0, 8)}`;
-  const role = multi ? `-${file.role.replace(/^(texture|image|character|model|model_anim|model-anim)-/, "")}` : "";
-  const ext = file.ext.replace(/^\./, "") || "bin";
-  return `${base}${role}.${ext}`;
-}
-async function downloadAssets(files, opts) {
-  const wanted = primaryFiles(files);
-  const result = { saved: [], failures: [] };
-  if (wanted.length === 0) return result;
-  try {
-    await fs16.mkdir(opts.outDir, { recursive: true });
-  } catch (err) {
-    result.failures.push(
-      `couldn't create ${opts.outDir} (${err instanceof Error ? err.message : String(err)})`
-    );
-    return result;
-  }
-  const multi = wanted.length > 1;
-  for (const file of wanted) {
-    const dest = path15.join(opts.outDir, localAssetName(opts.kind, opts.prompt, opts.id, file, multi));
-    try {
-      const res = await fetch(file.url);
-      if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      const buf = Buffer.from(await res.arrayBuffer());
-      await fs16.writeFile(dest, buf);
-      result.saved.push({ role: file.role, path: dest, url: file.url, bytes: buf.byteLength });
-    } catch (err) {
-      result.failures.push(
-        `${file.role}: ${err instanceof Error ? err.message : String(err)} \u2014 the asset is still live at ${file.url}`
-      );
-    }
-  }
-  return result;
-}
-function formatBytes(bytes) {
-  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-  if (bytes >= 1024) return `${Math.round(bytes / 1024)} KB`;
-  return `${bytes} B`;
-}
-var DEFAULT_ASSET_DIR = "./assets";
-function localDeliveryFor(mode, opts, prompt) {
-  if (mode !== "tools" || opts.noDownload) return void 0;
-  return { outDir: opts.outDir ?? DEFAULT_ASSET_DIR, prompt };
-}
-
 // src/lib/lanes.ts
 var LANE_CREDITS = /* @__PURE__ */ new Set(["ok", "exhausted", "unknown"]);
 async function fetchLanes(apiUrl, token, timeoutMs = 4e3) {
@@ -7141,8 +7161,10 @@ async function* readSSE(body) {
 
 // src/commands/generate.ts
 var MOCKED_LINE = "placeholder \u2014 this lane is mocked for this run";
+var FIXTURE_LINE = "fixture \u2014 real bytes replayed from an earlier generation on this account; nothing was generated or billed";
 function reportMocked(view, log) {
-  if (view.mocked === true) log.dim(`  ${MOCKED_LINE}`);
+  if (view.mocked !== true) return;
+  log.dim(`  ${view.provider === "fixture" ? FIXTURE_LINE : MOCKED_LINE}`);
 }
 var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
 var INLINE_IMAGE_LIMIT_BYTES = 4 * 1024 * 1024;
@@ -7274,6 +7296,15 @@ function applySkyboxGuard(prompt, raw) {
   return { prompt: guarded, guarded: true, nouns };
 }
 var MODEL_TEXTURE_TIERS = ["standard", "detailed", "none"];
+var LOW_POLY_FACE_LIMIT = { min: 1e3, max: 2e4 };
+var LOW_POLY_QUAD_FACE_LIMIT = { min: 500, max: 1e4 };
+var QUAD_FACE_LIMIT_MAX = 15e4;
+function faceLimitBand(o) {
+  if (o.lowPoly && o.quad) return { ...LOW_POLY_QUAD_FACE_LIMIT, why: "for --low-poly with --quad" };
+  if (o.lowPoly) return { ...LOW_POLY_FACE_LIMIT, why: "for --low-poly" };
+  if (o.quad) return { min: 1e3, max: QUAD_FACE_LIMIT_MAX, why: "for --quad" };
+  return { min: 1e3, max: 2e6, why: "for a raw mesh" };
+}
 function buildGenOptions(kind, opts) {
   const options = { ...opts.generationOptions };
   if (kind === "model" && opts.imageUrl) options.imageUrl = opts.imageUrl;
@@ -7284,7 +7315,15 @@ function buildGenOptions(kind, opts) {
     if (opts.quad) options.quad = true;
     if (opts.lowPoly) options.smartLowPoly = true;
     if (opts.parts) options.generateParts = true;
-    if (opts.faceLimit !== void 0) options.faceLimit = opts.faceLimit;
+    if (opts.faceLimit !== void 0) {
+      const band = faceLimitBand({ lowPoly: !!opts.lowPoly, quad: !!opts.quad });
+      if (opts.faceLimit < band.min || opts.faceLimit > band.max) {
+        throw new Error(
+          `--face-limit ${opts.faceLimit} is outside the ${band.min}-${band.max} band ${band.why} \u2014 Tripo refuses anything else for that topology. Drop --face-limit to take ${band.max}, or name a value in the band.`
+        );
+      }
+      options.faceLimit = opts.faceLimit;
+    }
     if (opts.autoSize) options.autoSize = true;
   }
   if (kind === "texture" && opts.terrain) options.terrain = true;
@@ -7479,7 +7518,7 @@ async function runGenerate(kind, opts) {
   log.dim(`  ${prompt}`);
   if (skyboxGuard?.guarded) log.dim("  \u21B3 environment-only guard applied (--raw to disable)");
   log.plain("");
-  {
+  if (mode !== "tools") {
     const counts = unshippedCounts(await readLedgerRows());
     const verdict = ceilingVerdict({ kind, counts, config: ceilingConfig() });
     if (!verdict.allow) {
@@ -8324,6 +8363,7 @@ async function runModelAnimate(opts) {
 }
 
 // src/commands/wait.ts
+import path18 from "path";
 var TERMINAL2 = /* @__PURE__ */ new Set(["completed", "failed"]);
 async function runWait(opts) {
   if (opts.all) return runWaitAll(opts);
@@ -8446,8 +8486,26 @@ async function runWaitAll(opts) {
     if (e.status === "queued" && v?.status === "completed") landed.push({ kind: e.kind, view: v });
     rows.push(await toRow(e, v, cwd));
   }
+  const delivered = [];
+  if (!opts.noDownload && await workspaceMode(cwd) === "tools") {
+    for (const e of ledger) {
+      const v = views.get(e.id);
+      if (v?.status !== "completed" || !v.files?.length) continue;
+      const local = localDeliveryFor("tools", opts, e.prompt || e.kind);
+      if (!local) continue;
+      const outDir = path18.join(path18.relative(process.cwd(), cwd) || ".", local.outDir);
+      const target = { kind: e.kind, prompt: local.prompt, id: e.id, outDir };
+      const missing = await undeliveredFiles(v.files, target);
+      if (missing.length === 0) continue;
+      delivered.push({ kind: e.kind, id: e.id, result: await downloadAssets(missing, target) });
+    }
+  }
   if (opts.json) {
-    writeJson({ generations: rows });
+    writeJson({
+      generations: rows,
+      // Additive: what THIS refresh wrote to disk. Absent when nothing was.
+      ...delivered.length > 0 ? { saved: delivered.flatMap((d) => d.result.saved.map((f) => ({ id: d.id, kind: d.kind, ...f }))) } : {}
+    });
     return;
   }
   log.plain(c.bold("genex wait --all"));
@@ -8482,6 +8540,14 @@ async function runWaitAll(opts) {
   if (count("running") + count("queued") > 0) {
     log.dim(`  Attach to any single one with: ${c.cyan("npx genex wait <id>")}`);
   }
+  if (delivered.length > 0) {
+    log.plain("");
+    log.plain(`  ${c.bold("Picked up")} \u2014 finished generations that were not in your project yet:`);
+    for (const d of delivered) {
+      log.plain(`  ${c.dim(`${d.kind} ${d.id}`)}`);
+      reportLocalFiles(d.result, log, false);
+    }
+  }
   if (landed.length > 0) {
     log.plain("");
     log.plain(`  ${c.bold("Just landed")} \u2014 how to use each one:`);
@@ -8523,7 +8589,7 @@ async function toRow(e, v, cwd) {
 
 // src/commands/controller.ts
 import fs20 from "fs/promises";
-import path19 from "path";
+import path20 from "path";
 
 // ../../packages/meshy-animation-catalog/src/index.ts
 import { createHash } from "crypto";
@@ -17654,8 +17720,8 @@ function searchMeshyAnimations(query, options = {}) {
 
 // src/lib/anims.ts
 import fs19 from "fs/promises";
-import path18 from "path";
-var ANIMS_DEST = path18.join("public", "assets", "anims");
+import path19 from "path";
+var ANIMS_DEST = path19.join("public", "assets", "anims");
 var HIDDEN_TAG = "reference";
 async function runAnims(opts) {
   const log = createLogger({ quiet: opts.quiet });
@@ -17671,7 +17737,7 @@ async function runAnims(opts) {
     printCatalog(log, manifest, selectors);
     return;
   }
-  const controllerMarker = path18.join(root, "src", "controllers", "character");
+  const controllerMarker = path19.join(root, "src", "controllers", "character");
   if (!await exists2(controllerMarker)) {
     log.error(
       `No character controller in this game (missing ${c.cyan("src/controllers/character/")}).`
@@ -17680,11 +17746,11 @@ async function runAnims(opts) {
     process.exitCode = 1;
     return;
   }
-  const destDir = path18.join(root, ANIMS_DEST);
-  const gameManifestPath = path18.join(destDir, "manifest.json");
+  const destDir = path19.join(root, ANIMS_DEST);
+  const gameManifestPath = path19.join(destDir, "manifest.json");
   if (opts.reset) {
     await fs19.rm(destDir, { recursive: true, force: true });
-    log.step(`Cleared ${c.cyan(ANIMS_DEST + path18.sep)} (--reset)`);
+    log.step(`Cleared ${c.cyan(ANIMS_DEST + path19.sep)} (--reset)`);
   }
   if (selectors.length === 0) {
     const installed = await readGameManifest(gameManifestPath);
@@ -17722,7 +17788,7 @@ async function runAnims(opts) {
     }
   }
   const wanted = [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
-  const cacheDir = path18.join(
+  const cacheDir = path19.join(
     opts.cacheDir ?? getAnimsCacheDir(),
     `${manifest.library}-v${manifest.version}`
   );
@@ -17734,13 +17800,13 @@ async function runAnims(opts) {
   let addedBytes = 0;
   const failures = [];
   for (const entry of wanted) {
-    const dest = path18.join(destDir, entry.file);
+    const dest = path19.join(destDir, entry.file);
     if (await hasSize(dest, entry.bytes)) {
       presentCount++;
       continue;
     }
     try {
-      const cached = path18.join(cacheDir, entry.file);
+      const cached = path19.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}`);
@@ -17750,7 +17816,7 @@ async function runAnims(opts) {
       await fs19.copyFile(cached, dest);
       installedCount++;
       addedBytes += entry.bytes;
-      log.dim(`  ${path18.join(ANIMS_DEST, entry.file)} (${formatMb(entry.bytes)})`);
+      log.dim(`  ${path19.join(ANIMS_DEST, entry.file)} (${formatMb(entry.bytes)})`);
     } catch (err) {
       failures.push(`${entry.name} (${err instanceof Error ? err.message : String(err)})`);
     }
@@ -17772,7 +17838,7 @@ async function runAnims(opts) {
   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 + path18.sep)}${addedBytes > 0 ? ` (+${formatMb(addedBytes)})` : ""}`
+    `${parts.join(", ")} \u2192 ${c.cyan(ANIMS_DEST + path19.sep)}${addedBytes > 0 ? ` (+${formatMb(addedBytes)})` : ""}`
   );
   for (const [selector, entries] of resolved) {
     const names = entries.filter((e) => !coreNames.has(e.name)).map((e) => e.name);
@@ -17804,7 +17870,7 @@ async function loadManifest(baseOverride) {
     }
   } catch {
   }
-  const snapshotPath = path18.join(getTemplatesDir(), "controllers", "assets", "anims-manifest.json");
+  const snapshotPath = path19.join(getTemplatesDir(), "controllers", "assets", "anims-manifest.json");
   const manifest = JSON.parse(await fs19.readFile(snapshotPath, "utf8"));
   return { manifest, source: "snapshot" };
 }
@@ -18138,8 +18204,8 @@ var CONTROLLER_FILE_SETS = {
     ]
   }
 };
-var CODE_DEST = path19.join("src", "controllers");
-var ASSETS_DEST = path19.join("public", "assets");
+var CODE_DEST = path20.join("src", "controllers");
+var ASSETS_DEST = path20.join("public", "assets");
 async function runController(opts) {
   const log = createLogger({ quiet: opts.quiet });
   if (opts.kind?.trim() === "anims") {
@@ -18156,31 +18222,31 @@ async function runController(opts) {
     process.exitCode = 1;
     return;
   }
-  const srcDir = path19.join(getTemplatesDir(), "controllers");
+  const srcDir = path20.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 + path19.sep)}`);
+  log.step(`Installing the ${kind} controller into ${c.cyan(CODE_DEST + path20.sep)}`);
   const plan = [
-    ...set.code.map((rel) => ({ from: rel, rel: path19.join(CODE_DEST, rel) })),
+    ...set.code.map((rel) => ({ from: rel, rel: path20.join(CODE_DEST, rel) })),
     ...set.assets.map((rel) => ({
       from: rel,
-      rel: path19.join(ASSETS_DEST, path19.basename(rel))
+      rel: path20.join(ASSETS_DEST, path20.basename(rel))
     }))
   ];
   let copied = 0;
   let skipped = 0;
   try {
     for (const file of plan) {
-      const dest = path19.join(root, file.rel);
+      const dest = path20.join(root, file.rel);
       if (!opts.force && await exists3(dest)) {
         skipped++;
         log.dim(`  skipped ${file.rel} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs20.mkdir(path19.dirname(dest), { recursive: true });
-      await fs20.copyFile(path19.join(srcDir, file.from), dest);
+      await fs20.mkdir(path20.dirname(dest), { recursive: true });
+      await fs20.copyFile(path20.join(srcDir, file.from), dest);
       copied++;
       log.dim(`  ${file.rel}`);
     }
@@ -18233,7 +18299,7 @@ async function runController(opts) {
   for (const line of set.sketch) {
     log.dim(`       ${line}`);
   }
-  if (kind === "character" && !await exists3(path19.join(root, ASSETS_DEST, "meshy-character.json"))) {
+  if (kind === "character" && !await exists3(path20.join(root, ASSETS_DEST, "meshy-character.json"))) {
     log.plain("");
     log.plain(
       `  ${stepOffset + 3}. This game has no generated character yet \u2014 ${c.cyan(
@@ -18265,8 +18331,8 @@ async function installMeshyCharacterManifest(args) {
     throw new Error("The API returned an invalid Meshy character manifest.");
   }
   assertCompleteMeshyControllerPack(manifest);
-  const destination = path19.join(args.root, ASSETS_DEST, "meshy-character.json");
-  await fs20.mkdir(path19.dirname(destination), { recursive: true });
+  const destination = path20.join(args.root, ASSETS_DEST, "meshy-character.json");
+  await fs20.mkdir(path20.dirname(destination), { recursive: true });
   await fs20.writeFile(
     destination,
     `${JSON.stringify(manifest, null, 2)}
@@ -18412,9 +18478,9 @@ function assertCompleteMeshyControllerPack(manifest) {
 }
 async function installFallbackAvatar(args) {
   const { root, srcDir, log } = args;
-  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);
+  const dest = path20.join(root, ASSETS_DEST, "avatar.vrm");
+  await fs20.mkdir(path20.dirname(dest), { recursive: true });
+  await fs20.copyFile(path20.join(srcDir, "assets", "default-avatar.vrm"), dest);
   log.dim("  public/assets/avatar.vrm (fallback avatar \u2014 bundled CC0 default)");
 }
 async function exists3(p) {
@@ -18428,7 +18494,7 @@ async function exists3(p) {
 
 // src/commands/character.ts
 import fs21 from "fs/promises";
-import path20 from "path";
+import path21 from "path";
 function exactAnimation(selector) {
   const trimmed = selector.trim();
   if (/^-?\d+$/.test(trimmed)) return animationById(Number(trimmed));
@@ -18508,7 +18574,7 @@ function showAmbiguity(selector, candidates, log, json = false) {
   }
   process.exitCode = 1;
 }
-var INSTALLED_MANIFEST = path20.join("public", "assets", "meshy-character.json");
+var INSTALLED_MANIFEST = path21.join("public", "assets", "meshy-character.json");
 async function resolveAdoptTarget(selector) {
   const trimmed = selector?.trim();
   if (trimmed && !trimmed.endsWith(".json")) {
@@ -18637,7 +18703,7 @@ async function runCharacterImport(opts) {
     opts,
     ctx,
     kind: "character",
-    prompt: `Import ${path20.basename(filePath)} as a rigged character`,
+    prompt: `Import ${path21.basename(filePath)} as a rigged character`,
     createPath: "/api/characters/import",
     body,
     quote: price,
@@ -19117,22 +19183,22 @@ async function context2(opts) {
   const project = await readProject();
   return { token, apiUrl: getApiUrl(opts.apiUrl ?? project?.apiUrl) };
 }
-async function readVideo(path27, log) {
+async function readVideo(path28, log) {
   let bytes;
   try {
-    bytes = await readFile(path27);
+    bytes = await readFile(path28);
   } catch {
-    log.error(`Can't read ${path27}.`);
+    log.error(`Can't read ${path28}.`);
     return null;
   }
   if (bytes.byteLength > MAX_VIDEO_BYTES) {
-    log.error(`${basename(path27)} is ${(bytes.byteLength / 1e6).toFixed(0)} MB \u2014 the limit is ${MAX_VIDEO_BYTES / 1e6} MB.`);
+    log.error(`${basename(path28)} 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, path27, bytes, log) {
-  const contentType = /\.mov$/i.test(path27) ? "video/quicktime" : "video/mp4";
+async function uploadVideo(apiUrl, token, characterId, path28, bytes, log) {
+  const contentType = /\.mov$/i.test(path28) ? "video/quicktime" : "video/mp4";
   const minted = await apiFetch(
     `${apiUrl}/api/characters/${encodeURIComponent(characterId)}/motions/video-url`,
     {
@@ -19147,7 +19213,7 @@ async function uploadVideo(apiUrl, token, characterId, path27, bytes, log) {
     return null;
   }
   const { uploadUrl, videoUrl } = await minted.json();
-  log.dim(`  uploading ${basename(path27)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
+  log.dim(`  uploading ${basename(path28)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
   const put = await fetch(uploadUrl, {
     method: "PUT",
     headers: { "Content-Type": contentType, "Content-Length": String(bytes.byteLength) },
@@ -19464,7 +19530,7 @@ function rank(items, query) {
 
 // src/commands/motion.ts
 import fs22 from "fs/promises";
-import path21 from "path";
+import path22 from "path";
 
 // src/lib/motion/npz.ts
 import zlib from "zlib";
@@ -20742,7 +20808,7 @@ async function expandTakes(selectors) {
     const st = await fs22.stat(sel).catch(() => null);
     if (st?.isDirectory()) {
       const names = await fs22.readdir(sel);
-      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path21.join(sel, n));
+      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path22.join(sel, n));
     } else if (st?.isFile()) {
       out.push(sel);
     } else {
@@ -20799,7 +20865,7 @@ async function motionVerify(opts, log) {
   }
   const reports = [];
   for (const file of files) {
-    const stem = path21.basename(file).replace(/\.npz$/, "");
+    const stem = path22.basename(file).replace(/\.npz$/, "");
     try {
       reports.push(analyzeTake(stem, await fs22.readFile(file), gates));
     } catch (err) {
@@ -20857,7 +20923,7 @@ async function motionCompile(opts, log) {
   }
   const inputs = [];
   for (const file of files) {
-    const stem = path21.basename(file).replace(/\.npz$/, "");
+    const stem = path22.basename(file).replace(/\.npz$/, "");
     try {
       inputs.push({ stem, take: loadTake(await fs22.readFile(file)) });
     } catch (err) {
@@ -20866,7 +20932,7 @@ async function motionCompile(opts, log) {
       return;
     }
   }
-  const setName = opts.set ?? path21.basename(opts.out).replace(/\.json$/, "");
+  const setName = opts.set ?? path22.basename(opts.out).replace(/\.json$/, "");
   let result;
   try {
     result = compileSet(inputs, setName, cfg);
@@ -20881,7 +20947,7 @@ async function motionCompile(opts, log) {
     process.exitCode = 1;
     return;
   }
-  await fs22.mkdir(path21.dirname(path21.resolve(opts.out)), { recursive: true });
+  await fs22.mkdir(path22.dirname(path22.resolve(opts.out)), { recursive: true });
   const json = JSON.stringify(result.data);
   await fs22.writeFile(opts.out, json);
   if (opts.json) {
@@ -20901,9 +20967,9 @@ var MOTION_RUNTIME_FILES = [
 var MOTION_PRESETS = {
   rifle: ["sets/rifle.json", "sets/jumps.json"]
 };
-var MOTION_DEST = path21.join("src", "motion");
+var MOTION_DEST = path22.join("src", "motion");
 async function motionInstall(opts, log) {
-  const srcDir = path21.join(getTemplatesDir(), "motion");
+  const srcDir = path22.join(getTemplatesDir(), "motion");
   const root = opts.cwd ?? process.cwd();
   const preset = opts.set;
   if (preset !== void 0 && !MOTION_PRESETS[preset]) {
@@ -20914,21 +20980,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 + path21.sep)}`);
+  log.step(`Vendoring the motion runtime into ${c.cyan(MOTION_DEST + path22.sep)}`);
   let copied = 0, skipped = 0;
   try {
     for (const rel of files) {
-      const dest = path21.join(root, MOTION_DEST, rel);
+      const dest = path22.join(root, MOTION_DEST, rel);
       const exists5 = await fs22.access(dest).then(() => true, () => false);
       if (!opts.force && exists5) {
         skipped++;
-        log.dim(`  skipped ${path21.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
+        log.dim(`  skipped ${path22.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs22.mkdir(path21.dirname(dest), { recursive: true });
-      await fs22.copyFile(path21.join(srcDir, rel), dest);
+      await fs22.mkdir(path22.dirname(dest), { recursive: true });
+      await fs22.copyFile(path22.join(srcDir, rel), dest);
       copied++;
-      log.dim(`  ${path21.join(MOTION_DEST, rel)}`);
+      log.dim(`  ${path22.join(MOTION_DEST, rel)}`);
     }
   } catch (err) {
     log.error(`Copy failed: ${String(err)}`);
@@ -21007,12 +21073,12 @@ async function runMotion(opts) {
 
 // src/commands/blender.ts
 import fs23 from "fs/promises";
-import path22 from "path";
+import path23 from "path";
 var SUBS2 = ["demo", "exec", "snap", "scene", "import", "export", "reset", "mcp", "serve", "seat", "release"];
 var DEFAULT_OUT_DIR = "assets/blender";
 async function writeB64(dir, name, b64) {
   await fs23.mkdir(dir, { recursive: true });
-  const p = path22.join(dir, name);
+  const p = path23.join(dir, name);
   await fs23.writeFile(p, Buffer.from(b64, "base64"));
   return p;
 }
@@ -21097,7 +21163,7 @@ async function runBlender(opts) {
     log.plain(rest.join("\n"));
     return 1;
   }
-  const outDir = path22.resolve(opts.outDir ?? DEFAULT_OUT_DIR);
+  const outDir = path23.resolve(opts.outDir ?? DEFAULT_OUT_DIR);
   const mode = opts.mode;
   if (mode !== void 0 && !isRenderMode(mode)) {
     log.error(`Unknown --mode ${mode}. Use one of: ${RENDER_MODES.join(", ")}.`);
@@ -21137,13 +21203,13 @@ async function runBlender(opts) {
       return 0;
     }
     case "export": {
-      const target = opts.out ?? path22.join(outDir, "scene.glb");
+      const target = opts.out ?? path23.join(outDir, "scene.glb");
       const r = await blenderCall(base, "/export", { path: "/tmp/genex-export.glb" });
       if (!r.glbBase64) {
         log.error(`/export answered with no GLB bytes${r.uploaded ? " (it was uploaded, not inlined)" : ""}`);
         return 1;
       }
-      await fs23.mkdir(path22.dirname(target), { recursive: true });
+      await fs23.mkdir(path23.dirname(target), { recursive: true });
       await fs23.writeFile(target, Buffer.from(r.glbBase64, "base64"));
       log.success(`Exported ${r.bytes ?? 0} bytes`);
       log.plain(`  ${c.cyan(target)}`);
@@ -21182,7 +21248,7 @@ async function runBlender(opts) {
           log.error(`Can't read ${opts.input}`);
           return 1;
         }
-        label = path22.basename(opts.input);
+        label = path23.basename(opts.input);
       }
       const r = await blenderCall(base, "/exec", { script, ...mode ? { mode } : {}, sheet: { formats: SHEET_FORMATS } });
       if (r.stdout?.trim()) log.plain(r.stdout.trimEnd());
@@ -21303,7 +21369,7 @@ print(f"castle: {n} objects")
 // src/commands/asset-new.ts
 import fs24 from "fs";
 import fsp from "fs/promises";
-import path23 from "path";
+import path24 from "path";
 import { pathToFileURL } from "url";
 var EXTRA_FILES = [
   "genex-asset.example.json",
@@ -21397,7 +21463,7 @@ Every milestone ends with \`npm run verify\`, then \`npx genex preview --no-buil
 }
 async function runAssetNew(options) {
   const log = createLogger();
-  const cwd = options.dir ? path23.resolve(options.dir) : process.cwd();
+  const cwd = options.dir ? path24.resolve(options.dir) : process.cwd();
   const slug = options.assetSlug;
   if (!slug) {
     log.error('Usage: genex asset new <slug> [--title "<Name>"] [--dims WxDxH] [--tri-band LOW-HIGH] [--holder "<your name>"] [--out <dir>]');
@@ -21407,14 +21473,14 @@ async function runAssetNew(options) {
     log.error(`The slug must be kebab-case (letters, digits, dashes), got: ${slug}`);
     return 1;
   }
-  const templateDir = path23.join(getTemplatesDir(), "asset-viewer");
+  const templateDir = path24.join(getTemplatesDir(), "asset-viewer");
   if (!fs24.existsSync(templateDir)) {
     log.error(`Vendored asset-viewer template not found at ${templateDir} \u2014 reinstall the CLI.`);
     return 1;
   }
-  const manifestTools = await import(pathToFileURL(path23.join(templateDir, "tools", "emit-manifest.mjs")).href);
+  const manifestTools = await import(pathToFileURL(path24.join(templateDir, "tools", "emit-manifest.mjs")).href);
   const { SHARED_FILES, PARITY_FILENAME, hashSharedFiles, pascalCase } = manifestTools;
-  const lockPath = path23.join(templateDir, "shared-files.sha256.json");
+  const lockPath = path24.join(templateDir, "shared-files.sha256.json");
   const lock = JSON.parse(await fsp.readFile(lockPath, "utf8"));
   const actual = hashSharedFiles(templateDir);
   const drifted = SHARED_FILES.filter((rel) => lock.files[rel] !== actual[rel]);
@@ -21427,7 +21493,7 @@ async function runAssetNew(options) {
   const triBand = parseBand(options.triBand ?? "500-8000");
   const holder = options.holder?.trim() || HOLDER_PLACEHOLDER;
   const year = (/* @__PURE__ */ new Date()).getUTCFullYear();
-  const outDir = path23.resolve(cwd, options.out ?? slug);
+  const outDir = path24.resolve(cwd, options.out ?? slug);
   if (fs24.existsSync(outDir) && fs24.readdirSync(outDir).length > 0 && !options.force) {
     log.error(`${outDir} already holds files. Nothing was touched \u2014 pass --force to write into it anyway.`);
     return 1;
@@ -21456,24 +21522,24 @@ async function runAssetNew(options) {
   };
   await fsp.mkdir(outDir, { recursive: true });
   for (const rel of [...SHARED_FILES, ...EXTRA_FILES]) {
-    const to = path23.join(outDir, rel);
-    await fsp.mkdir(path23.dirname(to), { recursive: true });
-    await fsp.copyFile(path23.join(templateDir, rel), to);
+    const to = path24.join(outDir, rel);
+    await fsp.mkdir(path24.dirname(to), { recursive: true });
+    await fsp.copyFile(path24.join(templateDir, rel), to);
   }
-  const pkg = fillTemplate(await fsp.readFile(path23.join(templateDir, "package.json"), "utf8"), {
+  const pkg = fillTemplate(await fsp.readFile(path24.join(templateDir, "package.json"), "utf8"), {
     slug,
     name,
     version
   });
-  await fsp.writeFile(path23.join(outDir, "package.json"), pkg, "utf8");
-  await fsp.writeFile(path23.join(outDir, "asset.config.json"), JSON.stringify(config, null, 2) + "\n", "utf8");
-  await fsp.writeFile(path23.join(outDir, ".gitignore"), GITIGNORE, "utf8");
+  await fsp.writeFile(path24.join(outDir, "package.json"), pkg, "utf8");
+  await fsp.writeFile(path24.join(outDir, "asset.config.json"), JSON.stringify(config, null, 2) + "\n", "utf8");
+  await fsp.writeFile(path24.join(outDir, ".gitignore"), GITIGNORE, "utf8");
   await fsp.writeFile(
-    path23.join(outDir, "DESIGN.md"),
+    path24.join(outDir, "DESIGN.md"),
     designDoc({ name, slug, sizeMeters, triBand, holder }),
     "utf8"
   );
-  const placeholder = await fsp.readFile(path23.join(templateDir, "src", "asset", "PLACEHOLDER.ts"), "utf8");
+  const placeholder = await fsp.readFile(path24.join(templateDir, "src", "asset", "PLACEHOLDER.ts"), "utf8");
   const seeded = seedAssetSource(placeholder, {
     slug,
     name,
@@ -21484,8 +21550,8 @@ async function runAssetNew(options) {
     pascalCase
   });
   const assetFilename = `${slug.replace(/-([a-z0-9])/g, (_, ch) => ch.toUpperCase())}.ts`;
-  await fsp.mkdir(path23.join(outDir, "src", "asset"), { recursive: true });
-  await fsp.writeFile(path23.join(outDir, "src", "asset", assetFilename), seeded, "utf8");
+  await fsp.mkdir(path24.join(outDir, "src", "asset"), { recursive: true });
+  await fsp.writeFile(path24.join(outDir, "src", "asset", assetFilename), seeded, "utf8");
   const copied = hashSharedFiles(outDir);
   const mismatched = SHARED_FILES.filter((rel) => copied[rel] !== lock.files[rel]);
   if (mismatched.length) {
@@ -21493,7 +21559,7 @@ async function runAssetNew(options) {
     return 1;
   }
   await fsp.writeFile(
-    path23.join(outDir, PARITY_FILENAME),
+    path24.join(outDir, PARITY_FILENAME),
     JSON.stringify(
       {
         note: "Recorded by `genex asset new`. Gate G13 recomputes these; do not hand-edit the viewer.",
@@ -21537,11 +21603,11 @@ async function runAssetNew(options) {
 }
 
 // src/commands/tools.ts
-import path26 from "path";
+import path27 from "path";
 
 // src/lib/local-install.ts
 import fs25 from "fs/promises";
-import path24 from "path";
+import path25 from "path";
 import { spawn as spawn4 } from "child_process";
 var CLI_PACKAGE = "@genex-ai/cli-demo";
 var FULL_NAME_FALLBACK = `npx ${CLI_PACKAGE}@${CLI_CHANNEL}`;
@@ -21561,10 +21627,10 @@ async function exists4(p) {
   }
 }
 async function detectPackageManager(cwd) {
-  let dir = path24.resolve(cwd);
+  let dir = path25.resolve(cwd);
   for (; ; ) {
     try {
-      const raw = await fs25.readFile(path24.join(dir, "package.json"), "utf8");
+      const raw = await fs25.readFile(path25.join(dir, "package.json"), "utf8");
       const pm = JSON.parse(raw).packageManager;
       if (typeof pm === "string") {
         const name = pm.split("@")[0];
@@ -21573,18 +21639,18 @@ async function detectPackageManager(cwd) {
     } catch {
     }
     for (const [file, pm] of LOCKFILES) {
-      if (await exists4(path24.join(dir, file))) return pm;
+      if (await exists4(path25.join(dir, file))) return pm;
     }
-    const parent = path24.dirname(dir);
+    const parent = path25.dirname(dir);
     if (parent === dir) return "npm";
     dir = parent;
   }
 }
 async function findLocalCli(cwd) {
-  let dir = path24.resolve(cwd);
+  let dir = path25.resolve(cwd);
   for (; ; ) {
-    if (await exists4(path24.join(dir, "node_modules", CLI_PACKAGE, "package.json"))) return dir;
-    const parent = path24.dirname(dir);
+    if (await exists4(path25.join(dir, "node_modules", CLI_PACKAGE, "package.json"))) return dir;
+    const parent = path25.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -21602,7 +21668,7 @@ function installArgs(pm, spec) {
   }
 }
 function manifestName(cwd) {
-  const slug = path24.basename(path24.resolve(cwd)).toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 100);
+  const slug = path25.basename(path25.resolve(cwd)).toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 100);
   return slug || "genex-tools-workspace";
 }
 function isSourceRun(moduleUrl = import.meta.url) {
@@ -21660,10 +21726,10 @@ async function ensureLocalCli(log, cwd = process.cwd(), opts = {}) {
     return;
   }
   const pm = await detectPackageManager(cwd);
-  const hadManifest = await exists4(path24.join(cwd, "package.json"));
+  const hadManifest = await exists4(path25.join(cwd, "package.json"));
   if (!hadManifest) {
     await fs25.writeFile(
-      path24.join(cwd, "package.json"),
+      path25.join(cwd, "package.json"),
       JSON.stringify({ name: manifestName(cwd), private: true }, null, 2) + "\n"
     );
     await ensureIgnored(cwd, "node_modules/");
@@ -21683,7 +21749,7 @@ async function ensureLocalCli(log, cwd = process.cwd(), opts = {}) {
   }
 }
 async function ensureIgnored(dir, entry) {
-  const file = path24.join(dir, ".gitignore");
+  const file = path25.join(dir, ".gitignore");
   let content = "";
   try {
     content = await fs25.readFile(file, "utf8");
@@ -21696,7 +21762,7 @@ async function ensureIgnored(dir, entry) {
 }
 
 // src/commands/doctor.ts
-import path25 from "path";
+import path26 from "path";
 var LANE_ORDER = [
   "model",
   "image",
@@ -21977,7 +22043,7 @@ async function fetchLegalStatus(apiUrl, token) {
 }
 async function firstSkillsMarker() {
   for (const target of resolveAgentTargets()) {
-    const marker = await readSkillsMarker(path25.join(target.baseDir, "skills"));
+    const marker = await readSkillsMarker(path26.join(target.baseDir, "skills"));
     if (marker) return marker;
   }
   return null;
@@ -22016,8 +22082,8 @@ async function runTools(opts) {
   let totalNew = 0;
   let totalUpdated = 0;
   for (const t of targets) {
-    const dest = path26.join(t.baseDir, "skills");
-    const { copied, updated } = await copyTemplates(path26.join(templatesDir, "skills"), dest, {
+    const dest = path27.join(t.baseDir, "skills");
+    const { copied, updated } = await copyTemplates(path27.join(templatesDir, "skills"), dest, {
       filter: (rel) => skillFamilyFilter("tools")(`skills/${rel}`)
     });
     await pruneRemovedSkills(dest, log);
@@ -22314,8 +22380,12 @@ ${c.bold("Options for the generators (`model` `sfx` `music` `voice` `texture` `i
   --geometry <tier>    (model) standard (default) | detailed (+20 credits, hero pieces).
   --quad               (model) quad-dominant mesh (+5; face limit \u2264150000).
   --low-poly           (model) smart low-poly topology (+10) \u2014 game-ready meshes.
+                       Holds --face-limit to 1000-20000 (500-10000 with --quad);
+                       omit it to take 20000. Runs a post-process after the mesh:
+                       allow up to 30 minutes.
   --parts              (model) separated, named parts at generation (+20).
-  --face-limit <n>     (model) cap on the raw mesh, 1000-2000000 (default 150000).
+  --face-limit <n>     (model) cap on the raw mesh, 1000-2000000 (default 150000;
+                       see --low-poly for its band).
   --auto-size          (model) scale to real-world metres by AI estimate.
   --granularity <g>    (model segment) part granularity: simple | balanced |
                        detailed (default balanced).
@@ -23301,8 +23371,8 @@ function applyValueFlag(options, flag, value) {
       break;
     case "--face-limit": {
       const n = Number(value);
-      if (!Number.isInteger(n) || n < 1e3 || n > 2e6) {
-        throw new Error(`Invalid --face-limit value: ${value} (expected 1000-2000000)`);
+      if (!Number.isInteger(n) || n < 500 || n > 2e6) {
+        throw new Error(`Invalid --face-limit value: ${value} (expected 1000-2000000; 500-10000 with --low-poly --quad)`);
       }
       options.faceLimit = n;
       break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.24.0-dev.615",
+  "version": "1.25.1-dev.617",
   "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-ai-model/SKILL.md

@@ -283,7 +283,9 @@ scene is a ghost: players and objects pass straight through it.
   the camera sits on; never for a crate), `--quad` (+5, quad-dominant mesh
   for anything you will deform or edit further; face limit ≤150000),
   `--low-poly` (+10, smart low-poly topology — the game-ready choice for
-  props that appear in numbers), `--parts` (+20, separated named parts at
+  props that appear in numbers; it holds `--face-limit` to 1000-20000,
+  500-10000 with `--quad` — omit the flag to take 20000 — and runs a
+  post-process after the mesh, so allow up to 30 minutes), `--parts` (+20, separated named parts at
   generation — cheaper than `model segment` when you know up front you need
   doors, wheels, magazines), `--face-limit <n>` (1000-2000000, default
   150000; the raw cap — the game still loads the @2048/@1024 rungs),

package/templates/skills/genex-tool-model/SKILL.md

@@ -42,14 +42,14 @@ npx genex model rig <model-id> --type quadruped
 npx genex model animate <rig-id> --preset walk,run
 ```
 
-- **`segment`** — one GLB whose parts carry NAMES, so you can address them: doors, turrets, magazines, destructibles. `--granularity simple|balanced|detailed`.
+- **`segment`** — one GLB split into addressable parts: doors, turrets, magazines, destructibles. `--granularity simple|balanced|detailed`. The parts are named by index (`tripo_part_0`, `tripo_part_1`, …), not by what they are — find the one you want by its bounds (the sails are the part with the widest extent, the door the lowest thin one), then keep that index in your manifest.
 - **`rig`** — a skeleton for any mesh, across 7 body plans: `biped`, `quadruped`, `hexapod`, `octopod`, `avian`, `serpentine`, `aquatic`. The plan is auto-detected; `--type` picks it. A mesh that cannot be rigged is refused and refunded before the paid step.
 - **`animate`** — retarget ready-made clips onto a rig, billed per clip. biped: `idle|walk|run|dive|climb|jump|slash|shoot|hurt|fall|turn`; quadruped/hexapod/octopod: `walk`; serpentine/aquatic: `march`.
 
 ## Options
 
 - `--image <path|url>` — build the model from a reference image (local file ≤ 4 MB, or a previous generation's URL). The prompt becomes optional.
-- **Quality knobs** (Tripo H3.1, each priced in the quote — pick per asset, say it in one line): `--texture standard|detailed|none` (detailed default, +10 over standard; none = geometry only), `--geometry detailed` (+20, hero pieces only), `--quad` (+5, for meshes you will edit; face limit ≤150000), `--low-poly` (+10, game-ready topology for props in numbers), `--parts` (+20, named parts at generation), `--face-limit <n>` (1000-2000000, default 150000), `--auto-size` (real-world metres).
+- **Quality knobs** (Tripo H3.1, each priced in the quote — pick per asset, say it in one line): `--texture standard|detailed|none` (detailed default, +10 over standard; none = geometry only), `--geometry detailed` (+20, hero pieces only), `--quad` (+5, for meshes you will edit; face limit ≤150000), `--low-poly` (+10, game-ready topology for props in numbers — it holds `--face-limit` to 1000-20000, 500-10000 with `--quad`; omit the flag to take 20000; it runs a post-process after the mesh, so allow up to 30 minutes), `--parts` (+20, named parts at generation), `--face-limit <n>` (1000-2000000, default 150000; see `--low-poly` for its band), `--auto-size` (real-world metres).
 - `--out-dir <dir>` — where the file lands (default `./assets`).
 - `--no-download` — print the URL only.
 - `--no-wait` — enqueue and return; pick it up with `npx genex wait <id>`.
@@ -65,9 +65,21 @@ Live prices and your balance: `npx genex doctor`.
 
 Models take the longest of any lane. `--no-wait` is the normal way to run
 several at once: enqueue them all, keep building, then `npx genex wait --all`
-for one status line each, and `npx genex wait <id>` to pick one up.
-**Re-running the model command bills a NEW model** — never use it as a status
-check.
+for one status line each — in a tools workspace it also downloads every
+finished model that is not in `./assets` yet, so one call after a break (or a
+restarted session) delivers the whole batch. `npx genex wait <id>` picks one
+up. **Re-running the model command bills a NEW model** — never use it as a
+status check. Five or so in flight at a time is the provider's comfortable
+concurrency; a burst beyond that waits on the server side rather than failing.
+
+## Placing a model
+
+A generated GLB has no shared "front": one building's door faces −x, the next
+one's +z. Do not guess and do not spend a render per side — read the mesh once
+on load (bounding box, and where the detail is: the door, the counter, the
+opening) or check it in a viewer, then record a per-model `front` (a yaw in
+your manifest) beside its path and apply it when you place it. Ask for a facing
+in the prompt too (`"…front toward +Z"`) — it helps, it does not guarantee.
 
 ## Troubleshooting