@helix3/helix-cli 0.1.22-helix3.412 → 0.1.22-helix3.415

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'}`);
@@ -655,6 +655,11 @@ vehicleCommand
     .option('--occupants', 'also seat an avatar in every seat, judge the cabin, and report where the runtime\'s cabin fit put each seat vs where it was authored (slow)')
     .option('--reference-paint <#rrggbb>', 'the reference body paint colour, the median of the body-paint pixels in the reference photos: renders the body paint alone from six cameras in the Try Now daylight (the world\'s own sun, exposure, tone mapping and lights) and fails on hue, saturation, lightness or highlight wash. White/silver/grey/black are judged on tint and lightness instead of hue')
     .option('--paint-tolerance <deg>', 'maximum circular hue distance (degrees) the rendered body may sit from a chromatic --reference-paint (default 12)', (v) => Number(v))
+    .option('--reference-wheel <image>', 'a close-up photo of the real wheel, face-on or nearly: renders the candidate\'s front-left wheel square-on and fails vehicle.wheels.design.* on spoke count and centre cap (a different finish fails, a neighbouring one warns). The photo\'s wheel is read from the image centre unless --reference-wheel-crop says where it is')
+    .option('--reference-wheel-spokes <n>', 'declare the real wheel\'s spoke count (overrides the count read from the photo; use it for an oblique or tight photo)', (v) => Number(v))
+    .option('--reference-wheel-finish <finish>', 'declare the real wheel\'s finish: silver, chrome, gunmetal, black, bronze, gold or coloured (overrides the finish read from the photo)')
+    .option('--reference-wheel-cap <yes|no>', 'declare whether the real wheel has a centre cap (overrides the photo)')
+    .option('--reference-wheel-crop <cx,cy,r>', 'where the wheel sits in the photo, as fractions: centre x of the width, centre y of the height, tyre outer radius of the shorter side (default 0.5,0.5,0.45)')
     .option('--storage-state <file>', 'Playwright storageState of a signed-in QA account (default: sign in with `helix login`, or $HELIX_VQA_STORAGE_STATE)')
     .option('--chrome <path>', 'Chromium executable (default: Playwright Chromium / Chrome for Testing, headless; the macOS system Chrome is refused)')
     .option('--api-url <url>', 'platform API base URL')
@@ -672,6 +677,13 @@ vehicleCommand
                 target, addOns: opts.addon, item: opts.item, toleranceCm: Number.isFinite(opts.toleranceCm) ? opts.toleranceCm : undefined,
                 glb: opts.glb, out: opts.out, proxyItem: opts.proxyItem, occupants: opts.occupants, apiBase, webBase,
                 referencePaint: opts.referencePaint, paintToleranceDeg: Number.isFinite(opts.paintTolerance) ? opts.paintTolerance : undefined,
+                referenceWheel: opts.referenceWheel ? {
+                    image: opts.referenceWheel,
+                    ...(Number.isFinite(opts.referenceWheelSpokes) ? { spokeCount: opts.referenceWheelSpokes } : {}),
+                    ...(opts.referenceWheelFinish ? { finish: opts.referenceWheelFinish } : {}),
+                    ...(opts.referenceWheelCap ? { centreCap: /^(y|yes|true|1)$/i.test(opts.referenceWheelCap) } : {}),
+                    ...(opts.referenceWheelCrop ? { crop: ((p) => ({ cx: p[0], cy: p[1], radius: p[2] }))(opts.referenceWheelCrop.split(',').map(Number)) } : {}),
+                } : undefined,
                 token: creds?.token ?? null, storageState: opts.storageState ?? process.env.HELIX_VQA_STORAGE_STATE, chrome: opts.chrome, quiet: opts.json,
             });
         }
@@ -801,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)();
@@ -819,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);
@@ -827,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)