@genex-ai/cli-demo 0.7.0 → 0.10.0

package/templates/skills/genex-threejs-procedural-vegetation/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: genex-threejs-procedural-vegetation
-description: Generate procedural vegetation for Genex Three.js games. Use for trees, trunks, roots, recursive branches, canopies, leaf cards, grass clumps, species presets, deterministic variation, growth forces, wind deformation, and vegetation that supports navigation or scene readability.
+description: Generate procedural vegetation for Genex Three.js games. Use for trees, trunks, roots, recursive branches, canopies, leaf cards, stylized meadow grass, GPU-computed grass fields, grass clumps, species presets, deterministic variation, growth forces, rooted blade and leaf wind, wind deformation, and vegetation that supports navigation or scene readability.
 ---
 
 # Genex Three.js Procedural Vegetation
@@ -24,10 +24,20 @@ Represent a plant as a growth hierarchy plus rendering adaptations. Do not model
 
 Read [references/vegetation-systems.md](references/vegetation-systems.md) and preserve its preset, continuation, child-placement, leaf, material, wind, and composition contracts before tuning.
 
+## Grass fields
+
+Grass is either instanced blade clusters (per-instance origin, facing, and
+height, with circular-arc rooted wind that bends blades from the ground up) or
+GPU-generated blade fields (blades written in render targets with Voronoi clump
+variation, folded blade curvature, and distance-based density falloff). Both
+keep terrain height and clump identity as shared causes; scattering blades with
+uniform randomness produces lawn noise, not a meadow.
+
 ## Visual failure conditions
 
 - branches form visible helices;
 - every child emerges at the same relative height;
+- dense grass ignores terrain height or clump-level variation;
 - bark texture scale changes with branch radius;
 - leaves reveal flat card normals under rotation;
 - leaf wind moves card roots instead of remaining anchored;

package/templates/skills/genex-threejs-procedural-vfx/SKILL.md

@@ -35,5 +35,7 @@ spark/debris pools, HDR hierarchy, and implementation limits.
 ## Routing boundary
 
 Use `$genex-threejs-temporal-surfaces` only for the screen-space
-frost/touch-history pipeline. Keep ship-space plasma, generated wakes, sparks,
+frost/touch-history pipeline. Use `$genex-threejs-precipitation-surfaces` for
+falling rain or snow, splash flipbooks, and weather events that alter ground
+materials. Keep ship-space plasma, generated wakes, sparks,
 and pooled debris in this skill.

package/templates/skills/genex-threejs-shadow-systems/SKILL.md

@@ -19,11 +19,6 @@ Use a single shadow map only when its receiver region is genuinely bounded. For
 
 Read [references/shadow-systems.md](references/shadow-systems.md) before implementing a large-world directional light.
 
-Read the
-[cached shadow clipmaps](../threejs-procedural-architecture/examples/authored-financial-tower/shadow-clipmaps.js)
-for three light-space square levels, per-level texel snapping, containment
-cross-fades, cached coarse updates, scaled bias, and unshadowed outside weight.
-
 ## Failure conditions
 
 - projection centers move by fractions of a texel;

package/templates/skills/genex-threejs-skill-router/SKILL.md

@@ -20,13 +20,14 @@ map, execution order, and acceptance gate.
 | reusable scalar/vector fields, domain warping, causal masks, procedural normals | `$genex-threejs-procedural-fields` |
 | atlas-filtered blocks, planetary surfaces, terrain wetness, lava/emissive procedural surfaces, authored frame PBR, specular AA | `$genex-threejs-procedural-materials` |
 | sculpted rails/frames, branch rings, semantic mesh writers, material groups | `$genex-threejs-procedural-geometry` |
-| trees, stylized grass, branching organisms, roots, foliage, rooted wind deformation | `$genex-threejs-procedural-vegetation` |
+| trees, stylized grass, GPU-computed grass fields, branching organisms, roots, foliage, rooted wind deformation | `$genex-threejs-procedural-vegetation` |
 | buildings, façade grammars, profiles, ornaments, modular mesh writers | `$genex-threejs-procedural-architecture` |
 | planets, terrain, craters, biome fields, coastlines, spherical detail | `$genex-threejs-procedural-planets` |
 | sky scattering, planetary shells, depth-based aerial perspective | `$genex-threejs-atmosphere-aerial-perspective` |
 | weather-driven raymarched clouds and cloud shadows | `$genex-threejs-volumetric-clouds` |
 | FFT oceans, hybrid FFT/Gerstner clear water, stylized above/below ocean optics, spectral cascades, choppy derivatives, Jacobian whitecaps | `$genex-threejs-spectral-ocean` |
 | authored analytic waves, bounded heightfield pools, object ripples, differential-area caustics, ray-traced pool volume optics, shared normals, heuristic refraction, fallback absorption, crest foam | `$genex-threejs-water-optics` |
