@genex-ai/cli-demo 1.4.1-dev.381 → 1.4.2

package/README.md

@@ -11,7 +11,6 @@ genex preview              # build + push to the hosted draft URL (unlisted)
 genex publish              # build + push, then list the game in the gallery
 genex make-remixable          # make this game remixable — migrate a private source to a public repo
 genex model "<prompt>"     # generate a 3D model  → prints an asset URL
-genex skybox "<prompt>"    # generate a 360° sky  → prints an asset URL
 genex sfx "<prompt>"       # generate a sound fx  → prints an asset URL
 genex texture "<prompt>"   # generate a texture   → prints an asset URL
 genex image "<prompt>"     # generate an image    → prints an asset URL
@@ -88,7 +87,7 @@ baked at build time via `GENEX_CLI_CHANNEL` (see `src/config.ts`).
 
 ## Generating assets
 
-`genex model | skybox | sfx | texture | image | video "<prompt>"` turn a prompt into a
+`genex model | sfx | texture | image | video "<prompt>"` turn a prompt into a
 real, game-ready asset stored in R2. The command blocks until the asset is ready (live SSE
 stream), then prints its public URL — the game loads it directly, nothing is
 downloaded or committed:
@@ -96,7 +95,6 @@ downloaded or committed:
 | Command | Provider | Prints (role) |
 | --- | --- | --- |
 | `genex model "<prompt>"` | Tripo | `…/generations/<id>/model-glb` |
-| `genex skybox "<prompt>"` | Blockade Labs | `…/generations/<id>/skybox-equirect` |
 | `genex sfx "<prompt>" [--duration <s>]` | ElevenLabs | `…/generations/<id>/audio-sfx` |
 | `genex texture "<prompt>" [--terrain]` | Gemini | `…/generations/<id>/texture-basecolor` |
 | `genex image "<prompt>" [--transparent] [--aspect <ratio>]` | fal.ai | `…/generations/<id>/image-main` |

package/dist/index.js

@@ -8,7 +8,7 @@ import fs from "fs";
 import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
