@hypersoniclabs/helix-cli 0.1.27-helix3.674 → 0.1.27-helix3.676

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/README.md +1 -0
  2. package/dist/index.js +36 -0
  3. package/dist/index.js.map +1 -1
  4. package/dist/tsconfig.build.tsbuildinfo +1 -1
  5. package/dist/vehicle/carbonWeave.d.ts +42 -0
  6. package/dist/vehicle/carbonWeave.js +227 -0
  7. package/dist/vehicle/carbonWeave.js.map +1 -0
  8. package/dist/visualQa/command.js +2 -1
  9. package/dist/visualQa/command.js.map +1 -1
  10. package/dist/visualQa/harnessFreshness.d.ts +26 -0
  11. package/dist/visualQa/harnessFreshness.js +78 -0
  12. package/dist/visualQa/harnessFreshness.js.map +1 -0
  13. package/dist/visualQa/hosted.d.ts +5 -1
  14. package/dist/visualQa/hosted.js +12 -0
  15. package/dist/visualQa/hosted.js.map +1 -1
  16. package/docs/visual-qa.md +10 -1
  17. package/package.json +1 -1
  18. package/plugins/beamng-vehicle/bin/__pycache__/beamng_abs.cpython-312.pyc +0 -0
  19. package/plugins/beamng-vehicle/bin/__pycache__/beamng_audio.cpython-312.pyc +0 -0
  20. package/plugins/beamng-vehicle/bin/__pycache__/beamng_engine.cpython-312.pyc +0 -0
  21. package/plugins/beamng-vehicle/bin/__pycache__/beamng_expression.cpython-312.pyc +0 -0
  22. package/plugins/beamng-vehicle/bin/__pycache__/beamng_jbeam.cpython-312.pyc +0 -0
  23. package/plugins/beamng-vehicle/bin/__pycache__/beamng_materials.cpython-312.pyc +0 -0
  24. package/plugins/beamng-vehicle/bin/__pycache__/beamng_stock_events.cpython-312.pyc +0 -0
  25. package/plugins/beamng-vehicle/bin/__pycache__/fmod_studio.cpython-312.pyc +0 -0
  26. package/plugins/beamng-vehicle/bin/__pycache__/fsb5.cpython-312.pyc +0 -0
  27. package/plugins/beamng-vehicle/bin/__pycache__/sim_audio.cpython-312.pyc +0 -0
  28. package/plugins/beamng-vehicle/bin/__pycache__/sim_audio_ac.cpython-312.pyc +0 -0
  29. package/plugins/beamng-vehicle/bin/__pycache__/sim_audio_beamng.cpython-312.pyc +0 -0
  30. package/plugins/beamng-vehicle/bin/__pycache__/sim_audio_fixtures.cpython-312.pyc +0 -0
  31. package/plugins/beamng-vehicle/bin/__pycache__/test_beamng_engine.cpython-312.pyc +0 -0
  32. package/plugins/beamng-vehicle/bin/__pycache__/test_sim_audio.cpython-312.pyc +0 -0
package/README.md CHANGED
@@ -65,6 +65,7 @@ The token is stored in `~/.helix/credentials.json` (mode `600`). It's sent as
65
65
  | `helix continuum make-item --package-id <id> --package-version <v> --manifest-cid <cid> --content-rating <rating> [--offer marketplace\|world --price-lix <n>]` | Project one exact sealed Package Version into an Item, with an optional first offer. |
66
66
  | `helix continuum publish-owned-item <item-id> --package-id <id> --package-version <v> --manifest-cid <cid> --content-rating <rating> --accept-rating-attestation` | Publish an existing personal Item from its unchanged public sealed Package pin. Offers are separate. |
