@genex-ai/cli-demo 0.47.0 → 0.48.0-dev.75

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 = "latest";
+var RAW_CHANNEL = "dev";
 var CLI_CHANNEL = RAW_CHANNEL === "dev" ? "dev" : "latest";
 var STANDS = {
   prod: { api: "https://api.genex.games", dashboard: "https://genex.games" },
@@ -868,6 +868,49 @@ async function writeGitignore(dir, log) {
   await fs4.writeFile(file, next);
   log.dim(`Updated .gitignore (${toAdd.join(", ")}).`);
 }
+var LFS_PATTERNS = [
+  // models
+  "*.glb",
+  "*.gltf",
+  "*.bin",
+  "*.vrm",
+  "*.fbx",
+  "*.obj",
+  // textures / images
+  "*.png",
+  "*.jpg",
+  "*.jpeg",
+  "*.webp",
+  "*.ktx2",
+  "*.basis",
+  "*.hdr",
+  "*.exr",
+  "*.tga",
+  // audio / video
+  "*.mp3",
+  "*.ogg",
+  "*.wav",
+  "*.m4a",
+  "*.mp4",
+  "*.webm"
+];
+async function writeGitattributes(dir, log) {
+  const file = path4.join(dir, ".gitattributes");
+  let content = "";
+  try {
+    content = await fs4.readFile(file, "utf8");
+  } catch {
+  }
+  const present = new Set(content.split("\n").map((l) => l.trim().split(/\s+/)[0]));
+  const toAdd = LFS_PATTERNS.filter((p) => !present.has(p));
+  if (toAdd.length === 0) return;
+  let next = content;
+  if (next.length > 0 && !next.endsWith("\n")) next += "\n";
+  if (!content.trim()) next += "# Binary game assets go to Git LFS (R2) \u2014 keeps the source push small\n";
+  next += toAdd.map((p) => `${p} filter=lfs diff=lfs merge=lfs -text`).join("\n") + "\n";
+  await fs4.writeFile(file, next);
+  log.dim(`Updated .gitattributes (${toAdd.length} binary globs \u2192 Git LFS).`);
+}
 
 // src/lib/store.ts
 import fs6 from "fs/promises";
@@ -1512,6 +1555,28 @@ async function pushWorktree(cwd, pushUrl, managed, log) {
       ["node_modules/", "dist/", ".git/", ".genex/", ".env", ".env.*", "!.env.example", ""].join("\n")
     );
     const env = { ...base, GIT_WORK_TREE: cwd, GIT_INDEX_FILE: path10.join(gitDir, "index-source") };
+    let lfs = (await run("git", ["lfs", "version"], base)).code !== 0 ? false : true;
+    if (!lfs) {
+      log.step("Installing git-lfs (keeps large binary assets out of the source push)\u2026");
+      const [bin, args] = process.platform === "darwin" ? ["brew", ["install", "git-lfs"]] : ["sudo", ["-n", "apt-get", "install", "-y", "git-lfs"]];
+      await run(bin, args, base);
+      lfs = (await run("git", ["lfs", "version"], base)).code === 0;
+      if (!lfs) {
+        log.warn(
+          "Couldn't install git-lfs \u2014 large binary assets won't be saved to your source (the game still publishes)."
+        );
+      }
+    }
+    if (lfs) {
+      await writeGitattributes(cwd, log);
+      const filters = [
+        ["filter.lfs.clean", "git-lfs clean -- %f"],
+        ["filter.lfs.smudge", "git-lfs smudge -- %f"],
+        ["filter.lfs.process", "git-lfs filter-process"],
+        ["filter.lfs.required", "true"]
+      ];
+      for (const [key, value] of filters) await run("git", ["config", key, value], base);
+    }
     await run("git", ["add", "-A"], env);
     const tree = (await run("git", ["ls-files"], env)).out.trim() ? (await run("git", ["write-tree"], env)).out.trim() : "";
     if (!tree || tree === EMPTY_TREE) {
@@ -1520,6 +1585,10 @@ async function pushWorktree(cwd, pushUrl, managed, log) {
     }
     const commit = (await run("git", ["commit-tree", tree, "-m", "source"], { ...base, ...ident })).out.trim();
     await run("git", ["update-ref", "refs/heads/main", commit], base);
+    if (lfs && (await run("git", ["lfs", "push", "--all", pushUrl, "main"], base)).code !== 0) {
+      log.error("Couldn't upload your game's binary assets to the source store.");
+      return false;
+    }
     const push = await run(
       "git",
       ["-c", "http.postBuffer=536870912", "push", "-q", pushUrl, "+refs/heads/main:main"],
@@ -1731,12 +1800,31 @@ async function detectGameStateUsage(cwd = process.cwd()) {
   }
   return false;
 }
+var UI_PHASE_MARKERS = /data-phase|setPhase/;
+async function detectUiPhases(cwd = process.cwd()) {
+  try {
+    const html = await fs10.readFile(path11.join(cwd, "index.html"), "utf8").catch(() => "");
+    if (UI_PHASE_MARKERS.test(html)) return true;
+    const srcDir = path11.join(cwd, "src");
+    const entries = await fs10.readdir(srcDir, { recursive: true });
+    for (const rel of entries) {
+      if (rel.includes("node_modules")) continue;
+      if (!/\.(ts|js|mts|mjs|tsx|jsx|html|css)$/.test(rel)) continue;
+      const content = await fs10.readFile(path11.join(srcDir, rel), "utf8").catch(() => "");
+      if (UI_PHASE_MARKERS.test(content)) return true;
+    }
+    return false;
+  } catch {
+    return true;
+  }
+}
 async function detectFeatures(log, cwd = process.cwd()) {
   return {
     embedSdkVersion: await detectEmbedSdkVersion(cwd),
     multiplayer: await detectMultiplayer(cwd),
     matchmaking: await detectMatchmaking(log, cwd),
-    gameStateUsed: await detectGameStateUsage(cwd)
+    gameStateUsed: await detectGameStateUsage(cwd),
+    uiPhases: await detectUiPhases(cwd)
   };
 }
 function advisoryNudges(log, d) {
@@ -1755,6 +1843,18 @@ function advisoryNudges(log, d) {
       "package.json declares genex.matchmaking but @genex-ai/multiplayer is not installed \u2014 matchmaking cannot work. Install the SDK and use matchmake() (see genex-threejs-multiplayer)."
     );
   }
+  if (!d.uiPhases) {
+    log.warn(
+      "No menu/loader screens detected (no data-phase/setPhase) \u2014 players get a bare HUD with no title screen and no styled loading. Run the genex-threejs-game-ui plan (loader, menu, screen tiers); a cinematic menu is two commands away (genex-ai-menu)."
+    );
+  }
+}
+async function firstPreviewNudge(log, cwd = process.cwd()) {
+  const meta = await readProject(cwd);
+  if (!meta || meta.lastDeployAt || meta.status === "published") return;
+  log.dim(
+    "  \u279C Draft page still the placeholder? Ship the first rough build now: npx genex preview \u2014 then keep building."
+  );
 }
 
 // src/commands/publish.ts
@@ -1792,6 +1892,8 @@ async function runPublish(opts) {
       process.exitCode = 1;
       return;
     }
+    meta.lastDeployAt = (/* @__PURE__ */ new Date()).toISOString();
+    await writeProject(meta);
   } else {
     log.info("Skipping build + deploy (--no-push).");
   }
