@helix3/helix-cli 0.1.20-helix3.400 → 0.1.21-helix3.403

package/README.md

@@ -346,11 +346,16 @@ A published world ships only its **built bundle**, so there is nothing on the se
   channel for exactly that reason.
 - **Limit**: 128 MiB compressed, checked locally before anything is uploaded.
 
-Before upload, module-based multiplayer worlds are checked for server realizability: every bank must
-be published with the declared checksum and the shared manifest validator must accept all module
-budgets under the 100,000 tick-node ceiling. Fix the named module/bank when this gate refuses a
-publish. For exceptional recovery only, `--skip-realizability-check` bypasses this check; flat-v0
-worlds are unaffected.
+Before upload, multiplayer worlds that install modules are checked for server realizability. A
+module with a `bank` reference must name a bank that is published with the declared checksum (bank
+modules belong to the default `multiplayer` block; the manifest validator refuses one inside a room
+type). A module without `bank` is inline: its rules are in the manifest, so there is nothing to
+resolve. The modules of every program (the default block and each `multiplayer.roomTypes` entry)
+must then fit the 100,000 tick-node ceiling at the number of players that program's room holds: 24
+for a standard default block, a room type's own `maxPlayers` up to 24, and the declared `maxPlayers`
+up to 64 with `capacityClass: "large"`, never fewer than 2. Fix the named module or bank when this
+gate refuses a publish. For exceptional recovery only, `--skip-realizability-check` bypasses this
+check; worlds without modules are unaffected.
 
 The programmatic surface (`publishWorld`, `checkBundle`, `whoAmI`, …) is exported for other CLI
 modules. Agent integrations should instruct or delegate to the `helix` commands above rather than

package/dist/index.js

@@ -653,6 +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('--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')
@@ -669,6 +671,7 @@ vehicleCommand
             summary = await runVehiclePreview({
                 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,
                 token: creds?.token ?? null, storageState: opts.storageState ?? process.env.HELIX_VQA_STORAGE_STATE, chrome: opts.chrome, quiet: opts.json,
             });
         }