@genex-ai/cli-demo 1.9.2-dev.516 → 1.9.3-dev.518

package/dist/index.js

@@ -5859,6 +5859,13 @@ async function recordTerminal(id, status, urls, cwd = process.cwd()) {
 async function countFailed(kind, cwd = process.cwd()) {
   return (await readLedger(cwd)).filter((e) => e.kind === kind && e.status === "failed").length;
 }
+async function countOutcomes(kind, cwd = process.cwd()) {
+  const rows = (await readLedger(cwd)).filter((e) => e.kind === kind);
+  return {
+    failed: rows.filter((e) => e.status === "failed").length,
+    completed: rows.filter((e) => e.status === "completed").length
+  };
+}
 
 // src/lib/detect-features.ts
 async function detectEmbedSdkVersion(cwd = process.cwd()) {
@@ -5986,7 +5993,8 @@ async function detectSurfaceScan(cwd = process.cwd()) {
     guessedRepeat: [],
     squarePoints: [],
     depthRange: [],
-    mediaElementAudio: []
+    mediaElementAudio: [],
+    deferredAudioContext: []
   };
   const srcDir = path18.join(cwd, "src");
   let entries;
@@ -6046,6 +6054,26 @@ async function detectSurfaceScan(cwd = process.cwd()) {
         detail: isCtor ? "new Audio(...)" : 'document.createElement("audio")'
       });
     }
+    const ctxRe = /([A-Za-z_$][\w$]*(?:\s*\.\s*[A-Za-z_$][\w$]*)*)\s*=\s*new\s+(?:\(\s*(?:window\s*\.\s*)?(?:webkit)?AudioContext[^)]*\)|(?:window\s*\.\s*)?(?:webkit)?AudioContext)\s*\(/g;
+    while (m = ctxRe.exec(content)) {
+      const target = m[1].replace(/\s+/g, "");
+      const leaf = target.split(".").pop();
+      const esc = leaf.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      const startsNull = new RegExp(
+        `\\b${esc}\\s*(?::[^;=
+]*\\|\\s*null[^;=
+]*)?\\s*=\\s*null\\b|\\b${esc}\\s*:[^;=
+]*\\|\\s*null`
+      ).test(content);
+      const guarded = new RegExp(
+        `!\\s*(?:this\\s*\\.\\s*)?${esc}\\b|\\b${esc}\\s*===?\\s*null\\b`
+      ).test(content);
+      if (!startsNull || !guarded) continue;
+      found.deferredAudioContext.push({
+        where: `${rel}:${lineOf(content, m.index)}`,
+        detail: `${target} starts null and is guarded elsewhere in this file`
+      });
+    }
   }
   return found;
 }
