@hypersoniclabs/helix-cli 0.1.25-helix3.479 → 0.1.25-helix3.480

package/README.md

@@ -104,7 +104,8 @@ The token is stored in `~/.helix/credentials.json` (mode `600`). It's sent as
 | `helix world audit\|source-audit\|perf-gate\|prove-live` | Run the blocking world QA, performance, and deployed-build identity gates. |
 | `helix world performance-report [bundle] [--scene <scene-v2.json>] [--package <package-version.json>] [--snapshot <inspect.json>] [--perf <receipt.json>]` | Analyze exact declared scene resources and existing reference-profile budgets, while keeping authored geometry/material/delivery estimates separate from supplied runtime claims. Prints actionable instancing, Palette, lighting, transfer, and visual-QA guidance; it never predicts FPS from static counts. |
 | `helix world scene-source inventory\|compile <helsinki\|bistro> <archive>` | Verify and safely inventory a known CC BY source archive, then compile deterministic local proxy/detail GLBs and an existing-schema Scene v2 package. |
-| `helix world scene-source publish <world-id> <package-dir> [--publish]` | Validate the Scene v2 package and print its multipart build receipt. Execution remains dry-run-only until backend private-pin entitlement lands; `--publish` currently fails closed, and access control never changes CC BY rights. |
+| `helix world scene-source publish <world-id> <package-dir> [--publish]` | Validate the Scene v2 package, refuse it if it breaks the open-world performance rules (docs/scene-perf.md; no override), and print its multipart build receipt. Execution remains dry-run-only until backend private-pin entitlement lands; `--publish` currently fails closed, and access control never changes CC BY rights. |
+| `helix scene validate <dir\|file> [--perf] [--tier desktop\|mobile\|desktop,mobile] [--out <report.json>]` | Check a Scene v2 package against the shared validator and, with `--perf`, the 14 open-world performance rules (textures, geometry, cells, draws, budget, first-playable bytes). Exit 0 pass, 1 refused, 2 cannot be judged. See `docs/scene-perf.md`. |
 | `helix continuum publish-source-map\|publish-scratch\|publish-package\|publish-glb\|make-item\|publish-owned-item` | Resume exact-CID object adoption/ingestion, Package lease/seal, optional explicitly authorized Listing, and WorldRelease publication through one creator-owned pipeline. |
 | `helix continuum receipt <job-id>` | Read the sanitized durable receipt for a completed Continuum publication. |
 | `helix unreal init\|validate\|doctor\|package [project]` | Create and gate a shared-runtime or native-game publish manifest, check optional editor MCP, and assemble a local upload-shaped package. |

package/dist/index.js

@@ -41,7 +41,8 @@ const moveUx_1 = require("./visualQa/moveUx");
 const validate_1 = require("./vehicle/validate");
 const commander_1 = require("commander");
 const commands_1 = require("./sceneHlod/commands");
-const commands_2 = require("./city/source/commands");
+const commands_2 = require("./scenePerf/commands");
+const commands_3 = require("./city/source/commands");
 const command_1 = require("./city/import/osm/command");
 const placementRequest_1 = require("./placementRequest");
 const bundle_1 = require("./bundle");
@@ -6019,10 +6020,11 @@ const scene = program
     .command('scene')
     .description('Bring a captured world into the scene sources a HELIX world streams');
 (0, commands_1.registerSceneHlodCommands)(scene, fail);
+(0, commands_2.registerScenePerfCommands)(scene);
 const city = program
     .command('city')
     .description('City pipelines: the neutral city source every importer writes and every generator reads');
-(0, commands_2.registerCitySourceCommands)(city, fail);
+(0, commands_3.registerCitySourceCommands)(city, fail);
 (0, command_1.registerCityImportOsm)(city, fail);
 const sceneImport = scene
     .command('import')
@@ -6588,6 +6590,19 @@ sceneSource
             requiresAuth: opts.requiresAuth,
             visibility: opts.visibility,
         });
+        // The open-world performance contract (docs/scene-perf.md): refuse before a byte is uploaded. No override flag.
+        {
+            const { enforceScenePerfGate, ScenePerfRefusal } = await Promise.resolve().then(() => __importStar(require('./scenePerf/gate')));
+            try {
+                const perf = await enforceScenePerfGate({ scene: input.scene, resources: input.resources.map((resource) => ({ path: resource.path, bytes: resource.bytes })) }, { tiers: opts.supportsMobile ? ['desktop', 'mobile'] : ['desktop'], profile: opts.profile });
+                process.stderr.write(`✔ performance contract: ${perf.rules.filter((rule) => rule.passed).length}/${perf.rules.length} rule checks pass${perf.warned.length ? ` (warnings: ${perf.warned.join(', ')}; run helix scene validate --perf for detail)` : ''}\n`);
+            }
+            catch (error) {
+                if (error instanceof ScenePerfRefusal)
+                    fail(`✖ ${error.message}`);
+                throw error;
+            }
+        }
         if (!opts.publish) {
             console.log(JSON.stringify(createSceneV2DryRunReceipt(input), null, 2));
             return;