@genex-ai/cli-demo 0.71.0 → 0.74.0-dev.190

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

@@ -72,9 +72,17 @@ everything twice.
    skill's "Self-testing a draft" section) — so you see the game, not the
    sign-in gate.
 2. Press each documented control once (keys, pointer); assert a **visible
-   response** to every one — the player moves, the camera turns, the button
-   fires. For an animated character, capture idle, walk, run, crouch-idle,
-   crouch-move, and jump. Inspect shoulders, elbows, wrists, and hands as well
+   response in its labeled direction** — this is the input-direction pass, and
+   it is part of THIS check, not an extra testing loop. Hold `KeyD`/ArrowRight
+   ~0.5s and screenshot-diff: the controlled thing moves or turns toward
+   screen-RIGHT (for a pan camera the viewport slides right — the terrain
+   streams LEFT); `KeyA`/ArrowLeft mirrors it. Keyboard synthesis needs no
+   pointer lock, so this works headless. For drag rigs, drag right AND drag up:
+   both axes must follow the one stated convention (grab-the-world or
+   move-the-camera — never one each). A response in the WRONG direction is a
+   fail, not a note: two shipped games passed "controls respond" while D
+   steered screen-left. For an animated character, capture idle, walk, run,
+   crouch-idle, crouch-move, and jump. Inspect shoulders, elbows, wrists, and hands as well
    as the feet: a fully bound non-T-pose can still be stylistically broken.
    Reject shrugging palms-up poses, permanently raised elbows, or a gait whose
    upper-body style contradicts the requested character. “No T-pose” is not
@@ -104,16 +112,24 @@ everything twice.
    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).
-6. Aim games get one extra pass (MANDATORY bucket — first-person or mouse-aimed):
-   state which pointer bucket the game chose; click the canvas and assert the
-   pointer locks (cursor gone, mouse-RIGHT turns the view RIGHT — check the axis,
-   not just that it moves); press Esc and assert the "click to aim/resume" cue
-   appears. The cue should be the bundled `createAimCue` helper (or an equivalent
+6. The cursor pass — every game, per the lock-or-tool rule: during play the OS
+   cursor is either the gameplay tool (cursor-core — confirm the explicit
+   `pointerLockAim: false` opt-out, cursor stays) or it is LOCKED away; a
+   non-cursor-core game with the arrow parked over the action is a defect, even
+   a keyboard-only racer. Aim games additionally: click the canvas and assert
+   the pointer locks (cursor gone, mouse-RIGHT turns the view RIGHT and
+   mouse-UP looks UP — name BOTH axes; yaw-only evidence has let inverted pitch
+   ship); press Esc and assert the "click to aim/resume" cue appears. The cue
+   should be the bundled `createAimCue` helper (or an equivalent
    `onAimChange`-driven overlay) — a MANDATORY-bucket game with no unlocked cue
-   fails. Also confirm a cursor-core game opted OUT (`pointerLockAim: false`) so it
-   isn't grabbing the cursor. Headless caveat: `requestPointerLock` throws in
-   headless Chromium — assert the wiring and the unlocked cue in a screenshot, and
-   say plainly that the lock itself needs one manual click.
+   fails. Games with a menu additionally: on the main menu, click one item that
+   does NOT start play (Settings/Options/Credits) — the cursor must remain
+   visible; the lock may only ever engage from the Play/Resume click or a
+   gameplay canvas click (the phase binding `setPaused(phase !== "playing")` is
+   what guarantees this — check it rides `setPhase`, not the render loop).
+   Headless caveat: `requestPointerLock` throws in headless Chromium —
+   assert the wiring and the unlocked cue in a screenshot, and say plainly that
+   the lock itself needs one manual click (do the both-axes look check there).
 7. **Ask the scene the three things the screenshot cannot answer** (below). Run it
    once, in the same browser you already have open.
 
@@ -279,6 +295,14 @@ visual-system work — the sequence above.
 
 - a MANDATORY-bucket aim game never requests pointer lock, or locks with no
   visible unlocked cue;
+- a movement key or look axis whose on-screen direction contradicts its label
+  (D turning the vehicle screen-left, mouse-up looking down with no invert
+  option);
+- drag-pan axes that mix conventions (one axis grab-the-world, the other
+  move-the-camera);
+- a non-cursor-core game that leaves the OS cursor visible during play;
+- a menu or settings click locks the pointer (or the cursor vanishes) while a
+  menu screen is still up;
 - approval relies on a single frame;
 - post-processing cannot be disabled per pass;
 - random seeds are not reproducible;

package/templates/skills/genex-threejs-water-optics/references/water-optics.md

@@ -2,7 +2,7 @@
 
 Use this reference for bounded or analytic water with shared displacement and normals, derivative-filtered detail, analytic reflection, heuristic refraction, absorption, and crest foam. Use `$genex-threejs-spectral-ocean` for stochastic FFT seas.
 
-> **Renderer note:** this reference assumes `WebGPURenderer` + TSL node materials. Check the project's actual renderer first — the Genex scaffold ships vanilla WebGL three.js. On WebGL, adapt the technique with standard materials / `EffectComposer` passes or pick a simpler alternative; never switch renderers mid-project.
+> **Renderer note:** this reference assumes `WebGPURenderer` + TSL node materials. Check the project's actual renderer first — the Genex scaffold ships vanilla WebGL three.js. On WebGL, adapt the technique with standard materials / `EffectComposer` passes or pick a simpler alternative; never switch renderers mid-project. Either way the effect obeys the device tier (`$genex-threejs-adaptive-quality`): expensive passes are desktop-tier, and on WebGPU the per-target MSAA sample count is a runtime knob the governor may drive.
 
 ## Contents
 

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)
 ```