@genex-ai/cli-demo 0.58.0-dev.132 → 0.59.0-dev.133

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.58.0-dev.132",
+  "version": "0.59.0-dev.133",
   "description": "Set up your ~/.claude workspace, authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/controllers/character/character-animations.ts

@@ -351,6 +351,7 @@ export class CharacterAnimations {
   // Every provided clip by name — lets playOneShot reach clips beyond the 9
   // locomotion states (any installed pack clip: Punch_*, Sword_*, Sitting_*…).
   #clipsByName = new Map<string, THREE.AnimationClip>();
+  #missingOneShotWarnings = new Set<string>();
   #oneShotAction: THREE.AnimationAction | null = null;
   #locomotionOneShotAction: THREE.AnimationAction | null = null;
   #oneShotOnDone: (() => void) | undefined;
@@ -615,7 +616,13 @@ export class CharacterAnimations {
   playOneShot(clipName: string, options: PlayOneShotOptions = {}): boolean {
     if (this.#disposed) return false;
     const clip = this.#clipsByName.get(clipName);
-    if (!clip) return false;
+    if (!clip) {
+      if (!this.#missingOneShotWarnings.has(clipName)) {
+        this.#missingOneShotWarnings.add(clipName);
+        console.warn(`[character-animations] one-shot clip "${clipName}" is not installed; playOneShot() returned false.`);
+      }
+      return false;
+    }
 
     const action = this.mixer.clipAction(clip);
 

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

@@ -139,7 +139,7 @@ export function resolveMeshyLocomotion(
 }
 
 export async function loadMeshyCharacter(manifestUrl: string): Promise<MeshyCharacter> {
-  const response = await fetch(manifestUrl);
+  const response = await fetch(manifestUrl, { cache: "no-store" });
   if (!response.ok) throw new Error(`[meshy-character] ${manifestUrl} returned HTTP ${response.status}`);
   const manifest = validateManifest(await response.json());
   const loader = new GLTFLoader();

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

@@ -17,7 +17,9 @@ npx genex character "stylized desert courier, practical layered clothing"
 ```
 
 The default request uses Meshy 6 to generate and texture an A-pose humanoid,
-remeshes and rigs it, adds the preview-reviewed neutral-v2
+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
 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
@@ -75,6 +77,12 @@ animation job completes, rerun `genex controller character --character <id>`
 to refresh `public/assets/meshy-character.json`; existing controller source is
 preserved unless `--force` is explicitly used.
 
+Meshy manifests bypass browser cache, so newly installed actions must work
+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.
+
 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

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

@@ -45,6 +45,11 @@ dynamic controller stays authoritative for collision, grounding, facing, and
 world translation. The animation layer poses the visual rig; it never
 translates the visual root.
 
+Meshy manifests bypass browser cache, so newly installed actions must work
+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.
+
 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.
 

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

@@ -47,8 +47,13 @@ everything twice.
    fires. 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
+   an animation-quality check.
    For Meshy characters, crouch passes only when the capsule behavior and a
-   visibly crouched pose both respond.
+   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.
 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