@helix3/helix-cli 0.1.14-helix3.159 → 0.1.14-helix3.161

package/README.md

@@ -250,6 +250,12 @@ A published world ships only its **built bundle**, so there is nothing on the se
   channel for exactly that reason.
 - **Limit**: 128 MiB compressed, checked locally before anything is uploaded.
 
+Before upload, module-based multiplayer worlds are checked for server realizability: every bank must
+be published with the declared checksum and the shared manifest validator must accept all module
+budgets under the 100,000 tick-node ceiling. Fix the named module/bank when this gate refuses a
+publish. For exceptional recovery only, `--skip-realizability-check` bypasses this check; flat-v0
+worlds are unaffected.
+
 The programmatic surface (`publishWorld`, `checkBundle`, `whoAmI`, …) is exported for other CLI
 modules. Agent integrations should instruct or delegate to the `helix` commands above rather than
 reimplementing operational behavior in a transport package.

package/dist/index.js

@@ -454,6 +454,7 @@ program
     .argument('[directory]', 'bundle directory', '.')
     .option('--thumbnail <file>', 'cover image (png, jpg/jpeg, webp, avif, or gif); otherwise uses thumbnail.<ext> at the bundle root')
     .option('--skip-subpath-check', 'skip the pre-publish sub-path load check (not recommended: it is the only gate that serves the bundle the way production does)')
+    .option('--skip-realizability-check', 'skip the pre-publish server-realizability gate (not recommended: it is what stops you publishing a module world whose banks the server cannot resolve)')
     .option('--description <text>', `catalog description, max ${lib_1.WORLD_DESCRIPTION_MAX} chars (pass "" to clear). helix.json cannot carry this — the manifest schema forbids unknown fields`)
     .option('--description-file <path>', 'read the catalog description from a file')
     .option('--upload-source', "Also upload this project's source so you can edit this world from the HELIX website later. " +
@@ -511,6 +512,7 @@ program
             description,
             uploadSource: opts.uploadSource,
             sourceDir: opts.sourceDir ? (0, node_path_1.resolve)(opts.sourceDir) : undefined,
+            skipRealizabilityCheck: opts.skipRealizabilityCheck,
         });
         console.log(`✔ Published "${result.title}" build ${result.buildNumber}`);
         if (result.playUrl)