@genex-ai/cli-demo 1.13.1-dev.558 → 1.13.2-dev.559

package/dist/index.js

@@ -700,11 +700,11 @@ var CONTRACT_END = "<!-- genex:contract:end -->";
 var GENEX_CONTRACT_BLOCK = `${CONTRACT_BEGIN}
 # Genex build contract (always in effect for this game)
 
-Your agentic capabilities that can boost your creation (all via \`npx genex \u2026\`): generate \`model\` (\`--image\` from a reference image; \`model segment <id>\` into named parts; \`model rig <id>\` + \`model animate <rig-id> --preset walk\` for non-biped bodies \u2014 7 body plans) \xB7 \`sfx\` \xB7 \`music\` \xB7 \`voice\` \xB7 \`texture\` \xB7 \`image\` (\`--edit\` \xB7 \`--inpaint\` \xB7 \`--glass\` \xB7 \`--clean\` \xB7 \`--upscale\`) \xB7 \`video\` \xB7 rigged \`character\` / \`creature\` \xB7 \`character animate <id> "<verb>"\` (also \`creature animate\`; \`--locomotion\` for the 8-way movement set, \`--video\` for your own footage) \xB7 the pixel toolbox \`ui extract|masks|plate|text-color|trim|audit\` \xB7 vendored \`controller character|car|drone|touch|quality|chat\` \xB7 \`animations search\` \xB7 \`wait <id>\` / \`wait --all\` \xB7 \`preview\` / \`publish\` \xB7 \`rename <name>\` (move the game to a new address \u2014 keeps its plays and likes, kills the old link, needs \`--yes\` once published, and the game must be rebuilt after). Full options: \`npx genex --help\`. There is NO sky generator: every sky, horizon, time of day and weather mood is built in code \u2014 your call how, from a background colour and fog to an atmospheric sky shader with a real sun. It costs nothing, weighs nothing on phones, and keeps the sun in sync with the scene's own lighting, which a painted panorama never can. Task\u2192lane routing lives in the \`genex-game-director\` skill's routing map \u2014 re-load it whenever you're unsure which lane owns a task.
+Your agentic capabilities that can boost your creation (all via \`npx genex \u2026\`): generate \`model\` (\`--image\` from a reference image; \`model segment <id>\` into named parts; \`model rig <id>\` + \`model animate <rig-id> --preset walk\` for non-biped bodies \u2014 7 body plans) \xB7 \`sfx\` \xB7 \`music\` \xB7 \`voice\` \xB7 \`texture\` \xB7 \`image\` (\`--edit\` \xB7 \`--inpaint\` \xB7 \`--glass\` \xB7 \`--clean\` \xB7 \`--upscale\`) \xB7 \`video\` \xB7 rigged \`character\` / \`creature\` \xB7 \`character animate <id> "<verb>"\` (also \`creature animate\`; \`--locomotion\` for the 8-way movement set, \`--video\` for your own footage) \xB7 the pixel toolbox \`ui extract|masks|plate|text-color|trim|audit\` \xB7 vendored \`controller character|car|drone|touch|quality|chat\` \xB7 \`animations search\` \xB7 \`wait <id>\` / \`wait --all\` \xB7 \`preview\` / \`publish\` \xB7 \`rename <name>\` (move the game to a new address \u2014 keeps its plays and likes, kills the old link, needs \`--yes\` once published, and the game must be rebuilt after). Full options: \`npx genex --help\`. There is NO sky generator: every sky, horizon, time of day and weather mood is built in code \u2014 your call how, from a background colour and fog to an atmospheric sky shader with a real sun. It costs nothing, weighs nothing on phones, and keeps the sun in sync with the scene's own lighting, which a painted panorama never can. Task\u2192lane routing lives in the \`genex-game-director\` skill's routing map \u2014 load the owning row before the first file of each subsystem, and re-load the map after any compaction.
 
-Important note: put soul into your creations, with many details and love. Aim to make them realistic and feel real. Use genex capabilities as an extension, but never limit your imagination \u2014 you are a powerful agent. Use your built-in sub-agents and iteration loops (\`/loop\` or your platform's equivalent) where you need them to reach outstanding results. Verify yourself. Anything you put in front of the player should already feel alive and impressive \u2014 never a bare scene waiting for "later". Build what's still missing before polishing what already works.
+Important note: put soul into your creations, with many details and love. Aim to make them realistic and feel real. Reach for genex capabilities by default \u2014 they are how the world gets real assets (law 22) \u2014 but never limit your imagination \u2014 you are a powerful agent. Use your built-in sub-agents and iteration loops (\`/loop\` or your platform's equivalent) where you need them to reach outstanding results. Verify yourself. Anything you put in front of the player should already feel alive and impressive \u2014 never a bare scene waiting for "later". Build what's still missing before polishing what already works.
 
-1. Load the \`genex-game-director\` skill before starting the requested work. Route from the player's latest clear request: a focused request starts directly without replaying discovery or commissioning unrelated lanes. After ANY context compaction or session resume, re-read this file and \`DESIGN.md\`, re-load the skill for the stage you are executing, and continue from the Build plan's \`Now:\` line \u2014 never from memory alone.
+1. Load the \`genex-game-director\` skill before starting the requested work. Route from the player's latest clear request: a focused request starts directly without replaying discovery or commissioning unrelated lanes. Before the first file of any subsystem, load its owning lane from the director's routing map and write it as \`Lane:\` beside that work in \`DESIGN.md\` (\`Lane: none \u2014 <why>\` when no row matches) \u2014 a matching row is not optional, and loading one lane never commissions another. After ANY context compaction or session resume, re-read this file and \`DESIGN.md\`, re-load the skill for the stage you are executing, and continue from the Build plan's \`Now:\` line \u2014 never from memory alone.
 2. Ask only when one unresolved answer materially changes the work. If the request is clear, do not repeat an interview, confirm the pitch, force a concept round, or ask whole-game-vs-one-part again. For a genuinely broad new game, ask one decision: whole coordinated build or one request-relevant part first. If there is no clear request \u2014 a setup prompt pasted with nothing of their own \u2014 ask in PLAIN CHAT what they want to make, in their own words, and never fill the blank by pitching concepts. Once you know what you are building, ask one decision at a time with your built-in question tool with clickable answer options when you have one; use a short plain-chat question otherwise. If the player stays silent after a necessary question, proceed on stated assumptions where reasonable and record each as "assumed \u2014 player didn't answer" in DESIGN.md \u2192 Decisions.
 3. \`DESIGN.md\` at the project root is the durable design contract AND build plan. Keep three truths distinct: the player's requested outcome, the current \`Now:\` focus, and open commitments. It must carry a \`## Build plan & status\` section with the working mode (\`whole coordinated build\`, \`step by step\`, or \`focused change\`), numbered milestones with status marks, and a \`Now:\` line naming the current one \u2014 a milestone is done only when its work reached a preview. The latest clear request may replace \`Now:\` immediately; it never silently shrinks the requested outcome or deletes unrelated commitments. Keep every decision, assumption, generation id/URL, local output, and wiring state current. When the plan first lands, tell the player in one plain line that you recorded what they asked for in \`DESIGN.md\` and will keep it current.
 4. Use \`genex\` commands to generate art, audio, video, characters, and UI. A local reference image is not a reason to switch tools: pass its file path to genex (\`--edit\`, \`--inpaint\`, and model's \`--image\` accept local paths). Don't limit yourself: add details, and mix generated assets with procedural generation to make scenes and games detailed and lively.
@@ -713,7 +713,7 @@ Important note: put soul into your creations, with many details and love. Aim to
 7. Never draw a rectangular backing plate behind bars, digits, or icons \u2014 in sprites or CSS. Ornament lives on the widget's own silhouette; a truly needed shaped plate comes from \`npx genex ui plate\`.
 8. Never park ready work behind a question, and never stall on an unanswered one \u2014 decide, state the decision in chat, record it, keep building.
 9. Before any publish and before ending a session: run \`npx genex wait\` on every generation you enqueued and wire in what landed \u2014 never park landed assets. Fonts the brief names are LOADED for real, Escape pauses, the loader shows something of the game rather than a black screen, and the player wears the game's own generated character (or DESIGN.md records why it doesn't).
-10. The player's body is the game's own generated character (\`npx genex character "<look>"\` \u2192 \`npx genex controller character --character <id>\`), enqueued with your first art actions, not after them. It applies wherever a human body appears on screen \u2014 first-person included, the moment remotes, a look-down body, a shadow, or a menu portrait shows one. Games whose player is not a person (car, ship, RTS cursor, board) generate that object with \`npx genex model\` instead, or build it procedurally. Characters: Meshy/Mixamo/VRM rigs rest facing +Z. Set yaw explicitly when placing a rig; never mirror a SkinnedMesh with negative scale. In any two-character scene, verify in a capture that they face each other, not the camera.
+10. The player's body is the game's own generated character (\`npx genex character "<look>"\` \u2192 \`npx genex controller character --character <id>\`), enqueued with your first art actions, not after them. It applies wherever a human body appears on screen \u2014 first-person included, the moment remotes, a look-down body, a shadow, or a menu portrait shows one. Games whose player is not a person (car, ship, RTS cursor, board) generate that object with \`npx genex model\` instead, or build it procedurally \u2014 held to law 22's bar like everything else the player looks at. Characters: Meshy/Mixamo/VRM rigs rest facing +Z. Set yaw explicitly when placing a rig; never mirror a SkinnedMesh with negative scale. In any two-character scene, verify in a capture that they face each other, not the camera.
 11. Verify by looking: one smoke check per milestone, after that milestone's preview push, in local test mode (\`?genex_local_test=1\`) with a real gameplay screenshot. A claim without a capture is not verification. Local-test evidence proves visuals and controls ONLY \u2014 label it that way when you show the player, and never work around the draft sign-in gate any other way.
 12. Treat every \`genex\` warning line \u2014 preflight, \`ui audit\`, \`wait\` nudges \u2014 as work, not noise.
 13. Every finished Build-plan milestone ends with \`npx genex preview\` and the player's page link (\`<dashboard>/draft/<slug>\`, with \`<dashboard>\` from \`.genex/project.json\`) \u2014 never a localhost link, a file path, or the bare play origin presented as their game. That page shows the build you just previewed; \`preview\` never disturbs the build players are on. When the player is happy with it, \`npx genex promote\` makes that exact build live for everyone \u2014 no rebuild. After every round of player feedback, end with a preview push. After the first release, the game is two versions and the player only ever hears these two words for them: the **draft** (their working copy, updated by \`preview\`) and the **public version** (what everyone plays). Command names are yours, not theirs \u2014 never say "promote" to the player; ask directly: "Want me to update the public version?", one line, once per round, and keep building while you wait \u2014 updating the public version is the ONE action that waits for an explicit yes, and more change requests instead of a yes mean "not yet". The player's "publish it" / "publish the update" / "update it" / "yes" after the first release ALL mean \`genex promote\` \u2014 never \`genex publish\` again, which would ship an untried rebuild. \`promote\` ships the last previewed build, so if anything was edited since the last \`preview\`, preview again before promoting.
@@ -724,6 +724,8 @@ Important note: put soul into your creations, with many details and love. Aim to
 18. 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.
 19. If the game sells anything, it sells it for coin at a fixed, visible price, and NEVER sells chance. Run this test on any purchasable thing before building it: does the player pay (with coin, or with anything coin bought, directly or indirectly), is the outcome uncertain when they pay, and is there a prize they wanted \u2014 all three yes means it is paid randomness, and you build the deterministic version instead. That rules out loot boxes, gacha, mystery boxes, crates, card packs, prize wheels and raffles; wagering, staking, betting, coinflips and casino or slot mechanics denominated in coin; and donation prompts, tip jars or any player-to-player coin transfer, because coin buys goods and never just moves. Randomness the player EARNS by playing is gameplay, not commerce \u2014 an enemy dropping a random item, a chest found in the level, a procedural layout, a crit roll \u2014 and is completely fine. Every coin price renders its real-money equivalent beside it (the server sends one with every item), item prices sit on the platform's price grid so no player is left holding change they cannot spend, and nothing in a shop carries a countdown, "limited time", or a stock counter. When a request crosses one of these lines, name the mechanic, give the one-sentence reason, propose a specific compliant alternative, and build that \u2014 never the banned version "as an option", never a partial one, and never after asking the player to confirm they want it. Load \`$genex-monetization\` before building a shop.
 20. When the player names a specific thing to integrate \u2014 a library, a controller, an asset, a part of an existing game, or a tagged reference the platform placed in \`.genex/refs/<slug>/\` \u2014 integrate the real thing: read its source first and build from it, never a lighter look-alike written from scratch because it was faster. A tagged reference owns the subsystem it was tagged for, outranking the default lane and the vendored controllers for that subsystem. If you genuinely can't use it, say so in one plain line and ask how to proceed.
+21. A turn ends in exactly one of two ways: on a question the player must answer before the next step can be chosen, or on a handoff \u2014 the draft link, what changed, what to try, and what is still open. Never close a turn on a promise. "I'll keep building", "while I keep working", "adding that now" are things you say and then DO before you stop; if you are stopping, say that you have stopped and what remains. While the Build plan's \`Now:\` line has open work and no answer is needed from the player, the turn is not over: preview, hand off, and start the next milestone in the same turn, until the requested outcome is reached or the platform's own budget ends the session. If a stop was forced on you anyway, the first line of your next turn is the promise you left and where it stands.
+22. **What the player sees must read as the thing it is**, in this game's own style: a building as that building, a person as a person, a prop as that prop, a surface as its material \u2014 and a coloured box, a capsule, or a flat grey block standing in for one of them is never its finished version. Generation is the default route to that bar wherever code will not honestly reach it: the player's character, whatever the request names, whatever the player walks up to, enters, or interacts with, and the music and sound underneath \u2014 reach for the belt on your own judgment, without stopping to ask; a status line saying what you queued is enough, and \`--no-wait\` keeps you building while it lands. Procedural code is a first-class engine for what is structural, repeated, distant, or parametric \u2014 terrain, sky, fences, paving, modular kits, filler \u2014 and for anything else only when the result meets the same bar and you have looked at it in a capture before its row says \`landed\`. Decide per object, not per category, and write the route on each Assets row in \`DESIGN.md\` \u2014 the paid flow for generated pieces, the procedural flow with its local path for code-built ones. An Assets table with no generation in it is a decision, not a default: record it as \`Generation: none \u2014 <why code alone reaches the bar here>\` or generate.
 ${CONTRACT_END}
 `;
 var GENEX_TOOLS_CONTRACT_BLOCK = `${CONTRACT_BEGIN}
@@ -2466,10 +2468,222 @@ function relTime(iso) {
 
 // src/lib/deploy.ts
 import "child_process";
+
+// src/lib/generation-ledger.ts
+import fs12 from "fs/promises";
+import path12 from "path";
+var ledgerPath = (cwd) => path12.join(cwd, ".genex", "generations.ndjson");
+async function append(cwd, event) {
+  try {
+    await fs12.access(path12.join(cwd, ".genex"));
+    await fs12.appendFile(ledgerPath(cwd), `${JSON.stringify(event)}
+`, "utf8");
+  } catch {
+  }
+}
+async function readLedger(cwd = process.cwd()) {
+  let raw;
+  try {
+    raw = await fs12.readFile(ledgerPath(cwd), "utf8");
+  } catch {
+    return [];
+  }
+  const entries = /* @__PURE__ */ new Map();
+  for (const line of raw.split("\n")) {
+    if (!line.trim()) continue;
+    try {
+      const e = JSON.parse(line);
+      if (e.t === "q" && typeof e.id === "string" && typeof e.kind === "string") {
+        if (!entries.has(e.id)) {
+          entries.set(e.id, {
+            id: e.id,
+            kind: e.kind,
+            prompt: typeof e.prompt === "string" ? e.prompt : "",
+            ...typeof e.tail === "string" ? { promptTail: e.tail } : {},
+            queuedAt: typeof e.at === "string" ? e.at : "",
+            status: "queued"
+          });
+        }
+      } else if (e.t === "done" && typeof e.id === "string") {
+        const entry = entries.get(e.id);
+        if (entry && (e.status === "completed" || e.status === "failed")) {
+          entry.status = e.status;
+          if (Array.isArray(e.urls)) entry.urls = e.urls.filter((u) => typeof u === "string");
+        }
+      }
+    } catch {
+    }
+  }
+  return [...entries.values()];
+}
+async function recordQueued(id, kind, prompt, cwd = process.cwd()) {
+  await append(cwd, {
+    t: "q",
+    id,
+    kind,
+    prompt: prompt.slice(0, 120),
+    ...prompt.length > 120 ? { tail: prompt.slice(-120) } : {},
+    at: (/* @__PURE__ */ new Date()).toISOString()
+  });
+}
+async function recordTerminal(id, status, urls, cwd = process.cwd()) {
+  const existing = (await readLedger(cwd)).find((e) => e.id === id);
+  if (existing && existing.status === status) return;
+  await append(cwd, { t: "done", id, status, ...urls?.length ? { urls } : {} });
+}
+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/generation-plan.ts
+var LANE_OF_KIND = {
+  image: "image",
+  video: "video",
+  sfx: "sfx",
+  music: "music",
+  voice: "voice",
+  texture: "texture",
+  skybox: "skybox",
+  model: "model",
+  model_segment: "model",
+  model_rig: "model",
+  model_animation: "model",
+  character: "character",
+  character_concept: "character",
+  character_preview: "character",
+  character_animation: "character",
+  character_motion: "character",
+  motion: "motion"
+};
+var LANE_OF_SKILL = {
+  "genex-ai-model": "model",
+  "genex-ai-texture": "texture",
+  "genex-ai-image": "image",
+  "genex-ai-video": "video",
+  "genex-ai-sfx": "sfx",
+  "genex-ai-music": "music",
+  "genex-ai-voice": "voice",
+  "genex-ai-character": "character",
+  "genex-ai-hud": "image",
+  "genex-ai-menu": "image"
+};
+var LANE_COMMAND = {
+  model: "npx genex model",
+  texture: "npx genex texture",
+  image: "npx genex image",
+  video: "npx genex video",
+  sfx: "npx genex sfx",
+  music: "npx genex music",
+  voice: "npx genex voice",
+  character: "npx genex character",
+  motion: 'npx genex character animate <id> "<verb>"'
+};
+var LANE_TOKEN = /\$(genex-[a-z0-9-]+)/g;
+var PROCEDURAL_ROW = /procedural|code-built|hand-built|three\.?js|\.tsx?\b|building \(/i;
+var PAID_ROW = /\b(model|glb|mesh|texture|image|sprite|poster|decal|video|sfx|sound|music|track|voice|character|creature|motion)\b/i;
+var LANE_WORDS = [
+  [/\b(model|glb|mesh)\b/i, "model"],
+  [/\btexture\b/i, "texture"],
+  [/\b(image|sprite|poster|decal)\b/i, "image"],
+  [/\bvideo\b/i, "video"],
+  [/\b(sfx|sound)\b/i, "sfx"],
+  [/\b(music|track)\b/i, "music"],
+  [/\bvoice\b/i, "voice"],
+  [/\b(character|creature)\b/i, "character"],
+  [/\bmotion\b/i, "motion"]
+];
+var GENERATION_NONE = /^\s*Generation:\s*none\s*—/im;
+var STATUS = /\b(proposed|planned|generating|landed|wired)\b/i;
+function sectionRows(design, heading) {
+  const lines = design.split("\n");
+  const start = lines.findIndex((l) => heading.test(l));
+  if (start < 0) return [];
+  const rows = [];
+  for (let i = start + 1; i < lines.length; i += 1) {
+    const line = lines[i] ?? "";
+    if (/^##\s/.test(line)) break;
+    if (!line.trim().startsWith("|")) continue;
+    const cells = line.split("|").map((c2) => c2.trim()).filter((c2) => c2.length > 0);
+    if (cells.length === 0 || cells.every((c2) => /^:?-+:?$/.test(c2))) continue;
+    if (/^asset$/i.test(cells[0] ?? "") || /^module$/i.test(cells[0] ?? "")) continue;
+    rows.push(cells);
+  }
+  return rows;
+}
+function classify(cells) {
+  const name = cells[0] ?? "";
+  if (/^<.*>$/.test(name)) return null;
+  const rest = cells.slice(1).join(" ");
+  const status = (STATUS.exec(rest) ?? [""])[0].toLowerCase();
+  if (PROCEDURAL_ROW.test(rest)) return { name, lane: null, status, procedural: true };
+  const token = new RegExp(LANE_TOKEN.source).exec(rest)?.[1];
+  const fromSkill = token ? LANE_OF_SKILL[token] : void 0;
+  if (fromSkill) return { name, lane: fromSkill, status, procedural: false };
+  if (!PAID_ROW.test(rest) && !/https?:\/\//.test(rest) && !/generating\s*\(/i.test(rest)) return null;
+  const lane = LANE_WORDS.find(([re]) => re.test(rest))?.[1] ?? null;
+  return { name, lane, status, procedural: false };
+}
+function auditGenerationPlan(input) {
+  const { design, ledger } = input;
+  if (design.trim().length === 0) return [];
+  const assetRows = sectionRows(design, /^##\s+Assets\b/i);
+  const proceduralRows = sectionRows(design, /^##\s+Procedural assets\b/i);
+  const rows = [
+    ...assetRows.map(classify),
+    ...proceduralRows.map((c2) => {
+      const r = classify(c2);
+      return r === null ? null : { ...r, lane: null, procedural: true };
+    })
+  ].filter((r) => r !== null);
+  const declaredLanes = /* @__PURE__ */ new Set();
+  for (const m of design.matchAll(LANE_TOKEN)) {
+    const lane = m[1] ? LANE_OF_SKILL[m[1]] : void 0;
+    if (lane) declaredLanes.add(lane);
+  }
+  const lanesRun = new Set(ledger.map((e) => LANE_OF_KIND[e.kind] ?? e.kind));
+  const warnings = [];
+  const owed = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (row.procedural || row.lane === null) continue;
+    if (row.status !== "planned" && row.status !== "generating") continue;
+    if (lanesRun.has(row.lane)) continue;
+    if (row.lane === "skybox") continue;
+    const held = owed.get(row.lane) ?? [];
+    held.push(row.status === "generating" ? `${row.name} (says generating, not in this project's ledger)` : row.name);
+    owed.set(row.lane, held);
+  }
+  for (const lane of declaredLanes) {
+    if (lanesRun.has(lane) || owed.has(lane) || lane === "skybox") continue;
+    if (!rows.some((r) => r.lane === lane)) owed.set(lane, ["declared as this subsystem's lane"]);
+  }
+  for (const [lane, names] of owed) {
+    const shown = names.slice(0, 3).join(", ") + (names.length > 3 ? `, +${names.length - 3} more` : "");
+    warnings.push(
+      `DESIGN.md plans generated ${lane} work (${shown}) and this project has never run a ${lane} generation \u2014 the plan says so and the generation ledger has nothing. Generate it (${LANE_COMMAND[lane] ?? `npx genex ${lane}`} "<prompt>" --no-wait), or change the row to say what happens instead and why.`
+    );
+  }
+  const paidRows = rows.filter((r) => !r.procedural);
+  const codeRows = rows.filter((r) => r.procedural);
+  if (paidRows.length === 0 && codeRows.length >= 1 && ledger.length === 0 && !GENERATION_NONE.test(design)) {
+    warnings.push(
+      `DESIGN.md's asset plan is all code-built rows and this project has never run a generation. What the player sees must read as the thing it is (build contract, law 22): a coloured box or a capsule is not a finished building, person, or prop. Generate what the request names and what the player looks at up close (npx genex model / texture / music \u2026 --no-wait), or record "Generation: none \u2014 <why code alone reaches the bar here>" beside the table.`
+    );
+  }
+  return warnings;
+}
+
+// src/lib/deploy.ts
 import crypto3 from "crypto";
