@virune/compiler 1.1.0-rc.0

package/dist/src/selfhost/bootstrap-artifact-normalizer.js

@@ -0,0 +1,226 @@
+import { createHash } from 'node:crypto';
+import { posix } from 'node:path';
+export const BOOTSTRAP_ARTIFACT_POLICY_VERSION = 1;
+const IGNORED_METADATA_FIELDS = ['generatedAt', 'runId'];
+const ignoredMetadataFieldSet = new Set(IGNORED_METADATA_FIELDS);
+const sha256Pattern = /^[0-9a-f]{64}$/u;
+export function normalizeBootstrapArtifact(input) {
+    if (input.policyVersion !== BOOTSTRAP_ARTIFACT_POLICY_VERSION) {
+        throw new Error(`Unsupported bootstrap artifact policy version: ${input.policyVersion}`);
+    }
+    const root = normalizeRoot(input.root);
+    const modules = input.modules.map(module => normalizeModule(module, root)).sort(comparePath);
+    assertUniquePaths(modules.map(module => module.path), 'module');
+    const checksumManifest = input.checksumManifest
+        .map(entry => normalizeChecksum(entry, root))
+        .sort(comparePath);
+    assertUniquePaths(checksumManifest.map(entry => entry.path), 'checksum');
+    const artifact = {
+        policy: {
+            version: BOOTSTRAP_ARTIFACT_POLICY_VERSION,
+            ignoredMetadataFields: [...IGNORED_METADATA_FIELDS],
+        },
+        moduleOrder: modules.map(module => module.path),
+        modules,
+        diagnosticsSchema: canonicalizeJson(input.diagnosticsSchema),
+        metadata: normalizeMetadata(input.metadata),
+        checksumManifest,
+    };
+    const serialized = JSON.stringify(artifact);
+    return {
+        artifact,
+        serialized,
+        sha256: createHash('sha256').update(serialized).digest('hex'),
+    };
+}
+export function diffBootstrapArtifacts(before, after) {
+    const changes = [];
+    const beforeValue = JSON.parse(before.serialized);
+    const afterValue = JSON.parse(after.serialized);
+    collectDiff(beforeValue, afterValue, '', changes);
+    return {
+        equal: changes.length === 0,
+        beforeSha256: before.sha256,
+        afterSha256: after.sha256,
+        changes,
+    };
+}
+function normalizeModule(module, root) {
+    const path = canonicalizeArtifactPath(module.path, root);
+    const exports = [...module.exports].sort(compareText);
+    assertUniqueValues(exports, `exports for ${path}`);
+    return {
+        path,
+        code: normalizeLineEndings(module.code),
+        sourceMap: canonicalizeSourceMap(module.sourceMap, root),
+        exports,
+    };
+}
+function normalizeChecksum(entry, root) {
+    const sha256 = entry.sha256.toLowerCase();
+    if (!sha256Pattern.test(sha256)) {
+        throw new Error(`Invalid SHA-256 for ${entry.path}`);
+    }
+    return {
+        path: canonicalizeArtifactPath(entry.path, root),
+        sha256,
+    };
+}
+function normalizeMetadata(metadata) {
+    const normalized = {};
+    for (const key of Object.keys(metadata).sort(compareText)) {
+        if (ignoredMetadataFieldSet.has(key))
+            continue;
+        const value = metadata[key];
+        if (value === undefined)
+            throw new Error(`Metadata field ${key} is undefined`);
+        normalized[key] = canonicalizeJson(value);
+    }
+    return normalized;
+}
+function canonicalizeSourceMap(value, root, path = []) {
+    if (value === null || typeof value === 'boolean' || typeof value === 'number') {
+        return canonicalizeJson(value);
+    }
+    if (typeof value === 'string') {
+        const key = path.at(-1);
+        const parent = path.at(-2);
+        if (key === 'file' || parent === 'sources')
+            return canonicalizeArtifactPath(value, root);
+        if (key === 'sourceRoot')
+            return value.length === 0 ? '' : canonicalizeArtifactPath(value, root);
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry, index) => canonicalizeSourceMap(entry, root, [...path, String(index)]));
+    }
+    const objectValue = value;
+    const normalized = {};
+    for (const key of Object.keys(objectValue).sort(compareText)) {
+        const entry = objectValue[key];
+        if (entry === undefined)
+            throw new Error(`Source map field ${[...path, key].join('.')} is undefined`);
+        normalized[key] = canonicalizeSourceMap(entry, root, [...path, key]);
+    }
+    return normalized;
+}
+function canonicalizeJson(value, path = []) {
+    if (value === null || typeof value === 'boolean' || typeof value === 'string')
+        return value;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            throw new Error(`Non-finite JSON number at ${path.join('.') || '<root>'}`);
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry, index) => canonicalizeJson(entry, [...path, String(index)]));
+    }
+    const objectValue = value;
+    const normalized = {};
+    for (const key of Object.keys(objectValue).sort(compareText)) {
+        const entry = objectValue[key];
+        if (entry === undefined)
+            throw new Error(`JSON field ${[...path, key].join('.')} is undefined`);
+        normalized[key] = canonicalizeJson(entry, [...path, key]);
+    }
+    return normalized;
+}
+function canonicalizeArtifactPath(value, root) {
+    let candidate = normalizeSlashes(value);
+    if (candidate.startsWith('file://'))
+        candidate = candidate.slice('file://'.length);
+    if (root.length > 0) {
+        if (candidate === root)
+            candidate = '.';
+        else if (candidate.startsWith(`${root}/`))
+            candidate = candidate.slice(root.length + 1);
+    }
+    while (candidate.startsWith('./'))
+        candidate = candidate.slice(2);
+    candidate = posix.normalize(candidate);
+    if (candidate.length === 0 || candidate === '.')
+        throw new Error(`Artifact path must reference a file: ${value}`);
+    if (candidate === '..' || candidate.startsWith('../') || candidate.startsWith('/') || /^[A-Za-z]:\//u.test(candidate)) {
+        throw new Error(`Artifact path escapes the configured root: ${value}`);
+    }
+    return candidate;
+}
+function normalizeRoot(value) {
+    let root = normalizeSlashes(value);
+    if (root.startsWith('file://'))
+        root = root.slice('file://'.length);
+    while (root.length > 1 && root.endsWith('/'))
+        root = root.slice(0, -1);
+    return root;
+}
+function normalizeSlashes(value) {
+    return value.replaceAll('\\', '/');
+}
+function normalizeLineEndings(value) {
+    return value.replaceAll('\r\n', '\n').replaceAll('\r', '\n');
+}
+function assertUniquePaths(paths, kind) {
+    assertUniqueValues(paths, `${kind} paths`);
+}
+function assertUniqueValues(values, kind) {
+    for (let index = 1; index < values.length; index += 1) {
+        if (values[index] === values[index - 1])
+            throw new Error(`Duplicate ${kind}: ${values[index]}`);
+    }
+}
+function comparePath(left, right) {
+    return compareText(left.path, right.path);
+}
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function collectDiff(before, after, path, changes) {
+    if (before === undefined || after === undefined) {
+        pushDiff(path, before, after, changes);
+        return;
+    }
+    if (isPrimitive(before) || isPrimitive(after)) {
+        if (!Object.is(before, after))
+            pushDiff(path, before, after, changes);
+        return;
+    }
+    if (Array.isArray(before) || Array.isArray(after)) {
+        if (!Array.isArray(before) || !Array.isArray(after)) {
+            pushDiff(path, before, after, changes);
+            return;
+        }
+        const length = Math.max(before.length, after.length);
+        for (let index = 0; index < length; index += 1) {
+            collectDiff(before[index], after[index], `${path}[${index}]`, changes);
+        }
+        return;
+    }
+    const beforeObject = before;
+    const afterObject = after;
+    const keys = [...new Set([...Object.keys(beforeObject), ...Object.keys(afterObject)])].sort(compareText);
+    for (const key of keys) {
+        const childPath = path.length === 0 ? key : `${path}.${key}`;
+        collectDiff(beforeObject[key], afterObject[key], childPath, changes);
+    }
+}
+function isPrimitive(value) {
+    return value === null || typeof value !== 'object';
+}
+function pushDiff(path, before, after, changes) {
+    changes.push({
+        section: sectionOf(path),
+        path: path.length === 0 ? '<root>' : path,
+        before: before === undefined ? '<missing>' : JSON.stringify(before),
+        after: after === undefined ? '<missing>' : JSON.stringify(after),
+    });
+}
+function sectionOf(path) {
+    if (path.length === 0)
+        return '<root>';
+    const dot = path.indexOf('.');
+    const bracket = path.indexOf('[');
+    const boundaryCandidates = [dot, bracket].filter(value => value >= 0);
+    const boundary = boundaryCandidates.length === 0 ? path.length : Math.min(...boundaryCandidates);
+    return path.slice(0, boundary);
+}
+//# sourceMappingURL=bootstrap-artifact-normalizer.js.map

