@genex-ai/cli-demo 0.22.0 → 0.24.0

package/dist/index.js

@@ -1668,7 +1668,7 @@ async function poll(apiUrl, token, id, onProgress) {
 function printHint(kind, files, log) {
   const url = files[0]?.url ?? "";
   const hint = {
-    model: `Load with GLTFLoader from the URL and add it to the scene \u2014 see the genex-ai-model skill. url = "${url}"`,
+    model: `Meshopt-compressed GLB \u2014 wire the decoder once (loader.setMeshoptDecoder(MeshoptDecoder)), then load with GLTFLoader 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}"`,
     sfx: `Load with AudioLoader into a THREE.PositionalAudio (camera needs an AudioListener) \u2014 see genex-ai-sfx. url = "${url}"`,
     texture: `Load each map with TextureLoader (RepeatWrapping) into a MeshStandardMaterial \u2014 see genex-ai-texture. Use the URLs above by role.`
@@ -1870,11 +1870,6 @@ async function exists2(p) {
 async function runExplore(opts) {
   const log = createLogger({ quiet: opts.quiet });
   const query = opts.query?.trim();
-  if (!query) {
-    log.error('Missing query. Usage: genex explore "<what you need>"');
-    process.exitCode = 1;
-    return;
-  }
   const apiUrl = getApiUrl(opts.apiUrl);
   let res;
   try {
@@ -1890,17 +1885,21 @@ async function runExplore(opts) {
     return;
   }
   const { items } = await res.json();
-  const ranked = rank(items, query).slice(0, 5);
+  const ranked = query ? rank(items, query).slice(0, 5) : [...items].sort((a, b) => b.playsCount - a.playsCount);
   if (opts.json) {
     console.log(JSON.stringify(ranked, null, 2));
     return;
   }
   if (ranked.length === 0) {
     log.plain(
-      `No curated projects matched "${query}". Try a broader term (terrain, grass, vehicle, water, building, dungeon, fish, shader).`
+      query ? `No curated projects matched "${query}". Run \`genex explore\` with no arguments to browse the whole catalog, or try a broader term (terrain, grass, vehicle, water, building, dungeon, fish, shader).` : `The curated catalog is empty right now \u2014 check back soon.`
     );
     return;
   }
+  if (!query) {
+    log.plain(c.bold(`The full curated catalog (${ranked.length} project${ranked.length === 1 ? "" : "s"}):`));
+    log.plain("");
+  }
   for (const [i, p] of ranked.entries()) {
     const meta = [
       p.categories.join(", "),
@@ -1960,8 +1959,9 @@ ${c.bold("Usage")}
   genex texture "<prompt>" [options] Generate a PBR texture into public/assets/textures.
   genex controller <type> [--force]  Install a physics controller (character|car|drone)
                                      into src/controllers (+ assets into public/assets).
-  genex explore "<query>" [options]  Search the curated community gallery \u2014 proven
-                                     Three.js systems you can clone or borrow parts from.
+  genex explore ["<query>"] [options] Search the curated community gallery \u2014 proven
+                                     Three.js systems you can clone or borrow parts
+                                     from. No query lists the whole catalog.
 
 ${c.bold("Options for the generators (`model` `skybox` `sfx` `texture`)")}
   --terrain            (texture) seamless tiling surface for terrain/ground.
@@ -2008,8 +2008,9 @@ ${c.bold("Options for `preview` / `publish`")}
   --env <path>         Token env file (default: ~/.genex/env).
 
 ${c.bold("Options for `explore`")}
-  --json               Print the top matches as JSON (for tools/agents).
+  --json               Print the matches as JSON (for tools/agents).
   --api-url <url>      Override the API base URL.
+                       (No query at all lists the entire curated catalog.)
 
 ${c.bold("Global")}
   --quiet              Reduce output.
@@ -2036,6 +2037,7 @@ ${c.bold("Examples")}
   genex texture "mossy cracked cobblestone" --terrain
   genex controller character
   genex explore "grass"
+  genex explore
 `;
 function parseArgs(argv) {
   const parsed = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.22.0",
+  "version": "0.24.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

@@ -63,13 +63,18 @@ side — reads as broken at a glance.
 
 ## Load it into the scene
 
-Use Three.js `GLTFLoader` with the URL the command printed (R2 sends the right CORS
-headers, so cross-origin loading just works):
+Generated model GLBs are **meshopt-compressed** on the Genex servers before
+storage (same visuals, several times smaller — faster loads on every play).
+Wire the decoder once — it's harmless for uncompressed files — then use
+Three.js `GLTFLoader` with the URL the command printed (R2 sends the right
+CORS headers, so cross-origin loading just works):
 
 ```ts
 import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
+import { MeshoptDecoder } from "three/addons/libs/meshopt_decoder.module.js";
 
 const loader = new GLTFLoader();
+loader.setMeshoptDecoder(MeshoptDecoder); // required for genex model GLBs
 // the URL `npx genex model` printed:
 const MODEL_URL = "https://assets.genex.technology/generations/<id>/model-glb";
 const gltf = await loader.loadAsync(MODEL_URL);

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

@@ -23,6 +23,13 @@ Examples: `npx genex explore "grass"`, `npx genex explore "vehicle physics"`,
 `npx genex explore "procedural building"`. No sign-in needed — this works even
 before `genex init`.
 
+**Not sure what exists?** Run it with no arguments to browse the whole curated
+catalog first — it's small and every entry is proven:
+
+```bash
+npx genex explore
+```
+
 Each result prints everything you need to act on it:
 
 - `play:` — open it in the browser to judge whether it fits.
@@ -36,8 +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>` — choose
-   "Ignore files and continue" if it warns the folder isn't empty; never use
+2. `cd <name>`, then `npx @genex-ai/cli-demo@latest 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`.
@@ -64,6 +70,7 @@ build from one:
 - keep any in-game credits screens or notices in place;
 - carry the credit into anything you publish or remix from it.
 
-If nothing matches your query, try a broader term (terrain, grass, vehicle,
+If nothing matches your query, run `npx genex explore` with no arguments to
+see everything available, or try a broader term (terrain, grass, vehicle,
 water, building, dungeon, fish, shader) — or build it with the regular
 `genex-threejs-*` skills instead.

package/templates/skills/genex-threejs-embed-auth/SKILL.md

@@ -273,10 +273,13 @@ and a gate capture is NOT visual evidence.
 - Do NOT work around the gate: don't dig through the SDK's internals for
   undocumented URL fragments, and don't drive the user's own signed-in
   browser.
-- For the visual pass on a draft, hand it off plainly: "open your draft page
-  and tell me what you see" — the owner's view is the real check. Once the
-  game is **published**, any fresh browser gets in as a guest, so your own
-  test browser works again for full visual validation.
+- For the visual pass on a draft, the owner IS the QA loop — not a fallback:
+  push `genex preview` at each playable milestone and hand it off plainly
+  ("check the draft — you can now X; ping me if something feels off"), then
+  keep building while they look. Their run-around catches exactly what the
+  gate hides from you: facing, proportions, feel. Once the game is
+  **published**, any fresh browser gets in as a guest, so your own test
+  browser works again for full visual validation.
 
 ## Checklist
 

package/templates/skills/genex-threejs-vehicle-controllers/references/car.md

@@ -96,21 +96,32 @@ treat the player as drivable ground.
 ## Custom generated bodies (`npx genex model`)
 
 A generated GLB works as the visual chassis — add it under `car.chassisObject`
-exactly like `carBodyMesh` above. Two rules keep it looking right:
-
-- **Generate the body WITHOUT wheels** — prompt it explicitly, e.g.
-  `npx genex model "red sports car body, no wheels"`. Wheels are code-driven:
-  each `ShapeCastWheel` steers, bounces, and spins whatever sits in
-  `wheel.modelObject`, so wheels baked into the body mesh stand frozen while
-  the invisible real wheels do the work — it reads as a broken car.
-- **Wheel-less is a valid look.** The suspension shapecasts need no wheel
-  visuals at all: a body with empty `modelObject`s sits and drives correctly.
-  Add per-corner wheel meshes (the cylinder in the wiring above, or a small
-  generated wheel model) only when you want wheels visible.
-
-Scale and center the GLB to hug the chassis colliders, and mind the
-+Z-forward convention when orienting it. Collider strategy for GLBs lives in
-`$genex-threejs-physics-rapier`.
+exactly like `carBodyMesh` above. Generated car models arrive as ONE mesh with
+the wheels baked in (prompting "no wheels" does not reliably remove them) —
+that is the expected input. Three rules make it read right:
+
+- **Never add visible wheel meshes to a generated body.** Leave every
+  `wheel.modelObject` empty — the suspension shapecasts drive the body
+  correctly with no wheel visuals, and code wheels next to the baked-in ones
+  read as a six-wheeled monster truck. The baked wheels simply don't spin;
+  at game speed that's the accepted look. (The cylinder wheels in the wiring
+  above are for hand-built box-chassis cars only.)
+- **Fit the invisible wheels to the body, not the body to the preset.**
+  Scale the GLB by LENGTH toward the preset's footprint (body length ≈
+  wheelbase + 1.5 m; race-grip/muscle-drift wheelbase is 3.0 m, track
+  1.7 m) — never a min-axis bounding-box fit, which shrinks the body and
+  strands the wheel slots outside its silhouette. Then move the wheel slots
+  to the model's own wheel arches (from its bounding box: axles at roughly
+  ±0.33 × body length on z, x at ±(half width − 0.1)) and set
+  `rayShapeR`/`wheelModelRadius` so the body STANDS on the road — baked
+  tires touching the ground, nothing floating.
+- **Verify the facing before anything else.** +Z must be the nose:
+  generation regularly comes back rotated 180° (the classic "car drives
+  backward" bug) — apply the one-time yaw wrapper from `$genex-ai-model`,
+  then confirm in your smoke test that the NOSE leads under forward input.
+
+Center the GLB over the chassis colliders. Collider strategy for GLBs lives
+in `$genex-threejs-physics-rapier`.
 
 ## Presets and provenance
 

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

@@ -41,6 +41,12 @@ this is the whole acceptance gate, and it is also the minimum for every game:
    direction, and NPCs driven by chase/aim code face their target. A model
    rotated 90° reads as broken — `$genex-ai-model` has the one-time facing
    fix.
+5. Vehicles get one extra pass: drive forward once and confirm the NOSE
+   leads (a 180° body is this bug's favorite disguise), and check the body
+   stands ON the road with its wheels inside the silhouette — a body
+   floating above detached wheels means the model was box-fit against the
+   preset's wheelbase (the vehicle skill's "Custom generated bodies" rules
+   fix it).
 
 Everything deeper (baselines, seed sweeps, mosaics, budgets) belongs to
 visual-system work — the sequence above.