+| falling snow, snow accumulation, model snow caps, wet asphalt puddles, procedural ripple normals, splash flipbooks, rain streaks, shared weather envelopes, surface wetness | `$genex-threejs-precipitation-surfaces` |
 | curved-ray black holes, accretion disks, wormholes | `$genex-threejs-raymarched-space-effects` |
 | particles, trails, plasma, shockwaves, layered event effects | `$genex-threejs-procedural-vfx` |
 | accumulated screen frost, touch clearing, reduced blur, and refraction masks | `$genex-threejs-temporal-surfaces` |
@@ -36,11 +37,13 @@ map, execution order, and acceptance gate.
 | eye adaptation, tone mapping, LUT grading, output color | `$genex-threejs-exposure-color-grading` |
 | shared depth/normal/velocity ownership and multi-pass ordering | `$genex-threejs-image-pipeline` |
 | fixed-view diagnostics, seed sweeps, temporal and budget evidence | `$genex-threejs-visual-validation` |
-| realtime multiplayer: movement sync, shared state, presence, shots/emotes, persistence | `$genex-threejs-multiplayer` |
+| realtime multiplayer: movement sync, a shared ball/NPC, host-run scores/enemies, shots/emotes, persistence | `$genex-threejs-multiplayer` |
 
 **Multiplayer is mandatory routing:** if the game has 2+ players sharing a world, loading
-`$genex-threejs-multiplayer` is **required** before any networking code — the relay does no
-interpolation/prediction, and that skill is how you add them.
+`$genex-threejs-multiplayer` is **required** before any networking code — the SDK auto-smooths
+remote players **and shared objects**, and gives you server-enforced object ownership (a ball) and
+a room `host` (scores, enemies). That skill covers the rules that keep it smooth and its per-genre
+recipes (sports/ball, shooter, co-op).
 
 ## Real (AI-generated) assets — `npx genex` commands
 
@@ -48,7 +51,9 @@ When the user wants a **specific, recognizable asset** (a named object, a descri
 sky, a particular sound or surface) rather than something authored in code, generate
 it with an `npx genex` command (run inside the project, where the `@genex-ai/cli-demo`
 dev dependency makes `genex` resolve to the right CLI). Each drops a real file into
-`./assets/` (committed by `npx genex publish`), and its skill has the exact Three.js
+`public/assets/<kind>/` so it ships with the built game — load it at runtime as
+`./assets/...` (the `public/` prefix is stripped when served; a bare `./assets/` dir
+would be dropped from the production build). Each skill has the exact Three.js
 loader code.
 
 | Work needed | Generate with | Skill |

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

@@ -18,7 +18,7 @@ Three.js release or branch, and do not blindly copy demo architecture.
 1. Define the game contract: player verb, win/interaction loop, target device,
    camera distance, scene scale, motion, and frame budget.
 2. Select the minimum scene-generation skills: geometry, materials, vegetation,
-   architecture, planets, water, clouds, or VFX.
+   architecture, planets, water, precipitation, clouds, or VFX.
 3. Add camera direction when framing, controls, transitions, or scale perception
    affect play.
 4. Add procedural animation when object motion needs authored phases,
@@ -54,8 +54,11 @@ publishing or multiplayer, inspect the project first. Prefer clean boundaries:
 
 **Multiplayer is mandatory routing.** If the game has 2+ players sharing a world,
 load `$genex-threejs-multiplayer` **before writing any networking code** — it is not
-optional. The `@genex-ai/multiplayer` relay syncs `me`/`shared` but does **no**
-physics, prediction, or interpolation; that skill is how you add interpolation for
-remote players, prediction for the local player, config wiring, and (for save-state
-games) the persistent-world API. Use only the APIs that skill documents — do not
-invent transport methods.
+optional. The `@genex-ai/multiplayer` relay syncs `me`/`shared`/`objects`; the **SDK
+auto-smooths remote players AND shared objects** for you (do not write your own
+interpolation). It gives you server-enforced primitives — `objects` (one owner per ball/
+NPC, claimed on contact) and a room `host` (single writer of scores, single simulator of
+enemies). That skill covers the rules that keep it smooth (draw `state` directly, render
+yourself and objects you own from a local object, quaternion rotation, `stateRaw` for
+hit-tests), the per-genre recipes (sports/ball, shooter, co-op), config wiring, and the
+persistent-world API. Use only the APIs that skill documents — do not invent transport methods.

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

