@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/vehicle/mintVehicle.js

@@ -0,0 +1,417 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTENT_RATINGS = void 0;
+exports.sealProvenanceKind = sealProvenanceKind;
+exports.canonicalBytes = canonicalBytes;
+exports.pinMeshRendition = pinMeshRendition;
+exports.vehicleRoot = vehicleRoot;
+exports.vehicleSealIntent = vehicleSealIntent;
+exports.isLandVehicle = isLandVehicle;
+exports.readVehicleBoard = readVehicleBoard;
+exports.vehicleSealCheck = vehicleSealCheck;
+exports.mintVehicle = mintVehicle;
+exports.formatVehicleMint = formatVehicleMint;
+/**
+ * `helix vehicle publish <dir>` — a vehicle package directory to a sealed Vehicle Package and the vehicle Item made
+ * from it, read back and verified. Package-first (helix-creator-cli #312): nothing is minted from loose bytes; the
+ * Item is projected from one exact sealed Package Version by `POST /api/v1/items` (`continuum make-item`).
+ *
+ *   1. validate   the package + GLB (`helix vehicle validate`, including the host-manifest gate) and every audio sample
+ *   2. upload     the GLB and every local WAV as public Continuum objects; their content URLs serve the exact bytes
+ *   3. root       the vehicle-definition: the package with `mesh.ref = "$self"`, its served mesh rendition pinned to the
+ *                 uploaded GLB (artifactRef / checksumSha256 / byteLength), audio rows pinned, optional
+ *                 `hostGrantExtensions` (publish.json) sealed beside it
+ *   4. seal       a public `vehicle` Package Version (root + GLB + WAVs)
+ *   5. make-item  the vehicle Item from that exact pin (no offer: open one after visual QA) — or, with `--item`, a
+ *                 STAGED Version and a version move carrying the package rider
+ *   6. read back  pin, package identity, the mesh pin, every audio URL, and the host board: hostKind vehicle,
+ *                 sockets and tunable paths (an empty board is a car no add-on can ever fit)
+ *
+ * Every step is recorded in `<out>/ledger.json`; re-running the same command resumes from the last finished step.
+ *
+ * Directory layout: `vehicle-package.json`, one `*.glb` (or `model.glb`) carrying `asset.extras.HELIX_vehicle`,
+ * WAVs beside it or under `audio/`, optional `publish.json`
+ * { title, description, tags, version, contentRating, provenance: { kind, source }, hostGrantExtensions }.
+ */
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const init_1 = require("../init");
+const audio_1 = require("./audio");
+const sealCheck_1 = require("./sealCheck");
+const platform_1 = require("./platform");
+const publish_1 = require("./publish");
+const validate_1 = require("./validate");
+exports.CONTENT_RATINGS = ['everyone', 'teen', 'mature', 'adult'];
+/** The seal accepts only these provenance kinds (it refuses "original"). */
+function sealProvenanceKind(kind) {
+    return kind === 'imported' || kind === 'generated' ? kind : 'authored';
+}
+function canonicalBytes(value) {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { canonicalJsonBytes } = require('@hypersoniclabs/helix-manifest');
+    return canonicalJsonBytes(value);
+}
+const now = () => new Date().toISOString();
+/**
+ * The served mesh rendition, pinned to the uploaded model. A `source` rendition with no bytes is kept as the
+ * description it is; exactly one served rendition is pinned (this command seals one model). Pure.
+ */
+function pinMeshRendition(pkg, glb) {
+    const out = JSON.parse(JSON.stringify(pkg));
+    if (!(0, platform_1.isRecord)(out.mesh))
+        throw new Error('the vehicle package has no mesh block');
+    const mesh = out.mesh;
+    const visual = (0, platform_1.isRecord)(mesh.visual) ? mesh.visual : undefined;
+    const pinned = { artifactRef: glb.url, checksumSha256: glb.sha, byteLength: glb.bytes };
+    if (!visual || !Array.isArray(visual.renditions) || visual.renditions.length === 0) {
+        mesh.visual = { format: 1, ...(visual ?? {}), renditions: [{ id: 'target-web', kind: 'derived', ...pinned }] };
+        return out;
+    }
+    const renditions = visual.renditions;
+    const served = renditions.filter((r) => (0, platform_1.isRecord)(r) && !(r.kind === 'source' && r.artifactRef === undefined && r.checksumSha256 === undefined));
+    if (served.length > 1) {
+        throw new Error(`mesh.visual declares ${served.length} served renditions (${served.map((r) => String(r.id)).join(', ')}); this command seals one model — keep one derived rendition and point every tier at it`);
+    }
+    if (served.length === 1)
+        Object.assign(served[0], pinned);
+    else
+        renditions.push({ id: 'target-web', kind: 'derived', ...pinned });
+    return out;
+}
+/** The exact vehicle-definition root: the published shape (`mesh.ref = "$self"`) with its model pinned. Pure. */
+function vehicleRoot(pkg, glb, hostGrantExtensions) {
+    const root = pinMeshRendition((0, validate_1.publishedVehiclePackage)(pkg), glb);
+    if (hostGrantExtensions !== undefined)
+        root.hostGrantExtensions = hostGrantExtensions;
+    return root;
+}
+/**
+ * The exact Package publication intent `vehicle publish` seals, built from values only (no network, no upload) so the
+ * real publish and the dry run's seal-side validation judge the SAME object. `audio` is every uploaded WAV.
+ */
+function vehicleSealIntent(a) {
+    const rootRef = { cid: (0, platform_1.cidOf)(a.rootSha), bytes: a.rootBytes.length, mediaType: publish_1.VEHICLE_ROOT_MEDIA_TYPE, role: 'vehicle-definition' };
+    const glbRef = { cid: (0, platform_1.cidOf)(a.glb.sha), bytes: a.glb.bytes, mediaType: 'model/gltf-binary', role: publish_1.VEHICLE_MODEL_ROLE };
+    const objects = [
+        { reference: rootRef, source: { kind: 'inline', bytes: a.rootBytes, filename: 'vehicle-package.json', audience: 'public' } },
+        { reference: glbRef, source: { kind: 'existing' } },
+    ];
+    const variants = [{ id: 'target-balanced', runtimeProfileId: 'web-balanced', object: glbRef }];
+    a.audio.forEach((u, index) => {
+        const ref = { cid: (0, platform_1.cidOf)(u.sha), bytes: u.bytes, mediaType: 'audio/wav', role: publish_1.VEHICLE_AUDIO_ROLE };
+        variants.push({ id: `audio-${String(index + 1).padStart(2, '0')}`, runtimeProfileId: 'vehicle-audio', object: ref });
+        objects.push({ reference: ref, source: { kind: 'existing' } });
+    });
+    const provenance = a.provenance ?? {};
+    const intent = {
+        projectId: `helix.continuum.vehicle.${a.identity.slug}`,
+        sourceDigest: (0, platform_1.sha256Hex)([a.rootSha, a.glb.sha, ...a.audio.map((u) => u.sha)].join('\n')),
+        package: { schema: 'helix.continuum.package/1', id: a.packageId, type: 'vehicle', name: a.identity.name },
+        packagePublication: { slug: a.identity.slug, visibility: a.identity.visibility },
+        packageVersion: {
+            schema: 'helix.continuum.package-version/1',
+            package: { id: a.packageId, type: 'vehicle' },
+            version: a.version,
+            root: rootRef,
+            dependencies: [],
+            variants,
+            compatibility: { contract: 'helix.vehicle/2', provides: ['vehicle.car/1', 'helix/vehicle-base@2'], requires: [] },
+            provenance: { kind: sealProvenanceKind(provenance.kind), source: provenance.source ?? `helix vehicle publish ${a.dirName}`, sourceId: `sha256:${a.rootSha}` },
+            expectedClosure: { objectCount: objects.length, totalBytes: objects.reduce((n, o) => n + Number(o.reference.bytes), 0) },
+        },
+        objects,
+        listings: [],
+        ...(a.stage ? { stage: true } : {}),
+    };
+    return { intent, objects };
+}
+const countOf = (value) => (Array.isArray(value) ? value.length : (0, platform_1.isRecord)(value) ? Object.keys(value).length : 0);
+/** Does this package drive on land (so its board must expose tunable paths)? */
+function isLandVehicle(pkg) {
+    if (!(0, platform_1.isRecord)(pkg))
+        return false;
+    const physics = (0, platform_1.isRecord)(pkg.physics) ? pkg.physics : undefined;
+    const simulation = (0, platform_1.isRecord)(pkg.simulation) ? pkg.simulation : undefined;
+    return Boolean((physics && (0, platform_1.isRecord)(physics.engine)) || (simulation && (0, platform_1.isRecord)(simulation.land)));
+}
+/** GET /universal-items/:id/slots, judged: a vehicle host with sockets and (on land) tunable paths. */
+async function readVehicleBoard(api, itemId, opts) {
+    const board = await api.request('GET', `/api/v1/universal-items/${itemId}/slots`);
+    const sockets = countOf(board.surface?.sockets);
+    const paths = countOf(board.surface?.paths);
+    const problems = [];
+    if (board.hostKind !== 'vehicle')
+        problems.push(`board hostKind is ${JSON.stringify(board.hostKind ?? null)}, not "vehicle": no add-on can target this car`);
+    if (sockets === 0)
+        problems.push('board surface has no sockets: no wheel, seat, exhaust or light add-on can attach');
+    if (opts.land && paths === 0)
+        problems.push('board surface exposes no tunable paths: no performance part (ECU, brakes, gearbox, tyres) can fit');
+    const grants = board.hostGrantExtensions ?? {};
+    if ((0, platform_1.isRecord)(opts.grants)) {
+        for (const [slotId, row] of Object.entries(opts.grants)) {
+            const want = (0, platform_1.isRecord)(row) && Array.isArray(row.hide) ? row.hide.map(String) : [];
+            const got = (0, platform_1.isRecord)(grants[slotId]) && Array.isArray(grants[slotId].hide) ? grants[slotId].hide.map(String) : [];
+            const missing = want.filter((g) => !got.includes(g));
+            if (missing.length)
+                problems.push(`board does not grant ${slotId} hide ${missing.join(', ')} that the Package sealed`);
+        }
+    }
+    return { hostKind: board.hostKind ?? null, sockets, paths, hostGrantExtensions: grants, ok: problems.length === 0, problems };
+}
+/**
+ * The seal-side validation of a vehicle publish, with nothing uploaded: the exact intent the real publish seals (model and
+ * WAVs pinned by their local sha256), judged by the real seal's own preflight, plus the Package/Item fields the backend
+ * validates when it makes the Item. Runs in the dry run AND before the real publish uploads anything.
+ */
+function vehicleSealCheck(vdir, opts, glbBytes) {
+    const publish = vdir.publish;
+    const title = opts.title ?? publish.title ?? (typeof vdir.pkg.displayName === 'string' ? vdir.pkg.displayName : undefined);
+    const issues = [];
+    if (!title)
+        issues.push({ level: 'error', code: 'SEAL_ITEM_TITLE', path: 'title', message: 'no title: pass --title, set publish.json title, or give the package a displayName', fix: 'name the car' });
+    issues.push(...(0, sealCheck_1.itemSealIssues)({
+        // an existing car's Package keeps its own name and slug; only a new car names them from the title
+        ...(opts.itemId || !title ? {} : { name: title, slug: `${(0, init_1.slugify)(title)}-00000000` }),
+        title: opts.itemId ? undefined : title, description: opts.itemId ? undefined : opts.description ?? publish.description, tags: opts.itemId ? undefined : opts.tags ?? publish.tags,
+        contentRating: opts.contentRating ?? publish.contentRating, needsRating: !opts.itemId,
+    }));
+    try {
+        const glb = { sha: (0, platform_1.sha256Hex)(glbBytes), bytes: glbBytes.length, url: `https://pending.invalid/content/sha256/${(0, platform_1.sha256Hex)(glbBytes)}` };
+        const root = vehicleRoot((0, audio_1.provisionalAudio)(vdir.pkg, vdir.dir).pkg, glb, publish.hostGrantExtensions);
+        const rootBytes = canonicalBytes(root);
+        const { intent } = vehicleSealIntent({
+            packageId: (0, platform_1.uuidV5)('helix.continuum.vehicle-package/dry-run', platform_1.VEHICLE_PACKAGE_NAMESPACE),
+            identity: { name: title ?? 'vehicle', slug: `${(0, init_1.slugify)(title ?? 'vehicle')}-00000000`, visibility: 'public' },
+            version: opts.version ?? publish.version ?? '1.0.0', rootBytes, rootSha: (0, platform_1.sha256Hex)(rootBytes), glb,
+            audio: (0, publish_1.plannedAudioUploads)(vdir.pkg, vdir.dir), provenance: publish.provenance, dirName: (0, node_path_1.basename)(vdir.dir), stage: !!opts.itemId,
+        });
+        issues.push(...(0, sealCheck_1.sealIntentIssues)(intent));
+    }
+    catch (error) {
+        issues.push({ level: 'error', code: 'SEAL_ROOT', path: 'vehicle-package.json', message: `the sealed root could not be built: ${error instanceof Error ? error.message : String(error)}`, fix: 'fix the package so the published root can be formed' });
+    }
+    return issues;
+}
+async function mintVehicle(opts, creds, deps) {
+    const say = deps.onProgress ?? (() => undefined);
+    const vdir = (0, publish_1.readVehicleDir)(opts.dir, { glb: opts.glb });
+    const outDir = (0, node_path_1.resolve)(opts.out ?? (0, node_path_1.join)(vdir.dir, '.helix-publish'));
+    const ledgerFile = (0, node_path_1.join)(outDir, 'ledger.json');
+    const packageOut = (0, node_path_1.join)(outDir, 'vehicle-package.json');
+    const files = { ledger: ledgerFile, package: packageOut };
+    const publish = vdir.publish;
+    // 1. validate ---------------------------------------------------------------------------------------------------
+    const glbBytes = (0, node_fs_1.readFileSync)(vdir.glbFile);
+    const validate = deps.validate ?? validate_1.validateVehicle;
+    // The same gate as `helix vehicle validate --glb`: engine validator, publish gate, host manifest, and (unless
+    // --no-simulate) the drive judged against the package's own targets.
+    const validation = await validate((0, audio_1.provisionalAudio)(vdir.pkg, vdir.dir).pkg, glbBytes, opts.simulate === false ? {} : { simulate: { apiUrl: creds.apiUrl, offline: opts.offline } });
+    const audio = await (0, audio_1.checkAudioLocal)(vdir.pkg, vdir.dir, deps.fetchAudio);
+    // The seal's own refusals (provenance, rating, Package shape ...), judged BEFORE anything uploads, so a dry run that
+    // passes cannot then be refused by the real seal for a reason it never looked at.
+    const seal = vehicleSealCheck(vdir, opts, glbBytes);
+    const v = { errors: validation.errors + seal.length, warnings: validation.warnings, issues: [...validation.issues, ...seal] };
+    if (!validation.ok || !audio.ok || seal.length > 0 || opts.dryRun) {
+        const ok = validation.ok && audio.ok && seal.length === 0;
+        return {
+            ok, dryRun: opts.dryRun === true, validation: v, audio, files,
+            next: ok ? ['re-run without --dry-run to publish'] : ['fix every error above, then re-run; nothing was uploaded'],
+        };
+    }
+    const title = opts.title ?? publish.title ?? (typeof vdir.pkg.displayName === 'string' ? vdir.pkg.displayName : undefined);
+    if (!title)
+        throw new Error('no title: pass --title, set publish.json title, or give the package a displayName');
+    const rating = opts.contentRating ?? publish.contentRating;
+    if (!opts.itemId && !exports.CONTENT_RATINGS.includes(rating)) {
+        throw new Error('a new vehicle Item needs a creator-attested rating: pass --content-rating everyone|teen|mature|adult (or set publish.json contentRating)');
+    }
+    if (opts.itemId && !opts.version)
+        throw new Error('--item publishes a new version of an existing car: pass --package-version (the next patch, e.g. 1.0.1)');
+    if (opts.itemId && !(opts.reason ?? '').trim())
+        throw new Error('--item needs --reason "<1-500 chars>" for the version move');
+    (0, node_fs_1.mkdirSync)(outDir, { recursive: true });
+    const ledger = (0, node_fs_1.existsSync)(ledgerFile)
+        ? JSON.parse((0, node_fs_1.readFileSync)(ledgerFile, 'utf8'))
+        : { schema: 'helix.vehicle-mint-ledger/1', intentId: (0, node_crypto_1.randomUUID)(), steps: [] };
+    const record = (step, detail) => {
+        ledger.steps.push({ at: now(), step, ...(detail === undefined ? {} : { detail }) });
+        (0, node_fs_1.writeFileSync)(ledgerFile, `${JSON.stringify(ledger, null, 2)}\n`);
+    };
+    if (opts.itemId && ledger.itemId && ledger.itemId !== opts.itemId) {
+        throw new Error(`${ledgerFile} belongs to item ${ledger.itemId}, not ${opts.itemId}; pass --out <new dir> for a different car`);
+    }
+    // 2. upload -------------------------------------------------------------------------------------------------------
+    const glbSha = (0, platform_1.sha256Hex)(glbBytes);
+    if (!ledger.glb || ledger.glb.sha !== glbSha) {
+        say(`uploading ${(0, node_path_1.basename)(vdir.glbFile)} (${(glbBytes.length / 1048576).toFixed(1)} MiB) as a public object`);
+        const object = await deps.objects.putObjectFromFile({ path: vdir.glbFile, filename: (0, node_path_1.basename)(vdir.glbFile), mediaType: 'model/gltf-binary', audience: 'public' });
+        if (object.cid !== (0, platform_1.cidOf)(glbSha) || object.bytes !== glbBytes.length)
+            throw new Error(`upload of ${vdir.glbFile} returned ${object.cid}/${object.bytes}, expected ${(0, platform_1.cidOf)(glbSha)}/${glbBytes.length}`);
+        const url = await (0, platform_1.publicObjectUrl)(creds.apiUrl, glbSha, glbBytes.length, { fetchBytes: deps.fetchBytes });
+        ledger.glb = { sha: glbSha, bytes: glbBytes.length, url };
+        record('upload-model', ledger.glb);
+    }
+    say('audio: uploading local samples and resolving their public URLs');
+    const attached = await (0, publish_1.attachAudioUrls)(vdir.pkg, vdir.dir, { objects: deps.objects, apiUrl: creds.apiUrl, fetchBytes: deps.fetchBytes, onProgress: say });
+    if (attached.uploaded.length)
+        record('upload-audio', attached.uploaded.map((u) => ({ name: u.name, sha: u.sha, bytes: u.bytes, url: u.url })));
+    // 3. root ---------------------------------------------------------------------------------------------------------
+    const root = vehicleRoot(attached.pkg, ledger.glb, publish.hostGrantExtensions);
+    (0, node_fs_1.writeFileSync)(packageOut, `${JSON.stringify(root, null, 2)}\n`);
+    const rootBytes = canonicalBytes(root);
+    const rootSha = (0, platform_1.sha256Hex)(rootBytes);
+    // The closure this run is about to seal: the root, the model, and every uploaded WAV. A loadable audio row whose
+    // cid is NOT in this set is not in the Package closure, so the runtime 404s it — refuse to seal before that ships.
+    const intendedClosure = (0, audio_1.sealedClosureSha256s)({
+        root: { cid: `cid:sha256:${rootSha}` },
+        variants: [{ object: { cid: `cid:sha256:${ledger.glb.sha}` } }, ...attached.uploaded.map((u) => ({ object: { cid: `cid:sha256:${u.sha}` } }))],
+    });
+    const preSeal = await (0, audio_1.checkAudioReadBack)(root, deps.fetchAudio, intendedClosure);
+    if (!preSeal.ok) {
+        return { ok: false, dryRun: false, validation: v, audio: preSeal, files, next: ['the finished package\'s audio does not resolve; nothing was sealed. Fix and re-run.'] };
+    }
+    const finalCheck = await validate(root);
+    if (!finalCheck.ok) {
+        return { ok: false, dryRun: false, validation: { errors: finalCheck.errors, warnings: finalCheck.warnings, issues: finalCheck.issues }, audio: preSeal, files, next: ['the sealed root (model pinned, audio pinned) no longer validates; nothing was sealed'] };
+    }
+    if (!opts.itemId && ledger.itemId && ledger.rootSha && ledger.rootSha !== rootSha) {
+        throw new Error(`this directory already minted item ${ledger.itemId} from a different package (ledger ${ledger.rootSha.slice(0, 12)}…, now ${rootSha.slice(0, 12)}…). `
+            + `A minted car is fixed: publish the change as a new version with --item ${ledger.itemId} --package-version <next> --reason "...", or pass --out <new dir> to mint a different car.`);
+    }
+    if (ledger.rootSha !== rootSha) {
+        // A different root is a different Version: never resume a seal or a move made for other bytes.
+        delete ledger.pin;
+        delete ledger.versionMove;
+    }
+    ledger.rootSha = rootSha;
+    // 4. seal ---------------------------------------------------------------------------------------------------------
+    let existing;
+    if (opts.itemId) {
+        existing = await (0, platform_1.getItem)(deps.api, opts.itemId);
+        if (existing.kind !== 'vehicle')
+            throw new Error(`item ${opts.itemId} is a ${existing.kind}, not a vehicle`);
+        if (!existing.continuumPackagePin)
+            throw new Error(`item ${opts.itemId} has no Vehicle Package pin to version; it predates Package-first publication`);
+    }
+    const version = opts.version ?? publish.version ?? '1.0.0';
+    if (!ledger.pin || ledger.pin.version !== version) {
+        const packageId = existing?.continuumPackagePin?.packageId ?? ledger.packageId ?? (0, platform_1.uuidV5)(`helix.continuum.vehicle-package/${ledger.intentId}`, platform_1.VEHICLE_PACKAGE_NAMESPACE);
+        let pkgIdentity;
+        if (existing) {
+            const owned = await deps.api.request('GET', `/api/v1/continuum/packages/${packageId}`);
+            const p = ((0, platform_1.isRecord)(owned.package) ? owned.package : owned);
+            pkgIdentity = { name: String(p.name), slug: String(p.slug), visibility: p.visibility === 'private' ? 'private' : 'public' };
+        }
+        else {
+            pkgIdentity = { name: title, slug: `${(0, init_1.slugify)(title)}-${ledger.intentId.slice(0, 8)}`, visibility: 'public' };
+        }
+        const { intent, objects } = vehicleSealIntent({
+            packageId, identity: pkgIdentity, version, rootBytes, rootSha, glb: ledger.glb, audio: attached.uploaded,
+            provenance: publish.provenance, dirName: (0, node_path_1.basename)(vdir.dir), stage: !!existing,
+        });
+        // Record the exact sealed closure so the read-back verifies every audio row against what was actually sealed.
+        ledger.closure = objects.map((object) => String(object.reference.cid));
+        const descriptorFile = (0, node_path_1.join)(outDir, `descriptor-${version}.json`);
+        (0, node_fs_1.writeFileSync)(descriptorFile, `${JSON.stringify(intent, (_k, value) => (value instanceof Uint8Array ? `<${value.length} inline bytes>` : value), 2)}\n`);
+        files.descriptor = descriptorFile;
+        ledger.packageId = packageId;
+        ledger.version = version;
+        record('descriptor', { packageId, version, objects: objects.length });
+        say(`sealing vehicle Package ${packageId}@${version} (${objects.length} objects)${existing ? ' as a staged version' : ''}`);
+        const receipt = await deps.publishPackage(intent);
+        const receiptFile = (0, node_path_1.join)(outDir, `receipt-${version}.json`);
+        (0, node_fs_1.writeFileSync)(receiptFile, `${JSON.stringify(receipt, null, 2)}\n`);
+        files.receipt = receiptFile;
+        const manifestCid = String(receipt.manifestCid ?? '');
+        if (!/^cid:sha256:[a-f0-9]{64}$/.test(manifestCid))
+            throw new Error(`the seal receipt names no manifest CID: ${JSON.stringify(receipt).slice(0, 300)}`);
+        ledger.pin = { packageId, version, manifestCid };
+        record('seal', receipt);
+    }
+    const pin = ledger.pin;
+    // 5. make the Item, or move the existing one ----------------------------------------------------------------------
+    const next = [];
+    let itemId = opts.itemId ?? ledger.itemId;
+    let versionMove = 'minted';
+    if (!opts.itemId && !itemId) {
+        say(`making vehicle Item "${title}" from ${pin.packageId}@${pin.version}`);
+        const made = await deps.makeItem({
+            packagePin: pin, intentId: ledger.intentId, contentRating: rating, title,
+            description: opts.description ?? publish.description, tags: opts.tags ?? publish.tags,
+        });
+        itemId = made.item.id;
+        ledger.itemId = itemId;
+        record('make-item', made);
+    }
+    else if (opts.itemId && ledger.versionMove !== 'moved') {
+        try {
+            await deps.api.request('POST', `/api/v1/universal-items/${opts.itemId}/versions`, { packagePin: pin, reason: String(opts.reason).trim(), vehiclePackage: root });
+            ledger.versionMove = 'moved';
+            ledger.itemId = opts.itemId;
+            record('set-version', { version: pin.version });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            record('set-version-refused', message);
+            if (/VISUAL_QA|visual.?qa/i.test(message)) {
+                ledger.versionMove = 'staged-awaiting-visual-qa';
+                ledger.itemId = opts.itemId;
+                record('staged', { version: pin.version });
+                next.push(`the version is sealed (staged) but the move needs a passing visual QA of this exact candidate: helix item visual-qa ${opts.itemId} --package-version ${pin.version} --vehicle-package ${packageOut} --submit`, `then re-run this same command to move the car (the ledger resumes at the move)`);
+                return { ok: true, dryRun: false, itemId: opts.itemId, packagePin: pin, versionMove: 'staged-awaiting-visual-qa', validation: v, audio: preSeal, files, next };
+            }
+            throw error;
+        }
+    }
+    if (opts.itemId)
+        versionMove = 'moved';
+    if (!itemId)
+        throw new Error('no item id after make-item');
+    // 6. read back ----------------------------------------------------------------------------------------------------
+    const after = await (0, platform_1.getItem)(deps.api, itemId);
+    const afterPin = after.continuumPackagePin ?? null;
+    const stored = after.properties?.vehiclePackage;
+    const identity = (0, platform_1.isRecord)(after.properties?.vehiclePackageIdentity) ? after.properties.vehiclePackageIdentity.checksumSha256 : undefined;
+    const pinMatches = !!afterPin && afterPin.packageId === pin.packageId && afterPin.version === pin.version && afterPin.manifestCid === pin.manifestCid;
+    const packageIdentityMatches = (0, platform_1.isRecord)(stored) && identity === (0, platform_1.sha256Hex)(canonicalBytes(stored));
+    const storedMesh = (0, platform_1.isRecord)(stored) && (0, platform_1.isRecord)(stored.mesh) ? stored.mesh : undefined;
+    const meshBound = storedMesh?.ref === itemId;
+    const storedRenditions = (0, platform_1.isRecord)(storedMesh?.visual) && Array.isArray(storedMesh.visual.renditions) ? storedMesh.visual.renditions : [];
+    const meshPinned = storedRenditions.some((r) => (0, platform_1.isRecord)(r) && r.checksumSha256 === ledger.glb.sha && r.artifactRef === ledger.glb.url && r.byteLength === ledger.glb.bytes);
+    const sealedClosure = (0, audio_1.sealedClosureSha256s)({ objectCids: ledger.closure });
+    const readAudio = await (0, audio_1.checkAudioReadBack)(stored, deps.fetchAudio, sealedClosure.size ? sealedClosure : undefined);
+    const board = await readVehicleBoard(deps.api, itemId, { land: isLandVehicle(root), grants: root.hostGrantExtensions });
+    record('read-back', { pin: afterPin, status: after.status, pinMatches, packageIdentityMatches, meshBound, meshPinned, audioOk: readAudio.ok, board });
+    const ok = pinMatches && packageIdentityMatches && meshBound && meshPinned && readAudio.ok && board.ok;
+    next.push(`prove it renders, sits and drives: helix item visual-qa ${itemId} --submit (or wait for the hosted run)`, `then sell it: helix item distribution create ${itemId} --channel marketplace --price-lix <n>`, `fit parts to it: helix vehicle addon publish <dir> with fits.only.items ["${itemId}"]`);
+    return {
+        ok, dryRun: false, itemId, slug: after.slug, packagePin: afterPin, versionMove, validation: v, audio: preSeal,
+        readBack: { pinMatches, packageIdentityMatches, meshBound, meshPinned, status: after.status, audio: readAudio, board },
+        files, next,
+    };
+}
+function formatVehicleMint(r) {
+    const lines = [];
+    for (const issue of r.validation.issues)
+        lines.push(`${issue.level === 'error' ? '✖' : '⚠'} [${issue.code}] ${issue.path}: ${issue.message}`);
+    for (const issue of r.audio.issues ?? [])
+        if (issue.level === 'error')
+            lines.push(`✖ [${issue.code}] ${issue.path}: ${issue.message}`);
+    if (r.itemId)
+        lines.push(`  item:    ${r.itemId}${r.slug ? ` (${r.slug})` : ''}`);
+    if (r.packagePin)
+        lines.push(`  package: ${r.packagePin.packageId}@${r.packagePin.version} ${r.packagePin.manifestCid}`);
+    if (r.readBack) {
+        const b = r.readBack.board;
+        lines.push(`  read-back: pin ${r.readBack.pinMatches}, package identity ${r.readBack.packageIdentityMatches}, mesh bound ${r.readBack.meshBound}, mesh pinned ${r.readBack.meshPinned}, audio ${r.readBack.audio.ok}, status ${r.readBack.status}`);
+        lines.push(`  host board: ${b.hostKind ?? 'none'}, ${b.sockets} sockets, ${b.paths} tunable paths${Object.keys(b.hostGrantExtensions).length ? `, grants ${JSON.stringify(b.hostGrantExtensions)}` : ''}`);
+        for (const p of b.problems)
+            lines.push(`✖ ${p}`);
+    }
+    for (const n of r.next)
+        lines.push(`  next: ${n}`);
+    lines.push(`${r.ok ? '✔' : '✖'} vehicle ${r.dryRun ? 'dry run' : r.versionMove === 'staged-awaiting-visual-qa' ? 'version staged' : r.versionMove === 'moved' ? 'version moved' : 'publish'}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=mintVehicle.js.map

package/dist/vehicle/mintVehicle.js.map

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

package/dist/vehicle/paintHue.d.ts

@@ -0,0 +1,89 @@
+/** Reference paint colour: `#rrggbb` or `rrggbb`. Throws on a malformed value. */
+export declare function hexToRgb(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+};
+/** Hue in degrees (0..360) of an RGB triple, in [0..255]. */
+export declare function rgbHue(r: number, g: number, b: number): number;
+export declare const hexToHue: (hex: string) => number;
+/** Circular distance between two hues, in degrees (0..180). */
+export declare function hueDistanceDeg(a: number, b: number): number;
+export interface Hsv {
+    h: number;
+    s: number;
+    v: number;
+}
+export declare function rgbToHsv(r: number, g: number, b: number): Hsv;
+/** One view: the car with only its body paint drawn, and the same camera with the paint hidden too (the backdrop alone). */
+export interface PaintViewPair {
+    id: string;
+    paint: Buffer;
+    empty: Buffer;
+}
+export interface PaintViewStats {
+    id: string;
+    /** Paint pixels in the view (after dropping the 2 px edge ring where the paint blends with the backdrop). */
+    pixels: number;
+    hueDeg: number;
+    medianSaturation: number;
+    medianValue: number;
+    /** Fraction of the paint pixels with a channel at the display ceiling (>= 250 of 255). */
+    clippedFraction: number;
+    /** Fraction of the paint pixels washed toward white: bright (value >= 0.8) with under half the reference saturation (chromatic) / near-white (neutral). */
+    washedFraction: number;
+}
+export interface PaintReference {
+    rgb: {
+        r: number;
+        g: number;
+        b: number;
+    };
+    hsv: Hsv;
+    kind: 'chromatic' | 'neutral';
+}
+/** Reference paint colour -> what to judge. Under 0.2 saturation (white, silver, grey, black) hue is undefined, so only lightness and tint are judged. */
+export declare function paintReference(hex: string): PaintReference;
+export declare function samplePaintView(view: PaintViewPair, ref: PaintReference): Promise<PaintViewStats>;
+/** Thresholds, all against the reference colour and all documented in the MCP `appearance` reference. */
+export declare const PAINT_LIMITS: {
+    /** Rendered saturation (median of the six view medians) as a share of the reference's. Chromatic paints. */
+    readonly saturationShare: 0.75;
+    /** A chromatic body may not render darker than this share of the reference value (a maroon over-correction). */
+    readonly minValueShare: 0.55;
+    /** Mean over the views of the share of paint pixels washed toward white (chromatic: bright and under half the reference saturation; neutral: all channels >= 245). */
+    readonly washedMean: 0.3;
+    /** Neutral paints: tint (saturation) above the reference's by at most this, lightness within this of the reference. */
+    readonly neutralTint: 0.15;
+    readonly neutralValue: 0.25;
+    /** A neutral reference at or above this value is white/silver: near-white pixels are its colour, so wash is not judged. */
+    readonly lightNeutralValue: 0.75;
+    /** Fewer paint pixels than this over all views and the paint cannot be judged. */
+    readonly minPixels: 3000;
+    readonly defaultHueToleranceDeg: 12;
+};
+export interface PaintMaterialFact {
+    name: string;
+    baseColorLinear?: number[] | null;
+    metalness?: number | null;
+    roughness?: number | null;
+    clearcoat?: number | null;
+    ior?: number | null;
+    specularIntensity?: number | null;
+    hasMap?: boolean;
+}
+export interface PaintAssert {
+    id: string;
+    pass: boolean;
+    detail: string;
+    measured: Record<string, unknown>;
+}
+/** What the creator can change, with the material's real values, appended to every failing paint message. */
+export declare function paintFixAdvice(materials: PaintMaterialFact[] | null | undefined, ref: PaintReference): string;
+export declare function rgbToHex(c: {
+    r: number;
+    g: number;
+    b: number;
+}): string;
+/** Judge the six paint views against the reference. Pure: numbers in, asserts out. */
+export declare function judgePaint(referenceHex: string, views: PaintViewStats[], materials: PaintMaterialFact[] | null | undefined, hueToleranceDeg?: number): PaintAssert[];