@helix3/helix-cli 0.1.15-helix3.232 → 0.1.15-helix3.233

package/README.md

@@ -65,6 +65,7 @@ The token is stored in `~/.helix/credentials.json` (mode `600`). It's sent as
 | `helix character import <body.glb> [--map <json>] [--fit source\|canonical] [--provenance <json>]` | Convert one self-contained third-party humanoid through the public `helix-humanoid@1` pipeline. The command rejects external/remote resources and resource bombs before parsing, generates bounded LODs, and emits a source/license/transformation/checksum receipt beside the output. `--fit canonical` aligns the rest skeleton/proportions; it does not prove that Base Male-targeted garments fit a different body surface. |
 | `helix character retarget-animation <clip.fbx\|clip.glb>` | Retarget a raw Mixamo/Meshy clip directly to `helix-humanoid@1`. FBX conversion is deterministic and runs inside the CLI; no hidden Blender/DCC pre-export is required. |
 | `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 continuum publish-source-map\|publish-scratch\|publish-package` | Resume exact-CID object adoption/ingestion, Package lease/seal, optional explicitly authorized Listing, and WorldRelease publication through one creator-owned pipeline. |

package/dist/index.js

@@ -42,6 +42,7 @@ const node_child_process_1 = require("node:child_process");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
+const scenePerformance_1 = require("./scenePerformance");
 const lib_1 = require("./lib");
 const itemQuote_1 = require("./itemQuote");
 const itemSearch_1 = require("./itemSearch");
@@ -4833,6 +4834,32 @@ addBundledAudit(world, {
     script: 'world-audit.mjs',
     usage: '[--snapshot <file>] [--dist <dir>] [--root <dir>] [--assets <file>] [--json]',
 });
+world
+    .command('performance-report')
+    .description('Analyze a built scene against existing Palette Showcase reference budgets, keep authored estimates separate from submitted runtime work, and print concrete optimization and verification guidance')
+    .argument('[directory]', 'built world bundle directory', 'dist')
+    .option('--scene <file>', 'exact Scene v2 JSON for authoritative resource roles/integrity, surfaces, and stream groups')
+    .option('--package <file>', 'Continuum Package version JSON for exact semantic material bindings and transitive closure facts')
+    .option('--snapshot <file>', 'world inspect snapshot JSON for visible-scene triangles')
+    .option('--perf <file>', 'supplied runtime performance receipt; byte/identity matches bind the claim but do not authenticate its origin')
+    .option('--profile <id>', 'Palette Showcase reference profile (not a universal Scene budget)', 'web-desktop-balanced')
+    .option('--json', 'machine-readable helix.scene-performance-report/1 output')
+    .action((directory, opts) => {
+    try {
+        const report = (0, scenePerformance_1.analyzeScenePerformance)({
+            directory: (0, node_path_1.resolve)(directory),
+            ...(opts.scene && { scene: (0, node_path_1.resolve)(opts.scene) }),
+            ...(opts.package && { package: (0, node_path_1.resolve)(opts.package) }),
+            ...(opts.snapshot && { snapshot: (0, node_path_1.resolve)(opts.snapshot) }),
+            ...(opts.perf && { perf: (0, node_path_1.resolve)(opts.perf) }),
+            profile: opts.profile,
+        });
+        console.log(opts.json ? JSON.stringify(report, null, 2) : (0, scenePerformance_1.formatScenePerformanceReport)(report));
+    }
+    catch (err) {
+        fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
 addBundledAudit(world, {
     name: 'source-audit',
     description: 'Run the blocking lighting, materials, audio, mobile, and authority audit',