@genex-ai/cli-demo 0.68.0 → 0.70.0-dev.182

package/templates/skills/genex-threejs-skill-router/references/routing-map.md

@@ -180,7 +180,10 @@ Three.js release or branch, and do not blindly copy demo architecture.
    (`$genex-threejs-visual-validation` owns the capture discipline).
 7. Add camera direction when framing, controls, transitions, or scale perception
    affect play — or the game aims with the mouse (shooter/FPS/turret): the
-   step-4 bucket decision executes here.
+   step-4 bucket decision executes here. And before ANY hand-rolled
+   steering/pan/look math: the screen-direction contract (D → screen-right,
+   mouse-right → view right, drag axes one convention) with verified copy-paste
+   bases lives there — signs are copied, never derived.
 8. Add procedural animation when object motion needs authored phases,
    convergence, looping, or deterministic timelines.
 9. Add shared fields before writing multiple independent noise layers.
@@ -191,7 +194,11 @@ Three.js release or branch, and do not blindly copy demo architecture.
     step-4 post plan, not inventing one now. This is a completion gate: the
     named post stack must be BUILT before the game is called done, published,
     or handed off — a game rendering on stock three.js defaults is not done,
-    and the gate does not wait for the word "done" to be said.
+    and the gate does not wait for the word "done" to be said. The stack is
+    tier-gated (`$genex-threejs-adaptive-quality`): full on desktop, the built
+    tone-mapping pass + the tier's light additions on phones — wire the
+    governor's post toggle so phone tiers drop the heavy passes, never ship
+    them undropped.
 12. Once the loop is playable, build the planned interface states via
     `$genex-threejs-game-ui` (HUD, pause on Escape, fail/retry, win, and the
     full loading state grown from the step-6 loader), then `npx genex wait`
@@ -250,7 +257,7 @@ module — a corrupted entry point costs more than the minutes saved.
 
 **Game fast path:** for a game task that loaded no procedural/visual-system skill,
 done = a screenshot plus an interaction smoke check (load the page, press each
-control, assert a visible response — `$genex-threejs-visual-validation` has the
+control, assert a visible response in its labeled direction — `$genex-threejs-visual-validation` has the
 procedure), **plus the UI floor from `$genex-threejs-game-ui` (the generated
 sprite HUD wired in — not the CSS placeholder — pause on Escape, the branded
 loader with its key-art background, the brief's font pair actually loaded)
@@ -277,7 +284,11 @@ A routed Genex scene is incomplete until it exposes:
 - named perceptual parameters for the important visual systems;
 - debug views for generated fields, masks, or passes;
 - a no-post baseline that still communicates the subject;
-- a clear quality tier or render-budget knob when the effect is expensive;
+- a clear quality tier or render-budget knob when the effect is expensive —
+  and for every GAME, the adaptive-quality tier wired at boot
+  (`$genex-threejs-adaptive-quality`): tier-capped pixel ratio, tier shadow
+  budget, the runtime governor in the loop, and generated skybox/texture
+  loads routed through their rungs;
 - when physics or controllers are in play, a fixed-timestep loop: per-frame
   work (platforms, enter/exit, controller updates) runs inside the physics
   world's before-step hook, then the world steps — never in the render loop;
@@ -287,9 +298,12 @@ A routed Genex scene is incomplete until it exposes:
 
 **Publishing IS calling it done.** Before `npx genex publish`, every completion
 gate above must pass — sprite HUD wired, Escape pause working, branded loader
-with its key art, fonts loaded, renderer baseline + one built post effect,
-world dressing placed or validly waived, and the content contract's
-countables present or explicitly re-scoped by the user. If any is still
+with its key art, fonts loaded, renderer baseline + one built post effect
+(tier-aware), the adaptive-quality tier wired at boot, world dressing placed
+or validly waived, and the content contract's countables present or
+explicitly re-scoped by the user. `genex preview`/`publish` print a mobile
+preflight (estimated phone GPU memory vs budget) — treat a warning there as a
+gate item too. If any is still
 pending, say which and publish only after an explicit go-ahead.
 
 Do not invent unavailable Genex service APIs. When preparing a game for Genex

package/templates/skills/genex-threejs-spectral-ocean/references/spectral-ocean.md

@@ -2,7 +2,7 @@
 
 Use this reference for a large, unbounded-looking ocean whose identity comes from directional spectral synthesis, staged inverse FFTs, derivative maps, Jacobian whitecaps, and coherent optical shading.
 
-> **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-threejs-touch-controls/SKILL.md

@@ -75,6 +75,10 @@ Pick what matches the game; most games need exactly one or two of these.
   lives on the stick; the static circle is fine for slower games. On the
   bundled character controller, pass it through instead — see
   `$genex-threejs-character-controller` (`joystick: { x: joy.x, y: joy.y }`).
+  Touch axes obey the same screen-direction contract as WASD and the mouse
+  (`$genex-threejs-camera-direction`): stick-right must move the player
+  screen-right, drag-right must turn the view right — a flipped feel is a sign
+  bug in the mapping, never a device quirk.
 - **Camera look → drag zone on the right half.** Default `DragZone()` is
   exactly that; per frame `const { dx, dy } = look.consumeDelta()` then apply
   to yaw/pitch with the same sensitivity scale as the mouse path. Games on the
@@ -149,6 +153,13 @@ z-order stays: drag zone (5) under joystick/buttons (10) under pause menus.
   canvas. If the game also needs taps there (tap to shoot), read them from the
   zone (`onChange` + a small-movement threshold) or shrink the zone.
 
+## Input is half of phone-playable
+
+This skill is INPUT only. A phone that can steer a game that then runs out of
+GPU memory still loses the player — the rendering half (device tiers, DPR and
+shadow budgets, the runtime governor, per-tier asset rungs) lives in
+`$genex-threejs-adaptive-quality` and is wired at boot for every game.
+
 ## When you skip
 
 Say it in one plain line — *"skipped touch controls: the game is

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,19 @@ 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. 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 +290,12 @@ 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;
 - 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)
 ```