@helix3/helix-cli 0.1.21-helix3.407 → 0.1.21-helix3.409

package/dist/index.js

@@ -653,8 +653,8 @@ vehicleCommand
     .option('--out <dir>', 'frames, contact-sheet.jpg, bundle.json and preview.json go here (default: <dir>/.helix-preview)')
     .option('--proxy-item <id>', 'a published vehicle the QA account can Try Now; the runtime loads it and the candidate replaces its car (and its slot board is what --addon fits to)')
     .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, sampled from the reference photo: sample the rendered body from the side pose and fail if its hue is off (default tolerance 15°)')
-    .option('--paint-tolerance <deg>', 'maximum circular hue distance (degrees) the rendered body may sit from --reference-paint (default 15)', (v) => Number(v))
+    .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('--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')
@@ -728,7 +728,11 @@ vehicleCommand
     + 'PASS iff |error| <= tolerance. The runtime is fetched once per version and cached by sha under ~/.helix/cache/engine-runtime; offline, the last '
     + 'cached runtime is used and labelled. TURBO LAG: with boostTorqueCoef 0 the solver adds no boost torque, so a turbo car whose curve is the full-boost '
     + 'dyno curve pulls with no lag; author lag by derating the torque curve below spool, then check `turbo lag` here (docs/vehicle-simulate.md). '
-    + 'Exit 0 = every compared figure passes, 1 = a figure is out of tolerance or the rest pose is wrong, 2 = could not simulate')
+    + 'KEYBOARD LAUNCH: it also launches the car the way a keyboard player does (W 0->1 in one tick, A/D taps with 100 ms reactions holding a lane; '
+    + 'the platform has no traction control and does not ramp a digital throttle) and nudges the yaw hands-off at 20/40/60/100 km/h and as each upshift '
+    + 're-engages: keyboard 0-100 vs the instrument, wheelspin per gear, post-shift yaw/heading/sideslip, lane offset. A nudge that grows into a spin '
+    + 'FAILS "not drivable on a keyboard". '
+    + 'Exit 0 = every compared figure passes and the keyboard launch does not FAIL, 1 = a figure is out of tolerance, the rest pose is wrong or the car is not drivable on a keyboard, 2 = could not simulate')
     .argument('[dir-or-package.json]', 'a vehicle package directory (vehicle-package.json), the package JSON, or a saved item read')
     .option('--item <id>', 'simulate a PUBLISHED vehicle item\'s stored package (public read) instead of a local file')
     .option('--spec <file>', 'extra targets: a package / {targets}, or a reference spec (perf.0_100_kmh_s, perf.braking_100_0_m, perf.braking_70mph_0_m, perf.skidpad_g, perf.turbo_lag_s … as {value, tol_pct})')
@@ -736,6 +740,7 @@ vehicleCommand
     .option('--runtime <file-or-url>', 'drive with this runtime bundle instead of the served one (a candidate engine build)')
     .option('--range <range>', 'engine range to resolve (default ^0.3)')
     .option('--api-url <url>', 'API to resolve the runtime (and --item) from (default: this CLI\'s environment)')
+    .option('--no-keyboard-launch', 'skip the keyboard launch and its hands-off yaw probe')
     .option('--json', 'print the machine-readable report')
     .action(async (input, opts) => {
     const { readVehiclePackageArg, simulateVehicle, targetsFromSpec, formatSimulationReport } = await Promise.resolve().then(() => __importStar(require('./vehicle/simulate')));
@@ -778,7 +783,7 @@ vehicleCommand
     }
     try {
         const runtime = await loadEngineRuntime({ apiUrl, offline: opts.offline, runtime: opts.runtime, range: opts.range });
-        const report = await simulateVehicle(pkg, runtime, { specTargets });
+        const report = await simulateVehicle(pkg, runtime, { specTargets, skipKeyboardLaunch: opts.keyboardLaunch === false });
         if (opts.json)
             console.log(JSON.stringify({ source, spec: opts.spec ? (0, node_path_1.resolve)(opts.spec) : null, ...report }, null, 2));
         else
@@ -795,6 +800,7 @@ 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). '
     + '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('--json', 'print the machine-readable report')