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

package/dist/vehicle/recheckListed.js

@@ -0,0 +1,200 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CURRENT_VEHICLE_GATES = void 0;
+exports.judgeRecord = judgeRecord;
+exports.listedVehicles = listedVehicles;
+exports.recheckListed = recheckListed;
+exports.renderRecheckText = renderRecheckText;
+exports.vehicleListingGate = vehicleListingGate;
+exports.listingRefusal = listingRefusal;
+// `helix vehicle recheck-listed`: judge LISTED cars against the gates that exist TODAY.
+//
+// WHY THIS EXISTS. A listed car is never re-judged when a gate is added: its visual-QA record is the run that passed when
+// it was listed. The F40 (0f443d72) went on sale on a run made before the posture and the hands-while-steering asserts
+// existed, so it stayed "passed" while its driver lay back with the hands off the wheel. This reads each listed car's
+// passing record, names every current blocking gate that record never ran (STALE) or failed (FAIL), and with --rerun
+// renders the car again now (`vehicle preview --item`, every seat occupied, the full inspection set) and reports that.
+const node_path_1 = __importDefault(require("node:path"));
+const vehicleGrip_1 = require("../visualQa/vehicleGrip");
+/** Every blocking assert a car's visual QA must have PASSED on today's route. A record without one never ran that gate. */
+exports.CURRENT_VEHICLE_GATES = [
+    'vehicle.wheels.at_hubs',
+    'vehicle.wheels.arch_clearance',
+    'vehicle.steering.wheel_rotates',
+    'vehicle.lamps.each_function_lights',
+    'vehicle.occupants.boarded',
+    'vehicle.occupants.head_clearance',
+    'vehicle.occupants.hips_on_seat',
+    'vehicle.occupants.feet_on_floor',
+    'vehicle.occupants.hands_on_wheel',
+    'vehicle.occupants.penetration',
+    'vehicle.occupants.torso_angle',
+    'vehicle.occupants.knees_up',
+    'vehicle.occupants.head_in_wings',
+    ...vehicleGrip_1.GRIP_ASSERT_IDS,
+];
+/** Judge one item's visual-QA status against the current gate list. Pure. */
+function judgeRecord(itemId, title, version, st, gates = exports.CURRENT_VEHICLE_GATES) {
+    const cur = st.currentVersion ?? null;
+    const runs = st.runs ?? [];
+    const run = (cur?.runId ? runs.find((r) => r.id === cur.runId) : undefined)
+        ?? runs.find((r) => r.verdict === 'pass' && (!cur?.packageVersionId || r.packageVersionId === cur.packageVersionId));
+    if (!run)
+        return { itemId, title, version, record: null, stale: [...gates], failed: [], status: 'no-record' };
+    const asserts = run.bundle?.asserts ?? [];
+    const ran = new Map(asserts.map((a) => [a.id, a]));
+    const stale = gates.filter((g) => !ran.has(g));
+    const failed = gates.filter((g) => { const a = ran.get(g); return !!a && !a.pass && (a.severity ?? 'block') === 'block'; });
+    return {
+        itemId, title, version: version ?? run.bundle?.item?.packageVersion ?? null,
+        record: { runId: run.id ?? null, createdAt: run.createdAt ?? null, harness: run.bundle?.harness?.version ?? null, verdict: run.verdict ?? null },
+        stale, failed,
+        status: failed.length ? 'fail' : stale.length ? 'stale' : 'current',
+    };
+}
+async function getJson(url) {
+    const res = await fetch(url, { headers: { accept: 'application/json', 'user-agent': 'Mozilla/5.0 helix-cli' }, signal: AbortSignal.timeout(30_000) });
+    if (!res.ok)
+        throw new Error(`GET ${url} -> ${res.status}`);
+    return (await res.json());
+}
+/** The listed vehicles: the marketplace catalogue's vehicle items (optionally one creator's). */
+async function listedVehicles(apiBase, creatorId) {
+    const out = [];
+    for (let page = 1; page <= 20; page++) {
+        const q = new URLSearchParams({ itemType: 'vehicle', limit: '50', page: String(page), ...(creatorId ? { creatorId } : {}) });
+        const body = await getJson(`${apiBase.replace(/\/$/, '')}/api/v1/universal-items?${q}`);
+        const items = (body.items ?? []).filter((i) => typeof i.id === 'string' && (i.itemType === 'vehicle' || i.kind === 'vehicle'));
+        for (const i of items)
+            if (!out.some((o) => o.id === i.id))
+                out.push({ id: i.id, title: String(i.title ?? i.id) });
+        if ((body.items ?? []).length < 50)
+            break;
+    }
+    return out;
+}
+async function recheckListed(o) {
+    const log = o.log ?? (() => undefined);
+    const targets = o.items?.length ? o.items.map((id) => ({ id, title: id })) : await listedVehicles(o.apiBase, o.creatorId);
+    const rows = [];
+    for (const t of targets) {
+        let title = t.title;
+        let version = null;
+        try {
+            const it = await getJson(`${o.apiBase.replace(/\/$/, '')}/api/v1/universal-items/${t.id}`);
+            title = String(it.item?.title ?? title);
+            version = it.item?.packageVersion ?? it.item?.currentVersion?.version ?? null;
+        }
+        catch { /* keep the id */ }
+        let row;
+        try {
+            const st = await getJson(`${o.apiBase.replace(/\/$/, '')}/api/v1/universal-items/${t.id}/visual-qa`);
+            row = judgeRecord(t.id, title, version, st);
+        }
+        catch (e) {
+            row = { itemId: t.id, title, version, record: null, stale: [...exports.CURRENT_VEHICLE_GATES], failed: [], status: 'no-record' };
+            log(`${t.id}: visual-QA status unreadable (${String(e?.message ?? e).slice(0, 120)})`);
+        }
+        if (o.rerun) {
+            const out = node_path_1.default.join(o.out, t.id.slice(0, 8));
+            log(`${title}: rendering today's inspection (every seat occupied) into ${out}`);
+            try {
+                const { runVehiclePreview } = await Promise.resolve().then(() => __importStar(require('./preview')));
+                const s = await runVehiclePreview({ item: t.id, out, apiBase: o.apiBase, webBase: o.webBase, token: o.token, storageState: o.storageState, chrome: o.chrome, quiet: true });
+                row.rerun = { verdict: s.verdict, exitCode: s.exitCode, failing: s.asserts.filter((a) => a.status === 'FAIL').map((a) => ({ id: a.id, detail: a.detail })), inspection: s.inspection?.dir ?? null, out };
+            }
+            catch (e) {
+                row.rerun = { verdict: 'error', exitCode: 2, failing: [], inspection: null, out, error: String(e?.message ?? e).slice(0, 400) };
+            }
+        }
+        rows.push(row);
+    }
+    return rows;
+}
+function renderRecheckText(rows) {
+    const L = [];
+    const bad = rows.filter((r) => r.status !== 'current' || (r.rerun && r.rerun.exitCode !== 0));
+    L.push(`${bad.length ? '✖' : '✔'} ${rows.length} listed vehicle(s) re-checked against today's ${exports.CURRENT_VEHICLE_GATES.length} blocking gates: ${bad.length} need action`);
+    for (const r of rows) {
+        L.push('');
+        L.push(`${r.status.toUpperCase().padEnd(9)} ${r.title} (${r.itemId}${r.version ? ` @${r.version}` : ''})`);
+        if (r.record)
+            L.push(`          record: run ${r.record.runId?.slice(0, 8) ?? '?'} ${r.record.verdict ?? '?'} ${r.record.createdAt ?? ''} by ${r.record.harness ?? '?'}`);
+        else
+            L.push('          record: no passing visual-QA run for the current version');
+        if (r.stale.length)
+            L.push(`          never ran: ${r.stale.join(', ')}`);
+        if (r.failed.length)
+            L.push(`          failed: ${r.failed.join(', ')}`);
+        if (r.rerun) {
+            L.push(`          today: ${r.rerun.verdict.toUpperCase()}${r.rerun.error ? ` (${r.rerun.error})` : ''}${r.rerun.inspection ? `  inspection sheets: ${r.rerun.inspection}` : ''}`);
+            for (const f of r.rerun.failing.slice(0, 14))
+                L.push(`            FAIL ${f.id} — ${f.detail.slice(0, 220)}`);
+        }
+    }
+    if (bad.length) {
+        L.push('');
+        L.push('A STALE or FAIL car is on sale on a record that does not cover today\'s gates. Re-run them (--rerun), fix what fails, stage a new');
+        L.push('version of the SAME item (vehicle publish --item <id> --package-version), and pass hosted visual QA on it. Until then, delist it.');
+    }
+    return L.join('\n');
+}
+/**
+ * The listing gate for a VEHICLE: before a new Claim/Buy route is created, its current version's passing visual-QA record
+ * must have run, and passed, every blocking gate that exists today. Returns null for an item that is not a vehicle.
+ */
+async function vehicleListingGate(apiBase, itemId) {
+    const base = apiBase.replace(/\/$/, '');
+    const it = await getJson(`${base}/api/v1/universal-items/${itemId}`);
+    const item = it.item ?? {};
+    if (item.itemType !== 'vehicle' && item.kind !== 'vehicle')
+        return null;
+    const st = await getJson(`${base}/api/v1/universal-items/${itemId}/visual-qa`);
+    return judgeRecord(itemId, String(item.title ?? itemId), item.packageVersion ?? null, st);
+}
+function listingRefusal(j) {
+    return [
+        `✖ ${j.title} (${j.itemId}) cannot be listed: its visual-QA record ${j.status === 'no-record' ? 'does not exist for the current version' : `(run ${j.record?.runId?.slice(0, 8) ?? '?'}, ${j.record?.harness ?? '?'}) is ${j.status.toUpperCase()} against today's gates`}.`,
+        ...(j.failed.length ? [`  failed: ${j.failed.join(', ')}`] : []),
+        ...(j.stale.length ? [`  never ran: ${j.stale.join(', ')}`] : []),
+        '  A car whose occupant or lamp asserts fail cannot be listed. Inspect it (`helix vehicle preview --item <id>`, every seat occupied), fix what',
+        '  fails, stage a new version of the same item, and pass hosted visual QA on it (`helix item visual-qa <id> --hosted`); then list it.',
+    ].join('\n');
+}
+//# sourceMappingURL=recheckListed.js.map