-import fs14 from "fs/promises";
+import fs15 from "fs/promises";
 import os8 from "os";
-import path13 from "path";
+import path14 from "path";
 
 // ../../packages/mobile-scan/src/image-dims.ts
 function u32be(b, o) {
@@ -2733,12 +2947,12 @@ function tierFor(estVramMb) {
 }
 
 // src/commands/ui.ts
-import fs13 from "fs/promises";
-import path12 from "path";
+import fs14 from "fs/promises";
+import path13 from "path";
 import { PNG as PNG2 } from "pngjs";
 
 // src/lib/png-tools.ts
-import fs12 from "fs/promises";
+import fs13 from "fs/promises";
 import { PNG } from "pngjs";
 var ALPHA_TRANSPARENT_MAX = 16;
 var isHttpUrl = (s) => /^https?:\/\//i.test(s);
@@ -2749,12 +2963,12 @@ async function loadPng(input) {
     if (!res.ok) throw new Error(`Couldn't fetch ${input} (HTTP ${res.status}).`);
     buf = Buffer.from(await res.arrayBuffer());
   } else {
-    buf = await fs12.readFile(input);
+    buf = await fs13.readFile(input);
   }
   return PNG.sync.read(buf);
 }
 async function writePng(file, png) {
-  await fs12.writeFile(file, PNG.sync.write(png));
+  await fs13.writeFile(file, PNG.sync.write(png));
 }
 function cropPng(image, box) {
   const out = new PNG({ width: box.w, height: box.h });
@@ -3054,7 +3268,7 @@ async function uiExtract(opts, log) {
   const dilatePx = opts.dilate ?? 0;
   const sheet = await loadPng(input);
   const { width: W, height: H, data } = sheet;
-  await fs13.mkdir(outDir, { recursive: true });
+  await fs14.mkdir(outDir, { recursive: true });
   log.plain(c.bold("genex ui extract"));
   log.dim(`  ${input} (${W}x${H}) \u2192 ${outDir}, ${names.length} names`);
   let hasTransparency = false;
@@ -3283,7 +3497,7 @@ async function uiExtract(opts, log) {
         rimPixels: speckle.sampled
       });
     }
