@helix3/helix-cli 0.1.14-helix3.166 → 0.1.14-helix3.168

package/README.md

@@ -65,6 +65,8 @@ The token is stored in `~/.helix/credentials.json` (mode `600`). It's sent as
 | `helix world audit\|source-audit\|perf-gate\|prove-live` | Run the blocking world QA, performance, and deployed-build identity gates. |
 | `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. |
+| `helix continuum receipt <job-id>` | Read the sanitized durable receipt for a completed Continuum publication. |
 | `helix unreal init\|validate\|doctor\|package [project]` | Create and gate a shared-runtime or native-game publish manifest, check optional editor MCP, and assemble a local upload-shaped package. |
 | `helix unreal publish <candidate> --world <slug>` | Upload a **cooked** Unreal world to HELIX: verify the candidate, presign, upload every artifact, finalize, and promote it as the world's active build. |
 | `helix doctor [--project <dir>]` | Print the environment + whether the @helix toolchain (CLI/MCP/SDK/manifest) is current. |

package/dist/builds/index.d.ts

@@ -0,0 +1,54 @@
+import { type BuildPackage, type ContinuumCid, type ContinuumObjectReference, type ContinuumPackageVariant, type ContinuumPackageVersion, type ContinuumPackageVersionReference, type RuntimeProfile } from '@hypersoniclabs/helix-manifest';
+export declare const PRIVATE_BUILD_DRAFT_SCHEMA: "helix.creator.build-draft/1";
+export type BuildDraft = {
+    schema: typeof PRIVATE_BUILD_DRAFT_SCHEMA;
+    visibility: 'private';
+    kind: BuildPackage['kind'];
+    base: ContinuumPackageVersionReference;
+    addOns: Array<{
+        /** Existing platform ItemSlotType or Package compatibility slot identifier. */
+        slot: string;
+        package: ContinuumPackageVersionReference;
+    }>;
+    overrides: Record<string, unknown>;
+    compatibility: BuildPackage['compatibility'];
+    provenance: ContinuumPackageVersion['provenance'];
+};
+export type BuildDraftInput = Omit<BuildDraft, 'schema' | 'visibility'>;
+export type BuildFreezeInput = {
+    packageId: string;
+    version: string;
+    root: ContinuumObjectReference;
+    variants?: ContinuumPackageVariant[];
+    contract: string;
+    expectedClosure: ContinuumPackageVersion['expectedClosure'];
+    /** Current registry/package metadata truth; this module does not duplicate it. */
+    slotTypes: readonly string[];
+    sourcePackages: readonly ContinuumPackageVersion[];
+};
+export type FrozenBuild = {
+    draft: BuildDraft;
+    manifest: ContinuumPackageVersion & {
+        build: BuildPackage;
+    };
+    manifestBytes: Uint8Array;
+    manifestCid: ContinuumCid;
+    sourceClosure: ContinuumPackageVersionReference[];
+};
+export type BuildFreezeResult = {
+    ok: true;
+    frozen: FrozenBuild;
+    errors: [];
+} | {
+    ok: false;
+    draft: BuildDraft;
+    errors: string[];
+};
+/** Start a mutable private draft through the same canonical Build normalizer. */
+export declare function createPrivateBuildDraft(input: BuildDraftInput): BuildDraft;
+/**
+ * Freeze a mutable private draft into the existing immutable U1 Build Package.
+ * Failure is data, not destruction: every refusal returns the untouched draft.
+ */
+export declare function freezeBuildDraft(draft: BuildDraft, input: BuildFreezeInput): BuildFreezeResult;
+export declare function frozenBuildArtifactKey(frozen: FrozenBuild, runtimeProfile: RuntimeProfile, compilerContract: string): ContinuumCid;

package/dist/builds/index.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRIVATE_BUILD_DRAFT_SCHEMA = void 0;
+exports.createPrivateBuildDraft = createPrivateBuildDraft;
+exports.freezeBuildDraft = freezeBuildDraft;
+exports.frozenBuildArtifactKey = frozenBuildArtifactKey;
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const identity_1 = require("../continuum/identity");
+exports.PRIVATE_BUILD_DRAFT_SCHEMA = 'helix.creator.build-draft/1';
+/** Start a mutable private draft through the same canonical Build normalizer. */
+function createPrivateBuildDraft(input) {
+    const build = (0, helix_manifest_1.normalizeBuildPackage)({
+        kind: input.kind,
+        base: input.base,
+        slots: input.addOns,
+        parameters: input.overrides,
+        compatibility: input.compatibility,
+    });
+    return {
+        schema: exports.PRIVATE_BUILD_DRAFT_SCHEMA,
+        visibility: 'private',
+        kind: build.kind,
+        base: build.base,
+        addOns: build.slots,
+        overrides: build.parameters,
+        compatibility: build.compatibility,
+        provenance: structuredClone(input.provenance),
+    };
+}
+/**
+ * Freeze a mutable private draft into the existing immutable U1 Build Package.
+ * Failure is data, not destruction: every refusal returns the untouched draft.
+ */
+function freezeBuildDraft(draft, input) {
+    const preserved = structuredClone(draft);
+    const errors = [];
+    if (draft.schema !== exports.PRIVATE_BUILD_DRAFT_SCHEMA ||
+        draft.visibility !== 'private') {
+        errors.push('Build draft must be a private helix.creator.build-draft/1 value');
+    }
+    try {
+        (0, identity_1.assertContinuumUuid)(input.packageId, 'Build Package id');
+        (0, identity_1.assertContinuumUuid)(draft.base.packageId, 'Build base Package id');
+        draft.addOns.forEach((addOn) => (0, identity_1.assertContinuumUuid)(addOn.package.packageId, `Build slot ${addOn.slot} Package id`));
+        input.sourcePackages.forEach((pkg) => (0, identity_1.assertContinuumUuid)(pkg.package.id, `Build source ${pkg.package.id} Package id`));
+    }
+    catch (error) {
+        errors.push(error instanceof Error ? error.message : String(error));
+    }
+    const slotTypes = new Set(input.slotTypes);
+    if (slotTypes.size !== input.slotTypes.length) {
+        errors.push('Build slot registry contains duplicate slot identifiers');
+    }
+    for (const addOn of draft.addOns) {
+        if (!slotTypes.has(addOn.slot)) {
+            errors.push(`Build add-on slot "${addOn.slot}" is not in the supplied slot registry`);
+        }
+    }
+    let build = null;
+    try {
+        build = (0, helix_manifest_1.normalizeBuildPackage)({
+            kind: draft.kind,
+            base: draft.base,
+            slots: draft.addOns,
+            parameters: draft.overrides,
+            compatibility: draft.compatibility,
+        });
+    }
+    catch (error) {
+        errors.push(error instanceof Error ? error.message : String(error));
+    }
+    if (!build || errors.length)
+        return failure(preserved, errors);
+    const sourceByIdentity = new Map(input.sourcePackages.map((pkg) => [packageIdentity(pkg.package.id, pkg.version), pkg]));
+    const basePackage = exactSourcePackage(build.base, sourceByIdentity, errors);
+    if (basePackage && basePackage.package.type !== build.kind) {
+        errors.push(`Build base Package type "${basePackage.package.type}" does not match Build kind "${build.kind}"`);
+    }
+    for (const slot of build.slots) {
+        const addOnPackage = exactSourcePackage(slot.package, sourceByIdentity, errors);
+        if (addOnPackage && addOnPackage.package.type !== 'addon') {
+            errors.push(`Build slot "${slot.slot}" must reference an addon Package, got "${addOnPackage.package.type}"`);
+        }
+    }
+    if (errors.length)
+        return failure(preserved, errors);
+    const manifest = {
+        schema: 'helix.continuum.package-version/1',
+        package: { id: input.packageId, type: 'build' },
+        version: input.version,
+        root: structuredClone(input.root),
+        dependencies: [
+            { slot: 'base', package: build.base, required: true },
+            ...build.slots.map((slot) => ({
+                slot: slot.slot,
+                package: slot.package,
+                required: true,
+            })),
+        ],
+        variants: structuredClone(input.variants ?? []),
+        compatibility: {
+            contract: input.contract,
+            requires: [...build.compatibility.requires],
+            provides: [...build.compatibility.provides],
+        },
+        provenance: structuredClone(draft.provenance),
+        expectedClosure: structuredClone(input.expectedClosure),
+        build,
+    };
+    const manifestResult = (0, helix_manifest_1.validateBuildPackage)(manifest);
+    if (!manifestResult.valid) {
+        return failure(preserved, manifestResult.errors);
+    }
+    const graphResult = (0, helix_manifest_1.validateContinuumGraph)({
+        packages: [...input.sourcePackages, manifestResult.manifest],
+        listings: [],
+        worldReleases: [],
+    });
+    if (!graphResult.valid)
+        return failure(preserved, graphResult.errors);
+    const normalizedManifest = graphResult.graph.packages.find((pkg) => pkg.package.id === input.packageId && pkg.version === input.version);
+    if (!normalizedManifest?.build) {
+        return failure(preserved, ['Validated graph did not retain the frozen Build Package']);
+    }
+    const sourceClosure = collectSourceClosure(normalizedManifest.build, sourceByIdentity);
+    const normalizedDraft = {
+        ...preserved,
+        base: normalizedManifest.build.base,
+        addOns: normalizedManifest.build.slots,
+        overrides: normalizedManifest.build.parameters,
+        compatibility: normalizedManifest.build.compatibility,
+    };
+    const frozenManifest = normalizedManifest;
+    return {
+        ok: true,
+        frozen: {
+            draft: normalizedDraft,
+            manifest: frozenManifest,
+            manifestBytes: (0, helix_manifest_1.canonicalContinuumPackageVersionBytes)(frozenManifest),
+            manifestCid: (0, helix_manifest_1.continuumPackageVersionCid)(frozenManifest),
+            sourceClosure,
+        },
+        errors: [],
+    };
+}
+function frozenBuildArtifactKey(frozen, runtimeProfile, compilerContract) {
+    const input = {
+        build: frozen.manifest.build,
+        sourceClosure: frozen.sourceClosure,
+        runtimeProfile,
+        compilerContract,
+    };
+    return (0, helix_manifest_1.runtimeArtifactKey)(input);
+}
+function failure(draft, errors) {
+    return { ok: false, draft, errors: [...new Set(errors)] };
+}
+function packageIdentity(packageId, version) {
+    return JSON.stringify([packageId, version]);
+}
+function referenceKey(reference) {
+    return JSON.stringify([
+        reference.packageId,
+        reference.version,
+        reference.manifestCid,
+    ]);
+}
+function exactSourcePackage(reference, sourceByIdentity, errors) {
+    const source = sourceByIdentity.get(packageIdentity(reference.packageId, reference.version));
+    if (!source) {
+        errors.push(`Build source is missing Package Version ${reference.packageId}@${reference.version}`);
+        return null;
+    }
+    let actualCid;
+    try {
+        actualCid = (0, helix_manifest_1.continuumPackageVersionCid)(source);
+    }
+    catch (error) {
+        errors.push(`Build source Package Version ${reference.packageId}@${reference.version} is invalid: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+    if (actualCid !== reference.manifestCid) {
+        errors.push(`Build source Package Version ${reference.packageId}@${reference.version} has CID ${actualCid}, expected ${reference.manifestCid}`);
+        return null;
+    }
+    return source;
+}
+function collectSourceClosure(build, sourceByIdentity) {
+    const collected = new Map();
+    const visited = new Set();
+    const visitReference = (reference) => {
+        const key = packageIdentity(reference.packageId, reference.version);
+        if (visited.has(key))
+            return;
+        visited.add(key);
+        const pkg = sourceByIdentity.get(key);
+        if (!pkg)
+            return;
+        const exact = {
+            packageId: pkg.package.id,
+            version: pkg.version,
+            manifestCid: (0, helix_manifest_1.continuumPackageVersionCid)(pkg),
+        };
+        collected.set(referenceKey(exact), exact);
+        pkg.dependencies.forEach((dependency) => visitReference(dependency.package));
+        pkg.scene?.children.forEach((child) => visitReference(child.scene));
+    };
+    visitReference(build.base);
+    build.slots.forEach((slot) => visitReference(slot.package));
+    return [...collected.values()].sort((left, right) => compareText(referenceKey(left), referenceKey(right)));
+}
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+//# sourceMappingURL=index.js.map

