@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

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>;

package/dist/canary/inventory.js

@@ -0,0 +1,499 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTHORITATIVE_CANARY_INVENTORY = exports.CANARY_MATERIAL_ARTIFACT_INVENTORY = exports.PACIFICA_MATERIAL_BINDING_IDS = void 0;
+exports.auditCanaryInventory = auditCanaryInventory;
+const catalog_1 = require("../sceneImport/materials/catalog");
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+exports.PACIFICA_MATERIAL_BINDING_IDS = [
+    "raw-concrete",
+    "polished-concrete",
+    "ceramic-tile",
+    "painted-metal",
+    "white-marble",
+];
+const staged = (key, category, path, sha256, bytes, mediaType, legacyIds = {}) => ({
+    key,
+    category,
+    state: "staged-input-required",
+    path,
+    sha256,
+    cid: `cid:sha256:${sha256}`,
+    bytes,
+    mediaType,
+    legacyIds,
+    nextAction: "Create a Vault Asset Version through the existing Vault upload flow, then record its version ID and use U8 vault-adoption. Do not inline or copy the bytes.",
+});
+const materialInventory = [
+    ...catalog_1.HELIX_OFFICIAL_MATERIAL_SUBSET,
+    ...catalog_1.HELIX_PACIFICA_MATERIAL_ADDITIONS,
+].map((entry) => ({
+    key: `material.${entry.id}`,
+    category: "material",
+    state: "unresolved",
+    legacyIds: {
+        catalogId: entry.id,
+        ...(entry.legacy?.sourceAssetId
+            ? { sourceAssetId: entry.legacy.sourceAssetId }
+            : {}),
+    },
+    nextAction: entry.id === "smooth-plaster"
+        ? "Author a factor-only base color and reuse the exact raw-concrete normal/ORM CIDs with low normalScale; do not create duplicate textures."
+        : entry.id === "clear-glass"
+            ? "Publish the procedural transparent-dielectric definition with no texture objects."
+            : "Use the inventoried albedo/normal/ORM KTX2 objects in the existing U10 material recipe.",
+}));
+const materialAlbedos = {
+    "raw-concrete": [
+        "4184de0b297c3ef94daf33f930de1ab5080612034e93f227aa566e24785dd0a8",
+        230_047,
+    ],
+    "light-oak": [
+        "6119b99de4957ce3303f06992bee14f95687b9ce2e05438a84ac9f25f5e177b4",
+        210_175,
+    ],
+    "painted-metal": [
+        "dbe55208e0b25a29a33cb384014407f9828b8a471823abf3555c2c3622fca432",
+        215_862,
+    ],
+    "weathered-brick": [
+        "6f5f9859ea02da05f3585b87a0e961b8207d67b60b03531fc3700d6cf7e59a28",
+        232_567,
+    ],
+    granite: [
+        "53ffda4ae56077bc9ea541e89993cb6768389180663ca2f013424c6624693d27",
+        284_242,
+    ],
+    "ceramic-tile": [
+        "1ace6b28d2ef8cebcf9d94b3debbf06a12c5f76edd06646287a9c04a77bf0f09",
+        94_029,
+    ],
+    "cloth-fabric": [
+        "9aaeaa1656f810fd7ed1333ba871c725f5018c605e16d335f1bca6f12aa96d57",
+        233_194,
+    ],
+    leather: [
+        "f84e38c1b248c7bf4f9146084558d79afdbb004891e2a6dd53642f568710eb0b",
+        228_331,
+    ],
+    grass: [
+        "7ecb4b8af4946a844f203f655378c03fb48b8cee907230200d77d7b6d418bf1d",
+        276_718,
+    ],
+    "polished-concrete": [
+        "b6c1aac95700c086c25d18dab00fee5020b8eef3ee72fb81b798f3dd6db205b8",
+        184_645,
+    ],
+    "white-marble": [
+        "8c47c40a4da59b720aaa3ca84b462ed9a8f3ad9b83cbb13a74ca1e6ea6592279",
+        209_532,
+    ],
+};
+const materialLinearMaps = {
+    "raw-concrete": {
+        normal: [
+            "644cbad0af55c2e4c097729956839b7dba49abb99d0ed4beb9e8583f69f3df60",
+            902_389,
+        ],
+        orm: [
+            "eae51d7300ddcdb2b06acda9b7223024a971ae69ebb00e5ca7a059353228115c",
+            954_955,
+        ],
+    },
+    "light-oak": {
+        normal: [
+            "37e5b6b40ebc4ad5f4717a0ab3735c8d15cf7c574e2995b50cfbb988fd526ba7",
+            582_750,
+        ],
+        orm: [
+            "bc8477583321afab524288d0c4e069af9a4da34ba4f80718fcbfd24a57b4196a",
+            462_896,
+        ],
+    },
+    "painted-metal": {
+        normal: [
+            "b6ea53a8531e99dd7092e7188ccf2fdbdb608747e586aa3df28f0449f648b274",
+            604_480,
+        ],
+        orm: [
+            "23d7a553983ba0e949b745ce022bb8df3427f9c0310aa4b33280d3db09113e34",
+            1_017_214,
+        ],
+    },
+    "weathered-brick": {
+        normal: [
+            "0ca763e9d25d19e4f7bc80ebf1577fc82fe63e8cd251f14cc0af8a95e44607bb",
+            1_147_825,
+        ],
+        orm: [
+            "84252d4ca2d62dbe55a0f43b0c5f19db7198b656122ca84bd5b9b8c9701a3f26",
+            460_898,
+        ],
+    },
+    granite: {
+        normal: [
+            "04830440e07c198e600af97a67c8582aa43e2fd214e40e17b5bb7beba7877237",
+            818_087,
+        ],
+        orm: [
+            "aefb2a11dd67a2ffb9f31a48884eae333a34cb3fb834c1b1fb5a1eb3a58689ff",
+            509_417,
+        ],
+    },
+    "ceramic-tile": {
+        normal: [
+            "aeefa254794c0c1a00f9ae557c316d13ef590b2ec210b822228952fdf63e77b3",
+            381_777,
+        ],
+        orm: [
+            "52be234c702445d1acb8bb76d9e874b14d111da6960f8368eae723c1da0c217e",
+            532_184,
+        ],
+    },
+    "cloth-fabric": {
+        normal: [
+            "55c4c6c8585fc586b453c84de561a68b101690fe7620f9583dc5878f430945be",
+            988_333,
+        ],
+        orm: [
+            "4d30b37a23157fad166180e0f4129deca52dbdcd2e83f3987d5f98982aa78a02",
+            776_474,
+        ],
+    },
+    leather: {
+        normal: [
+            "5927b7079d9d1388d1ca96e199a74a1f056354f7b37a1bff9d4862ef69e309e5",
+            864_098,
+        ],
+        orm: [
+            "fe3babeba382a8ef01cc736ac52ed1a02e65782cf0fa53d9e26a704761077c64",
+            1_065_929,
+        ],
+    },
+    grass: {
+        normal: [
+            "5a427045c5bab9ef9ad0f83e16a5c135ee435e1bfa5bfbe6a7073799d605e6da",
+            1_267_519,
+        ],
+        orm: [
+            "bfee88ba0ca7e21df043eb4c34dd9b4e492c8b8c982341500bb85f54af08b446",
+            1_061_811,
+        ],
+    },
+    "polished-concrete": {
+        normal: [
+            "9060f40351b855cc66d90006df3370ae28bc42cec4eec9264d19c72bde88b235",
+            612_400,
+        ],
+        orm: [
+            "3cfbb3e00e87a5dbe4e92c9bf1d8bd6d496392cdfa7195dfbf6c22ae4ec096f2",
+            955_423,
+        ],
+    },
+    "white-marble": {
+        normal: [
+            "ca0c6b2d34694f61093b86b803dc0909200d240739a52851688fad7d97f00f7f",
+            486_162,
+        ],
+        orm: [
+            "ed24365535fdea32176b9a4b0a08eb9068945d623cff5b2649975c2913abcf3d",
+            579_632,
+        ],
+    },
+};
+exports.CANARY_MATERIAL_ARTIFACT_INVENTORY = [
+    ...Object.entries(materialAlbedos).map(([id, [sha256, bytes]]) => ({
+        key: `material.${id}.base-color`,
+        category: "material",
+        state: "inline-input-required",
+        path: `/Users/jack/Developer/helix/sources/helix-web-engine-new/asset-packs/helix-materials/materials/${id}/albedo.ktx2`,
+        sha256,
+        cid: `cid:sha256:${sha256}`,
+        bytes,
+        mediaType: "image/ktx2",
+        nextAction: "Hash-verify and use U8 inline ingestion; this 1024 KTX2 already carries 11 mips.",
+    })),
+    ...Object.entries(materialLinearMaps).flatMap(([id, maps]) => ["normal", "orm"].map((map) => {
+        const [sha256, bytes] = maps[map];
+        const inline = bytes <= 1024 * 1024;
+        return {
+            key: `material.${id}.${map}`,
+            category: "material",
+            state: inline
+                ? "inline-input-required"
+                : "staged-input-required",
+            path: `/Users/jack/Developer/helix/run/continuum-canary-materials/${id}/${map}.ktx2`,
+            sha256,
+            cid: `cid:sha256:${sha256}`,
+            bytes,
+            mediaType: "image/ktx2",
+            nextAction: inline
+                ? "Hash-verify and use U8 inline ingestion; this linear UASTC RDO 1.5 KTX2 carries 11 mips."
+                : "Stage through the existing Vault upload flow, then use U8 no-copy adoption; do not degrade or base64-upload this >1 MiB KTX2.",
+        };
+    })),
+    ...["normal", "orm"].map((map) => {
+        const [sha256, bytes] = materialLinearMaps["raw-concrete"][map];
+        return {
+            key: `material.smooth-plaster.${map}`,
+            category: "material",
+            state: "inline-input-required",
+            path: `/Users/jack/Developer/helix/run/continuum-canary-materials/raw-concrete/${map}.ktx2`,
+            sha256,
+            cid: `cid:sha256:${sha256}`,
+            bytes,
+            mediaType: "image/ktx2",
+            legacyIds: { sharedFrom: `raw-concrete.${map}` },
+            nextAction: "Reuse the exact raw-concrete object CID in the factor-only smooth-plaster recipe; do not duplicate bytes.",
+        };
+    }),
+].sort((a, b) => a.key.localeCompare(b.key));
+const vehicleInventory = [
+    staged("vehicle.subaru.base", "vehicle", "/Users/jack/Developer/helix/dev-fixtures/vehicles/converted/subaru-wrx-sti/subaru_wrx_sti_full.glb", "49d1f8d89731508a9c8bead6784df847147c42ec29162a5d8b67fb891cc5ccd4", 8_713_272, "model/gltf-binary", { sourceCommit: "84adef54136ab37d608b0f6162e076368cfa2085" }),
+    {
+        ...staged("vehicle.subaru.addon.tomei.mesh", "vehicle", "/Users/jack/Developer/helix/worktrees/helix-web-engine-new/vehicle-v2/asset-packs/vehicles/parts/subik/meshes/subik_exhaust_raceJDMInvidia.glb", "2047d61611fdae07cc2b3c229d16ded5435ea7993fcdfbe630d66b5cfda3de0e", 106_600, "model/gltf-binary", {
+            slot: "pwr.exhaust",
+            slotType: "vehicle.exhaust@1",
+            partId: "subik_exhaust_raceJDMInvidia",
+        }),
+        state: "inline-input-required",
+        nextAction: "Read and hash-verify this sub-1 MiB GLB, then use U8 exact inline ingestion; CID dedup prevents copying an existing object.",
+    },
+    {
+        ...staged("vehicle.subaru.addon.g25.mesh", "vehicle", "/Users/jack/Developer/helix/worktrees/helix-web-engine-new/vehicle-v2/asset-packs/vehicles/parts/subik/meshes/subik_turbo_stage1.glb", "7ba25ff2cdfbce621853442c031d53526fc8cc7112227320cc92e64f81c65b51", 34_112, "model/gltf-binary", {
+            slot: "pwr.induction",
+            slotType: "vehicle.induction@1",
+            partId: "subik_turbo_stage2",
+        }),
+        state: "inline-input-required",
+        nextAction: "Read and hash-verify this sub-1 MiB GLB, then use U8 exact inline ingestion; CID dedup prevents copying an existing object.",
+    },
+    {
+        ...staged("vehicle.subaru.addon.tomei.definition", "vehicle", "/Users/jack/Developer/helix/worktrees/helix-web-engine-new/vehicle-v2/asset-packs/vehicles/parts/subik/parts/subik.exhaust.subik_exhaust_raceJDMInvidia.part.json", "84e289e4e3ae39f09343e8a64fa3926c44720df1cf05790a02474300a15cac7c", 6_172, "application/json", {
+            slot: "pwr.exhaust",
+            sourceCommit: "84adef54136ab37d608b0f6162e076368cfa2085",
+        }),
+        state: "inline-input-required",
+        nextAction: "Use this functional part definition as the add-on Package root and ingest it inline after exact hash verification.",
+    },
+    {
+        ...staged("vehicle.subaru.addon.g25.definition", "vehicle", "/Users/jack/Developer/helix/worktrees/helix-web-engine-new/vehicle-v2/asset-packs/vehicles/parts/subik/parts/subik.induction.subik_turbo_stage2.part.json", "102477478cf2e08b12a5d2f4d94e7f62f2d3bb3af6aadca83c2ed4ebc1dd3aa2", 7_534, "application/json", {
+            slot: "pwr.induction",
+            sourceCommit: "84adef54136ab37d608b0f6162e076368cfa2085",
+        }),
+        state: "inline-input-required",
+        nextAction: "Use this functional part definition as the add-on Package root and ingest it inline after exact hash verification.",
+    },
+    {
+        key: "vehicle.subaru.functional-definition",
+        category: "vehicle",
+        state: "unresolved",
+        legacyIds: { sourceCommit: "84adef54136ab37d608b0f6162e076368cfa2085" },
+        nextAction: "Freeze the existing vehicle-v2 handling, slots, controls, audio, camera, and runtime-module contract into one canonical vehicle definition object. The mesh alone is not publishable.",
+    },
+];
+const characterSources = [
+    [
+        "base-female",
+        "bcafa7e1-9487-422d-8c08-e152b81f1f45",
+        "bce4c302-7d1e-4360-99c1-d5c2972dfc6e",
+        "3314a97abdc871d2c12e4f9dd32791ea30fefe76970879d02ccecc0ddca7e056",
+        700_668,
+        "https://eu.uni-items-web.dev.helix-cdn.com/universal-items/cc5aabad-97da-46e3-ae3a-e15193c03940/web-female-base.web.glb",
+    ],
+    [
+        "head",
+        "e807a3af-2dbe-471b-a0bc-0116ed6d80e4",
+        "fe59f3bf-226b-4a5a-baea-fb9a148de53c",
+        "3cc56f9c055c7bd1d0773aa6bb079ba0cf749d164b8c11ffe0ec77926a691294",
+        190_752,
+        "https://eu.uni-items-web.dev.helix-cdn.com/universal-items/b0ef42c9-7baf-450e-97f0-aa5e311fbd8a/web-head-f-default.web.glb",
+    ],
+    [
+        "top",
+        "f3104a2a-895c-419a-8963-2ec01571878e",
+        "8a118992-1f30-428f-8ff7-4885b13276ca",
+        "64f33669f1935c600873f95d80f60fc4e24a2f9511f6c54b138640d9685fc589",
+        226_396,
+        "https://eu.uni-items-web.dev.helix-cdn.com/universal-items/7e468dab-54af-4303-afb9-35638ca00dfe/web-f-basic-t-shirt.web.glb",
+    ],
+    [
+        "bottom",
+        "a0038607-64f0-46a0-a067-30565c4fa6ac",
+        "40e7cb66-b69e-42bf-b93f-b885880b948e",
+        "c0b7c1c1b9cb33a8ab0d9a383f55cf50cd96770f340067db8542d393f74493e5",
+        293_028,
+        "https://eu.uni-items-web.dev.helix-cdn.com/universal-items/6eda726e-e8cf-48b0-b24a-81ddaab32ce0/web-wearable-f-cargo-pants.web.glb",
+    ],
+    [
+        "footwear",
+        "c40f1f46-44b9-4a1d-b854-06665d50b452",
+        "d8dcf47a-2b0a-4039-8d6b-e30622ee160a",
+        "2e6f8f75f06685d9e6120143dc2c32415d828ff5b8d366cd8d4eb34ceff59316",
+        246_368,
+        "https://eu.uni-items-web.dev.helix-cdn.com/universal-items/c8ea113f-6dd6-466b-abf1-6ccfbb2ce444/web-wearable-f-chunky-knit-sneakers.web.glb",
+    ],
+    [
+        "hair",
+        "7d91fc8a-b828-411e-a1aa-59c9f2ba2b7e",
+        "e9e65369-fe40-491f-b60b-def8f83f7400",
+        "4eb27f26d0aea29697e4594a4f27f328203d122ceb72a3f82cd8c93569b7d38f",
+        687_392,
+        "https://eu.uni-items-web.dev.helix-cdn.com/universal-items/a1e18928-ce0c-47a4-813c-aae25816b3b6/web-wearable-f-ponytail.web.glb",
+    ],
+];
+const characterInventory = characterSources.map(([key, universalItemId, assetId, sha256, bytes, url]) => ({
+    key: `character.${key}`,
+    category: "character",
+    state: "inline-input-required",
+    url,
+    sha256,
+    cid: `cid:sha256:${sha256}`,
+    bytes,
+    mediaType: "model/gltf-binary",
+    legacyIds: { universalItemId, assetId },
+    nextAction: "Download through the existing Universal Item asset URL, hash/size verify, ingest the sub-1 MiB bytes through U8 inline ingestion, then attach the exact Package pin. CID dedup prevents duplication.",
+}));
+const pacificaR21Leaves = [
+    [
+        "exterior",
+        "22dbd011afaebd51b74268e1a690ad93c78ddf754323101affb24596bc0efb6a",
+        "0abb5fca4ad25dca0dcb1447a214e81d1971021417b32abdf26f9ea67bde4840",
+        697_695,
+    ],
+    [
+        "sd",
+        "ff9d34863cd1278da39e562f30fe9156f73d235115dac42224f2d52a1a0f0f8e",
+        "12d18c3260ff2d76f54e076600349c38bf8b428c49c7e4b21e5c0bc50d40f79f",
+        604_912,
+    ],
+    [
+        "interior-f0-a-a",
+        "ba029e93f3ffb58e4fdcf91fc4baab4c2e42ee5335e4c67a581419c8abc843d1",
+        "ab7a30c3e04bb121f9d7d3d606e4b93605263b63df01e4ba01d63292b80419a7",
+        719_525,
+    ],
+    [
+        "interior-f0-a-b",
+        "2e195984dfcfa4d5f958a25b84aa381ae0fba299ad166665511a496627754a11",
+        "dbb7de6b7674743cb00b65caf5b3483d3646ef75729974f61ff5d312da16859c",
+        664_423,
+    ],
+    [
+        "interior-f0-b-a",
+        "eee6c75559f94a267f94bf3877b77fbca47d7d0746e146000b6633db0b83b439",
+        "24dc0613a985d04a6a7d20995909f1110639f79a6ac7d68df405d977d87da3a3",
+        736_068,
+    ],
+    [
+        "interior-f0-b-b",
+        "5f0ccb72538472c406b49e2d761ac1c7c68edf2db163bc6e949ac9dfb4c1c4a6",
+        "38433e1a25426d6dff5252841d7565dc27ac1e89876d50e53b23cb31cb22a6c6",
+        733_494,
+    ],
+    [
+        "interior-f1-y0-a",
+        "9b257130f44b83c31f33e25ecce38eed932b6aba6d8f9c6a9e892e800f69b44c",
+        "f301e4c3185ee731402dcdf3dae968f957c948b018ce93e6a5b6329268f22393",
+        920_453,
+    ],
+    [
+        "interior-f1-y0-b",
+        "8bb65f684daa4799482d37ab784149f76cd04339bfb97c34cae150f01ef083cd",
+        "2d4cff20c7ee11e0bc866779da4733dcbfa0da6415a3c6a3e643c26978808aee",
+        876_084,
+    ],
+    [
+        "interior-f1-y1-a",
+        "1d8971bba502929b540be6cbbb167a8ca7229e19867aee1a837e706dbc3ad72e",
+        "aacb6e801ff1b646a031d8334a90f3f7d8b941046b38955093822435c39e47ee",
+        946_455,
+    ],
+    [
+        "interior-f1-y1-b",
+        "f690f79dcf5468eb90721c52843d361092eb1ba5ef8a8debbfd56e803f86c891",
+        "24542639cf06ec28571c9332978f530a6404ff20d119a54cbdd36dce8168ff3d",
+        912_101,
+    ],
+    [
+        "interior-f2",
+        "a41bd3ac86fa4cb363d25f8a3ad2f31d8ba0f91b01bbc6c6cfd0d33af3a1f24c",
+        "e14ad4ec0e2683acc276ce57c60a4abeae8510c00a08c9899c273ed064f3a8d3",
+        637_646,
+    ],
+];
+const pacificaR21Inventory = pacificaR21Leaves.map(([key, pinnedIntegrity, sha256, bytes]) => ({
+    key: `scene.pacifica.r2.1.${key}`,
+    category: "scene",
+    state: "inline-input-required",
+    path: `/Users/jack/Developer/helix/run/continuum-pacifica-r2.1/${pinnedIntegrity}.scene.helix-scene.json`,
+    sha256,
+    localSha256: sha256,
+    cid: `cid:sha256:${sha256}`,
+    bytes,
+    mediaType: "application/vnd.helix.scene+json;version=2",
+    legacyIds: {
+        pinnedSemanticIntegrity: pinnedIntegrity,
+        mountGraph: "helix-web-demo-worlds@origin/main:worlds/pacifica-native",
+    },
+    nextAction: "Hash-verify and inline-ingest this sub-1 MiB Scene document by its raw-byte CID; resolve every declared resource through existing World/Vault no-copy adoption where receipts exist.",
+}));
+exports.AUTHORITATIVE_CANARY_INVENTORY = [
+    ...materialInventory,
+    ...exports.CANARY_MATERIAL_ARTIFACT_INVENTORY,
+    ...vehicleInventory,
+    ...characterInventory,
+    ...pacificaR21Inventory,
+].sort((a, b) => a.key.localeCompare(b.key));
+/**
+ * Local paths are hash-verified and backend adoption receipts are explicit
+ * inputs. A historical publish JSON alone never makes an isolated environment
+ * publish-ready.
+ */
+async function auditCanaryInventory(entries = exports.AUTHORITATIVE_CANARY_INVENTORY, available = {}) {
+    const blockers = [];
+    for (const entry of entries) {
+        let blocker;
+        const block = (reason) => {
+            blocker ??= { key: entry.key, reason, nextAction: entry.nextAction };
+        };
+        if (entry.path) {
+            try {
+                const bytes = await (0, promises_1.readFile)(entry.path);
+                const actual = (0, node_crypto_1.createHash)("sha256").update(bytes).digest("hex");
+                const expected = entry.localSha256 ?? entry.sha256;
+                if (expected && actual !== expected)
+                    block(`local SHA-256 mismatch: expected ${expected}, got ${actual}`);
+            }
+            catch (error) {
+                block(`source path unavailable: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        if (entry.state === "unresolved")
+            block("exact content descriptor is unresolved");
+        if (entry.state === "inline-input-required" &&
+            (!entry.cid || !available.inlineCids?.has(entry.cid)))
+            block("hash-verified inline bytes are not staged in the canary input");
+        if (entry.state === "staged-input-required" &&
+            (!entry.cid || !available.stagedCids?.has(entry.cid)))
+            block("large object has no existing adoption/staging receipt");
+        if (entry.state === "candidate-adoption") {
+            const adoptionKey = entry.adoption?.kind === "instant-world-adoption"
+                ? `${entry.adoption.buildId}:${entry.adoption.contentSha256}`
+                : entry.adoption?.kind === "vault-adoption"
+                    ? entry.adoption.vaultAssetVersionId
+                    : "";
+            if (!adoptionKey || !available.verifiedAdoptions?.has(adoptionKey))
+                block("candidate no-copy receipt is not verified in the target backend");
+        }
+        if (blocker)
+            blockers.push(blocker);
+    }
+    return {
+        schema: "helix.creator.continuum-canary-inventory-audit/1",
+        status: blockers.length ? "blocked" : "ready",
+        entries: entries.length,
+        blockers: blockers.sort((a, b) => a.key.localeCompare(b.key) || a.reason.localeCompare(b.reason)),
+    };
+}
+//# sourceMappingURL=inventory.js.map