@helix3/helix-cli 0.1.18-helix3.265 → 0.1.18-helix3.266

package/bridge-plugins/helix.bridge.unreal/bin/unreal-skeletal-mesh-extract.js

@@ -22,6 +22,15 @@ const PROFILE_SET_SCHEMA = 'helix.bridge.unreal-asset-set/1';
 const CAPABILITY = 'unreal.project.extract';
 const MAX_PROFILE_BYTES = 64 * 1024;
 const MAX_PROJECT_ENTRIES = 100_000;
+// Mirrors src/bridge/detect.ts's DIRECTORY_EXCLUDES (kept in sync by hand: this plugin script
+// runs standalone via `spawn`, not through the built CLI, so it cannot import that module).
+// Binaries/Intermediate/Saved/DerivedDataCache are large, regenerable Unreal build/cache
+// directories that never contain a .uproject and were the reason a real project (hundreds of
+// GB of Perforce-synced Engine + build caches) blew straight through the entry-count limit
+// below without ever reaching the actual project file.
+const PROJECT_WALK_EXCLUDES = new Set([
+  '.git', 'node_modules', 'Intermediate', 'Saved', 'DerivedDataCache', 'Library', '.godot', 'Binaries',
+]);
 const LOG_TAIL_BYTES = 16 * 1024;
 const FBX_HEADER_BYTES = 1024;
 const FBX_BINARY_HEADER = Buffer.from('Kaydara FBX Binary  \0\x1a\0', 'binary');
