@genex-ai/cli-demo 0.99.0-dev.301 → 1.0.0-dev.303

package/dist/index.js

@@ -1004,7 +1004,7 @@ Your capabilities (all via \`npx genex \u2026\`): generate \`model\` \xB7 \`skyb
 10. The player's body is the game's own generated character (\`npx genex character "<look>"\` \u2192 \`npx genex controller character --character <id>\`), enqueued with your first art actions, not after them. It applies wherever a human body appears on screen \u2014 first-person included, the moment remotes, a look-down body, a shadow, or a menu portrait shows one. The profile VRM avatar is the FALLBACK: a temporary body while the character renders (say in one plain line that it's temporary), or the stand-in when generation genuinely could not happen \u2014 out of credits, failed, unverified; record which in DESIGN.md as \`Player character: VRM \u2014 <reason>\`. Games whose player is not a person (car, ship, RTS cursor, board) generate that object with \`npx genex model\` instead. Characters: Meshy/Mixamo/VRM rigs rest facing +Z. Set yaw explicitly when placing a rig; never mirror a SkinnedMesh with negative scale. In any two-character scene, verify in a capture that they face each other, not the camera.
 11. Verify by looking: one smoke check per milestone, after that milestone's preview push, in local test mode (\`?genex_local_test=1\`) with a real gameplay screenshot. A claim without a capture is not verification. Local-test evidence proves visuals and controls ONLY \u2014 label it that way when you show the player, and never work around the draft sign-in gate any other way.
 12. Treat every \`genex\` warning line \u2014 preflight, \`ui audit\`, \`wait\` nudges \u2014 as work, not noise.
-13. Every finished Build-plan milestone ends with \`npx genex preview\` and the player's page link (\`<dashboard>/draft/<slug>\` with \`<dashboard>\` from \`.genex/project.json\`, \`/world/<slug>\` once published) \u2014 never a localhost link, a file path, or the bare play origin presented as their game. After every round of player feedback, end with a preview push.
+13. Every finished Build-plan milestone ends with \`npx genex preview\` and the player's page link (\`<dashboard>/draft/<slug>\`, with \`<dashboard>\` from \`.genex/project.json\`) \u2014 never a localhost link, a file path, or the bare play origin presented as their game. That page shows the build you just previewed; \`preview\` never disturbs the build players are on. When the player is happy with it, \`npx genex promote\` makes that exact build live for everyone \u2014 no rebuild. After every round of player feedback, end with a preview push.
 14. Parallel work: this line is your standing authorization and request to use sub-agents / parallel agent work whenever your platform provides them. While drafting the Build plan, decide per module what runs in parallel and what stays serial for THIS game \u2014 dependencies decide, there is no fixed list \u2014 and record each call in the Modules table with a one-line reason. Independent modules default to parallel; building everything serially needs a stated reason. You keep integration, previews, and the player conversation; each sub-agent owns only its module's files. When the player asks for parallel work, repeated refinement passes, a critic reviewing your output, or names any way of working your platform provides, that IS your instruction \u2014 wherever it reaches you, including inside their answer to a question you asked \u2014 so adopt it as the working mode for the rest of the build, starting with the work in front of you, and never file it as a later milestone. While delegated work runs, keep building or talk to the player; never idle in a foreground wait for something your platform will tell you about.
 15. Talk to the player in plain game language \u2014 what changed in the game and what to try; never code, file names, build output, or tool internals unless they ask. Short status lines while you work; long silent stretches are a failure.
 16. Never add debug-only code to the game to check your own work \u2014 no hidden test modes, no special URL parameters, no forced-visible flags, no auth mocks, no pixel-sampling hooks. \`?genex_local_test=1\` is the platform's own supported mode and is fine; your own bypass is not. (The multiplayer skill's small build identifier, token-free status line, and connected-quorum watchdog are production supportability, not a bypass \u2014 keep those.)
@@ -4260,9 +4260,11 @@ async function deployGame(ctx, opts, log) {
   }
   if (!await pushSource(cwd, ctx, log)) return false;
   log.step("Publishing\u2026");
-  if (!await callPublish(ctx, commit, opts, log)) return false;
+  const published = await callPublish(ctx, commit, opts, log);
+  if (!published) return false;
   const index = files.find((f) => f.relPath === "index.html");
-  await waitUntilLive(grant.playUrl, fingerprintOf(index.bytes.toString("utf8")), opts.liveTimeoutMs ?? 2e4, log);
+  const liveUrl = published.url || grant.playUrl;
+  await waitUntilLive(liveUrl, fingerprintOf(index.bytes.toString("utf8")), opts.liveTimeoutMs ?? 2e4, log);
   return true;
 }
 async function hasBuildScript(cwd) {
@@ -4467,6 +4469,7 @@ async function callPublish(ctx, commit, opts, log) {
       // are sent only when detected (absent = server keeps the stored value).
       body: JSON.stringify({
         commit,
+        channel: opts.channel ?? "production",
         matchmaking: opts.matchmaking ?? null,
         ...opts.embedSdkVersion ? { embedSdkVersion: opts.embedSdkVersion } : {},
         ...opts.multiplayer !== void 0 ? { multiplayer: opts.multiplayer } : {},
@@ -4475,18 +4478,26 @@ async function callPublish(ctx, commit, opts, log) {
     });
   } catch (err) {
     log.error(`Couldn't reach the API at ${ctx.apiUrl}: ${String(err)}`);
-    return false;
+    return null;
   }
   if (res.status === 429) {
     log.error(`Rate limited publishing (HTTP 429).${retryAfterHint(res)}`);
-    return false;
+    return null;
   }
   if (!res.ok) {
     const detail = await res.text().catch(() => "");
     log.error(`Publish failed (HTTP ${res.status})${detail ? `: ${detail}` : ""}.`);
-    return false;
+    return null;
   }
