@genex-ai/cli-demo 0.60.0 → 0.62.0-dev.143

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.60.0",
+  "version": "0.62.0-dev.143",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/controllers/character/meshy/meshy-loader.ts

@@ -12,6 +12,7 @@ export type MeshyMotionPolicy =
 export type MeshyLocomotionBindingMode = "loop" | "one-shot" | "pose";
 
 export interface MeshyLocomotionBinding {
+  actionId?: number;
   clip: string;
   mode: MeshyLocomotionBindingMode;
   phase?: number;
@@ -23,7 +24,20 @@ export interface MeshyCharacterManifest {
   revision: number;
   manifestVersion: number;
   rig: "meshy-biped";
-  controllerPack?: { key: string; version: number };
+  controllerPack?: {
+    key: string;
+    version: number;
+    fingerprint?: string;
+    actionIds?: number[];
+  };
+  provenance?: {
+    provider: "meshy";
+    aiModel: "meshy-6";
+    apiVersion?: string;
+    poseMode: "a-pose" | "t-pose";
+    shouldRemesh: boolean;
+    targetPolycount: number;
+  };
   model: {
     url: string;
     heightMeters: number | null;

package/templates/skills/genex-ai-character/SKILL.md

@@ -16,10 +16,12 @@ crossfades, transition rules, and multiplayer authority contract.
 npx genex character "stylized desert courier, practical layered clothing"
 ```
 
-The default request uses Meshy 6 to generate and texture an A-pose humanoid,
-validates the rig's arm pose, and retries the full generation once in a strict
-T-pose before requesting controller-pack animations when the A-pose is invalid.
-It remeshes and rigs the accepted model, adds the preview-reviewed neutral-v2
+The default request uses Meshy 6 to generate, texture, remesh, and rig an
+A-pose humanoid. It generates the required controller-pack actions for that
+candidate and rejects bad structural or native motion instead of repairing it.
+If any required check fails, it retries the complete workflow once in a strict
+T-pose; optional actions start only after a full candidate passes. It remeshes
+and rigs the accepted model, adds the immutable preview-reviewed neutral-v3
 idle/walk/run/crouch/jump controller pack,
 and stores every successful model
 and clip at permanent Genex asset URLs. It prints the complete Genex-credit
@@ -83,6 +85,17 @@ after preview without asking the player to disable cache.
 `playOneShot()` returns false and emits one warning when a requested clip is
 absent; treat that as an installation failure, not a successful action.
 
+Meshy limb rotations are played unchanged. Never freeze hand tracks or apply
+post-mixer arm, leg, or foot corrections. A bad native rig or clip must be
+rejected and regenerated. Only horizontal root/hip translation is normalized
+so Rapier remains authoritative.
+
+A controller pack is an immutable exact action set. If a required binding is
+absent, installation fails instead of substituting Meshy's rig-basic Walking
+or Running animation. During Meshy validation, record the action ID actually
+bound to every slot. A public preview is not evidence when the game is playing
+a different clip or a rig-basic fallback.
+
 Load `$genex-threejs-character-controller` for the actual wiring. The install
 command copies the shared controller plus `character/meshy/meshy-loader.ts`.
 The manifest points at the current rigged model and compact animation-only GLBs
@@ -93,6 +106,8 @@ durations, nominal speeds, trajectories, and gameplay requirements.
 
 - Meshy clips play only on the exact character revision whose skeleton
   signature matches. There is no runtime retargeting in this lane.
+- Do not repair hands, arms, or legs at runtime. Verify the installed manifest's
+  exact slot-to-action mappings; stop and regenerate when a native pose is bad.
 - Rapier owns the player transform. Animation tracks are normalized
   horizontally in place; never move the rendered character root separately.
 - `controller-loop` clips follow controller-local intent and measured speed.

package/templates/skills/genex-ai-hud/SKILL.md

@@ -409,7 +409,7 @@ after a bad single costs the whole chain).
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it
   writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the
   prompt. Non-retryable; rewrite the wording.

package/templates/skills/genex-ai-image/SKILL.md

@@ -194,7 +194,7 @@ set belongs to `$genex-ai-hud` — both build on this command.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the prompt.
   This is non-retryable; retrying the same wording fails again. Rewrite the prompt.
 - **Decal is an opaque rectangle** — the image has no alpha. Regenerate with

package/templates/skills/genex-ai-menu/SKILL.md

@@ -321,7 +321,7 @@ upgrades, in order of effort:
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it
   writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the
   prompt. Non-retryable; rewrite the wording.

package/templates/skills/genex-ai-model/SKILL.md

@@ -107,7 +107,7 @@ scene is a ghost: players and objects pass straight through it.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this model generation. Tell the user the facts the CLI printed: their balance, this
   generation's cost, and when their credits refill. Then offer to continue the build

package/templates/skills/genex-ai-sfx/SKILL.md

@@ -72,7 +72,7 @@ Reuse one loaded `buffer` across many plays; create a fresh `Audio`/`PositionalA
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this sound generation. Tell the user the facts the CLI printed: their balance, this
   generation's cost, and when their credits refill. Then offer to continue the build

package/templates/skills/genex-ai-skybox/SKILL.md

@@ -76,7 +76,7 @@ scene.background = texture; // keep the raw texture for the visible sky
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this skybox generation. Tell the user the facts the CLI printed: their balance, this
   generation's cost, and when their credits refill. Then offer to continue the build

package/templates/skills/genex-ai-texture/SKILL.md

@@ -225,7 +225,7 @@ first one is the one a screenshot of the whole arena will not show you.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this texture generation. Tell the user the facts the CLI printed: their balance,
   this generation's cost, and when their credits refill. Then offer to continue the

package/templates/skills/genex-ai-video/SKILL.md

@@ -145,7 +145,7 @@ set belongs to `$genex-ai-hud` — both build on `npx genex image`/`video`.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the prompt.
   This is non-retryable; retrying the same wording fails again. Rewrite the prompt.
 - **Nothing plays / black surface** — the first `video.play()` must run inside a user

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

@@ -43,7 +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>` — never use
+2. `cd <name>`, then `npx @genex-ai/cli-demo@dev 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`.

package/templates/skills/genex-getting-started/SKILL.md

@@ -130,7 +130,7 @@ and re-link the clone to the same live game:
 ```bash
 git clone <the game's repo url> my-game && cd my-game
 npm install
-npx @genex-ai/cli-demo@latest link <slug>   # slug = the name in the play URL
+npx @genex-ai/cli-demo@dev link <slug>   # slug = the name in the play URL
 ```
 
 Don't know the slug? **`npx genex list`** prints every game on your account —
@@ -157,7 +157,7 @@ Safe to run any time — genex-owned skills are refreshed to the latest version,
 and your own files are never touched:
 
 ```bash
-npx @genex-ai/cli-demo@latest init
+npx @genex-ai/cli-demo@dev init
 ```
 
 Use `--force` only if you intentionally want your own existing files overwritten

package/templates/skills/genex-threejs-character-controller/SKILL.md

@@ -50,6 +50,13 @@ after preview without asking the player to disable cache. `playOneShot()`
 returns false and emits one warning when a requested clip is absent; treat
 that as an installation failure, not a successful action.
 
+Meshy limb rotations are played unchanged. Never freeze hand tracks or apply
+post-mixer arm, leg, or foot corrections. A bad native rig or clip must be
+rejected and regenerated. Only horizontal root/hip translation is normalized
+so Rapier remains authoritative. A controller pack is an immutable exact
+action set: if a required binding is absent, installation fails instead of
+substituting Meshy's rig-basic Walking or Running animation.
+
 Because these files are game-owned, never run `genex controller character --force` over an edited
 fork as a migration strategy. Install a fresh copy elsewhere and port only the named changes.
 
@@ -200,6 +207,10 @@ slots, fallbacks, and cadence data. UAL clips still land in
 genre hints, `playOneShot` options, overrides, foot IK, and remote-player
 animation.
 
+For Meshy characters, do not repair hands, arms, or legs at runtime. Verify
+that the installed manifest binds the expected action IDs; if a native pose
+is bad or a required binding is missing, stop and regenerate the character.
+
 ## Crouch (built in)
 
 `C` toggles crouch (capsule shrinks, speed drops to `crouchSpeedRatio ×

package/templates/skills/genex-threejs-character-controller/references/animations.md

@@ -110,6 +110,11 @@ const anims = new CharacterAnimations(native.scene, native.clips, {
 });
 ```
 
+During Meshy validation, record the action ID actually bound to every slot.
+A public preview is not evidence when the game is playing a different clip or
+a rig-basic fallback. The native loader plays every limb quaternion unchanged;
+never freeze hand tracks or add post-mixer arm, leg, or foot corrections.
+
 The loader rejects clips whose manifest skeleton signature differs from the
 current model revision or whose tracks target missing bones. This is deliberate
 same-rig playback, not runtime retargeting. After adding an action, rerun the

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

@@ -54,6 +54,10 @@ everything twice.
    visibly crouched pose both respond. If a control calls `playOneShot()`, a
    false result or missing-clip warning is an installation failure even when
    locomotion continues normally.
+   During Meshy validation, record the action ID actually bound to every slot.
+   A public preview is not evidence when the game is playing a different clip
+   or a rig-basic fallback. Do not repair hands, arms, or legs at runtime: if a
+   native pose is bad or a required binding is missing, stop and regenerate.
 3. Capture one screenshot of live gameplay — of the **game**, not a sign-in
    gate or loading screen. A capture of the SDK's "Sign in to play" overlay is
    NOT gameplay evidence. Evidence captured in local test mode must be labeled

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