@@ -230,7 +239,7 @@ function findProject(sourcePath) {
       const path = join(directory, entry.name);
       if (entry.isSymbolicLink()) fail(`Unreal project snapshot contains a symlink: ${path}`);
       if (entry.isDirectory()) {
-        pending.push(path);
+        if (!PROJECT_WALK_EXCLUDES.has(entry.name)) pending.push(path);
       } else if (entry.isFile() && extname(entry.name).toLowerCase() === '.uproject') {
         projects.push(path);
       }

package/bridge-plugins/helix.bridge.unreal/test/handler.test.js

@@ -255,3 +255,20 @@ test('requires exactly one uproject in the immutable source snapshot', () => {
   assert.equal(result.status, 1);
   assert.match(result.stderr, /exactly one \.uproject file; found 2/);
 });
+
+test('does not walk into Binaries/Intermediate/Saved/DerivedDataCache when finding the .uproject', () => {
+  const entry = fixture();
+  // A real Perforce-synced Unreal project's build/cache directories can hold hundreds of
+  // thousands of files; simulate that here with just enough entries (and a decoy .uproject
+  // inside one of them) to prove the walk skips them entirely rather than merely tolerating them.
+  for (const excluded of ['Binaries', 'Intermediate', 'Saved', 'DerivedDataCache']) {
+    const dir = join(entry.project, excluded, 'Nested');
+    mkdirSync(dir, { recursive: true });
+    for (let i = 0; i < 10; i += 1) writeFileSync(join(dir, `junk-${i}.bin`), '');
+  }
+  writeFileSync(join(entry.project, 'Intermediate', 'Decoy.uproject'), '{}');
+  const result = run(entry);
+  assert.equal(result.status, 0, result.stderr);
+  const response = JSON.parse(result.stdout);
+  assert.equal(response.artifacts[0].kind, 'format.fbx');
+});

package/bridge-recipes/unreal/helix-character-creator-female/README.md

@@ -0,0 +1,57 @@
+# HELIX Character Creator Female
+
+Female mirror of `helix-character-creator-male/`: curated Unreal asset profiles for the
+canonical HELIX Base Female and one representative wearable for every supported customizer
+slot, scaffolded 2026-09-26 by the wearables-import research pass
+(`/Users/jack/Developer/helix-workspace/run/open-alpha-qa/wearables-import/inventory.md`).
+
+The profiles expect the `/HelixCharacterCreator` plugin mount, same as the male directory. Run
+these through the packaged `helix.bridge.unreal` adapter: `--type character` for the base body/
+face, `--type addon --input host=... --input addon=...` for wearables.
+
+**Published compatibility host: Universal Item `bcafa7e1-9487-422d-8c08-e152b81f1f45`** ("Base
+Female", creator `testcreator`, package v1.2.0, Face V1, published but not on the public
+marketplace list — no marketplaceDistributions, same orphan-publish pattern as HELIX Starter and
+Male Cargo Bottom, so it will not surface from a normal marketplace search).
+
+Every `*.addon.json` profile is bound to that host twice, mirroring the male pattern exactly:
+`hostItemId` selects `bcafa7e1-9487-422d-8c08-e152b81f1f45`, while `hostSha256` must equal the
+bytes of the host GLB. **That GLB's sha256 was independently downloaded and re-hashed for this
+scaffold** (not taken on trust from the reporting agent):
+
+```
+curl -sL -o female-base.glb "https://eu.uni-items-web.dev.helix-cdn.com/universal-items/bcafa7e1-9487-422d-8c08-e152b81f1f45/bce4c302-7d1e-4360-99c1-d5c2972dfc6e/web/female-base.web.glb"
+shasum -a 256 female-base.glb
+# 8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760  (1,789,588 bytes, valid glTF-binary v2)
+```
+
+**Known metadata bug, not fixed here:** the Universal Item API's own `sizeBytes` field for this
+asset reports `753656`, which does not match the actual downloaded byte count (1,789,588) or a
+real GLB parse. Use the sha256 above, measured from the actual bytes, not anything derived from
+that stale field. Worth a bug report against whatever wrote that metadata.
+
+Each `<slot>.json` here names one confirmed (`find`-verified, not guessed) representative female
+asset per slot, picked from the full 220-item wearable survey in `inventory.md`:
+
+| Slot | Representative | Unreal source |
+| --- | --- | --- |
+| top | Female Basic Tee | `Characters/Clothes/Woman/W_Basic_T_Shirt/W_Basic_T_Shirt` |
+| bottom | Female Cargo Bottom | `Characters/Clothes/Woman/W_Cargo_Pants/W_Cargo_Pants` |
+| footwear | Female Chunky Knit Sneakers | `Characters/Clothes/Woman/Chunky_Knit_Sneakers/SKM_W_Chunky_Knit_Sneakers` |
+| gloves | Female NEO Arcane Heir Gloves | `Characters/Clothes/Woman/NEO_Arcane_Heir_Gloves/SKM_W_NEO_Arcane_Heir_Gloves` |
+| mask | Female Cyberpunk ONI Mask | `Characters/Clothes/Woman/Cyberpunk_ONI_Mask/SKM_W_Cyberpunk_ONI_Mask` |
+| headwear | Female Cap | `Characters/Clothes/Woman/W_Cap/W_Cap` |
+| eyewear | Female Sport Sunglasses | `Characters/Clothes/Woman/Sport_Sunglasses/SKM_W_Sport_Sunglasses` |
+| neck | Female Chain | `Characters/Clothes/Woman/W_Chain/SK_W_Chain` |
+| back | Female Black Bag | `Characters/Clothes/Woman/W_BlackBag/W_BlackBag_skinning` |
+| hair | Female Hair A1 | `Characters/Hairs/Female/Hair_A1/SK_Hair_A1_F` |
+| outfit | Female Firefight Outfit | `Characters/Clothes/Woman/SK_W_Firefight_Outfit/SK_W_Firefight_Outfit_skinning` |
+
+`female-cap.addon.json` carries the same `technical-fabric-ripstop` palette family forced on
+`male-cap.addon.json`, for visual-review parity with the Palette Pilot batch — change it if the
+pilot phase wants a different reviewed family for the female cap.
+
+None of these files have been run through `bridge import` yet — they are unexecuted scaffolding
+only, mirroring the shape of the male recipes exactly. The pilot phase should smoke-test
+`all.json` first (13-asset batch, same shape as the male `all.json`), then work through the
+remaining ~219 female/male to-do items in `inventory.md` following this same pattern.

package/bridge-recipes/unreal/helix-character-creator-female/all.json

@@ -0,0 +1,18 @@
+{
+  "schemaVersion": "helix.bridge.unreal-asset-set/1",
+  "assets": [
+    { "slug": "base-female", "assetPath": "/HelixCharacterCreator/MetaHumans/Characters/F_Default/MC_Test/Body/SKM_MC_Female_Default_BodyMesh", "exportMorphTargets": true },
+    { "slug": "base-female-face", "assetPath": "/HelixCharacterCreator/MetaHumans/Characters/F_Default/MC_Test/Face/SKM_MC_Female_Default_FaceMesh", "exportMorphTargets": true },
+    { "slug": "female-basic-tee", "assetPath": "/HelixCharacterCreator/Characters/Clothes/Woman/W_Basic_T_Shirt/W_Basic_T_Shirt", "exportMorphTargets": true },
+    { "slug": "female-cargo-bottom", "assetPath": "/HelixCharacterCreator/Characters/Clothes/Woman/W_Cargo_Pants/W_Cargo_Pants", "exportMorphTargets": true },
+    { "slug": "female-chunky-knit-sneakers", "assetPath": "/HelixCharacterCreator/Characters/Clothes/Woman/Chunky_Knit_Sneakers/SKM_W_Chunky_Knit_Sneakers", "exportMorphTargets": true },
+    { "slug": "female-neo-arcane-heir-gloves", "assetPath": "/HelixCharacterCreator/Characters/Clothes/Woman/NEO_Arcane_Heir_Gloves/SKM_W_NEO_Arcane_Heir_Gloves", "exportMorphTargets": true },
+    { "slug": "female-cyberpunk-oni-mask", "assetPath": "/HelixCharacterCreator/Characters/Clothes/Woman/Cyberpunk_ONI_Mask/SKM_W_Cyberpunk_ONI_Mask", "exportMorphTargets": true },
+    { "slug": "female-cap", "assetPath": "/HelixCharacterCreator/Characters/Clothes/Woman/W_Cap/W_Cap", "exportMorphTargets": true },
+    { "slug": "female-sport-sunglasses", "assetPath": "/HelixCharacterCreator/Characters/Clothes/Woman/Sport_Sunglasses/SKM_W_Sport_Sunglasses", "exportMorphTargets": true },
+    { "slug": "female-chain", "assetPath": "/HelixCharacterCreator/Characters/Clothes/Woman/W_Chain/SK_W_Chain", "exportMorphTargets": true },
+    { "slug": "female-black-bag", "assetPath": "/HelixCharacterCreator/Characters/Clothes/Woman/W_BlackBag/W_BlackBag_skinning", "exportMorphTargets": true },
+    { "slug": "female-hair-a1", "assetPath": "/HelixCharacterCreator/Characters/Hairs/Female/Hair_A1/SK_Hair_A1_F", "exportMorphTargets": true },
+    { "slug": "female-firefight-outfit", "assetPath": "/HelixCharacterCreator/Characters/Clothes/Woman/SK_W_Firefight_Outfit/SK_W_Firefight_Outfit_skinning", "exportMorphTargets": true }
+  ]
+}

package/bridge-recipes/unreal/helix-character-creator-female/back.addon.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge-character-addon-profile/1","title":"Female Black Bag","slug":"female-black-bag","hostItemId":"bcafa7e1-9487-422d-8c08-e152b81f1f45","hostSha256":"8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760","slotType":"character.back@1","socket":"back","nodes":[],"ops":[]}

package/bridge-recipes/unreal/helix-character-creator-female/back.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"female-black-bag","assetPath":"/HelixCharacterCreator/Characters/Clothes/Woman/W_BlackBag/W_BlackBag_skinning","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/base-female-face.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"base-female-face","assetPath":"/HelixCharacterCreator/MetaHumans/Characters/F_Default/MC_Test/Face/SKM_MC_Female_Default_FaceMesh","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/base-female.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"base-female","assetPath":"/HelixCharacterCreator/MetaHumans/Characters/F_Default/MC_Test/Body/SKM_MC_Female_Default_BodyMesh","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/bottom.addon.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge-character-addon-profile/1","title":"Female Cargo Bottom","slug":"female-cargo-bottom","hostItemId":"bcafa7e1-9487-422d-8c08-e152b81f1f45","hostSha256":"8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760","slotType":"character.bottom@1","socket":"chest","nodes":[],"ops":[]}