package/dist/vehicle/recheckListed.js.map

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

package/dist/vehicle/renditionManifest.d.ts

@@ -0,0 +1,10 @@
+type Variant = {
+    id: string;
+    cid: string;
+    mediaType?: string;
+    role?: string;
+};
+/** One line per rendition whose bytes the Version does not carry; empty when consistent or when no GLB variant is declared. */
+export declare function vehicleRenditionManifestProblems(root: unknown, variants: ReadonlyArray<Variant>, previousRoot?: unknown): string[];
+export declare const RENDITION_FIX = "point every mesh.visual.renditions[] artifactRef/checksumSha256/byteLength at the GLB variant the Version seals for that rendition (match by rendition id), then reseal";
+export {};

package/dist/vehicle/renditionManifest.js

@@ -0,0 +1,56 @@
+"use strict";
+// Does every drawn rendition a vehicle package names point at a GLB its Package Version actually carries?
+//
+// The engine draws a car from `mesh.visual.tiers[tier].renditionId` → that rendition's `artifactRef` (engine
+// `WorldVehicleSpawnAdapter#modelOf`), NOT from the manifest's `vehicle.model.web.*` variant. A root whose renditions
+// disagree with its own manifest therefore seals, passes `helix vehicle preview` (which serves the candidate GLB for every
+// rendition) and then draws OTHER bytes for owners. Subaru 1.0.22 (2026-10-07): the manifest's `target-balanced` was the
+// lamp-fixed 481c44ea…, the root's `target-balanced` and `target-desktop-high` still named the 1.0.21 GLB d2460a0c…, so
+// `visual-qa --package-version 1.0.22` drew the old car and failed late with "rendered bytes are not the pinned model".
+//
+// The same rule runs server-side on the trial and the version move (helix-backend-api `vehicleRenditionManifestProblems`).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RENDITION_FIX = void 0;
+exports.vehicleRenditionManifestProblems = vehicleRenditionManifestProblems;
+const hexOf = (cid) => /^cid:sha256:([0-9a-f]{64})$/.exec(cid)?.[1] ?? null;
+const rec = (v) => (v && typeof v === 'object' && !Array.isArray(v) ? v : null);
+/** One line per rendition whose bytes the Version does not carry; empty when consistent or when no GLB variant is declared. */
+function vehicleRenditionManifestProblems(root, variants, previousRoot) {
+    const glbById = new Map();
+    for (const v of variants) {
+        const hex = hexOf(v.cid);
+        const isGlb = v.mediaType ? v.mediaType === 'model/gltf-binary' : /^vehicle\.model\./.test(v.role ?? '');
+        if (hex && isGlb)
+            glbById.set(v.id, hex);
+    }
+    if (!glbById.size)
+        return [];
+    const carried = new Set(glbById.values());
+    // A derived rendition may legitimately be a runtime artifact that is not a Continuum object (an optimised derivative).
+    // What it may not be is the PREVIOUS car: bytes the item draws today, carried over while this Version seals a new model.
+    const previous = new Set();
+    const prev = rec(rec(rec(previousRoot)?.mesh)?.visual)?.renditions;
+    for (const raw of Array.isArray(prev) ? prev : []) {
+        const r = rec(raw);
+        if (r && r.kind !== 'source' && typeof r.checksumSha256 === 'string')
+            previous.add(r.checksumSha256);
+    }
+    const modelChanged = [...carried].some((d) => !previous.has(d));
+    const renditions = rec(rec(rec(root)?.mesh)?.visual)?.renditions;
+    const problems = [];
+    for (const raw of Array.isArray(renditions) ? renditions : []) {
+        const r = rec(raw);
+        if (!r || r.kind === 'source' || typeof r.checksumSha256 !== 'string')
+            continue;
+        const id = typeof r.id === 'string' ? r.id : '?';
+        const sha = r.checksumSha256;
+        const declared = glbById.get(id);
+        if (declared && declared !== sha)
+            problems.push(`rendition "${id}" draws ${sha.slice(0, 12)}… but the Version's "${id}" variant is ${declared.slice(0, 12)}…`);
+        else if (!declared && !carried.has(sha) && modelChanged && previous.has(sha))
+            problems.push(`rendition "${id}" still draws ${sha.slice(0, 12)}…, the car the item draws today, while the Version seals ${[...carried].map((d) => `${d.slice(0, 12)}…`).join(', ')}`);
+    }
+    return problems;
+}
+exports.RENDITION_FIX = 'point every mesh.visual.renditions[] artifactRef/checksumSha256/byteLength at the GLB variant the Version seals for that rendition (match by rendition id), then reseal';
+//# sourceMappingURL=renditionManifest.js.map