-var RAW_CHANNEL = "dev";
+var RAW_CHANNEL = "latest";
 var CLI_CHANNEL = RAW_CHANNEL === "dev" ? "dev" : "latest";
 var STANDS = {
   prod: { api: "https://api.genex.games", dashboard: "https://genex.games" },
@@ -991,7 +991,7 @@ var CONTRACT_END = "<!-- genex:contract:end -->";
 var GENEX_CONTRACT_BLOCK = `${CONTRACT_BEGIN}
 # Genex build contract (always in effect for this game)
 
-Your agentic capabilities that can boost your creation (all via \`npx genex \u2026\`): generate \`model\` \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|chat\` \xB7 \`animations search\` \xB7 \`wait <id>\` / \`wait --all\` \xB7 \`preview\` / \`publish\` \xB7 \`rename <name>\` (move the game to a new address \u2014 keeps its plays and likes, kills the old link, needs \`--yes\` once published, and the game must be rebuilt after). Full options: \`npx genex --help\`. Task\u2192lane routing lives in the \`genex-game-director\` skill's routing map \u2014 re-load it whenever you're unsure which lane owns a task.
+Your agentic capabilities that can boost your creation (all via \`npx genex \u2026\`): generate \`model\` \xB7 \`sfx\` \xB7 \`music\` \xB7 \`voice\` \xB7 \`texture\` \xB7 \`image\` (\`--edit\` \xB7 \`--inpaint\` \xB7 \`--glass\` \xB7 \`--clean\` \xB7 \`--upscale\`) \xB7 \`video\` \xB7 rigged \`character\` / \`creature\` \xB7 \`character animate <id> "<verb>"\` (also \`creature animate\`; \`--locomotion\` for the 8-way movement set, \`--video\` for your own footage) \xB7 the pixel toolbox \`ui extract|masks|plate|text-color|trim|audit\` \xB7 vendored \`controller character|car|drone|touch|quality|chat\` \xB7 \`animations search\` \xB7 \`wait <id>\` / \`wait --all\` \xB7 \`preview\` / \`publish\` \xB7 \`rename <name>\` (move the game to a new address \u2014 keeps its plays and likes, kills the old link, needs \`--yes\` once published, and the game must be rebuilt after). Full options: \`npx genex --help\`. There is NO sky generator: every sky, horizon, time of day and weather mood is built in code \u2014 your call how, from a background colour and fog to an atmospheric sky shader with a real sun. It costs nothing, weighs nothing on phones, and keeps the sun in sync with the scene's own lighting, which a painted panorama never can. Task\u2192lane routing lives in the \`genex-game-director\` skill's routing map \u2014 re-load it whenever you're unsure which lane owns a task.
 
 Important note: put soul into your creations, with many details and love. Aim to make them realistic and feel real. Use genex capabilities as an extension, but never limit your imagination \u2014 you are a powerful agent. Use your built-in sub-agents and iteration loops (\`/loop\` or your platform's equivalent) where you need them to reach outstanding results. Verify yourself. Anything you put in front of the player should already feel alive and impressive \u2014 never a bare scene waiting for "later". Build what's still missing before polishing what already works.
 
@@ -1118,6 +1118,11 @@ var REMOVED_SKILLS = [
   "genex-explore",
   "genex-threejs-procedural-materials",
   // folded into genex-threejs-procedural-assets (AG-881)
+  // 2026-08-12: the generated-panorama lane is paused at the provider, and
+  // every sky is built in code now. Leaving this SKILL.md
+  // installed would keep pointing agents at `npx genex skybox`, which the CLI
+  // refuses.
+  "genex-ai-skybox",
   "genex-threejs-skill-router",
   "genex-threejs-bloom",
   "genex-threejs-screen-space-ambient-occlusion",
@@ -4890,157 +4895,6 @@ async function runMakeRemixable(opts) {
   }
 }
 
-// src/commands/domain.ts
-var SUBCOMMANDS = ["add", "list", "verify", "remove"];
-function statusWord(d) {
-  if (d.status === "active") return c.green("live");
-  if (d.status === "failed") return c.red("stopped");
-  return c.dim("waiting for DNS");
-}
-async function runDomain(opts) {
-  const log = createLogger({ quiet: opts.quiet });
-  const sub = (opts.name ?? "list").trim();
-  if (!SUBCOMMANDS.includes(sub)) {
-    log.error(`Unknown subcommand \`${sub}\`. Use: ${SUBCOMMANDS.join(", ")}.`);
-    process.exitCode = 1;
-    return;
-  }
-  const needsHost = sub !== "list";
-  const hostname = opts.hostname?.trim();
-  if (needsHost && !hostname) {
-    log.error(`\`genex domain ${sub}\` needs a hostname, e.g. ${c.cyan(`genex domain ${sub} play.yourdomain.com`)}.`);
-    process.exitCode = 1;
-    return;
-  }
-  const meta = await readProject();
-  if (!meta?.id) {
-    log.error("This folder isn't linked to a game.");
-    log.dim(`  Run ${c.cyan("genex link")} (or ${c.cyan("genex list")} to find the slug) first.`);
-    process.exitCode = 1;
-    return;
-  }
-  const apiUrl = getApiUrl(opts.apiUrl ?? meta.apiUrl);
-  let token = opts.token ?? await readUserToken(opts.envPath);
-  if (!token) {
-    if (opts.noAuth) {
-      log.error("Not signed in. Re-run without --no-auth to connect.");
-      process.exitCode = 1;
-      return;
-    }
-    log.plain("Not signed in \u2014 connecting\u2026");
-    try {
-      token = await authorize(apiUrl, getAuthUrl(opts.authUrl), {
-        log,
-        inlineWaitMs: opts.timeoutSec ? opts.timeoutSec * 1e3 : void 0
-      });
-    } catch (err) {
-      if (err instanceof AuthPendingError) {
-        printAuthHandoff(log, err);
-        log.dim(`Then re-run ${c.cyan(`genex domain ${sub}`)}.`);
-        return;
-      }
-      log.error(`Sign-in didn't complete: ${err instanceof Error ? err.message : String(err)}`);
-      process.exitCode = 1;
-      return;
-    }
-    await writeUserToken(token, opts.envPath);
-  }
-  const base = `${apiUrl}/api/projects/${encodeURIComponent(meta.id)}/domains`;
-  const auth = { Authorization: `Bearer ${token}` };
-  const call = (url, init2) => apiFetch(url, { ...init2, headers: { ...auth, "Content-Type": "application/json", ...init2?.headers ?? {} } });
-  let res;
-  try {
-    if (sub === "list") res = await call(base);
-    else if (sub === "add") res = await call(base, { method: "POST", body: JSON.stringify({ hostname }) });
-    else if (sub === "verify")
-      res = await call(`${base}/${encodeURIComponent(hostname)}/verify`, { method: "POST" });
-    else res = await call(`${base}/${encodeURIComponent(hostname)}`, { method: "DELETE" });
-  } catch (err) {
-    log.error(`Couldn't reach the API at ${apiUrl}.`);
-    log.dim(`  ${String(err)}`);
-    process.exitCode = 1;
-    return;
-  }
-  if (!res.ok) {
-    if (await printedStructuredError(res)) {
-      process.exitCode = 1;
-      return;
-    }
-    const body = await res.json().catch(() => null);
-    if (res.status === 503) {
-      log.error("Custom domains aren't available on this Genex environment yet.");
-    } else if (res.status === 404) {
-      log.error(sub === "list" || sub === "add" ? "That game wasn't found on this account." : `${hostname} isn't connected to this game.`);
-    } else {
-      log.error(body?.message ?? body?.error ?? `Request failed (${res.status}).`);
-    }
-    process.exitCode = 1;
-    return;
-  }
-  const data = await res.json();
-  if (opts.json) {
-    log.plain(JSON.stringify(data, null, 2));
-    return;
-  }
-  if (sub === "list") {
-    const rows = data.domains ?? [];
-    if (rows.length === 0) {
-      log.plain("No domains connected to this game.");
-      log.dim(`  ${c.cyan("genex domain add play.yourdomain.com")} to connect one.`);
-      return;
-    }
-    for (const d of rows) log.plain(`  ${d.hostname.padEnd(34)} ${statusWord(d)}`);
-    return;
-  }
-  if (sub === "add") {
-    if (data.supported === false) {
-      log.plain(String(data.message ?? "That domain's DNS host doesn't support one-click setup."));
-      const manual = data.manual;
-      const records = Array.isArray(manual?.records) ? manual.records : [];
-      if (records.length > 0) {
-        log.plain("");
-        log.plain("  Add these two records at your DNS host:");
-        log.plain("");
-        for (const r of records) {
-          log.plain(`    ${c.cyan(String(r.type ?? ""))}  ${String(r.name ?? "")}`);
-          log.plain(`          ${String(r.value ?? "")}`);
-        }
-        log.plain("");
-        if (manual?.apexHint) {
-          log.dim("  At a root domain your host may call the first one ALIAS or ANAME.");
-        }
-        log.dim(`  Then run: genex domain verify ${String(data.hostname ?? "")}`);
-        log.dim("  DNS can take a few minutes to spread.");
-        return;
-      }
-      log.dim("  Your game stays reachable at its usual address.");
-      return;
-    }
-    const applyUrl = String(data.applyUrl ?? "");
-    const providerName = String(data.providerName ?? "your DNS host");
-    log.success(`${data.hostname} can be connected through ${providerName}.`);
-    log.plain("");
-    log.plain(`  Approve the DNS change here: ${c.cyan(applyUrl)}`);
-    log.plain("");
-    log.dim("  One click writes the records. Nothing to copy or paste.");
-    if (!applyUrl.startsWith("https://")) {
-      log.warn("That DNS host returned a setup link we could not verify \u2014 not opening it.");
-    } else if (!opts.noOpen) {
-      openBrowser(applyUrl, () => log.dim("  (Couldn't open a browser \u2014 use the link above.)"));
-    }
-    log.dim(`  Then ${c.cyan(`genex domain verify ${String(data.hostname)}`)} once you have approved it.`);
-    return;
-  }
-  if (sub === "verify") {
-    const status = String(data.status ?? "");
-    if (status === "active") log.success(`${hostname} is live.`);
-    else if (status === "failed") log.error(`${hostname} is stopped \u2014 its verification record is missing.`);
-    else log.plain(`${hostname} isn't verified yet \u2014 DNS changes can take a few minutes to spread.`);
-    return;
-  }
-  log.success(`${hostname} disconnected.`);
-}
-
 // src/lib/promote.ts
 async function promoteBuild(apiUrl, projectId, token, log) {
   let res;
@@ -6529,7 +6383,10 @@ 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}"`,
+    // Unreachable while the lane is paused (see src/index.ts) — kept so a
+    // restore is one deletion. Games that already ship a panorama still load
+    // it this way.
+    skybox: `Load as an equirectangular texture \u2192 scene.background + scene.environment. url = "${url}"`,
     sfx: `Load with AudioLoader into a THREE.PositionalAudio (camera needs an AudioListener) \u2014 see genex-ai-sfx. url = "${url}"`,
     music: `Load with AudioLoader into a non-positional THREE.Audio: setLoop(true), setVolume(0.30), start on the first user gesture \u2014 and the settings screen MUST have Music + SFX volume sliders \u2014 see genex-ai-music. url = "${url}"`,
     voice: `Load with AudioLoader into a THREE.Audio (or PositionalAudio at the speaker); voice lines are content \u2014 keep them short, SUBTITLED, and skippable \u2014 see genex-ai-voice. url = "${url}"`,
