@helix3/helix-cli 0.1.15-helix3.245 → 0.1.16-helix3.249

package/README.md

@@ -51,6 +51,7 @@ The token is stored in `~/.helix/credentials.json` (mode `600`). It's sent as
 | `helix device create <dir> --id <slug> --title <t> --model <mesh.glb> --template standing-desk\|clock\|television` | Scaffold a GLB-backed `helix.device/1` definition, including the interactive TV/media-player template. There is intentionally no website Device editor. |
 | `helix device validate [dir] [--json]` | Validate the definition, GLB bytes and named-node bindings, typed state/controls, capabilities, and Home+World compatibility. |
 | `helix device test [dir] [--mode single\|multiplayer\|both] [--json]` | Exercise every interaction, persistence remount, and deterministic one-/two-client authority convergence. |
+| `helix world scene-elements compile <input> --output <scene>` | Compile typed Scene v2 authoring, including exact Continuum Device pins, instances, and locally validated typed links. See [`examples/scene-elements-devices.json`](examples/scene-elements-devices.json). |
 | `helix preview-video <slug> <youtube-url>` | Set or clear a published world's YouTube preview. |
 | `helix thumbnail set <slug> <file>` | Upload a thumbnail or preview image through the CLI-owned media path. |
 | `helix assets search\|get\|versions\|track\|install\|update` | Search the typed Vault with explainable ranking; inspect/manage annotations and immutable versions; install by durable ID with verified SHA-256 receipts. Material installs default to lean runtime KTX2 maps; use `--material-renditions source` for source PNGs or `all` for both families. |

package/dist/index.js

@@ -4682,7 +4682,7 @@ const sceneElements = world
     .description('Compile nested typed architectural authoring data into native Scene v2');
 sceneElements
     .command('compile')
-    .description('Compile a helix.scene-elements/1 or /2 document into a sealed, zero-download Scene v2 document')
+    .description('Compile a helix.scene-elements/1 or /2 document, including exact pinned Devices, into sealed Scene v2')
     .argument('<input>', 'semantic scene-elements JSON file')
     .requiredOption('-o, --output <file>', 'output .helix-scene.json file')
     .action(async (input, opts) => {
@@ -4706,6 +4706,11 @@ sceneElements
             scene: { id: scene.id, revision: scene.revision, integritySha256: scene.integrity.sha256 },
             primitives: scene.nodes.filter((node) => node.components?.some((component) => component.type === 'render.primitive')).length,
             resources: scene.resources.length,
+            devices: {
+                definitions: scene.itemDefinitions.filter((definition) => 'packageId' in definition).length,
+                instances: scene.itemInstances.length,
+                links: scene.deviceLinks?.length ?? 0,
+            },
             bundleFiles: bundleFiles.map((asset) => asset.uri),
         }, null, 2));
     }
@@ -5475,11 +5480,13 @@ unreal
     .option('--version <version>', 'release version', '1.0.0')
     .option('--max-players <n>', 'runtime policy max players', '1')
     .option('--rating <rating>', 'everyone, teen, or mature', 'everyone')
+    .option('--avatar-mode <mode>', 'universal or world-default (default: universal)', 'universal')
     .option('--out <file>', 'where to write it (default: <publishDir>/continuum/world-release.json)')
     .option('--json', 'machine-readable result')
     .action(async (publishDir, opts) => {
     try {
         const { buildUnrealWorldRelease } = await Promise.resolve().then(() => __importStar(require('./unreal/release')));
+        const avatarMode = (0, unreal_1.parseAvatarMode)(opts.avatarMode);
         const result = await buildUnrealWorldRelease({
             publishDir,
             worldId: opts.world,
@@ -5489,6 +5496,7 @@ unreal
             version: opts.version,
             maxPlayers: Number(opts.maxPlayers),
             contentRating: opts.rating,
+            avatarMode,
             outPath: opts.out,
         });
         if (opts.json) {