67
67
  | `helix vehicle audio-import <mod dir\|mod .zip\|AC car dir\|.bank> --out <dir> [--sim beamng\|ac\|auto] [--vehicle <id>] [--config <file.pc>] [--map <slot-map.json>] [--beamng-root <dir>] [--cylinders N] [--base-package <vehicle-package.json>] [--json]` | Takes a car's sounds from the sim mod that carries them, never synthesised: a BeamNG mod's own ladders and every sound its parts name (stock FMOD events resolved in the install's banks with `--beamng-root`, which also supplies what the game itself plays for unnamed slots), or an Assetto Corsa car's FMOD bank. Writes `audio/*.wav` (16-bit PCM, malformed headers repaired) and `audio.json` (the package `audio` block, all 26 live slots (the retired tyre/brake squeal slots are never emitted), `provenance` on every slot, bank sample and blend). `--map` merges slots from several sources. The block always carries the runtime's mix fields (gains, load mix, muffling): from `--base-package` to keep a car's current mix, else the mod's soundConfig, else the engine's defaults. Exit `1` when a slot stays empty. See [docs/vehicle-audio-import.md](docs/vehicle-audio-import.md). |
68
+ | `helix vehicle carbon-weave <in.glb> <out.glb> [--tile-cm <cm>] [--roughness <r>] [--normal-scale <s>] [--carbon-materials <regex>\|none] [--ktx2]` | Give a vehicle GLB's carbon-fibre a tiling 2x2 twill detail normal + roughness map at a real ~1.2 cm tile (UV scale per material from 3D/UV area), clearcoat roughness, non-metal. Tags source names that are exposed carbon first (default `EXT_Carbon*`, `EXT_Plastic_shinny`, `EXT_painted_metal`; an unmapped `EXT_painted_metal` rips as silver sides). Exit `1` when nothing was woven. See [docs/vehicle-carbon-weave.md](docs/vehicle-carbon-weave.md). |
68
69
  | `helix vehicle audio-check <dir\|package.json\|audio.json\|item-id> [--reference <clip>]... [--json]` | Proves every sound the runtime will select resolves, is PCM WAV and is audible (pre-publish on local files, or read-back on a published item), and that no two roles share one recording (shift up = shift down, an exhaust rung = an engine rung) and the rev limiter is a short crack the runtime can retrigger. Prints each slot's provenance and FAILS synthesised or generated audio (`AUDIO_SYNTHESISED`), a car without a recorded engine ladder (`AUDIO_ENGINE_UNSOURCED`), a missing or empty slot (`AUDIO_SLOT_UNSOURCED`, except `absent: "not-fitted"` / `"combined-with-engine"`) among the 26 live slots (the retired tyre squeal, scrub, wheelspin, skid and brake squeal slots only warn: `AUDIO_SLOT_RETIRED`), recordings without provenance (`AUDIO_PROVENANCE_MISSING`) and a not-fitted claim the physics contradicts (`AUDIO_SLOT_FITMENT_MISMATCH`) and an audio block without finite mix fields (`AUDIO_MIX_FIELDS_MISSING`: a NaN gain freezes the car in Try Now); `vehicle publish` refuses the same. `--reference <clip>` (repeatable; `slot=clip` for a slot) compares the idle voice's centroid and firing roughness with a real-car recording. |
69
70
  | `helix vehicle addon check <dir> [--json]` | Add-on fit gate for local source and host compatibility, including the web customizer's meshless guard (`ADDON_CUSTOMIZER_REFUSES`: a part with no `model.glb` must be a verified tune-only/sound-only definition). |
70
71
  | `helix vehicle addon check --item <addOnId>... / --host <vehicleId>... [--json]` | Published mode (public reads, no sign-in): reads each add-on Item's exact Package pin and runs exactly what the web customizer runs; `--host` checks every add-on on the car's rail. Exit `1` = the customizer would refuse a part, with its message. |
package/dist/index.js CHANGED
@@ -962,6 +962,39 @@ vehicleCommand
962
962
  process.exitCode = 2;
963
963
  }
964
964
  });