-    const outPath = path12.join(outDir, `${name}.png`);
+    const outPath = path13.join(outDir, `${name}.png`);
     await writePng(outPath, out);
     const sidecar = {
       name,
@@ -3302,7 +3516,7 @@ async function uiExtract(opts, log) {
       defringed
     };
     const { name: _n, out: _o, ...sidecarBody } = sidecar;
-    await fs13.writeFile(
+    await fs14.writeFile(
       outPath.replace(/\.png$/i, "") + ".bbox.json",
       JSON.stringify(sidecarBody, null, 2)
     );
@@ -3311,8 +3525,8 @@ async function uiExtract(opts, log) {
       `${name}.png  ${cropW}x${cropH} (ar ${sidecar.aspectRatio}) at sheet ${padX0},${padY0}`
     );
   }
-  const debugPath = path12.join(outDir, "extract-debug.json");
-  await fs13.writeFile(
+  const debugPath = path13.join(outDir, "extract-debug.json");
+  await fs14.writeFile(
     debugPath,
     JSON.stringify(
       {
@@ -3774,7 +3988,7 @@ async function uiMasks(opts, log) {
   const registrationTolerance = opts.registrationTolerance ?? 0.04;
   const edgeFlushMax = opts.edgeFlushMax ?? 0.04;
   const loosened = registrationTolerance > 0.04 || edgeFlushMax > 0.04 || minCoverage < 0.01 || maxCoverage > 0.85;
-  await fs13.mkdir(outDir, { recursive: true });
+  await fs14.mkdir(outDir, { recursive: true });
   log.plain(c.bold("genex ui masks"));
   log.dim(`  ${input} (${image.width}x${image.height}), ${pairs.length} pair(s) \u2192 ${outDir}`);
   const sheetComponents = detectSheetComponents(image, opts.minPixels ?? 2e3);
@@ -3827,11 +4041,11 @@ async function uiMasks(opts, log) {
       });
     }
     const overlay = makeOverlay(clean2, converted.png);
-    const framePath = path12.join(outDir, `${pair.name}-frame.png`);
-    const maskPath = path12.join(outDir, `${pair.name}-mask.png`);
-    const annotatedPath = path12.join(outDir, `${pair.name}-annotated-source.png`);
-    const overlayPath = path12.join(outDir, `${pair.name}-overlay.png`);
-    const metaPath = path12.join(outDir, `${pair.name}.annotated-progress.json`);
+    const framePath = path13.join(outDir, `${pair.name}-frame.png`);
+    const maskPath = path13.join(outDir, `${pair.name}-mask.png`);
+    const annotatedPath = path13.join(outDir, `${pair.name}-annotated-source.png`);
+    const overlayPath = path13.join(outDir, `${pair.name}-overlay.png`);
+    const metaPath = path13.join(outDir, `${pair.name}.annotated-progress.json`);
     await writePng(framePath, clean2);
     await writePng(maskPath, converted.png);
     await writePng(annotatedPath, annotated);
@@ -3878,7 +4092,7 @@ async function uiMasks(opts, log) {
       },
       overlay: overlayPath
     };
-    await fs13.writeFile(metaPath, `${JSON.stringify(meta, null, 2)}
+    await fs14.writeFile(metaPath, `${JSON.stringify(meta, null, 2)}
 `);
     results.push(meta);
     const fb = converted.bbox;
@@ -3894,8 +4108,8 @@ async function uiMasks(opts, log) {
       );
     }
   }
-  const indexPath = path12.join(outDir, "annotated-progress.json");
-  await fs13.writeFile(indexPath, `${JSON.stringify({ input, loosened, pairs: results }, null, 2)}
+  const indexPath = path13.join(outDir, "annotated-progress.json");
+  await fs14.writeFile(indexPath, `${JSON.stringify({ input, loosened, pairs: results }, null, 2)}
 `);
   log.plain("");
   log.success(`Wrote ${pairs.length} frame+mask pair(s) \u2192 ${outDir} (index: ${indexPath}).`);
@@ -4021,7 +4235,7 @@ async function uiTextColor(opts, log) {
   };
   process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
-  if (opts.out) await fs13.writeFile(opts.out, `${JSON.stringify(result, null, 2)}
+  if (opts.out) await fs14.writeFile(opts.out, `${JSON.stringify(result, null, 2)}
 `);
   if (opts.cropPath) log.dim(`  crop \u2192 ${opts.cropPath}`);
 }
@@ -4053,7 +4267,7 @@ async function uiTrim(opts, log) {
   const sidecar = computeBBoxes(trimmed);
   const speckleAllowed = !!(speckle && speckle.ratio > SPECKLE_MAX_RATIO);
   const sidecarPath = outPath.replace(/\.png$/i, "") + ".bbox.json";
-  await fs13.writeFile(
+  await fs14.writeFile(
     sidecarPath,
     JSON.stringify(speckleAllowed ? { ...sidecar, speckleAllowed: true } : sidecar, null, 2)
   );
@@ -4160,7 +4374,7 @@ async function uiPlate(opts, log) {
     fail("No interior found \u2014 the image is fully transparent (or erode ate everything). Check --in / lower --erode.");
   }
   await writePng(outPath, out);
-  const name = path12.basename(outPath);
+  const name = path13.basename(outPath);
   log.plain(c.bold("genex ui plate"));
   log.success(`${outPath}  ${W}x${H}, interior ${(count / (W * H) * 100).toFixed(1)}% (erode ${erode}px)`);
   log.dim("  Wire it as the plate's silhouette (same box as the frame <img>, plate UNDER the art):");
@@ -4325,13 +4539,13 @@ async function walkFiles(dir) {
   const out = [];
   let entries;
   try {
-    entries = await fs13.readdir(dir, { withFileTypes: true });
+    entries = await fs14.readdir(dir, { withFileTypes: true });
   } catch {
     return out;
   }
   for (const entry of entries) {
     if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
-    const p = path12.join(dir, entry.name);
+    const p = path13.join(dir, entry.name);
     if (entry.isDirectory()) out.push(...await walkFiles(p));
     else out.push(p);
   }
@@ -4340,7 +4554,7 @@ async function walkFiles(dir) {
 async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   const viewportFindings = [];
   try {
-    const indexHtml = await fs13.readFile(path12.join(cwd, "index.html"), "utf8");
+    const indexHtml = await fs14.readFile(path13.join(cwd, "index.html"), "utf8");
     if (!/<meta[^>]+name=["']viewport["']/i.test(indexHtml)) {
       viewportFindings.push({
         kind: "viewport-meta",
@@ -4354,28 +4568,28 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     }
   } catch {
   }
-  const absAssets = path12.resolve(cwd, assetDir);
+  const absAssets = path13.resolve(cwd, assetDir);
   try {
-    if (!(await fs13.stat(absAssets)).isDirectory()) {
+    if (!(await fs14.stat(absAssets)).isDirectory()) {
       return viewportFindings.length > 0 ? viewportFindings : null;
     }
   } catch {
     return viewportFindings.length > 0 ? viewportFindings : null;
   }
-  const srcFiles = (await walkFiles(path12.resolve(cwd, srcDir))).filter(
-    (p) => AUDIT_SRC_EXTS.has(path12.extname(p).toLowerCase())
+  const srcFiles = (await walkFiles(path13.resolve(cwd, srcDir))).filter(
+    (p) => AUDIT_SRC_EXTS.has(path13.extname(p).toLowerCase())
   );
   try {
-    for (const name of await fs13.readdir(cwd)) {
-      const ext = path12.extname(name).toLowerCase();
-      if (ext === ".html" || ext === ".css") srcFiles.push(path12.join(cwd, name));
+    for (const name of await fs14.readdir(cwd)) {
+      const ext = path13.extname(name).toLowerCase();
+      if (ext === ".html" || ext === ".css") srcFiles.push(path13.join(cwd, name));
     }
   } catch {
   }
   const sources = [];
   for (const p of srcFiles) {
     try {
-      sources.push({ rel: path12.relative(cwd, p), text: await fs13.readFile(p, "utf8") });
+      sources.push({ rel: path13.relative(cwd, p), text: await fs14.readFile(p, "utf8") });
     } catch {
     }
   }
@@ -4385,11 +4599,11 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   const metaByName = /* @__PURE__ */ new Map();
   const bboxByPng = /* @__PURE__ */ new Map();
   for (const p of assetFiles) {
-    const base = path12.basename(p);
+    const base = path13.basename(p);
     const metaMatch = /^(.+)\.annotated-progress\.json$/.exec(base);
     if (metaMatch) {
       try {
-        const meta = JSON.parse(await fs13.readFile(p, "utf8"));
+        const meta = JSON.parse(await fs14.readFile(p, "utf8"));
         metaByName.set(metaMatch[1], {
           cleanCrop: meta.clean?.crop ?? null,
           loosened: meta.loosened === true
@@ -4400,7 +4614,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     }
     if (base.endsWith(".bbox.json")) {
       try {
-        const sidecar = JSON.parse(await fs13.readFile(p, "utf8"));
+        const sidecar = JSON.parse(await fs14.readFile(p, "utf8"));
         if (sidecar.sheetBBox) bboxByPng.set(base.replace(/\.bbox\.json$/, ".png"), sidecar.sheetBBox);
       } catch {
       }
@@ -4409,7 +4623,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   for (const [name, meta] of metaByName) {
     if (!meta.cleanCrop || !referenced(`${name}-mask.png`)) continue;
     for (const p of assetFiles) {
-      const base = path12.basename(p);
+      const base = path13.basename(p);
       if (!base.toLowerCase().endsWith(".png")) continue;
       if (base !== `${name}.png` && !base.startsWith(`${name}-`)) continue;
       if (/-mask\.png$|-frame\.png$|-overlay\.png$|-annotated-source\.png$/.test(base)) continue;
@@ -4433,7 +4647,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   }
   const pngByBase = /* @__PURE__ */ new Map();
   for (const p of assetFiles) {
-    const base = path12.basename(p);
+    const base = path13.basename(p);
     if (base.toLowerCase().endsWith(".png")) pngByBase.set(base, p);
   }
   for (const [maskBase, maskPath] of pngByBase) {
@@ -4446,8 +4660,8 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
       let frame;
       let mask;
       try {
-        frame = PNG2.sync.read(await fs13.readFile(framePath));
-        mask = PNG2.sync.read(await fs13.readFile(maskPath));
+        frame = PNG2.sync.read(await fs14.readFile(framePath));
+        mask = PNG2.sync.read(await fs14.readFile(maskPath));
       } catch {
         continue;
       }
@@ -4466,7 +4680,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     if (!referenced(base)) continue;
     let png;
     try {
-      png = PNG2.sync.read(await fs13.readFile(p));
+      png = PNG2.sync.read(await fs14.readFile(p));
     } catch {
       continue;
     }
@@ -4486,7 +4700,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
   }
   const maskReported = /* @__PURE__ */ new Set();
   for (const p of assetFiles) {
-    const m = /^(.+)\.annotated-progress\.json$/.exec(path12.basename(p));
+    const m = /^(.+)\.annotated-progress\.json$/.exec(path13.basename(p));
     if (!m) continue;
     const maskBase = `${m[1]}-mask.png`;
     if (!referenced(maskBase)) {
@@ -4498,14 +4712,14 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     }
   }
   for (const p of assetFiles) {
-    const base = path12.basename(p);
+    const base = path13.basename(p);
     if (!base.toLowerCase().endsWith(".png")) continue;
     if (/-annotated-source\.png$|-overlay\.png$/.test(base)) continue;
     if (maskReported.has(base)) continue;
     if (!referenced(base)) {
       findings.push({
         kind: "unwired-sprite",
-        message: `${path12.relative(cwd, p)} is on disk but never referenced in ${srcDir}/index.html/CSS \u2014 wire it, or record the one-line reason it was cut. (Computed-string references are invisible here \u2014 check.)`
+        message: `${path13.relative(cwd, p)} is on disk but never referenced in ${srcDir}/index.html/CSS \u2014 wire it, or record the one-line reason it was cut. (Computed-string references are invisible here \u2014 check.)`
       });
     }
   }
@@ -4692,7 +4906,7 @@ async function printUiAuditPreflight(log) {
 }
 async function printPipelineStatePreflight(log, cwd = process.cwd()) {
   try {
-    const design = await fs14.readFile(path13.join(cwd, "DESIGN.md"), "utf8").catch(() => "");
+    const design = await fs15.readFile(path14.join(cwd, "DESIGN.md"), "utf8").catch(() => "");
     const warnings = [];
     if (design.length > 0 && !/##\s*build plan & status/i.test(design)) {
       warnings.push(
@@ -4700,13 +4914,14 @@ async function printPipelineStatePreflight(log, cwd = process.cwd()) {
       );
     }
     if (!/player character:/i.test(design)) {
-      const hasCharacter = await fs14.access(path13.join(cwd, "public", "assets", "meshy-character.json")).then(() => true, () => false);
+      const hasCharacter = await fs15.access(path14.join(cwd, "public", "assets", "meshy-character.json")).then(() => true, () => false);
       if (!hasCharacter && await loadsPlayerBody(cwd)) {
         warnings.push(
           `Player character is the stock avatar \u2014 no generated character is wired. The game's own generated character is the player's body wherever a human body appears on screen, first-person included (genex-ai-character). Generate it, or record "Player character: VRM \u2014 <reason>" in DESIGN.md (no human body in this game / out of credits / player declined).`
         );
       }
     }
+    warnings.push(...auditGenerationPlan({ design, ledger: await readLedger(cwd) }));
     for (const w of warnings) log.warn(w);
   } catch {
   }
@@ -4714,12 +4929,12 @@ async function printPipelineStatePreflight(log, cwd = process.cwd()) {
 async function loadsPlayerBody(cwd) {
   const BODY_LOADERS = /\bloadPlayerCharacter\s*\(|\bloadVrm(?:Clone)?\s*\(/;
   try {
-    const entries = await fs14.readdir(path13.join(cwd, "src"), { recursive: true });
+    const entries = await fs15.readdir(path14.join(cwd, "src"), { recursive: true });
     for (const rel of entries) {
       if (rel.includes("node_modules")) continue;
-      if (rel.split(path13.sep)[0] === "controllers" || rel.startsWith("controllers/")) continue;
+      if (rel.split(path14.sep)[0] === "controllers" || rel.startsWith("controllers/")) continue;
       if (!/\.(ts|tsx|js|jsx)$/.test(rel)) continue;
-      const text = await fs14.readFile(path13.join(cwd, "src", rel), "utf8").catch(() => "");
+      const text = await fs15.readFile(path14.join(cwd, "src", rel), "utf8").catch(() => "");
       if (BODY_LOADERS.test(text)) return true;
     }
   } catch {
@@ -4756,9 +4971,9 @@ async function deployGame(ctx, opts, log) {
     }
     log.success("Built.");
   }
-  const distDir = path13.join(cwd, "dist");
+  const distDir = path14.join(cwd, "dist");
   const siteDir = await isDir(distDir) ? distDir : cwd;
-  const rel = path13.relative(cwd, siteDir) || ".";
+  const rel = path14.relative(cwd, siteDir) || ".";
   if (siteDir === cwd) await writeGitignore(cwd, log);
   const files = await collectFiles(siteDir);
   if (files.length === 0) {
@@ -4847,7 +5062,7 @@ async function deployGame(ctx, opts, log) {
 }
 async function hasBuildScript(cwd) {
   try {
-    const pkg = JSON.parse(await fs14.readFile(path13.join(cwd, "package.json"), "utf8"));
+    const pkg = JSON.parse(await fs15.readFile(path14.join(cwd, "package.json"), "utf8"));
     return Boolean(pkg.scripts?.build);
   } catch {
     return false;
@@ -4856,12 +5071,12 @@ async function hasBuildScript(cwd) {
 async function collectFiles(root) {
   const out = [];
   const walk2 = async (dir, prefix) => {
-    for (const e of await fs14.readdir(dir, { withFileTypes: true })) {
+    for (const e of await fs15.readdir(dir, { withFileTypes: true })) {
       const relPath = prefix ? `${prefix}/${e.name}` : e.name;
       if (e.isDirectory()) {
-        if (!EXCLUDE_DIRS.has(e.name)) await walk2(path13.join(dir, e.name), relPath);
+        if (!EXCLUDE_DIRS.has(e.name)) await walk2(path14.join(dir, e.name), relPath);
       } else if (e.isFile() && !isSecretEnvFile(e.name)) {
-        out.push({ relPath, bytes: await fs14.readFile(path13.join(dir, e.name)) });
+        out.push({ relPath, bytes: await fs15.readFile(path14.join(dir, e.name)) });
       }
     }
   };
@@ -5103,7 +5318,7 @@ async function pushWorktree(cwd, pushUrl, managed, log, branch = "main", onCommi
     log.error("Couldn't save your game's source \u2014 please try again.");
     return false;
   };
-  const gitDir = await fs14.mkdtemp(path13.join(os8.tmpdir(), "genex-source-"));
+  const gitDir = await fs15.mkdtemp(path14.join(os8.tmpdir(), "genex-source-"));
   const base = { GIT_DIR: gitDir };
   if (urlHasEmbeddedCredentials(pushUrl)) {
     base.GIT_CONFIG_COUNT = "1";
@@ -5118,12 +5333,12 @@ async function pushWorktree(cwd, pushUrl, managed, log, branch = "main", onCommi
   };
   try {
     if ((await run("git", ["init", "-q"], base)).code !== 0) return failed();
-    await fs14.writeFile(
-      path13.join(gitDir, "info", "exclude"),
+    await fs15.writeFile(
+      path14.join(gitDir, "info", "exclude"),
       // .env* are secrets — never publish them; `!` keeps the non-secret template.
       ["node_modules/", "dist/", ".git/", ".genex/", ".env", ".env.*", "!.env.example", ""].join("\n")
     );
-    const env = { ...base, GIT_WORK_TREE: cwd, GIT_INDEX_FILE: path13.join(gitDir, "index-source") };
+    const env = { ...base, GIT_WORK_TREE: cwd, GIT_INDEX_FILE: path14.join(gitDir, "index-source") };
     let lfs = (await run("git", ["lfs", "version"], base)).code !== 0 ? false : true;
     if (!lfs) {
       log.step("Installing git-lfs (keeps large binary assets out of the source push)\u2026");
@@ -5175,7 +5390,7 @@ async function pushWorktree(cwd, pushUrl, managed, log, branch = "main", onCommi
   } catch {
     return failed();
   } finally {
-    await fs14.rm(gitDir, { recursive: true, force: true }).catch(() => {
+    await fs15.rm(gitDir, { recursive: true, force: true }).catch(() => {
     });
   }
 }
@@ -5227,7 +5442,7 @@ async function fetchPushUrl(ctx, log, expectStagingCommit) {
 }
 async function isDir(p) {
   try {
-    return (await fs14.stat(p)).isDirectory();
+    return (await fs15.stat(p)).isDirectory();
   } catch {
     return false;
   }
@@ -5711,81 +5926,6 @@ async function promoteBuild(apiUrl, projectId, token, log) {
 // src/lib/detect-features.ts
 import fs16 from "fs/promises";
 import path15 from "path";
-
-// src/lib/generation-ledger.ts
-import fs15 from "fs/promises";
-import path14 from "path";
-var ledgerPath = (cwd) => path14.join(cwd, ".genex", "generations.ndjson");
-async function append(cwd, event) {
-  try {
-    await fs15.access(path14.join(cwd, ".genex"));
-    await fs15.appendFile(ledgerPath(cwd), `${JSON.stringify(event)}
-`, "utf8");
-  } catch {
-  }
-}
-async function readLedger(cwd = process.cwd()) {
-  let raw;
-  try {
-    raw = await fs15.readFile(ledgerPath(cwd), "utf8");
-  } catch {
-    return [];
-  }
-  const entries = /* @__PURE__ */ new Map();
-  for (const line of raw.split("\n")) {
-    if (!line.trim()) continue;
-    try {
-      const e = JSON.parse(line);
-      if (e.t === "q" && typeof e.id === "string" && typeof e.kind === "string") {
-        if (!entries.has(e.id)) {
-          entries.set(e.id, {
-            id: e.id,
-            kind: e.kind,
-            prompt: typeof e.prompt === "string" ? e.prompt : "",
-            ...typeof e.tail === "string" ? { promptTail: e.tail } : {},
-            queuedAt: typeof e.at === "string" ? e.at : "",
-            status: "queued"
-          });
-        }
-      } else if (e.t === "done" && typeof e.id === "string") {
-        const entry = entries.get(e.id);
-        if (entry && (e.status === "completed" || e.status === "failed")) {
-          entry.status = e.status;
-          if (Array.isArray(e.urls)) entry.urls = e.urls.filter((u) => typeof u === "string");
-        }
-      }
-    } catch {
-    }
-  }
-  return [...entries.values()];
-}
-async function recordQueued(id, kind, prompt, cwd = process.cwd()) {
-  await append(cwd, {
-    t: "q",
-    id,
-    kind,
-    prompt: prompt.slice(0, 120),
-    ...prompt.length > 120 ? { tail: prompt.slice(-120) } : {},
-    at: (/* @__PURE__ */ new Date()).toISOString()
-  });
-}
-async function recordTerminal(id, status, urls, cwd = process.cwd()) {
-  const existing = (await readLedger(cwd)).find((e) => e.id === id);
-  if (existing && existing.status === status) return;
-  await append(cwd, { t: "done", id, status, ...urls?.length ? { urls } : {} });
-}
-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()) {
   try {
     const raw = await fs16.readFile(path15.join(cwd, "package.json"), "utf8");
@@ -19391,7 +19531,7 @@ var EXPECT_DIR = {
   bl: [D, -D],
   br: [-D, -D]
 };
-function classify(stemRaw) {
+function classify2(stemRaw) {
   const stem = stemRaw.replace(/-s\d+$/, "");
   if (stem.includes("jump") || stem.includes("ollie") || stem.includes("trick")) {
     return { kind: "oneshot", expect: null };
@@ -19782,7 +19922,7 @@ function score(kind, m, gates = DEFAULT_GATES) {
 }
 function analyzeTake(stem, buf, gates = DEFAULT_GATES) {
   const t = loadTake(buf);
-  const { kind, expect } = classify(stem);
+  const { kind, expect } = classify2(stem);
   const F = t.F;
   const lo = kind !== "oneshot" ? Math.min(RAMP, Math.max(4, Math.floor(F / 4))) : 8;
   const w = [lo, F - Math.min(TAIL, Math.max(2, Math.floor(F / 8)))];
@@ -20047,7 +20187,7 @@ function compileSet(inputs, setName, cfg = DEFAULT_MOTION_CONFIG) {
   const gaits = {};
   const aimTakes = [];
   for (const { stem, take } of inputs) {
-    const { kind } = classify(stem);
+    const { kind } = classify2(stem);
     const aim = /aim|rifle|pistol/.test(stem);
     if (aim && (kind === "idle" || kind === "freeform")) aimTakes.push({ stem, take });
     if (kind === "loco") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.13.1-dev.558",
+  "version": "1.13.2-dev.559",
   "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

@@ -9,13 +9,17 @@ Turn a text prompt into a real, game-ready **GLB** and drop it into the project.
 
 ## When to use this vs. procedural geometry
 
-- **Use `npx genex model`** for a specific, recognizable object — a barrel, a chair, a
-  sword, a spaceship, an animal. You get a real textured mesh.
-- **Use `$genex-threejs-procedural-assets`** when code is the more efficient
-  engine: structures and buildings, modular kits, and anything placed many
-  times with variation (editable, seeded, no GLB file). Mixing both in one
-  scene is the normal way to build a detailed world — generated hero pieces
-  over procedural dressing.
+- **Use `npx genex model`** for a specific, recognizable object the player will
+  look at — a barrel, a chair, a sword, a spaceship, an animal, a named
+  building, the thing the request asked for. You get a real textured mesh, and
+  this is the default route whenever code would not honestly make the object
+  read as itself.
+- **Use `$genex-threejs-procedural-assets`** for what is structural, repeated,
+  distant, or parametric — modular kits, fences, walls, paving, terrain,
+  anything placed many times with variation (editable, seeded, no GLB file) —
+  and for a close-up object only when the code result meets the same bar and
+  you have checked it in a capture. Mixing both in one scene is the normal way
+  to build a detailed world.
 
 **The output is a STATIC, unrigged mesh by default — no skeleton, no animation
 clips.** A "wolf" or "guard" from this command can be posed and moved as one

package/templates/skills/genex-game-director/SKILL.md

@@ -1,14 +1,19 @@
 ---
 name: genex-game-director
-description: The lightweight Genex request router. Read the latest game, tool, component, or focused-change request; ask only genuinely unresolved build forks; keep DESIGN.md current; and load only the Genex skills that the requested work actually needs. Use first for new work, resumed work, or whenever ownership is unclear.
+description: The Genex request router. Read the latest game, tool, component, or focused-change request; ask only genuinely unresolved build forks; keep DESIGN.md current; and load each owning lane BEFORE the first file of the subsystem it owns — only the lanes the work touches, never the whole pack, and never fewer than the work needs. Use first for new work, resumed work, or whenever ownership is unclear.
 ---
 
 # Genex Game Director
 
 The player chooses what to build and in what order. You route that request;
-the owning Genex skills control how their lanes run. Load only skills that
-change the requested result—never the whole pack by default, and never
-commission unrelated work because an old workflow listed it.
+the owning Genex skills control how their lanes run.
+
+Routing binds in BOTH directions: load only the lanes the requested work
+touches — never the whole pack by default, and never unrelated work because an
+old workflow listed it — and load a lane BEFORE the first file of the subsystem
+it owns. A matching row in the routing map is not a suggestion: each lane
+exists because writing that subsystem without it ships a known defect.
+Loading one lane never commissions another.
 
 **After any context compaction or session resume**, re-read the project's
 `AGENTS.md`, `DESIGN.md` when present, and the skill for the work you are
@@ -103,32 +108,56 @@ Never invent a provider generation ID for local code. Sections for gameplay,
 content, UI, world, assets, multiplayer, character/animation, tools, or
 modules are conditional on the request and existing project.
 
-## 4. Route to the owning lane
-
-Use the [routing map](references/routing-map.md) for exact ownership. The main
-Genex asset and runtime lanes are:
-
-- `npx genex model "<prompt>"`—a generated GLB (also `--image` from a
-  reference picture, `model segment` into named parts, `model rig` +
-  `model animate` for non-biped bodies) → `$genex-ai-model`
-- `npx genex texture "<prompt>"`—a generated surface → `$genex-ai-texture`
-- sky, horizon, time of day, weather mood—built in code, never generated; no
-  command and no skill owns it, so pick what this game needs
-- `npx genex sfx "<prompt>"` / `music` / `voice` →
-  `$genex-ai-sfx`, `$genex-ai-music`, `$genex-ai-voice`
-- `npx genex image "<prompt>"` / `video`—2D and motion art →
-  `$genex-ai-image`, `$genex-ai-video`
-- UI, HUD, and menu requests → `$genex-threejs-game-ui`,
-  `$genex-ai-hud`, `$genex-ai-menu`
-- `npx genex character`, `creature`, and their motion commands →
-  `$genex-ai-character`, `$genex-threejs-creatures`
-- movement and vehicles → `$genex-threejs-character-controller`,
-  `$genex-threejs-vehicle-controllers`
-- phone input and phone-survivable rendering →
-  `$genex-threejs-touch-controls`, `$genex-threejs-adaptive-quality`
-- structures, buildings, modular kits, repeated or varied environment pieces,
-  and parameterized objects — code is often the more efficient engine for
-  these → `$genex-threejs-procedural-assets`
+## 4. Routing map — load the owning lane before the first file
+
+For every subsystem the current milestone touches, find its row below, load
+that skill, and write the lane beside the work in `DESIGN.md` — a `Lane` cell
+on the module's row in the Modules table, or a `Lane:` line under `Now:` in
+focused or step-by-step work. `Lane: none — <why>` is the only way to write a
+subsystem with no lane. Then write the code. Never reconstruct a lane's API or
+vendored code from memory of another engine.
+
+| Work needed | Load |
+| --- | --- |
+| shot composition, chase/side/orbit rigs, camera handoffs, projection ownership, pointer look, mouse-aimed action, mouse-look, the screen-direction contract for hand-rolled steering/pan/look input signs, floating origins | `$genex-threejs-camera-direction` |
+| on-foot player movement: walk/run/jump/crouch, third-person character, slopes, stairs, moving platforms, the player's body loader, directional locomotion, transitions, action motion | `$genex-threejs-character-controller` |
+| **attacking, casting, aiming or reloading WHILE moving** — any action the legs must keep running under; a weapon carry stance over stock locomotion; a wind-up the character holds while walking | `$genex-threejs-character-controller` (`references/animations.md`, upper-body layering) |
+| dash, dodge, roll, blink, backstep, a lunging attack — any burst that moves the character itself | `$genex-threejs-character-controller` (`references/tuning-and-presets.md`, dash recipe) |
+| the game's own generated character—the player's body wherever a human body appears—or Meshy animation coverage beyond the stock pack: reference-informed A-pose concepts, exact action IDs, same-rig adapter | `$genex-ai-character` + `$genex-threejs-character-controller` |
+| a character/enemy needs motion the catalog lacks—a signature move, boss telegraph, death, full 8-way set, or the player's footage; free plan before spend | `$genex-ai-character` motion section + `references/motion-generation.md` |
+| remote player bodies in multiplayer—never hand-built primitives: the game's generated character when it has one, otherwise the player's `p.avatarUrl` VRM | `$genex-threejs-multiplayer` + `$genex-threejs-character-controller` |
+| enemies, NPCs, or creatures: rigged bipeds via `npx genex creature`; non-biped body plans (quadruped, flier, serpent, aquatic, multi-leg) via `npx genex model rig` + `model animate`; static plus procedural motion only for shapes with no body plan; collider, facing, hit reaction, death | `$genex-threejs-creatures` |
+| cars, drones, vehicle physics, gearbox, character↔vehicle enter/exit | `$genex-threejs-vehicle-controllers` |
+| playable on phones: joystick, virtual buttons, drag zones, genre touch recipes, rotate-device overlay | `$genex-threejs-touch-controls` |
+| phone-survivable rendering: device tiers, DPR/shadow/post budgets, runtime governor, generated-asset rungs, Quality picker, dispose-on-swap | `$genex-threejs-adaptive-quality` |
+| anything falls, collides, gets pushed, or needs colliders/events | `$genex-threejs-physics-rapier` |
+| launch/docking timelines, authored transform phases, springs, convergence, deterministic prop/debris motion | `$genex-threejs-procedural-animation` |
+| rebuild a reference prop, hard-surface object, modular decoration, or structural environment piece (kits, fences, walls, paving) as editable parameterized Three.js code — held to the asset bar at the end of this section | `$genex-threejs-procedural-assets` |
+| stylized/abstract shader-authored materials, the procedural/PBR material boundary | `$genex-threejs-procedural-assets` |
+| particles, trails, plasma, shockwaves, pooled bursts, and event effects | `$genex-threejs-procedural-vfx` |
+| stable large-world shadows, cascades, clipmaps, cached updates | `$genex-threejs-shadow-systems` |
+| eye adaptation, tone mapping, output color, LUT grading, and proven static grain | `$genex-threejs-exposure-color-grading` |
+| fixed-view screenshots, input direction, facing, temporal and budget evidence | `$genex-threejs-visual-validation` |
+| the default for a concrete object the player looks at up close: a generated GLB for a prop, vehicle, building, or object — from text or a reference image (`--image`); split into named parts (`model segment`); rig + animate any mesh (`model rig` / `model animate`) | `$genex-ai-model` |
+| generated surface or terrain texture with real-world UV scale | `$genex-ai-texture` |
+| sky, skybox, horizon, time of day, weather mood, night or space backdrop | build it in code in the scene—there is no sky command and no owning skill, so pick the technique this game needs |
+| poster, sign, sprite, decal, reference sheet, or other 2D art | `$genex-ai-image` |
+| in-world motion art or another requested video | `$genex-ai-video` |
+| sound effect, one looping music bed, or a short spoken line | `$genex-ai-sfx`, `$genex-ai-music`, or `$genex-ai-voice` |
+| requested UI/HUD/menu/interface work, a visible UI problem, or an interface you decided this game wants built with generated art | `$genex-threejs-game-ui` |
+| selling anything for platform coin: a shop, an item catalog, boosts, cosmetics, "make it earn"; also any request for a loot box, gacha, wager, casino mechanic or donation prompt, which that skill refuses and replaces | `$genex-monetization` |
+| cinematic menu/title/pause/victory/defeat/lobby/credits video treatment | `$genex-ai-menu` |
+| drawn HUD chrome the game's style wants—one element or a matched set of frames, masks, and icons | `$genex-ai-hud` |
+| the game works but feels flat, floaty, or unresponsive: input response, camera, impacts, cooldowns, difficulty, fail/retry | `$genex-threejs-game-feel` |
+| realtime multiplayer: movement sync, shared ball/NPC, host-run scores/enemies, shots/emotes, persistence | `$genex-threejs-multiplayer` |
+| players talking to each other by TEXT — chat, room chat, "let them type to each other" (`room.chat` + `npx genex controller chat`) | `$genex-threejs-multiplayer` |
+| players TALKING — voice chat, mic, "hear each other", proximity/positional voice (`room.voice` + `npx genex controller voice`; party-sized, max 6 per room — say that number out loud before building the feature) | `$genex-threejs-multiplayer` |
+| player identity, sign-in, guests, saves/progress, per-player state, shared persistent world, leaderboards—mandatory for every game | `$genex-threejs-embed-auth` |
+| the player EXPLICITLY asks to make an asset or publish something from their game as an asset for the free library | `$genex-asset-author` (`genex asset new`) — never offer this unprompted; no game duty routes here |
+
+Request-shape rules, working modes and the protected-lane handoffs stay in the
+[routing map](references/routing-map.md); read it when the request shape, not
+the subsystem, is what is unclear.
 
 For “make this image 3D,” ask **one** route question only when both results
 honestly fit: a generated GLB built from the picture itself
@@ -145,12 +174,23 @@ supplied and creating one is part of the requested work, use the existing
 Assets row.
 
 The request sets the floor for the asset plan, never the ceiling: a world
-should feel dressed and alive, so plan the detail its genre implies — and pick
-the more efficient engine per object. Paid generation buys hero pieces (the
-player's character, key props, music); procedural code is the
-unlimited detail engine for structures, buildings, modular kits, and repeated
-or varied dressing (`$genex-threejs-procedural-assets` owns that lane) — and
-for the sky, which is never generated at all. Mixing
+should feel dressed and alive, so plan the detail its genre implies — and
+choose the engine per object, never per category. The bar is the same for both
+engines: whatever the player looks at must read as the thing it is, in this
+game's own style — a building as that building, a person as a person, a prop as
+that prop. A coloured box, a capsule or a flat grey block is not a finished
+version of any of them. Generation is the default route to that bar wherever
+code will not honestly reach it: the player's character, anything the request
+names, anything the player walks up to, enters, or interacts with, and the
+music and sound under it. Procedural code (`$genex-threejs-procedural-assets`)
+is a first-class engine for what is structural, repeated, distant, or
+parametric — terrain, sky (never generated), fences, paving, modular kits,
+filler — and for anything else only when the result meets the same bar and you
+have checked it in a capture before its row says `landed`. Write the route on
+each Assets row: the paid flow for generated pieces, the procedural flow with
+its local path for code-built ones — the table is where the per-object decision
+lives, and a table with no generated row records
+`Generation: none — <why code alone reaches the bar here>` beside it. Mixing
 both in one scene is the normal way to build, never a fallback. In focused
 work, stay inside the touched scope. Run independent planned generations with
 `--no-wait`, scaffold while they land, and preserve their IDs, URLs, and

package/templates/skills/genex-game-director/references/design-contract.md

@@ -37,11 +37,15 @@ so it survives a long pause, context compaction, handoff, and remix.
   status flow `proposed → planned → generating (id) → landed (URL) → wired`.
   A landed asset is unfinished until wired or visibly cancelled. Preserve
   generation IDs, permanent URLs, local outputs, and wiring state across
-  compaction.
+  compaction. Every row shows its route: generated rows carry the paid flow;
+  code-built rows carry the procedural flow and a local path. A table with no
+  generated row at all carries `Generation: none — <why code alone reaches the
+  bar here>` beside it (build contract, law 22).
 - **Code-built procedural assets use their own truthful status flow:**
   `proposed → planned → building (blockout | detail | material | runtime) →
   landed (<local TypeScript path>) → wired`. They never invent a provider
-  generation ID. A generated reference image is a separate normal Assets row.
+  generation ID. `landed` on a code-built row means a capture at gameplay
+  distance showed it reads as the thing it is. A generated reference image is a separate normal Assets row.
 - Sections are request-driven. Gameplay, content, UI, assets, world,
   multiplayer, character/animation, tools, modules, and procedural assets
   appear only when the request or existing project uses them.
@@ -73,6 +77,7 @@ or explicitly re-scope it.>
 Working mode: <whole coordinated build | step by step | focused change>
 Now: ▶ <number/name of the current milestone or focused task>
 Done when: <one plain, observable condition for the current work>
+Lane: <$genex-… owning the current subsystem | none — why no row matches>
 1. <milestone> — ✅ → previewed
 2. <milestone> — ▶ in progress (<main agent | sub-agent>)
 3. <milestone> — ⏸ paused (<reason>)
@@ -121,7 +126,10 @@ Menu video: <generation id/URL, or the still standing in while it renders>
 | <asset> | <model/image/texture/…> | planned | — |
 | <asset> | <kind> | generating (<id>) | — |
 | <asset> | <kind> | landed → <URL> | yes/no |
+| <asset> | procedural-code | building (blockout) | — |
 Status flow: proposed → planned → generating (id) → landed (URL) → wired.
+Code-built rows: proposed → planned → building (…) → landed (<local path>) → wired.
+Generation: none — <why code alone reaches the bar in this game> (only when no row is generated)
 
 **HUD pipeline state (only while the sprites lane is running) — keep this
 current; it is how that pipeline survives a context compaction.**
@@ -152,9 +160,9 @@ Play-button rule: nothing connects before the click when a Play screen exists.
 Verification still open: <two-identity/netcode evidence>
 
 ## Modules (whole coordinated mode or another useful split only)
-| Module | Owns files | Built by | Done when |
-|---|---|---|---|
-| <request-derived stream> | <disjoint paths> | <parallel/serial + reason> | <observable result> |
+| Module | Lane | Owns files | Built by | Done when |
+|---|---|---|---|---|
+| <request-derived stream> | <$genex-… or none — why> | <disjoint paths> | <parallel/serial + reason> | <observable result> |
 
 ## Verification evidence
 - <preview URL/date and what it proves>

package/templates/skills/genex-game-director/references/routing-map.md

@@ -34,49 +34,17 @@ copy demo architecture.
 
 ## Route by system
 
-| Work needed | Load |
-| --- | --- |
-| shot composition, chase/side/orbit rigs, camera handoffs, projection ownership, pointer look, mouse-aimed action, mouse-look, the screen-direction contract for hand-rolled steering/pan/look input signs, floating origins | `$genex-threejs-camera-direction` |
-| on-foot player movement: walk/run/jump/crouch, third-person character, slopes, stairs, moving platforms, the player's body loader, directional locomotion, transitions, action motion | `$genex-threejs-character-controller` |
-| **attacking, casting, aiming or reloading WHILE moving** — any action the legs must keep running under; a weapon carry stance over stock locomotion; a wind-up the character holds while walking | `$genex-threejs-character-controller` (`references/animations.md`, upper-body layering) |
-| dash, dodge, roll, blink, backstep, a lunging attack — any burst that moves the character itself | `$genex-threejs-character-controller` (`references/tuning-and-presets.md`, dash recipe) |
-| the game's own generated character—the player's body wherever a human body appears—or Meshy animation coverage beyond the stock pack: reference-informed A-pose concepts, exact action IDs, same-rig adapter | `$genex-ai-character` + `$genex-threejs-character-controller` |
-| a character/enemy needs motion the catalog lacks—a signature move, boss telegraph, death, full 8-way set, or the player's footage; free plan before spend | `$genex-ai-character` motion section + `references/motion-generation.md` |
-| remote player bodies in multiplayer—never hand-built primitives: the game's generated character when it has one, otherwise the player's `p.avatarUrl` VRM | `$genex-threejs-multiplayer` + `$genex-threejs-character-controller` |
-| enemies, NPCs, or creatures: rigged bipeds via `npx genex creature`; non-biped body plans (quadruped, flier, serpent, aquatic, multi-leg) via `npx genex model rig` + `model animate`; static plus procedural motion only for shapes with no body plan; collider, facing, hit reaction, death | `$genex-threejs-creatures` |
-| cars, drones, vehicle physics, gearbox, character↔vehicle enter/exit | `$genex-threejs-vehicle-controllers` |
-| playable on phones: joystick, virtual buttons, drag zones, genre touch recipes, rotate-device overlay | `$genex-threejs-touch-controls` |
-| phone-survivable rendering: device tiers, DPR/shadow/post budgets, runtime governor, generated-asset rungs, Quality picker, dispose-on-swap | `$genex-threejs-adaptive-quality` |
-| anything falls, collides, gets pushed, or needs colliders/events | `$genex-threejs-physics-rapier` |
-| launch/docking timelines, authored transform phases, springs, convergence, deterministic prop/debris motion | `$genex-threejs-procedural-animation` |
-| rebuild a reference prop, hard-surface object, modular decoration, or simple environment piece as editable parameterized Three.js code | `$genex-threejs-procedural-assets` |
-| stylized/abstract shader-authored materials, the procedural/PBR material boundary | `$genex-threejs-procedural-assets` |
-| particles, trails, plasma, shockwaves, pooled bursts, and event effects | `$genex-threejs-procedural-vfx` |
-| stable large-world shadows, cascades, clipmaps, cached updates | `$genex-threejs-shadow-systems` |
-| eye adaptation, tone mapping, output color, LUT grading, and proven static grain | `$genex-threejs-exposure-color-grading` |
-| fixed-view screenshots, input direction, facing, temporal and budget evidence | `$genex-threejs-visual-validation` |
-| a generated GLB for a concrete prop, vehicle, building, or object — from text or a reference image (`--image`); split into named parts (`model segment`); rig + animate any mesh (`model rig` / `model animate`) | `$genex-ai-model` |
-| generated surface or terrain texture with real-world UV scale | `$genex-ai-texture` |
-| sky, skybox, horizon, time of day, weather mood, night or space backdrop | build it in code in the scene—there is no sky command and no owning skill, so pick the technique this game needs |
-| poster, sign, sprite, decal, reference sheet, or other 2D art | `$genex-ai-image` |
-| in-world motion art or another requested video | `$genex-ai-video` |
-| sound effect, one looping music bed, or a short spoken line | `$genex-ai-sfx`, `$genex-ai-music`, or `$genex-ai-voice` |
-| requested UI/HUD/menu/interface work, a visible UI problem, or an interface you decided this game wants built with generated art | `$genex-threejs-game-ui` |
-| selling anything for platform coin: a shop, an item catalog, boosts, cosmetics, "make it earn"; also any request for a loot box, gacha, wager, casino mechanic or donation prompt, which that skill refuses and replaces | `$genex-monetization` |
-| cinematic menu/title/pause/victory/defeat/lobby/credits video treatment | `$genex-ai-menu` |
-| drawn HUD chrome the game's style wants—one element or a matched set of frames, masks, and icons | `$genex-ai-hud` |
-| the game works but feels flat, floaty, or unresponsive: input response, camera, impacts, cooldowns, difficulty, fail/retry | `$genex-threejs-game-feel` |
-| realtime multiplayer: movement sync, shared ball/NPC, host-run scores/enemies, shots/emotes, persistence | `$genex-threejs-multiplayer` |
-| players talking to each other by TEXT — chat, room chat, "let them type to each other" (`room.chat` + `npx genex controller chat`) | `$genex-threejs-multiplayer` |
-| players TALKING — voice chat, mic, "hear each other", proximity/positional voice (`room.voice` + `npx genex controller voice`; party-sized, max 6 per room — say that number out loud before building the feature) | `$genex-threejs-multiplayer` |
-| player identity, sign-in, guests, saves/progress, per-player state, shared persistent world, leaderboards—mandatory for every game | `$genex-threejs-embed-auth` |
-| the player EXPLICITLY asks to make an asset or publish something from their game as an asset for the free library | `$genex-asset-author` (`genex asset new`) — never offer this unprompted; no game duty routes here |
+The ownership table lives in **SKILL.md §4** so it is in front of you the
+moment the director loads, rather than behind a link you have to decide to
+open. This file keeps the request-shape and working-mode rules; read it when
+the shape of the request, not the owning subsystem, is what is unclear.
 
 ## Request-sized execution
 
 ### Focused work
 
-Load only the owning row or rows, preserve the current architecture, implement
+Load the owning row or rows — before the first file of each subsystem, and
+none beyond the work — preserve the current architecture, implement
 the requested result, and run its relevant check. UI work routes directly to
 UI; movement routes directly to movement; publishing routes directly to the
 existing publish flow. Do not add a concept, unrelated asset batch, full-game
@@ -132,12 +100,12 @@ flow and state what remains.
 
 ## Procedural assets (code-built)
 
-Use `$genex-threejs-procedural-assets` whenever code is the more efficient
-engine for an object — structures, buildings, modular kits, repeated or varied
-props, parameterized objects — or when the player asks for procedural,
-parametric, or code-built work. It is a first-class lane, not a fallback, and
-mixing it with generated GLBs in one scene is the normal way to build a
-detailed world. An image alone still doesn't decide the route (ask the one
+Use `$genex-threejs-procedural-assets` whenever code will honestly make the
+object read as the thing it is — structural pieces, modular kits, repeated or
+varied props, parameterized objects — or when the player asks for procedural,
+parametric, or code-built work. It is a first-class lane, not a fallback, held
+to the same bar as a generated GLB, and mixing it with generated GLBs in one
+scene is the normal way to build a detailed world. An image alone still doesn't decide the route (ask the one
 route question when both honestly fit), and never use it for player bodies,
 rigged characters/creatures, or animation.
 

package/templates/skills/genex-threejs-procedural-assets/SKILL.md

@@ -1,30 +1,34 @@
 ---
 name: genex-threejs-procedural-assets
-description: Build editable, parameterized Three.js objects in code — structures, buildings, modular kits, repeated or varied props — whenever code is the more efficient engine for them, or the user asks for procedural/parametric work. A first-class lane alongside generated GLBs; mix both freely.
+description: Build editable, parameterized Three.js objects in code — modular kits, structural pieces, repeated or varied props, and any object code will honestly make read as the thing it is — or whenever the user asks for procedural/parametric work. A first-class lane alongside generated GLBs, held to the same bar; mix both freely.
 ---
 
 # Genex Three.js Procedural Assets
 
 Build a recognizable asset as local, editable Three.js code. This lane is a
-first-class engine, not a fallback: for structures, buildings, modular kits,
-and anything placed many times with variation, code is often more efficient
-than a generated GLB — and mixing procedural pieces with generated hero
-pieces in the same scene is the normal way to build a detailed, lively world.
+first-class engine, not a fallback — and it is held to the same bar as a
+generated GLB: the result must read as the thing it is when the player looks at
+it, in the game's own style. A coloured box or a flat grey block is a blockout,
+never a landed asset. Mixing procedural pieces with generated pieces in the
+same scene is the normal way to build a detailed, lively world.
 
 ## Choose the route
 
 - Start directly when the user says procedural, parametric, code-built,
   customizable, seeded, or asks for controlled variations.
-- Also start directly when code is plainly the efficient route: buildings and
-  structures, modular environment kits, fences, pipes, rails, and anything
-  placed many times with variation.
+- Also start directly for what is structural, repeated, distant, or
+  parametric: terrain, modular environment kits, fences, pipes, rails, walls,
+  paving, and anything placed many times with variation.
+- For anything the player looks at up close, walks into, or interacts with — a
+  named building, a signature prop, a vehicle — code is a choice, not a
+  default: take it only when you will honestly reach the bar above, and confirm
+  it in a capture at gameplay distance before the row reads `landed`. Otherwise
+  `$genex-ai-model` owns it.
 - An attached or available image does not activate this skill by itself.
 - If “make this image 3D” could honestly mean either route, ask exactly one
   question: **“Do you want a generated textured GLB, or editable procedural
   Three.js code?”**
 - Use `$genex-ai-model` when the user chooses a generated textured GLB.
-- Use this skill for props, hard-surface objects, modular decorations, and
-  simple structures or environment pieces.
 - Do not use it for characters, creatures, rigging, skeletal animation, or
   character likeness. Keep those in their existing specialist lanes.
 
@@ -60,6 +64,9 @@ proposed → planned → building (blockout | detail | material | runtime)
 → landed (<local TypeScript path>) → wired
 ```
 
+`landed` means a capture at gameplay distance showed it reads as the thing it
+is — not that the file exists.
+
 A Genex-generated reference keeps its separate image row and normal paid
 generation status. Note that the procedural-code row is derived from that
 image. A private user reference is not a paid generation row.