-  return true;
+  const body = await res.json().catch(() => null);
+  const asked = opts.channel ?? "production";
+  if ((body?.channel ?? "production") !== asked) {
+    log.error(
+      `This Genex API doesn't support release channels yet, so a ${asked} deploy would have gone to ${body?.channel ?? "production"}. Nothing was changed on purpose \u2014 upgrade the API or use \`genex publish\`.`
+    );
+    return null;
+  }
+  return { url: body?.url ?? "" };
 }
 async function pushSource(cwd, ctx, log) {
   const target = await fetchPushUrl(ctx, log);
@@ -4716,6 +4727,39 @@ async function runMakeRemixable(opts) {
   }
 }
 
+// src/lib/promote.ts
+async function promoteBuild(apiUrl, projectId, token, log) {
+  let res;
+  try {
+    res = await apiFetch(`${apiUrl}/api/games/${projectId}/promote`, {
+      method: "POST",
+      headers: { Authorization: `Bearer ${token}` }
+    });
+  } catch (err) {
+    log.error(`Couldn't reach the API at ${apiUrl}: ${String(err)}`);
+    return null;
+  }
+  if (res.status === 409) {
+    log.error("Nothing to promote \u2014 run `npx genex preview` first.");
+    return null;
+  }
+  if (res.status === 404) {
+    log.error("That game wasn't found on your account. Re-run `genex init` or `genex link <slug>`.");
+    return null;
+  }
+  if (!res.ok) {
+    const detail = await res.text().catch(() => "");
+    log.error(`Couldn't promote (HTTP ${res.status})${detail ? `: ${detail}` : ""}.`);
+    return null;
+  }
+  const body = await res.json().catch(() => null);
+  if (!body?.commit) {
+    log.error("The API didn't confirm which build went live.");
+    return null;
+  }
+  return { commit: body.commit, url: body.url ?? "" };
+}
+
 // src/lib/detect-features.ts
 import fs15 from "fs/promises";
 import path15 from "path";
