@helix3/helix-cli 0.1.21-helix3.406 → 0.1.21-helix3.408

package/README.md

@@ -595,7 +595,7 @@ Every finding prints as `CODE  path — message` plus a `fix:` line; `--json` re
 | Cross-field | `GROUND_TO_BODY_ORIGIN_MISMATCH` (> 5 mm; fix the ride height, the field is locked after first publish), `COMPONENT_BUILD_DIGEST_MISMATCH` (prints the computed digest), `COMPONENT_ACTIONS_MISMATCH` (prints the compiled protocol), `COMPONENT_BUILD_INVALID`, `PANEL_SIGNAL_NO_ACTION` (warn), `SEAT_SOCKET_UNKNOWN` (warn) |
 | Drive (package `targets`) | `SIMULATED_PERFORMANCE_OUT_OF_TOLERANCE` (figure, simulated, target, error, tolerance, engine version), `SIMULATED_REST_POSE_INVALID`, `SIMULATION_UNAVAILABLE` (warn: no runtime reachable or cached) |
 | `--glb` host manifest | `HOST_MANIFEST_MISSING`, `HOST_MANIFEST_MISPLACED` (found in scene/document/node extras; the backend reads only `asset.extras.HELIX_vehicle`), `HOST_MANIFEST_EMPTY`, `HOST_MANIFEST_DIVERGENT`, `HOST_MANIFEST_SOCKET_INVALID`, `HOST_MANIFEST_SOCKET_NAME_INVALID`, `HOST_MANIFEST_SOCKET_NODE_MISSING`. `helix continuum publish-package` refuses a `vehicle` Package descriptor whose model GLB has any of these errors before sealing. See [docs/vehicle-simulate.md](docs/vehicle-simulate.md#host-manifest) |
-| `--glb` | `WHEEL_NODES_MISSING`, `WHEEL_PIVOT_NOT_AT_HUB` (origin > 2 cm from the centre of its geometry — the wheel add-on anchor lands there), `WHEEL_ORIGINS_NOT_DISTINCT`, `WHEEL_FRAME_MIRRORED_X`, `WHEEL_FRAME_FRONT_NOT_PLUS_Z`, `WHEEL_NODE_EMPTY` (warn), `LENGTH_NOT_ALONG_Z` (warn), `PANEL_NODE_MISSING`, `VEHICLE_BUDGET_TRIANGLES` / `_MATERIALS` / `_TEXTURE_EDGE` / `_DRAW_CALLS` / `_FILE_SIZE` |
+| `--glb` | `WHEEL_NODES_MISSING`, `WHEEL_PIVOT_NOT_AT_HUB` (origin > 2 cm from the centre of its geometry — the wheel add-on anchor lands there), `WHEEL_ORIGINS_NOT_DISTINCT`, `WHEEL_FRAME_MIRRORED_X`, `WHEEL_FRAME_FRONT_NOT_PLUS_Z`, `WHEEL_NODE_EMPTY` (warn), `LENGTH_NOT_ALONG_Z` (warn), `PANEL_NODE_MISSING`, `PANEL_ROLE_MISSING_DOOR` / `PANEL_ROLE_NO_NODE_BONNET` / `PANEL_ROLE_NO_NODE_BOOT` / `PANEL_ROLE_UNDECLARED_BONNET` / `PANEL_ROLE_UNDECLARED_BOOT` (warn: a four-wheeled car should articulate its doors, bonnet and boot / engine cover), the lamp-coverage gate on the lit geometry (`LAMP_INDICATOR_REAR_MISSING` / `LAMP_INDICATOR_FRONT_MISSING` / `LAMP_INDICATOR_SIDE_UNLIT` / `LAMP_INDICATOR_NO_ROWS` / `LAMP_NODE_UNLIT` / `LAMP_REPEATER_UNLIT` / `LAMP_FUNCTION_NO_ROW` errors, `LAMP_ROW_NO_TARGET` / `LAMP_NO_LIGHTING_ROWS` / `LAMP_INDICATOR_REAR_OPTED_OUT` warns; the documented opt-out for a car that really has no rear indicators is `lights.noRearIndicators: "<why, with source>"`), `VEHICLE_BUDGET_TRIANGLES` / `_MATERIALS` / `_TEXTURE_EDGE` / `_DRAW_CALLS` / `_FILE_SIZE` |
 
 The model frame is glTF: +X is the vehicle's left, +Y up, +Z forward, metres. Wheel nodes are found by name with
 the engine's own resolver (`wheel_lf` / `wheel_rf` / `wheel_lr` / `wheel_rr` and the usual aliases); all four must

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