@genex-ai/cli-demo 0.32.0 → 0.34.0

package/README.md

@@ -8,6 +8,7 @@ genex init <name>          # authorize + create the draft project
 genex link <slug>          # re-link this folder to an existing game of yours (recovery)
 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

package/dist/index.js

@@ -567,6 +567,34 @@ function formatUpdateRequired(body) {
   const message = body.message ?? `Genex CLI ${body.clientVersion ?? getCliVersion()} is below the minimum supported version${body.minVersion ? ` ${body.minVersion}` : ""}.`;
   return [`${c.red("\u2717")} ${message}`, `  Update now \u2014 run: ${action}  (then re-run this command)`];
 }
+function shortDate(iso) {
+  const d = new Date(iso);
+  if (Number.isNaN(d.getTime())) return iso;
+  return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
+}
+function formatInsufficientCredits(body) {
+  const message = body.message ?? `this generation costs ${body.price ?? "?"} credits; your balance is ${body.balance ?? 0}.`;
+  const lines = [`${c.red("\u2717")} Out of credits \u2014 ${lowerFirst(message)}`];
+  if (body.refillAt && body.refillTo) {
+    lines.push(`  Credits refill to ${body.refillTo} on ${shortDate(body.refillAt)}.`);
+  }
+  if (body.url) lines.push(`  Get more or check your balance: ${body.url}`);
+  return lines;
+}
+function formatVerificationRequired(body) {
+  const lines = [
+    `${c.red("\u2717")} Email not verified \u2014 verify your email to unlock your free generation credits.`
+  ];
+  if (body.url) lines.push(`  Verify here: ${body.url}  (then re-run this command)`);
+  return lines;
+}
+function lowerFirst(s) {
+  return s ? s[0].toLowerCase() + s.slice(1) : s;
+}
+var structuredPrinted = /* @__PURE__ */ new WeakSet();
+function printedStructuredError(res) {
+  return structuredPrinted.has(res);
+}
 async function apiFetch(url, init = {}) {
   const headers = new Headers(init.headers);
   if (!headers.has(CLI_VERSION_HEADER)) headers.set(CLI_VERSION_HEADER, getCliVersion());
@@ -580,6 +608,39 @@ async function apiFetch(url, init = {}) {
     } catch {
     }
   }
+  if (res.status === 402) {
+    try {
+      const body = await res.clone().json();
+      if (body?.error === "insufficient_credits") {
+        for (const line of formatInsufficientCredits(body)) process.stderr.write(line + "\n");
+        structuredPrinted.add(res);
+      }
+    } catch {
+    }
+  }
+  if (res.status === 403) {
+    try {
+      const body = await res.clone().json();
+      if (body?.error === "email_verification_required") {
+        for (const line of formatVerificationRequired(body)) process.stderr.write(line + "\n");
+        structuredPrinted.add(res);
+      }
+    } catch {
+    }
+  }
+  if (res.status === 503) {
+    try {
+      const body = await res.clone().json();
+      if (body?.error === "generation_paused") {
+        process.stderr.write(
+          `${c.red("\u2717")} ${body.message ?? "Generation is temporarily paused platform-wide. Try again later."}
+`
+        );
+        structuredPrinted.add(res);
+      }
+    } catch {
+    }
+  }
   return res;
 }
 
@@ -598,7 +659,12 @@ async function createDraftProject(opts) {
           "Content-Type": "application/json",
           Authorization: `Bearer ${token}`
         },
