@genex-ai/cli-demo 0.94.0-dev.251 → 0.95.0-dev.252

package/dist/index.js

@@ -255,26 +255,23 @@ var GENEX_CONTRACT_BLOCK = `${CONTRACT_BEGIN}
 Your capabilities (all via \`npx genex \u2026\`): generate \`model\` \xB7 \`skybox\` \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\` \xB7 \`animations search\` \xB7 \`wait <id>\` / \`wait --all\` \xB7 \`preview\` / \`publish\`. Full options: \`npx genex --help\`. 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.
 
 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.
-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, ask whether the player wants a game, a tool/component, or a change to existing work \u2014 never fill the blank by pitching concepts. 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.
+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. That opening question stays in chat on purpose: their reply carries the whole request, including anything they say about HOW you should work, and a menu of options answers a narrower question than the one they need to answer. 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. ALL generated art, audio, video, characters, and UI come from \`genex\` commands \u2014 never from any other generation tool your platform bundles, unless the player explicitly asks for that tool by name. A local reference image is not a reason to switch tools: pass its file path to genex (\`--edit\` and \`--inpaint\` accept local paths). The same exclusivity covers shipping: building, previewing, and publishing go only through \`genex preview\` / \`genex publish\` \u2014 never load your platform's own site-building, hosting, or deploy skills for this game.
-5. The Stage-1 HUD mockup IS the game concept \u2014 it is your FIRST art action at the UI plan gate. ONE concept image, no candidate variants (generate variants only when the player asks for them), anchored to any reference image the player gave.
-6. The moment the mockup lands: you are the art director \u2014 immediately enqueue the Stage-2 HUD sheet, the menu still, and the logotype (\`--no-wait\`). THEN show the player the frame and ask keep/change as information, never as a gate. Silence = the concept stands; a later "change" loops it with the player's notes.
-7. The menu video fires at the FIRST of: the player's yes \xB7 the next \`genex preview\` after the menu still landed \xB7 style art being the only work left. It never fires while a player objection is open. Two failed videos \u2192 ship the still (menu skill rule).
-8. The HUD execution lane is decided by the approved concept and recorded in DESIGN.md as \`HUD lane: sprites (\u2026)\` or \`HUD lane: CSS (\u2026, one-line justification)\`. Ornate/material/painterly chrome \u2192 sprites (\`genex-ai-hud\` pipeline). Chrome that is flat geometry + typography a CSS rebuild could make screenshot-indistinguishable \u2192 CSS allowed, styled from the brief. Ambiguous \u2192 sprites. Only the player may decline the generated HUD.
-9. 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\`.
-10. Fonts: the brief's display + body pair comes from the menu skill's genre table (or carries a one-line stated reason) and is LOADED for real in \`index.html\`.
-11. 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.
-12. Wire-in floors before any publish and before ending a session: sprite HUD wired (or the recorded CSS lane finished), menu video playing (or its recorded still fallback), logotype placed, fonts loaded, Escape pause, branded loader, the player wearing the game's own generated character (or DESIGN.md recording why it isn't). Run \`npx genex wait\` on every generation you enqueued and wire what landed \u2014 never park landed assets.
-13. 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. The profile VRM avatar is the FALLBACK: a temporary body while the character renders (say in one plain line that it's temporary), or the stand-in when generation genuinely could not happen \u2014 out of credits, failed, unverified; record which in DESIGN.md as \`Player character: VRM \u2014 <reason>\`. Games whose player is not a person (car, ship, RTS cursor, board) generate that object with \`npx genex model\` instead. 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.
-14. 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.
-15. Treat every \`genex\` warning line \u2014 preflight, \`ui audit\`, \`wait\` nudges \u2014 as work, not noise.
-16. 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\`, \`/world/<slug>\` once published) \u2014 never a localhost link, a file path, or the bare play origin presented as their game. After every round of player feedback, end with a preview push.
-17. Parallel work: this line is your standing authorization and request to use sub-agents / parallel agent work whenever your platform provides them. While drafting the Build plan, decide per module what runs in parallel and what stays serial for THIS game \u2014 dependencies decide, there is no fixed list \u2014 and record each call in the Modules table with a one-line reason. Independent modules default to parallel; building everything serially needs a stated reason. You keep integration, previews, and the player conversation; each sub-agent owns only its module's files.
-18. Talk to the player in plain game language \u2014 what changed in the game and what to try; never code, file names, build output, or tool internals unless they ask. Short status lines while you work; long silent stretches are a failure.
-19. Never add debug-only code to the game to check your own work \u2014 no hidden test modes, no special URL parameters, no forced-visible flags, no auth mocks, no pixel-sampling hooks. \`?genex_local_test=1\` is the platform's own supported mode and is fine; your own bypass is not. (The multiplayer skill's small build identifier, token-free status line, and connected-quorum watchdog are production supportability, not a bypass \u2014 keep those.)
-20. Input directions match their labels: A/\u2190 moves or turns the player screen-LEFT, D/\u2192 screen-RIGHT, mouse-up looks up, and drag-pan axes share ONE convention. The cursor is either the gameplay tool (RTS, card, builder) or locked away during play \u2014 keyboard-only games included. Check it in every milestone's smoke pass.
-21. v0 is a milestone, not the destination. When the ask was bigger than one loop, every milestone after v0 grows back toward the FULL ask with DESIGN.md's content lines as the checklist \u2014 a slice that previewed well never quietly becomes the game. Cosmetics never jump the queue past promised content.
+5. Generated UI art is a tool you reach for, not a pipeline you owe. A restrained interface built in clean CSS is a finished, legitimate HUD \u2014 not a placeholder. Reach for the sprite lane (\`genex-ai-hud\`) when the game's own style genuinely wants drawn chrome \u2014 ornate, painterly, comic, hand-made \u2014 or when the player asks for HUD art. Generating ONE element you decided the game needs \u2014 a frame, a mask, an icon, a wordmark, a menu backdrop, a menu video \u2014 is a normal use of these tools, never a half-run pipeline. There is NO global game-concept image and no UI plan recited in chat: the art direction lives in the game's brief in words. A lane's own concept step survives only where the player is choosing a concrete thing (a character's candidates). Whatever you do generate, run its quality steps in full \u2014 extraction, masks, wiring, \`npx genex ui audit\`.
+6. 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\`.
+7. Fonts: the brief's display + body pair comes from the menu skill's genre table (or carries a one-line stated reason) and is LOADED for real in \`index.html\`.
+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. The profile VRM avatar is the FALLBACK: a temporary body while the character renders (say in one plain line that it's temporary), or the stand-in when generation genuinely could not happen \u2014 out of credits, failed, unverified; record which in DESIGN.md as \`Player character: VRM \u2014 <reason>\`. Games whose player is not a person (car, ship, RTS cursor, board) generate that object with \`npx genex model\` instead. 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\`, \`/world/<slug>\` once published) \u2014 never a localhost link, a file path, or the bare play origin presented as their game. After every round of player feedback, end with a preview push.
+14. Parallel work: this line is your standing authorization and request to use sub-agents / parallel agent work whenever your platform provides them. While drafting the Build plan, decide per module what runs in parallel and what stays serial for THIS game \u2014 dependencies decide, there is no fixed list \u2014 and record each call in the Modules table with a one-line reason. Independent modules default to parallel; building everything serially needs a stated reason. You keep integration, previews, and the player conversation; each sub-agent owns only its module's files. When the player asks for parallel work, repeated refinement passes, a critic reviewing your output, or names any way of working your platform provides, that IS your instruction \u2014 wherever it reaches you, including inside their answer to a question you asked \u2014 so adopt it as the working mode for the rest of the build, starting with the work in front of you, and never file it as a later milestone. While delegated work runs, keep building or talk to the player; never idle in a foreground wait for something your platform will tell you about.
+15. Talk to the player in plain game language \u2014 what changed in the game and what to try; never code, file names, build output, or tool internals unless they ask. Short status lines while you work; long silent stretches are a failure.
+16. Never add debug-only code to the game to check your own work \u2014 no hidden test modes, no special URL parameters, no forced-visible flags, no auth mocks, no pixel-sampling hooks. \`?genex_local_test=1\` is the platform's own supported mode and is fine; your own bypass is not. (The multiplayer skill's small build identifier, token-free status line, and connected-quorum watchdog are production supportability, not a bypass \u2014 keep those.)
+17. Input directions match their labels: A/\u2190 moves or turns the player screen-LEFT, D/\u2192 screen-RIGHT, mouse-up looks up, and drag-pan axes share ONE convention. The cursor is either the gameplay tool (RTS, card, builder) or locked away during play \u2014 keyboard-only games included. Check it in every milestone's smoke pass.
+18. v0 is a milestone, not the destination. When the ask was bigger than one loop, every milestone after v0 grows back toward the FULL ask with DESIGN.md's content lines as the checklist \u2014 a slice that previewed well never quietly becomes the game. Cosmetics never jump the queue past promised content.
 ${CONTRACT_END}
 `;
 var CLAUDE_IMPORT_LINE = "@AGENTS.md";
@@ -516,6 +513,11 @@ function isCacheFresh(cache, nowMs) {
   const at = Date.parse(cache.checkedAt);
   return Number.isFinite(at) && nowMs - at < CHECK_INTERVAL_MS;
 }
