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

package/package.json

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