-        body: JSON.stringify(opts.repoUrl ? { name, repoUrl: opts.repoUrl } : { name })
+        body: JSON.stringify({
+          name,
+          ...opts.repoUrl ? { repoUrl: opts.repoUrl } : {},
+          ...opts.private ? { private: true } : {},
+          ...opts.remixedFromSlug ? { remixedFromSlug: opts.remixedFromSlug } : {}
+        })
       });
     } catch (err) {
       log.warn(`Couldn't reach the API at ${apiUrl} to create the project.`);
@@ -929,6 +995,8 @@ async function runInit(opts) {
     token,
     name: projectName,
     repoUrl: opts.repo?.trim() || void 0,
+    private: opts.private,
+    remixedFromSlug: opts.remixedFrom?.trim() || void 0,
     colyseusUrl,
     dashboardUrl: authBaseUrl,
     log
@@ -1267,10 +1335,12 @@ async function callPublish(ctx, commit, opts, log) {
   return true;
 }
 async function pushSource(cwd, ctx, log) {
-  const EMPTY_TREE = "4b825dc642cb6eb9a060e54bf8d69288fbee4904";
   const target = await fetchPushUrl(ctx, log);
   if (!target) return false;
-  const { pushUrl, managed } = target;
+  return pushWorktree(cwd, target.pushUrl, target.managed, log);
+}
+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;
@@ -1379,6 +1449,75 @@ async function waitUntilLive(playUrl, fingerprint, timeoutMs, log) {
   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("");
+  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 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;
+  }
+  if (res.status === 401) {
+    log.error("Not authorized \u2014 your token may have expired. Re-run `genex init`.");
+    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 (!res.ok) {
+    log.error(`Couldn't make the game public (HTTP ${res.status}).`);
+    process.exitCode = 1;
+    return;
+  }
+  const data = await res.json().catch(() => null);
+  if (!data?.pushUrl) {
+    log.error("The API didn't return a push URL.");
+    process.exitCode = 1;
+    return;
+  }
+  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;
+  }
+  const newCloneUrl = data.project?.cloneUrl;
+  if (newCloneUrl && newCloneUrl !== meta.cloneUrl) {
+    await writeProject({ ...meta, cloneUrl: newCloneUrl });
+  }
+  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 fs10 from "fs/promises";
 import path11 from "path";
@@ -1664,6 +1803,10 @@ async function runGenerate(kind, opts) {
       process.exitCode = 1;
       return;
     }
+    if (printedStructuredError(res)) {
+      process.exitCode = 1;
+      return;
+    }
     if (!res.ok) {
       log.error(`Generation request failed (HTTP ${res.status}).`);
       process.exitCode = 1;
@@ -2063,6 +2206,8 @@ ${c.bold("Usage")}
                                      update the same live game. Never creates a project.
   genex preview [options]            Build + push to the hosted draft URL (unlisted).
   genex publish [options]            Build + push, then list the game 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 model "<prompt>" [options]   Generate a 3D model (GLB) into public/assets/models.
   genex skybox "<prompt>" [options]  Generate a skybox (equirect) into public/assets/skybox.
   genex sfx "<prompt>" [options]     Generate a sound effect (mp3) into public/assets/sfx.
@@ -2085,6 +2230,8 @@ ${c.bold("Options for `init`")}
   --name <name>        Same as the positional name.
   --repo <url>         Host the source in your own git repo (https/ssh) instead of a managed one;
                        preview/publish push there with your git credentials.
+  --private            Create the game private \u2014 only you can remix it (managed repos only).
+  --remixed-from <slug> Record the game this one was remixed from (lineage).
   --agents <list>      Agents to install skills for (claude,codex,cursor; default: auto-detect).
   --dir <path>         Single destination workspace (overrides --agents).
   --env <path>         Token env file (default: ~/.genex/env).
@@ -2142,6 +2289,7 @@ ${c.bold("Examples")}
   genex preview
   genex publish
   genex publish --categories games,vfx
+  genex make-remixable
   genex publish --no-push --title "My Game"
   genex model "weathered wooden barrel with iron bands"
   genex skybox "golden hour over a misty mountain range"
@@ -2167,6 +2315,7 @@ function parseArgs(argv) {
     "--agents",
     "--name",
     "--repo",
+    "--remixed-from",
     "--title",
     "--description",
     "--categories",
@@ -2210,6 +2359,9 @@ function parseArgs(argv) {
       case "--regenerate-cover":
         parsed.options.regenerateCover = true;
         break;
+      case "--private":
+        parsed.options.private = true;
+        break;
       case "--quiet":
         parsed.options.quiet = true;
         break;
@@ -2269,6 +2421,9 @@ function applyValueFlag(options, flag, value) {
     case "--repo":
       options.repo = value;
       break;
+    case "--remixed-from":
+      options.remixedFrom = value;
+      break;
     case "--title":
       options.title = value;
       break;
@@ -2347,6 +2502,9 @@ async function main() {
       case "link":
         await runLink(parsed.options);
         break;
+      case "make-remixable":
+        await runMakeRemixable(parsed.options);
+        break;
       case "controller":
         await runController({ ...parsed.options, kind: parsed.options.name });
         break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.32.0",
+  "version": "0.34.0",
   "description": "Set up your ~/.claude workspace, authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

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

@@ -106,5 +106,14 @@ scene is a ghost: players and objects pass straight through it.
 ## Troubleshooting
 
 - **"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 model 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 simple Three.js primitive-based stand-in
+  mesh) 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.
 - **The mesh looks low-detail / wrong** — make the prompt more specific
   (materials, style, parts) and regenerate; each run is a fresh asset.

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

@@ -73,6 +73,15 @@ Reuse one loaded `buffer` across many plays; create a fresh `Audio`/`PositionalA
 ## Troubleshooting
 
 - **"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 sound 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 small WebAudio-synthesized stub sound)
+  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.
 - **No sound** — the `AudioContext` is suspended until a user gesture; trigger the
   first play from a click/keydown. Confirm the camera has an `AudioListener`.
 - **Too quiet/loud** — `sound.setVolume(0..1)`; for positional, tune

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

@@ -77,6 +77,16 @@ scene.background = texture; // keep the raw texture for the visible sky
 ## Troubleshooting
 
 - **"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 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

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

@@ -82,6 +82,16 @@ scene.add(ground);
 ## Troubleshooting
 
 - **"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
+  build with a procedurally-coded placeholder (a procedural Three.js material in a
+  matching 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.
 - **Visible tiling seams** — use `--terrain` (tuned for seamless edges), lower the
   `repeat`, or blend two textures. Perfect seamlessness is a known v1 limitation.
 - **Colors look washed/dark** — ensure `map.colorSpace = THREE.SRGBColorSpace`.

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

@@ -9,13 +9,15 @@ Genex ships improvements continuously. The `genex` CLI tells you when something
 is stale; you (the agent) apply the update at the right moment and tell the
 user what happened. The user never manages versions themselves.
 
-## The three signals in `genex` output
+## The signals in `genex` output
 
 | Line | Meaning | What you do |
 | -- | -- | -- |
 | `🔄 Genex skills updated to X.Y.Z` | Skills were auto-refreshed to match the installed CLI. | Nothing — informational. Skills stay in sync on their own. |
 | `⬆ Genex <package> X.Y.Z available (installed A.B.C) — run: <command>` | A newer npm package exists. | Run the printed command at a **safe moment** (below), then tell the user. |
 | `✗ … below the minimum supported version … Update now — run: <command>` | The API refuses this CLI version (HTTP 426, `cli_update_required`). | Run the printed command **now**, then re-run the refused genex command. |
+| `✗ Out of credits — … costs N credits; your balance is M.` | The account can't cover this generation (HTTP 402, `insufficient_credits`). | Relay the printed facts (balance, cost, refill date, link) to the user; offer a procedural placeholder so the build continues — see the generation skill's Troubleshooting. |
+| `✗ Email not verified — …` | Generation credits are locked until the email is verified (HTTP 403, `email_verification_required`). | Give the user the printed verify link, wait for them to confirm, then re-run the command. |
 
 ## Safe moments — when to apply a nudge