@helix3/helix-cli 0.1.22-helix3.413 → 0.1.22-helix3.416

package/README.md

@@ -53,7 +53,7 @@ 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-check <dir\|package.json\|item-id> [--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). |
+| `helix vehicle audio-check <dir\|package.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. `--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

@@ -624,7 +624,7 @@ vehicleCommand
             console.log((0, validate_1.formatVehicleIssues)(result.issues));
         if (result.simulation) {
             const { formatSimulationReport } = await Promise.resolve().then(() => __importStar(require('./vehicle/simulate')));
-            console.log(formatSimulationReport(result.simulation).split('\n').map((line) => `  ${line}`).join('\n'));
+            console.log(formatSimulationReport(result.simulation, { withPolicy: false }).split('\n').map((line) => `  ${line}`).join('\n'));
         }
         if (provisional > 0)
             console.log(`  ${provisional} audio row${provisional === 1 ? '' : 's'} backed by a local WAV: seal the WAV in the Vehicle Package before making its Item; \`helix vehicle audio-check\` proves ${provisional === 1 ? 'it plays' : 'they play'}`);
@@ -813,13 +813,17 @@ vehicleCommand
     .command('audio-check')
     .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 '
     + 'beside the package before publish, or HTTP 200 with the exact declared bytes and sha256 after), be PCM WAV, and be audible (not silence). '
-    + 'It also measures what each sound is made of: clipping, DC offset, a resampled-copy ladder rung, one fixed formant stack or fixed tone shared by every rung, and an exactly periodic synthetic horn (each reported with its measured value and a fix). '
+    + 'It also measures what each sound is made of: clipping, DC offset, a resampled-copy ladder rung, one fixed formant stack or fixed tone shared by every rung, near-duplicate sounds across roles (shift up = shift down, an exhaust rung = an engine rung), a rev-limiter clip too long to stutter (the runtime re-fires it every 60 ms), and an exactly periodic synthetic horn (each reported with its measured value and a fix). '
     + 'Pass a package directory / package JSON for the pre-seal check, or a published vehicle item id for the read-back check. Exit 0 = every sample plays')
     .argument('<dir|package.json|item-id>', 'package directory or file (pre-seal), or a published vehicle item UUID (read-back)')
+    .option('--reference <clip>', 'a recording of the REAL car to compare the idle voice with: a WAV (or anything ffmpeg reads) of the engine idling; `slot=clip` compares that slot instead (e.g. horn=horn.wav, startup=start.wav). Repeat for several clips (the median is used). Spectral centroid and firing roughness are measured identically on both sides; WARN beyond 2.5x, error beyond 10x (field recordings differ by 2-4x between takes of one car)', (value, previous) => [...previous, value], [])
     .option('--json', 'print the machine-readable report')
     .action(async (target, opts) => {
     try {
         const audio = await Promise.resolve().then(() => __importStar(require('./vehicle/audio')));
+        const { loadReferenceClips } = await Promise.resolve().then(() => __importStar(require('./vehicle/audioReference')));
+        const reference = opts.reference?.length ? { bySlot: loadReferenceClips(opts.reference).bySlot } : undefined;
+        const options = reference ? { reference } : {};
         let report;
         if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(target)) {
             const creds = (0, config_1.loadCredentials)();
@@ -831,7 +835,7 @@ vehicleCommand
             const pkg = (body.item ?? body).properties?.vehiclePackage;
             if (!pkg)
                 throw new Error(`item ${target} carries no properties.vehiclePackage (is it a vehicle?)`);
-            report = await audio.checkAudioReadBack(pkg);
+            report = await audio.checkAudioReadBack(pkg, undefined, undefined, options);
         }
         else {
             const path = (0, node_path_1.resolve)(target);
@@ -839,7 +843,7 @@ vehicleCommand
             const isDir = statSync(path).isDirectory();
             const { readVehicleDir } = await Promise.resolve().then(() => __importStar(require('./vehicle/publish')));
             const pkg = isDir ? readVehicleDir(path).pkg : (0, validate_1.readJsonFile)(path);
-            report = await audio.checkAudioLocal(pkg, isDir ? path : (0, node_path_1.resolve)(path, '..'));
+            report = await audio.checkAudioLocal(pkg, isDir ? path : (0, node_path_1.resolve)(path, '..'), undefined, undefined, options);
         }
         printVehicleJsonOr(opts.json, report, () => console.log(audio.formatAudioReport(report)));
         if (!report.ok)