package/bridge-recipes/unreal/helix-character-creator-female/bottom.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"female-cargo-bottom","assetPath":"/HelixCharacterCreator/Characters/Clothes/Woman/W_Cargo_Pants/W_Cargo_Pants","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/eyewear.addon.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge-character-addon-profile/1","title":"Female Sport Sunglasses","slug":"female-sport-sunglasses","hostItemId":"bcafa7e1-9487-422d-8c08-e152b81f1f45","hostSha256":"8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760","slotType":"character.eyewear@1","socket":"head","nodes":[],"ops":[]}

package/bridge-recipes/unreal/helix-character-creator-female/eyewear.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"female-sport-sunglasses","assetPath":"/HelixCharacterCreator/Characters/Clothes/Woman/Sport_Sunglasses/SKM_W_Sport_Sunglasses","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/footwear.addon.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge-character-addon-profile/1","title":"Female Chunky Knit Sneakers","slug":"female-chunky-knit-sneakers","hostItemId":"bcafa7e1-9487-422d-8c08-e152b81f1f45","hostSha256":"8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760","slotType":"character.footwear@1","socket":"chest","nodes":[],"ops":[]}

package/bridge-recipes/unreal/helix-character-creator-female/footwear.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"female-chunky-knit-sneakers","assetPath":"/HelixCharacterCreator/Characters/Clothes/Woman/Chunky_Knit_Sneakers/SKM_W_Chunky_Knit_Sneakers","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/gloves.addon.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge-character-addon-profile/1","title":"Female NEO Arcane Heir Gloves","slug":"female-neo-arcane-heir-gloves","hostItemId":"bcafa7e1-9487-422d-8c08-e152b81f1f45","hostSha256":"8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760","slotType":"character.gloves@1","socket":"chest","nodes":[],"ops":[]}

