@helix3/helix-cli 0.1.20-helix3.390 → 0.1.20-helix3.392

package/dist/continuum/pull.js

@@ -13,8 +13,12 @@ async function pullContinuumPackageSource(api, packageId, version, outputDirecto
     if (!validation.valid)
         throw new TypeError(`Package Version is invalid: ${validation.errors.join('; ')}`);
     const manifest = validation.manifest;
-    if (!manifest.source)
-        throw new TypeError('Package Version has no creator source bundle; it must be converted before it can be pulled for remix');
+    if (!manifest.source) {
+        throw new TypeError('Package Version has no creator source bundle, so there is nothing to pull for remix. ' +
+            'A publish-glb (asset/character) Package stores only the sealed GLB: read its manifest with ' +
+            'GET /api/v1/continuum/public/packages/<packageId>/versions/<version>, then fetch the GLB bytes from ' +
+            'the public object/artifact bytes route the manifest names.');
+    }
     const downloaded = await api.readPackageObject(packageId, version, inspection.manifestCid, manifest.source.cid);
     if (downloaded.mediaType !== manifest.source.mediaType || downloaded.bytes.byteLength !== manifest.source.bytes || (0, helix_manifest_1.cidFromBytes)(downloaded.bytes) !== manifest.source.cid) {
         throw new TypeError('downloaded source bundle does not match its exact Package descriptor');

package/dist/continuum/pull.js.map

@@ -1 +1 @@
-{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../src/continuum/pull.ts"],"names":[],"mappings":";;AAwBA,gEAiCC;AAzDD,6CAAqC;AACrC,mEAA6H;AAC7H,+CAA2D;AAC3D,yCAAoC;AACpC,mEAAoE;AACpE,iDAA0F;AAmBnF,KAAK,UAAU,0BAA0B,CAC9C,GAA2B,EAC3B,SAAiB,EACjB,OAAe,EACf,eAAuB;IAEvB,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,IAAA,gDAA+B,EAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,CAAC,UAAU,CAAC,KAAK;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1G,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,SAAS,CAAC,sGAAsG,CAAC,CAAC;IAClJ,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChH,IAAI,UAAU,CAAC,SAAS,KAAK,QAAQ,CAAC,MAAM,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,IAAA,6BAAY,EAAC,UAAU,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAC1K,MAAM,IAAI,SAAS,CAAC,sEAAsE,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,MAAM,GAAG,IAAA,yCAA0B,EAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,IAAA,mBAAO,EAAC,eAAe,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,IAAA,gBAAK,EAAC,MAAM,CAAC,CAAC;QACpB,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;IACtE,CAAC;IACD,MAAM,IAAA,gBAAK,EAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,IAAA,2CAA4B,EAAC,MAAM,EAAE,IAAA,mBAAO,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG;QACf,MAAM,EAAE,gCAAgC;QACxC,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE;QACnG,aAAa,EAAE,QAAQ;QACvB,OAAO,EAAE,6IAA6I;KACvJ,CAAC;IACF,MAAM,IAAA,oBAAS,EAAC,IAAA,mBAAO,EAAC,MAAM,EAAE,qBAAqB,CAAC,EAAE,oBAAM,CAAC,IAAI,CAAC,IAAA,mCAAkB,EAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAChI,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC/H,CAAC"}
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../src/continuum/pull.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -36,6 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 require("./stdioBlocking");
 const itemSetVersion_1 = require("./itemSetVersion");
+const itemPublishVersion_1 = require("./itemPublishVersion");
 const moveUx_1 = require("./visualQa/moveUx");
 const validate_1 = require("./vehicle/validate");
 const commander_1 = require("commander");
@@ -1706,6 +1707,53 @@ itemThumbnail
         fail(`✖ ${(0, itemThumbnail_1.describeThumbnailError)(error, itemId)}`);
     }
 });
+// Ship a corrected mesh onto an already-published GLB add-on/prop/avatar IN PLACE: seal a new Version of the item's
+// own Continuum Package, then move the item pointer. On a listed item the move is refused by the visual-QA gate (the
+// sealed Version stays behind), and the refusal names the two finishing steps: `item visual-qa --package-version vN
+// --submit`, then `item set-version`. This is step 1 of `VERSION_MOVE_FLOW_HELP`.
+item
+    .command('publish-version')
+    .description('Ship a corrected mesh onto an already-published GLB add-on/prop/avatar, IN PLACE — new Package Version, same item id/owner/listings; every existing owner gets it at their next spawn')
+    .argument('<item-id>', 'existing, already-published universal item UUID')
+    .argument('<file>', 'corrected mesh (binary glTF, .glb)')
+    .requiredOption('--reason <text>', 'required, lands in the audit ledger (e.g. "fixed poke-through on the left cuff")')
+    .option('--notes <text>', 'optional creator-facing changelog note')
+    .option('--expected-current-version-id <uuid>', 'refuse if the item has moved off this Package Version since you last read it')
+    .option('--update-id <uuid>', 'idempotency key — retrying with the same id never double-publishes')
+    .option('--json', 'machine-readable output')
+    .addHelpText('after', moveUx_1.VERSION_MOVE_FLOW_HELP)
+    .action(async (itemId, file, opts) => {
+    const creds = requireAuth();
+    try {
+        const result = await (0, itemPublishVersion_1.publishItemVersion)(itemId, (0, node_path_1.resolve)(file), {
+            reason: opts.reason,
+            notes: opts.notes,
+            expectedCurrentVersionId: opts.expectedCurrentVersionId,
+            updateId: opts.updateId,
+            onProgress: (message) => !opts.json && console.log(message),
+        }, creds);
+        if (opts.json) {
+            console.log(JSON.stringify({ ...result, refusal: result.refusal ? { status: result.refusal.status, body: result.refusal.body } : undefined }, null, 2));
+            if (!result.move)
+                process.exitCode = 1;
+            return;
+        }
+        if (result.move) {
+            for (const line of (0, itemSetVersion_1.renderSetVersionSuccess)(result.move))
+                console.log(line);
+            console.log(`  sealed: ${result.packageId}@${result.version} (manifest ${result.manifestCid})`);
+            return;
+        }
+        console.log(`✔ Sealed ${result.packageId}@${result.version} — a new Version of ${itemId} (manifest ${result.manifestCid}).`);
+        console.log(`  The move is gated by visual QA; the seal is left in place and is reused by a retry with the same mesh.`);
+        if (result.refusal)
+            console.log((0, itemSetVersion_1.renderSetVersionError)(result.refusal));
+        process.exitCode = 1;
+    }
+    catch (error) {
+        fail(error instanceof lib_1.ApiError ? error.render() : `✖ ${error instanceof Error ? error.message : String(error)}`);
+    }
+});
 // Move a (listed) item to an already-sealed Package Version of its own package. The visual-QA gate refuses the move
 // until that version has a passing run; a refusal prints the server's message first because it names the next command.
 item