@helix3/helix-cli 0.1.23-helix3.431 → 0.1.23-helix3.433

package/README.md

@@ -53,8 +53,8 @@ The token is stored in `~/.helix/credentials.json` (mode `600`). It's sent as
 | `helix continuum publish-glb <mesh.glb> --title <t> [--package-type asset\|character] [--offer marketplace\|world --price-lix <n> --content-rating <rating>]` | Seal a Package first; optional offer makes it ownable. See [Package-first GLB publication](#package-first-glb-publication). |
 | `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. |
 | `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. |
-| `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] [--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 31 slots, `provenance` on every slot, bank sample and blend). `--map` merges slots from several sources. Exit `1` when a slot stays empty. See [docs/vehicle-audio-import.md](docs/vehicle-audio-import.md). |
-| `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"`), recordings without provenance (`AUDIO_PROVENANCE_MISSING`) and a not-fitted claim the physics contradicts (`AUDIO_SLOT_FITMENT_MISMATCH`); `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. |
+| `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 31 slots, `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). |
+| `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"`), 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. |
 | `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). |
 | `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. |
 | `helix item list-slots [--json]` | Print the Character-Creator vocabulary a wearable declares: the cosmetic slot tags, and the genders. |

package/dist/index.js

@@ -983,12 +983,13 @@ vehicleCommand
     .option('--sim <sim>', 'beamng | ac | auto', 'auto')
     .option('--vehicle <id>', 'the BeamNG vehicle folder (vehicles/<id>) when the mod has several')
     .option('--config <file.pc>', 'the BeamNG configuration whose selected parts name the sounds (default: the vehicle\'s default .pc)')
-    .option('--map <slot-map.json>', 'merge sources per slot: { sources: { id: { path, sim: beamng|ac|beamng-base|recording, vehicle?, config?, modUrl? } }, slots: { <slot>: { source?, sample?|field?|event?|file?, blend? (ladders), trim?: { startS, endS }, concat?: [pick, ...], notFitted?|absent: "not-fitted" + reason } }, ladder: { source, blend?, exhaustBlend?, rpm: { sample: rpm }, prefer, nativeRungs }, cylinders, strokes, crankLayout, bankId, modUrl } (docs/vehicle-audio-import.md)')
+    .option('--map <slot-map.json>', 'merge sources per slot: { sources: { id: { path, sim: beamng|ac|beamng-base|recording, vehicle?, config?, modUrl? } }, slots: { <slot>: { source?, sample?|field?|event?|file?, blend? (ladders), trim?: { startS, endS }, concat?: [pick, ...], notFitted?|absent: "not-fitted" + reason } }, ladder: { source, blend?, exhaustBlend?, rpm: { sample: rpm }, prefer, nativeRungs }, cylinders, strokes, crankLayout, bankId, modUrl, engineGainDb, exhaustGainDb, minLoadMix, maxLoadMix, muffling } (docs/vehicle-audio-import.md)')
     .option('--beamng-root <dir>', 'the BeamNG.drive install (its content/art_sound.zip FMOD banks and content/vehicles/common.zip); default $HELIX_BEAMNG_ROOT')
     .option('--cylinders <n>', 'the RECORDED engine\'s cylinder count (the ladder pitch model); required for an Assetto Corsa car', (v) => Number(v))
     .option('--prefer <side>', 'exterior | interior engine recordings (Assetto Corsa engine_ext / engine_int)', 'exterior')
     .option('--ac-native-rungs', 'keep only FMOD engine samples the bank places at their recorded pitch (no auto-pitch re-rate)')
     .option('--mod-url <url>', 'where the mod was downloaded from (recorded in provenance.modUrl)')
+    .option('--base-package <vehicle-package.json>', 'an existing package (file, its directory, or an audio.json) whose audio mix to keep: engineGainDb, exhaustGainDb, minLoadMix, maxLoadMix, muffling (else the mod\'s soundConfig, else the engine\'s defaults; --map values win)')
     .option('--json', 'print the machine-readable result')
     .action(async (source, opts) => {
     try {
@@ -1000,7 +1001,7 @@ vehicleCommand
         const result = importVehicleAudio({
             source, out: opts.out, sim: (opts.sim ?? 'auto'), vehicle: opts.vehicle, config: opts.config, map: opts.map,
             beamngRoot: opts.beamngRoot ?? process.env.HELIX_BEAMNG_ROOT, cylinders: opts.cylinders, prefer: opts.prefer === 'interior' ? 'interior' : 'exterior',
-            acNativeRungs: opts.acNativeRungs, modUrl: opts.modUrl, vgmstream: process.env.HELIX_VGMSTREAM,
+            acNativeRungs: opts.acNativeRungs, modUrl: opts.modUrl, basePackage: opts.basePackage, vgmstream: process.env.HELIX_VGMSTREAM,
         });
         printVehicleJsonOr(opts.json, result, () => console.log(formatAudioImport(result)));
         if (!result.ok)