package/dist/vehicle/renditionManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renditionManifest.js","sourceRoot":"","sources":["../../src/vehicle/renditionManifest.ts"],"names":[],"mappings":";AAAA,0GAA0G;AAC1G,EAAE;AACF,6GAA6G;AAC7G,sHAAsH;AACtH,2HAA2H;AAC3H,yHAAyH;AACzH,wHAAwH;AACxH,wHAAwH;AACxH,EAAE;AACF,2HAA2H;;;AAQ3H,4EA2BC;AA/BD,MAAM,KAAK,GAAG,CAAC,GAAW,EAAiB,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACnG,MAAM,GAAG,GAAG,CAAC,CAAU,EAAkC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAA6B,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAEtJ,+HAA+H;AAC/H,SAAgB,gCAAgC,CAAC,IAAa,EAAE,QAAgC,EAAE,YAAsB;IACtH,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACzG,IAAI,GAAG,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,uHAAuH;IACvH,yHAAyH;IACzH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC;IACnE,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAAC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IAAC,CAAC;IAChL,MAAM,YAAY,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC;IACjE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC9D,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ;YAAE,SAAS;QAChF,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACjD,MAAM,GAAG,GAAG,CAAC,CAAC,cAAc,CAAC;QAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,QAAQ,IAAI,QAAQ,KAAK,GAAG;YAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,wBAAwB,EAAE,gBAAgB,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;aAC1J,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,YAAY,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,iBAAiB,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,4DAA4D,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvQ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAEY,QAAA,aAAa,GAAG,yKAAyK,CAAC"}