965
+ vehicleCommand
966
+ .command('carbon-weave')
967
+ .description('Give a vehicle GLB\'s carbon-fibre a real weave: a tiling 2x2 twill detail normal + roughness map at ~1.2 cm per tile (UV scale from 3D/UV area per material), clearcoat roughness, non-metal. '
968
+ + 'Applies to materials with semantic family carbon-fiber, and first tags source names that are exposed carbon (default EXT_Carbon*, EXT_Plastic_shinny, EXT_painted_metal; a rip\'s unmapped EXT_painted_metal renders as silver). '
969
+ + 'Fails if it weaves nothing. See docs/vehicle-carbon-weave.md')
970
+ .argument('<in.glb>', 'the vehicle model')
971
+ .argument('<out.glb>', 'where to write the woven model')
972
+ .option('--tile-cm <cm>', 'real-world size of one weave tile', '1.2')
973
+ .option('--roughness <r>', 'clearcoat roughness factor', '0.17')
974
+ .option('--normal-scale <s>', 'normal map scale', '0.45')
975
+ .option('--carbon-materials <regex>', 'source material names to tag as carbon-fiber; "none" tags nothing')
976
+ .option('--ktx2', 'encode the two weave textures as KTX2 (UASTC) instead of PNG')
977
+ .action(async (inGlb, outGlb, opts) => {
978
+ try {
979
+ const { weaveGlbFile } = await Promise.resolve().then(() => __importStar(require('./vehicle/carbonWeave')));
980
+ const report = await weaveGlbFile((0, node_path_1.resolve)(inGlb), (0, node_path_1.resolve)(outGlb), {
981
+ tileCm: Number(opts.tileCm),
982
+ roughness: Number(opts.roughness),
983
+ normalScale: Number(opts.normalScale),
984
+ carbonMaterials: opts.carbonMaterials === undefined ? undefined : opts.carbonMaterials === 'none' ? null : opts.carbonMaterials,
985
+ ktx2: opts.ktx2,
986
+ });
987
+ for (const w of report.weaved)
988
+ console.log(`${w.material}${w.tagged ? ' (tagged carbon-fiber)' : ''}: ${w.metresPerUv.toFixed(3)} m/uv, ${w.tilesPerUv.toFixed(1)} tiles/uv`);
989
+ for (const s of report.skipped)
990
+ console.log(`skipped ${s}`);
991
+ console.log(`✔ weave on ${report.weaved.length} material(s) -> ${(0, node_path_1.resolve)(outGlb)}`);
992
+ }
993
+ catch (error) {
994
+ process.stderr.write(`✖ ${error instanceof Error ? error.message : String(error)}\n`);
995
+ process.exitCode = 1;
996
+ }
997
+ });
965
998
  vehicleCommand
966
999
  .command('audio-check')
967
1000
  .description('Prove every sound a vehicle declares will actually play: each engine-ladder rung and slot sample the runtime selects must resolve (a local WAV '
@@ -2323,6 +2356,7 @@ item
2323
2356
  .option('--poll-seconds <n>', 'with --hosted-worker: queue polling interval', '10')
2324
2357
  .option('--render-timeout <seconds>', 'with --hosted-worker: hard limit per render', '900')
2325
2358
  .option('--worker <name>', 'with --hosted-worker: runner identity recorded on the job')
2359
+ .option('--follow-ref <ref>', 'with --hosted-worker: exit before the next claim when origin/<ref> changed a harness file (HELIX_VQA_FOLLOW_REF), so the next worker starts on current source')
2326
2360
  .option('--local-critic', 'also run the vision critic locally (needs ANTHROPIC_API_KEY or OPENROUTER_API_KEY)')
2327
2361
  .option('--out <dir>', 'bundle directory (frames, bundle.json, contact-sheet.jpg)')
2328
2362
  .option('--storage-state <file>', 'Playwright storageState of a signed-in QA account (Try Now and the customiser need one); default $HELIX_VQA_STORAGE_STATE')
@@ -2355,6 +2389,7 @@ item
2355
2389
  fail('✖ --hosted-worker needs HELIX_VQA_BOT_EMAIL and HELIX_VQA_BOT_PASSWORD in the environment');
2356
2390
  const { runHostedWorker } = await Promise.resolve().then(() => __importStar(require('./visualQa/hosted')));
2357
2391
  const workerApi = opts.apiUrl ?? process.env.HELIX_API_URL ?? config_1.DEFAULT_API_URL; // never a stored login: the runner is its own account
2392
+ const followRef = opts.followRef ?? process.env.HELIX_VQA_FOLLOW_REF;
2358
2393
  const summary = await runHostedWorker({
2359
2394
  apiBase: workerApi,
2360
2395
  webBase: opts.webUrl ?? process.env.HELIX_WEB_URL ?? (0, config_1.webUrlForApi)(workerApi) ?? config_1.DEFAULT_WEB_URL,
@@ -2370,6 +2405,7 @@ item
2370
2405
  out: opts.out,
2371
2406
  chrome: opts.chrome,
2372
2407
  cliVersion: (0, lib_1.cliVersion)(),
2408
+ freshness: followRef ? async () => (await Promise.resolve().then(() => __importStar(require('./visualQa/harnessFreshness')))).checkHarnessFresh({ ref: followRef }) : undefined,
2373
2409
  });
2374
2410
  if (opts.json)
2375
2411
  console.log(JSON.stringify(summary, null, 2));