package/bridge-recipes/unreal/helix-character-creator-female/gloves.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"female-neo-arcane-heir-gloves","assetPath":"/HelixCharacterCreator/Characters/Clothes/Woman/NEO_Arcane_Heir_Gloves/SKM_W_NEO_Arcane_Heir_Gloves","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/hair.addon.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge-character-addon-profile/1","title":"Female Hair A1","slug":"female-hair-a1","hostItemId":"bcafa7e1-9487-422d-8c08-e152b81f1f45","hostSha256":"8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760","slotType":"character.hair@1","socket":"head","nodes":[],"ops":[]}

package/bridge-recipes/unreal/helix-character-creator-female/hair.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"female-hair-a1","assetPath":"/HelixCharacterCreator/Characters/Hairs/Female/Hair_A1/SK_Hair_A1_F","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/headwear.addon.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge-character-addon-profile/1","title":"Female Cap","slug":"female-cap","hostItemId":"bcafa7e1-9487-422d-8c08-e152b81f1f45","hostSha256":"8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760","slotType":"character.headwear@1","socket":"head","nodes":[],"palette":{"action":"forceFamilyId","familyId":"technical-fabric-ripstop","familyVersion":"1.0.0","presetId":"clean","overrides":{}},"ops":[]}

package/bridge-recipes/unreal/helix-character-creator-female/headwear.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"female-cap","assetPath":"/HelixCharacterCreator/Characters/Clothes/Woman/W_Cap/W_Cap","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/mask.addon.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge-character-addon-profile/1","title":"Female Cyberpunk ONI Mask","slug":"female-cyberpunk-oni-mask","hostItemId":"bcafa7e1-9487-422d-8c08-e152b81f1f45","hostSha256":"8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760","slotType":"character.mask@1","socket":"head","nodes":[],"ops":[]}

package/bridge-recipes/unreal/helix-character-creator-female/mask.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"female-cyberpunk-oni-mask","assetPath":"/HelixCharacterCreator/Characters/Clothes/Woman/Cyberpunk_ONI_Mask/SKM_W_Cyberpunk_ONI_Mask","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/neck.addon.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge-character-addon-profile/1","title":"Female Chain","slug":"female-chain","hostItemId":"bcafa7e1-9487-422d-8c08-e152b81f1f45","hostSha256":"8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760","slotType":"character.neck@1","socket":"chest","nodes":[],"ops":[]}

package/bridge-recipes/unreal/helix-character-creator-female/neck.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"female-chain","assetPath":"/HelixCharacterCreator/Characters/Clothes/Woman/W_Chain/SK_W_Chain","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/outfit.addon.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge-character-addon-profile/1","title":"Female Firefight Outfit","slug":"female-firefight-outfit","hostItemId":"bcafa7e1-9487-422d-8c08-e152b81f1f45","hostSha256":"8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760","slotType":"character.outfit@1","socket":"chest","nodes":[],"ops":[]}

package/bridge-recipes/unreal/helix-character-creator-female/outfit.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"female-firefight-outfit","assetPath":"/HelixCharacterCreator/Characters/Clothes/Woman/SK_W_Firefight_Outfit/SK_W_Firefight_Outfit_skinning","exportMorphTargets":true}

package/bridge-recipes/unreal/helix-character-creator-female/top.addon.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge-character-addon-profile/1","title":"Female Basic Tee","slug":"female-basic-tee","hostItemId":"bcafa7e1-9487-422d-8c08-e152b81f1f45","hostSha256":"8e75dfafb8c1bed53fa49fca633195385f5890bed1adae4fb2d28d3dea5b8760","slotType":"character.top@1","socket":"chest","nodes":[],"ops":[]}

package/bridge-recipes/unreal/helix-character-creator-female/top.json

@@ -0,0 +1 @@
+{"schemaVersion":"helix.bridge.unreal-asset/1","slug":"female-basic-tee","assetPath":"/HelixCharacterCreator/Characters/Clothes/Woman/W_Basic_T_Shirt/W_Basic_T_Shirt","exportMorphTargets":true}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helix3/helix-cli",
-  "version": "0.1.18-helix3.265",
+  "version": "0.1.18-helix3.266",
   "description": "helix — the HELIX creator CLI: scaffold, validate, and publish Instant Worlds",
   "main": "dist/lib.js",
   "types": "dist/lib.d.ts",