@@ -1,6 +1,6 @@
 ---
 name: genex-threejs-spectral-ocean
-description: Build large procedural oceans for Genex Three.js games. Use for FFT-style wave spectra, multi-cascade wave bands, choppy displacement, derivatives, whitecaps, temporal foam, ocean shading, camera-scale transitions, and GPU-budgeted open-water scenes.
+description: Build large procedural oceans for Genex Three.js games. Use for FFT-style wave spectra, multi-cascade wave bands, hybrid FFT plus Gerstner clear water, stylized above/below-surface ocean optics, choppy displacement, derivatives, Jacobian whitecaps, temporal foam, underwater absorption, crest scatter, ocean shading, camera-scale transitions, and GPU-budgeted open-water scenes.
 ---
 
 # Genex Three.js Spectral Ocean
@@ -22,6 +22,16 @@ Treat an ocean as a sampled stochastic wave field with explicit frequency-space
 
 Read [references/spectral-ocean.md](references/spectral-ocean.md) before implementing or auditing a spectral ocean.
 
+## Hybrid and stylized variants
+
+For clear shallow water, a hybrid ocean may add a few authored Gerstner swells on
+top of the FFT cascades — never instead of them — with Beer–Lambert depth color,
+sand-bed caustics, and sharp sun highlights. A stylized ocean meant to be seen
+from above and below can drive color from height gradients, add sun-path glints
+and crest scatter, and composite an underwater Beer–Lambert tint from scene
+depth. Both variants keep the spectral core, its derivatives, and Jacobian foam
+as the single source of surface truth.
+
 ## Non-negotiable gates
 
 - Require a power-of-two grid and a passing FFT impulse/frequency test.

package/templates/skills/genex-threejs-temporal-surfaces/SKILL.md

@@ -36,4 +36,6 @@ coupling, and implementation defects that must be corrected.
 ## Routing boundary
 
 Use `$genex-threejs-procedural-vfx` for world- or object-space residue, particles, and
-dissolves. This skill owns screen-space persistent history and its composite.
+dissolves. Use `$genex-threejs-precipitation-surfaces` for rain wetness, puddles,
+snow accumulation, and weather-surface coupling in world space. This skill owns
+screen-space persistent history and its composite.

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

@@ -1,6 +1,6 @@
 ---
 name: genex-threejs-water-optics
-description: Build analytic water surfaces for Genex Three.js games. Use for rivers, pools, lakes, shoreline water, shared wave displacement, normals, Fresnel, refraction, absorption, crest foam, underwater color, and cheaper water than a full spectral ocean.
+description: Build analytic water surfaces for Genex Three.js games. Use for rivers, pools, lakes, shoreline water, bounded heightfield pool simulation, object-driven ripples, differential-area caustics, ray-traced pool volume optics, shared wave displacement, normals, Fresnel, refraction, absorption, crest foam, underwater color, and cheaper water than a full spectral ocean.
 ---
 
 # Genex Three.js Water Optics
@@ -25,6 +25,16 @@ Read [references/water-optics.md](references/water-optics.md)
 for the exact five-wave displaced ocean, six-band normal-only water, optical
 hierarchy, and the limits that distinguish both from the spectral-ocean skill.
 
+## Bounded pool volumes
+
+A bounded pool couples a small RGBA heightfield simulation (height and velocity,
+with local drop injection and moving-object displacement) with the optical
+layer: normals derive from the simulated heights and feed differential-area
+caustics on the pool floor, and the water volume is shaded by ray-tracing
+against the pool bounds. Keep the simulation, the normal derivation, and the
+caustics reading the same field — a caustic pattern detached from the simulated
+surface is a failure condition below.
+
 ## Failure conditions
 
 - normal texture motion does not agree with displaced crests;
@@ -40,6 +50,8 @@ hierarchy, and the limits that distinguish both from the spectral-ocean skill.
 ## Routing boundary
 
 Use `$genex-threejs-spectral-ocean` for stochastic directional spectra, FFT
-cascades, Jacobian breaking, and persistent ocean foam. This skill owns
+cascades, Jacobian breaking, and persistent ocean foam. Use
+`$genex-threejs-precipitation-surfaces` for rain-driven puddle wetness, ripple
+masks, and weather-coupled splashes on ground surfaces. This skill owns
 authored analytic waves, bounded heightfield simulation, ray-traced
 pool-volume optics, and bounded-water optics.