package/dist/src/selfhost/bootstrap-artifact-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-artifact-normalizer.js","sourceRoot":"","sources":["../../../src/selfhost/bootstrap-artifact-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAU,CAAC;AA6E5D,MAAM,uBAAuB,GAAG,CAAC,aAAa,EAAE,OAAO,CAAU,CAAC;AAClE,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAS,uBAAuB,CAAC,CAAC;AACzE,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC,MAAM,UAAU,0BAA0B,CAAC,KAA6B;IACvE,IAAI,KAAK,CAAC,aAAa,KAAK,iCAAiC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,kDAAkD,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7F,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEhE,MAAM,gBAAgB,GAAG,KAAK,CAAC,gBAAgB;SAC7C,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;SAC5C,IAAI,CAAC,WAAW,CAAC,CAAC;IACpB,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;IAEzE,MAAM,QAAQ,GAAgC;QAC7C,MAAM,EAAE;YACP,OAAO,EAAE,iCAAiC;YAC1C,qBAAqB,EAAE,CAAC,GAAG,uBAAuB,CAAC;SACnD;QACD,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/C,OAAO;QACP,iBAAiB,EAAE,gBAAgB,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAC5D,QAAQ,EAAE,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC3C,gBAAgB;KAChB,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO;QACN,QAAQ;QACR,UAAU;QACV,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KAC7D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACrC,MAAyC,EACzC,KAAwC;IAExC,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAc,CAAC;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAc,CAAC;IAC7D,WAAW,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO;QACN,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC,MAAM;QAC3B,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,OAAO;KACP,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACvB,MAAoC,EACpC,IAAY;IAEZ,MAAM,IAAI,GAAG,wBAAwB,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtD,kBAAkB,CAAC,OAAO,EAAE,eAAe,IAAI,EAAE,CAAC,CAAC;IACnD,OAAO;QACN,IAAI;QACJ,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC;QACvC,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC;QACxD,OAAO;KACP,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA6B,EAAE,IAAY;IACrE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO;QACN,IAAI,EAAE,wBAAwB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;QAChD,MAAM;KACN,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,QAA6C;IACvE,MAAM,UAAU,GAA8B,EAAE,CAAC;IACjD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3D,IAAI,uBAAuB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,eAAe,CAAC,CAAC;QAC/E,UAAU,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAgB,EAAE,IAAY,EAAE,OAA0B,EAAE;IAC1F,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/E,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,KAAK,MAAM,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzF,IAAI,GAAG,KAAK,YAAY;YAAE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACjG,OAAO,KAAK,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,WAAW,GAAG,KAAmB,CAAC;IACxC,MAAM,UAAU,GAA8B,EAAE,CAAC;IACjD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACtG,UAAU,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAgB,EAAE,OAA0B,EAAE;IACvE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5F,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;QACxG,OAAO,KAAK,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,WAAW,GAAG,KAAmB,CAAC;IACxC,MAAM,UAAU,GAA8B,EAAE,CAAC;IACjD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAChG,UAAU,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAa,EAAE,IAAY;IAC5D,IAAI,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACnF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,IAAI,SAAS,KAAK,IAAI;YAAE,SAAS,GAAG,GAAG,CAAC;aACnC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC;YAAE,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClE,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,KAAK,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,KAAK,EAAE,CAAC,CAAC;IAClH,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvH,MAAM,IAAI,KAAK,CAAC,8CAA8C,KAAK,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IACnC,IAAI,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAwB,EAAE,IAAY;IAChE,kBAAkB,CAAC,KAAK,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAyB,EAAE,IAAY;IAClE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;AACF,CAAC;AAED,SAAS,WAAW,CAAsC,IAAO,EAAE,KAAQ;IAC1E,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC/C,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,WAAW,CACnB,MAA6B,EAC7B,KAA4B,EAC5B,IAAY,EACZ,OAAqC;IAErC,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO;IACR,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACtE,OAAO;IACR,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACvC,OAAO;QACR,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACrD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAChD,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;QACD,OAAO;IACR,CAAC;IACD,MAAM,YAAY,GAAG,MAAoB,CAAC;IAC1C,MAAM,WAAW,GAAG,KAAmB,CAAC;IACxC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzG,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;QAC7D,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;AACF,CAAC;AAED,SAAS,WAAW,CAAC,KAAgB;IACpC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACpD,CAAC;AAED,SAAS,QAAQ,CAChB,IAAY,EACZ,MAA6B,EAC7B,KAA4B,EAC5B,OAAqC;IAErC,OAAO,CAAC,IAAI,CAAC;QACZ,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC;QACxB,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QACzC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QACnE,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;KAChE,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC;IACjG,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/selfhost/bootstrap-artifact-snapshot.d.ts

