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

package/README.md

@@ -595,6 +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` host-frame bind contract | `HOST_BIND_ROOT_MISSING` (no `vehicle_root` node), `HOST_BIND_MOUNT_NODE_MISSING` (an offered `boot`/`bonnet` socket with no node to mount on), `HOST_BIND_ROOT_NOT_OWNER` (the lid node is outside `vehicle_root`): a host that offers a lid socket must carry the nodes a host-frame add-on binds to, or the runtime throws while composing the car and it is never presented. `vehicle addon check --host`, `vehicle addon check <dir>` and `vehicle preview --addon` apply the same rule to the add-ons' own `bind { socket, root }`; `vehicle preview` refuses before launching a browser and fails at once on a `[helix-vehicle] composition failed` console line or a page error |
 | `--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

package/dist/index.js

@@ -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,
             });
         }