@hypersoniclabs/helix-cli 0.1.25-helix3.506 → 0.1.25-helix3.507

package/README.md

@@ -76,6 +76,7 @@ The token is stored in `~/.helix/credentials.json` (mode `600`). It's sent as
 | `helix item set-version <item-id> --package-version <v> --reason <text> [--expected-current-version-id <uuid>] [--as-admin] [--json]` | Move an item to a sealed Package Version of its own package (pin resolved from the public Package API; `POST /api/v1/universal-items/<id>/versions`). The flow for a **listed** item: `continuum publish-package` seals vN → `item set-version`; the visual check is advisory and never gates the move. A refusal (a technical failure or content safety) prints the server's plain reason first, then the remedy. An unknown version lists the sealed ones. A **vehicle** moves its car with the pin: the version's sealed root (role `vehicle-definition`) is verified against the manifest and sent as `vehiclePackage`, the same rider `vehicle publish --item` sends; a version without one is refused with a pointer to that resume. A version the item **already had** is a rollback: `PUT /api/v1/universal-items/<id>/versions/current { revision, reason }` (the server restores that revision's retained `vehiclePackage`; a pin-only revision has none and is refused). `--as-admin` (platform admins, for an item another account created) posts the same body to `POST /api/v1/admin/universal-items/<id>/versions`: same gates (visual QA included, no override), `--reason` recorded with you as the actor. |
 | `helix item thumbnail refresh <item-id> [--force] [--dry-run] [--json]` | Re-render a published item's canonical thumbnail from its **active Package Version** with the standard server renderer (`POST /api/v1/universal-items/<id>/thumbnail/regenerate`, owner or admin). Prints the status (`generated` / `current` / `dry-run`), old -> new thumbnail URL, renderer version and the source lane + Package Version. `--dry-run` writes nothing; `--force` re-renders even when the stored thumbnail is current. Moving an item to a new Package Version now refreshes the thumbnail automatically unless you uploaded one. An older backend answers 404 and the CLI says it does not support thumbnail refresh yet. Not the world `helix thumbnail set <slug>` command. |
 | `helix item thumbnail set <item-id> <image> [--json]` | Upload your own thumbnail (png/jpg/webp, up to 10 MiB, checked locally) for a published item (`PUT /api/v1/universal-items/<id>/thumbnail`, moderated). A creator upload stays in place across version moves until you run `thumbnail refresh --force`. 403 = you are not the item's owner. |
+| `helix item lods <packageId>[@version] \| --item <id> \| --glb <file> [--out <dir>] [--variant <id>] [--api-url <url>] [--json]` | Compile the `helix.item-lod/1` Runtime Artifact for a published prop, Device or vehicle Package Version: LOD1 (at most 25% of the triangles, textures at most 512 px) and LOD2 (at most 300 triangles, textures at most 256 px), each its own GLB with its own downsampled UASTC KTX2 textures and a measured `maxErrorM`, plus an 8-view 512 px octahedral impostor atlas. Content-addressed and deterministic; a source of 300 triangles or fewer waives the LOD1 cap; skinned input (avatars, add-ons) is refused. Local preview; the backend worker is the catalogue's source of truth. See [docs/item-lod.md](docs/item-lod.md). |
 | `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, including [declarative character hand reach](docs/device-hand-reach.md). |
 | `helix device test [dir] [--mode single\|multiplayer\|both] [--json]` | Exercise every interaction, persistence remount, and deterministic one-/two-client authority convergence. |

package/dist/index.js

@@ -41,17 +41,18 @@ const moveUx_1 = require("./visualQa/moveUx");
 const validate_1 = require("./vehicle/validate");
 const commander_1 = require("commander");
 const commands_1 = require("./sceneHlod/commands");
+const command_1 = require("./itemLod/command");
 const commands_2 = require("./scenePerf/commands");
 const commands_3 = require("./sceneSplit/commands");
-const command_1 = require("./city/import/cs2/command");
+const command_2 = require("./city/import/cs2/command");
 const buildingsCommand_1 = require("./cs2/convert/buildingsCommand");
 const commands_4 = require("./sceneCreate/commands");
 const commands_5 = require("./city/source/commands");
-const command_2 = require("./city/import/osm/command");
-const command_3 = require("./city/buildings/command");
+const command_3 = require("./city/import/osm/command");
+const command_4 = require("./city/buildings/command");
 const commands_6 = require("./model/commands");
-const command_4 = require("./city/roads/command");
-const command_5 = require("./cs2/restyle/command");
+const command_5 = require("./city/roads/command");
+const command_6 = require("./cs2/restyle/command");
 const propsCommand_1 = require("./cs2/propsCommand");
 const placementRequest_1 = require("./placementRequest");
 const bundle_1 = require("./bundle");
@@ -6061,6 +6062,7 @@ 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, command_1.registerItemLodCommand)(item, fail);
 (0, commands_2.registerScenePerfCommands)(scene);
 (0, commands_3.registerSceneSplitCommands)(scene, fail);
 (0, commands_4.registerSceneCreateCommands)(scene, fail);
@@ -6068,11 +6070,11 @@ const city = program
     .command('city')
     .description('City pipelines: the neutral city source every importer writes and every generator reads');
 (0, commands_5.registerCitySourceCommands)(city, fail);
-(0, command_2.registerCityImportOsm)(city, fail);
-(0, command_3.registerCityBuildings)(city, fail);
-(0, command_1.registerCityImportCs2)(city, fail);
-(0, command_4.registerCityRoadsCommands)(city, fail);
-(0, command_5.registerCityRoadsRestyleCs2)(city, fail);
+(0, command_3.registerCityImportOsm)(city, fail);
+(0, command_4.registerCityBuildings)(city, fail);
+(0, command_2.registerCityImportCs2)(city, fail);
+(0, command_5.registerCityRoadsCommands)(city, fail);
+(0, command_6.registerCityRoadsRestyleCs2)(city, fail);
 (0, propsCommand_1.registerCityPropsKit)(city, fail);
 (0, commands_6.registerModelCommands)(program, fail);
 const sceneImport = scene