@@ -1875,8 +1977,9 @@ async function runPreview(opts) {
   const freshStatus = await fetchProjectStatus(apiUrl, token, meta.slug);
   if (freshStatus && freshStatus !== meta.status) {
     meta.status = freshStatus;
-    await writeProject(meta);
   }
+  meta.lastDeployAt = (/* @__PURE__ */ new Date()).toISOString();
+  await writeProject(meta);
   const published = meta.status === "published";
   log.plain("");
   if (published) {
@@ -2041,9 +2144,9 @@ async function awaitAndReport(apiUrl, token, id, kind, log) {
     process.exitCode = 1;
     return;
   }
-  reportTerminal(kind, view, log);
+  await reportTerminal(kind, view, log);
 }
-function reportTerminal(kind, view, log) {
+async function reportTerminal(kind, view, log) {
   if (view.status !== "completed") {
     log.error(`Generation ${view.status}${view.error ? `: ${view.error}` : ""}.`);
     process.exitCode = 1;
@@ -2063,6 +2166,7 @@ function reportTerminal(kind, view, log) {
   }
   log.plain("");
   printHint(kind, files, log);
+  await firstPreviewNudge(log);
 }
 var WAIT_TIMEOUT_MS = 10 * 60 * 1e3;
 var KIND_WAIT_TIMEOUT_MS = {
@@ -2211,7 +2315,7 @@ async function runWait(opts) {
   log.dim(`  ${kind} ${id}`);
   log.plain("");
   if (TERMINAL2.has(view.status)) {
-    reportTerminal(kind, view, log);
+    await reportTerminal(kind, view, log);
     return;
   }
   await awaitAndReport(apiUrl, token, id, kind, log);
@@ -2690,6 +2794,7 @@ async function runController(opts) {
   for (const line of set.sketch) {
     log.dim(`       ${line}`);
   }
+  await firstPreviewNudge(log);
 }
 async function installOwnerAvatar(args) {
   const { root, srcDir, apiUrl, token, log } = args;

package/package.json

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

package/templates/controllers/shared/physics-world.ts

@@ -157,7 +157,8 @@ const _identityMatrix = new THREE.Matrix4();
  * const physics = await PhysicsWorld.create();
  * physics.onBeforeStep(() => controller.update(physics.timeStep));
  * renderer.setAnimationLoop(() => {
- *   physics.step(clock.getDelta());   // fixed substeps + mesh sync + events
+ *   physics.step(delta);              // fixed substeps + mesh sync + events
+ *   // delta = capped performance.now() difference — avoid THREE.Clock.getDelta()
  *   // ...camera + render (render-delta code lives OUT here, never inside)
  * });
  * ```

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

@@ -346,7 +346,7 @@ after a bad single costs the whole chain).
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it
   writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the
   prompt. Non-retryable; rewrite the wording.

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

@@ -182,7 +182,7 @@ set belongs to `$genex-ai-hud` — both build on this command.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev 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.
 - **Decal is an opaque rectangle** — the image has no alpha. Regenerate with

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

@@ -272,7 +272,7 @@ upgrades, in order of effort:
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it
   writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the
   prompt. Non-retryable; rewrite the wording.

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

@@ -107,7 +107,7 @@ 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`).
+- **"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 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

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

@@ -72,7 +72,7 @@ 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`).
+- **"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 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

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

@@ -76,7 +76,7 @@ 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`).
+- **"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

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

@@ -81,7 +81,7 @@ scene.add(ground);
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"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 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

@@ -145,7 +145,7 @@ set belongs to `$genex-ai-hud` — both build on `npx genex image`/`video`.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev 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-explore/SKILL.md

@@ -43,7 +43,7 @@ Add `--json` for machine-readable output.
 **As a NEW game (start from the whole project):**
 
 1. `git clone <clone URL from the output> <name>` — pick a short one-word name.
-2. `cd <name>`, then `npx @genex-ai/cli-demo@latest init <name>` — never use
+2. `cd <name>`, then `npx @genex-ai/cli-demo@dev init <name>` — never use
    `--force`. This creates your own project; the original is untouched.
 3. `npm install`, keep `base: './'` in `vite.config`, then build your changes
    and ship with `npx genex preview`.

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

@@ -125,7 +125,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@latest link <slug>   # slug = the name in the play URL
+npx @genex-ai/cli-demo@dev link <slug>   # slug = the name in the play URL
 ```
 
 `link` never creates a project: it signs in if needed (the browser opens once)
@@ -148,7 +148,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@latest init
+npx @genex-ai/cli-demo@dev init
 ```
 
 Use `--force` only if you intentionally want your own existing files overwritten

package/templates/skills/genex-threejs-character-controller/SKILL.md

@@ -94,9 +94,14 @@ physics.onBeforeStep(() => {
 });
 
 // Render phase: step physics, then camera, then animations.
+// Delta comes from performance.now(), NOT THREE.Clock — Clock.getDelta() has
+// repeatedly frozen at 0 in real games (world renders, nothing moves).
 const pivot = new THREE.Vector3();
+let lastT = performance.now();
 renderer.setAnimationLoop(() => {
-  const delta = clock.getDelta();
+  const nowT = performance.now();
+  const delta = Math.min((nowT - lastT) / 1000, 0.1);
+  lastT = nowT;
   physics.step(delta); // runs the fixed substeps + world.step() + mesh sync
 
   pivot.copy(character.currPos).addScaledVector(character.bodyYAxis, 0.5);

package/templates/skills/genex-threejs-character-controller/references/wiring.md

@@ -169,7 +169,11 @@ Per fixed **substep** (inside `physics.onBeforeStep`), in this order:
 Per **render** frame (inside `renderer.setAnimationLoop`), in this order:
 
 ```ts
-const delta = clock.getDelta();
+// Delta from performance.now() — THREE.Clock.getDelta() has repeatedly frozen
+// at 0 in real games (world renders, nothing moves).
+const nowT = performance.now();
+const delta = Math.min((nowT - lastT) / 1000, 0.1);
+lastT = nowT;
 physics.step(delta);                               // 1. fixed substeps + mesh sync
 
 pivot.copy(character.currPos).addScaledVector(character.bodyYAxis, 0.5);

package/templates/skills/genex-threejs-physics-rapier/SKILL.md

@@ -59,9 +59,11 @@ physics.onBeforeStep(() => {
   // controller.update(), impulses, kinematic platform poses ...
 });
 
-const clock = new THREE.Clock();
+let lastT = performance.now(); // NOT THREE.Clock — its getDelta() has frozen at 0 in real games
 renderer.setAnimationLoop(() => {
-  physics.step(clock.getDelta()); // fixed substeps + mesh sync + events
+  const nowT = performance.now();
+  physics.step(Math.min((nowT - lastT) / 1000, 0.1)); // fixed substeps + mesh sync + events
+  lastT = nowT;
   // camera follow, mixers, HUD go HERE (render-delta work, after the step) —
   // never inside onBeforeStep above
   renderer.render(scene, camera);

package/templates/skills/genex-threejs-vehicle-controllers/SKILL.md

@@ -51,8 +51,11 @@ physics.onBeforeStep(() => {
   drone.update(dt);
 });                                              // 4. world.step() runs after
 
+let lastT = performance.now();
 renderer.setAnimationLoop(() => {
-  physics.step(clock.getDelta()); // fixed substeps + interpolated mesh sync
+  const nowT = performance.now();
+  physics.step(Math.min((nowT - lastT) / 1000, 0.1)); // fixed substeps + interpolated mesh sync
+  lastT = nowT;                   // performance.now() delta — THREE.Clock.getDelta() freezes at 0 in real games
   // camera + render here — render-delta code never goes inside onBeforeStep
 });
 ```

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

@@ -26,11 +26,16 @@ evidence, temporal checks, budgets, and explicit rejection criteria.
 
 For plain game tasks — nothing from the procedural/visual-system pack loaded —
 this is the whole acceptance gate, and it is also the *ceiling*: a smoke check,
-not a certification. Run it ONCE per milestone to catch obvious breakage, fix
-what's clearly broken, and hand the feel/polish judgment to the player — don't
-loop re-testing the same build, and don't try to exercise every button and edge
-case yourself. The player deciding "does it feel right?" is faster and truer
-than you clicking everything twice.
+not a certification. Run it ONCE per milestone, and only AFTER that milestone's
+`genex preview` is pushed — ship the rough draft first, then check it; the
+player may already be walking around your build while you do. Catch obvious
+breakage, fix what's clearly broken, and hand the feel/polish judgment to the
+player — don't loop re-testing the same build, don't re-test after cosmetic
+tweaks (sounds, colors, tuning values), and don't try to exercise every button
+and edge case yourself. This browser check is the only testing a game draft
+needs: never add unit tests or a test framework to a game unless the user asks.
+The player deciding "does it feel right?" is faster and truer than you clicking
+everything twice.
 
 1. Load the page in a real browser; the canvas renders (no black screen, no
    console errors). For an unpublished draft, open the dev server in local

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@latest   # the genex CLI (a dev dependency)
+npm i -D @genex-ai/cli-demo@dev   # 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)
 ```