@genex-ai/cli-demo 1.13.1-dev.558 → 1.14.0-dev.560

package/dist/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
-  BLENDER_SETUP_HINT,
   RENDER_MODES,
   SHEET_FORMATS,
   acquireSeat,
   apiFetch,
   blenderCall,
   blenderEndpoint,
+  blenderSetupHint,
   fetchSignedInEmail,
   getWorkspacePath,
   isRenderMode,
@@ -22,7 +22,7 @@ import {
   writeProject,
   writeUserToken,
   writeWorkspace
-} from "./chunk-WXHTNSFB.js";
+} from "./chunk-2UJK5OCB.js";
 import {
   CLI_CHANNEL,
   DEFAULT_API_URL,
@@ -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 a live Blender for composing levels and interiors \u2014 \`blender scene|exec|snap|import|export\` (hosted sessions with the GPU lane on, or \`blender serve\` on your own machine; the \`genex-blender-scene\` skill owns it) \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") {
@@ -20473,7 +20613,7 @@ async function runMotion(opts) {
 // src/commands/blender.ts
 import fs23 from "fs/promises";
 import path22 from "path";
-var SUBS2 = ["demo", "exec", "snap", "scene", "export", "reset", "mcp", "serve"];
+var SUBS2 = ["demo", "exec", "snap", "scene", "import", "export", "reset", "mcp", "serve"];
 var DEFAULT_OUT_DIR = "assets/blender";
 async function writeB64(dir, name, b64) {
   await fs23.mkdir(dir, { recursive: true });
@@ -20504,7 +20644,7 @@ async function runBlender(opts) {
     return serveLocalBlender({ port, log });
   }
   if (sub === "mcp") {
-    const { runBlenderMcp } = await import("./blender-mcp-LLN4FPA4.js");
+    const { runBlenderMcp } = await import("./blender-mcp-3U5AG7WS.js");
     return runBlenderMcp();
   }
   let base = blenderEndpoint();
@@ -20519,8 +20659,8 @@ async function runBlender(opts) {
     return 1;
   }
   if (!base) {
-    const [first, ...rest] = BLENDER_SETUP_HINT.split("\n");
-    log.error(first ?? "GENEX_BLENDER_URL is not set");
+    const [first, ...rest] = blenderSetupHint().split("\n");
+    log.error(first ?? "No Blender endpoint");
     log.plain(rest.join("\n"));
     return 1;
   }
@@ -20566,12 +20706,31 @@ async function runBlender(opts) {
     case "export": {
       const target = opts.out ?? path22.join(outDir, "scene.glb");
       const r = await blenderCall(base, "/export", { path: "/tmp/genex-export.glb" });
+      if (!r.glbBase64) {
+        log.error(`/export answered with no GLB bytes${r.uploaded ? " (it was uploaded, not inlined)" : ""}`);
+        return 1;
+      }
       await fs23.mkdir(path22.dirname(target), { recursive: true });
-      await fs23.writeFile(target, Buffer.from(r.glbBase64 ?? "", "base64"));
+      await fs23.writeFile(target, Buffer.from(r.glbBase64, "base64"));
       log.success(`Exported ${r.bytes ?? 0} bytes`);
       log.plain(`  ${c.cyan(target)}`);
       return 0;
     }
+    case "import": {
+      const url = opts.importUrl?.trim();
+      if (!url || !/^https?:\/\//.test(url)) {
+        log.error("genex blender import needs a GLB URL: genex blender import https://\u2026/model-glb");
+        return 1;
+      }
+      const r = await blenderCall(base, "/import", { url });
+      log.success(`imported ${r.count ?? 0}: ${(r.imported ?? []).join(", ") || "(nothing)"}`);
+      const snap = await blenderCall(base, "/render", { ...mode ? { mode } : {}, sheet: { formats: SHEET_FORMATS } });
+      const sheet = sheetOf(snap);
+      if (sheet) log.plain(`  ${c.cyan(await writeB64(outDir, `contact-sheet.${sheetExt(sheet.mime)}`, sheet.b64))}`);
+      const info = await blenderCall(base, "/scene");
+      reportScene(log, info);
+      return 0;
+    }
     case "exec":
     case "demo": {
       let script;
@@ -21594,6 +21753,13 @@ ${c.bold("Usage")}
                                      signature move. --lean keeps movement to forward
                                      walk + run (enemies follow a path).
   genex animations search "<intent>" Search Meshy's animation library by gameplay intent.
+  genex blender <verb>               Compose a level or interior in a live Blender \u2014
+                                     scene | exec --in <file.py> | snap [--mode \u2026] |
+                                     import <glb-url> | export --out <file.glb> | reset.
+                                     Hosted sessions get a GPU seat on first use; at a
+                                     terminal run 'genex blender serve' against your
+                                     own Blender. Every scene change writes
+                                     ./assets/blender/contact-sheet.webp \u2014 look at it.
   genex wait <id>                    Attach to a generation enqueued with --no-wait and
                                      print its asset URL(s) when it finishes. Safe to
                                      re-run \u2014 it never creates a new generation.
@@ -22290,6 +22456,13 @@ function parseArgs(argv) {
             parsed.error = `Unexpected argument: ${arg}`;
             return parsed;
           }
+        } else if (parsed.command === "blender") {
+          if (parsed.options.name === "import" && parsed.options.importUrl === void 0) {
+            parsed.options.importUrl = arg;
+          } else {
+            parsed.error = `Unexpected argument: ${arg}`;
+            return parsed;
+          }
         } else {
           parsed.error = `Unexpected argument: ${arg}`;
           return parsed;
@@ -22810,9 +22983,8 @@ async function main() {
       case "ui":
         await runUi({ ...parsed.options, sub: parsed.options.name });
         break;
-      // HIDDEN from --help: the M1 test surface for the Blender service spike
-      // (apps/blender-service). Gated on GENEX_BLENDER_URL, which no hosted
-      // stand sets, so this is a local-only verb until that service is real.
+      // The Blender surface (apps/blender-service): a hosted seat, an explicit
+      // GENEX_BLENDER_URL, or `blender serve` — see commands/blender.ts.
       case "blender":
         process.exitCode = await runBlender({ ...parsed.options, sub: parsed.options.name });
         break;