@@ -0,0 +1,23 @@
+import type { ProjectBuildResult } from '../project/project.js';
+import { type JsonValue, type NormalizedBootstrapArtifactResult } from './bootstrap-artifact-normalizer.js';
+export type BootstrapStage = 'stage0' | 'stage1' | 'stage2';
+export interface BootstrapArtifactSnapshotOptions {
+    readonly stage: BootstrapStage;
+    readonly compilerVersion: string;
+    readonly runtimeAbi: string;
+    readonly interopAbi: string;
+    readonly seedSha256?: string;
+    readonly generatedAt?: string;
+    readonly runId?: string;
+    readonly metadata?: Readonly<Record<string, JsonValue>>;
+    readonly diagnosticsSchema?: JsonValue;
+}
+/**
+ * Convert an actual project build into the versioned bootstrap artifact model.
+ * The snapshot is data-only and is suitable for Stage 1／Stage 2 comparison,
+ * but it does not perform either stage or select a production compiler.
+ */
+export declare function snapshotProjectBuild(result: ProjectBuildResult, options: BootstrapArtifactSnapshotOptions): NormalizedBootstrapArtifactResult;
+/** Extract the finite ES module export forms emitted by Virune's emitter. */
+export declare function extractGeneratedModuleExports(code: string): readonly string[];
+//# sourceMappingURL=bootstrap-artifact-snapshot.d.ts.map