package/dist/vehicle/sealCheck.d.ts

@@ -0,0 +1,30 @@
+import type { Json } from './platform';
+export type SealIssue = {
+    level: 'error';
+    code: string;
+    path: string;
+    message: string;
+    fix: string;
+};
+export declare const CONTENT_RATING_VALUES: readonly ["everyone", "teen", "mature", "adult"];
+export declare const SEAL_LIMITS: {
+    readonly packageName: 160;
+    readonly packageSlug: 160;
+    readonly itemTitle: 100;
+    readonly itemDescription: 4000;
+    readonly itemTags: 20;
+    readonly itemTag: 40;
+};
+/** The Package Version / closure refusals of the real seal, as one issue per refusal (nothing is uploaded or sealed). */
+export declare function sealIntentIssues(intent: Json): SealIssue[];
+/** Package identity and Item fields the publish sends to the backend (a NEW Item needs a rating; a new version does not). */
+export declare function itemSealIssues(input: {
+    name?: string;
+    slug?: string;
+    title?: string;
+    description?: string;
+    tags?: string[];
+    contentRating?: string;
+    needsRating: boolean;
+}): SealIssue[];
+export declare function formatSealIssues(issues: SealIssue[]): string[];

package/dist/vehicle/sealCheck.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEAL_LIMITS = exports.CONTENT_RATING_VALUES = void 0;
+exports.sealIntentIssues = sealIntentIssues;
+exports.itemSealIssues = itemSealIssues;
+exports.formatSealIssues = formatSealIssues;
+const workflow_1 = require("../continuum/workflow");
+exports.CONTENT_RATING_VALUES = ['everyone', 'teen', 'mature', 'adult'];
+exports.SEAL_LIMITS = {
+    packageName: 160,
+    packageSlug: 160,
+    itemTitle: 100,
+    itemDescription: 4000,
+    itemTags: 20,
+    itemTag: 40,
+};
+const SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** The Package Version / closure refusals of the real seal, as one issue per refusal (nothing is uploaded or sealed). */
+function sealIntentIssues(intent) {
+    try {
+        (0, workflow_1.preflightContinuumPublicationIntent)(intent);
+        return [];
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return message.split('; ').filter(Boolean).map((part) => {
+            const at = /^(packageVersion\.[A-Za-z0-9_.[\]]+)/.exec(part);
+            return { level: 'error', code: 'SEAL_REFUSED', path: at?.[1] ?? 'packageVersion', message: `the seal would refuse this publish: ${part}`, fix: at ? `correct ${at[1]} (in publish.json / addon.json provenance, version or the package files it names)` : 'correct the field named, then re-run' };
+        });
+    }
+}
+/** Package identity and Item fields the publish sends to the backend (a NEW Item needs a rating; a new version does not). */
+function itemSealIssues(input) {
+    const out = [];
+    const add = (code, path, message) => { out.push({ level: 'error', code, path, message, fix: 'correct the field named, then re-run (nothing was uploaded)' }); };
+    if (input.needsRating && !exports.CONTENT_RATING_VALUES.includes(String(input.contentRating))) {
+        add('SEAL_CONTENT_RATING', 'contentRating', `contentRating is ${input.contentRating === undefined ? 'missing' : JSON.stringify(input.contentRating)}: a new Item needs a creator-attested rating, one of ${exports.CONTENT_RATING_VALUES.join(', ')} (pass --content-rating or set it in the directory's JSON)`);
+    }
+    if (input.name !== undefined && (input.name.length < 1 || input.name.length > exports.SEAL_LIMITS.packageName))
+        add('SEAL_PACKAGE_NAME', 'package.name', `the Package name is ${input.name.length} characters; it must be 1-${exports.SEAL_LIMITS.packageName}`);
+    if (input.slug !== undefined && (input.slug.length > exports.SEAL_LIMITS.packageSlug || !SLUG_RE.test(input.slug)))
+        add('SEAL_PACKAGE_SLUG', 'package.slug', `the Package slug ${JSON.stringify(input.slug)} must be lowercase alphanumeric segments joined by single hyphens, at most ${exports.SEAL_LIMITS.packageSlug} characters`);
+    if (input.title !== undefined && (input.title.length < 1 || input.title.length > exports.SEAL_LIMITS.itemTitle))
+        add('SEAL_ITEM_TITLE', 'title', `the Item title is ${input.title.length} characters; it must be 1-${exports.SEAL_LIMITS.itemTitle}`);
+    if (input.description !== undefined && input.description.length > exports.SEAL_LIMITS.itemDescription)
+        add('SEAL_ITEM_DESCRIPTION', 'description', `the Item description is ${input.description.length} characters; the limit is ${exports.SEAL_LIMITS.itemDescription}`);
+    if (input.tags !== undefined) {
+        if (input.tags.length > exports.SEAL_LIMITS.itemTags)
+            add('SEAL_ITEM_TAGS', 'tags', `${input.tags.length} tags; the limit is ${exports.SEAL_LIMITS.itemTags}`);
+        const long = input.tags.filter((t) => t.length > exports.SEAL_LIMITS.itemTag);
+        if (long.length)
+            add('SEAL_ITEM_TAGS', 'tags', `tag(s) over ${exports.SEAL_LIMITS.itemTag} characters: ${long.map((t) => JSON.stringify(t.slice(0, 24) + '…')).join(', ')}`);
+    }
+    return out;
+}
+function formatSealIssues(issues) {
+    return issues.map((i) => `✖ [${i.code}] ${i.path}: ${i.message}`);
+}
+//# sourceMappingURL=sealCheck.js.map