@@ -6054,7 +6082,9 @@ var UNPICKED_AFTER_MS = 15 * 60 * 1e3;
 async function detectGenerationAudit(cwd = process.cwd()) {
   const ledger = await readLedger(cwd);
   const audited = ledger.filter((e) => WIRED_BY_URL.has(e.kind));
-  if (audited.length === 0) return { unwired: [], unpicked: [], unresolved: [], deadWired: [] };
+  if (audited.length === 0) {
+    return { unwired: [], unpicked: [], unresolved: [], deadWired: [], musicNoSlider: false };
+  }
   let haystack = "";
   const read = async (file) => {
     try {
@@ -6101,7 +6131,10 @@ async function detectGenerationAudit(cwd = process.cwd()) {
     // 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" && haystack.includes(e.id)).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)
   };
 }
 async function detectFeatures(log, cwd = process.cwd()) {
@@ -6156,6 +6189,11 @@ function generationNudges(log, g) {
       `${g.unwired.length} finished generation(s) are wired nowhere in the game: ${describe(g.unwired)}. Each was paid for \u2014 wire it in (its URL embeds the id) or tell the user in one plain line why it stays unused.`
     );
   }
+  if (g.musicNoSlider) {
+    log.warn(
+      `This game paid for a music track and has no volume control anywhere in its source. Music with no Music/SFX sliders is the failure genex-ai-music names: two sliders in the settings screen, persisted and applied live (music ~0.30, sfx ~0.7). A player who cannot turn the music down mutes the browser tab instead, which takes every other sound in the game with it.`
+    );
+  }
 }
 function surfaceNudges(log, s) {
   if (s.guessedRepeat.length) {
@@ -6176,6 +6214,12 @@ function surfaceNudges(log, s) {
       `HTML <audio> elements are carrying this game's sound: ${list}. On iPhone an <audio> element is a handle on the operating system's media pipeline in ANOTHER PROCESS: every write to .volume or .playbackRate is a cross-process call, and play() is slow and asynchronous. A sound driven from a live value \u2014 wheels from speed, engine from RPM \u2014 writes 60-120 of those a second and stutters the whole game, while one-shots arrive late. It disguises itself as a graphics problem perfectly: only while moving, identical at every quality setting, desktop fine. THREE.Audio/PositionalAudio on one AudioListener have none of this \u2014 genex-ai-sfx ships the pooled one-shot, the live-value loop, and the decode-during-the-menu preload.`
     );
   }
+  if (s.deferredAudioContext.length) {
+    const list = s.deferredAudioContext.map((d) => `${d.where} \u2014 ${d.detail}`).join("; ");
+    log.warn(
+      `Sound selected before the AudioContext exists is LOST, not queued: ${list}. Building the context inside the first user gesture is correct \u2014 browsers require it \u2014 but the code around it already skips its work while the context is null, and that is the half that goes wrong: a track chosen on a title screen sets the "current track" variable, its play call is skipped, and when the context finally exists the selector already matches, so nothing ever re-fires. The game then runs with permanently silent music while its SFX (wired directly inside the start handler) play fine. Whatever was pending at the moment the context is created must be RE-KICKED right there. If this game already re-kicks, there is nothing to do \u2014 source alone cannot tell the two apart.`
+    );
+  }
   for (const d of s.depthRange) {
     log.warn(
       `Camera depth range ${d.detail} (far/near = ${d.ratio.toExponential(1)}) at ${d.where} is past what a 24-bit depth buffer can serve \u2014 touching surfaces will z-fight and flicker, and it reads fine right up until it doesn't. near is the expensive knob (resolvable depth \u2248 z\xB2 / (near \xD7 2^24)), so raise near to the closest the camera can actually get \u2014 the quality kit's cameraNearFar derives the pair from the world, and spreading depthRendererOptions() into the renderer adds reversed-Z (free precision at distance, works on WebGL and WebGPU alike): genex-threejs-adaptive-quality. If the range is genuinely astronomical, that is what logarithmicDepthBuffer is for (it costs early-Z): genex-threejs-camera-direction.`
@@ -7259,6 +7303,9 @@ async function reportTerminal(kind, view, log, open = false, json = false) {
       if (kind === "video") {
         const failures = await countFailed("video");
         (failures >= 2 ? log.plain : log.dim)(videoFailureAdvice(failures));
+      } else {
+        const advice = laneFailureAdvice(kind, await countOutcomes(kind));
+        if (advice) log.plain(advice);
       }
     }
     process.exitCode = 1;
@@ -7317,6 +7364,10 @@ async function reportTerminal(kind, view, log, open = false, json = false) {
   }
   printHint(kind, view, files, log);
 }
+function laneFailureAdvice(kind, outcomes) {
+  if (outcomes.failed < 2 || outcomes.completed > 0) return null;
+  return `  ${c.bold(`\u270B ${outcomes.failed} ${kind} generations attempted in this project, ${outcomes.failed} failed, none succeeded.`)} That pattern is the LANE, not your prompt \u2014 a fourth attempt bills the same and returns the same. Build this one in code, use a different lane, or tell the user in one plain line what is unavailable and carry on with the rest of the game.`;
+}
 function videoFailureAdvice(failures) {
   if (failures >= 2) {
     return `  ${c.bold(`\u270B ${failures} failed videos in this project \u2014 don't queue another attempt of the same clip.`)} One retry per clip is the budget. Use its key-art still as the backdrop instead (the genex-ai-menu skill's built-in fallback; a slow CSS pan gives it life), tell the user in one plain line, and spend the minutes in the game.`;
@@ -7436,31 +7487,50 @@ async function reportTextureSeam(url, log) {
   } catch {
   }
 }
-function printHint(kind, view, files, log) {
-  const url = files[0]?.url ?? "";
+var HINT_URL_KINDS = /* @__PURE__ */ new Set([
+  "model",
+  "skybox",
+  "sfx",
+  "music",
+  "voice",
+  "image",
+  "video",
+  "model_segment",
+  "model_rig",
+  "model_animation"
+]);
+function assetHint(kind, view, url) {
   const hint = {
-    model: `Standard GLB \u2014 load with GLTFLoader straight from the URL \u2014 see the genex-ai-model skill. url = "${url}"`,
+    model: `Standard GLB \u2014 load with GLTFLoader straight from the URL \u2014 see the genex-ai-model skill.`,
     // Unreachable while the lane is paused (see src/index.ts) — kept so a
     // restore is one deletion. Games that already ship a panorama still load
     // it this way.
-    skybox: `Load as an equirectangular texture \u2192 scene.background + scene.environment. url = "${url}"`,
-    sfx: `Load with AudioLoader into a THREE.PositionalAudio (camera needs an AudioListener) \u2014 see genex-ai-sfx. url = "${url}"`,
-    music: `Load with AudioLoader into a non-positional THREE.Audio: setLoop(true), setVolume(0.30), start on the first user gesture \u2014 and the settings screen MUST have Music + SFX volume sliders \u2014 see genex-ai-music. url = "${url}"`,
-    voice: `Load with AudioLoader into a THREE.Audio (or PositionalAudio at the speaker); voice lines are content \u2014 keep them short, SUBTITLED, and skippable \u2014 see genex-ai-voice. url = "${url}"`,
+    skybox: `Load as an equirectangular texture \u2192 scene.background + scene.environment.`,
+    // The boot-order clause is not decoration: a hosted run shipped three paid
+    // music tracks and a silent title screen because the game selected a track
+    // while its AudioContext was still null. NAME the failure — pointing at the
+    // skill does not work, because no skill states this rule.
+    sfx: `Load with AudioLoader into a THREE.PositionalAudio (camera needs an AudioListener). Create the AudioContext inside the first user gesture \u2014 anything you fire before it exists is LOST, not queued \u2014 see genex-ai-sfx.`,
+    music: `Load with AudioLoader into a non-positional THREE.Audio: setLoop(true), setVolume(0.30). Create the AudioContext inside the first user gesture, and RE-KICK whatever track was already selected: a track chosen while the context was null is LOST, not queued, so nothing plays until the selection happens to change again. The settings screen MUST have Music + SFX volume sliders \u2014 see genex-ai-music.`,
+    voice: `Load with AudioLoader into a THREE.Audio (or PositionalAudio at the speaker); voice lines are content \u2014 keep them short, SUBTITLED, and skippable \u2014 see genex-ai-voice.`,
     texture: `Load each map with TextureLoader (RepeatWrapping) into a MeshStandardMaterial \u2014 see genex-ai-texture. Use the URLs above by role.`,
-    image: `Load with TextureLoader (set colorSpace = SRGBColorSpace) onto any mesh/plane/sprite \u2014 see genex-ai-image. url = "${url}"`,
-    video: `Wire an HTMLVideoElement (crossOrigin="anonymous", muted, loop, playsInline) into a THREE.VideoTexture \u2014 see genex-ai-video. url = "${url}"`,
+    image: `Load with TextureLoader (set colorSpace = SRGBColorSpace) onto any mesh/plane/sprite \u2014 see genex-ai-image.`,
+    video: `Wire an HTMLVideoElement (crossOrigin="anonymous", muted, loop, playsInline) into a THREE.VideoTexture \u2014 see genex-ai-video.`,
     motion: `Raw ARDY takes + verify report \u2014 download the takes, rename them meaningfully (routing is by filename), then: genex motion verify \u2192 compile \u2192 install. Full procedure: the genex-ai-character skill's motion reference.`,
     character_concept: "Show all three concept candidates to the user and wait for an explicit selection.",
     character_preview: "Show all four preview views to the user and wait for explicit approval before finalizing.",
     character: `Install the controller and current manifest with genex controller character --character ${view.id}.`,
     character_animation: "The action is now part of the character's current manifest; refresh the local controller manifest before testing.",
     character_motion: `The clips are part of the character's current manifest \u2014 install them with genex controller character --character ${view.id}, then play the game and watch the motion on the real character before calling it done.`,
-    model_segment: `One GLB with NAMED parts \u2014 load with GLTFLoader, then getObjectByName / traverse scene.children to move, detach, or swap a part. Part names print above when the provider reports them. url = "${url}"`,
-    model_rig: `Rigged GLB (Tripo skeleton) \u2014 load with GLTFLoader; give it motion with genex model animate ${view.id} --preset walk, or drive the bones in code. url = "${url}"`,
-    model_animation: `Animated GLB \u2014 load with GLTFLoader and play its clips via THREE.AnimationMixer (gltf.animations). url = "${url}"`
+    model_segment: `One GLB with NAMED parts \u2014 load with GLTFLoader, then getObjectByName / traverse scene.children to move, detach, or swap a part. Part names print above when the provider reports them.`,
+    model_rig: `Rigged GLB (Tripo skeleton) \u2014 load with GLTFLoader; give it motion with genex model animate ${view.id} --preset walk, or drive the bones in code.`,
+    model_animation: `Animated GLB \u2014 load with GLTFLoader and play its clips via THREE.AnimationMixer (gltf.animations).`
   };
-  log.dim(`  ${hint[kind]}`);
+  const base = hint[kind];
+  return url && HINT_URL_KINDS.has(kind) ? `${base} url = "${url}"` : base;
+}
+function printHint(kind, view, files, log) {
+  log.dim(`  ${assetHint(kind, view, files[0]?.url ?? "")}`);
   log.dim("  Reference the URL directly in your code \u2014 don't download it into the repo.");
 }
 var CONCEPT_STOP = "STOP \u2014 show all three concept images to the user and wait for an explicit selection. Do not create the 3D preview until they choose candidate 1, 2, or 3.";
@@ -7826,8 +7896,11 @@ async function runWaitAll(opts) {
     }
   }
   const rows = [];
+  const landed = [];
   for (const e of ledger) {
-    rows.push(await toRow(e, views.get(e.id), cwd));
+    const v = views.get(e.id);
+    if (e.status === "queued" && v?.status === "completed") landed.push({ kind: e.kind, view: v });
+    rows.push(await toRow(e, v, cwd));
   }
   if (opts.json) {
     writeJson({ generations: rows });
@@ -7854,6 +7927,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 (landed.length > 0) {
+    log.plain("");
+    log.plain(`  ${c.bold("Just landed")} \u2014 how to use each one:`);
+    for (const l of landed) {
+      const hint = assetHint(l.kind, l.view);
+      if (hint) log.dim(`  \u2022 ${l.kind}: ${hint}`);
+    }
+  }
   log.plain("");
   log.dim(
     "  \u{1F4DC} Resumed or compacted? Re-read AGENTS.md + DESIGN.md (continue from its Now: line) before building on."
@@ -21567,10 +21648,11 @@ async function main() {
           await runCharacterAnimateMotion({ ...parsed.options, creature: true });
           break;
         }
-        if (!parsed.options.json && !parsed.options.quiet) {
-          log.dim(
-            "  Biped-shaped creatures only (Meshy rig limit) \u2014 for a true quadruped/flier/serpent, generate it with `npx genex model` and rig it with `npx genex model rig` (7 body plans), or go static + the genex-threejs-creatures procedural recipes."
-          );
+        if (!parsed.options.quiet) {
+          const note = "  Biped-shaped creatures only (Meshy rig limit) \u2014 for a true quadruped/flier/serpent, generate it with `npx genex model` and rig it with `npx genex model rig` (7 body plans), or go static + the genex-threejs-creatures procedural recipes.";
+          if (parsed.options.json) process.stderr.write(`${note}
+`);
+          else log.dim(note);
         }
         await runCharacter({
           ...parsed.options,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.9.2-dev.516",
+  "version": "1.9.3-dev.518",
   "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-game-director/references/routing-map.md

@@ -190,8 +190,10 @@ Search the catalog first. A missing verb uses
 `genex character animate <id> "<verb>"` or the creature equivalent, with the
 existing free motion plan before paid work, route selection, source/clip
 validation, locomotion bindings, manifests, controller authority, and runtime
-playback unchanged. `$genex-threejs-procedural-animation` remains the
-non-biped/prop-motion fallback.
+playback unchanged. A non-biped BODY now has a rigged route —
+`npx genex model` → `model rig --type <plan>` → `model animate` (7 body plans,
+AG-908) — so `$genex-threejs-procedural-animation` is the fallback for shapes
+with no riggable body plan, and it keeps prop/debris motion outright.
 
 ### Optimization and mobile