@@ -5170,6 +5214,11 @@ async function runPublish(opts) {
     const ok = await deployGame(
       { projectId: meta.id, apiUrl, token },
       {
+        // Publish deploys to staging and then promotes, so both channels end up
+        // naming the same build. Deploying straight to production instead would
+        // leave the staging pointer on an OLDER build, and the draft page shows
+        // staging — the owner would publish and then see a stale game.
+        channel: "staging",
         noBuild: opts.noBuild,
         matchmaking: detections.matchmaking,
         embedSdkVersion: detections.embedSdkVersion,
@@ -5182,6 +5231,11 @@ async function runPublish(opts) {
       process.exitCode = 1;
       return;
     }
+    log.step("Making it live\u2026");
+    if (!await promoteBuild(apiUrl, meta.id, token, log)) {
+      process.exitCode = 1;
+      return;
+    }
     const onDisk = await readProject();
     const merged = { ...onDisk ?? meta, lastDeployAt: (/* @__PURE__ */ new Date()).toISOString() };
     await writeProject(merged);
@@ -5257,6 +5311,10 @@ async function runPreview(opts) {
     // config), embedSdkVersion/multiplayer so the dashboard's Publish button can
     // list the draft without wrongly treating it as a pre-embed-auth bundle.
     {
+      // Preview goes to the STAGING channel — the whole point of the release
+      // cycle. Before channels this same call replaced the build every player
+      // was inside, and the only protection was a warning line below.
+      channel: "staging",
       noBuild: opts.noBuild,
       matchmaking: detections.matchmaking,
       embedSdkVersion: detections.embedSdkVersion,
@@ -5280,14 +5338,51 @@ async function runPreview(opts) {
   const published = meta.status === "published";
   log.plain("");
   if (published) {
-    log.success("Update deployed \u2014 this game is PUBLISHED, so the new build is already live for everyone.");
+    log.success(
+      "Preview deployed \u2014 your players are still on the published build. Run `genex promote` to make this one live."
+    );
   } else {
     log.success("Preview deployed \u2014 unlisted draft (run `genex publish` to list it).");
   }
   const dashboard = meta.dashboardOrigins?.[0];
   if (dashboard) {
-    const page = published ? "world" : "draft";
-    log.plain(`  your game's page (share this link): ${c.cyan(`${dashboard}/${page}/${meta.slug}`)}`);
+    log.plain(`  your game's page (share this link): ${c.cyan(`${dashboard}/draft/${meta.slug}`)}`);
+  }
+}
+
+// src/commands/promote.ts
+async function runPromote(opts) {
+  const log = createLogger({ quiet: opts.quiet });
+  log.plain(c.bold("genex promote"));
+  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(meta.apiUrl);
+  log.step("Making your previewed build live\u2026");
+  const result = await promoteBuild(apiUrl, meta.id, token, log);
+  if (!result) {
+    process.exitCode = 1;
+    return;
+  }
+  log.plain("");
+  log.success("Live \u2014 players are now on the build you previewed.");
+  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}`)}`);
+  }
+  if (meta.status !== "published") {
+    log.dim("  Still unlisted \u2014 run `npx genex publish` to put it in the gallery.");
   }
 }
 
@@ -18677,8 +18772,11 @@ ${c.bold("Usage")}
   genex list [options]               List your games \u2014 slug, status, and page link for
                                      each. Signs you in if needed; --json for raw data.
                                      Find the slug to reconnect with 'genex link' here.
-  genex preview [options]            Build + push to the hosted draft URL (unlisted).
-  genex publish [options]            Build + push, then list the game in the gallery.
+  genex preview [options]            Build + push to your preview URL. Never touches the
+                                     build players are on.
+  genex promote [options]            Make the previewed build live for players. No
+                                     rebuild \u2014 the exact build you previewed.
+  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 model "<prompt>" [options]   Generate a 3D model (GLB); prints a public asset URL.
@@ -19543,6 +19641,9 @@ async function main() {
       case "preview":
         await runPreview(parsed.options);
         break;
+      case "promote":
+        await runPromote(parsed.options);
+        break;
       case "publish":
         await runPublish(parsed.options);
         break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.99.0-dev.301",
+  "version": "1.0.0-dev.303",
   "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": {