package/dist/vehicle/sealCheck.js.map

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

package/dist/vehicle/simulate.d.ts

@@ -0,0 +1,219 @@
+import type { EngineRuntime, LoadedRuntime } from './simulateRuntime';
+import type { VehicleIssue } from './validate';
+import { type KeyboardLaunchReport } from './keyboardLaunch';
+type Json = Record<string, unknown>;
+/** The fraction a figure may miss its target by when a spec leaf carries no tolerance. */
+export declare const DEFAULT_SPEC_TOLERANCE = 0.1;
+/** Degrees. A car resting tilted more than this in the instrument is a defect (the harness rule). */
+export declare const REST_TILT_LIMIT_DEG = 3;
+export interface FigureDef {
+    key: string;
+    label: string;
+    unit: string;
+}
+/** Every figure a target can name. Keys are the package `targets` keys (the runtime's own, plus three this adds). */
+export declare const FIGURES: readonly FigureDef[];
+export interface Target {
+    /** A FIGURES key, or `brakingFrom<N>(Kph|Mph)ToZeroM` for a spec-requested stop. */
+    key: string;
+    value: number;
+    /** Fraction: 0.08 = ±8 %. */
+    tolerance: number;
+    source: 'package' | 'spec';
+    /** Where the target came from (`targets.zeroToHundredKphS`, `perf.0_100_kmh_s`). */
+    path: string;
+    /** Set when the source gave no tolerance and the default was applied. */
+    defaultedTolerance?: boolean;
+    /** For braking stops: the entry speed in m/s. */
+    fromMps?: number;
+}
+/** A braking target's entry speed (m/s), for the keys that are stops. */
+export declare function brakingEntryMps(key: string): number | undefined;
+/** The package's own `targets`, for the keys this instrument measures. Unknown keys are ignored (not every target is a drive figure). */
+export declare function targetsFromPackage(pkg: unknown): Target[];
+/** Reference-spec paths (the harness `reference/<car>-spec.json` shape) → figure keys. */
+export declare const SPEC_ALIASES: ReadonlyArray<[string, string[]]>;
+/**
+ * Targets from a `--spec` file. Three shapes are accepted:
+ *   - a vehicle package, or `{ "targets": { … } }` — package-style `{ value, tolerance }` (a fraction);
+ *   - a reference spec — `perf.0_100_kmh_s`, `perf.braking_100_0_m` (from 100 km/h), `perf.braking_70mph_0_m`
+ *     (from 70 mph) … with `{ value, tol_pct }` (a percent) or a bare number (tolerance 10 %);
+ *   - a flat map of package-style target keys.
+ */
+export declare function targetsFromSpec(spec: unknown, file?: string): Target[];
+export interface Comparison {
+    key: string;
+    figure: string;
+    unit: string;
+    measured: number | null;
+    target: number;
+    tolerance: number;
+    /** (measured − target) / target; null when nothing was measured. */
+    error: number | null;
+    pass: boolean;
+    source: 'package' | 'spec';
+    path: string;
+    note?: string;
+}
+/** The runtime's `compareToTargets` rule, one figure at a time. A figure that could not be measured FAILS. */
+export declare function compareFigure(measured: number | null | undefined, target: Pick<Target, 'value' | 'tolerance'>): {
+    error: number | null;
+    pass: boolean;
+};
+export declare function figureLabel(key: string): {
+    label: string;
+    unit: string;
+};
+export interface TurboLag {
+    /** Seconds from full throttle to 90 % of the pull's peak acceleration; null when the roll-on could not be set up. */
+    lagS: number | null;
+    gear: number;
+    transmission: 'manual' | 'automatic';
+    startRpm: number;
+    startSpeedKph: number;
+    rpmAt90: number | null;
+    peakAccelG: number;
+    startAccelG: number;
+    reason?: string;
+}
+export interface CurveShape {
+    points: number;
+    peakTorqueNm: number;
+    peakTorqueRpm: number;
+    torqueAtLagStartRpm: number | null;
+    /** Torque at the roll-on start rpm as a fraction of peak torque. */
+    lagStartFractionOfPeak: number | null;
+    rpmAt50PctPeak: number | null;
+    rpmAt90PctPeak: number | null;
+    /** Midpoint rpm of the steepest rising segment, and its slope. */
+    steepestRiseRpm: number | null;
+    steepestRiseNmPer1000Rpm: number | null;
+    boost: {
+        boostTorqueCoef: number | null;
+        curveBoostBar: number | null;
+        turbine: boolean;
+        induction: string | null;
+        modelsBoostTorque: boolean;
+    };
+}
+export interface SimulationFigures {
+    zeroToHundredKphS: number | null;
+    zeroToSixtyMphS: number | null;
+    quarterMileS: number | null;
+    topSpeedKph: number | null;
+    topSpeedConverged: boolean;
+    ungovernedTopSpeedKph: number | null;
+    brakingHundredToZeroM: number | null;
+    brakingSixtyToZeroM: number | null;
+    lateralG: number | null;
+    turboLagS: number | null;
+    peakAccelG: number | null;
+    gearsUsed: number | null;
+    rpmAtSixtyMph: number | null;
+    /** Spec-requested extra stops, by key (`brakingFrom70MphToZeroM`). */
+    extraBraking: Record<string, number | null>;
+}
+export interface RestPose {
+    allGrounded: boolean;
+    chassisClearanceM: number | null;
+    rideHeightM: number | null;
+    pitchDeg: number | null;
+    rollDeg: number | null;
+}
+export interface SimulationReport {
+    ok: boolean;
+    package: {
+        id: string | null;
+        displayName: string | null;
+    };
+    runtime: LoadedRuntime['info'];
+    figures: SimulationFigures;
+    rest: RestPose;
+    turboLag: TurboLag;
+    curve: CurveShape | null;
+    comparisons: Comparison[];
+    /** Rest-pose failures (not grounded, tilted). */
+    restFailures: string[];
+    failures: number;
+    notes: string[];
+    /** How the gearbox shifts: is it auto, and does the live drive's manual layer apply. */
+    shift: ShiftPolicy;
+    /** Loud shift-policy caveats (a manual box the live drive will pin in 1st unless shifted, or auto-shift unverified live). */
+    shiftWarnings: string[];
+    /**
+     * The full-throttle DIGITAL launch a keyboard player makes (see `keyboardLaunch.ts`): null when skipped. Its FAIL
+     * (not drivable on a keyboard) counts as a failure; its WARN does not.
+     */
+    keyboardLaunch: KeyboardLaunchReport | null;
+    /**
+     * The package's `simulation.land.tractionControl`, as the runtime that ran it treats it. `modelled` is false when the
+     * block is authored but the runtime predates it (it is then ignored here AND live, by the same runtime).
+     */
+    tractionControl: TractionControlReport;
+    /**
+     * Engine-policy warnings (`enginePolicy.ts`): a speed limiter far below the ungoverned top speed (the platform car runs
+     * ungoverned) and a torque curve above the declared crank figures. Printed with the report; `validate` surfaces them.
+     */
+    policy: VehicleIssue[];
+}
+export interface TractionControlReport {
+    authored: boolean;
+    enabled: boolean;
+    modelled: boolean;
+    spec: Json | null;
+}
+/** First engine version whose land solver honours `simulation.land.tractionControl`. */
+export declare const TRACTION_CONTROL_MIN_ENGINE = "0.3.204";
+/** Read the authored traction-control block and whether this runtime models it (it exports the default block). */
+export declare function tractionControlOf(p: Json, hc: EngineRuntime): TractionControlReport;
+export interface ShiftPolicy {
+    /** `gearbox.kind` from the v2 driveline (manual | sequential | automatic | dct | …), null when absent. */
+    kind: string | null;
+    /** `gearbox.auto.enabled` — whether the box shifts itself in the default (automatic) drive mode. */
+    automatic: boolean;
+    /** `kind === 'manual' || 'sequential'` — the live drive then exposes a manual shift layer. */
+    supportsManual: boolean;
+}
+/** Torque-curve onset shape. `points` are [rpm, Nm] pairs (any order). */
+export declare function curveShape(points: Array<[number, number]>, lagStartRpm: number | null, engine: Json, turbine: boolean, induction: string | null): CurveShape | null;
+/** The roll-on start rpm for a driveline (see the header). */
+export declare function lagStartRpm(driveline: {
+    engine: {
+        idleRpm: number;
+        limiterRpm: number;
+    };
+    clutch?: {
+        launchStartRpm?: number;
+    };
+    gearbox?: {
+        kind?: string;
+        auto?: {
+            enabled?: boolean;
+            downRpm?: number;
+        };
+    };
+}, automatic: boolean): number;
+/** The fixed-gear roll-on. Exported for the smoke test; needs a loaded runtime. */
+export declare function measureTurboLag(hc: EngineRuntime, tuning: Json): Promise<TurboLag>;
+/** Read a vehicle package from a directory or a JSON file. */
+export declare function readVehiclePackageArg(arg: string): {
+    file: string;
+    dir: string;
+    pkg: unknown;
+};
+export interface SimulateOptions {
+    /** Extra targets (a `--spec` file's). */
+    specTargets?: Target[];
+    /** Skip the turbo-lag roll-on (validate does not need it unless a target names it). */
+    skipTurboLag?: boolean;
+    /** Skip the keyboard launch and its hands-off yaw probe. */
+    skipKeyboardLaunch?: boolean;
+}
+/** Measure the package with a loaded runtime and compare every figure. Throws only when the engine cannot run it. */
+export declare function simulateVehicle(pkg: unknown, runtime: LoadedRuntime, opts?: SimulateOptions): Promise<SimulationReport>;
+export declare function formatTractionControl(tc: TractionControlReport | undefined): string;
+/** `withPolicy: false` omits the engine-policy lines (`validate` already lists them as issues above the report). */
+export declare function formatSimulationReport(r: SimulationReport, opts?: {
+    withPolicy?: boolean;
+}): string;
+export {};