@genex-ai/cli-demo 1.21.0-dev.604 → 1.22.0-dev.605

package/dist/index.js

@@ -2394,6 +2394,26 @@ async function recordTerminal(id, status, urls, cwd = process.cwd()) {
   if (existing && existing.status === status) return;
   await append(cwd, { t: "done", id, status, ...urls?.length ? { urls } : {} });
 }
+async function recordShipped(commit, cwd = process.cwd()) {
+  await append(cwd, { t: "ship", at: (/* @__PURE__ */ new Date()).toISOString(), ...commit ? { commit } : {} });
+}
+async function readLedgerRows(cwd = process.cwd()) {
+  let raw;
+  try {
+    raw = await fs11.readFile(ledgerPath(cwd), "utf8");
+  } catch {
+    return [];
+  }
+  const rows = [];
+  for (const line of raw.split("\n")) {
+    if (!line.trim()) continue;
+    try {
+      rows.push(JSON.parse(line));
+    } catch {
+    }
+  }
+  return rows;
+}
 async function countFailed(kind, cwd = process.cwd()) {
   return (await readLedger(cwd)).filter((e) => e.kind === kind && e.status === "failed").length;
 }
@@ -4870,6 +4890,8 @@ async function deployGame(ctx, opts, log) {
       });
     }
   }
+  await recordShipped(commit, cwd).catch(() => {
+  });
   const index = files.find((f) => f.relPath === "index.html");
   const liveUrl = published.url || grant.playUrl;
   await waitUntilLive(liveUrl, fingerprintOf(index.bytes.toString("utf8")), opts.liveTimeoutMs ?? 2e4, log);
@@ -6885,6 +6907,63 @@ function describeGenerationFailure(kind, error) {
   };
 }
 
+// src/lib/generation-ceiling.ts
+var CHARACTER_KINDS = /* @__PURE__ */ new Set([
+  "character",
+  "character_concept",
+  "character_preview",
+  "character_animation",
+  "character_motion"
+]);
+var DEFAULT_CEILING = 12;
+var DEFAULT_CHARACTER_CEILING = 3;
+function envNumber(raw, fallback) {
+  if (raw === void 0 || raw.trim() === "") return fallback;
+  const n = Number(raw);
+  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : fallback;
+}
+function ceilingConfig(env = process.env) {
+  return {
+    ceiling: envNumber(env.GENEX_GENERATION_CEILING, DEFAULT_CEILING),
+    characterCeiling: envNumber(env.GENEX_CHARACTER_CEILING, DEFAULT_CHARACTER_CEILING)
+  };
+}
+function unshippedCounts(rows) {
+  let lastShip = -1;
+  for (let i = rows.length - 1; i >= 0; i -= 1) {
+    if (rows[i]?.t === "ship") {
+      lastShip = i;
+      break;
+    }
+  }
+  let total = 0;
+  let character = 0;
+  for (let i = lastShip + 1; i < rows.length; i += 1) {
+    const r = rows[i];
+    if (r?.t !== "q") continue;
+    total += 1;
+    if (typeof r.kind === "string" && CHARACTER_KINDS.has(r.kind)) character += 1;
+  }
+  return { total, character };
+}
+function ceilingVerdict(input) {
+  const { kind, counts, config } = input;
+  const isCharacter = CHARACTER_KINDS.has(kind);
+  if (isCharacter && config.characterCeiling > 0 && counts.character >= config.characterCeiling) {
+    return {
+      allow: false,
+      reason: `${counts.character} character generations are already waiting and none has been seen in the game yet. Run \`npx genex preview\` \u2014 put the bodies you have in front of the player, look at them, then generate the rest. (A cast fanned out before one body is on screen is how a build ends up with an asset library and an empty world. Raise or remove this with GENEX_CHARACTER_CEILING; 0 turns it off.)`
+    };
+  }
+  if (config.ceiling > 0 && counts.total >= config.ceiling) {
+    return {
+      allow: false,
+      reason: `${counts.total} generations are already waiting and none of them has been shipped yet. Run \`npx genex preview\` \u2014 it takes seconds, it is free, and it resets this immediately. (There is no total here: preview between batches and generate as much as the game needs. Raise or remove it with GENEX_GENERATION_CEILING; 0 turns it off.)`
+    };
+  }
+  return { allow: true };
+}
+
 // src/lib/download-assets.ts
 import fs16 from "fs/promises";
 import path15 from "path";
@@ -7400,6 +7479,15 @@ async function runGenerate(kind, opts) {
   log.dim(`  ${prompt}`);
   if (skyboxGuard?.guarded) log.dim("  \u21B3 environment-only guard applied (--raw to disable)");
   log.plain("");
+  {
+    const counts = unshippedCounts(await readLedgerRows());
+    const verdict = ceilingVerdict({ kind, counts, config: ceilingConfig() });
+    if (!verdict.allow) {
+      log.error(verdict.reason);
+      process.exitCode = 1;
+      return;
+    }
+  }
   let id;
   try {
     const res = await apiFetch(`${apiUrl}/api/generations`, {
@@ -18618,6 +18706,15 @@ async function postWorkflow(url, token, body) {
 }
 async function runWorkflow(args) {
   const log = createLogger({ quiet: args.opts.quiet || args.opts.json });
+  {
+    const counts = unshippedCounts(await readLedgerRows());
+    const verdict = ceilingVerdict({ kind: args.kind, counts, config: ceilingConfig() });
+    if (!verdict.allow) {
+      log.error(verdict.reason);
+      process.exitCode = 1;
+      return;
+    }
+  }
   const created = await postWorkflow(`${args.ctx.apiUrl}${args.createPath}`, args.ctx.token, args.body);
   if (!created) {
     process.exitCode = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.21.0-dev.604",
+  "version": "1.22.0-dev.605",
   "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

@@ -204,7 +204,11 @@ together with `--no-wait` while you scaffold. Before a second batch starts,
 every id in the first is collected with `npx genex wait --all`, loaded from a
 file in `src/`, and seen in a capture. A batch begun while the previous one is
 still uncollected is how a game ends up with an asset library and an empty
-world. Preserve every id, URL and wiring state across a compaction.
+world. This is enforced, not merely advised: unshipped generations are counted
+and the generate commands refuse past a ceiling, which `npx genex preview`
+resets to zero. There is no total — preview between batches and generate as
+much as the game needs. Preserve every id, URL and wiring state across a
+compaction.
 
 ## 5. Execute by working mode
 

package/templates/skills/genex-lane-card/SKILL.md

@@ -45,6 +45,24 @@ Skip this and the mesh is a speck or a wall — it is the single most common way
 generated asset ships broken. Rigged bodies mismeasure here; those go through
 the controller's own boot path, not this snippet.
 
+## Generate in batches you can finish
+
+The belt has a **shipping ratchet**: generations that have not been shown to the
+player are counted, and the count resets to zero every time you `npx genex
+preview`. Hit it and the command refuses with the number and the fix.
+
+It is not a spend limit and there is no total — preview between batches and
+generate as much as the game needs. What it stops is one thing: fanning out a
+whole cast or a shelf of props before the player has seen any of it. If you are
+refused, you are not out of anything. You have work that nobody has looked at.
+
+```bash
+npx genex model "..." --no-wait   # a batch you can finish
+npx genex wait --all              # collect it
+# wire it, then:
+npx genex preview                 # free, seconds — and the count is zero again
+```
+
 ## The one rule
 
 An asset is not done when the command exits. It is done when something in