+function wasRecentlyNotified(cache, name, latest, nowMs) {
+  if (cache.notified?.[name] !== latest) return false;
+  const at = Date.parse(cache.notifiedAt ?? "");
+  return Number.isFinite(at) && nowMs - at < CHECK_INTERVAL_MS;
+}
 async function readUpdateCache() {
   try {
     const raw = await fs4.readFile(getUpdateCachePath(), "utf8");
@@ -551,7 +553,12 @@ function startUpdateCheck() {
       results.forEach((r, i) => {
         if (r.status === "fulfilled" && r.value) latest[PUBLISHED_PACKAGES[i].name] = r.value;
       });
-      const next = { checkedAt: (/* @__PURE__ */ new Date()).toISOString(), latest };
+      const next = {
+        checkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        latest,
+        ...cached?.notified ? { notified: cached.notified } : {},
+        ...cached?.notifiedAt ? { notifiedAt: cached.notifiedAt } : {}
+      };
       await fs4.mkdir(getGenexDir(), { recursive: true });
       await fs4.writeFile(getUpdateCachePath(), JSON.stringify(next, null, 2) + "\n");
       return next;
@@ -572,20 +579,24 @@ async function installedPackageVersion(cwd, name) {
 function formatNudge(label, latest, installed, install) {
   return `\u2B06 Genex ${label} ${latest} available (installed ${installed}) \u2014 run: ${install}`;
 }
-async function reportUpdateNudges(check, log, cwd = process.cwd()) {
+async function reportUpdateNudges(check, log, cwd = process.cwd(), cachePath = getUpdateCachePath()) {
   try {
     const cache = await check;
     if (!cache) return;
+    const now = Date.now();
     const lines = [];
+    const announced = {};
     let whatsNew = null;
     for (const pkg of PUBLISHED_PACKAGES) {
       if (pkg.name === "@genex-ai/cli-demo" && CLI_CHANNEL === "dev") continue;
       const latest = cache.latest[pkg.name];
       if (!latest) continue;
+      if (wasRecentlyNotified(cache, pkg.name, latest, now)) continue;
       const installed = pkg.name === "@genex-ai/cli-demo" ? getCliVersion() : await installedPackageVersion(cwd, pkg.name);
       if (!installed) continue;
       if (isNewerVersion(latest, installed)) {
         lines.push(formatNudge(pkg.label, latest, installed, pkg.install));
+        announced[pkg.name] = latest;
         whatsNew ??= `https://www.npmjs.com/package/${pkg.name}`;
       }
     }
@@ -594,6 +605,19 @@ async function reportUpdateNudges(check, log, cwd = process.cwd()) {
     log.dim(
       `  Apply at a safe moment (never mid-task) \u2014 see the genex-updates skill. What's new: ${whatsNew}`
     );
+    await recordNotified(cache, announced, cachePath);
+  } catch {
+  }
+}
+async function recordNotified(cache, announced, cachePath) {
+  try {
+    const next = {
+      ...cache,
+      notified: { ...cache.notified ?? {}, ...announced },
+      notifiedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await fs4.mkdir(path4.dirname(cachePath), { recursive: true });
+    await fs4.writeFile(cachePath, JSON.stringify(next, null, 2) + "\n");
   } catch {
   }
 }
@@ -984,22 +1008,22 @@ async function createDraftProject(opts) {
     } catch (err) {
       log.warn(`Couldn't reach the API at ${apiUrl} to create the project.`);
       log.dim(`  ${String(err)}`);
-      return null;
+      return { meta: null };
     }
     if (res.status === 409 && i === 0) continue;
     if (res.status === 401) {
       log.warn("Not authorized to create the project (token rejected).");
-      return null;
+      return { meta: null, unauthorized: true };
     }
     if (!res.ok) {
       log.warn(`Couldn't create the project (HTTP ${res.status}).`);
-      return null;
+      return { meta: null };
     }
     const data = await res.json().catch(() => null);
     const project = data?.project;
     if (!project || !project.cloneUrl) {
       log.warn("Project created, but the API response was unexpected.");
-      return null;
+      return { meta: null };
     }
     log.success(`Created project ${c.cyan(project.slug)}.`);
     log.plain(
@@ -1008,19 +1032,21 @@ async function createDraftProject(opts) {
     if (project.playUrl) log.dim(`  play (after preview/publish): ${project.playUrl}`);
     log.dim(`  dashboard: ${dashboardUrl}/dashboard`);
     return {
-      id: project.id,
-      slug: project.slug,
-      cloneUrl: project.cloneUrl,
-      apiUrl,
-      playUrl: project.playUrl ?? void 0,
-      status: "draft",
-      // Derived client-side from the auth/web origin the CLI just authorized
-      // against (respects --auth-url overrides) — no API contract change.
-      dashboardOrigins: [new URL(dashboardUrl).origin]
+      meta: {
+        id: project.id,
+        slug: project.slug,
+        cloneUrl: project.cloneUrl,
+        apiUrl,
+        playUrl: project.playUrl ?? void 0,
+        status: "draft",
+        // Derived client-side from the auth/web origin the CLI just authorized
+        // against (respects --auth-url overrides) — no API contract change.
+        dashboardOrigins: [new URL(dashboardUrl).origin]
+      }
     };
   }
   log.warn("Couldn't create a project with a unique name. Try `--name <unique>`.");
-  return null;
+  return { meta: null };
 }
 function randomSuffix() {
   return crypto2.randomBytes(3).toString("hex");
@@ -1180,6 +1206,17 @@ async function writeUserToken(token, envPath) {
   const { path: written } = await writeEnvVar(getGenexEnvPath(envPath), ENV_TOKEN_KEY, token);
   return { path: written };
 }
+async function rotateRejectedEnv(envPath) {
+  const file = getGenexEnvPath(envPath);
+  const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const aside = `${file}.rejected-${stamp}`;
+  try {
+    await fs7.rename(file, aside);
+    return aside;
+  } catch {
+    return null;
+  }
+}
 async function readUserToken(envPath) {
   const fromGenex = await readTokenFromFile(getGenexEnvPath(envPath));
   if (fromGenex) return fromGenex;
@@ -1359,6 +1396,7 @@ async function runInit(opts) {
   }
   const authBaseUrl = getAuthUrl(opts.authUrl);
   let token = await readUserToken(opts.envPath);
+  let savedToken = Boolean(token);
   if (!token) {
     try {
       token = await authorize(authBaseUrl, {
@@ -1373,18 +1411,22 @@ async function runInit(opts) {
     const { path: tokenPath } = await writeUserToken(token, opts.envPath);
     log.success(`Authorized. Saved your token to ${c.cyan(tokenPath)} (${ENV_TOKEN_KEY}).`);
     log.plain("");
+    savedToken = false;
   }
   await writeGitignore(process.cwd(), log);
   if (await writeAgentsContract(process.cwd())) {
     log.dim("  wrote the Genex build contract into AGENTS.md (managed block) + CLAUDE.md stub");
   }
   const apiUrl = getApiUrl(opts.apiUrl);
-  const signedInEmail = await fetchSignedInEmail(apiUrl, token);
-  if (signedInEmail) log.plain(`  signed in as ${c.cyan(signedInEmail)}`);
+  const echoIdentity = async () => {
+    const email = await fetchSignedInEmail(apiUrl, token);
+    if (email) log.plain(`  signed in as ${c.cyan(email)}`);
+  };
+  await echoIdentity();
   const projectName = opts.name?.trim() || path9.basename(process.cwd());
-  const meta = await createDraftProject({
+  const create = (bearer) => createDraftProject({
     apiUrl,
-    token,
+    token: bearer,
     name: projectName,
     repoUrl: opts.repo?.trim() || void 0,
     private: opts.private,
@@ -1392,6 +1434,28 @@ async function runInit(opts) {
     dashboardUrl: authBaseUrl,
     log
   });
+  let created = await create(token);
+  if (!created.meta && created.unauthorized && savedToken) {
+    log.plain("");
+    log.warn("Your saved sign-in was rejected \u2014 reconnecting in the browser\u2026");
+    const aside = await rotateRejectedEnv(opts.envPath);
+    if (aside) log.dim(`  moved the rejected credential to ${c.cyan(aside)}`);
+    try {
+      token = await authorize(authBaseUrl, {
+        log,
+        timeoutMs: opts.timeoutSec ? opts.timeoutSec * 1e3 : void 0
+      });
+    } catch (err) {
+      log.error(err instanceof Error ? err.message : String(err));
+      log.dim("Your workspace files were installed. Re-run `genex init` to finish authorizing.");
+      throw err;
+    }
+    const { path: tokenPath } = await writeUserToken(token, opts.envPath);
+    log.success(`Authorized. Saved your token to ${c.cyan(tokenPath)} (${ENV_TOKEN_KEY}).`);
+    await echoIdentity();
+    created = await create(token);
+  }
+  const meta = created.meta;
   if (!meta) {
     log.plain("");
     log.warn("Setup finished, but creating your game failed \u2014 fix the error above and re-run `genex init`.");
@@ -1644,11 +1708,11 @@ function relTime(iso) {
 }
 
 // src/lib/deploy.ts
-import { spawn as spawn4 } from "child_process";
+import { spawn as spawn3 } from "child_process";
 import crypto3 from "crypto";
-import fs14 from "fs/promises";
+import fs12 from "fs/promises";
 import os4 from "os";
-import path14 from "path";
+import path12 from "path";
 
 // ../../packages/mobile-scan/src/image-dims.ts
 function u32be(b, o) {
@@ -3735,2259 +3799,2153 @@ async function uiAudit(opts, log) {
   if (opts.strict || hard.length > 0) process.exitCode = 1;
 }
 
-// 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) {
+// src/lib/deploy.ts
+function run(cmd, args, env) {
+  return new Promise((resolve) => {
+    let child;
+    try {
+      child = spawn3(cmd, args, { env: env ? { ...process.env, ...env } : process.env });
+    } catch {
+      resolve({ code: -1, out: "", err: `${cmd} not found` });
+      return;
+    }
+    let out = "";
+    let err = "";
+    child.stdout?.on("data", (d) => out += String(d));
+    child.stderr?.on("data", (d) => err += String(d));
+    child.on("error", () => resolve({ code: -1, out, err: `${cmd} not found` }));
+    child.on("close", (code2) => resolve({ code: code2 ?? -1, out, err }));
+  });
+}
+function printMobilePreflight(files, log) {
   try {
-    await fs12.access(path12.join(cwd, ".genex"));
-    await fs12.appendFile(ledgerPath(cwd), `${JSON.stringify(event)}
-`, "utf8");
+    const scan = scanBundle(files.map((f) => ({ relPath: f.relPath, bytes: f.bytes })));
+    const externalDims = /* @__PURE__ */ new Map();
+    for (const url of scan.genexAssetUrls) {
+      const role = url.split("/").pop() ?? "";
+      if (scan.markers.adaptiveQuality && role === SKYBOX_ROLE) {
+        externalDims.set(url, { width: 2048, height: 1024 });
+      } else if (scan.markers.modelRungs && role.endsWith("-glb")) {
+        externalDims.set(url, { width: 1024, height: 2048, glb: true });
+      } else {
+        externalDims.set(url, null);
+      }
+    }
+    const est = estimateVram(scan, externalDims);
+    const tier = tierFor(est.estVramMb);
+    const line = `Mobile preflight: ~${est.estVramMb} MB est. GPU memory on phones (budget: <${MOBILE_BUDGET_MB.broad} MB broad, <${MOBILE_BUDGET_MB.modern} MB modern) \u2014 ${tier}.`;
+    if (tier === "mobile-broad") {
+      log.dim(`  ${line}`);
+      return;
+    }
+    log.warn(line);
+    for (const url of est.unresolvedExternals) {
+      const role = url.split("/").pop() ?? "";
+      if (role === SKYBOX_ROLE) {
+        log.warn(
+          `  Skybox loaded full-size (${url.slice(0, 80)}\u2026): ~178 MB decoded on phones. Load it through pickAsset (genex-threejs-adaptive-quality) so phones get the @2048 rung.`
+        );
+      } else if (role.endsWith("-glb")) {
+        log.warn(
+          `  Model loaded without pickModel (${url.slice(0, 80)}\u2026) \u2014 phones fetch the full provider-raw GLB. Load it through loadModelWithFallback (genex-threejs-adaptive-quality) so phones get the @1024 rung.`
+        );
+      }
+    }
+    if (est.textureMaxDim > 2048) {
+      log.warn(`  Largest texture is ${est.textureMaxDim}px \u2014 phones want \u22642048 (props \u22641024).`);
+    }
+    if (scan.markers.postStack && scan.markers.dprCapLiteral == null) {
+      log.warn(
+        "  Post stack detected with no devicePixelRatio cap \u2014 cap at 1.5 on phones (genex-threejs-adaptive-quality)."
+      );
+    }
+    if (!scan.markers.contextLossHandler) {
+      log.warn("  No context-loss handler found \u2014 one GPU reset shows a dead canvas on phones.");
+    }
   } catch {
   }
 }
-async function readLedger(cwd = process.cwd()) {
-  let raw;
+async function printUiAuditPreflight(log) {
   try {
-    raw = await fs12.readFile(ledgerPath(cwd), "utf8");
+    const findings = await collectUiAuditFindings("public/assets/hud", "src");
+    if (!findings || findings.length === 0) return;
+    log.warn(
+      `HUD wiring audit: ${findings.length} finding(s) \u2014 heuristics, check each (\`npx genex ui audit\` for the full report):`
+    );
+    for (const finding of findings.slice(0, 6)) log.warn(`  [${finding.kind}] ${finding.message}`);
+    if (findings.length > 6) log.dim(`  \u2026and ${findings.length - 6} more.`);
   } 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");
-        }
+}
+async function printPipelineStatePreflight(log, cwd = process.cwd()) {
+  try {
+    const design = await fs12.readFile(path12.join(cwd, "DESIGN.md"), "utf8").catch(() => "");
+    const warnings = [];
+    if (design.length > 0 && !/##\s*build plan & status/i.test(design)) {
+      warnings.push(
+        "DESIGN.md has no `## Build plan & status` section \u2014 numbered milestones with a `Now:` line are how a compacted or resumed session knows where the build is (genex-game-director's design contract has the shape)."
+      );
+    }
+    if (!/player character:/i.test(design)) {
+      const hasCharacter = await fs12.access(path12.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).`
+        );
       }
-    } catch {
     }
+    for (const w of warnings) log.warn(w);
+  } 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 loadsPlayerBody(cwd) {
+  const BODY_LOADERS = /\bloadPlayerCharacter\s*\(|\bloadVrm(?:Clone)?\s*\(/;
+  try {
+    const entries = await fs12.readdir(path12.join(cwd, "src"), { recursive: true });
+    for (const rel of entries) {
+      if (rel.includes("node_modules")) continue;
+      if (rel.split(path12.sep)[0] === "controllers" || rel.startsWith("controllers/")) continue;
+      if (!/\.(ts|tsx|js|jsx)$/.test(rel)) continue;
+      const text = await fs12.readFile(path12.join(cwd, "src", rel), "utf8").catch(() => "");
+      if (BODY_LOADERS.test(text)) return true;
+    }
+  } catch {
+  }
+  return false;
 }
-
-// src/commands/generate.ts
-import fs13 from "fs/promises";
-import path13 from "path";
-import { PNG as PNG4 } from "pngjs";
-
-// src/lib/glass.ts
-import { PNG as PNG3 } from "pngjs";
-var GLASS_PROMPT_SUFFIX = " Rendered on a perfectly flat, uniform, solid pure magenta background, hex #FF00FF, like a studio chroma-key screen: absolutely no shading, no gradient, no vignette, no glow, no shadows on the background. Subject centered, sharp edge silhouette.";
-var GLASS_MIN_FLATNESS = 0.99;
-var GLASS_MIN_KEY_STRENGTH = 180;
-var FLATNESS_DEV_MAX = 12;
-var clamp255 = (v) => v < 0 ? 0 : v > 255 ? 255 : Math.round(v);
-function median(values) {
-  const s = values.slice().sort((a, b) => a - b);
-  return s[Math.floor(s.length / 2)] ?? 0;
+var EXCLUDE_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", ".genex", "dist"]);
+function isSecretEnvFile(name) {
+  return name === ".env" || name.startsWith(".env.") && name !== ".env.example";
 }
-function solveMagentaGlass(source) {
-  const { width: W, height: H, data } = source;
-  const ringW = Math.max(2, Math.round(Math.min(W, H) * 0.04));
-  const rs = [];
-  const gs = [];
-  const bs = [];
-  const ringIdx = [];
-  for (let y = 0; y < H; y++) {
-    for (let x = 0; x < W; x++) {
-      const inRing = x < ringW || y < ringW || x >= W - ringW || y >= H - ringW;
-      if (!inRing) continue;
-      const i = (y * W + x) * 4;
-      ringIdx.push(i);
-      rs.push(data[i]);
-      gs.push(data[i + 1]);
-      bs.push(data[i + 2]);
+async function deployGame(ctx, opts, log) {
+  const cwd = process.cwd();
+  if (!opts.noBuild && await hasBuildScript(cwd)) {
+    log.step("Building the production bundle\u2026");
+    const built = await run("npm", ["run", "build"]);
+    if (built.code !== 0) {
+      log.error("Build failed \u2014 your game was NOT deployed.");
+      const tail = (built.err || built.out).trim().split("\n").slice(-12).join("\n");
+      if (tail) log.dim(tail);
+      return false;
     }
+    log.success("Built.");
   }
-  const K = { r: median(rs), g: median(gs), b: median(bs) };
-  const keyHex = `#${[K.r, K.g, K.b].map((v) => v.toString(16).padStart(2, "0")).join("")}`;
-  const keyStrength = Math.min(K.r, K.b) - K.g;
-  let flat = 0;
-  for (const i of ringIdx) {
-    const dev = Math.max(
-      Math.abs(data[i] - K.r),
-      Math.abs(data[i + 1] - K.g),
-      Math.abs(data[i + 2] - K.b)
-    );
-    if (dev < FLATNESS_DEV_MAX) flat++;
+  const distDir = path12.join(cwd, "dist");
+  const siteDir = await isDir2(distDir) ? distDir : cwd;
+  const rel = path12.relative(cwd, siteDir) || ".";
+  if (siteDir === cwd) await writeGitignore(cwd, log);
+  const files = await collectFiles(siteDir);
+  if (files.length === 0) {
+    log.warn("Nothing to deploy \u2014 the build produced no files.");
+    return false;
   }
-  const flatness = ringIdx.length === 0 ? 0 : flat / ringIdx.length;
-  const base = { keyColor: K, keyHex, keyStrength, flatness };
-  if (flatness < GLASS_MIN_FLATNESS || keyStrength < GLASS_MIN_KEY_STRENGTH) {
-    return {
-      ...base,
-      png: source,
-      ok: false,
-      rejected: `backdrop not keyable (flatness ${flatness.toFixed(3)}, key strength ${keyStrength} \u2014 want \u2265${GLASS_MIN_FLATNESS}/${GLASS_MIN_KEY_STRENGTH}): the model shaded the magenta screen instead of painting it flat. Regenerate (same prompt \u2014 this is a rare roll), or steer harder: keep the --glass suffix intact and avoid magenta/pink art in the subject.`
-    };
+  if (!files.some((f) => f.relPath === "index.html")) {
+    log.error(`No index.html in ${rel} \u2014 a game needs one to serve. Nothing deployed.`);
+    return false;
   }
-  const out = new PNG3({ width: W, height: H });
-  const mKey = Math.max(1, keyStrength);
-  for (let p = 0; p < W * H; p++) {
-    const i = p * 4;
-    const R = data[i];
-    const G = data[i + 1];
-    const B = data[i + 2];
-    const m = Math.max(0, Math.min(R, B) - G);
-    let a = 1 - m / mKey;
-    if (a < 0) a = 0;
-    if (a > 1) a = 1;
-    if (a <= 0.02) {
-      out.data[i] = 0;
-      out.data[i + 1] = 0;
-      out.data[i + 2] = 0;
-      out.data[i + 3] = 0;
-      continue;
-    }
-    out.data[i] = clamp255((R - (1 - a) * K.r) / a);
-    out.data[i + 1] = clamp255((G - (1 - a) * K.g) / a);
-    out.data[i + 2] = clamp255((B - (1 - a) * K.b) / a);
-    out.data[i + 3] = Math.round(a * 255);
+  const lfsPointers = files.filter(
+    (f) => f.bytes.length < 1024 && f.bytes.subarray(0, 64).toString("latin1").startsWith("version https://git-lfs.github.com/spec/v")
+  );
+  if (lfsPointers.length > 0) {
+    log.error(
+      `${lfsPointers.length} file${lfsPointers.length > 1 ? "s" : ""} in ${rel} ${lfsPointers.length > 1 ? "are" : "is"} an unresolved Git LFS pointer, not the real asset \u2014 the game would fail to load at runtime. Run \`git lfs pull\` and rebuild. Nothing deployed.`
+    );
+    for (const p of lfsPointers.slice(0, 8)) log.dim(`  ${p.relPath}`);
+    if (lfsPointers.length > 8) log.dim(`  \u2026and ${lfsPointers.length - 8} more`);
+    return false;
   }
-  return { ...base, png: out, ok: true };
+  printMobilePreflight(files, log);
+  await printUiAuditPreflight(log);
+  await printPipelineStatePreflight(log);
+  const commit = contentCommit(files);
+  log.step("Requesting an upload token\u2026");
+  const grant = await getUploadToken(ctx, commit, log);
+  if (!grant) return false;
+  const totalBytes = files.reduce((n, f) => n + f.bytes.length, 0);
+  const mb = (n) => (n / 1048576).toFixed(n < 1048576 ? 2 : 1);
+  if (files.length > grant.limits.maxFiles) {
+    log.error(`Too many files (${files.length} > ${grant.limits.maxFiles}). Trim the build and retry.`);
+    return false;
+  }
+  const oversized = files.find((f) => f.bytes.length > grant.limits.maxFileBytes);
+  if (oversized) {
+    log.error(`${oversized.relPath} is ${mb(oversized.bytes.length)} MB \u2014 over the ${mb(grant.limits.maxFileBytes)} MB per-file limit.`);
+    return false;
+  }
+  if (totalBytes > grant.limits.maxTotalBytes) {
+    log.error(`Build is ${mb(totalBytes)} MB \u2014 over the ${mb(grant.limits.maxTotalBytes)} MB limit.`);
+    return false;
+  }
+  log.step(`Uploading ${files.length} files\u2026`);
+  if (!await uploadAll(grant, files, log)) {
+    log.error("Couldn't upload your game \u2014 please try again.");
+    return false;
+  }
+  if (!await pushSource(cwd, ctx, log)) return false;
+  log.step("Publishing\u2026");
+  if (!await callPublish(ctx, commit, opts, log)) return false;
+  const index = files.find((f) => f.relPath === "index.html");
+  await waitUntilLive(grant.playUrl, fingerprintOf(index.bytes.toString("utf8")), opts.liveTimeoutMs ?? 2e4, log);
+  return true;
 }
-
-// src/lib/open.ts
-import { spawn as spawn3 } from "child_process";
-function tokenize(cmd) {
-  return cmd.trim().split(/\s+/).filter(Boolean);
+async function hasBuildScript(cwd) {
+  try {
+    const pkg = JSON.parse(await fs12.readFile(path12.join(cwd, "package.json"), "utf8"));
+    return Boolean(pkg.scripts?.build);
+  } catch {
+    return false;
+  }
 }
-function openUrl(url) {
-  let command;
-  let args;
-  const custom = (process.env.GENEX_BROWSER || process.env.BROWSER)?.trim();
-  const customParts = custom ? tokenize(custom) : [];
-  if (customParts.length > 0) {
-    command = customParts[0];
-    args = [...customParts.slice(1), url];
-  } else {
-    switch (process.platform) {
-      case "darwin":
-        command = "open";
-        args = [url];
-        break;
-      case "win32":
-        command = "cmd";
-        args = ["/c", "start", "", url];
-        break;
-      default:
-        command = "xdg-open";
-        args = [url];
-        break;
+async function collectFiles(root) {
+  const out = [];
+  const walk2 = async (dir, prefix) => {
+    for (const e of await fs12.readdir(dir, { withFileTypes: true })) {
+      const relPath = prefix ? `${prefix}/${e.name}` : e.name;
+      if (e.isDirectory()) {
+        if (!EXCLUDE_DIRS.has(e.name)) await walk2(path12.join(dir, e.name), relPath);
+      } else if (e.isFile() && !isSecretEnvFile(e.name)) {
+        out.push({ relPath, bytes: await fs12.readFile(path12.join(dir, e.name)) });
+      }
     }
+  };
+  await walk2(root, "");
+  return out;
+}
+function contentCommit(files) {
+  const h = crypto3.createHash("sha1");
+  for (const f of [...files].sort((a, b) => a.relPath < b.relPath ? -1 : a.relPath > b.relPath ? 1 : 0)) {
+    h.update(f.relPath, "utf8");
+    h.update("\0");
+    h.update(f.bytes);
   }
+  return h.digest("hex");
+}
+function retryAfterHint(res) {
+  const raw = Number(res.headers.get("retry-after"));
+  if (!Number.isFinite(raw) || raw <= 0) return "";
+  const secs = Math.ceil(raw);
+  return ` Try again in ${secs < 90 ? `${secs}s` : `~${Math.ceil(secs / 60)} min`}.`;
+}
+async function getUploadToken(ctx, commit, log) {
+  let res;
   try {
-    const child = spawn3(command, args, { stdio: "ignore", detached: true });
-    child.on("error", () => {
+    res = await apiFetch(`${ctx.apiUrl}/api/games/${ctx.projectId}/upload-token`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${ctx.token}` },
+      body: JSON.stringify({ commit })
     });
-    child.unref();
-  } catch {
+  } catch (err) {
+    log.error(`Couldn't reach the API at ${ctx.apiUrl}: ${String(err)}`);
+    return null;
+  }
+  if (res.status === 401) {
+    log.error("Not authorized (HTTP 401) \u2014 your sign-in expired or was revoked.");
+    log.plain("  Fix: run `genex link <your-game>` and sign in as the game's owner, then re-run this command.");
+    return null;
+  }
+  if (res.status === 404) {
+    log.error("This account doesn't own this game (HTTP 404) \u2014 you're signed in as a different account.");
+    log.plain("  Fix: run `genex link <your-game>` and sign in as the OWNER account, then re-run this command.");
+    return null;
+  }
+  if (res.status === 429) {
+    log.error(`Rate limited requesting an upload token (HTTP 429).${retryAfterHint(res)}`);
+    return null;
+  }
+  if (!res.ok) {
+    log.error(`Couldn't get an upload token (HTTP ${res.status}).`);
+    return null;
   }
+  return await res.json();
 }
-
-// src/lib/sse.ts
-async function* readSSE(body) {
-  const decoder = new TextDecoder();
-  const reader = body.getReader();
-  let buf = "";
-  let event = "";
-  let data = [];
-  try {
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      buf += decoder.decode(value, { stream: true });
-      while (true) {
-        const nl = buf.search(/[\r\n]/);
-        if (nl === -1) break;
-        if (buf[nl] === "\r" && nl === buf.length - 1) break;
-        const sep = buf[nl] === "\r" && buf[nl + 1] === "\n" ? 2 : 1;
-        const line = buf.slice(0, nl);
-        buf = buf.slice(nl + sep);
-        if (line === "") {
-          if (data.length > 0) yield { event: event || "message", data: data.join("\n") };
-          event = "";
-          data = [];
-          continue;
-        }
-        if (line.startsWith(":")) continue;
-        const colon = line.indexOf(":");
-        const field = colon === -1 ? line : line.slice(0, colon);
-        let value2 = colon === -1 ? "" : line.slice(colon + 1);
-        if (value2.startsWith(" ")) value2 = value2.slice(1);
-        if (field === "event") event = value2;
-        else if (field === "data") data.push(value2);
+async function uploadAll(grant, files, log) {
+  const base = grant.uploadUrl.replace(/\/+$/, "");
+  const threshold = grant.limits.singlePutMaxBytes ?? grant.limits.maxFileBytes;
+  const small = files.filter((f) => f.bytes.length <= threshold);
+  const large = files.filter((f) => f.bytes.length > threshold);
+  let failed = false;
+  let next = 0;
+  const worker = async () => {
+    while (!failed) {
+      const i = next++;
+      if (i >= small.length) return;
+      const f = small[i];
+      const encoded = f.relPath.split("/").map(encodeURIComponent).join("/");
+      let res = null;
+      try {
+        res = await fetch(`${base}/${encoded}`, {
+          method: "PUT",
+          headers: { Authorization: `Bearer ${grant.token}` },
+          body: f.bytes
+        });
+      } catch {
+        res = null;
+      }
+      if (!res || !res.ok) {
+        failed = true;
+        log.warn(`Upload failed for ${f.relPath}${res ? ` (HTTP ${res.status})` : " (network error)"}.`);
       }
     }
-  } finally {
-    reader.releaseLock();
+  };
+  await Promise.all(Array.from({ length: Math.min(8, small.length) }, () => worker()));
+  if (failed) return false;
+  for (const f of large) {
+    if (!await uploadMultipart(base, grant.token, f, grant.limits.partSizeBytes, log)) return false;
   }
+  return true;
 }
-
-// src/commands/generate.ts
-var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-var INLINE_IMAGE_LIMIT_BYTES = 4 * 1024 * 1024;
-var IMAGE_MIME_BY_EXT = {
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".webp": "image/webp"
-};
-var isRemoteRef = (value) => /^(https?:\/\/|data:)/i.test(value);
-async function inlineLocalImage(filePath, flag) {
-  let bytes;
+async function uploadMultipart(base, uploadToken, f, partSize, log) {
+  const encoded = f.relPath.split("/").map(encodeURIComponent).join("/");
+  const auth = { Authorization: `Bearer ${uploadToken}` };
+  const totalParts = Math.ceil(f.bytes.length / partSize);
+  log.step(`Uploading ${f.relPath} (${(f.bytes.length / 1048576).toFixed(1)} MB in ${totalParts} parts)\u2026`);
+  let uploadId;
   try {
-    bytes = await fs13.readFile(filePath);
+    const res = await fetch(`${base}/${encoded}?action=mpu-create`, { method: "POST", headers: auth });
+    if (!res.ok) {
+      log.warn(`Upload failed for ${f.relPath} (HTTP ${res.status} starting multipart).`);
+      return false;
+    }
+    uploadId = (await res.json()).uploadId;
   } catch {
-    return { ok: false, error: `Couldn't read the ${flag} file at ${filePath}.` };
+    log.warn(`Upload failed for ${f.relPath} (network error starting multipart).`);
+    return false;
   }
-  if (bytes.length > INLINE_IMAGE_LIMIT_BYTES) {
-    return {
-      ok: false,
-      error: `${flag} file is ${(bytes.length / 1048576).toFixed(1)} MB \u2014 over the ~4 MB inline limit. Downscale/compress it first, or pass an asset URL instead.`
-    };
-  }
-  const mime = IMAGE_MIME_BY_EXT[path13.extname(filePath).toLowerCase()] ?? "image/png";
-  return { ok: true, dataUri: `data:${mime};base64,${bytes.toString("base64")}` };
-}
-var SKYBOX_ENVIRONMENT_SUFFIX = ". The image contains ONLY sky: cloud, atmosphere, light, weather and distant haze at the horizon. Every structure, object, plant and ground surface is outside the frame.";
-var SKYBOX_PROMPT_MAX = 2e3;
-var SKYBOX_STRUCTURE_NOUNS = [
-  "building",
-  "buildings",
-  "house",
-  "houses",
-  "hut",
-  "huts",
-  "cabin",
-  "cabins",
-  "tower",
-  "towers",
-  "castle",
-  "castles",
-  "cathedral",
-  "cathedrals",
-  "church",
-  "churches",
-  "temple",
-  "temples",
-  "shrine",
-  "shrines",
-  "monastery",
-  "palace",
-  "fortress",
-  "citadel",
-  "ruin",
-  "ruins",
-  "city",
-  "cityscape",
-  "skyline",
-  "town",
-  "village",
-  "settlement",
-  "street",
-  "streets",
-  "road",
-  "roads",
-  "courtyard",
-  "plaza",
-  "bridge",
-  "bridges",
-  "wall",
-  "walls",
-  "gate",
-  "gates",
-  "fence",
-  "fences",
-  "pillar",
-  "pillars",
-  "column",
-  "columns",
-  "statue",
-  "statues",
-  "monument",
-  "obelisk",
-  "spire",
-  "spires",
-  "rooftop",
-  "rooftops",
-  "tree",
-  "trees",
-  "forest",
-  "jungle",
-  "ship",
-  "ships",
-  "boat",
-  "boats",
-  "car",
-  "cars",
-  "vehicle",
-  "vehicles",
-  "person",
-  "people",
-  "figure",
-  "figures",
-  "character",
-  "characters",
-  "creature",
-  "creatures",
-  "dragon",
-  "banner",
-  "banners",
-  "flag",
-  "flags",
-  "torch",
-  "torches",
-  "lamp",
-  "lamps"
-];
-var SKYBOX_NOUN_RE = new RegExp(`\\b(${SKYBOX_STRUCTURE_NOUNS.join("|")})\\b`, "gi");
-function skyboxStructureNouns(prompt) {
-  const found = /* @__PURE__ */ new Set();
-  for (const m of prompt.matchAll(SKYBOX_NOUN_RE)) found.add(m[1].toLowerCase());
-  return [...found];
-}
-function applySkyboxGuard(prompt, raw) {
-  if (raw) return { prompt, guarded: false, nouns: [] };
-  const nouns = skyboxStructureNouns(prompt);
-  const guarded = `${prompt}${SKYBOX_ENVIRONMENT_SUFFIX}`;
-  if (guarded.length > SKYBOX_PROMPT_MAX) return { prompt, guarded: false, nouns };
-  return { prompt: guarded, guarded: true, nouns };
-}
-function buildGenOptions(kind, opts) {
-  const options = { ...opts.generationOptions };
-  if (kind === "texture" && opts.terrain) options.terrain = true;
-  if ((kind === "sfx" || kind === "music") && opts.duration) options.durationSeconds = opts.duration;
-  if (kind === "voice") {
-    if (opts.voice) options.voice = opts.voice;
-    if (opts.voiceId) options.voiceId = opts.voiceId;
-  }
-  if (kind === "image") {
-    if (opts.transparent) options.transparent = true;
-    if (opts.aspect) options.aspect = opts.aspect;
-    if (opts.quality) options.quality = opts.quality;
-    if (opts.candidates !== void 0 && opts.candidates > 1) options.candidates = opts.candidates;
-    if (opts.width && opts.height) {
-      options.width = opts.width;
-      options.height = opts.height;
-    }
-    if (opts.editUrl) {
-      options.sourceUrl = opts.editUrl;
-      options.op = "edit";
+  const abort = async () => {
+    try {
+      await fetch(`${base}/${encoded}?action=mpu-abort&uploadId=${encodeURIComponent(uploadId)}`, {
+        method: "DELETE",
+        headers: auth
+      });
+    } catch {
     }
-    if (opts.cleanUrl) {
-      options.sourceUrl = opts.cleanUrl;
-      options.op = "remove-bg";
-      options.bgMode = opts.bgMode ?? "sheet";
+  };
+  const parts = [];
+  let failed = false;
+  let next = 0;
+  const partWorker = async () => {
+    while (!failed) {
+      const i = next++;
+      if (i >= totalParts) return;
+      const partNumber = i + 1;
+      const bytes = f.bytes.subarray(i * partSize, Math.min((i + 1) * partSize, f.bytes.length));
+      const part = await uploadPartWithRetry(base, encoded, auth, uploadId, partNumber, bytes);
+      if (!part) {
+        failed = true;
+        log.warn(`Upload failed for ${f.relPath} (part ${partNumber}/${totalParts}).`);
+        return;
+      }
+      parts.push(part);
     }
-    if (opts.upscaleUrl) {
-      options.sourceUrl = opts.upscaleUrl;
-      options.op = "upscale";
+  };
+  await Promise.all(Array.from({ length: Math.min(4, totalParts) }, () => partWorker()));
+  if (failed) {
+    await abort();
+    return false;
+  }
+  parts.sort((a, b) => a.partNumber - b.partNumber);
+  try {
+    const res = await fetch(`${base}/${encoded}?action=mpu-complete&uploadId=${encodeURIComponent(uploadId)}`, {
+      method: "POST",
+      headers: { ...auth, "Content-Type": "application/json" },
+      body: JSON.stringify({ parts })
+    });
+    if (!res.ok) {
+      log.warn(`Upload failed for ${f.relPath} (HTTP ${res.status} completing multipart).`);
+      await abort();
+      return false;
     }
-    if (opts.inpaintUrl) options.maskUrl = opts.inpaintUrl;
-    if (opts.removeBackground) options.removeBackground = true;
-    if (opts.bgMode) options.bgMode = opts.bgMode;
+  } catch {
+    log.warn(`Upload failed for ${f.relPath} (network error completing multipart).`);
+    await abort();
+    return false;
   }
-  if (kind === "video") {
-    if (opts.duration) options.durationSeconds = opts.duration;
-    if (opts.resolution) options.resolution = opts.resolution;
-    if (opts.loop) options.loop = true;
-    if (opts.frameUrl) options.frameUrl = opts.frameUrl;
-    if (opts.firstFrameUrl) options.firstFrameUrl = opts.firstFrameUrl;
-    if (opts.lastFrameUrl) options.lastFrameUrl = opts.lastFrameUrl;
+  return true;
+}
+async function uploadPartWithRetry(base, encoded, auth, uploadId, partNumber, bytes) {
+  for (let attempt = 0; ; attempt++) {
+    let res = null;
+    try {
+      res = await fetch(
+        `${base}/${encoded}?action=mpu-part&uploadId=${encodeURIComponent(uploadId)}&partNumber=${partNumber}`,
+        { method: "PUT", headers: auth, body: bytes }
+      );
+      if (res.ok) return await res.json();
+    } catch {
+      res = null;
+    }
+    if (res && res.status < 500) return null;
+    if (attempt >= 2) return null;
+    await new Promise((resolve) => setTimeout(resolve, attempt === 0 ? 500 : 2e3));
   }
-  return options;
 }
-async function runGenerate(kind, opts) {
-  const log = createLogger({ quiet: opts.quiet || opts.json });
-  const typedPrompt = opts.prompt?.trim();
-  if (!typedPrompt) {
-    log.error(`Missing prompt. Usage: ${c.cyan(`genex ${kind} "<prompt>"`)}`);
-    process.exitCode = 1;
-    return;
+async function callPublish(ctx, commit, opts, log) {
+  let res;
+  try {
+    res = await apiFetch(`${ctx.apiUrl}/api/games/${ctx.projectId}/publish`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${ctx.token}` },
+      // Detections ride every go-live (preview AND publish): matchmaking is
+      // tri-state (object = upsert, null = clear); embedSdkVersion/multiplayer
+      // are sent only when detected (absent = server keeps the stored value).
+      body: JSON.stringify({
+        commit,
+        matchmaking: opts.matchmaking ?? null,
+        ...opts.embedSdkVersion ? { embedSdkVersion: opts.embedSdkVersion } : {},
+        ...opts.multiplayer !== void 0 ? { multiplayer: opts.multiplayer } : {},
+        ...opts.mobileControls !== void 0 ? { mobileControls: opts.mobileControls } : {}
+      })
+    });
+  } catch (err) {
+    log.error(`Couldn't reach the API at ${ctx.apiUrl}: ${String(err)}`);
+    return false;
   }
-  const skyboxGuard = kind === "skybox" ? applySkyboxGuard(typedPrompt, opts.raw) : void 0;
-  if (skyboxGuard && skyboxGuard.nouns.length > 0) {
-    log.error(
-      `A skybox is sky only \u2014 this prompt names ${skyboxGuard.nouns.join(", ")}.`
-    );
-    log.plain(
-      [
-        "  Structures painted into a sky render at infinite distance: they never get closer",
-        "  as the player moves, and they read as broken the moment the camera strafes.",
-        `  ${c.cyan("\u2192")} Build them as scene geometry (${c.cyan("npx genex model")}); describe only light, colour,`,
-        "    cloud, weather and time of day here.",
-        `  ${c.cyan("\u2192")} Genuinely want it painted into the sky (a space-station panorama for a scene`,
-        `    with no world geometry)? Re-run with ${c.cyan("--raw")}.`
-      ].join("\n")
-    );
-    process.exitCode = 1;
-    return;
+  if (res.status === 429) {
+    log.error(`Rate limited publishing (HTTP 429).${retryAfterHint(res)}`);
+    return false;
   }
-  let prompt = skyboxGuard?.prompt ?? typedPrompt;
-  if (kind === "image" && opts.glass) {
-    const conflict = opts.transparent ? "--transparent" : opts.removeBackground ? "--remove-bg" : opts.editUrl ? "--edit" : opts.cleanUrl ? "--clean" : opts.upscaleUrl ? "--upscale" : opts.noWait ? "--no-wait" : void 0;
-    if (conflict) {
-      log.error(
-        conflict === "--no-wait" ? "--glass runs a local key-solve on the finished image \u2014 it has to wait. Drop --no-wait." : `--glass generates a NEW panel on a magenta key screen \u2014 it cannot combine with ${conflict}. The solved RGBA ships real translucency; no removal pass applies.`
-      );
-      process.exitCode = 1;
-      return;
-    }
-    prompt = `${prompt}${GLASS_PROMPT_SUFFIX}`;
+  if (!res.ok) {
+    const detail = await res.text().catch(() => "");
+    log.error(`Publish failed (HTTP ${res.status})${detail ? `: ${detail}` : ""}.`);
+    return false;
   }
-  if (kind === "image" && opts.inpaintUrl && !/^https?:\/\//i.test(opts.inpaintUrl)) {
-    if (!opts.editUrl) {
-      log.error("--inpaint targets an edit \u2014 pass --edit <asset-url> alongside it.");
-      process.exitCode = 1;
-      return;
+  return true;
+}
+async function pushSource(cwd, ctx, log) {
+  const target = await fetchPushUrl(ctx, log);
+  if (!target) return false;
+  if (await pushWorktree(cwd, target.pushUrl, target.managed, log)) return true;
+  if (!target.managed) return false;
+  log.info("Retrying the source push\u2026");
+  await new Promise((r) => setTimeout(r, 2e3));
+  const fresh = await fetchPushUrl(ctx, log);
+  if (!fresh) return false;
+  return pushWorktree(cwd, fresh.pushUrl, fresh.managed, log);
+}
+function urlHasEmbeddedCredentials(pushUrl) {
+  return /^[a-z][a-z0-9+.-]*:\/\/[^/@]+@/i.test(pushUrl);
+}
+async function pushWorktree(cwd, pushUrl, managed, log) {
+  const EMPTY_TREE = "4b825dc642cb6eb9a060e54bf8d69288fbee4904";
+  const failed = () => {
+    log.error("Couldn't save your game's source \u2014 please try again.");
+    return false;
+  };
+  const gitDir = await fs12.mkdtemp(path12.join(os4.tmpdir(), "genex-source-"));
+  const base = { GIT_DIR: gitDir };
+  if (urlHasEmbeddedCredentials(pushUrl)) {
+    base.GIT_CONFIG_COUNT = "1";
+    base.GIT_CONFIG_KEY_0 = "credential.helper";
+    base.GIT_CONFIG_VALUE_0 = "";
+  }
+  const ident = {
+    GIT_AUTHOR_NAME: "genex",
+    GIT_AUTHOR_EMAIL: "agent@genex.local",
+    GIT_COMMITTER_NAME: "genex",
+    GIT_COMMITTER_EMAIL: "agent@genex.local"
+  };
+  try {
+    if ((await run("git", ["init", "-q"], base)).code !== 0) return failed();
+    await fs12.writeFile(
+      path12.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: path12.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");
+      const [bin, args] = process.platform === "darwin" ? ["brew", ["install", "git-lfs"]] : ["sudo", ["-n", "apt-get", "install", "-y", "git-lfs"]];
+      await run(bin, args, base);
+      lfs = (await run("git", ["lfs", "version"], base)).code === 0;
+      if (!lfs) {
+        log.warn(
+          "Couldn't install git-lfs \u2014 large binary assets won't be saved to your source (the game still publishes)."
+        );
+      }
     }
-    try {
-      const bytes = await fs13.readFile(opts.inpaintUrl);
-      opts = { ...opts, inpaintUrl: `data:image/png;base64,${bytes.toString("base64")}` };
-    } catch {
-      log.error(`Couldn't read the --inpaint mask at ${opts.inpaintUrl}.`);
-      process.exitCode = 1;
-      return;
+    if (lfs) {
+      await writeGitattributes(cwd, log);
+      const filters = [
+        ["filter.lfs.clean", "git-lfs clean -- %f"],
+        ["filter.lfs.smudge", "git-lfs smudge -- %f"],
+        ["filter.lfs.process", "git-lfs filter-process"],
+        ["filter.lfs.required", "true"]
+      ];
+      for (const [key, value] of filters) await run("git", ["config", key, value], base);
     }
-  }
-  if (kind === "image" && opts.editUrl && !isRemoteRef(opts.editUrl)) {
-    const inlined = await inlineLocalImage(opts.editUrl, "--edit");
-    if (!inlined.ok) {
-      log.error(inlined.error);
-      process.exitCode = 1;
-      return;
+    await run("git", ["add", "-A"], env);
+    const tree = (await run("git", ["ls-files"], env)).out.trim() ? (await run("git", ["write-tree"], env)).out.trim() : "";
+    if (!tree || tree === EMPTY_TREE) {
+      log.error("Nothing to publish \u2014 the project has no files.");
+      return false;
     }
-    opts = { ...opts, editUrl: inlined.dataUri };
-  }
-  if (kind === "video" && opts.frameUrl && !isRemoteRef(opts.frameUrl)) {
-    const inlined = await inlineLocalImage(opts.frameUrl, "--frame");
-    if (!inlined.ok) {
-      log.error(inlined.error);
-      process.exitCode = 1;
-      return;
+    const commit = (await run("git", ["commit-tree", tree, "-m", "source"], { ...base, ...ident })).out.trim();
+    await run("git", ["update-ref", "refs/heads/main", commit], base);
+    if (lfs && (await run("git", ["lfs", "push", "--all", pushUrl, "main"], base)).code !== 0) {
+      log.error("Couldn't upload your game's binary assets to the source store.");
+      return false;
     }
-    opts = { ...opts, frameUrl: inlined.dataUri };
-  }
-  if (kind === "voice" && prompt.length > 1e3) {
-    log.warn(
-      `Voice text is ${prompt.length} chars \u2014 the server clamps at 1000 (billing follows the clamp). Split longer copy into separate lines.`
+    const push = await run(
+      "git",
+      ["-c", "http.postBuffer=536870912", "push", "-q", pushUrl, "+refs/heads/main:main"],
+      base
     );
+    if (push.code === 0) return true;
+    if (!managed) {
+      log.error(
+        "Couldn't push to your repo. Check that you have push access (SSH key or git credentials) and that the repo exists."
+      );
+      return false;
+    }
+    return failed();
+  } catch {
+    return failed();
+  } finally {
+    await fs12.rm(gitDir, { recursive: true, force: true }).catch(() => {
+    });
   }
-  const token = opts.token ?? await readUserToken(opts.envPath);
-  if (!token) {
-    log.error("Not authorized. Run `genex init` first to sign in.");
-    process.exitCode = 1;
-    return;
-  }
-  const meta = await readProject();
-  const apiUrl = getApiUrl(opts.apiUrl ?? meta?.apiUrl);
-  const options = buildGenOptions(kind, opts);
-  log.plain(c.bold(`genex ${kind}`));
-  log.dim(`  ${prompt}`);
-  if (skyboxGuard?.guarded) log.dim("  \u21B3 environment-only guard applied (--raw to disable)");
-  log.plain("");
-  let id;
+}
+async function fetchPushUrl(ctx, log) {
+  let res;
   try {
-    const res = await apiFetch(`${apiUrl}/api/generations`, {
+    res = await apiFetch(`${ctx.apiUrl}/api/projects/${ctx.projectId}/push-token`, {
       method: "POST",
-      headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
-      body: JSON.stringify({ kind, prompt, options })
+      headers: { Authorization: `Bearer ${ctx.token}` }
     });
-    if (res.status === 401) {
-      log.error("Unauthorized \u2014 your token may have expired. Re-run `genex init`.");
-      process.exitCode = 1;
-      return;
-    }
-    if (printedStructuredError(res)) {
-      process.exitCode = 1;
-      return;
-    }
-    if (!res.ok) {
-      let message;
-      if (res.status >= 400 && res.status < 500) {
-        try {
-          const body = await res.json();
-          if (typeof body.message === "string" && body.message.trim()) message = body.message;
-        } catch {
-        }
-      }
-      log.error(message ?? `Generation request failed (HTTP ${res.status}).`);
-      process.exitCode = 1;
-      return;
-    }
-    ({ id } = await res.json());
   } catch (err) {
-    log.error(`Couldn't reach the API at ${apiUrl}: ${String(err)}`);
-    process.exitCode = 1;
-    return;
+    log.error(`Couldn't reach the API to authorize the source push: ${String(err)}`);
+    return null;
+  }
+  if (res.status === 401) {
+    log.error("Not authorized \u2014 your token may have expired. Re-run `genex init`.");
+    return null;
   }
-  await recordQueued(id, kind, prompt);
-  if (opts.noWait) {
-    if (opts.json) {
-      writeJson({
-        kind,
-        id,
-        status: "pending",
-        nextCommand: `genex wait ${id} --json`
-      });
-    } else {
-      log.success(`Queued (${id}).`);
-      log.plain(`  Pick it up any time with: ${c.cyan(`npx genex wait ${id}`)}`);
-      log.dim("  (Re-running the generate command would start \u2014 and bill \u2014 a NEW generation.)");
-    }
-    return id;
+  if (res.status === 429) {
+    log.error(`Rate limited authorizing the source push (HTTP 429).${retryAfterHint(res)}`);
+    return null;
   }
-  if (kind === "image" && opts.glass) {
-    if (!opts.json) log.step("Generating\u2026 (this can take up to a minute)");
-    const view = await waitForTerminalView(
-      apiUrl,
-      token,
-      id,
-      kind,
-      opts.json ? () => {
-      } : (p) => log.dim(`  ${p}%`)
-    );
-    if (!view) {
-      if (opts.json) writeJson({ kind, id, status: "failed", error: "Timed out waiting for the generation." });
-      else log.error("Timed out waiting for the generation.");
-      process.exitCode = 1;
-      return id;
-    }
-    await reportGlassTerminal(view, opts.outDir ?? ".", log, opts.json ?? false);
-    return id;
+  if (!res.ok) {
+    log.error(`Couldn't authorize the source push (HTTP ${res.status}).`);
+    return null;
   }
-  await awaitAndReport(apiUrl, token, id, kind, log, opts.open, opts.json);
-  return id;
+  const data = await res.json().catch(() => null);
+  if (!data?.pushUrl) {
+    log.error("The API didn't return a push URL.");
+    return null;
+  }
+  return { pushUrl: data.pushUrl, managed: data.managed !== false };
 }
-async function reportGlassTerminal(view, outDir, log, json) {
-  const files = (view.files ?? []).filter((f) => /^image-(main|alt-\d+)$/.test(f.role));
-  if (view.status !== "completed" || files.length === 0) {
-    await reportTerminal("image", view, log, false, json);
+async function isDir2(p) {
+  try {
+    return (await fs12.stat(p)).isDirectory();
+  } catch {
+    return false;
+  }
+}
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function fingerprintOf(html) {
+  const m = html.match(/[A-Za-z0-9_]+-[A-Za-z0-9_-]{8}\.(?:js|css)/);
+  return m ? m[0] : null;
+}
+async function waitUntilLive(playUrl, fingerprint, timeoutMs, log) {
+  if (!fingerprint) {
+    log.success(`Live. \u{1F310}  ${playUrl}`);
     return;
   }
-  await recordTerminal(view.id, "completed", files.map((f) => f.url));
-  await fs13.mkdir(outDir, { recursive: true });
-  const solved = [];
-  for (let i = 0; i < files.length; i++) {
-    const f = files[i];
-    let png;
+  const deadline = Date.now() + timeoutMs;
+  let n = 0;
+  while (Date.now() < deadline) {
     try {
-      const res = await fetch(f.url);
-      if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      png = PNG4.sync.read(Buffer.from(await res.arrayBuffer()));
-    } catch (err) {
-      solved.push({
-        path: null,
-        url: f.url,
-        keyHex: "",
-        keyStrength: 0,
-        flatness: 0,
-        rejected: `couldn't fetch the candidate (${String(err)}) \u2014 re-run later; the URL stays live.`
-      });
-      continue;
-    }
-    const r = solveMagentaGlass(png);
-    if (!r.ok) {
-      solved.push({
-        path: null,
-        url: f.url,
-        keyHex: r.keyHex,
-        keyStrength: r.keyStrength,
-        flatness: r.flatness,
-        rejected: r.rejected
-      });
-      continue;
+      const res = await fetch(`${playUrl}?_genexlive=${n++}`, { cache: "no-store" });
+      if (res.ok && (await res.text()).includes(fingerprint)) {
+        log.success(`Live. \u{1F310}  ${playUrl}`);
+        return;
+      }
+    } catch {
     }
-    const outPath = path13.join(outDir, `glass-${i + 1}.png`);
-    await fs13.writeFile(outPath, PNG4.sync.write(r.png));
-    solved.push({
-      path: outPath,
-      url: f.url,
-      keyHex: r.keyHex,
-      keyStrength: r.keyStrength,
-      flatness: r.flatness
-    });
-  }
-  const shipped = solved.filter((s) => s.path !== null);
-  if (json) {
-    writeJson({ kind: "image", id: view.id, status: view.status, glass: solved });
-    if (shipped.length === 0) process.exitCode = 1;
-    return;
+    await sleep(1500);
   }
+  log.success(`Published. \u{1F310}  ${playUrl}`);
+  log.dim("  (If the previous build shows, hard-refresh in a few seconds.)");
+}
+
+// src/commands/make-remixable.ts
+async function runMakeRemixable(opts) {
+  const log = createLogger({ quiet: opts.quiet });
+  log.plain(c.bold("genex make-remixable"));
   log.plain("");
-  if (shipped.length > 0) {
-    log.success(`Solved ${shipped.length} glass panel(s) \u2014 real translucency baked in the alpha:`);
-  }
-  for (const s of solved) {
-    if (s.path) {
-      log.plain(`  ${s.path}  ${c.dim(`key ${s.keyHex}, strength ${s.keyStrength}, flatness ${s.flatness.toFixed(3)}`)}`);
-    } else {
-      log.error(`Candidate rejected: ${s.rejected}`);
-      log.dim(`  raw candidate stays at ${s.url}`);
-    }
+  const meta = await readProject();
+  if (!meta) {
+    log.error("No genex project here. Run `genex init` in this directory first.");
+    process.exitCode = 1;
+    return;
   }
-  if (shipped.length > 0) {
-    log.plain("");
-    log.dim(
-      "  Wire the PNG like any sprite (TextureLoader / <img>): its alpha IS the glass \u2014 no CSS opacity, no plate underneath. See genex-ai-image (--glass) and genex-ai-menu."
-    );
-  } else {
+  const token = await readUserToken(opts.envPath);
+  if (!token) {
+    log.error("Not authorized. Run `genex init` first to sign in.");
     process.exitCode = 1;
+    return;
   }
-}
-async function awaitAndReport(apiUrl, token, id, kind, log, open = false, json = false) {
-  if (!json) log.step("Generating\u2026 (this can take up to a minute)");
-  const view = await waitForTerminalView(
-    apiUrl,
-    token,
-    id,
-    kind,
-    json ? () => {
-    } : (p) => log.dim(`  ${p}%`)
-  );
-  if (!view) {
-    if (json) writeJson({ kind, id, status: "failed", error: "Timed out waiting for the generation." });
-    else log.error("Timed out waiting for the generation.");
+  const apiUrl = getApiUrl(opts.apiUrl ?? meta.apiUrl);
+  log.step("Preparing a public repo for your game\u2026");
+  let res;
+  try {
+    res = await apiFetch(`${apiUrl}/api/projects/${meta.id}/make-remixable`, {
+      method: "POST",
+      headers: { Authorization: `Bearer ${token}` }
+    });
+  } catch (err) {
+    log.error(`Couldn't reach the API at ${apiUrl}: ${String(err)}`);
     process.exitCode = 1;
     return;
   }
-  await reportTerminal(kind, view, log, open, json);
-}
-async function waitForTerminalView(apiUrl, token, id, kind, onProgress = () => {
-}) {
-  const timeoutMs = waitTimeoutFor(kind);
-  const deadline = Date.now() + timeoutMs;
-  const streamed = await waitViaSSE(apiUrl, token, id, onProgress, deadline);
-  return streamed === "unsupported" ? poll(apiUrl, token, id, onProgress, timeoutMs) : streamed;
-}
-async function reportTerminal(kind, view, log, open = false, json = false) {
-  if (view.status !== "completed") {
-    if (json) writeJson({ kind, id: view.id, status: view.status, error: view.error ?? null });
-    else log.error(`Generation ${view.status}${view.error ? `: ${view.error}` : ""}.`);
-    if (view.status === "failed") {
-      await recordTerminal(view.id, "failed");
-      if (kind === "video") {
-        const failures = await countFailed("video");
-        (failures >= 2 ? log.plain : log.dim)(videoFailureAdvice(failures));
-      }
-    }
+  if (res.status === 401) {
+    log.error("Not authorized \u2014 your token may have expired. Re-run `genex init`.");
     process.exitCode = 1;
     return;
   }
-  const files = view.files ?? [];
-  if (files.length === 0) {
-    if (json) writeJson({ kind, id: view.id, status: "failed", error: "Generation completed but produced no files." });
-    else log.error("Generation completed but produced no files.");
+  if (res.status === 404) {
+    log.error("That game wasn't found on your account. Re-run `genex init` or `genex link <slug>`.");
     process.exitCode = 1;
     return;
   }
-  await recordTerminal(view.id, "completed", files.map((f) => f.url));
-  if (kind === "character_concept") {
-    reportCharacterConceptTerminal(view, log, { json, open });
+  if (!res.ok) {
+    log.error(`Couldn't make the game public (HTTP ${res.status}).`);
+    process.exitCode = 1;
     return;
   }
-  if (kind === "character_preview") {
-    reportCharacterPreviewTerminal(view, log, { json, open });
+  const data = await res.json().catch(() => null);
+  if (!data?.pushUrl) {
+    log.error("The API didn't return a push URL.");
+    process.exitCode = 1;
     return;
   }
-  if (json) {
-    writeJson({
-      kind,
-      id: view.id,
-      status: view.status,
-      files,
-      ...kind === "character" ? {
-        characterId: view.id,
-        nextCommand: `genex controller character --character ${view.id}`
-      } : {}
-    });
+  log.step("Copying your game's source to the public repo\u2026");
+  if (!await pushWorktree(process.cwd(), data.pushUrl, true, log)) {
+    process.exitCode = 1;
     return;
   }
-  log.plain("");
-  log.success("Done \u2014 live on R2 (nothing downloaded or committed):");
-  for (const f of files) {
-    const label = files.length > 1 ? `${c.dim(`${f.role.replace(/^texture-/, "")}: `)}` : "";
-    log.plain(`  ${label}${f.url}`);
+  const newCloneUrl = data.project?.cloneUrl;
+  if (newCloneUrl && newCloneUrl !== meta.cloneUrl) {
+    await writeProject({ ...meta, cloneUrl: newCloneUrl });
   }
   log.plain("");
-  if (kind === "texture" && files[0]) await reportTextureSeam(files[0].url, log);
-  if (open && files[0]) {
-    openUrl(files[0].url);
-    log.plain(
-      `  ${c.bold("\u{1F441}  Show this to the user")} \u2014 it just opened in their browser; paste this link in chat too so they can open it themselves:`
-    );
-    log.plain(`     ${files[0].url}`);
-    log.plain("");
+  log.success("Your game is public \u2014 anyone can remix it now. \u{1F310}");
+  const dashboard = meta.dashboardOrigins?.[0];
+  if (dashboard) {
+    const page = meta.status === "published" ? "world" : "draft";
+    log.plain(`  your game's page: ${c.cyan(`${dashboard}/${page}/${meta.slug}`)}`);
   }
-  printHint(kind, view, files, log);
-  await maybePrintHudStageNudge(view, log);
-}
-var STAGE1_PROMPT_MARKER = "A screenshot of a complete game HUD";
-var STAGE2_PROMPT_MARKER = "Look at this game HUD screenshot";
-var MENU_STILL_PROMPT_MARKER = "No UI elements, no text, no buttons in the frame.";
-var STAGE1_LANDING_NUDGE = "\u2192 HUD mockup landed: you are the art director \u2014 enqueue the Stage-2 sheet + menu still + logotype now (--no-wait). The keep/change answer can loop the concept later \u2014 do not wait for it (genex-ai-hud).";
-async function shouldNudgeStage1(id, cwd = process.cwd()) {
-  const ledger = await readLedger(cwd);
-  const idx = ledger.findIndex((e) => e.id === id);
-  const me = ledger[idx];
-  if (!me || me.kind !== "image" || !me.prompt.startsWith(STAGE1_PROMPT_MARKER)) return false;
-  return !ledger.some(
-    (e, i) => i > idx && e.kind === "image" && e.prompt.startsWith(STAGE2_PROMPT_MARKER)
-  );
 }
-async function maybePrintHudStageNudge(view, log) {
+
+// src/lib/detect-features.ts
+import fs14 from "fs/promises";
+import path14 from "path";
+
+// src/lib/generation-ledger.ts
+import fs13 from "fs/promises";
+import path13 from "path";
+var ledgerPath = (cwd) => path13.join(cwd, ".genex", "generations.ndjson");
+async function append(cwd, event) {
   try {
-    if (view.status !== "completed") return;
-    if (await shouldNudgeStage1(view.id)) {
-      log.plain("");
-      log.plain(`  ${c.bold(STAGE1_LANDING_NUDGE)}`);
-    }
+    await fs13.access(path13.join(cwd, ".genex"));
+    await fs13.appendFile(ledgerPath(cwd), `${JSON.stringify(event)}
+`, "utf8");
   } catch {
   }
 }
-function videoFailureAdvice(failures) {
-  if (failures >= 2) {
-    return `  ${c.bold(`\u270B ${failures} failed videos in this project \u2014 don't queue another attempt of the same clip.`)} One retry per clip is the budget. Use its key-art still as the backdrop instead (the genex-ai-menu skill's built-in fallback; a slow CSS pan gives it life), tell the user in one plain line, and spend the minutes in the game.`;
-  }
-  return "  Video renders fail server-side sometimes. One retry is fair \u2014 shorter clip (4\u20136 s), simpler motion. After a second failure, switch to the key-art still (genex-ai-menu's fallback) instead of a third attempt.";
-}
-var WAIT_TIMEOUT_MS = 10 * 60 * 1e3;
-var KIND_WAIT_TIMEOUT_MS = {
-  video: 15 * 60 * 1e3,
-  // 15 min
-  motion: 20 * 60 * 1e3,
-  // 8 takes ≈ 8-9 GPU min + a serverless cold start
-  character_concept: 15 * 60 * 1e3,
-  character_preview: 30 * 60 * 1e3,
-  character: 30 * 60 * 1e3,
-  character_animation: 20 * 60 * 1e3,
-  // Per clip this lane is fast (locomotion ~2s, video ~51s, described ~130s) —
-  // the BATCH is what takes time. A 20-clip standard set is the sizing case.
-  character_motion: 30 * 60 * 1e3
-};
-var waitTimeoutFor = (kind) => KIND_WAIT_TIMEOUT_MS[kind] ?? WAIT_TIMEOUT_MS;
-var TERMINAL = /* @__PURE__ */ new Set(["completed", "failed"]);
-async function waitViaSSE(apiUrl, token, id, onProgress, deadline) {
-  let connectFailures = 0;
-  let last = -1;
-  while (Date.now() < deadline) {
-    const abort = new AbortController();
-    const timer = setTimeout(() => abort.abort(), deadline - Date.now());
-    try {
-      let res;
-      try {
-        res = await apiFetch(`${apiUrl}/api/generations/${id}/events`, {
-          headers: { Authorization: `Bearer ${token}`, Accept: "text/event-stream" },
-          signal: abort.signal
-        });
-      } catch {
-        if (++connectFailures >= 3) return "unsupported";
-        await sleep(2e3);
-        continue;
-      }
-      if (res.status === 404 || res.status === 405) return "unsupported";
-      const contentType = res.headers.get("content-type") ?? "";
-      if (!res.ok || !res.body || !contentType.includes("text/event-stream")) {
-        if (++connectFailures >= 3) return "unsupported";
-        await sleep(2e3);
-        continue;
-      }
-      connectFailures = 0;
-      try {
-        for await (const ev of readSSE(res.body)) {
-          if (ev.event !== "status") continue;
-          let view;
-          try {
-            view = JSON.parse(ev.data);
-          } catch {
-            continue;
-          }
-          if (view.progress !== last) {
-            last = view.progress;
-            onProgress(view.progress);
-          }
-          if (TERMINAL.has(view.status)) return view;
-        }
-      } catch {
-      }
-      await sleep(1e3);
-    } finally {
-      clearTimeout(timer);
-      abort.abort();
-    }
+async function readLedger(cwd = process.cwd()) {
+  let raw;
+  try {
+    raw = await fs13.readFile(ledgerPath(cwd), "utf8");
+  } catch {
+    return [];
   }
-  return null;
-}
-async function poll(apiUrl, token, id, onProgress, timeoutMs) {
-  const deadline = Date.now() + timeoutMs;
-  let last = -1;
-  while (Date.now() < deadline) {
+  const entries = /* @__PURE__ */ new Map();
+  for (const line of raw.split("\n")) {
+    if (!line.trim()) continue;
     try {
-      const res = await apiFetch(`${apiUrl}/api/generations/${id}`, {
-        headers: { Authorization: `Bearer ${token}` }
-      });
-      if (res.ok) {
-        const { generation } = await res.json();
-        if (generation.progress !== last) {
-          last = generation.progress;
-          onProgress(generation.progress);
+      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"
+          });
         }
-        if (generation.status === "completed" || generation.status === "failed") {
-          return generation;
+      } 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 {
     }
-    await sleep(3e3);
-  }
-  return null;
-}
-async function reportTextureSeam(url, log) {
-  try {
-    const res = await fetch(url);
-    if (!res.ok) return;
-    const png = PNG4.sync.read(Buffer.from(await res.arrayBuffer()));
-    if (png.width < 4 || png.height < 4) return;
-    const r = measureSeam(png);
-    if (r.seamless) {
-      log.dim(`  Tiling check: seam ${r.worstRatio}\xD7 this texture's own detail \u2014 tiles cleanly.`);
-      return;
-    }
-    log.error(
-      `Visible ${r.worstAxis} tiling seam \u2014 the tile boundary jumps ${r.worstRatio}\xD7 this texture's own detail (want \u2264 ${r.tolerance}\xD7).`
-    );
-    log.plain("  It will read as a repeating grid on any large surface. Before wiring it in:");
-    log.plain('  \u2022 regenerate with "seamless tiling, no visible edges" in the prompt (--terrain for ground).');
-    log.plain("  Do NOT hide it by tiling less: a hand-picked repeat trades a seam you can name for a");
-    log.plain("  stretched texture you can't. Scale belongs in the UVs (worldUV \u2014 genex-ai-texture).");
-    log.plain(`  Re-check any image any time: ${c.cyan("npx genex ui seams --in <url>")}`);
-  } catch {
-  }
-}
-function printHint(kind, view, files, log) {
-  const url = files[0]?.url ?? "";
-  const hint = {
-    model: `Standard GLB \u2014 load with GLTFLoader straight from the URL \u2014 see the genex-ai-model skill. url = "${url}"`,
-    skybox: `Load as an equirectangular texture \u2192 scene.background + scene.environment \u2014 see genex-ai-skybox. url = "${url}"`,
-    sfx: `Load with AudioLoader into a THREE.PositionalAudio (camera needs an AudioListener) \u2014 see genex-ai-sfx. url = "${url}"`,
-    music: `Load with AudioLoader into a non-positional THREE.Audio: setLoop(true), setVolume(0.30), start on the first user gesture \u2014 and the settings screen MUST have Music + SFX volume sliders \u2014 see genex-ai-music. url = "${url}"`,
-    voice: `Load with AudioLoader into a THREE.Audio (or PositionalAudio at the speaker); voice lines are content \u2014 keep them short, SUBTITLED, and skippable \u2014 see genex-ai-voice. url = "${url}"`,
-    texture: `Load each map with TextureLoader (RepeatWrapping) into a MeshStandardMaterial \u2014 see genex-ai-texture. Use the URLs above by role.`,
-    image: `Load with TextureLoader (set colorSpace = SRGBColorSpace) onto any mesh/plane/sprite \u2014 see genex-ai-image. url = "${url}"`,
-    video: `Wire an HTMLVideoElement (crossOrigin="anonymous", muted, loop, playsInline) into a THREE.VideoTexture \u2014 see genex-ai-video. url = "${url}"`,
-    motion: `Raw ARDY takes + verify report \u2014 download the takes, rename them meaningfully (routing is by filename), then: genex motion verify \u2192 compile \u2192 install. Full procedure: the genex-ai-character skill's motion reference.`,
-    character_concept: "Show all three concept candidates to the user and wait for an explicit selection.",
-    character_preview: "Show all four preview views to the user and wait for explicit approval before finalizing.",
-    character: `Install the controller and current manifest with genex controller character --character ${view.id}.`,
-    character_animation: "The action is now part of the character's current manifest; refresh the local controller manifest before testing.",
-    character_motion: `The clips are part of the character's current manifest \u2014 install them with genex controller character --character ${view.id}, then play the game and watch the motion on the real character before calling it done.`
-  };
-  log.dim(`  ${hint[kind]}`);
-  log.dim("  Reference the URL directly in your code \u2014 don't download it into the repo.");
-}
-var CONCEPT_STOP = "STOP \u2014 show all three concept images to the user and wait for an explicit selection. Do not create the 3D preview until they choose candidate 1, 2, or 3.";
-function metadataOf(view) {
-  return view.metadata && typeof view.metadata === "object" ? view.metadata : {};
-}
-function stringValue(value) {
-  return typeof value === "string" && value.length > 0 ? value : void 0;
-}
-function finiteNumber(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
-}
-function conceptCandidates(view) {
-  const candidates = [];
-  for (const file of view.files ?? []) {
-    const match = /^(?:concept-candidate|character-concept)-([123])(?:\.[a-z0-9]+)?$/i.exec(file.role);
-    if (!match) continue;
-    candidates.push({ candidate: Number(match[1]), role: file.role, url: file.url });
   }
-  return candidates.sort((a, b) => a.candidate - b.candidate);
-}
-function conceptContactSheet(view) {
-  return (view.files ?? []).find(
-    (file) => /^(?:concept-gallery|character-concepts-contact-sheet)(?:\.[a-z0-9]+)?$/i.test(file.role)
-  );
+  return [...entries.values()];
 }
-function requestedBuildOf(view) {
-  const metadata = metadataOf(view);
-  const raw = metadata.requestedBuild && typeof metadata.requestedBuild === "object" ? metadata.requestedBuild : {};
-  const actionIds = Array.isArray(raw.actionIds) ? raw.actionIds.filter((id) => typeof id === "number" && Number.isInteger(id)) : [];
-  return {
-    actionIds,
-    controllerPack: raw.controllerPack !== false,
-    ...finiteNumber(raw.heightMeters) === void 0 ? {} : { heightMeters: finiteNumber(raw.heightMeters) }
-  };
+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()
+  });
 }
-function characterFinalizeCommand(previewId, intent) {
-  const args = [
-    "genex",
-    "character",
-    "finalize",
-    previewId,
-    "--user-approved",
-    "--approve-remesh",
-    "10000"
-  ];
-  if (intent.heightMeters !== void 0) args.push("--height", String(intent.heightMeters));
-  for (const actionId of intent.actionIds) args.push("--animation", String(actionId));
-  return args.join(" ");
+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 } : {} });
 }
-function reportCharacterConceptTerminal(view, log, opts = {}) {
-  const candidates = conceptCandidates(view);
-  if (candidates.length !== 3 || candidates.some((entry, index) => entry.candidate !== index + 1)) {
-    const error = "Character concept generation completed without exactly candidates 1, 2, and 3.";
-    if (opts.json) writeJson({ kind: "character_concept", id: view.id, status: "failed", error });
-    else log.error(error);
-    process.exitCode = 1;
-    return;
-  }
-  const metadata = metadataOf(view);
-  const contactSheet = conceptContactSheet(view);
-  const nextCommand = `genex character preview ${view.id} --candidate <n> --user-approved`;
-  if (opts.open) openUrl(contactSheet?.url ?? candidates[0].url);
-  if (opts.json) {
-    writeJson({
-      kind: "character_concept",
-      stage: "concept",
-      id: view.id,
-      status: view.status,
-      provider: stringValue(metadata.provider),
-      model: stringValue(metadata.aiModel) ?? stringValue(metadata.providerModel),
-      candidates,
-      ...contactSheet ? { contactSheetUrl: contactSheet.url } : {},
-      ...opts.quote ? { quote: opts.quote } : {},
-      requiresUserApproval: true,
-      nextCommand
-    });
-    return;
-  }
-  log.success("Three character concept candidates are ready:");
-  for (const candidate of candidates) log.plain(`  ${candidate.candidate}. ${candidate.url}`);
-  if (contactSheet) log.plain(`  Contact sheet: ${contactSheet.url}`);
-  log.plain("");
-  log.plain(`  ${c.bold("\u{1F441}  Show these to the user")} \u2014 include all three numbered links, not only your favorite.`);
-  log.plain(`  ${c.bold(CONCEPT_STOP)}`);
-  log.plain(`  After approval: ${c.cyan(nextCommand)}`);
-  log.plain("");
+async function countFailed(kind, cwd = process.cwd()) {
+  return (await readLedger(cwd)).filter((e) => e.kind === kind && e.status === "failed").length;
 }
-var PREVIEW_DIRECTIONS = ["front", "back", "left", "right"];
-function previewViews(view) {
-  const metadata = metadataOf(view);
-  const rawViews = metadata.views && typeof metadata.views === "object" ? metadata.views : {};
-  const result = {};
-  for (const direction of PREVIEW_DIRECTIONS) {
-    const fromMetadata = stringValue(rawViews[direction]);
-    const fromFile = (view.files ?? []).find((file) => {
-      const role = file.role.toLowerCase();
-      return file.contentType.startsWith("image/") && role.includes(direction);
-    })?.url;
-    result[direction] = fromMetadata ?? fromFile;
+
+// src/lib/detect-features.ts
+async function detectEmbedSdkVersion(cwd = process.cwd()) {
+  try {
+    const raw = await fs14.readFile(path14.join(cwd, "package.json"), "utf8");
+    const pkg = JSON.parse(raw);
+    const version = pkg.dependencies?.["@genex-ai/embed-sdk"] ?? pkg.devDependencies?.["@genex-ai/embed-sdk"];
+    return typeof version === "string" && version ? version : null;
+  } catch {
+    return null;
   }
-  return result;
 }
-function previewSource(view) {
-  return (view.files ?? []).find(
-    (file) => file.contentType === "model/gltf-binary" || /(?:source-highpoly|character-preview)(?:\.glb)?$/i.test(file.role)
-  )?.url;
+async function detectMultiplayer(cwd = process.cwd()) {
+  try {
+    const raw = await fs14.readFile(path14.join(cwd, "package.json"), "utf8");
+    const pkg = JSON.parse(raw);
+    return Boolean(
+      pkg.dependencies?.["@genex-ai/multiplayer"] ?? pkg.devDependencies?.["@genex-ai/multiplayer"]
+    );
+  } catch {
+    return false;
+  }
 }
-function reportCharacterPreviewTerminal(view, log, opts = {}) {
-  const metadata = metadataOf(view);
-  const views = previewViews(view);
-  const sourceFaceCount = finiteNumber(metadata.sourceFaceCount);
-  const missingViews = PREVIEW_DIRECTIONS.filter((direction) => !views[direction]);
-  if (sourceFaceCount === void 0 || missingViews.length > 0) {
-    const detail = [
-      sourceFaceCount === void 0 ? "source face count" : "",
-      missingViews.length > 0 ? `${missingViews.join(", ")} view${missingViews.length === 1 ? "" : "s"}` : ""
-    ].filter(Boolean).join(" and ");
-    const error = `Character preview completed without ${detail}.`;
-    if (opts.json) writeJson({ kind: "character_preview", id: view.id, status: "failed", error });
-    else log.error(error);
-    process.exitCode = 1;
-    return;
+async function detectMatchmaking(log, cwd = process.cwd()) {
+  let pkg;
+  try {
+    pkg = JSON.parse(await fs14.readFile(path14.join(cwd, "package.json"), "utf8"));
+  } catch (err) {
+    log.dim(`  (skipping matchmaking \u2014 couldn't read package.json: ${String(err)})`);
+    return null;
   }
-  const intent = requestedBuildOf(view);
-  const nextCommand = characterFinalizeCommand(view.id, intent);
-  const sourceUrl = previewSource(view);
-  const stop = `STOP \u2014 show the front, back, left, and right views to the user. The high-detail source has ${sourceFaceCount} faces and remains preserved in R2. Ask them to approve a separate 10,000-face triangle rigging copy.`;
-  if (opts.open) openUrl(views.front);
-  if (opts.json) {
-    writeJson({
-      kind: "character_preview",
-      stage: "preview",
-      id: view.id,
-      status: view.status,
-      provider: stringValue(metadata.provider),
-      model: stringValue(metadata.aiModel) ?? stringValue(metadata.providerModel),
-      poseMode: stringValue(metadata.poseMode),
-      shouldRemesh: metadata.shouldRemesh === true,
-      sourceFaceCount,
-      views,
-      ...sourceUrl ? { sourceUrl } : {},
-      requestedBuild: intent,
-      ...opts.quote ? { quote: opts.quote } : {},
-      requiresUserApproval: true,
-      nextCommand
-    });
-    return;
+  const mm = pkg.genex?.matchmaking;
+  if (mm && typeof mm.preset === "string" && mm.preset) {
+    return {
+      preset: mm.preset,
+      ...mm.winCondition ? { winCondition: mm.winCondition } : {},
+      ...mm.config ? { config: mm.config } : {}
+    };
   }
-  log.success("The high-detail Meshy character preview is ready:");
-  for (const direction of PREVIEW_DIRECTIONS) log.plain(`  ${direction}: ${views[direction]}`);
-  if (sourceUrl) log.plain(`  High-detail source: ${sourceUrl}`);
-  log.plain("");
-  log.plain(`  ${c.bold("\u{1F441}  Show these to the user")} \u2014 include all four views.`);
-  log.plain(`  ${c.bold(stop)}`);
-  log.plain(`  After approval: ${c.cyan(nextCommand)}`);
-  log.plain("");
-}
-function writeJson(value) {
-  process.stdout.write(`${JSON.stringify(value)}
-`);
+  return null;
 }
-
-// src/lib/deploy.ts
-function run(cmd, args, env) {
-  return new Promise((resolve) => {
-    let child;
+var TOUCH_KIT_MARKERS = /controllers\/touch\/|controllers\/character\/touch-joystick|TouchJoystick|VirtualButton|DragZone|RotateOverlay/;
+async function detectMobileControls(cwd = process.cwd()) {
+  try {
+    const raw = await fs14.readFile(path14.join(cwd, "package.json"), "utf8");
+    const pkg = JSON.parse(raw);
+    if (pkg.genex?.mobileControls === true) return true;
+  } catch {
+  }
+  const srcDir = path14.join(cwd, "src");
+  let entries;
+  try {
+    entries = await fs14.readdir(srcDir, { recursive: true });
+  } catch {
+    return false;
+  }
+  for (const rel of entries) {
+    if (rel.includes("node_modules")) continue;
+    if (!/\.(ts|js|mts|mjs|tsx|jsx)$/.test(rel)) continue;
     try {
-      child = spawn4(cmd, args, { env: env ? { ...process.env, ...env } : process.env });
+      const content = await fs14.readFile(path14.join(srcDir, rel), "utf8");
+      if (TOUCH_KIT_MARKERS.test(content)) return true;
     } catch {
-      resolve({ code: -1, out: "", err: `${cmd} not found` });
-      return;
     }
-    let out = "";
-    let err = "";
-    child.stdout?.on("data", (d) => out += String(d));
-    child.stderr?.on("data", (d) => err += String(d));
-    child.on("error", () => resolve({ code: -1, out, err: `${cmd} not found` }));
-    child.on("close", (code2) => resolve({ code: code2 ?? -1, out, err }));
-  });
+  }
+  return false;
 }
-function printMobilePreflight(files, log) {
+var GAME_STATE_CALLS = /savePlayerState|saveWorldState|submitScore/;
+async function detectGameStateUsage(cwd = process.cwd()) {
+  const srcDir = path14.join(cwd, "src");
+  let entries;
   try {
-    const scan = scanBundle(files.map((f) => ({ relPath: f.relPath, bytes: f.bytes })));
-    const externalDims = /* @__PURE__ */ new Map();
-    for (const url of scan.genexAssetUrls) {
-      const role = url.split("/").pop() ?? "";
-      if (scan.markers.adaptiveQuality && role === SKYBOX_ROLE) {
-        externalDims.set(url, { width: 2048, height: 1024 });
-      } else if (scan.markers.modelRungs && role.endsWith("-glb")) {
-        externalDims.set(url, { width: 1024, height: 2048, glb: true });
-      } else {
-        externalDims.set(url, null);
-      }
-    }
-    const est = estimateVram(scan, externalDims);
-    const tier = tierFor(est.estVramMb);
-    const line = `Mobile preflight: ~${est.estVramMb} MB est. GPU memory on phones (budget: <${MOBILE_BUDGET_MB.broad} MB broad, <${MOBILE_BUDGET_MB.modern} MB modern) \u2014 ${tier}.`;
-    if (tier === "mobile-broad") {
-      log.dim(`  ${line}`);
-      return;
-    }
-    log.warn(line);
-    for (const url of est.unresolvedExternals) {
-      const role = url.split("/").pop() ?? "";
-      if (role === SKYBOX_ROLE) {
-        log.warn(
-          `  Skybox loaded full-size (${url.slice(0, 80)}\u2026): ~178 MB decoded on phones. Load it through pickAsset (genex-threejs-adaptive-quality) so phones get the @2048 rung.`
-        );
-      } else if (role.endsWith("-glb")) {
-        log.warn(
-          `  Model loaded without pickModel (${url.slice(0, 80)}\u2026) \u2014 phones fetch the full provider-raw GLB. Load it through loadModelWithFallback (genex-threejs-adaptive-quality) so phones get the @1024 rung.`
-        );
-      }
-    }
-    if (est.textureMaxDim > 2048) {
-      log.warn(`  Largest texture is ${est.textureMaxDim}px \u2014 phones want \u22642048 (props \u22641024).`);
+    entries = await fs14.readdir(srcDir, { recursive: true });
+  } catch {
+    return false;
+  }
+  for (const rel of entries) {
+    if (rel.includes("node_modules")) continue;
+    if (!/\.(ts|js|mts|mjs|tsx|jsx)$/.test(rel)) continue;
+    try {
+      const content = await fs14.readFile(path14.join(srcDir, rel), "utf8");
+      if (GAME_STATE_CALLS.test(content)) return true;
+    } catch {
     }
-    if (scan.markers.postStack && scan.markers.dprCapLiteral == null) {
-      log.warn(
-        "  Post stack detected with no devicePixelRatio cap \u2014 cap at 1.5 on phones (genex-threejs-adaptive-quality)."
-      );
+  }
+  return false;
+}
+function ctorArgs(content, ctor) {
+  const out = [];
+  const re = new RegExp(`new\\s+(?:THREE\\.)?${ctor}\\s*\\(`, "g");
+  let m;
+  while (m = re.exec(content)) {
+    let i = re.lastIndex;
+    let depth = 1;
+    while (i < content.length && depth > 0) {
+      const ch = content[i];
+      if (ch === "(" || ch === "{" || ch === "[") depth++;
+      else if (ch === ")" || ch === "}" || ch === "]") depth--;
+      i++;
     }
-    if (!scan.markers.contextLossHandler) {
-      log.warn("  No context-loss handler found \u2014 one GPU reset shows a dead canvas on phones.");
+    out.push({ text: content.slice(re.lastIndex, i - 1), index: m.index });
+  }
+  return out;
+}
+function splitArgs(text) {
+  const out = [];
+  let depth = 0;
+  let start = 0;
+  for (let i = 0; i < text.length; i++) {
+    const ch = text[i];
+    if (ch === "(" || ch === "{" || ch === "[") depth++;
+    else if (ch === ")" || ch === "}" || ch === "]") depth--;
+    else if (ch === "," && depth === 0) {
+      out.push(text.slice(start, i).trim());
+      start = i + 1;
     }
-  } catch {
   }
+  out.push(text.slice(start).trim());
+  return out;
 }
-async function printUiAuditPreflight(log) {
+var lineOf = (content, index) => content.slice(0, index).split("\n").length;
+var DEPTH_RATIO_LIMIT = 1e6;
+async function detectSurfaceScan(cwd = process.cwd()) {
+  const found = { guessedRepeat: [], squarePoints: [], depthRange: [] };
+  const srcDir = path14.join(cwd, "src");
+  let entries;
   try {
-    const findings = await collectUiAuditFindings("public/assets/hud", "src");
-    if (!findings || findings.length === 0) return;
-    log.warn(
-      `HUD wiring audit: ${findings.length} finding(s) \u2014 heuristics, check each (\`npx genex ui audit\` for the full report):`
-    );
-    for (const finding of findings.slice(0, 6)) log.warn(`  [${finding.kind}] ${finding.message}`);
-    if (findings.length > 6) log.dim(`  \u2026and ${findings.length - 6} more.`);
+    entries = await fs14.readdir(srcDir, { recursive: true });
   } catch {
+    return found;
   }
-}
-async function printPipelineStatePreflight(log, cwd = process.cwd()) {
-  try {
-    const ledger = await readLedger(cwd);
-    const design = await fs14.readFile(path14.join(cwd, "DESIGN.md"), "utf8").catch(() => "");
-    const fullPrompt = (e) => `${e.prompt} ${e.promptTail ?? ""}`;
-    const warnings = [];
-    const stage1Done = ledger.some(
-      (e) => e.kind === "image" && e.status === "completed" && e.prompt.startsWith(STAGE1_PROMPT_MARKER)
-    );
-    const stage2Enqueued = ledger.some(
-      (e) => e.kind === "image" && e.prompt.startsWith(STAGE2_PROMPT_MARKER)
-    );
-    if (stage1Done && !stage2Enqueued) warnings.push(STAGE1_LANDING_NUDGE);
-    const menuStillDone = ledger.some(
-      (e) => e.kind === "image" && e.status === "completed" && fullPrompt(e).includes(MENU_STILL_PROMPT_MARKER)
-    );
-    const videoEnqueued = ledger.some((e) => e.kind === "video");
-    const videoDeclined = /menu video:\s*declined/i.test(design);
-    if (menuStillDone && !videoEnqueued && !videoDeclined) {
-      warnings.push(
-        'Menu video not enqueued \u2014 the animated menu backdrop is the default for every game. Enqueue it (genex-ai-menu), or record "Menu video: declined (reason)" in DESIGN.md if the player declined it.'
-      );
-    }
-    if (design.length > 0 && !/##\s*build plan & status/i.test(design)) {
-      warnings.push(
-        "DESIGN.md has no `## Build plan & status` section \u2014 numbered milestones with a `Now:` line are how a compacted or resumed session knows where the build is (genex-game-director's design contract has the shape)."
-      );
+  for (const rel of entries) {
+    if (rel.includes("node_modules")) continue;
+    if (!/\.(ts|js|mts|mjs|tsx|jsx)$/.test(rel)) continue;
+    const raw = await fs14.readFile(path14.join(srcDir, rel), "utf8").catch(() => "");
+    if (!raw) continue;
+    const content = raw.replace(/\/\*[\s\S]*?\*\//g, (m2) => m2.replace(/[^\n]/g, " ")).replace(/(^|[^:])\/\/[^\n]*/gm, (m2, p1) => p1 + " ".repeat(m2.length - p1.length));
+    const repeatRe = /\.repeat\.set\(\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)\s*\)/g;
+    let m;
+    while (m = repeatRe.exec(content)) {
+      const u = Number(m[1]);
+      const v = Number(m[2]);
+      if (u === v) continue;
+      found.guessedRepeat.push({
+        where: `${rel}:${lineOf(content, m.index)}`,
+        detail: `repeat.set(${m[1]}, ${m[2]})`
+      });
     }
-    if (!/hud lane:/i.test(design)) {
-      const hudDom = await hasHudLikeDom(cwd);
-      if (hudDom && !await hasExtractionSidecars(cwd)) {
-        warnings.push(
-          'HUD appears hand-built with no recorded lane decision \u2014 the concept decides the lane: run the sprite pipeline (genex-ai-hud), or record "HUD lane: CSS (\u2026, one-line justification)" in DESIGN.md.'
-        );
-      }
+    for (const call of ctorArgs(content, "PointsMaterial")) {
+      if (/\b(map|alphaMap)\s*:/.test(call.text)) continue;
+      found.squarePoints.push({
+        where: `${rel}:${lineOf(content, call.index)}`,
+        detail: "PointsMaterial with no map/alphaMap"
+      });
     }
-    if (!/player character:/i.test(design)) {
-      const hasCharacter = await fs14.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).`
-        );
-      }
+    for (const call of ctorArgs(content, "PerspectiveCamera")) {
+      const args = splitArgs(call.text);
+      if (args.length < 4) continue;
+      const near = Number(args[2]);
+      const far = Number(args[3]);
+      if (!isFinite(near) || !isFinite(far) || near <= 0 || far <= near) continue;
+      const ratio = far / near;
+      if (ratio <= DEPTH_RATIO_LIMIT) continue;
+      found.depthRange.push({
+        where: `${rel}:${lineOf(content, call.index)}`,
+        detail: `near ${near} / far ${far}`,
+        ratio
+      });
     }
-    for (const w of warnings) log.warn(w);
-  } catch {
   }
+  return found;
 }
-async function hasHudLikeDom(cwd) {
-  const HUD_MARKERS = /\bhud\b|health-?bar|mana-?bar|stamina-?bar|ammo-?count/i;
-  const files = [];
+var WIRED_BY_URL = /* @__PURE__ */ new Set(["model", "skybox", "sfx", "music", "texture", "video"]);
+var UNPICKED_AFTER_MS = 15 * 60 * 1e3;
+async function detectGenerationAudit(cwd = process.cwd()) {
+  const ledger = await readLedger(cwd);
+  const audited = ledger.filter((e) => WIRED_BY_URL.has(e.kind));
+  if (audited.length === 0) return { unwired: [], unpicked: [], unresolved: [], deadWired: [] };
+  let haystack = "";
+  const read = async (file) => {
+    try {
+      haystack += await fs14.readFile(file, "utf8");
+    } catch {
+    }
+  };
   try {
     for (const entry of await fs14.readdir(cwd, { withFileTypes: true })) {
-      if (entry.isFile() && /\.(html|css)$/.test(entry.name)) files.push(path14.join(cwd, entry.name));
+      if (entry.isFile() && /\.(ts|tsx|js|jsx|css|html|json)$/.test(entry.name)) {
+        await read(path14.join(cwd, entry.name));
+      }
     }
   } catch {
   }
-  try {
-    const entries = await fs14.readdir(path14.join(cwd, "src"), { recursive: true });
-    for (const rel of entries) {
-      if (rel.includes("node_modules")) continue;
-      if (/\.(ts|tsx|js|jsx|html|css)$/.test(rel)) files.push(path14.join(cwd, "src", rel));
+  for (const sub of ["src", "public"]) {
+    try {
+      const entries = await fs14.readdir(path14.join(cwd, sub), { recursive: true });
+      for (const rel of entries) {
+        if (rel.includes("node_modules")) continue;
+        if (!/\.(ts|tsx|js|jsx|css|html|json|txt)$/.test(rel)) continue;
+        await read(path14.join(cwd, sub, rel));
+      }
+    } catch {
     }
-  } catch {
-  }
-  for (const file of files) {
-    const text = await fs14.readFile(file, "utf8").catch(() => "");
-    if (HUD_MARKERS.test(text)) return true;
   }
-  return false;
+  const ref = ({ id, kind, prompt }) => ({
+    id,
+    kind,
+    prompt
+  });
+  const now = Date.now();
+  const stale = (e) => e.status === "queued" && now - Date.parse(e.queuedAt) > UNPICKED_AFTER_MS;
+  return {
+    unwired: audited.filter((e) => e.status === "completed" && !haystack.includes(e.id)).map(ref),
+    unpicked: audited.filter((e) => stale(e) && !haystack.includes(e.id)).map(ref),
+    // Wired in but never picked up: the deterministic URL let the agent wire
+    // the asset before it finished, so nobody ever learned whether it DID
+    // finish — a provider-side failure (credits, moderation) leaves a dead URL
+    // that renders as a silently missing asset. Kept separate from `unpicked`
+    // because the fix is a status check, not wiring.
+    unresolved: audited.filter((e) => stale(e) && haystack.includes(e.id)).map(ref),
+    // Known-failed AND still wired: the worst case, and it must keep firing
+    // AFTER the status check converges the ledger to "failed" (otherwise the
+    // audit self-erases the moment the agent runs the recommended command and
+    // the dead URL ships silently anyway).
+    deadWired: audited.filter((e) => e.status === "failed" && haystack.includes(e.id)).map(ref)
+  };
 }
-async function loadsPlayerBody(cwd) {
-  const BODY_LOADERS = /\bloadPlayerCharacter\s*\(|\bloadVrm(?:Clone)?\s*\(/;
-  try {
-    const entries = await fs14.readdir(path14.join(cwd, "src"), { recursive: true });
-    for (const rel of entries) {
-      if (rel.includes("node_modules")) 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(path14.join(cwd, "src", rel), "utf8").catch(() => "");
-      if (BODY_LOADERS.test(text)) return true;
-    }
-  } catch {
-  }
-  return false;
+async function detectFeatures(log, cwd = process.cwd()) {
+  return {
+    embedSdkVersion: await detectEmbedSdkVersion(cwd),
+    multiplayer: await detectMultiplayer(cwd),
+    matchmaking: await detectMatchmaking(log, cwd),
+    gameStateUsed: await detectGameStateUsage(cwd),
+    mobileControls: await detectMobileControls(cwd),
+    surfaces: await detectSurfaceScan(cwd),
+    generations: await detectGenerationAudit(cwd)
+  };
 }
-async function hasExtractionSidecars(cwd) {
-  try {
-    const entries = await fs14.readdir(path14.join(cwd, "public"), { recursive: true });
-    return entries.some(
-      (rel) => rel.endsWith(".annotated-progress.json") || rel.endsWith(".bbox.json")
+function advisoryNudges(log, d) {
+  if (!d.embedSdkVersion) {
+    log.warn(
+      "This game has no player identity or saves \u2014 players lose everything on refresh. The genex-threejs-embed-auth skill wires it with one call (initEmbed) \u2014 load it before publishing."
     );
-  } catch {
-    return false;
-  }
-}
-var EXCLUDE_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", ".genex", "dist"]);
-function isSecretEnvFile(name) {
-  return name === ".env" || name.startsWith(".env.") && name !== ".env.example";
-}
-async function deployGame(ctx, opts, log) {
-  const cwd = process.cwd();
-  if (!opts.noBuild && await hasBuildScript(cwd)) {
-    log.step("Building the production bundle\u2026");
-    const built = await run("npm", ["run", "build"]);
-    if (built.code !== 0) {
-      log.error("Build failed \u2014 your game was NOT deployed.");
-      const tail = (built.err || built.out).trim().split("\n").slice(-12).join("\n");
-      if (tail) log.dim(tail);
-      return false;
-    }
-    log.success("Built.");
-  }
-  const distDir = path14.join(cwd, "dist");
-  const siteDir = await isDir2(distDir) ? distDir : cwd;
-  const rel = path14.relative(cwd, siteDir) || ".";
-  if (siteDir === cwd) await writeGitignore(cwd, log);
-  const files = await collectFiles(siteDir);
-  if (files.length === 0) {
-    log.warn("Nothing to deploy \u2014 the build produced no files.");
-    return false;
-  }
-  if (!files.some((f) => f.relPath === "index.html")) {
-    log.error(`No index.html in ${rel} \u2014 a game needs one to serve. Nothing deployed.`);
-    return false;
   }
-  const lfsPointers = files.filter(
-    (f) => f.bytes.length < 1024 && f.bytes.subarray(0, 64).toString("latin1").startsWith("version https://git-lfs.github.com/spec/v")
-  );
-  if (lfsPointers.length > 0) {
-    log.error(
-      `${lfsPointers.length} file${lfsPointers.length > 1 ? "s" : ""} in ${rel} ${lfsPointers.length > 1 ? "are" : "is"} an unresolved Git LFS pointer, not the real asset \u2014 the game would fail to load at runtime. Run \`git lfs pull\` and rebuild. Nothing deployed.`
+  if (d.multiplayer && !d.embedSdkVersion) {
+    log.warn(
+      "Multiplayer will NOT work: @genex-ai/multiplayer needs the embed-sdk token (getColyseusAuth) \u2014 the relay rejects tokenless joins. Wire genex-threejs-embed-auth first."
     );
-    for (const p of lfsPointers.slice(0, 8)) log.dim(`  ${p.relPath}`);
-    if (lfsPointers.length > 8) log.dim(`  \u2026and ${lfsPointers.length - 8} more`);
-    return false;
-  }
-  printMobilePreflight(files, log);
-  await printUiAuditPreflight(log);
-  await printPipelineStatePreflight(log);
-  const commit = contentCommit(files);
-  log.step("Requesting an upload token\u2026");
-  const grant = await getUploadToken(ctx, commit, log);
-  if (!grant) return false;
-  const totalBytes = files.reduce((n, f) => n + f.bytes.length, 0);
-  const mb = (n) => (n / 1048576).toFixed(n < 1048576 ? 2 : 1);
-  if (files.length > grant.limits.maxFiles) {
-    log.error(`Too many files (${files.length} > ${grant.limits.maxFiles}). Trim the build and retry.`);
-    return false;
-  }
-  const oversized = files.find((f) => f.bytes.length > grant.limits.maxFileBytes);
-  if (oversized) {
-    log.error(`${oversized.relPath} is ${mb(oversized.bytes.length)} MB \u2014 over the ${mb(grant.limits.maxFileBytes)} MB per-file limit.`);
-    return false;
-  }
-  if (totalBytes > grant.limits.maxTotalBytes) {
-    log.error(`Build is ${mb(totalBytes)} MB \u2014 over the ${mb(grant.limits.maxTotalBytes)} MB limit.`);
-    return false;
   }
-  log.step(`Uploading ${files.length} files\u2026`);
-  if (!await uploadAll(grant, files, log)) {
-    log.error("Couldn't upload your game \u2014 please try again.");
-    return false;
+  if (d.matchmaking && !d.multiplayer) {
+    log.warn(
+      "package.json declares genex.matchmaking but @genex-ai/multiplayer is not installed \u2014 matchmaking cannot work. Install the SDK and use matchmake() (see genex-threejs-multiplayer)."
+    );
   }
-  if (!await pushSource(cwd, ctx, log)) return false;
-  log.step("Publishing\u2026");
-  if (!await callPublish(ctx, commit, opts, log)) return false;
-  const index = files.find((f) => f.relPath === "index.html");
-  await waitUntilLive(grant.playUrl, fingerprintOf(index.bytes.toString("utf8")), opts.liveTimeoutMs ?? 2e4, log);
-  return true;
+  surfaceNudges(log, d.surfaces);
+  generationNudges(log, d.generations);
 }
-async function hasBuildScript(cwd) {
-  try {
-    const pkg = JSON.parse(await fs14.readFile(path14.join(cwd, "package.json"), "utf8"));
-    return Boolean(pkg.scripts?.build);
-  } catch {
-    return false;
+function generationNudges(log, g) {
+  const describe = (refs) => refs.map((r) => `${r.kind} ${r.id} ("${r.prompt.slice(0, 48)}")`).join("; ");
+  if (g.unpicked.length) {
+    log.warn(
+      `${g.unpicked.length} generation(s) enqueued 15+ minutes ago were never picked up: ${describe(g.unpicked)}. Run npx genex wait <id> on each (npx genex wait --all shows every status at once) \u2014 landed assets get wired in before the last push of a session, never parked for "later".`
+    );
   }
-}
-async function collectFiles(root) {
-  const out = [];
-  const walk2 = async (dir, prefix) => {
-    for (const e of await fs14.readdir(dir, { withFileTypes: true })) {
-      const relPath = prefix ? `${prefix}/${e.name}` : e.name;
-      if (e.isDirectory()) {
-        if (!EXCLUDE_DIRS.has(e.name)) await walk2(path14.join(dir, e.name), relPath);
-      } else if (e.isFile() && !isSecretEnvFile(e.name)) {
-        out.push({ relPath, bytes: await fs14.readFile(path14.join(dir, e.name)) });
-      }
-    }
-  };
-  await walk2(root, "");
-  return out;
-}
-function contentCommit(files) {
-  const h = crypto3.createHash("sha1");
-  for (const f of [...files].sort((a, b) => a.relPath < b.relPath ? -1 : a.relPath > b.relPath ? 1 : 0)) {
-    h.update(f.relPath, "utf8");
-    h.update("\0");
-    h.update(f.bytes);
+  if (g.unresolved.length) {
+    log.warn(
+      `${g.unresolved.length} generation(s) are wired into the game but were never picked up, so their real status is unknown: ${describe(g.unresolved)}. A generation that failed server-side (credits, moderation) leaves a dead URL \u2014 the asset just silently never appears. One call checks them all: npx genex wait --all.`
+    );
   }
-  return h.digest("hex");
-}
-function retryAfterHint(res) {
-  const raw = Number(res.headers.get("retry-after"));
-  if (!Number.isFinite(raw) || raw <= 0) return "";
-  const secs = Math.ceil(raw);
-  return ` Try again in ${secs < 90 ? `${secs}s` : `~${Math.ceil(secs / 60)} min`}.`;
-}
-async function getUploadToken(ctx, commit, log) {
-  let res;
-  try {
-    res = await apiFetch(`${ctx.apiUrl}/api/games/${ctx.projectId}/upload-token`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json", Authorization: `Bearer ${ctx.token}` },
-      body: JSON.stringify({ commit })
-    });
-  } catch (err) {
-    log.error(`Couldn't reach the API at ${ctx.apiUrl}: ${String(err)}`);
-    return null;
+  if (g.deadWired.length) {
+    log.warn(
+      `${g.deadWired.length} FAILED generation(s) are still wired into the game: ${describe(g.deadWired)}. Those URLs will never exist \u2014 each asset silently never appears. Replace the wiring or re-generate (that bills a new one), and tell the user what changed.`
+    );
   }
-  if (res.status === 401) {
-    log.error("Not authorized (HTTP 401) \u2014 your sign-in expired or was revoked.");
-    log.plain("  Fix: run `genex link <your-game>` and sign in as the game's owner, then re-run this command.");
-    return null;
+  if (g.unwired.length) {
+    log.warn(
+      `${g.unwired.length} finished generation(s) are wired nowhere in the game: ${describe(g.unwired)}. Each was paid for \u2014 wire it in (its URL embeds the id) or tell the user in one plain line why it stays unused.`
+    );
   }
-  if (res.status === 404) {
-    log.error("This account doesn't own this game (HTTP 404) \u2014 you're signed in as a different account.");
-    log.plain("  Fix: run `genex link <your-game>` and sign in as the OWNER account, then re-run this command.");
-    return null;
+}
+function surfaceNudges(log, s) {
+  if (s.guessedRepeat.length) {
+    const list = s.guessedRepeat.map((d) => `${d.where} \u2014 ${d.detail}`).join("; ");
+    log.warn(
+      `Texture tiling picked by eye, not derived from the mesh: ${list}. A hand-chosen repeat is right for at most ONE face \u2014 a BoxGeometry gives all six faces 0..1 UVs whatever their world size, and repeat lives on the Texture, so every mesh sharing that texture inherits it. Derive the UVs from world size instead: genex-ai-texture ships worldUV(geometry, TILE_M), after which repeat stays (1, 1) and cannot be wrong.`
+    );
   }
-  if (res.status === 429) {
-    log.error(`Rate limited requesting an upload token (HTTP 429).${retryAfterHint(res)}`);
-    return null;
+  if (s.squarePoints.length) {
+    const list = s.squarePoints.map((d) => d.where).join(", ");
+    log.warn(
+      `Particles will render as hard SQUARES: ${list} builds a PointsMaterial with no map/alphaMap, so every point is an opaque camera-facing quad. Give it a soft sprite (genex image --transparent) or a round gl_PointCoord cutout \u2014 and check the particle belongs there at all: genex-threejs-procedural-vfx decides that per moment.`
+    );
   }
-  if (!res.ok) {
-    log.error(`Couldn't get an upload token (HTTP ${res.status}).`);
-    return null;
+  for (const d of s.depthRange) {
+    log.warn(
+      `Camera depth range ${d.detail} (far/near = ${d.ratio.toExponential(1)}) at ${d.where} is past what a 24-bit depth buffer can serve \u2014 touching surfaces will z-fight and flicker, and it reads fine right up until it doesn't. near is the expensive knob (resolvable depth \u2248 z\xB2 / (near \xD7 2^24)), so raise near to the closest the camera can actually get. If the range is genuinely astronomical, that is what WebGLRenderer's logarithmicDepthBuffer is for: genex-threejs-camera-direction.`
+    );
   }
-  return await res.json();
 }
-async function uploadAll(grant, files, log) {
-  const base = grant.uploadUrl.replace(/\/+$/, "");
-  const threshold = grant.limits.singlePutMaxBytes ?? grant.limits.maxFileBytes;
-  const small = files.filter((f) => f.bytes.length <= threshold);
-  const large = files.filter((f) => f.bytes.length > threshold);
-  let failed = false;
-  let next = 0;
-  const worker = async () => {
-    while (!failed) {
-      const i = next++;
-      if (i >= small.length) return;
-      const f = small[i];
-      const encoded = f.relPath.split("/").map(encodeURIComponent).join("/");
-      let res = null;
-      try {
-        res = await fetch(`${base}/${encoded}`, {
-          method: "PUT",
-          headers: { Authorization: `Bearer ${grant.token}` },
-          body: f.bytes
-        });
-      } catch {
-        res = null;
-      }
-      if (!res || !res.ok) {
-        failed = true;
-        log.warn(`Upload failed for ${f.relPath}${res ? ` (HTTP ${res.status})` : " (network error)"}.`);
-      }
+async function exploreReuseNudge(log, meta, cwd = process.cwd()) {
+  if (!meta.exploreRanAt || meta.reuseNudgedAt) return;
+  if (await borrowEvidence(meta, cwd)) return;
+  log.warn(
+    "This project browsed the curated catalog (genex explore) but no borrowed catalog project is visible in the game. If the plan mapped systems to the catalog \u2014 grass, terrain, water, vehicles \u2014 land those borrows or cancel each in one plain line to the user: a planned borrow that silently becomes hand-rolled code is a scope cut."
+  );
+  meta.reuseNudgedAt = (/* @__PURE__ */ new Date()).toISOString();
+  try {
+    const onDisk = await readProject(cwd);
+    if (onDisk) {
+      onDisk.reuseNudgedAt = meta.reuseNudgedAt;
+      await writeProject(onDisk, cwd);
     }
-  };
-  await Promise.all(Array.from({ length: Math.min(8, small.length) }, () => worker()));
-  if (failed) return false;
-  for (const f of large) {
-    if (!await uploadMultipart(base, grant.token, f, grant.limits.partSizeBytes, log)) return false;
+  } catch {
   }
-  return true;
 }
-async function uploadMultipart(base, uploadToken, f, partSize, log) {
-  const encoded = f.relPath.split("/").map(encodeURIComponent).join("/");
-  const auth = { Authorization: `Bearer ${uploadToken}` };
-  const totalParts = Math.ceil(f.bytes.length / partSize);
-  log.step(`Uploading ${f.relPath} (${(f.bytes.length / 1048576).toFixed(1)} MB in ${totalParts} parts)\u2026`);
-  let uploadId;
+async function borrowEvidence(meta, cwd) {
+  let host;
+  let ownPath;
   try {
-    const res = await fetch(`${base}/${encoded}?action=mpu-create`, { method: "POST", headers: auth });
-    if (!res.ok) {
-      log.warn(`Upload failed for ${f.relPath} (HTTP ${res.status} starting multipart).`);
-      return false;
-    }
-    uploadId = (await res.json()).uploadId;
+    const own = new URL(meta.cloneUrl);
+    host = own.host;
+    ownPath = own.pathname;
   } catch {
-    log.warn(`Upload failed for ${f.relPath} (network error starting multipart).`);
-    return false;
+    return true;
   }
-  const abort = async () => {
+  const gitConfig = await fs14.readFile(path14.join(cwd, ".git", "config"), "utf8").catch(() => "");
+  for (const m of gitConfig.matchAll(/url\s*=\s*(\S+)/g)) {
     try {
-      await fetch(`${base}/${encoded}?action=mpu-abort&uploadId=${encodeURIComponent(uploadId)}`, {
-        method: "DELETE",
-        headers: auth
-      });
+      const u = new URL(m[1]);
+      if (u.host === host && u.pathname !== ownPath) return true;
     } catch {
     }
-  };
-  const parts = [];
-  let failed = false;
-  let next = 0;
-  const partWorker = async () => {
-    while (!failed) {
-      const i = next++;
-      if (i >= totalParts) return;
-      const partNumber = i + 1;
-      const bytes = f.bytes.subarray(i * partSize, Math.min((i + 1) * partSize, f.bytes.length));
-      const part = await uploadPartWithRetry(base, encoded, auth, uploadId, partNumber, bytes);
-      if (!part) {
-        failed = true;
-        log.warn(`Upload failed for ${f.relPath} (part ${partNumber}/${totalParts}).`);
-        return;
-      }
-      parts.push(part);
+  }
+  const readme = await fs14.readFile(path14.join(cwd, "README.md"), "utf8").catch(() => "");
+  return readme.includes(host) || /\b(upstream|originally by|ported from|borrowed from)\b/i.test(readme);
+}
+
+// src/commands/publish.ts
+async function runPublish(opts) {
+  const log = createLogger({ quiet: opts.quiet });
+  log.plain(c.bold("genex publish"));
+  log.plain("");
+  const token = opts.token ?? await readUserToken(opts.envPath);
+  if (!token) {
+    log.error("Not authorized. Run `genex init` first to sign in.");
+    process.exitCode = 1;
+    return;
+  }
+  const meta = await readProject();
+  if (!meta) {
+    log.error("No genex project here. Run `genex init` in this directory first.");
+    process.exitCode = 1;
+    return;
+  }
+  const apiUrl = getApiUrl(opts.apiUrl ?? meta.apiUrl);
+  const detections = await detectFeatures(log);
+  advisoryNudges(log, detections);
+  if (!opts.noPush) {
+    const ok = await deployGame(
+      { projectId: meta.id, apiUrl, token },
+      {
+        noBuild: opts.noBuild,
+        matchmaking: detections.matchmaking,
+        embedSdkVersion: detections.embedSdkVersion,
+        multiplayer: detections.multiplayer,
+        mobileControls: detections.mobileControls
+      },
+      log
+    );
+    if (!ok) {
+      process.exitCode = 1;
+      return;
     }
-  };
-  await Promise.all(Array.from({ length: Math.min(4, totalParts) }, () => partWorker()));
-  if (failed) {
-    await abort();
-    return false;
+    const onDisk = await readProject();
+    const merged = { ...onDisk ?? meta, lastDeployAt: (/* @__PURE__ */ new Date()).toISOString() };
+    await writeProject(merged);
+    meta.lastDeployAt = merged.lastDeployAt;
+  } else {
+    log.info("Skipping build + deploy (--no-push).");
+  }
+  log.step("Listing it in the gallery\u2026");
+  let res;
+  try {
+    const body = {};
+    if (opts.title) body.title = opts.title;
+    if (opts.description) body.description = opts.description;
+    if (opts.regenerateCover) body.regenerateCover = true;
+    if (opts.categories?.length) body.categories = opts.categories;
+    if (opts.sourceRepoUrl) body.sourceRepoUrl = opts.sourceRepoUrl;
+    if (opts.sourceAuthor) body.sourceAuthor = opts.sourceAuthor;
+    if (opts.license) body.license = opts.license;
+    if (opts.purchaseUrl) body.purchaseUrl = opts.purchaseUrl;
+    if (opts.productName) body.productName = opts.productName;
+    if (detections.embedSdkVersion) body.embedSdkVersion = detections.embedSdkVersion;
+    body.multiplayer = detections.multiplayer;
+    body.matchmaking = detections.matchmaking ?? null;
+    body.gameStateUsed = detections.gameStateUsed;
+    body.mobileControls = detections.mobileControls;
+    res = await apiFetch(`${apiUrl}/api/projects/${meta.id}/publish`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+      body: JSON.stringify(body)
+    });
+  } catch {
+    log.error("Couldn't reach Genex \u2014 please try again.");
+    process.exitCode = 1;
+    return;
+  }
+  if (!res.ok) {
+    log.error("Publish failed \u2014 please try again.");
+    process.exitCode = 1;
+    return;
+  }
+  log.plain("");
+  log.success("Published. \u{1F389}");
+  const dashboard = meta.dashboardOrigins?.[0];
+  if (dashboard) log.plain(`  world page (share this link): ${c.cyan(`${dashboard}/world/${meta.slug}`)}`);
+  if (meta.playUrl) log.dim(`  play: ${meta.playUrl}`);
+}
+
+// src/commands/preview.ts
+async function runPreview(opts) {
+  const log = createLogger({ quiet: opts.quiet });
+  log.plain(c.bold("genex preview"));
+  log.plain("");
+  const meta = await readProject();
+  if (!meta) {
+    log.error("No genex project here. Run `genex init` in this directory first.");
+    process.exitCode = 1;
+    return;
+  }
+  const token = await readUserToken(opts.envPath);
+  if (!token) {
+    log.error("Not authorized. Run `genex init` first to sign in.");
+    process.exitCode = 1;
+    return;
+  }
+  const detections = await detectFeatures(log);
+  advisoryNudges(log, detections);
+  await exploreReuseNudge(log, meta);
+  const apiUrl = getApiUrl(meta.apiUrl);
+  const ok = await deployGame(
+    { projectId: meta.id, apiUrl, token },
+    // Detections reach the server on every preview too: matchmaking so a draft's
+    // declared preset doesn't silently run the default (null clears a removed
+    // config), embedSdkVersion/multiplayer so the dashboard's Publish button can
+    // list the draft without wrongly treating it as a pre-embed-auth bundle.
+    {
+      noBuild: opts.noBuild,
+      matchmaking: detections.matchmaking,
+      embedSdkVersion: detections.embedSdkVersion,
+      multiplayer: detections.multiplayer,
+      mobileControls: detections.mobileControls
+    },
+    log
+  );
+  if (!ok) {
+    process.exitCode = 1;
+    return;
+  }
+  const freshStatus = await fetchProjectStatus(apiUrl, token, meta.slug);
+  if (freshStatus && freshStatus !== meta.status) {
+    meta.status = freshStatus;
   }
-  parts.sort((a, b) => a.partNumber - b.partNumber);
-  try {
-    const res = await fetch(`${base}/${encoded}?action=mpu-complete&uploadId=${encodeURIComponent(uploadId)}`, {
-      method: "POST",
-      headers: { ...auth, "Content-Type": "application/json" },
-      body: JSON.stringify({ parts })
-    });
-    if (!res.ok) {
-      log.warn(`Upload failed for ${f.relPath} (HTTP ${res.status} completing multipart).`);
-      await abort();
-      return false;
-    }
-  } catch {
-    log.warn(`Upload failed for ${f.relPath} (network error completing multipart).`);
-    await abort();
-    return false;
+  const onDisk = await readProject();
+  const merged = { ...onDisk ?? meta, status: meta.status, lastDeployAt: (/* @__PURE__ */ new Date()).toISOString() };
+  await writeProject(merged);
+  meta.lastDeployAt = merged.lastDeployAt;
+  const published = meta.status === "published";
+  log.plain("");
+  if (published) {
+    log.success("Update deployed \u2014 this game is PUBLISHED, so the new build is already live for everyone.");
+  } else {
+    log.success("Preview deployed \u2014 unlisted draft (run `genex publish` to list it).");
+  }
+  const dashboard = meta.dashboardOrigins?.[0];
+  if (dashboard) {
+    const page = published ? "world" : "draft";
+    log.plain(`  your game's page (share this link): ${c.cyan(`${dashboard}/${page}/${meta.slug}`)}`);
   }
-  return true;
 }
-async function uploadPartWithRetry(base, encoded, auth, uploadId, partNumber, bytes) {
-  for (let attempt = 0; ; attempt++) {
-    let res = null;
-    try {
-      res = await fetch(
-        `${base}/${encoded}?action=mpu-part&uploadId=${encodeURIComponent(uploadId)}&partNumber=${partNumber}`,
-        { method: "PUT", headers: auth, body: bytes }
-      );
-      if (res.ok) return await res.json();
-    } catch {
-      res = null;
+
+// src/commands/generate.ts
+import fs15 from "fs/promises";
+import path15 from "path";
+import { PNG as PNG4 } from "pngjs";
+
+// src/lib/glass.ts
+import { PNG as PNG3 } from "pngjs";
+var GLASS_PROMPT_SUFFIX = " Rendered on a perfectly flat, uniform, solid pure magenta background, hex #FF00FF, like a studio chroma-key screen: absolutely no shading, no gradient, no vignette, no glow, no shadows on the background. Subject centered, sharp edge silhouette.";
+var GLASS_MIN_FLATNESS = 0.99;
+var GLASS_MIN_KEY_STRENGTH = 180;
+var FLATNESS_DEV_MAX = 12;
+var clamp255 = (v) => v < 0 ? 0 : v > 255 ? 255 : Math.round(v);
+function median(values) {
+  const s = values.slice().sort((a, b) => a - b);
+  return s[Math.floor(s.length / 2)] ?? 0;
+}
+function solveMagentaGlass(source) {
+  const { width: W, height: H, data } = source;
+  const ringW = Math.max(2, Math.round(Math.min(W, H) * 0.04));
+  const rs = [];
+  const gs = [];
+  const bs = [];
+  const ringIdx = [];
+  for (let y = 0; y < H; y++) {
+    for (let x = 0; x < W; x++) {
+      const inRing = x < ringW || y < ringW || x >= W - ringW || y >= H - ringW;
+      if (!inRing) continue;
+      const i = (y * W + x) * 4;
+      ringIdx.push(i);
+      rs.push(data[i]);
+      gs.push(data[i + 1]);
+      bs.push(data[i + 2]);
     }
-    if (res && res.status < 500) return null;
-    if (attempt >= 2) return null;
-    await new Promise((resolve) => setTimeout(resolve, attempt === 0 ? 500 : 2e3));
   }
-}
-async function callPublish(ctx, commit, opts, log) {
-  let res;
-  try {
-    res = await apiFetch(`${ctx.apiUrl}/api/games/${ctx.projectId}/publish`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json", Authorization: `Bearer ${ctx.token}` },
-      // Detections ride every go-live (preview AND publish): matchmaking is
-      // tri-state (object = upsert, null = clear); embedSdkVersion/multiplayer
-      // are sent only when detected (absent = server keeps the stored value).
-      body: JSON.stringify({
-        commit,
-        matchmaking: opts.matchmaking ?? null,
-        ...opts.embedSdkVersion ? { embedSdkVersion: opts.embedSdkVersion } : {},
-        ...opts.multiplayer !== void 0 ? { multiplayer: opts.multiplayer } : {},
-        ...opts.mobileControls !== void 0 ? { mobileControls: opts.mobileControls } : {}
-      })
-    });
-  } catch (err) {
-    log.error(`Couldn't reach the API at ${ctx.apiUrl}: ${String(err)}`);
-    return false;
+  const K = { r: median(rs), g: median(gs), b: median(bs) };
+  const keyHex = `#${[K.r, K.g, K.b].map((v) => v.toString(16).padStart(2, "0")).join("")}`;
+  const keyStrength = Math.min(K.r, K.b) - K.g;
+  let flat = 0;
+  for (const i of ringIdx) {
+    const dev = Math.max(
+      Math.abs(data[i] - K.r),
+      Math.abs(data[i + 1] - K.g),
+      Math.abs(data[i + 2] - K.b)
+    );
+    if (dev < FLATNESS_DEV_MAX) flat++;
   }
-  if (res.status === 429) {
-    log.error(`Rate limited publishing (HTTP 429).${retryAfterHint(res)}`);
-    return false;
+  const flatness = ringIdx.length === 0 ? 0 : flat / ringIdx.length;
+  const base = { keyColor: K, keyHex, keyStrength, flatness };
+  if (flatness < GLASS_MIN_FLATNESS || keyStrength < GLASS_MIN_KEY_STRENGTH) {
+    return {
+      ...base,
+      png: source,
+      ok: false,
+      rejected: `backdrop not keyable (flatness ${flatness.toFixed(3)}, key strength ${keyStrength} \u2014 want \u2265${GLASS_MIN_FLATNESS}/${GLASS_MIN_KEY_STRENGTH}): the model shaded the magenta screen instead of painting it flat. Regenerate (same prompt \u2014 this is a rare roll), or steer harder: keep the --glass suffix intact and avoid magenta/pink art in the subject.`
+    };
   }
-  if (!res.ok) {
-    const detail = await res.text().catch(() => "");
-    log.error(`Publish failed (HTTP ${res.status})${detail ? `: ${detail}` : ""}.`);
-    return false;
+  const out = new PNG3({ width: W, height: H });
+  const mKey = Math.max(1, keyStrength);
+  for (let p = 0; p < W * H; p++) {
+    const i = p * 4;
+    const R = data[i];
+    const G = data[i + 1];
+    const B = data[i + 2];
+    const m = Math.max(0, Math.min(R, B) - G);
+    let a = 1 - m / mKey;
+    if (a < 0) a = 0;
+    if (a > 1) a = 1;
+    if (a <= 0.02) {
+      out.data[i] = 0;
+      out.data[i + 1] = 0;
+      out.data[i + 2] = 0;
+      out.data[i + 3] = 0;
+      continue;
+    }
+    out.data[i] = clamp255((R - (1 - a) * K.r) / a);
+    out.data[i + 1] = clamp255((G - (1 - a) * K.g) / a);
+    out.data[i + 2] = clamp255((B - (1 - a) * K.b) / a);
+    out.data[i + 3] = Math.round(a * 255);
   }
-  return true;
-}
-async function pushSource(cwd, ctx, log) {
-  const target = await fetchPushUrl(ctx, log);
-  if (!target) return false;
-  if (await pushWorktree(cwd, target.pushUrl, target.managed, log)) return true;
-  if (!target.managed) return false;
-  log.info("Retrying the source push\u2026");
-  await new Promise((r) => setTimeout(r, 2e3));
-  const fresh = await fetchPushUrl(ctx, log);
-  if (!fresh) return false;
-  return pushWorktree(cwd, fresh.pushUrl, fresh.managed, log);
+  return { ...base, png: out, ok: true };
 }
-function urlHasEmbeddedCredentials(pushUrl) {
-  return /^[a-z][a-z0-9+.-]*:\/\/[^/@]+@/i.test(pushUrl);
+
+// src/lib/open.ts
+import { spawn as spawn4 } from "child_process";
+function tokenize(cmd) {
+  return cmd.trim().split(/\s+/).filter(Boolean);
 }
-async function pushWorktree(cwd, pushUrl, managed, log) {
-  const EMPTY_TREE = "4b825dc642cb6eb9a060e54bf8d69288fbee4904";
-  const failed = () => {
-    log.error("Couldn't save your game's source \u2014 please try again.");
-    return false;
-  };
-  const gitDir = await fs14.mkdtemp(path14.join(os4.tmpdir(), "genex-source-"));
-  const base = { GIT_DIR: gitDir };
-  if (urlHasEmbeddedCredentials(pushUrl)) {
-    base.GIT_CONFIG_COUNT = "1";
-    base.GIT_CONFIG_KEY_0 = "credential.helper";
-    base.GIT_CONFIG_VALUE_0 = "";
-  }
-  const ident = {
-    GIT_AUTHOR_NAME: "genex",
-    GIT_AUTHOR_EMAIL: "agent@genex.local",
-    GIT_COMMITTER_NAME: "genex",
-    GIT_COMMITTER_EMAIL: "agent@genex.local"
-  };
-  try {
-    if ((await run("git", ["init", "-q"], base)).code !== 0) return failed();
-    await fs14.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: 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");
-      const [bin, args] = process.platform === "darwin" ? ["brew", ["install", "git-lfs"]] : ["sudo", ["-n", "apt-get", "install", "-y", "git-lfs"]];
-      await run(bin, args, base);
-      lfs = (await run("git", ["lfs", "version"], base)).code === 0;
-      if (!lfs) {
-        log.warn(
-          "Couldn't install git-lfs \u2014 large binary assets won't be saved to your source (the game still publishes)."
-        );
-      }
-    }
-    if (lfs) {
-      await writeGitattributes(cwd, log);
-      const filters = [
-        ["filter.lfs.clean", "git-lfs clean -- %f"],
-        ["filter.lfs.smudge", "git-lfs smudge -- %f"],
-        ["filter.lfs.process", "git-lfs filter-process"],
-        ["filter.lfs.required", "true"]
-      ];
-      for (const [key, value] of filters) await run("git", ["config", key, value], base);
-    }
-    await run("git", ["add", "-A"], env);
-    const tree = (await run("git", ["ls-files"], env)).out.trim() ? (await run("git", ["write-tree"], env)).out.trim() : "";
-    if (!tree || tree === EMPTY_TREE) {
-      log.error("Nothing to publish \u2014 the project has no files.");
-      return false;
-    }
-    const commit = (await run("git", ["commit-tree", tree, "-m", "source"], { ...base, ...ident })).out.trim();
-    await run("git", ["update-ref", "refs/heads/main", commit], base);
-    if (lfs && (await run("git", ["lfs", "push", "--all", pushUrl, "main"], base)).code !== 0) {
-      log.error("Couldn't upload your game's binary assets to the source store.");
-      return false;
-    }
-    const push = await run(
-      "git",
-      ["-c", "http.postBuffer=536870912", "push", "-q", pushUrl, "+refs/heads/main:main"],
-      base
-    );
-    if (push.code === 0) return true;
-    if (!managed) {
-      log.error(
-        "Couldn't push to your repo. Check that you have push access (SSH key or git credentials) and that the repo exists."
-      );
-      return false;
+function openUrl(url) {
+  let command;
+  let args;
+  const custom = (process.env.GENEX_BROWSER || process.env.BROWSER)?.trim();
+  const customParts = custom ? tokenize(custom) : [];
+  if (customParts.length > 0) {
+    command = customParts[0];
+    args = [...customParts.slice(1), url];
+  } else {
+    switch (process.platform) {
+      case "darwin":
+        command = "open";
+        args = [url];
+        break;
+      case "win32":
+        command = "cmd";
+        args = ["/c", "start", "", url];
+        break;
+      default:
+        command = "xdg-open";
+        args = [url];
+        break;
     }
-    return failed();
-  } catch {
-    return failed();
-  } finally {
-    await fs14.rm(gitDir, { recursive: true, force: true }).catch(() => {
-    });
   }
-}
-async function fetchPushUrl(ctx, log) {
-  let res;
   try {
-    res = await apiFetch(`${ctx.apiUrl}/api/projects/${ctx.projectId}/push-token`, {
-      method: "POST",
-      headers: { Authorization: `Bearer ${ctx.token}` }
+    const child = spawn4(command, args, { stdio: "ignore", detached: true });
+    child.on("error", () => {
     });
-  } catch (err) {
-    log.error(`Couldn't reach the API to authorize the source push: ${String(err)}`);
-    return null;
-  }
-  if (res.status === 401) {
-    log.error("Not authorized \u2014 your token may have expired. Re-run `genex init`.");
-    return null;
-  }
-  if (res.status === 429) {
-    log.error(`Rate limited authorizing the source push (HTTP 429).${retryAfterHint(res)}`);
-    return null;
-  }
-  if (!res.ok) {
-    log.error(`Couldn't authorize the source push (HTTP ${res.status}).`);
-    return null;
+    child.unref();
+  } catch {
   }
-  const data = await res.json().catch(() => null);
-  if (!data?.pushUrl) {
-    log.error("The API didn't return a push URL.");
-    return null;
+}
+
+// src/lib/sse.ts
+async function* readSSE(body) {
+  const decoder = new TextDecoder();
+  const reader = body.getReader();
+  let buf = "";
+  let event = "";
+  let data = [];
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buf += decoder.decode(value, { stream: true });
+      while (true) {
+        const nl = buf.search(/[\r\n]/);
+        if (nl === -1) break;
+        if (buf[nl] === "\r" && nl === buf.length - 1) break;
+        const sep = buf[nl] === "\r" && buf[nl + 1] === "\n" ? 2 : 1;
+        const line = buf.slice(0, nl);
+        buf = buf.slice(nl + sep);
+        if (line === "") {
+          if (data.length > 0) yield { event: event || "message", data: data.join("\n") };
+          event = "";
+          data = [];
+          continue;
+        }
+        if (line.startsWith(":")) continue;
+        const colon = line.indexOf(":");
+        const field = colon === -1 ? line : line.slice(0, colon);
+        let value2 = colon === -1 ? "" : line.slice(colon + 1);
+        if (value2.startsWith(" ")) value2 = value2.slice(1);
+        if (field === "event") event = value2;
+        else if (field === "data") data.push(value2);
+      }
+    }
+  } finally {
+    reader.releaseLock();
   }
-  return { pushUrl: data.pushUrl, managed: data.managed !== false };
 }
-async function isDir2(p) {
+
+// src/commands/generate.ts
+var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
+var INLINE_IMAGE_LIMIT_BYTES = 4 * 1024 * 1024;
+var IMAGE_MIME_BY_EXT = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".webp": "image/webp"
+};
+var isRemoteRef = (value) => /^(https?:\/\/|data:)/i.test(value);
+async function inlineLocalImage(filePath, flag) {
+  let bytes;
   try {
-    return (await fs14.stat(p)).isDirectory();
+    bytes = await fs15.readFile(filePath);
   } catch {
-    return false;
+    return { ok: false, error: `Couldn't read the ${flag} file at ${filePath}.` };
+  }
+  if (bytes.length > INLINE_IMAGE_LIMIT_BYTES) {
+    return {
+      ok: false,
+      error: `${flag} file is ${(bytes.length / 1048576).toFixed(1)} MB \u2014 over the ~4 MB inline limit. Downscale/compress it first, or pass an asset URL instead.`
+    };
   }
+  const mime = IMAGE_MIME_BY_EXT[path15.extname(filePath).toLowerCase()] ?? "image/png";
+  return { ok: true, dataUri: `data:${mime};base64,${bytes.toString("base64")}` };
 }
-var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
-function fingerprintOf(html) {
-  const m = html.match(/[A-Za-z0-9_]+-[A-Za-z0-9_-]{8}\.(?:js|css)/);
-  return m ? m[0] : null;
+var SKYBOX_ENVIRONMENT_SUFFIX = ". The image contains ONLY sky: cloud, atmosphere, light, weather and distant haze at the horizon. Every structure, object, plant and ground surface is outside the frame.";
+var SKYBOX_PROMPT_MAX = 2e3;
+var SKYBOX_STRUCTURE_NOUNS = [
+  "building",
+  "buildings",
+  "house",
+  "houses",
+  "hut",
+  "huts",
+  "cabin",
+  "cabins",
+  "tower",
+  "towers",
+  "castle",
+  "castles",
+  "cathedral",
+  "cathedrals",
+  "church",
+  "churches",
+  "temple",
+  "temples",
+  "shrine",
+  "shrines",
+  "monastery",
+  "palace",
+  "fortress",
+  "citadel",
+  "ruin",
+  "ruins",
+  "city",
+  "cityscape",
+  "skyline",
+  "town",
+  "village",
+  "settlement",
+  "street",
+  "streets",
+  "road",
+  "roads",
+  "courtyard",
+  "plaza",
+  "bridge",
+  "bridges",
+  "wall",
+  "walls",
+  "gate",
+  "gates",
+  "fence",
+  "fences",
+  "pillar",
+  "pillars",
+  "column",
+  "columns",
+  "statue",
+  "statues",
+  "monument",
+  "obelisk",
+  "spire",
+  "spires",
+  "rooftop",
+  "rooftops",
+  "tree",
+  "trees",
+  "forest",
+  "jungle",
+  "ship",
+  "ships",
+  "boat",
+  "boats",
+  "car",
+  "cars",
+  "vehicle",
+  "vehicles",
+  "person",
+  "people",
+  "figure",
+  "figures",
+  "character",
+  "characters",
+  "creature",
+  "creatures",
+  "dragon",
+  "banner",
+  "banners",
+  "flag",
+  "flags",
+  "torch",
+  "torches",
+  "lamp",
+  "lamps"
+];
+var SKYBOX_NOUN_RE = new RegExp(`\\b(${SKYBOX_STRUCTURE_NOUNS.join("|")})\\b`, "gi");
+function skyboxStructureNouns(prompt) {
+  const found = /* @__PURE__ */ new Set();
+  for (const m of prompt.matchAll(SKYBOX_NOUN_RE)) found.add(m[1].toLowerCase());
+  return [...found];
 }
-async function waitUntilLive(playUrl, fingerprint, timeoutMs, log) {
-  if (!fingerprint) {
-    log.success(`Live. \u{1F310}  ${playUrl}`);
-    return;
+function applySkyboxGuard(prompt, raw) {
+  if (raw) return { prompt, guarded: false, nouns: [] };
+  const nouns = skyboxStructureNouns(prompt);
+  const guarded = `${prompt}${SKYBOX_ENVIRONMENT_SUFFIX}`;
+  if (guarded.length > SKYBOX_PROMPT_MAX) return { prompt, guarded: false, nouns };
+  return { prompt: guarded, guarded: true, nouns };
+}
+function buildGenOptions(kind, opts) {
+  const options = { ...opts.generationOptions };
+  if (kind === "texture" && opts.terrain) options.terrain = true;
+  if ((kind === "sfx" || kind === "music") && opts.duration) options.durationSeconds = opts.duration;
+  if (kind === "voice") {
+    if (opts.voice) options.voice = opts.voice;
+    if (opts.voiceId) options.voiceId = opts.voiceId;
   }
-  const deadline = Date.now() + timeoutMs;
-  let n = 0;
-  while (Date.now() < deadline) {
-    try {
-      const res = await fetch(`${playUrl}?_genexlive=${n++}`, { cache: "no-store" });
-      if (res.ok && (await res.text()).includes(fingerprint)) {
-        log.success(`Live. \u{1F310}  ${playUrl}`);
-        return;
-      }
-    } catch {
+  if (kind === "image") {
+    if (opts.transparent) options.transparent = true;
+    if (opts.aspect) options.aspect = opts.aspect;
+    if (opts.quality) options.quality = opts.quality;
+    if (opts.candidates !== void 0 && opts.candidates > 1) options.candidates = opts.candidates;
+    if (opts.width && opts.height) {
+      options.width = opts.width;
+      options.height = opts.height;
+    }
+    if (opts.editUrl) {
+      options.sourceUrl = opts.editUrl;
+      options.op = "edit";
+    }
+    if (opts.cleanUrl) {
+      options.sourceUrl = opts.cleanUrl;
+      options.op = "remove-bg";
+      options.bgMode = opts.bgMode ?? "sheet";
+    }
+    if (opts.upscaleUrl) {
+      options.sourceUrl = opts.upscaleUrl;
+      options.op = "upscale";
     }
-    await sleep2(1500);
+    if (opts.inpaintUrl) options.maskUrl = opts.inpaintUrl;
+    if (opts.removeBackground) options.removeBackground = true;
+    if (opts.bgMode) options.bgMode = opts.bgMode;
+  }
+  if (kind === "video") {
+    if (opts.duration) options.durationSeconds = opts.duration;
+    if (opts.resolution) options.resolution = opts.resolution;
+    if (opts.loop) options.loop = true;
+    if (opts.frameUrl) options.frameUrl = opts.frameUrl;
+    if (opts.firstFrameUrl) options.firstFrameUrl = opts.firstFrameUrl;
+    if (opts.lastFrameUrl) options.lastFrameUrl = opts.lastFrameUrl;
   }
-  log.success(`Published. \u{1F310}  ${playUrl}`);
-  log.dim("  (If the previous build shows, hard-refresh in a few seconds.)");
+  return options;
 }
-
-// src/commands/make-remixable.ts
-async function runMakeRemixable(opts) {
-  const log = createLogger({ quiet: opts.quiet });
-  log.plain(c.bold("genex make-remixable"));
-  log.plain("");
-  const meta = await readProject();
-  if (!meta) {
-    log.error("No genex project here. Run `genex init` in this directory first.");
+async function runGenerate(kind, opts) {
+  const log = createLogger({ quiet: opts.quiet || opts.json });
+  const typedPrompt = opts.prompt?.trim();
+  if (!typedPrompt) {
+    log.error(`Missing prompt. Usage: ${c.cyan(`genex ${kind} "<prompt>"`)}`);
     process.exitCode = 1;
     return;
   }
-  const token = await readUserToken(opts.envPath);
-  if (!token) {
-    log.error("Not authorized. Run `genex init` first to sign in.");
+  const skyboxGuard = kind === "skybox" ? applySkyboxGuard(typedPrompt, opts.raw) : void 0;
+  if (skyboxGuard && skyboxGuard.nouns.length > 0) {
+    log.error(
+      `A skybox is sky only \u2014 this prompt names ${skyboxGuard.nouns.join(", ")}.`
+    );
+    log.plain(
+      [
+        "  Structures painted into a sky render at infinite distance: they never get closer",
+        "  as the player moves, and they read as broken the moment the camera strafes.",
+        `  ${c.cyan("\u2192")} Build them as scene geometry (${c.cyan("npx genex model")}); describe only light, colour,`,
+        "    cloud, weather and time of day here.",
+        `  ${c.cyan("\u2192")} Genuinely want it painted into the sky (a space-station panorama for a scene`,
+        `    with no world geometry)? Re-run with ${c.cyan("--raw")}.`
+      ].join("\n")
+    );
     process.exitCode = 1;
     return;
   }
-  const apiUrl = getApiUrl(opts.apiUrl ?? meta.apiUrl);
-  log.step("Preparing a public repo for your game\u2026");
-  let res;
-  try {
-    res = await apiFetch(`${apiUrl}/api/projects/${meta.id}/make-remixable`, {
-      method: "POST",
-      headers: { Authorization: `Bearer ${token}` }
-    });
-  } catch (err) {
-    log.error(`Couldn't reach the API at ${apiUrl}: ${String(err)}`);
-    process.exitCode = 1;
-    return;
+  let prompt = skyboxGuard?.prompt ?? typedPrompt;
+  if (kind === "image" && opts.glass) {
+    const conflict = opts.transparent ? "--transparent" : opts.removeBackground ? "--remove-bg" : opts.editUrl ? "--edit" : opts.cleanUrl ? "--clean" : opts.upscaleUrl ? "--upscale" : opts.noWait ? "--no-wait" : void 0;
+    if (conflict) {
+      log.error(
+        conflict === "--no-wait" ? "--glass runs a local key-solve on the finished image \u2014 it has to wait. Drop --no-wait." : `--glass generates a NEW panel on a magenta key screen \u2014 it cannot combine with ${conflict}. The solved RGBA ships real translucency; no removal pass applies.`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    prompt = `${prompt}${GLASS_PROMPT_SUFFIX}`;
   }
-  if (res.status === 401) {
-    log.error("Not authorized \u2014 your token may have expired. Re-run `genex init`.");
-    process.exitCode = 1;
-    return;
+  if (kind === "image" && opts.inpaintUrl && !/^https?:\/\//i.test(opts.inpaintUrl)) {
+    if (!opts.editUrl) {
+      log.error("--inpaint targets an edit \u2014 pass --edit <asset-url> alongside it.");
+      process.exitCode = 1;
+      return;
+    }
+    try {
+      const bytes = await fs15.readFile(opts.inpaintUrl);
+      opts = { ...opts, inpaintUrl: `data:image/png;base64,${bytes.toString("base64")}` };
+    } catch {
+      log.error(`Couldn't read the --inpaint mask at ${opts.inpaintUrl}.`);
+      process.exitCode = 1;
+      return;
+    }
   }
-  if (res.status === 404) {
-    log.error("That game wasn't found on your account. Re-run `genex init` or `genex link <slug>`.");
-    process.exitCode = 1;
-    return;
+  if (kind === "image" && opts.editUrl && !isRemoteRef(opts.editUrl)) {
+    const inlined = await inlineLocalImage(opts.editUrl, "--edit");
+    if (!inlined.ok) {
+      log.error(inlined.error);
+      process.exitCode = 1;
+      return;
+    }
+    opts = { ...opts, editUrl: inlined.dataUri };
   }
-  if (!res.ok) {
-    log.error(`Couldn't make the game public (HTTP ${res.status}).`);
-    process.exitCode = 1;
-    return;
+  if (kind === "video" && opts.frameUrl && !isRemoteRef(opts.frameUrl)) {
+    const inlined = await inlineLocalImage(opts.frameUrl, "--frame");
+    if (!inlined.ok) {
+      log.error(inlined.error);
+      process.exitCode = 1;
+      return;
+    }
+    opts = { ...opts, frameUrl: inlined.dataUri };
   }
-  const data = await res.json().catch(() => null);
-  if (!data?.pushUrl) {
-    log.error("The API didn't return a push URL.");
-    process.exitCode = 1;
-    return;
+  if (kind === "voice" && prompt.length > 1e3) {
+    log.warn(
+      `Voice text is ${prompt.length} chars \u2014 the server clamps at 1000 (billing follows the clamp). Split longer copy into separate lines.`
+    );
   }
-  log.step("Copying your game's source to the public repo\u2026");
-  if (!await pushWorktree(process.cwd(), data.pushUrl, true, log)) {
+  const token = opts.token ?? await readUserToken(opts.envPath);
+  if (!token) {
+    log.error("Not authorized. Run `genex init` first to sign in.");
     process.exitCode = 1;
     return;
   }
-  const newCloneUrl = data.project?.cloneUrl;
-  if (newCloneUrl && newCloneUrl !== meta.cloneUrl) {
-    await writeProject({ ...meta, cloneUrl: newCloneUrl });
-  }
+  const meta = await readProject();
+  const apiUrl = getApiUrl(opts.apiUrl ?? meta?.apiUrl);
+  const options = buildGenOptions(kind, opts);
+  log.plain(c.bold(`genex ${kind}`));
+  log.dim(`  ${prompt}`);
+  if (skyboxGuard?.guarded) log.dim("  \u21B3 environment-only guard applied (--raw to disable)");
   log.plain("");
-  log.success("Your game is public \u2014 anyone can remix it now. \u{1F310}");
-  const dashboard = meta.dashboardOrigins?.[0];
-  if (dashboard) {
-    const page = meta.status === "published" ? "world" : "draft";
-    log.plain(`  your game's page: ${c.cyan(`${dashboard}/${page}/${meta.slug}`)}`);
-  }
-}
-
-// src/lib/detect-features.ts
-import fs15 from "fs/promises";
-import path15 from "path";
-async function detectEmbedSdkVersion(cwd = process.cwd()) {
-  try {
-    const raw = await fs15.readFile(path15.join(cwd, "package.json"), "utf8");
-    const pkg = JSON.parse(raw);
-    const version = pkg.dependencies?.["@genex-ai/embed-sdk"] ?? pkg.devDependencies?.["@genex-ai/embed-sdk"];
-    return typeof version === "string" && version ? version : null;
-  } catch {
-    return null;
-  }
-}
-async function detectMultiplayer(cwd = process.cwd()) {
-  try {
-    const raw = await fs15.readFile(path15.join(cwd, "package.json"), "utf8");
-    const pkg = JSON.parse(raw);
-    return Boolean(
-      pkg.dependencies?.["@genex-ai/multiplayer"] ?? pkg.devDependencies?.["@genex-ai/multiplayer"]
-    );
-  } catch {
-    return false;
-  }
-}
-async function detectMatchmaking(log, cwd = process.cwd()) {
-  let pkg;
-  try {
-    pkg = JSON.parse(await fs15.readFile(path15.join(cwd, "package.json"), "utf8"));
-  } catch (err) {
-    log.dim(`  (skipping matchmaking \u2014 couldn't read package.json: ${String(err)})`);
-    return null;
-  }
-  const mm = pkg.genex?.matchmaking;
-  if (mm && typeof mm.preset === "string" && mm.preset) {
-    return {
-      preset: mm.preset,
-      ...mm.winCondition ? { winCondition: mm.winCondition } : {},
-      ...mm.config ? { config: mm.config } : {}
-    };
-  }
-  return null;
-}
-var TOUCH_KIT_MARKERS = /controllers\/touch\/|controllers\/character\/touch-joystick|TouchJoystick|VirtualButton|DragZone|RotateOverlay/;
-async function detectMobileControls(cwd = process.cwd()) {
-  try {
-    const raw = await fs15.readFile(path15.join(cwd, "package.json"), "utf8");
-    const pkg = JSON.parse(raw);
-    if (pkg.genex?.mobileControls === true) return true;
-  } catch {
-  }
-  const srcDir = path15.join(cwd, "src");
-  let entries;
+  let id;
   try {
-    entries = await fs15.readdir(srcDir, { recursive: true });
-  } catch {
-    return false;
-  }
-  for (const rel of entries) {
-    if (rel.includes("node_modules")) continue;
-    if (!/\.(ts|js|mts|mjs|tsx|jsx)$/.test(rel)) continue;
-    try {
-      const content = await fs15.readFile(path15.join(srcDir, rel), "utf8");
-      if (TOUCH_KIT_MARKERS.test(content)) return true;
-    } catch {
+    const res = await apiFetch(`${apiUrl}/api/generations`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+      body: JSON.stringify({ kind, prompt, options })
+    });
+    if (res.status === 401) {
+      log.error("Unauthorized \u2014 your token may have expired. Re-run `genex init`.");
+      process.exitCode = 1;
+      return;
     }
-  }
-  return false;
-}
-var GAME_STATE_CALLS = /savePlayerState|saveWorldState|submitScore/;
-async function detectGameStateUsage(cwd = process.cwd()) {
-  const srcDir = path15.join(cwd, "src");
-  let entries;
-  try {
-    entries = await fs15.readdir(srcDir, { recursive: true });
-  } catch {
-    return false;
-  }
-  for (const rel of entries) {
-    if (rel.includes("node_modules")) continue;
-    if (!/\.(ts|js|mts|mjs|tsx|jsx)$/.test(rel)) continue;
-    try {
-      const content = await fs15.readFile(path15.join(srcDir, rel), "utf8");
-      if (GAME_STATE_CALLS.test(content)) return true;
-    } catch {
+    if (printedStructuredError(res)) {
+      process.exitCode = 1;
+      return;
     }
-  }
-  return false;
-}
-var UI_PHASE_MARKERS = /data-phase|setPhase/;
-async function detectUiPhases(cwd = process.cwd()) {
-  try {
-    const html = await fs15.readFile(path15.join(cwd, "index.html"), "utf8").catch(() => "");
-    if (UI_PHASE_MARKERS.test(html)) return true;
-    const srcDir = path15.join(cwd, "src");
-    const entries = await fs15.readdir(srcDir, { recursive: true });
-    for (const rel of entries) {
-      if (rel.includes("node_modules")) continue;
-      if (!/\.(ts|js|mts|mjs|tsx|jsx|html|css)$/.test(rel)) continue;
-      const content = await fs15.readFile(path15.join(srcDir, rel), "utf8").catch(() => "");
-      if (UI_PHASE_MARKERS.test(content)) return true;
+    if (!res.ok) {
+      let message;
+      if (res.status >= 400 && res.status < 500) {
+        try {
+          const body = await res.json();
+          if (typeof body.message === "string" && body.message.trim()) message = body.message;
+        } catch {
+        }
+      }
+      log.error(message ?? `Generation request failed (HTTP ${res.status}).`);
+      process.exitCode = 1;
+      return;
     }
-    return false;
-  } catch {
-    return true;
-  }
-}
-function ctorArgs(content, ctor) {
-  const out = [];
-  const re = new RegExp(`new\\s+(?:THREE\\.)?${ctor}\\s*\\(`, "g");
-  let m;
-  while (m = re.exec(content)) {
-    let i = re.lastIndex;
-    let depth = 1;
-    while (i < content.length && depth > 0) {
-      const ch = content[i];
-      if (ch === "(" || ch === "{" || ch === "[") depth++;
-      else if (ch === ")" || ch === "}" || ch === "]") depth--;
-      i++;
+    ({ id } = await res.json());
+  } catch (err) {
+    log.error(`Couldn't reach the API at ${apiUrl}: ${String(err)}`);
+    process.exitCode = 1;
+    return;
+  }
+  await recordQueued(id, kind, prompt);
+  if (opts.noWait) {
+    if (opts.json) {
+      writeJson({
+        kind,
+        id,
+        status: "pending",
+        nextCommand: `genex wait ${id} --json`
+      });
+    } else {
+      log.success(`Queued (${id}).`);
+      log.plain(`  Pick it up any time with: ${c.cyan(`npx genex wait ${id}`)}`);
+      log.dim("  (Re-running the generate command would start \u2014 and bill \u2014 a NEW generation.)");
     }
-    out.push({ text: content.slice(re.lastIndex, i - 1), index: m.index });
+    return id;
   }
-  return out;
-}
-function splitArgs(text) {
-  const out = [];
-  let depth = 0;
-  let start = 0;
-  for (let i = 0; i < text.length; i++) {
-    const ch = text[i];
-    if (ch === "(" || ch === "{" || ch === "[") depth++;
-    else if (ch === ")" || ch === "}" || ch === "]") depth--;
-    else if (ch === "," && depth === 0) {
-      out.push(text.slice(start, i).trim());
-      start = i + 1;
+  if (kind === "image" && opts.glass) {
+    if (!opts.json) log.step("Generating\u2026 (this can take up to a minute)");
+    const view = await waitForTerminalView(
+      apiUrl,
+      token,
+      id,
+      kind,
+      opts.json ? () => {
+      } : (p) => log.dim(`  ${p}%`)
+    );
+    if (!view) {
+      if (opts.json) writeJson({ kind, id, status: "failed", error: "Timed out waiting for the generation." });
+      else log.error("Timed out waiting for the generation.");
+      process.exitCode = 1;
+      return id;
     }
+    await reportGlassTerminal(view, opts.outDir ?? ".", log, opts.json ?? false);
+    return id;
   }
-  out.push(text.slice(start).trim());
-  return out;
+  await awaitAndReport(apiUrl, token, id, kind, log, opts.open, opts.json);
+  return id;
 }
-var lineOf = (content, index) => content.slice(0, index).split("\n").length;
-var DEPTH_RATIO_LIMIT = 1e6;
-async function detectSurfaceScan(cwd = process.cwd()) {
-  const found = { guessedRepeat: [], squarePoints: [], depthRange: [] };
-  const srcDir = path15.join(cwd, "src");
-  let entries;
-  try {
-    entries = await fs15.readdir(srcDir, { recursive: true });
-  } catch {
-    return found;
+async function reportGlassTerminal(view, outDir, log, json) {
+  const files = (view.files ?? []).filter((f) => /^image-(main|alt-\d+)$/.test(f.role));
+  if (view.status !== "completed" || files.length === 0) {
+    await reportTerminal("image", view, log, false, json);
+    return;
   }
-  for (const rel of entries) {
-    if (rel.includes("node_modules")) continue;
-    if (!/\.(ts|js|mts|mjs|tsx|jsx)$/.test(rel)) continue;
-    const raw = await fs15.readFile(path15.join(srcDir, rel), "utf8").catch(() => "");
-    if (!raw) continue;
-    const content = raw.replace(/\/\*[\s\S]*?\*\//g, (m2) => m2.replace(/[^\n]/g, " ")).replace(/(^|[^:])\/\/[^\n]*/gm, (m2, p1) => p1 + " ".repeat(m2.length - p1.length));
-    const repeatRe = /\.repeat\.set\(\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)\s*\)/g;
-    let m;
-    while (m = repeatRe.exec(content)) {
-      const u = Number(m[1]);
-      const v = Number(m[2]);
-      if (u === v) continue;
-      found.guessedRepeat.push({
-        where: `${rel}:${lineOf(content, m.index)}`,
-        detail: `repeat.set(${m[1]}, ${m[2]})`
-      });
-    }
-    for (const call of ctorArgs(content, "PointsMaterial")) {
-      if (/\b(map|alphaMap)\s*:/.test(call.text)) continue;
-      found.squarePoints.push({
-        where: `${rel}:${lineOf(content, call.index)}`,
-        detail: "PointsMaterial with no map/alphaMap"
+  await recordTerminal(view.id, "completed", files.map((f) => f.url));
+  await fs15.mkdir(outDir, { recursive: true });
+  const solved = [];
+  for (let i = 0; i < files.length; i++) {
+    const f = files[i];
+    let png;
+    try {
+      const res = await fetch(f.url);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      png = PNG4.sync.read(Buffer.from(await res.arrayBuffer()));
+    } catch (err) {
+      solved.push({
+        path: null,
+        url: f.url,
+        keyHex: "",
+        keyStrength: 0,
+        flatness: 0,
+        rejected: `couldn't fetch the candidate (${String(err)}) \u2014 re-run later; the URL stays live.`
       });
+      continue;
     }
-    for (const call of ctorArgs(content, "PerspectiveCamera")) {
-      const args = splitArgs(call.text);
-      if (args.length < 4) continue;
-      const near = Number(args[2]);
-      const far = Number(args[3]);
-      if (!isFinite(near) || !isFinite(far) || near <= 0 || far <= near) continue;
-      const ratio = far / near;
-      if (ratio <= DEPTH_RATIO_LIMIT) continue;
-      found.depthRange.push({
-        where: `${rel}:${lineOf(content, call.index)}`,
-        detail: `near ${near} / far ${far}`,
-        ratio
+    const r = solveMagentaGlass(png);
+    if (!r.ok) {
+      solved.push({
+        path: null,
+        url: f.url,
+        keyHex: r.keyHex,
+        keyStrength: r.keyStrength,
+        flatness: r.flatness,
+        rejected: r.rejected
       });
+      continue;
     }
+    const outPath = path15.join(outDir, `glass-${i + 1}.png`);
+    await fs15.writeFile(outPath, PNG4.sync.write(r.png));
+    solved.push({
+      path: outPath,
+      url: f.url,
+      keyHex: r.keyHex,
+      keyStrength: r.keyStrength,
+      flatness: r.flatness
+    });
   }
-  return found;
-}
-var WIRED_BY_URL = /* @__PURE__ */ new Set(["model", "skybox", "sfx", "music", "texture", "video"]);
-var UNPICKED_AFTER_MS = 15 * 60 * 1e3;
-async function detectGenerationAudit(cwd = process.cwd()) {
-  const ledger = await readLedger(cwd);
-  const audited = ledger.filter((e) => WIRED_BY_URL.has(e.kind));
-  if (audited.length === 0) return { unwired: [], unpicked: [], unresolved: [], deadWired: [] };
-  let haystack = "";
-  const read = async (file) => {
-    try {
-      haystack += await fs15.readFile(file, "utf8");
-    } catch {
-    }
-  };
-  try {
-    for (const entry of await fs15.readdir(cwd, { withFileTypes: true })) {
-      if (entry.isFile() && /\.(ts|tsx|js|jsx|css|html|json)$/.test(entry.name)) {
-        await read(path15.join(cwd, entry.name));
-      }
-    }
-  } catch {
+  const shipped = solved.filter((s) => s.path !== null);
+  if (json) {
+    writeJson({ kind: "image", id: view.id, status: view.status, glass: solved });
+    if (shipped.length === 0) process.exitCode = 1;
+    return;
   }
-  for (const sub of ["src", "public"]) {
-    try {
-      const entries = await fs15.readdir(path15.join(cwd, sub), { recursive: true });
-      for (const rel of entries) {
-        if (rel.includes("node_modules")) continue;
-        if (!/\.(ts|tsx|js|jsx|css|html|json|txt)$/.test(rel)) continue;
-        await read(path15.join(cwd, sub, rel));
-      }
-    } catch {
+  log.plain("");
+  if (shipped.length > 0) {
+    log.success(`Solved ${shipped.length} glass panel(s) \u2014 real translucency baked in the alpha:`);
+  }
+  for (const s of solved) {
+    if (s.path) {
+      log.plain(`  ${s.path}  ${c.dim(`key ${s.keyHex}, strength ${s.keyStrength}, flatness ${s.flatness.toFixed(3)}`)}`);
+    } else {
+      log.error(`Candidate rejected: ${s.rejected}`);
+      log.dim(`  raw candidate stays at ${s.url}`);
     }
   }
-  const ref = ({ id, kind, prompt }) => ({
+  if (shipped.length > 0) {
+    log.plain("");
+    log.dim(
+      "  Wire the PNG like any sprite (TextureLoader / <img>): its alpha IS the glass \u2014 no CSS opacity, no plate underneath. See genex-ai-image (--glass) and genex-ai-menu."
+    );
+  } else {
+    process.exitCode = 1;
+  }
+}
+async function awaitAndReport(apiUrl, token, id, kind, log, open = false, json = false) {
+  if (!json) log.step("Generating\u2026 (this can take up to a minute)");
+  const view = await waitForTerminalView(
+    apiUrl,
+    token,
     id,
     kind,
-    prompt
-  });
-  const now = Date.now();
-  const stale = (e) => e.status === "queued" && now - Date.parse(e.queuedAt) > UNPICKED_AFTER_MS;
-  return {
-    unwired: audited.filter((e) => e.status === "completed" && !haystack.includes(e.id)).map(ref),
-    unpicked: audited.filter((e) => stale(e) && !haystack.includes(e.id)).map(ref),
-    // Wired in but never picked up: the deterministic URL let the agent wire
-    // the asset before it finished, so nobody ever learned whether it DID
-    // finish — a provider-side failure (credits, moderation) leaves a dead URL
-    // that renders as a silently missing asset. Kept separate from `unpicked`
-    // because the fix is a status check, not wiring.
-    unresolved: audited.filter((e) => stale(e) && haystack.includes(e.id)).map(ref),
-    // Known-failed AND still wired: the worst case, and it must keep firing
-    // AFTER the status check converges the ledger to "failed" (otherwise the
-    // audit self-erases the moment the agent runs the recommended command and
-    // the dead URL ships silently anyway).
-    deadWired: audited.filter((e) => e.status === "failed" && haystack.includes(e.id)).map(ref)
-  };
+    json ? () => {
+    } : (p) => log.dim(`  ${p}%`)
+  );
+  if (!view) {
+    if (json) writeJson({ kind, id, status: "failed", error: "Timed out waiting for the generation." });
+    else log.error("Timed out waiting for the generation.");
+    process.exitCode = 1;
+    return;
+  }
+  await reportTerminal(kind, view, log, open, json);
 }
-async function detectFeatures(log, cwd = process.cwd()) {
-  return {
-    embedSdkVersion: await detectEmbedSdkVersion(cwd),
-    multiplayer: await detectMultiplayer(cwd),
-    matchmaking: await detectMatchmaking(log, cwd),
-    gameStateUsed: await detectGameStateUsage(cwd),
-    mobileControls: await detectMobileControls(cwd),
-    uiPhases: await detectUiPhases(cwd),
-    surfaces: await detectSurfaceScan(cwd),
-    generations: await detectGenerationAudit(cwd)
-  };
+async function waitForTerminalView(apiUrl, token, id, kind, onProgress = () => {
+}) {
+  const timeoutMs = waitTimeoutFor(kind);
+  const deadline = Date.now() + timeoutMs;
+  const streamed = await waitViaSSE(apiUrl, token, id, onProgress, deadline);
+  return streamed === "unsupported" ? poll(apiUrl, token, id, onProgress, timeoutMs) : streamed;
 }
-function advisoryNudges(log, d) {
-  if (!d.embedSdkVersion) {
-    log.warn(
-      "This game has no player identity or saves \u2014 players lose everything on refresh. The genex-threejs-embed-auth skill wires it with one call (initEmbed) \u2014 load it before publishing."
-    );
-  }
-  if (d.multiplayer && !d.embedSdkVersion) {
-    log.warn(
-      "Multiplayer will NOT work: @genex-ai/multiplayer needs the embed-sdk token (getColyseusAuth) \u2014 the relay rejects tokenless joins. Wire genex-threejs-embed-auth first."
-    );
+async function reportTerminal(kind, view, log, open = false, json = false) {
+  if (view.status !== "completed") {
+    if (json) writeJson({ kind, id: view.id, status: view.status, error: view.error ?? null });
+    else log.error(`Generation ${view.status}${view.error ? `: ${view.error}` : ""}.`);
+    if (view.status === "failed") {
+      await recordTerminal(view.id, "failed");
+      if (kind === "video") {
+        const failures = await countFailed("video");
+        (failures >= 2 ? log.plain : log.dim)(videoFailureAdvice(failures));
+      }
+    }
+    process.exitCode = 1;
+    return;
   }
-  if (d.matchmaking && !d.multiplayer) {
-    log.warn(
-      "package.json declares genex.matchmaking but @genex-ai/multiplayer is not installed \u2014 matchmaking cannot work. Install the SDK and use matchmake() (see genex-threejs-multiplayer)."
-    );
+  const files = view.files ?? [];
+  if (files.length === 0) {
+    if (json) writeJson({ kind, id: view.id, status: "failed", error: "Generation completed but produced no files." });
+    else log.error("Generation completed but produced no files.");
+    process.exitCode = 1;
+    return;
   }
-  if (!d.uiPhases) {
-    log.warn(
-      "No menu/loader screens detected (no data-phase/setPhase) \u2014 players get a bare HUD with no title screen and no styled loading. Run the genex-threejs-game-ui plan (loader, menu, screen tiers); a cinematic menu is two commands away (genex-ai-menu)."
-    );
+  await recordTerminal(view.id, "completed", files.map((f) => f.url));
+  if (kind === "character_concept") {
+    reportCharacterConceptTerminal(view, log, { json, open });
+    return;
   }
-  surfaceNudges(log, d.surfaces);
-  generationNudges(log, d.generations);
-}
-function generationNudges(log, g) {
-  const describe = (refs) => refs.map((r) => `${r.kind} ${r.id} ("${r.prompt.slice(0, 48)}")`).join("; ");
-  if (g.unpicked.length) {
-    log.warn(
-      `${g.unpicked.length} generation(s) enqueued 15+ minutes ago were never picked up: ${describe(g.unpicked)}. Run npx genex wait <id> on each (npx genex wait --all shows every status at once) \u2014 landed assets get wired in before the last push of a session, never parked for "later".`
-    );
+  if (kind === "character_preview") {
+    reportCharacterPreviewTerminal(view, log, { json, open });
+    return;
   }
-  if (g.unresolved.length) {
-    log.warn(
-      `${g.unresolved.length} generation(s) are wired into the game but were never picked up, so their real status is unknown: ${describe(g.unresolved)}. A generation that failed server-side (credits, moderation) leaves a dead URL \u2014 the asset just silently never appears. One call checks them all: npx genex wait --all.`
-    );
+  if (json) {
+    writeJson({
+      kind,
+      id: view.id,
+      status: view.status,
+      files,
+      ...kind === "character" ? {
+        characterId: view.id,
+        nextCommand: `genex controller character --character ${view.id}`
+      } : {}
+    });
+    return;
   }
-  if (g.deadWired.length) {
-    log.warn(
-      `${g.deadWired.length} FAILED generation(s) are still wired into the game: ${describe(g.deadWired)}. Those URLs will never exist \u2014 each asset silently never appears. Replace the wiring or re-generate (that bills a new one), and tell the user what changed.`
-    );
+  log.plain("");
+  log.success("Done \u2014 live on R2 (nothing downloaded or committed):");
+  for (const f of files) {
+    const label = files.length > 1 ? `${c.dim(`${f.role.replace(/^texture-/, "")}: `)}` : "";
+    log.plain(`  ${label}${f.url}`);
   }
-  if (g.unwired.length) {
-    log.warn(
-      `${g.unwired.length} finished generation(s) are wired nowhere in the game: ${describe(g.unwired)}. Each was paid for \u2014 wire it in (its URL embeds the id) or tell the user in one plain line why it stays unused.`
+  log.plain("");
+  if (kind === "texture" && files[0]) await reportTextureSeam(files[0].url, log);
+  if (open && files[0]) {
+    openUrl(files[0].url);
+    log.plain(
+      `  ${c.bold("\u{1F441}  Show this to the user")} \u2014 it just opened in their browser; paste this link in chat too so they can open it themselves:`
     );
+    log.plain(`     ${files[0].url}`);
+    log.plain("");
   }
+  printHint(kind, view, files, log);
 }
-function surfaceNudges(log, s) {
-  if (s.guessedRepeat.length) {
-    const list = s.guessedRepeat.map((d) => `${d.where} \u2014 ${d.detail}`).join("; ");
-    log.warn(
-      `Texture tiling picked by eye, not derived from the mesh: ${list}. A hand-chosen repeat is right for at most ONE face \u2014 a BoxGeometry gives all six faces 0..1 UVs whatever their world size, and repeat lives on the Texture, so every mesh sharing that texture inherits it. Derive the UVs from world size instead: genex-ai-texture ships worldUV(geometry, TILE_M), after which repeat stays (1, 1) and cannot be wrong.`
-    );
-  }
-  if (s.squarePoints.length) {
-    const list = s.squarePoints.map((d) => d.where).join(", ");
-    log.warn(
-      `Particles will render as hard SQUARES: ${list} builds a PointsMaterial with no map/alphaMap, so every point is an opaque camera-facing quad. Give it a soft sprite (genex image --transparent) or a round gl_PointCoord cutout \u2014 and check the particle belongs there at all: genex-threejs-procedural-vfx decides that per moment.`
-    );
-  }
-  for (const d of s.depthRange) {
-    log.warn(
-      `Camera depth range ${d.detail} (far/near = ${d.ratio.toExponential(1)}) at ${d.where} is past what a 24-bit depth buffer can serve \u2014 touching surfaces will z-fight and flicker, and it reads fine right up until it doesn't. near is the expensive knob (resolvable depth \u2248 z\xB2 / (near \xD7 2^24)), so raise near to the closest the camera can actually get. If the range is genuinely astronomical, that is what WebGLRenderer's logarithmicDepthBuffer is for: genex-threejs-camera-direction.`
-    );
+function videoFailureAdvice(failures) {
+  if (failures >= 2) {
+    return `  ${c.bold(`\u270B ${failures} failed videos in this project \u2014 don't queue another attempt of the same clip.`)} One retry per clip is the budget. Use its key-art still as the backdrop instead (the genex-ai-menu skill's built-in fallback; a slow CSS pan gives it life), tell the user in one plain line, and spend the minutes in the game.`;
   }
+  return "  Video renders fail server-side sometimes. One retry is fair \u2014 shorter clip (4\u20136 s), simpler motion. After a second failure, switch to the key-art still (genex-ai-menu's fallback) instead of a third attempt.";
 }
-async function exploreReuseNudge(log, meta, cwd = process.cwd()) {
-  if (!meta.exploreRanAt || meta.reuseNudgedAt) return;
-  if (await borrowEvidence(meta, cwd)) return;
-  log.warn(
-    "This project browsed the curated catalog (genex explore) but no borrowed catalog project is visible in the game. If the plan mapped systems to the catalog \u2014 grass, terrain, water, vehicles \u2014 land those borrows or cancel each in one plain line to the user: a planned borrow that silently becomes hand-rolled code is a scope cut."
-  );
-  meta.reuseNudgedAt = (/* @__PURE__ */ new Date()).toISOString();
-  try {
-    const onDisk = await readProject(cwd);
-    if (onDisk) {
-      onDisk.reuseNudgedAt = meta.reuseNudgedAt;
-      await writeProject(onDisk, cwd);
+var WAIT_TIMEOUT_MS = 10 * 60 * 1e3;
+var KIND_WAIT_TIMEOUT_MS = {
+  video: 15 * 60 * 1e3,
+  // 15 min
+  motion: 20 * 60 * 1e3,
+  // 8 takes ≈ 8-9 GPU min + a serverless cold start
+  character_concept: 15 * 60 * 1e3,
+  character_preview: 30 * 60 * 1e3,
+  character: 30 * 60 * 1e3,
+  character_animation: 20 * 60 * 1e3,
+  // Per clip this lane is fast (locomotion ~2s, video ~51s, described ~130s) —
+  // the BATCH is what takes time. A 20-clip standard set is the sizing case.
+  character_motion: 30 * 60 * 1e3
+};
+var waitTimeoutFor = (kind) => KIND_WAIT_TIMEOUT_MS[kind] ?? WAIT_TIMEOUT_MS;
+var TERMINAL = /* @__PURE__ */ new Set(["completed", "failed"]);
+async function waitViaSSE(apiUrl, token, id, onProgress, deadline) {
+  let connectFailures = 0;
+  let last = -1;
+  while (Date.now() < deadline) {
+    const abort = new AbortController();
+    const timer = setTimeout(() => abort.abort(), deadline - Date.now());
+    try {
+      let res;
+      try {
+        res = await apiFetch(`${apiUrl}/api/generations/${id}/events`, {
+          headers: { Authorization: `Bearer ${token}`, Accept: "text/event-stream" },
+          signal: abort.signal
+        });
+      } catch {
+        if (++connectFailures >= 3) return "unsupported";
+        await sleep2(2e3);
+        continue;
+      }
+      if (res.status === 404 || res.status === 405) return "unsupported";
+      const contentType = res.headers.get("content-type") ?? "";
+      if (!res.ok || !res.body || !contentType.includes("text/event-stream")) {
+        if (++connectFailures >= 3) return "unsupported";
+        await sleep2(2e3);
+        continue;
+      }
+      connectFailures = 0;
+      try {
+        for await (const ev of readSSE(res.body)) {
+          if (ev.event !== "status") continue;
+          let view;
+          try {
+            view = JSON.parse(ev.data);
+          } catch {
+            continue;
+          }
+          if (view.progress !== last) {
+            last = view.progress;
+            onProgress(view.progress);
+          }
+          if (TERMINAL.has(view.status)) return view;
+        }
+      } catch {
+      }
+      await sleep2(1e3);
+    } finally {
+      clearTimeout(timer);
+      abort.abort();
     }
-  } catch {
   }
+  return null;
 }
-async function borrowEvidence(meta, cwd) {
-  let host;
-  let ownPath;
-  try {
-    const own = new URL(meta.cloneUrl);
-    host = own.host;
-    ownPath = own.pathname;
-  } catch {
-    return true;
-  }
-  const gitConfig = await fs15.readFile(path15.join(cwd, ".git", "config"), "utf8").catch(() => "");
-  for (const m of gitConfig.matchAll(/url\s*=\s*(\S+)/g)) {
+async function poll(apiUrl, token, id, onProgress, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  let last = -1;
+  while (Date.now() < deadline) {
     try {
-      const u = new URL(m[1]);
-      if (u.host === host && u.pathname !== ownPath) return true;
+      const res = await apiFetch(`${apiUrl}/api/generations/${id}`, {
+        headers: { Authorization: `Bearer ${token}` }
+      });
+      if (res.ok) {
+        const { generation } = await res.json();
+        if (generation.progress !== last) {
+          last = generation.progress;
+          onProgress(generation.progress);
+        }
+        if (generation.status === "completed" || generation.status === "failed") {
+          return generation;
+        }
+      }
     } catch {
     }
+    await sleep2(3e3);
   }
-  const readme = await fs15.readFile(path15.join(cwd, "README.md"), "utf8").catch(() => "");
-  return readme.includes(host) || /\b(upstream|originally by|ported from|borrowed from)\b/i.test(readme);
+  return null;
 }
-
-// src/commands/publish.ts
-async function runPublish(opts) {
-  const log = createLogger({ quiet: opts.quiet });
-  log.plain(c.bold("genex publish"));
-  log.plain("");
-  const token = opts.token ?? await readUserToken(opts.envPath);
-  if (!token) {
-    log.error("Not authorized. Run `genex init` first to sign in.");
-    process.exitCode = 1;
-    return;
+async function reportTextureSeam(url, log) {
+  try {
+    const res = await fetch(url);
+    if (!res.ok) return;
+    const png = PNG4.sync.read(Buffer.from(await res.arrayBuffer()));
+    if (png.width < 4 || png.height < 4) return;
+    const r = measureSeam(png);
+    if (r.seamless) {
+      log.dim(`  Tiling check: seam ${r.worstRatio}\xD7 this texture's own detail \u2014 tiles cleanly.`);
+      return;
+    }
+    log.error(
+      `Visible ${r.worstAxis} tiling seam \u2014 the tile boundary jumps ${r.worstRatio}\xD7 this texture's own detail (want \u2264 ${r.tolerance}\xD7).`
+    );
+    log.plain("  It will read as a repeating grid on any large surface. Before wiring it in:");
+    log.plain('  \u2022 regenerate with "seamless tiling, no visible edges" in the prompt (--terrain for ground).');
+    log.plain("  Do NOT hide it by tiling less: a hand-picked repeat trades a seam you can name for a");
+    log.plain("  stretched texture you can't. Scale belongs in the UVs (worldUV \u2014 genex-ai-texture).");
+    log.plain(`  Re-check any image any time: ${c.cyan("npx genex ui seams --in <url>")}`);
+  } catch {
+  }
+}
+function printHint(kind, view, files, log) {
+  const url = files[0]?.url ?? "";
+  const hint = {
+    model: `Standard GLB \u2014 load with GLTFLoader straight from the URL \u2014 see the genex-ai-model skill. url = "${url}"`,
+    skybox: `Load as an equirectangular texture \u2192 scene.background + scene.environment \u2014 see genex-ai-skybox. url = "${url}"`,
+    sfx: `Load with AudioLoader into a THREE.PositionalAudio (camera needs an AudioListener) \u2014 see genex-ai-sfx. url = "${url}"`,
+    music: `Load with AudioLoader into a non-positional THREE.Audio: setLoop(true), setVolume(0.30), start on the first user gesture \u2014 and the settings screen MUST have Music + SFX volume sliders \u2014 see genex-ai-music. url = "${url}"`,
+    voice: `Load with AudioLoader into a THREE.Audio (or PositionalAudio at the speaker); voice lines are content \u2014 keep them short, SUBTITLED, and skippable \u2014 see genex-ai-voice. url = "${url}"`,
+    texture: `Load each map with TextureLoader (RepeatWrapping) into a MeshStandardMaterial \u2014 see genex-ai-texture. Use the URLs above by role.`,
+    image: `Load with TextureLoader (set colorSpace = SRGBColorSpace) onto any mesh/plane/sprite \u2014 see genex-ai-image. url = "${url}"`,
+    video: `Wire an HTMLVideoElement (crossOrigin="anonymous", muted, loop, playsInline) into a THREE.VideoTexture \u2014 see genex-ai-video. url = "${url}"`,
+    motion: `Raw ARDY takes + verify report \u2014 download the takes, rename them meaningfully (routing is by filename), then: genex motion verify \u2192 compile \u2192 install. Full procedure: the genex-ai-character skill's motion reference.`,
+    character_concept: "Show all three concept candidates to the user and wait for an explicit selection.",
+    character_preview: "Show all four preview views to the user and wait for explicit approval before finalizing.",
+    character: `Install the controller and current manifest with genex controller character --character ${view.id}.`,
+    character_animation: "The action is now part of the character's current manifest; refresh the local controller manifest before testing.",
+    character_motion: `The clips are part of the character's current manifest \u2014 install them with genex controller character --character ${view.id}, then play the game and watch the motion on the real character before calling it done.`
+  };
+  log.dim(`  ${hint[kind]}`);
+  log.dim("  Reference the URL directly in your code \u2014 don't download it into the repo.");
+}
+var CONCEPT_STOP = "STOP \u2014 show all three concept images to the user and wait for an explicit selection. Do not create the 3D preview until they choose candidate 1, 2, or 3.";
+function metadataOf(view) {
+  return view.metadata && typeof view.metadata === "object" ? view.metadata : {};
+}
+function stringValue(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function finiteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function conceptCandidates(view) {
+  const candidates = [];
+  for (const file of view.files ?? []) {
+    const match = /^(?:concept-candidate|character-concept)-([123])(?:\.[a-z0-9]+)?$/i.exec(file.role);
+    if (!match) continue;
+    candidates.push({ candidate: Number(match[1]), role: file.role, url: file.url });
   }
-  const meta = await readProject();
-  if (!meta) {
-    log.error("No genex project here. Run `genex init` in this directory first.");
+  return candidates.sort((a, b) => a.candidate - b.candidate);
+}
+function conceptContactSheet(view) {
+  return (view.files ?? []).find(
+    (file) => /^(?:concept-gallery|character-concepts-contact-sheet)(?:\.[a-z0-9]+)?$/i.test(file.role)
+  );
+}
+function requestedBuildOf(view) {
+  const metadata = metadataOf(view);
+  const raw = metadata.requestedBuild && typeof metadata.requestedBuild === "object" ? metadata.requestedBuild : {};
+  const actionIds = Array.isArray(raw.actionIds) ? raw.actionIds.filter((id) => typeof id === "number" && Number.isInteger(id)) : [];
+  return {
+    actionIds,
+    controllerPack: raw.controllerPack !== false,
+    ...finiteNumber(raw.heightMeters) === void 0 ? {} : { heightMeters: finiteNumber(raw.heightMeters) }
+  };
+}
+function characterFinalizeCommand(previewId, intent) {
+  const args = [
+    "genex",
+    "character",
+    "finalize",
+    previewId,
+    "--user-approved",
+    "--approve-remesh",
+    "10000"
+  ];
+  if (intent.heightMeters !== void 0) args.push("--height", String(intent.heightMeters));
+  for (const actionId of intent.actionIds) args.push("--animation", String(actionId));
+  return args.join(" ");
+}
+function reportCharacterConceptTerminal(view, log, opts = {}) {
+  const candidates = conceptCandidates(view);
+  if (candidates.length !== 3 || candidates.some((entry, index) => entry.candidate !== index + 1)) {
+    const error = "Character concept generation completed without exactly candidates 1, 2, and 3.";
+    if (opts.json) writeJson({ kind: "character_concept", id: view.id, status: "failed", error });
+    else log.error(error);
     process.exitCode = 1;
     return;
   }
-  const apiUrl = getApiUrl(opts.apiUrl ?? meta.apiUrl);
-  const detections = await detectFeatures(log);
-  advisoryNudges(log, detections);
-  if (!opts.noPush) {
-    const ok = await deployGame(
-      { projectId: meta.id, apiUrl, token },
-      {
-        noBuild: opts.noBuild,
-        matchmaking: detections.matchmaking,
-        embedSdkVersion: detections.embedSdkVersion,
-        multiplayer: detections.multiplayer,
-        mobileControls: detections.mobileControls
-      },
-      log
-    );
-    if (!ok) {
-      process.exitCode = 1;
-      return;
-    }
-    const onDisk = await readProject();
-    const merged = { ...onDisk ?? meta, lastDeployAt: (/* @__PURE__ */ new Date()).toISOString() };
-    await writeProject(merged);
-    meta.lastDeployAt = merged.lastDeployAt;
-  } else {
-    log.info("Skipping build + deploy (--no-push).");
-  }
-  log.step("Listing it in the gallery\u2026");
-  let res;
-  try {
-    const body = {};
-    if (opts.title) body.title = opts.title;
-    if (opts.description) body.description = opts.description;
-    if (opts.regenerateCover) body.regenerateCover = true;
-    if (opts.categories?.length) body.categories = opts.categories;
-    if (opts.sourceRepoUrl) body.sourceRepoUrl = opts.sourceRepoUrl;
-    if (opts.sourceAuthor) body.sourceAuthor = opts.sourceAuthor;
-    if (opts.license) body.license = opts.license;
-    if (opts.purchaseUrl) body.purchaseUrl = opts.purchaseUrl;
-    if (opts.productName) body.productName = opts.productName;
-    if (detections.embedSdkVersion) body.embedSdkVersion = detections.embedSdkVersion;
-    body.multiplayer = detections.multiplayer;
-    body.matchmaking = detections.matchmaking ?? null;
-    body.gameStateUsed = detections.gameStateUsed;
-    body.mobileControls = detections.mobileControls;
-    res = await apiFetch(`${apiUrl}/api/projects/${meta.id}/publish`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
-      body: JSON.stringify(body)
+  const metadata = metadataOf(view);
+  const contactSheet = conceptContactSheet(view);
+  const nextCommand = `genex character preview ${view.id} --candidate <n> --user-approved`;
+  if (opts.open) openUrl(contactSheet?.url ?? candidates[0].url);
+  if (opts.json) {
+    writeJson({
+      kind: "character_concept",
+      stage: "concept",
+      id: view.id,
+      status: view.status,
+      provider: stringValue(metadata.provider),
+      model: stringValue(metadata.aiModel) ?? stringValue(metadata.providerModel),
+      candidates,
+      ...contactSheet ? { contactSheetUrl: contactSheet.url } : {},
+      ...opts.quote ? { quote: opts.quote } : {},
+      requiresUserApproval: true,
+      nextCommand
     });
-  } catch {
-    log.error("Couldn't reach Genex \u2014 please try again.");
-    process.exitCode = 1;
-    return;
-  }
-  if (!res.ok) {
-    log.error("Publish failed \u2014 please try again.");
-    process.exitCode = 1;
     return;
   }
+  log.success("Three character concept candidates are ready:");
+  for (const candidate of candidates) log.plain(`  ${candidate.candidate}. ${candidate.url}`);
+  if (contactSheet) log.plain(`  Contact sheet: ${contactSheet.url}`);
   log.plain("");
-  log.success("Published. \u{1F389}");
-  const dashboard = meta.dashboardOrigins?.[0];
-  if (dashboard) log.plain(`  world page (share this link): ${c.cyan(`${dashboard}/world/${meta.slug}`)}`);
-  if (meta.playUrl) log.dim(`  play: ${meta.playUrl}`);
-}
-
-// src/commands/preview.ts
-async function runPreview(opts) {
-  const log = createLogger({ quiet: opts.quiet });
-  log.plain(c.bold("genex preview"));
+  log.plain(`  ${c.bold("\u{1F441}  Show these to the user")} \u2014 include all three numbered links, not only your favorite.`);
+  log.plain(`  ${c.bold(CONCEPT_STOP)}`);
+  log.plain(`  After approval: ${c.cyan(nextCommand)}`);
   log.plain("");
-  const meta = await readProject();
-  if (!meta) {
-    log.error("No genex project here. Run `genex init` in this directory first.");
-    process.exitCode = 1;
-    return;
+}
+var PREVIEW_DIRECTIONS = ["front", "back", "left", "right"];
+function previewViews(view) {
+  const metadata = metadataOf(view);
+  const rawViews = metadata.views && typeof metadata.views === "object" ? metadata.views : {};
+  const result = {};
+  for (const direction of PREVIEW_DIRECTIONS) {
+    const fromMetadata = stringValue(rawViews[direction]);
+    const fromFile = (view.files ?? []).find((file) => {
+      const role = file.role.toLowerCase();
+      return file.contentType.startsWith("image/") && role.includes(direction);
+    })?.url;
+    result[direction] = fromMetadata ?? fromFile;
   }
-  const token = await readUserToken(opts.envPath);
-  if (!token) {
-    log.error("Not authorized. Run `genex init` first to sign in.");
+  return result;
+}
+function previewSource(view) {
+  return (view.files ?? []).find(
+    (file) => file.contentType === "model/gltf-binary" || /(?:source-highpoly|character-preview)(?:\.glb)?$/i.test(file.role)
+  )?.url;
+}
+function reportCharacterPreviewTerminal(view, log, opts = {}) {
+  const metadata = metadataOf(view);
+  const views = previewViews(view);
+  const sourceFaceCount = finiteNumber(metadata.sourceFaceCount);
+  const missingViews = PREVIEW_DIRECTIONS.filter((direction) => !views[direction]);
+  if (sourceFaceCount === void 0 || missingViews.length > 0) {
+    const detail = [
+      sourceFaceCount === void 0 ? "source face count" : "",
+      missingViews.length > 0 ? `${missingViews.join(", ")} view${missingViews.length === 1 ? "" : "s"}` : ""
+    ].filter(Boolean).join(" and ");
+    const error = `Character preview completed without ${detail}.`;
+    if (opts.json) writeJson({ kind: "character_preview", id: view.id, status: "failed", error });
+    else log.error(error);
     process.exitCode = 1;
     return;
   }
-  const detections = await detectFeatures(log);
-  advisoryNudges(log, detections);
-  await exploreReuseNudge(log, meta);
-  const apiUrl = getApiUrl(meta.apiUrl);
-  const ok = await deployGame(
-    { projectId: meta.id, apiUrl, token },
-    // Detections reach the server on every preview too: matchmaking so a draft's
-    // declared preset doesn't silently run the default (null clears a removed
-    // config), embedSdkVersion/multiplayer so the dashboard's Publish button can
-    // list the draft without wrongly treating it as a pre-embed-auth bundle.
-    {
-      noBuild: opts.noBuild,
-      matchmaking: detections.matchmaking,
-      embedSdkVersion: detections.embedSdkVersion,
-      multiplayer: detections.multiplayer,
-      mobileControls: detections.mobileControls
-    },
-    log
-  );
-  if (!ok) {
-    process.exitCode = 1;
+  const intent = requestedBuildOf(view);
+  const nextCommand = characterFinalizeCommand(view.id, intent);
+  const sourceUrl = previewSource(view);
+  const stop = `STOP \u2014 show the front, back, left, and right views to the user. The high-detail source has ${sourceFaceCount} faces and remains preserved in R2. Ask them to approve a separate 10,000-face triangle rigging copy.`;
+  if (opts.open) openUrl(views.front);
+  if (opts.json) {
+    writeJson({
+      kind: "character_preview",
+      stage: "preview",
+      id: view.id,
+      status: view.status,
+      provider: stringValue(metadata.provider),
+      model: stringValue(metadata.aiModel) ?? stringValue(metadata.providerModel),
+      poseMode: stringValue(metadata.poseMode),
+      shouldRemesh: metadata.shouldRemesh === true,
+      sourceFaceCount,
+      views,
+      ...sourceUrl ? { sourceUrl } : {},
+      requestedBuild: intent,
+      ...opts.quote ? { quote: opts.quote } : {},
+      requiresUserApproval: true,
+      nextCommand
+    });
     return;
   }
-  const freshStatus = await fetchProjectStatus(apiUrl, token, meta.slug);
-  if (freshStatus && freshStatus !== meta.status) {
-    meta.status = freshStatus;
-  }
-  const onDisk = await readProject();
-  const merged = { ...onDisk ?? meta, status: meta.status, lastDeployAt: (/* @__PURE__ */ new Date()).toISOString() };
-  await writeProject(merged);
-  meta.lastDeployAt = merged.lastDeployAt;
-  const published = meta.status === "published";
+  log.success("The high-detail Meshy character preview is ready:");
+  for (const direction of PREVIEW_DIRECTIONS) log.plain(`  ${direction}: ${views[direction]}`);
+  if (sourceUrl) log.plain(`  High-detail source: ${sourceUrl}`);
+  log.plain("");
+  log.plain(`  ${c.bold("\u{1F441}  Show these to the user")} \u2014 include all four views.`);
+  log.plain(`  ${c.bold(stop)}`);
+  log.plain(`  After approval: ${c.cyan(nextCommand)}`);
   log.plain("");
-  if (published) {
-    log.success("Update deployed \u2014 this game is PUBLISHED, so the new build is already live for everyone.");
-  } else {
-    log.success("Preview deployed \u2014 unlisted draft (run `genex publish` to list it).");
-  }
-  const dashboard = meta.dashboardOrigins?.[0];
-  if (dashboard) {
-    const page = published ? "world" : "draft";
-    log.plain(`  your game's page (share this link): ${c.cyan(`${dashboard}/${page}/${meta.slug}`)}`);
-  }
+}
+function writeJson(value) {
+  process.stdout.write(`${JSON.stringify(value)}
+`);
 }
 
 // src/commands/wait.ts
@@ -6129,15 +6087,6 @@ async function runWaitAll(opts) {
   if (count("running") + count("queued") > 0) {
     log.dim(`  Attach to any single one with: ${c.cyan("npx genex wait <id>")}`);
   }
-  const stage1Stalled = rows.some(
-    (r, i) => r.kind === "image" && r.status === "done" && r.prompt.startsWith(STAGE1_PROMPT_MARKER) && !rows.some(
-      (s, j) => j > i && s.kind === "image" && s.prompt.startsWith(STAGE2_PROMPT_MARKER)
-    )
-  );
-  if (stage1Stalled) {
-    log.plain("");
-    log.plain(`  ${c.bold(STAGE1_LANDING_NUDGE)}`);
-  }
   log.plain("");
   log.dim(
     "  \u{1F4DC} Resumed or compacted? Re-read AGENTS.md + DESIGN.md (continue from its Now: line) before building on."
@@ -19190,7 +19139,8 @@ async function main() {
     log.plain(HELP);
     return;
   }
-  const updateLog = createLogger({ quiet: parsed.options.quiet || parsed.options.json });
+  const quietUpdates = Boolean(parsed.options.quiet || parsed.options.json);
+  const updateLog = createLogger({ quiet: quietUpdates });
   if (parsed.command !== "init") await syncSkills(updateLog);
   const updateCheck = startUpdateCheck();
   Sentry2.setTag("command", parsed.command);
@@ -19311,7 +19261,7 @@ async function main() {
         process.exitCode = 1;
     }
   } finally {
-    await reportUpdateNudges(updateCheck, updateLog);
+    if (!quietUpdates) await reportUpdateNudges(updateCheck, updateLog);
     await flushSentry();
   }
 }