package/dist/src/selfhost/bootstrap-artifact-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-artifact-snapshot.d.ts","sourceRoot":"","sources":["../../../src/selfhost/bootstrap-artifact-snapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAGN,KAAK,SAAS,EACd,KAAK,iCAAiC,EACtC,MAAM,oCAAoC,CAAC;AAE5C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;CACvC;AAgBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,gCAAgC,GACvC,iCAAiC,CAsDnC;AAED,6EAA6E;AAC7E,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAqB7E"}

package/dist/src/selfhost/bootstrap-artifact-snapshot.js

@@ -0,0 +1,122 @@
+import { createHash } from 'node:crypto';
+import { BOOTSTRAP_ARTIFACT_POLICY_VERSION, normalizeBootstrapArtifact, } from './bootstrap-artifact-normalizer.js';
+const defaultDiagnosticsSchema = {
+    type: 'object',
+    required: ['code', 'severity', 'message', 'span'],
+    properties: {
+        code: { type: 'string' },
+        severity: { enum: ['error', 'warning'] },
+        message: { type: 'string' },
+        span: {
+            type: 'object',
+            required: ['file', 'start', 'end'],
+        },
+    },
+};
+/**
+ * Convert an actual project build into the versioned bootstrap artifact model.
+ * The snapshot is data-only and is suitable for Stage 1／Stage 2 comparison,
+ * but it does not perform either stage or select a production compiler.
+ */
+export function snapshotProjectBuild(result, options) {
+    const errors = result.diagnostics.filter(diagnostic => diagnostic.severity === 'error');
+    if (errors.length > 0) {
+        throw new Error(`Cannot snapshot a failed project build: ${errors.length} error diagnostic(s)`);
+    }
+    assertNonEmpty(options.compilerVersion, 'compilerVersion');
+    assertNonEmpty(options.runtimeAbi, 'runtimeAbi');
+    assertNonEmpty(options.interopAbi, 'interopAbi');
+    if (options.seedSha256 !== undefined)
+        assertSha256(options.seedSha256, 'seedSha256');
+    const modules = result.modules.flatMap(module => {
+        if (module.output === undefined && module.outputPath === undefined)
+            return [];
+        if (module.output === undefined || module.outputPath === undefined) {
+            throw new Error(`Incomplete emitted module snapshot for ${module.source.path}`);
+        }
+        return [{
+                path: module.outputPath,
+                code: module.output.code,
+                sourceMap: parseSourceMap(module.output.map, module.outputPath),
+                exports: extractGeneratedModuleExports(module.output.code),
+            }];
+    });
+    if (modules.length === 0)
+        throw new Error('Cannot snapshot a project build with no emitted modules');
+    const checksumManifest = modules.flatMap(module => {
+        const codeEntry = { path: module.path, sha256: sha256(module.code) };
+        if (!result.config.sourceMap)
+            return [codeEntry];
+        const sourceModule = result.modules.find(item => item.outputPath === module.path);
+        if (sourceModule?.output === undefined)
+            throw new Error(`Missing source map for ${module.path}`);
+        return [codeEntry, { path: `${module.path}.map`, sha256: sha256(sourceModule.output.map) }];
+    });
+    return normalizeBootstrapArtifact({
+        policyVersion: BOOTSTRAP_ARTIFACT_POLICY_VERSION,
+        root: result.root,
+        modules,
+        diagnosticsSchema: options.diagnosticsSchema ?? defaultDiagnosticsSchema,
+        metadata: {
+            ...options.metadata,
+            stage: options.stage,
+            compilerVersion: options.compilerVersion,
+            languageVersion: result.config.languageVersion,
+            platform: result.config.platform,
+            target: result.config.target,
+            runtimeAbi: options.runtimeAbi,
+            interopAbi: options.interopAbi,
+            sourceMap: result.config.sourceMap,
+            sourcesContent: result.config.sourcesContent,
+            ...(options.seedSha256 === undefined ? {} : { seedSha256: options.seedSha256.toLowerCase() }),
+            ...(options.generatedAt === undefined ? {} : { generatedAt: options.generatedAt }),
+            ...(options.runId === undefined ? {} : { runId: options.runId }),
+        },
+        checksumManifest,
+    });
+}
+/** Extract the finite ES module export forms emitted by Virune's emitter. */
+export function extractGeneratedModuleExports(code) {
+    const exports = [];
+    const declarationPattern = /(?:^|\n)export\s+(?:async\s+)?(?:function|const)\s+([A-Za-z_$][A-Za-z0-9_$]*)/gu;
+    for (const match of code.matchAll(declarationPattern)) {
+        const name = match[1];
+        if (name !== undefined)
+            exports.push(name);
+    }
+    const listPattern = /(?:^|\n)export\s*\{([^}]*)\};/gu;
+    for (const match of code.matchAll(listPattern)) {
+        for (const entry of (match[1] ?? '').split(',')) {
+            const value = entry.trim();
+            if (value.length === 0)
+                continue;
+            const parts = value.split(/\s+as\s+/u);
+            const name = parts.at(-1);
+            if (name === undefined || !/^[A-Za-z_$][A-Za-z0-9_$]*$/u.test(name)) {
+                throw new Error(`Unsupported generated export entry: ${value}`);
+            }
+            exports.push(name);
+        }
+    }
+    return exports;
+}
+function parseSourceMap(value, outputPath) {
+    try {
+        return JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error(`Invalid source map for ${outputPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function sha256(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+function assertNonEmpty(value, name) {
+    if (value.length === 0)
+        throw new Error(`${name} must not be empty`);
+}
+function assertSha256(value, name) {
+    if (!/^[0-9a-f]{64}$/iu.test(value))
+        throw new Error(`${name} must be a SHA-256 value`);
+}
+//# sourceMappingURL=bootstrap-artifact-snapshot.js.map

package/dist/src/selfhost/bootstrap-artifact-snapshot.js.map

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

package/dist/src/selfhost/bootstrap-compiler-selection.d.ts

@@ -0,0 +1,36 @@
+import type { BootstrapStageArtifact } from './bootstrap-stage-executor.js';
+import { type BootstrapRollbackDecisionResult } from './bootstrap-rollback-decision.js';
+import { type InternalKernelCompiler } from './compiler-facade.js';
+import type { KernelOutputV1 } from './contract.js';
+export interface BootstrapSelfHostCandidate {
+    readonly artifact: BootstrapStageArtifact;
+    readonly temporaryRoot: string;
+}
+export interface BootstrapCompilerSelectionRequest {
+    readonly rollbackDecision: unknown;
+    readonly input: unknown;
+    readonly selfHostCandidate?: BootstrapSelfHostCandidate;
+}
+export interface BootstrapCompilerSelectionDependencies {
+    readonly legacyCompiler?: InternalKernelCompiler;
+}
+export interface BootstrapCompilerSelectionResult {
+    readonly rollback: BootstrapRollbackDecisionResult;
+    readonly selection: 'legacy' | 'self-host';
+    readonly output: KernelOutputV1;
+    readonly materializedStageArtifactSha256: string | null;
+}
+export declare class BootstrapCompilerSelectionError extends Error {
+    readonly path: string;
+    readonly name = "BootstrapCompilerSelectionError";
+    constructor(path: string, message: string);
+}
+/**
+ * Evaluate rollback evidence before touching a Self-host compiler candidate.
+ *
+ * A Legacy rollback must remain usable when the candidate artifact is missing,
+ * corrupt, or otherwise impossible to materialize. The Stage artifact is read
+ * only after the rollback decision explicitly selects Self-host execution.
+ */
+export declare function executeBootstrapCompilerSelection(request: BootstrapCompilerSelectionRequest, dependencies?: BootstrapCompilerSelectionDependencies): Promise<BootstrapCompilerSelectionResult>;
+//# sourceMappingURL=bootstrap-compiler-selection.d.ts.map

package/dist/src/selfhost/bootstrap-compiler-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-compiler-selection.d.ts","sourceRoot":"","sources":["../../../src/selfhost/bootstrap-compiler-selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAEN,KAAK,+BAA+B,EACpC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAGN,KAAK,sBAAsB,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iCAAiC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;CACxD;AAED,MAAM,WAAW,sCAAsC;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACjD;AAED,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,+BAA+B,EAAE,MAAM,GAAG,IAAI,CAAC;CACxD;AAED,qBAAa,+BAAgC,SAAQ,KAAK;aAEtB,IAAI,EAAE,MAAM;IAD/C,SAAyB,IAAI,qCAAqC;gBAC/B,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAGhE;AAED;;;;;;GAMG;AACH,wBAAsB,iCAAiC,CACtD,OAAO,EAAE,iCAAiC,EAC1C,YAAY,GAAE,sCAA2C,GACvD,OAAO,CAAC,gCAAgC,CAAC,CAsC3C"}

package/dist/src/selfhost/bootstrap-compiler-selection.js

@@ -0,0 +1,52 @@
+import { evaluateBootstrapRollbackDecision, } from './bootstrap-rollback-decision.js';
+import { createInternalCompilerFacade, } from './compiler-facade.js';
+import { materializeStageCompilerFacade } from './stage-compiler-facade.js';
+export class BootstrapCompilerSelectionError extends Error {
+    path;
+    name = 'BootstrapCompilerSelectionError';
+    constructor(path, message) {
+        super(`${path}: ${message}`);
+        this.path = path;
+    }
+}
+/**
+ * Evaluate rollback evidence before touching a Self-host compiler candidate.
+ *
+ * A Legacy rollback must remain usable when the candidate artifact is missing,
+ * corrupt, or otherwise impossible to materialize. The Stage artifact is read
+ * only after the rollback decision explicitly selects Self-host execution.
+ */
+export async function executeBootstrapCompilerSelection(request, dependencies = {}) {
+    const rollback = evaluateBootstrapRollbackDecision(request.rollbackDecision);
+    if (rollback.decision.selection === 'legacy') {
+        const facadeDependencies = {
+            ...(dependencies.legacyCompiler === undefined
+                ? {}
+                : { legacyCompiler: dependencies.legacyCompiler }),
+        };
+        const facade = createInternalCompilerFacade(facadeDependencies);
+        return {
+            rollback,
+            selection: 'legacy',
+            output: await facade.compile(request.input, { selection: 'legacy' }),
+            materializedStageArtifactSha256: null,
+        };
+    }
+    const candidate = request.selfHostCandidate;
+    if (candidate === undefined) {
+        throw new BootstrapCompilerSelectionError('request.selfHostCandidate', 'Self-host selection requires a Stage compiler candidate');
+    }
+    const facade = await materializeStageCompilerFacade(candidate.artifact, candidate.temporaryRoot);
+    try {
+        return {
+            rollback,
+            selection: 'self-host',
+            output: await facade.compile(request.input, { selection: 'self-host' }),
+            materializedStageArtifactSha256: facade.artifactSha256,
+        };
+    }
+    finally {
+        await facade.dispose();
+    }
+}
+//# sourceMappingURL=bootstrap-compiler-selection.js.map

package/dist/src/selfhost/bootstrap-compiler-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-compiler-selection.js","sourceRoot":"","sources":["../../../src/selfhost/bootstrap-compiler-selection.ts"],"names":[],"mappings":"AACA,OAAO,EACN,iCAAiC,GAEjC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACN,4BAA4B,GAG5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAwB5E,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IAEtB;IADV,IAAI,GAAG,iCAAiC,CAAC;IAClE,YAAmC,IAAY,EAAE,OAAe;QAC/D,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QADK,SAAI,GAAJ,IAAI,CAAQ;IAE/C,CAAC;CACD;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACtD,OAA0C,EAC1C,eAAuD,EAAE;IAEzD,MAAM,QAAQ,GAAG,iCAAiC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7E,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,kBAAkB,GAAuC;YAC9D,GAAG,CAAC,YAAY,CAAC,cAAc,KAAK,SAAS;gBAC5C,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,cAAc,EAAE,CAAC;SACnD,CAAC;QACF,MAAM,MAAM,GAAG,4BAA4B,CAAC,kBAAkB,CAAC,CAAC;QAChE,OAAO;YACN,QAAQ;YACR,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;YACpE,+BAA+B,EAAE,IAAI;SACrC,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAC5C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,+BAA+B,CACxC,2BAA2B,EAC3B,yDAAyD,CACzD,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,8BAA8B,CAClD,SAAS,CAAC,QAAQ,EAClB,SAAS,CAAC,aAAa,CACvB,CAAC;IACF,IAAI,CAAC;QACJ,OAAO;YACN,QAAQ;YACR,SAAS,EAAE,WAAW;YACtB,MAAM,EAAE,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;YACvE,+BAA+B,EAAE,MAAM,CAAC,cAAc;SACtD,CAAC;IACH,CAAC;YAAS,CAAC;QACV,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;AACF,CAAC"}

package/dist/src/selfhost/bootstrap-execution-probe.d.ts

@@ -0,0 +1,42 @@
+import { type KernelOutputV1 } from './contract.js';
+import { type BootstrapArtifactSnapshotOptions } from './bootstrap-artifact-snapshot.js';
+import type { NormalizedBootstrapArtifactResult } from './bootstrap-artifact-normalizer.js';
+import { type SelfhostMvpModule } from './mvp-adapter.js';
+export declare const BOOTSTRAP_EXECUTION_PROBE_VERSION: 1;
+export interface BootstrapExecutionProbeOptions extends Omit<BootstrapArtifactSnapshotOptions, 'stage'> {
+    readonly temporaryRoot: string;
+    readonly entryModulePath?: string;
+}
+export interface BootstrapExecutionProbeArtifact {
+    readonly policyVersion: typeof BOOTSTRAP_EXECUTION_PROBE_VERSION;
+    readonly claim: 'stage0-compiler-execution-probe';
+    readonly productionEligible: false;
+    readonly compilerArtifactSha256: string;
+    readonly inputSha256: string;
+    readonly outputSha256: string;
+    readonly accepted: boolean;
+    readonly diagnosticCodes: readonly string[];
+    readonly emittedModulePaths: readonly string[];
+}
+export interface BootstrapExecutionProbeResult {
+    readonly compilerArtifact: NormalizedBootstrapArtifactResult;
+    readonly output: KernelOutputV1;
+    readonly artifact: BootstrapExecutionProbeArtifact;
+    readonly serialized: string;
+    readonly sha256: string;
+}
+/**
+ * Build the current Self-host MVP with Stage 0, load the emitted compiler as an
+ * executable candidate, and compile one canonical Kernel Contract input.
+ *
+ * This is deliberately an execution probe. It does not claim that the emitted
+ * compiler rebuilt its own multi-module source tree, produced Stage 1／2, or is
+ * eligible for production promotion.
+ */
+export declare function runBootstrapExecutionProbe(projectRoot: string, value: unknown, options: BootstrapExecutionProbeOptions): Promise<BootstrapExecutionProbeResult>;
+export declare function validateSelfhostMvpModule(value: unknown): SelfhostMvpModule;
+/** Materialize a normalized compiler artifact without changing repository outputs. */
+export declare function materializeBootstrapCompilerCandidate(compilerArtifact: NormalizedBootstrapArtifactResult, temporaryRoot: string): Promise<string>;
+/** Load the declared compiler entry from an isolated materialized artifact. */
+export declare function loadBootstrapCompilerCandidate(root: string, entryModulePath: string): Promise<SelfhostMvpModule>;
+//# sourceMappingURL=bootstrap-execution-probe.d.ts.map

package/dist/src/selfhost/bootstrap-execution-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-execution-probe.d.ts","sourceRoot":"","sources":["../../../src/selfhost/bootstrap-execution-probe.ts"],"names":[],"mappings":"AAKA,OAAO,EAKN,KAAK,cAAc,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEN,KAAK,gCAAgC,EACrC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAEN,KAAK,iBAAiB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,iCAAiC,EAAG,CAAU,CAAC;AAE5D,MAAM,WAAW,8BAChB,SAAQ,IAAI,CAAC,gCAAgC,EAAE,OAAO,CAAC;IACvD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,aAAa,EAAE,OAAO,iCAAiC,CAAC;IACjE,QAAQ,CAAC,KAAK,EAAE,iCAAiC,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,KAAK,CAAC;IACnC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,iCAAiC,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC/C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,8BAA8B,GACrC,OAAO,CAAC,6BAA6B,CAAC,CA6BxC;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAS3E;AAED,sFAAsF;AACtF,wBAAsB,qCAAqC,CAC1D,gBAAgB,EAAE,iCAAiC,EACnD,aAAa,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,+EAA+E;AAC/E,wBAAsB,8BAA8B,CACnD,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAM5B"}