@genex-ai/cli-demo 1.5.0-dev.389 → 1.5.1-dev.392

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

@@ -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.
 
@@ -1119,6 +1119,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",
@@ -6680,7 +6685,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}"`,
@@ -19412,7 +19420,6 @@ ${c.bold("Usage")}
                                      so this is the only way one exists. Prices come
                                      off a fixed grid, printed on any refusal.
   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).
@@ -19487,12 +19494,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
@@ -19664,7 +19667,6 @@ ${c.bold("Examples")}
   genex shop remove sku_123
   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
@@ -20268,6 +20270,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,

package/package.json

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

package/templates/skills/genex-game-director/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 —

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

@@ -150,6 +150,16 @@ Render `name`, `iconUrl`, `priceCoins` **and** `priceDisplayUsdCents`. Never
 hardcode a price: the server charges what its own catalog says, so a hardcoded
 number can silently disagree with what the player is charged.
 
+`getShop()` works for a **guest** and inside a **preview** build, so the shop
+window renders for everyone — that is the point of showing it to a signed-out
+player at all. Buying is what needs an account.
+
+**Your game cannot read the player's coin balance, and no HUD should show one.**
+The wallet spans every game on the platform, so an untrusted game is not told how
+much a player can spend. Show what you *can* know — what they own, from
+`getEntitlements()` — and let `buy()` report `insufficient_balance` if it comes
+to that.
+
 ### Buying
 
 ```ts

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-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.