@helix3/helix-cli 0.1.19-helix3.372 → 0.1.19-helix3.377

package/dist/index.js

@@ -696,6 +696,11 @@ function vehicleContinuumDeps() {
         };
     });
 }
+/** The drive-effect instrument for `vehicle addon check`: the live runtime's physics, loaded lazily on first use. */
+async function vehicleDriveMeasure(apiUrl) {
+    const drive = await Promise.resolve().then(() => __importStar(require('./vehicle/drive')));
+    return async (vehiclePackage, ops, slotType) => drive.judgeDriveEffect(await drive.loadDriveEngine(apiUrl), vehiclePackage, ops, slotType);
+}
 function printVehicleJsonOr(json, value, human) {
     if (json)
         console.log(JSON.stringify(value, (_k, v) => (v === Number.NEGATIVE_INFINITY ? '-Infinity' : v), 2));
@@ -749,10 +754,14 @@ vehicleAddOnCommand
     .command('check')
     .description('Prove an add-on will fit and land where it should BEFORE paying for it: the local fits/ops contract, the model\'s helixMeshFrame anchoring '
     + '(a socket-frame part centred on its mount), per host — a vehicle, wheel origins at the hubs, hide targets present, hide grants on the board — '
-    + 'and the backend\'s own fit dry run (POST /universal-items/validate-fit: how many hosts it actually fits). '
-    + 'Directory: addon.json { title, fits, ops, ... } + model.glb. Exit 0 = fits every named host')
+    + 'tunable paths the part requires exposed on the host surface, the backend\'s own fit dry run (POST /universal-items/validate-fit: how many '
+    + 'hosts it actually fits), and — for tune ops — the DRIVE EFFECT on each host, measured with the live runtime\'s own physics and add-on fold '
+    + '(0-100, top speed, quarter mile, skidpad g and roll, full- and part-pedal stops, handbrake), each op judged on a figure it can move; an op '
+    + 'that changes nothing or cancels another is reported. Directory: addon.json { title, fits, ops, ... } + model.glb (none for a tune-only part: '
+    + 'ECU, gearbox, brakes, sway bars, coilovers, tyre compound — every op a tune). Exit 0 = fits every named host and does something')
     .argument('<dir>', 'the add-on directory')
     .option('--glb <file>', 'the add-on model, when the directory holds more than one .glb')
+    .option('--no-measure', 'skip the drive-effect measurement (it downloads the live runtime and runs its physics, ~1-5 s per host)')
     .option('--json', 'print the machine-readable report')
     .action(async (dir, opts) => {
     try {
@@ -762,6 +771,7 @@ vehicleAddOnCommand
             api: lib_1.HelixApi.forCredentials(creds),
             onProgress: (m) => { if (!opts.json)
                 console.log(`· ${m}`); },
+            measureDrive: opts.measure === false ? undefined : await vehicleDriveMeasure(creds.apiUrl),
         });
         printVehicleJsonOr(opts.json, report, () => console.log(addon.formatAddOnReport(report)));
         if (!report.ok)
@@ -1758,6 +1768,7 @@ item
     .option('--package-version <version>', 'render this version of the item\'s pinned package instead of the pin: a version move judged before the pointer moves (vehicles, avatars, add-ons, wearables)')
     .option('--vehicle-package <file>', 'with --package-version on a vehicle: the version move\'s vehicle package JSON, served by Try Now after server-side preparation')
     .option('--chrome <path>', 'Chromium executable (default: Playwright Chromium / Chrome for Testing, headless; the macOS system Chrome is refused)')
+    .option('--no-world-walk', 'skip the world walk (wearables, character add-ons, avatars: worn and walked in the test grounds, measured for holes and poke-through); also HELIX_VQA_WORLD_WALK=0')
     .option('--api-url <url>', 'platform API base URL')
     .option('--web-url <url>', 'website base URL (default: the site that serves --api-url)')
     .option('--json', 'print the outcome as JSON')
@@ -1881,6 +1892,7 @@ item
             packageVersion: opts.packageVersion?.trim() || null,
             vehiclePackage,
             chrome: opts.chrome,
+            worldWalk: opts.worldWalk,
             submit: opts.submit,
             localCritic: opts.localCritic,
             cliVersion: (0, lib_1.cliVersion)(),