@@ -16766,6 +16623,8 @@ async function exists3(p) {
 }
 
 // src/commands/character.ts
+import fs21 from "fs/promises";
+import path20 from "path";
 function exactAnimation(selector) {
   const trimmed = selector.trim();
   if (/^-?\d+$/.test(trimmed)) return animationById(Number(trimmed));
@@ -16845,6 +16704,86 @@ function showAmbiguity(selector, candidates, log, json = false) {
   }
   process.exitCode = 1;
 }
+var INSTALLED_MANIFEST = path20.join("public", "assets", "meshy-character.json");
+async function resolveAdoptTarget(selector) {
+  const trimmed = selector?.trim();
+  if (trimmed && !trimmed.endsWith(".json")) {
+    return { ok: true, characterId: trimmed, from: "the id you gave" };
+  }
+  const file = trimmed ?? INSTALLED_MANIFEST;
+  let raw;
+  try {
+    raw = await fs21.readFile(file, "utf8");
+  } catch {
+    return {
+      ok: false,
+      message: trimmed ? `Could not read ${file}.` : `No character id given, and this game has no installed character manifest at ${INSTALLED_MANIFEST}. Pass the id from the game you remixed: genex character adopt <character-id>.`
+    };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return { ok: false, message: `${file} is not valid JSON.` };
+  }
+  const characterId = parsed?.characterId;
+  if (typeof characterId !== "string" || characterId.length === 0) {
+    return { ok: false, message: `${file} carries no characterId.` };
+  }
+  return { ok: true, characterId, from: file };
+}
+async function runCharacterAdopt(opts) {
+  const log = createLogger({ quiet: opts.quiet || opts.json });
+  const target = await resolveAdoptTarget(opts.characterId);
+  if (!target.ok) {
+    fail2(opts, target.message, "character");
+    return;
+  }
+  const ctx = await context(opts);
+  if (!ctx) {
+    fail2(opts, "Not authorized. Run `genex init` first to sign in.", "character");
+    return;
+  }
+  const project = await readProject();
+  if (!project?.id) {
+    fail2(
+      opts,
+      "No linked game here. Run this from the game folder that remixed the original (`genex link` if it is not linked yet).",
+      "character"
+    );
+    return;
+  }
+  if (!opts.json) {
+    log.plain(c.bold("Adopting character"));
+    log.plain(`  ${target.characterId} \xB7 from ${target.from}`);
+    log.dim("  Copies the body and its clips into your account. No credits \u2014 it generates nothing.");
+    log.plain("");
+  }
+  await runWorkflow({
+    opts,
+    ctx,
+    kind: "character",
+    prompt: `Adopt character ${target.characterId}`,
+    createPath: `/api/characters/${encodeURIComponent(target.characterId)}/adopt`,
+    body: { projectId: project.id },
+    quote: { credits: 0 },
+    completed: (view) => {
+      if (opts.json) {
+        writeJson({
+          kind: "character",
+          status: view.status,
+          characterId: view.id,
+          adoptedFrom: target.characterId,
+          nextCommand: `genex controller character --character ${view.id}`
+        });
+        return;
+      }
+      log.success(`Adopted. This character is yours now: ${c.cyan(view.id)}`);
+      log.plain(`  Point the game at it: ${c.cyan(`genex controller character --character ${view.id}`)}`);
+      log.plain(`  Then animate it: ${c.cyan(`genex character animate ${view.id} "<what it should do>"`)}`);
+    }
+  });
+}
 async function runCharacter(opts) {
   if (opts.directText) {
     await runDirectTextCharacter(opts);
@@ -17252,22 +17191,22 @@ async function context2(opts) {
   const project = await readProject();
   return { token, apiUrl: getApiUrl(opts.apiUrl ?? project?.apiUrl) };
 }
-async function readVideo(path21, log) {
+async function readVideo(path22, log) {
   let bytes;
   try {
-    bytes = await readFile(path21);
+    bytes = await readFile(path22);
   } catch {
-    log.error(`Can't read ${path21}.`);
+    log.error(`Can't read ${path22}.`);
     return null;
   }
   if (bytes.byteLength > MAX_VIDEO_BYTES) {
-    log.error(`${basename(path21)} is ${(bytes.byteLength / 1e6).toFixed(0)} MB \u2014 the limit is ${MAX_VIDEO_BYTES / 1e6} MB.`);
+    log.error(`${basename(path22)} is ${(bytes.byteLength / 1e6).toFixed(0)} MB \u2014 the limit is ${MAX_VIDEO_BYTES / 1e6} MB.`);
     return null;
   }
   return bytes;
 }
-async function uploadVideo(apiUrl, token, characterId, path21, bytes, log) {
-  const contentType = /\.mov$/i.test(path21) ? "video/quicktime" : "video/mp4";
+async function uploadVideo(apiUrl, token, characterId, path22, bytes, log) {
+  const contentType = /\.mov$/i.test(path22) ? "video/quicktime" : "video/mp4";
   const minted = await apiFetch(
     `${apiUrl}/api/characters/${encodeURIComponent(characterId)}/motions/video-url`,
     {
@@ -17282,7 +17221,7 @@ async function uploadVideo(apiUrl, token, characterId, path21, bytes, log) {
     return null;
   }
   const { uploadUrl, videoUrl } = await minted.json();
-  log.dim(`  uploading ${basename(path21)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
+  log.dim(`  uploading ${basename(path22)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
   const put = await fetch(uploadUrl, {
     method: "PUT",
     headers: { "Content-Type": contentType, "Content-Length": String(bytes.byteLength) },
@@ -17598,8 +17537,8 @@ function rank(items, query) {
 }
 
 // src/commands/motion.ts
-import fs21 from "fs/promises";
-import path20 from "path";
+import fs22 from "fs/promises";
+import path21 from "path";
 
 // src/lib/motion/npz.ts
 import zlib from "zlib";
@@ -18850,7 +18789,7 @@ async function motionGen(opts, log) {
   }
   if (opts.constraintsPath !== void 0) {
     try {
-      const raw = await fs21.readFile(opts.constraintsPath, "utf8");
+      const raw = await fs22.readFile(opts.constraintsPath, "utf8");
       generationOptions.constraints = JSON.parse(raw);
     } catch {
       log.error(`Couldn't read the --constraints JSON at ${opts.constraintsPath}.`);
@@ -18874,10 +18813,10 @@ async function motionGen(opts, log) {
 async function expandTakes(selectors) {
   const out = [];
   for (const sel of selectors) {
-    const st = await fs21.stat(sel).catch(() => null);
+    const st = await fs22.stat(sel).catch(() => null);
     if (st?.isDirectory()) {
-      const names = await fs21.readdir(sel);
-      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path20.join(sel, n));
+      const names = await fs22.readdir(sel);
+      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path21.join(sel, n));
     } else if (st?.isFile()) {
       out.push(sel);
     } else {
@@ -18912,7 +18851,7 @@ async function motionVerify(opts, log) {
   let gates = DEFAULT_GATES;
   if (opts.gatesPath) {
     try {
-      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs21.readFile(opts.gatesPath, "utf8")));
+      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs22.readFile(opts.gatesPath, "utf8")));
     } catch {
       log.error(`Couldn't read the --gates JSON at ${opts.gatesPath}.`);
       process.exitCode = 1;
@@ -18934,9 +18873,9 @@ async function motionVerify(opts, log) {
   }
   const reports = [];
   for (const file of files) {
-    const stem = path20.basename(file).replace(/\.npz$/, "");
+    const stem = path21.basename(file).replace(/\.npz$/, "");
     try {
-      reports.push(analyzeTake(stem, await fs21.readFile(file), gates));
+      reports.push(analyzeTake(stem, await fs22.readFile(file), gates));
     } catch (err) {
       reports.push({
         take: stem,
@@ -18974,7 +18913,7 @@ async function motionCompile(opts, log) {
   let cfg = DEFAULT_MOTION_CONFIG;
   if (opts.configPath) {
     try {
-      const patch = JSON.parse(await fs21.readFile(opts.configPath, "utf8"));
+      const patch = JSON.parse(await fs22.readFile(opts.configPath, "utf8"));
       cfg = { ...DEFAULT_MOTION_CONFIG, ...patch, idleLoop: { ...DEFAULT_MOTION_CONFIG.idleLoop, ...patch.idleLoop } };
     } catch {
       log.error(`Couldn't read the --config JSON at ${opts.configPath}.`);
@@ -18992,16 +18931,16 @@ async function motionCompile(opts, log) {
   }
   const inputs = [];
   for (const file of files) {
-    const stem = path20.basename(file).replace(/\.npz$/, "");
+    const stem = path21.basename(file).replace(/\.npz$/, "");
     try {
-      inputs.push({ stem, take: loadTake(await fs21.readFile(file)) });
+      inputs.push({ stem, take: loadTake(await fs22.readFile(file)) });
     } catch (err) {
       log.error(`${stem}: ${err instanceof Error ? err.message : String(err)}`);
       process.exitCode = 1;
       return;
     }
   }
-  const setName = opts.set ?? path20.basename(opts.out).replace(/\.json$/, "");
+  const setName = opts.set ?? path21.basename(opts.out).replace(/\.json$/, "");
   let result;
   try {
     result = compileSet(inputs, setName, cfg);
@@ -19016,9 +18955,9 @@ async function motionCompile(opts, log) {
     process.exitCode = 1;
     return;
   }
-  await fs21.mkdir(path20.dirname(path20.resolve(opts.out)), { recursive: true });
+  await fs22.mkdir(path21.dirname(path21.resolve(opts.out)), { recursive: true });
   const json = JSON.stringify(result.data);
-  await fs21.writeFile(opts.out, json);
+  await fs22.writeFile(opts.out, json);
   if (opts.json) {
     writeJson({ out: opts.out, set: setName, tracks: Object.keys(result.data.gaits), bytes: json.length });
     return;
@@ -19036,9 +18975,9 @@ var MOTION_RUNTIME_FILES = [
 var MOTION_PRESETS = {
   rifle: ["sets/rifle.json", "sets/jumps.json"]
 };
-var MOTION_DEST = path20.join("src", "motion");
+var MOTION_DEST = path21.join("src", "motion");
 async function motionInstall(opts, log) {
-  const srcDir = path20.join(getTemplatesDir(), "motion");
+  const srcDir = path21.join(getTemplatesDir(), "motion");
   const root = opts.cwd ?? process.cwd();
   const preset = opts.set;
   if (preset !== void 0 && !MOTION_PRESETS[preset]) {
@@ -19049,21 +18988,21 @@ async function motionInstall(opts, log) {
   const files = [...MOTION_RUNTIME_FILES, ...preset ? MOTION_PRESETS[preset] : []];
   log.plain(c.bold(`genex motion install${preset ? ` --set ${preset}` : ""}`));
   log.plain("");
-  log.step(`Vendoring the motion runtime into ${c.cyan(MOTION_DEST + path20.sep)}`);
+  log.step(`Vendoring the motion runtime into ${c.cyan(MOTION_DEST + path21.sep)}`);
   let copied = 0, skipped = 0;
   try {
     for (const rel of files) {
-      const dest = path20.join(root, MOTION_DEST, rel);
-      const exists4 = await fs21.access(dest).then(() => true, () => false);
+      const dest = path21.join(root, MOTION_DEST, rel);
+      const exists4 = await fs22.access(dest).then(() => true, () => false);
       if (!opts.force && exists4) {
         skipped++;
-        log.dim(`  skipped ${path20.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
+        log.dim(`  skipped ${path21.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs21.mkdir(path20.dirname(dest), { recursive: true });
-      await fs21.copyFile(path20.join(srcDir, rel), dest);
+      await fs22.mkdir(path21.dirname(dest), { recursive: true });
+      await fs22.copyFile(path21.join(srcDir, rel), dest);
       copied++;
-      log.dim(`  ${path20.join(MOTION_DEST, rel)}`);
+      log.dim(`  ${path21.join(MOTION_DEST, rel)}`);
     }
   } catch (err) {
     log.error(`Copy failed: ${String(err)}`);
@@ -19104,7 +19043,7 @@ async function motionConstraints(opts, log) {
   }
   const doc = directionConstraint(dir, speed, duration);
   const out = opts.out ?? "constraints.json";
-  await fs21.writeFile(out, JSON.stringify(doc));
+  await fs22.writeFile(out, JSON.stringify(doc));
   if (opts.json) {
     writeJson({ out, dir: dirName, speed, duration, waypoints: doc[0].frame_indices.length });
     return;
@@ -19169,12 +19108,7 @@ ${c.bold("Usage")}
   genex publish [options]            Build + push + make live, then list it in the gallery.
   genex make-remixable [options]     Make THIS game remixable by everyone \u2014 migrates a
                                      private source onto a public managed genex repo.
-  genex domain <sub> [host]          Play this game on a domain you own:
-                                     add | list | verify | remove. "add" opens a
-                                     one-click approval at your DNS host \u2014 no
-                                     records to copy or paste.
   genex model "<prompt>" [options]   Generate a 3D model (GLB); prints a public asset URL.
-  genex skybox "<prompt>" [options]  Generate a skybox (equirect); prints a public asset URL.
   genex sfx "<prompt>" [options]     Generate a sound effect (mp3); prints a public asset URL.
   genex music "<prompt>" [options]   Generate an instrumental music track (mp3); prints a
                                      public asset URL. --duration 10-300s (default 90).
@@ -19188,7 +19122,7 @@ ${c.bold("Usage")}
   genex video "<prompt>" [options]   Generate a video (mp4); prints a public asset URL.
   genex character "<brief>"          Generate 3 character concepts for user selection.
   genex character preview <concept-id>
-                                     Generate an unremeshed Meshy 6 preview of one
+                                     Generate an unremeshed Meshy 7 preview of one
                                      explicitly user-approved concept candidate.
   genex character finalize <preview-id>
                                      Finalize an approved preview as a 10,000-face
@@ -19204,6 +19138,10 @@ ${c.bold("Usage")}
                                      multi-beat moves; --action <id-or-query> still
                                      picks a catalog clip.
   genex character motions <id>       List the clips installed on that character.
+  genex character adopt [<id>]       Claim a character from a game you remixed, so it
+                                     can take new animations. With no id it adopts the
+                                     body this game already wears. Free \u2014 it copies,
+                                     it does not generate.
   genex creature "<desc>"            One-shot rigged enemy/creature (biped-shaped
                                      bodies only \u2014 Meshy rig limit): model \u2192 rig \u2192
                                      bind library clips via --animation. No approval
@@ -19245,12 +19183,8 @@ ${c.bold("Usage")}
                                      Pure local work (no API); the PNG tools read
                                      a file or URL, audit scans the project.
 
-${c.bold("Options for the generators (`model` `skybox` `sfx` `music` `voice` `texture` `image` `video`)")}
+${c.bold("Options for the generators (`model` `sfx` `music` `voice` `texture` `image` `video`)")}
   --terrain            (texture) seamless tiling surface for terrain/ground.
-  --raw                (skybox) send the prompt exactly as written \u2014 skip the
-                       appended environment-only clause AND the refusal on
-                       prompts that name structures/objects (a sky is sky only;
-                       landforms and weather always pass).
   --duration <sec>     (sfx, video, music) target clip length in seconds;
                        (character/creature animate) 3-6 s of reference video for
                        verbs that route to AI video (default 3) \u2014 longer gives a
@@ -19414,11 +19348,8 @@ ${c.bold("Examples")}
   genex publish
   genex publish --categories games,vfx
   genex make-remixable
-  genex domain add play.mygame.com
-  genex domain list
   genex publish --no-push --title "My Game"
   genex model "weathered wooden barrel with iron bands"
-  genex skybox "golden hour over a misty mountain range"
   genex sfx "punchy laser zap" --duration 2
   genex music "brooding orchestral battle loop, seamless loop, no intro or outro" --no-wait
   genex voice "You shall not pass!" --voice gruff
@@ -19539,9 +19470,6 @@ function parseArgs(argv) {
       case "--no-auth":
         parsed.options.noAuth = true;
         break;
-      case "--no-open":
-        parsed.options.noOpen = true;
-        break;
       case "--no-push":
         parsed.options.noPush = true;
         break;
@@ -19649,7 +19577,7 @@ function parseArgs(argv) {
         } else if (parsed.command === "controller") {
           (parsed.options.selectors ??= []).push(arg);
         } else if (parsed.command === "character") {
-          if ((parsed.options.name === "animate" || parsed.options.name === "motions") && !parsed.options.characterId) {
+          if ((parsed.options.name === "animate" || parsed.options.name === "motions" || parsed.options.name === "adopt") && !parsed.options.characterId) {
             parsed.options.characterId = arg;
           } else if (parsed.options.name === "animate") {
             (parsed.options.verbs ??= []).push(arg);
@@ -19657,7 +19585,7 @@ function parseArgs(argv) {
             parsed.options.conceptId = arg;
           } else if (parsed.options.name === "finalize" && !parsed.options.previewId) {
             parsed.options.previewId = arg;
-          } else if (!["animate", "motions", "preview", "finalize"].includes(parsed.options.name ?? "")) {
+          } else if (!["animate", "motions", "preview", "finalize", "adopt"].includes(parsed.options.name ?? "")) {
             parsed.options.name = `${parsed.options.name} ${arg}`;
           } else {
             parsed.error = `Unexpected argument: ${arg}`;
@@ -19676,12 +19604,6 @@ function parseArgs(argv) {
           } else {
             (parsed.options.selectors ??= []).push(arg);
           }
-        } else if (parsed.command === "domain") {
-          if (!parsed.options.hostname) parsed.options.hostname = arg;
-          else {
-            parsed.error = `Unexpected argument: ${arg}`;
-            return parsed;
-          }
         } else if (parsed.command === "animations") {
           parsed.options.query = parsed.options.query ? `${parsed.options.query} ${arg}` : arg;
         } else {
@@ -19991,6 +19913,21 @@ async function main() {
     ci: !!process.env.CI
   });
   try {
+    if (parsed.command === "skybox") {
+      log.error("The generated-sky lane is paused \u2014 `genex skybox` is not available.");
+      log.plain(
+        [
+          `  ${c.cyan("\u2192")} Build the sky in code instead \u2014 your call how: a background colour with`,
+          `    fog, a gradient dome, or three.js's own ${c.cyan("Sky")} shader with a real sun. It costs`,
+          "    no credits, no download and no phone memory, and the sun stays in sync with",
+          "    your lighting.",
+          `  ${c.cyan("\u2192")} A distant skyline or landmark was never a sky: build it as geometry, or`,
+          `    generate it with ${c.cyan("npx genex model")}.`
+        ].join("\n")
+      );
+      process.exitCode = 1;
+      return;
+    }
     if (GEN_KINDS.has(parsed.command)) {
       await runGenerate(parsed.command, {
         ...parsed.options,
@@ -20017,9 +19954,6 @@ async function main() {
       case "make-remixable":
         await runMakeRemixable(parsed.options);
         break;
-      case "domain":
-        await runDomain(parsed.options);
-        break;
       case "controller":
         await runController({ ...parsed.options, kind: parsed.options.name });
         break;
@@ -20036,6 +19970,8 @@ async function main() {
           await runCharacterPreview(parsed.options);
         } else if (parsed.options.name === "finalize") {
           await runCharacterFinalize(parsed.options);
+        } else if (parsed.options.name === "adopt") {
+          await runCharacterAdopt(parsed.options);
         } else {
           await runCharacter({ ...parsed.options, prompt: parsed.options.name });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.4.1-dev.381",
+  "version": "1.4.2",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/controllers/character/meshy/meshy-loader.ts

@@ -32,7 +32,10 @@ export interface MeshyCharacterManifest {
   };
   provenance?: {
     provider: "meshy";
-    aiModel: "meshy-6";
+    /** Open on purpose. This type is vendored into a player's game and frozen
+     *  there at install time, so a future model would make an older copy of
+     *  this file describe its own manifest as invalid. */
+    aiModel: string;
     apiVersion?: string;
     meshyApiVersion?: string;
     poseMode: "a-pose" | "t-pose";

package/templates/skills/genex-ai-texture/SKILL.md

@@ -225,7 +225,7 @@ first one is the one a screenshot of the whole arena will not show you.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this texture generation. Tell the user the facts the CLI printed: their balance,
   this generation's cost, and when their credits refill. Then offer to continue the

package/templates/skills/genex-ai-video/SKILL.md

@@ -151,7 +151,7 @@ set belongs to `$genex-ai-hud` — both build on `npx genex image`/`video`.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the prompt.
   This is non-retryable; retrying the same wording fails again. Rewrite the prompt.
 - **Nothing plays / black surface** — the first `video.play()` must run inside a user

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

@@ -112,8 +112,8 @@ Genex asset and runtime lanes are:
 
 - `npx genex model "<prompt>"`—a static GLB → `$genex-ai-model`
 - `npx genex texture "<prompt>"`—a generated surface → `$genex-ai-texture`
-- `npx genex skybox "<prompt>"`—a 360° environment-only sky →
-  `$genex-ai-skybox`
+- sky, horizon, time of day, weather mood—built in code, never generated; no
+  command and no skill owns it, so pick what this game needs
 - `npx genex sfx "<prompt>"` / `music` / `voice` →
   `$genex-ai-sfx`, `$genex-ai-music`, `$genex-ai-voice`
 - `npx genex image "<prompt>"` / `video`—2D and motion art →
@@ -146,9 +146,10 @@ Assets row.
 The request sets the floor for the asset plan, never the ceiling: a world
 should feel dressed and alive, so plan the detail its genre implies — and pick
 the more efficient engine per object. Paid generation buys hero pieces (the
-player's character, key props, the skybox, music); procedural code is the
+player's character, key props, music); procedural code is the
 unlimited detail engine for structures, buildings, modular kits, and repeated
-or varied dressing (`$genex-threejs-procedural-assets` owns that lane). Mixing
+or varied dressing (`$genex-threejs-procedural-assets` owns that lane) — and
+for the sky, which is never generated at all. Mixing
 both in one scene is the normal way to build, never a fallback. In focused
 work, stay inside the touched scope. Run independent planned generations with
 `--no-wait`, scaffold while they land, and preserve their IDs, URLs, and

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

@@ -54,7 +54,7 @@ copy demo architecture.
 | fixed-view screenshots, input direction, facing, temporal and budget evidence | `$genex-threejs-visual-validation` |
 | a static generated GLB for a concrete prop, vehicle, building, or non-rigged object | `$genex-ai-model` |
 | generated surface or terrain texture with real-world UV scale | `$genex-ai-texture` |
-| environment-only 360° sky | `$genex-ai-skybox` |
+| sky, skybox, horizon, time of day, weather mood, night or space backdrop | build it in code in the scene—there is no sky command and no owning skill, so pick the technique this game needs |
 | poster, sign, sprite, decal, reference sheet, or other 2D art | `$genex-ai-image` |
 | in-world motion art or another requested video | `$genex-ai-video` |
 | sound effect, one looping music bed, or a short spoken line | `$genex-ai-sfx`, `$genex-ai-music`, or `$genex-ai-voice` |

package/templates/skills/genex-getting-started/SKILL.md

@@ -40,7 +40,6 @@ the asset lives in Genex storage (R2), not your repo, so there's nothing to comm
 
 ```bash
 npx genex model "weathered wooden barrel"      # a 3D mesh (GLB)
-npx genex skybox "golden hour over mountains"  # a 360° sky + lighting
 npx genex sfx "punchy laser zap" --duration 2  # a sound effect (mp3)
 npx genex texture "mossy cobblestone" --terrain # a tiling surface texture
 npx genex image "vintage travel poster"        # a picture (poster/sign/sprite/decal)
@@ -51,8 +50,11 @@ npx genex video "waterfall mist drifting" --loop      # a video clip (screen/bac
 `npx genex` resolve to the right CLI.)
 
 Each has a focused skill with the exact loader code — `$genex-ai-model`,
-`$genex-ai-skybox`, `$genex-ai-sfx`, `$genex-ai-texture`, `$genex-ai-image`,
-`$genex-ai-video`. Two more workflow skills draw UI art on the same commands,
+`$genex-ai-sfx`, `$genex-ai-texture`, `$genex-ai-image`,
+`$genex-ai-video`. The sky is not on that list: there is no sky command, so
+every sky, horizon, and time of day is built in code — your call how, from a
+background colour and fog to an atmospheric sky shader with a real sun. Two
+more workflow skills draw UI art on the same commands,
 for games whose style wants it: `$genex-ai-menu` (a cinematic menu — looping
 video backdrop + DOM buttons) and `$genex-ai-hud` (a HUD sprite set with
 masked fills). A restrained interface in clean CSS is a finished UI too —
@@ -159,7 +161,7 @@ and re-link the clone to the same live game:
 ```bash
 git clone <the game's repo url> my-game && cd my-game
 npm install
-npx @genex-ai/cli-demo@dev link <slug>   # slug = the name in the play URL
+npx @genex-ai/cli-demo@latest link <slug>   # slug = the name in the play URL
 ```
 
 Don't know the slug? **`npx genex list`** prints every game on your account —
@@ -186,7 +188,7 @@ Safe to run any time — genex-owned skills are refreshed to the latest version,
 and your own files are never touched:
 
 ```bash
-npx @genex-ai/cli-demo@dev init
+npx @genex-ai/cli-demo@latest init
 ```
 
 Use `--force` only if you intentionally want your own existing files overwritten

package/templates/skills/genex-threejs-adaptive-quality/SKILL.md

@@ -7,7 +7,7 @@ description: Make a Genex Three.js game phone-survivable with the vendored adapt
 
 Phones enforce a hard GPU-memory ceiling desktops don't have: iOS silently
 kills the page when a game allocates too much, and the kill arrives at BOOT —
-exactly when a skybox, models, and the post stack all decode at once. This
+exactly when textures, models, and the post stack all decode at once. This
 skill wires the vendored quality kit so the game boots conservatively on
 phones, steps quality UP when the device proves smooth, and never gets uglier
 on desktop. **You can recover from ugly; you cannot recover from a killed
@@ -115,22 +115,27 @@ reads; pause your own loop and audio on `visibilitychange` too.
 
 ## Generated assets: load through the rungs
 
-Generated skyboxes are 8192×4096 — about 178 MB decoded, over half a phone's
-whole budget in one texture. Every generated image asset ships with downscale
-rungs; phones must load through them:
+A generated texture original can be several thousand pixels square — a handful
+of them decode into more memory than a phone has. Every generated image asset
+ships with downscale rungs; phones must load through them:
 
 ```ts
 import { detectTier } from "./controllers/quality/tier.ts";
 import { loadTextureWithFallback } from "./controllers/quality/pick-asset.ts";
 
-const texture = await loadTextureWithFallback(SKYBOX_URL, tier, (u) =>
+const texture = await loadTextureWithFallback(TEXTURE_URL, tier, (u) =>
   new THREE.TextureLoader().loadAsync(u),
 );
 ```
 
-Desktop loads the original, phones the `@2048` rung (~11 MB), and a missing
-rung falls back to the original — never a broken boot. The `$genex-ai-skybox`
-and `$genex-ai-texture` skills show the wiring in place.
+Desktop loads the original, phones the small rung, and a missing rung falls
+back to the original — never a broken boot. The `$genex-ai-texture` skill
+shows the wiring in place.
+
+The sky costs nothing here: it is built in code, so there
+is no panorama to download, no rung ladder, and no boot-time decode. Games
+carrying a generated equirect sky predate that and still load through the
+`skybox-equirect` rungs the kit resolves for them.
 
 ## Generated models: load through the rungs
 
@@ -170,7 +175,7 @@ source, fetched only as the fallback of last resort. Meshy characters take
 the same ladder through
 `loadMeshyCharacter(manifestUrl, { loader: gltfLoader.loader, modelUrlCandidates: (u) => [pickModel(u, tier, { ktx2: gltfLoader.ktx2 }), pickModel(u, tier), u] })`.
 KTX2-capable games can also pass `ktx2Load` to `loadTextureWithFallback` so
-skyboxes/textures use their `.ktx2` variants.
+textures use their `.ktx2` variants.
 
 ## Quality picker in settings
 
@@ -219,9 +224,10 @@ runtime).
   (antialias) are locked wrong for the session. Tier first, renderer second.
 - Governor wired to context-creation flags → no-op at best. Runtime knobs
   only: DPR, post toggles, distances, frame cap.
-- Skybox loaded with a bare `TextureLoader.loadAsync(SKYBOX_URL)` on a game
-  that targets phones → ~178 MB decoded; route it through
-  `loadTextureWithFallback`.
+- A generated texture loaded with a bare `TextureLoader.loadAsync(url)` on a
+  game that targets phones → the full-size original decoded; route it through
+  `loadTextureWithFallback`. (Same for the equirect sky of a game that predates
+  the procedural sky lane — the `skybox-equirect` rungs still resolve.)
 - Quality stepping on every spike → shader compiles read as slowness. The
   governor requires SUSTAINED slow windows; do not shorten them.
 - Testing quality tiers by resizing the desktop window → tiers key off touch +

package/templates/skills/genex-threejs-adaptive-quality/references/adaptive-quality.md

@@ -7,7 +7,7 @@ when, or teaching the governor a game-specific step.
 
 The phone budget is a hard ceiling that includes GPU memory (textures,
 framebuffers), and the OS kill arrives with no catchable event. Boot is the
-danger window: skybox + models + post targets decode together. So phone tiers
+danger window: big textures + models + post targets decode together. So phone tiers
 START one notch below what the heuristics suggest and the governor steps UP
 after ~20 smooth seconds. The cost of guessing low is moments of softness; the
 cost of guessing high is a dead page.

package/templates/skills/genex-threejs-game-ui/SKILL.md

@@ -67,7 +67,7 @@ type.
 
 **3. Never stall the build on art.** Scaffold, boot wiring, the core loop,
 and the gameplay-logic modules keep moving in parallel whatever the UI is
-doing — and the core asset set (hero model, ground texture, skybox, sfx) is
+doing — and the core asset set (hero model, ground texture, sky, sfx) is
 prompted from the game IDEA, so it can launch up front behind placeholders.
 Nothing ready to build waits on an art answer: decide, say the decision in
 one line, keep going.

package/templates/skills/genex-threejs-visual-validation/SKILL.md

@@ -134,13 +134,9 @@ everything twice.
    visible; the lock may only ever engage from the Play/Resume click or a
    gameplay canvas click (the phase binding `setPaused(phase !== "playing")` is
    what guarantees this — check it rides `setPhase`, not the render loop).
-   Headless caveat, measured on Chromium 151: `requestPointerLock` does NOT
-   throw — it locks, with or without a user gesture, so the lock and the
-   unlocked cue ARE yours to assert headless. What does not survive is the
-   both-axes look check: synthesised mouse movement cancels to a net zero
-   delta, so turning right then left proves nothing about direction. Assert the
-   wiring and the cue in a screenshot, and say plainly that confirming which way
-   the view turns needs one manual pass with a real mouse.
+   Headless caveat: `requestPointerLock` throws in headless Chromium —
+   assert the wiring and the unlocked cue in a screenshot, and say plainly that
+   the lock itself needs one manual click (do the both-axes look check there).
 7. **Ask the scene the three things the screenshot cannot answer** (below). Run it
    once, in the same browser you already have open.
 

package/templates/skills/genex-updates/SKILL.md

@@ -38,7 +38,7 @@ update, so update immediately.)
 Run exactly the command the nudge printed, from the game project root:
 
 ```bash
-npm i -D @genex-ai/cli-demo@dev   # the genex CLI (a dev dependency)
+npm i -D @genex-ai/cli-demo@latest   # the genex CLI (a dev dependency)
 npm i @genex-ai/embed-sdk@latest     # identity/saves SDK (ships inside the game)
 npm i @genex-ai/multiplayer@latest   # multiplayer SDK (only if the game uses it)
 ```

package/templates/skills/genex-ai-skybox/SKILL.md

@@ -1,133 +0,0 @@
----
-name: genex-ai-skybox
-description: Generate a real 360° skybox (equirectangular panorama) from a text prompt with `npx genex skybox`, then load it as the scene background + environment lighting in Three.js. Use when the user wants a specific photoreal/painted sky or backdrop ("sunset over the ocean", "alien purple nebula", "foggy pine forest") as an image, rather than a procedural/shader sky.
----
-
-# Genex AI · Skybox
-
-Turn a prompt into a 360° **equirectangular** panorama that wraps the scene and
-also lights it (image-based lighting).
-
-## When to use this vs. a procedural sky
-
-- **Use `npx genex skybox`** for a specific, describable ENVIRONMENT — "golden
-  hour over misty mountains", "rolling thunderstorm, towering cumulonimbus",
-  "alien purple nebula", "hazy dusk sky over a distant sea horizon". You get a
-  real image.
-- Build a procedural, animated, time-of-day sky directly in the game's existing
-  scene/runtime only when that is the requested deliverable; this image lane
-  owns static generated panoramas.
-
-**A skybox is environment only — never content.** Buildings, trees, ruins,
-towers, or any object painted into the sky render at infinite distance: they
-never get closer as the player moves, they sit at the wrong parallax against
-the real 3D world, and they read as broken the moment the camera strafes.
-Structures belong in the scene as geometry (`npx genex model`); the sky
-carries atmosphere — light, weather, clouds, haze, stars.
-
-**Writing "no cathedral" does not rescue a prompt that also says "cathedral".**
-Image models are steered by the nouns they ARE given; a ban loses to any
-positive mention of the same thing in the same prompt. A real pilot asked for
-a *"cinematic dark anime gothic atmosphere, ruined cathedral courtyard mood,
-**no buildings or structures**"* — and got a full gothic cathedral with a
-courtyard balustrade and a baked ground plane. Five negations in that prompt,
-zero effect. So never name a structure in a skybox prompt **even to exclude
-it**: describe only light, colour, cloud, weather and time of day.
-
-The CLI enforces this both ways. It appends a closed-positive environment
-clause to every prompt (you'll see `↳ environment-only guard applied`; the
-full final prompt is stored with the generation), and it **refuses outright,
-before spending any credits**, when the prompt itself names a structure or
-object. Landforms are fine — "golden hour over misty mountains", "a distant
-sea horizon", "towering cumulonimbus" all pass. If you genuinely need content
-baked into the sky — e.g. a space station panorama for a scene with no world
-geometry — pass `--raw` to send your prompt exactly as written.
-
-## Run
-
-```bash
-npx genex skybox "<prompt>"
-```
-
-Blocks until ready, then prints its public URL:
-
-```
-https://assets.genex.technology/generations/<id>/skybox-equirect
-```
-
-The image lives in Genex storage (R2) and loads straight from that URL — you don't
-download it and nothing is committed to your repo. The URL is permanent (works the same
-in local dev, the published game, and remixes).
-
-## Load it as background + environment
-
-Load the equirect JPG through the quality tier's rung ladder, mark it
-equirectangular, and use it for both the visible background and the lighting.
-The bare URL is an 8192×4096 original — ~178 MB decoded, over half a phone's
-GPU budget in one texture — so phones must load the downscale rung the platform
-stores next to every skybox (`$genex-threejs-adaptive-quality`):
-
-```ts
-import * as THREE from "three";
-import { detectTier } from "./controllers/quality/tier.ts";
-import { loadTextureWithFallback } from "./controllers/quality/pick-asset.ts";
-
-// the URL `npx genex skybox` printed (R2 sends CORS headers, so cross-origin works):
-const SKYBOX_URL = "https://assets.genex.technology/generations/<id>/skybox-equirect";
-const tier = detectTier(); // reuse the boot tier if you already have it
-const texture = await loadTextureWithFallback(SKYBOX_URL, tier, (u) =>
-  new THREE.TextureLoader().loadAsync(u),
-);
-texture.mapping = THREE.EquirectangularReflectionMapping;
-texture.colorSpace = THREE.SRGBColorSpace;
-
-scene.background = texture;   // visible sky
-scene.environment = texture;  // image-based lighting on PBR materials
-```
-
-Desktop gets the original; phones get the `@2048`/`@4096` rung; a missing rung
-falls back to the original automatically — never a broken boot.
-
-For sharper reflections/lighting, pre-filter it with `PMREMGenerator`:
-
-```ts
-const pmrem = new THREE.PMREMGenerator(renderer);
-const envMap = pmrem.fromEquirectangular(texture).texture;
-scene.environment = envMap;
-scene.background = texture; // keep the raw texture for the visible sky
-// Do NOT dispose `texture` here — it IS the visible background. Dispose it only
-// if you later stop using it as the sky.
-```
-
-## Publish checklist
-
-- Load it from the **URL** the command printed — absolute and permanent, so it resolves
-  the same in local dev, the published game, and remixes. Nothing to commit.
-- Don't copy the image into `public/assets/` — generated assets live in R2, not the repo.
-
-## Options
-
-- `--raw` — send the prompt exactly as written, skipping the appended
-  environment-only guard (for the rare sky that must carry content).
-- `--no-wait` — enqueue and return immediately with the generation id; pick
-  the result up later with `npx genex wait <id>` (safe to re-run — it attaches
-  to the SAME generation).
-- `--api-url <url>` — override the API base (local dev).
-
-## Troubleshooting
-
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
-- **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
-  this skybox generation. Tell the user the facts the CLI printed: their balance, this
-  generation's cost, and when their credits refill. Then offer to continue the build
-  with a procedurally-coded placeholder (a gradient/procedural sky or a plain
-  `scene.background` color) and mark the spot with
-  `// TODO(genex): regenerate when credits refill` so the real asset is one command
-  away later. Do not stop the session over this.
-- **"Email not verified" (`email_verification_required`)** — generation credits
-  unlock after the account's email is verified. Give the user the verify link the
-  CLI printed, wait for them to confirm, then re-run the command.
-- **Sky looks too dark/bright** — adjust `renderer.toneMappingExposure`, or scale
-  `scene.environment` influence via material `envMapIntensity`.
-- **Seam/pole artifacts** — that's inherent to equirect images; keep the camera
-  away from looking straight up/down, or use PMREM for the lighting.