package/dist/builds/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builds/index.ts"],"names":[],"mappings":"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"}

package/dist/canary/cli.d.ts

@@ -0,0 +1,17 @@
+import { type PacificaHybridMigrationReport } from './pacifica';
+import type { ContinuumCanaryInput } from './plan';
+export type LoadedContinuumCanaryDescriptor = {
+    sourceDigest: string;
+    preflight?: PacificaHybridMigrationReport;
+    input?: ContinuumCanaryInput;
+};
+export declare const CANARY_FILE_READ_CONCURRENCY = 12;
+export declare class BoundedCanaryFileReader {
+    readonly limit: number;
+    private active;
+    private readonly waiting;
+    constructor(limit?: number);
+    run<T>(read: () => Promise<T>): Promise<T>;
+}
+/** Resolve descriptor-relative files once; the normal U8 publisher remains the only transport. */
+export declare function loadContinuumCanaryDescriptor(path: string): Promise<LoadedContinuumCanaryDescriptor>;

package/dist/canary/cli.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoundedCanaryFileReader = exports.CANARY_FILE_READ_CONCURRENCY = void 0;
+exports.loadContinuumCanaryDescriptor = loadContinuumCanaryDescriptor;
+const node_crypto_1 = require("node:crypto");
+const node_buffer_1 = require("node:buffer");
+const node_path_1 = require("node:path");
+const cli_1 = require("../continuum/cli");
+const pacifica_1 = require("./pacifica");
+exports.CANARY_FILE_READ_CONCURRENCY = 12;
+class BoundedCanaryFileReader {
+    limit;
+    active = 0;
+    waiting = [];
+    constructor(limit = exports.CANARY_FILE_READ_CONCURRENCY) {
+        this.limit = limit;
+        if (!Number.isInteger(limit) || limit < 1)
+            throw new TypeError('canary file read concurrency must be a positive integer');
+    }
+    async run(read) {
+        if (this.active >= this.limit)
+            await new Promise((resolve) => this.waiting.push(resolve));
+        else
+            this.active += 1;
+        try {
+            return await read();
+        }
+        finally {
+            const next = this.waiting.shift();
+            if (next)
+                next();
+            else
+                this.active -= 1;
+        }
+    }
+}
+exports.BoundedCanaryFileReader = BoundedCanaryFileReader;
+/** Resolve descriptor-relative files once; the normal U8 publisher remains the only transport. */
+async function loadContinuumCanaryDescriptor(path) {
+    const absolute = (0, node_path_1.resolve)(path);
+    const descriptorFile = await (0, cli_1.readSafeRegularFile)(absolute, 16 * 1024 * 1024, 'canary descriptor');
+    const bytes = descriptorFile.bytes;
+    const value = JSON.parse(node_buffer_1.Buffer.from(bytes).toString('utf8'));
+    const hydrated = await hydrateFileSources(value, (0, node_path_1.dirname)(descriptorFile.path), { nodes: 0 }, 0, new BoundedCanaryFileReader());
+    const sourceDigest = (hydrated.sourceDigest ?? (0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex')).toLowerCase();
+    if (!/^[a-f0-9]{64}$/.test(sourceDigest))
+        throw new TypeError('canary descriptor sourceDigest must be a SHA-256 digest');
+    if (hydrated.pacifica && hydrated.pacificaHybrid)
+        throw new TypeError('canary descriptor must choose pacifica or pacificaHybrid, not both');
+    let pacifica = hydrated.pacifica;
+    let preflight;
+    if (hydrated.pacificaHybrid) {
+        const migration = await (0, pacifica_1.loadPacificaHybridMigration)({
+            fixtureRoot: hydrated.pacificaHybrid.fixtureRoot,
+            objectSourcesByCid: hydrated.pacificaHybrid.objectSourcesByCid,
+        });
+        preflight = migration.report;
+        pacifica = migration.pacifica;
+    }
+    if (!pacifica)
+        return { sourceDigest, ...(preflight ? { preflight } : {}) };
+    const { pacificaHybrid: _hybrid, ...descriptor } = hydrated;
+    return {
+        sourceDigest,
+        ...(preflight ? { preflight } : {}),
+        input: { ...descriptor, sourceDigest, pacifica },
+    };
+}
+async function hydrateFileSources(value, base, budget, depth, reader) {
+    if (depth > 128)
+        throw new TypeError('canary descriptor exceeds the maximum nesting depth of 128');
+    budget.nodes += 1;
+    if (budget.nodes > 100_000)
+        throw new TypeError('canary descriptor exceeds the maximum value count of 100000');
+    if (Array.isArray(value))
+        return Promise.all(value.map((entry) => hydrateFileSources(entry, base, budget, depth + 1, reader)));
+    if (!value || typeof value !== 'object')
+        return value;
+    const record = value;
+    if (record.kind === 'inline')
+        throw new TypeError('JSON canary descriptors cannot embed inline bytes; use a descriptor-relative file source');
+    if (record.kind === 'file') {
+        if (typeof record.path !== 'string')
+            throw new TypeError('canary file source path must be a string');
+        const sourcePath = record.path;
+        const object = await reader.run(() => (0, cli_1.readSafeConfinedFile)(base, sourcePath, 1024 * 1024, `canary file source ${sourcePath}`));
+        return {
+            kind: 'inline', bytes: object.bytes, filename: (0, node_path_1.basename)(object.path),
+            ...(record.audience === 'private' || record.audience === 'public' ? { audience: record.audience } : {}),
+        };
+    }
+    const entries = await Promise.all(Object.entries(record).map(async ([key, entry]) => [key, await hydrateFileSources(entry, base, budget, depth + 1, reader)]));
+    return Object.fromEntries(entries);
+}
+//# sourceMappingURL=cli.js.map

package/dist/canary/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/canary/cli.ts"],"names":[],"mappings":"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"}

package/dist/canary/index.d.ts

@@ -0,0 +1,4 @@
+export * from './cli';
+export * from './inventory';
+export * from './pacifica';
+export * from './plan';

package/dist/canary/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./cli"), exports);
+__exportStar(require("./inventory"), exports);
+__exportStar(require("./pacifica"), exports);
+__exportStar(require("./plan"), exports);
+//# sourceMappingURL=index.js.map

package/dist/canary/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/canary/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,8CAA4B;AAC5B,6CAA2B;AAC3B,yCAAuB"}

package/dist/canary/inventory.d.ts

@@ -0,0 +1,46 @@
+export declare const PACIFICA_MATERIAL_BINDING_IDS: readonly ["raw-concrete", "polished-concrete", "ceramic-tile", "painted-metal", "white-marble"];
+export type CanarySourceState = "inline-input-required" | "candidate-adoption" | "staged-input-required" | "unresolved";
+export type CanarySourceInventoryEntry = {
+    key: string;
+    category: "material" | "vehicle" | "character" | "scene";
+    state: CanarySourceState;
+    path?: string;
+    url?: string;
+    localSha256?: string;
+    sha256?: string;
+    cid?: `cid:sha256:${string}`;
+    bytes?: number;
+    mediaType?: string;
+    legacyIds?: Record<string, string>;
+    adoption?: {
+        kind: "instant-world-adoption";
+        buildId: string;
+        contentSha256: string;
+    } | {
+        kind: "vault-adoption";
+        vaultAssetVersionId: string;
+    };
+    nextAction: string;
+};
+export declare const CANARY_MATERIAL_ARTIFACT_INVENTORY: readonly CanarySourceInventoryEntry[];
+export declare const AUTHORITATIVE_CANARY_INVENTORY: readonly CanarySourceInventoryEntry[];
+export type CanaryInventoryAudit = {
+    schema: "helix.creator.continuum-canary-inventory-audit/1";
+    status: "ready" | "blocked";
+    entries: number;
+    blockers: Array<{
+        key: string;
+        reason: string;
+        nextAction: string;
+    }>;
+};
+/**
+ * Local paths are hash-verified and backend adoption receipts are explicit
+ * inputs. A historical publish JSON alone never makes an isolated environment
+ * publish-ready.
+ */
+export declare function auditCanaryInventory(entries?: readonly CanarySourceInventoryEntry[], available?: {
+    inlineCids?: ReadonlySet<string>;
+    stagedCids?: ReadonlySet<string>;
+    verifiedAdoptions?: ReadonlySet<string>;
+}): Promise<CanaryInventoryAudit>;