@genex-ai/cli-demo 0.23.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.`

package/package.json

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