@scriptc/compiler 0.2.4 → 0.2.6

package/dist/backend/native/runtime-inputs.d.ts

@@ -0,0 +1,12 @@
+/** Recipe bytes and dependency snapshots must cover every extracted owner in
+ * both source and installed builds. Keep this explicit: directory enumeration
+ * could accidentally hash tests, source maps, or stale installed modules. */
+export declare const NATIVE_RECIPE_IMPLEMENTATION_PATHS: string[];
+export declare const EXECUTABLE_RUNTIME_SOURCES: readonly ["scr_context.c", "scr_shared.c", "scr_number.c", "scr_bigint.c", "scr_string.c", "scr_grapheme.c", "scr_array.c", "scr_bytes.c", "scr_bytes_io.c", "scr_map.c", "scr_closure.c", "scr_ffi.c", "scr_object.c", "scr_union.c", "scr_exception.c", "scr_error.c", "scr_console.c", "scr_lib.c", "scr_path.c", "scr_url.c", "scr_url_params.c", "scr_json.c", "scr_node_builtin.c", "scr_async.c", "scr_crypto_async.c", "scr_child.c", "scr_cycle.c"];
+export declare function runtimeSrcDir(): string;
+/** The library base: the executable lane's unconditional sources minus the
+ * fiber/loop and child-process units, plus the library-mode TU. */
+export declare const LIB_RUNTIME_SOURCES: string[];
+export declare function nativeSourceFiles(directory: string, recursive: boolean, include?: (name: string) => boolean): Promise<string[]>;
+export declare function runtimeFingerprintInputPaths(rtDir: string): Promise<string[]>;
+export declare function runtimeFingerprint(rtDir: string): Promise<string>;

package/dist/backend/native/runtime-inputs.js

@@ -0,0 +1,165 @@
+import { createHash } from "node:crypto";
+import { createRequire } from "node:module";
+import { readdir, readFile, realpath, stat } from "node:fs/promises";
+import { basename, dirname, extname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { MBEDTLS_VERSION, QJS_COMMIT, ZLIB_VERSION } from "../vendor-inputs.js";
+import { stableTestMemo } from "./session.js";
+const implementationPath = fileURLToPath(import.meta.url);
+const backendDir = dirname(dirname(implementationPath));
+/** Recipe bytes and dependency snapshots must cover every extracted owner in
+ * both source and installed builds. Keep this explicit: directory enumeration
+ * could accidentally hash tests, source maps, or stale installed modules. */
+export const NATIVE_RECIPE_IMPLEMENTATION_PATHS = [
+    "native-toolchain",
+    "build-cache",
+    "vendor-archives",
+    "native/process",
+    "native/runtime-inputs",
+    "native/session",
+    "native/driver",
+    "native/tool-identity",
+    "native/contracts",
+    "native/program-shards",
+    "native/library",
+    "native/object-merge",
+    "native/compiler-fingerprint",
+    "native/linker-fingerprint",
+    "native/dependency-files",
+    "native/trace-paths",
+    "native/runtime-objects",
+    "native/vendor",
+    "native/artifact-stamps",
+    "native/executable",
+    "native/cache-warm",
+].map((stem) => join(backendDir, `${stem}${extname(implementationPath)}`));
+export const EXECUTABLE_RUNTIME_SOURCES = [
+    "scr_context.c",
+    "scr_shared.c",
+    "scr_number.c",
+    "scr_bigint.c",
+    "scr_string.c",
+    "scr_grapheme.c",
+    "scr_array.c",
+    "scr_bytes.c",
+    "scr_bytes_io.c",
+    "scr_map.c",
+    "scr_closure.c",
+    "scr_ffi.c",
+    "scr_object.c",
+    "scr_union.c",
+    "scr_exception.c",
+    "scr_error.c",
+    "scr_console.c",
+    "scr_lib.c",
+    "scr_path.c",
+    "scr_url.c",
+    "scr_url_params.c",
+    "scr_json.c",
+    "scr_node_builtin.c",
+    "scr_async.c",
+    "scr_crypto_async.c",
+    "scr_child.c",
+    "scr_cycle.c",
+];
+export function runtimeSrcDir() {
+    const testRoot = process.env["SCRIPTC_TEST_RUNTIME_SRC_DIR"];
+    if (testRoot !== undefined)
+        return resolve(testRoot);
+    const require = createRequire(import.meta.url);
+    return join(dirname(require.resolve("@scriptc/runtime/package.json")), "src");
+}
+/** The library base: the executable lane's unconditional sources minus the
+ * fiber/loop and child-process units, plus the library-mode TU. */
+export const LIB_RUNTIME_SOURCES = [
+    ...EXECUTABLE_RUNTIME_SOURCES.filter((f) => f !== "scr_async.c" && f !== "scr_crypto_async.c" && f !== "scr_child.c" && f !== "scr_ffi.c"),
+    "scr_library.c",
+];
+export async function nativeSourceFiles(directory, recursive, include = (name) => name.endsWith(".c") || name.endsWith(".h")) {
+    const files = [];
+    const walk = async (current, ancestors) => {
+        const canonical = await realpath(current).catch(() => resolve(current));
+        if (ancestors.has(canonical))
+            return;
+        const nestedAncestors = new Set(ancestors).add(canonical);
+        const entries = await readdir(current, { withFileTypes: true }).catch(() => []);
+        for (const entry of entries) {
+            const path = join(current, entry.name);
+            if (entry.isDirectory() && recursive) {
+                await walk(path, nestedAncestors);
+            }
+            else if (entry.isSymbolicLink()) {
+                const target = await stat(path).catch(() => null);
+                if (target?.isDirectory() && recursive)
+                    await walk(path, nestedAncestors);
+                else if (target?.isFile() && include(entry.name))
+                    files.push(path);
+            }
+            else if (entry.isFile() && include(entry.name)) {
+                files.push(path);
+            }
+        }
+    };
+    await walk(directory, new Set());
+    return files.sort();
+}
+/** Content hash of every owned native source/header plus this backend's build
+ * recipe implementation. It keys complete artifacts, runtime objects, and the
+ * separately built vendor prerequisites, so two installed scriptc versions or
+ * worktrees can share a user cache without exchanging outputs produced from
+ * different vendored bytes or compile/archive recipes. Recursive enumeration
+ * also catches a newly added nested header that begins shadowing a system
+ * include, while content hashing catches same-size timestamp-preserving edits. */
+async function runtimeFingerprintFresh(rtDir) {
+    const groups = await runtimeFingerprintInputGroups(rtDir);
+    const h = createHash("sha256")
+        .update("native-owned-inputs-v2\0")
+        .update(QJS_COMMIT)
+        .update(MBEDTLS_VERSION)
+        .update(ZLIB_VERSION)
+        .update("\0backend-recipe\0");
+    for (const path of NATIVE_RECIPE_IMPLEMENTATION_PATHS) {
+        h.update(basename(path))
+            .update("\0")
+            .update(await readFile(path))
+            .update("\0");
+    }
+    for (const group of groups) {
+        for (const n of group.names) {
+            h.update(group.label)
+                .update("/")
+                .update(n)
+                .update("\0")
+                .update(await readFile(join(group.dir, n)))
+                .update("\0");
+        }
+    }
+    return h.digest("hex");
+}
+async function runtimeFingerprintInputGroups(rtDir) {
+    return Promise.all([
+        { label: "runtime", dir: rtDir },
+        { label: "ryu", dir: join(rtDir, "..", "vendor", "ryu") },
+        { label: "quickjs-ng", dir: join(rtDir, "..", "vendor", "quickjs-ng") },
+        { label: "mbedtls", dir: join(rtDir, "..", "vendor", "mbedtls") },
+        { label: "zlib", dir: join(rtDir, "..", "vendor", "zlib") },
+        { label: "curl", dir: join(rtDir, "..", "vendor", "curl") },
+    ].map(async (group) => {
+        const names = (await nativeSourceFiles(group.dir, true))
+            .map((path) => relative(group.dir, path))
+            .sort();
+        return { ...group, names };
+    }));
+}
+export async function runtimeFingerprintInputPaths(rtDir) {
+    return [
+        ...(await runtimeFingerprintInputGroups(rtDir)).flatMap((group) => group.names.map((name) => join(group.dir, name))),
+        ...NATIVE_RECIPE_IMPLEMENTATION_PATHS,
+    ];
+}
+const stableRuntimeFingerprintMemos = new Map();
+export function runtimeFingerprint(rtDir) {
+    const key = resolve(rtDir);
+    return stableTestMemo(stableRuntimeFingerprintMemos, key, () => runtimeFingerprintFresh(rtDir));
+}
+//# sourceMappingURL=runtime-inputs.js.map

package/dist/backend/native/runtime-inputs.js.map

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

package/dist/backend/native/runtime-inputs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/backend/native/runtime-inputs.test.js

@@ -0,0 +1,64 @@
+import { execFile } from "node:child_process";
+import { copyFile, mkdir, mkdtemp, readdir, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { basename, dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { promisify } from "node:util";
+import { afterEach, expect, test } from "vitest";
+import { NATIVE_RECIPE_IMPLEMENTATION_PATHS } from "./runtime-inputs.js";
+const execute = promisify(execFile);
+const backend = fileURLToPath(new URL("..", import.meta.url));
+const temporary = [];
+afterEach(async () => {
+    await Promise.all(temporary.splice(0).map((path) => rm(path, { recursive: true, force: true })));
+});
+test("the recipe identity covers every native owner and retains the original recipes", async () => {
+    const owners = (await readdir(join(backend, "native")))
+        .filter((name) => name.endsWith(".ts") && !name.endsWith(".test.ts"))
+        .map((name) => join(backend, "native", name));
+    expect(new Set(NATIVE_RECIPE_IMPLEMENTATION_PATHS).size).toBe(NATIVE_RECIPE_IMPLEMENTATION_PATHS.length);
+    expect(NATIVE_RECIPE_IMPLEMENTATION_PATHS.filter((path) => dirname(path) === join(backend, "native")).sort()).toEqual(owners.sort());
+    for (const name of ["native-toolchain.ts", "build-cache.ts", "vendor-archives.ts"]) {
+        expect(NATIVE_RECIPE_IMPLEMENTATION_PATHS).toContain(join(backend, name));
+    }
+});
+test("editing any recipe owner changes the fingerprint and every owner joins the dependency proof", async () => {
+    const work = await mkdtemp(join(tmpdir(), "scriptc-recipe-identity-"));
+    temporary.push(work);
+    const native = join(work, "backend", "native");
+    const runtime = join(work, "runtime", "src");
+    await mkdir(native, { recursive: true });
+    await mkdir(runtime, { recursive: true });
+    await writeFile(join(work, "package.json"), '{"type":"module"}\n');
+    await writeFile(join(runtime, "source.c"), "int recipe_identity_probe;\n");
+    for (const source of NATIVE_RECIPE_IMPLEMENTATION_PATHS) {
+        const destination = join(dirname(source) === join(backend, "native") ? native : dirname(native), basename(source));
+        await copyFile(source, destination);
+    }
+    await copyFile(join(backend, "vendor-inputs.ts"), join(dirname(native), "vendor-inputs.ts"));
+    // A separate process imports the copied implementation so import.meta.url
+    // exercises source-path resolution without modifying the running checkout.
+    const moduleUrl = pathToFileURL(join(native, "runtime-inputs.ts")).href;
+    const script = `
+import { appendFile } from "node:fs/promises";
+import { NATIVE_RECIPE_IMPLEMENTATION_PATHS as recipes, runtimeFingerprint, runtimeFingerprintInputPaths } from ${JSON.stringify(moduleUrl)};
+const runtime = ${JSON.stringify(runtime)};
+const dependencies = await runtimeFingerprintInputPaths(runtime);
+let previous = await runtimeFingerprint(runtime);
+const changed = [];
+for (const recipe of recipes) {
+  await appendFile(recipe, "\\n// recipe mutation probe\\n");
+  const current = await runtimeFingerprint(runtime);
+  changed.push(current !== previous && dependencies.includes(recipe));
+  previous = current;
+}
+process.stdout.write(JSON.stringify(changed));
+`;
+    const { stdout } = await execute(process.execPath, ["--import", "tsx", "--input-type=module", "--eval", script], {
+        cwd: fileURLToPath(new URL("../../../../..", import.meta.url)),
+        env: { ...process.env, SCRIPTC_TEST_STABLE_TOOLCHAIN: "0" },
+        timeout: 30_000,
+    });
+    expect(JSON.parse(stdout)).toEqual(NATIVE_RECIPE_IMPLEMENTATION_PATHS.map(() => true));
+});
+//# sourceMappingURL=runtime-inputs.test.js.map

package/dist/backend/native/runtime-inputs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-inputs.test.js","sourceRoot":"","sources":["../../../src/backend/native/runtime-inputs.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AACpC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9D,MAAM,SAAS,GAAa,EAAE,CAAC;AAE/B,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACnG,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;IAChG,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;SACpD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;SACpE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,GAAG,CAAC,kCAAkC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAC3D,kCAAkC,CAAC,MAAM,CAC1C,CAAC;IACF,MAAM,CACJ,kCAAkC,CAAC,MAAM,CACvC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CACpD,CAAC,IAAI,EAAE,CACT,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,EAAE,CAAC;QACnF,MAAM,CAAC,kCAAkC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6FAA6F,EAAE,KAAK,IAAI,EAAE;IAC7G,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC,CAAC;IACvE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,qBAAqB,CAAC,CAAC;IACnE,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,8BAA8B,CAAC,CAAC;IAC3E,KAAK,MAAM,MAAM,IAAI,kCAAkC,EAAE,CAAC;QACxD,MAAM,WAAW,GAAG,IAAI,CACtB,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EACtE,QAAQ,CAAC,MAAM,CAAC,CACjB,CAAC;QACF,MAAM,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC7F,0EAA0E;IAC1E,2EAA2E;IAC3E,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,MAAM,MAAM,GAAG;;kHAEiG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;kBACzH,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;;;;;;;;;;;CAWxC,CAAC;IACA,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAC9B,OAAO,CAAC,QAAQ,EAChB,CAAC,UAAU,EAAE,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,CAAC,EAC5D;QACE,GAAG,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,gBAAgB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9D,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,6BAA6B,EAAE,GAAG,EAAE;QAC3D,OAAO,EAAE,MAAM;KAChB,CACF,CAAC;IACF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,kCAAkC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACzF,CAAC,CAAC,CAAC"}

package/dist/backend/native/runtime-objects.d.ts

@@ -0,0 +1,16 @@
+/** Reset process observations whose validity is bounded to one public native
+ * build. A long-lived caller may change PATH or install/remove ccache between
+ * invocations; the next build must probe that environment again. */
+export declare function clearCcCaches(): void;
+/** The cached .o set for one flag flavor, compiled on first need. Concurrent
+ * first builds (parallel test workers on a cold cache) may duplicate work;
+ * per-file atomic renames make every winner equivalent. Publication is held
+ * until verifyInputs confirms that the source/header fingerprint used by the
+ * key still describes the bytes clang just read. */
+export declare function ensureRuntimeObjects(root: string, ccArgv: string[], cflags: string[], sources: string[], keyPrefix: string, verifyInputs: () => Promise<boolean>, protectedPaths?: Set<string>): Promise<Map<string, string>>;
+/** Give one active link/archive operation private names for its cached
+ * runtime objects. A hard link keeps the inode alive if another process's LRU
+ * sweep unlinks the cache entry; filesystems that cannot hard-link across the
+ * cache/tmp boundary fall back to a copy. If eviction wins before staging,
+ * the caller catches the read failure and performs a fully fresh compile. */
+export declare function stageRuntimeObjects(objects: ReadonlyMap<string, string>, stageDir: string): Promise<Map<string, string>>;

package/dist/backend/native/runtime-objects.js

@@ -0,0 +1,122 @@
+import { createHash } from "node:crypto";
+import { mkdir, mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { basename, join } from "node:path";
+import { stageCachedFile, cacheDigestPath, publishCachedFile, validCachedFile, } from "../build-cache.js";
+import { execFileAsync } from "./process.js";
+import { CacheInputsChangedError } from "./session.js";
+let ccacheMemo = null;
+/** Reset process observations whose validity is bounded to one public native
+ * build. A long-lived caller may change PATH or install/remove ccache between
+ * invocations; the next build must probe that environment again. */
+export function clearCcCaches() {
+    ccacheMemo = null;
+}
+function ccacheAvailable() {
+    ccacheMemo ??= execFileAsync("ccache", ["--version"]).then(() => true, () => false);
+    return ccacheMemo;
+}
+/** The cached .o set for one flag flavor, compiled on first need. Concurrent
+ * first builds (parallel test workers on a cold cache) may duplicate work;
+ * per-file atomic renames make every winner equivalent. Publication is held
+ * until verifyInputs confirms that the source/header fingerprint used by the
+ * key still describes the bytes clang just read. */
+export async function ensureRuntimeObjects(root, ccArgv, cflags, sources, keyPrefix, verifyInputs, protectedPaths) {
+    const setKey = createHash("sha256")
+        .update(keyPrefix)
+        .update(cflags.join("\x1f"))
+        .digest("hex")
+        .slice(0, 24);
+    const objDir = join(root, "obj", setKey);
+    const objOf = (src) => join(objDir, `${basename(src, ".c")}.o`);
+    if (protectedPaths !== undefined) {
+        for (const source of sources) {
+            const object = objOf(source);
+            protectedPaths.add(object);
+            protectedPaths.add(cacheDigestPath(object));
+        }
+    }
+    const present = await Promise.all(sources.map((s) => validCachedFile(objOf(s))));
+    const missing = sources.filter((_, i) => !present[i]);
+    if (missing.length > 0) {
+        // ccache wraps only the default clang driver — multi-word drivers
+        // (`zig cc`) run bare; their object sets are keyed apart anyway.
+        const useCcache = process.env["SCRIPTC_TEST_DISABLE_CCACHE"] !== "1" &&
+            ccArgv.length === 1 &&
+            ccArgv[0] === "clang" &&
+            (await ccacheAvailable());
+        await mkdir(objDir, { recursive: true });
+        const tmpDir = await mkdtemp(join(tmpdir(), "scriptc-cache-obj-"));
+        try {
+            const compiled = new Map();
+            // Modest parallelism: a flavor's objects build once, but several cold
+            // workers can race here — keep each build's CPU footprint small.
+            const width = 4;
+            for (let i = 0; i < missing.length; i += width) {
+                await Promise.all(missing.slice(i, i + width).map(async (src) => {
+                    const tmpObj = join(tmpDir, `${basename(src, ".c")}.o`);
+                    const argv = [
+                        ...(useCcache ? ["ccache"] : []),
+                        ...ccArgv,
+                        ...cflags,
+                        "-c",
+                        src,
+                        "-o",
+                        tmpObj,
+                    ];
+                    await execFileAsync(argv[0] ?? "clang", argv.slice(1), useCcache
+                        ? {
+                            // ccache direct mode remembers only the headers selected by
+                            // its previous manifest and can miss a newly created,
+                            // higher-priority header. The scriptc object-set key already
+                            // includes the recursive runtime namespace fingerprint, so
+                            // carry it into ccache's own keyspace as well.
+                            env: {
+                                ...process.env,
+                                CCACHE_NAMESPACE: [process.env["CCACHE_NAMESPACE"], `scriptc-${setKey}`]
+                                    .filter((value) => value !== undefined && value !== "")
+                                    .join(":"),
+                            },
+                        }
+                        : undefined);
+                    compiled.set(src, tmpObj);
+                }));
+            }
+            // The fingerprint was computed before these subprocesses started. Do
+            // not place their outputs under that key if a checkout/package update
+            // changed any runtime source or included header while clang was reading.
+            if (!(await verifyInputs()))
+                throw new CacheInputsChangedError();
+            for (const [src, built] of compiled) {
+                const destination = objOf(src);
+                await publishCachedFile(built, destination);
+            }
+        }
+        finally {
+            await rm(tmpDir, { recursive: true, force: true });
+        }
+    }
+    if (!(await verifyInputs()))
+        throw new CacheInputsChangedError();
+    const objects = new Map(sources.map((s) => [s, objOf(s)]));
+    if (!(await Promise.all([...objects.values()].map(validCachedFile))).every(Boolean)) {
+        throw new Error("native object cache integrity check failed");
+    }
+    return objects;
+}
+/** Give one active link/archive operation private names for its cached
+ * runtime objects. A hard link keeps the inode alive if another process's LRU
+ * sweep unlinks the cache entry; filesystems that cannot hard-link across the
+ * cache/tmp boundary fall back to a copy. If eviction wins before staging,
+ * the caller catches the read failure and performs a fully fresh compile. */
+export async function stageRuntimeObjects(objects, stageDir) {
+    await mkdir(stageDir, { recursive: true });
+    const now = new Date();
+    const staged = await Promise.all([...objects].map(async ([source, object]) => {
+        const destination = join(stageDir, basename(object));
+        await stageCachedFile(object, destination, now);
+        return [source, destination];
+    }));
+    return new Map(staged);
+}
+//# sourceMappingURL=runtime-objects.js.map

package/dist/backend/native/runtime-objects.js.map

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

package/dist/backend/native/session.d.ts

@@ -0,0 +1,12 @@
+/** Test lanes run against one immutable checkout and one immutable toolchain
+ * for the lifetime of each Vitest worker. Production deliberately rediscovers
+ * compiler/linker inputs on every invocation, but doing that thousands of
+ * times in the differential corpus costs far more than the compile itself.
+ * This test-only opt-in lets those workers reuse metadata probes for their
+ * session; the cache-correctness suite removes the flag and exercises the
+ * strict production path. */
+export declare function stableTestToolchainSession(): boolean;
+export declare function stableTestMemo<T>(cache: Map<string, Promise<T>>, key: string, probe: () => Promise<T>): Promise<T>;
+export declare class CacheInputsChangedError extends Error {
+    constructor();
+}

package/dist/backend/native/session.js

@@ -0,0 +1,31 @@
+/** Test lanes run against one immutable checkout and one immutable toolchain
+ * for the lifetime of each Vitest worker. Production deliberately rediscovers
+ * compiler/linker inputs on every invocation, but doing that thousands of
+ * times in the differential corpus costs far more than the compile itself.
+ * This test-only opt-in lets those workers reuse metadata probes for their
+ * session; the cache-correctness suite removes the flag and exercises the
+ * strict production path. */
+export function stableTestToolchainSession() {
+    return process.env["SCRIPTC_TEST_STABLE_TOOLCHAIN"] === "1";
+}
+export function stableTestMemo(cache, key, probe) {
+    if (!stableTestToolchainSession())
+        return probe();
+    const existing = cache.get(key);
+    if (existing !== undefined)
+        return existing;
+    const pending = probe();
+    cache.set(key, pending);
+    void pending.catch(() => {
+        if (cache.get(key) === pending)
+            cache.delete(key);
+    });
+    return pending;
+}
+export class CacheInputsChangedError extends Error {
+    constructor() {
+        super("runtime inputs changed while populating the native object cache");
+        this.name = "CacheInputsChangedError";
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/backend/native/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/backend/native/session.ts"],"names":[],"mappings":"AAAA;;;;;;6BAM6B;AAC7B,MAAM,UAAU,0BAA0B;IACxC,OAAO,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,KAAK,GAAG,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAA8B,EAC9B,GAAW,EACX,KAAuB;IAEvB,IAAI,CAAC,0BAA0B,EAAE;QAAE,OAAO,KAAK,EAAE,CAAC;IAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;IACxB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxB,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;QACtB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO;YAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD;QACE,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/backend/native/tool-identity.d.ts

@@ -0,0 +1,37 @@
+import { type CcDriver } from "./driver.js";
+/** Inputs that can change which native tool/runtime implementation an
+ * executable build selects before compileC has a chance to rediscover it.
+ * The early whole-program cache keys this exact posture before restoring a
+ * final binary; compileC retains its deeper inode/content validation. */
+export declare function executableNativeEnvironmentFingerprint(env?: NodeJS.ProcessEnv): Promise<string>;
+interface ResolvedTool {
+    canonicalPath: string;
+    cacheIdentity: string;
+    fileIdentity: string;
+}
+/** Resolve the executable the OS will select for an argv[0] spelling. The
+ * path and inode metadata join the version output below: two PATH postures
+ * must not share cache entries merely because both drivers call themselves
+ * `clang` or print the same upstream version. ctime catches an in-place tool
+ * replacement even when a package manager preserves its size and mtime. */
+export declare function resolvedTool(command: string, env?: NodeJS.ProcessEnv): Promise<ResolvedTool | null>;
+export declare function resolvedToolIdentity(command: string, env?: NodeJS.ProcessEnv): Promise<string | null>;
+export declare const directCompilerSelections: Map<string, ResolvedTool>;
+export declare function compilerDriverProbeKey(driver: Pick<CcDriver, "argv" | "targetArgs" | "target">, environmentFingerprint: string): string;
+/** Persistent caches require an inspectable compiler driver. A general
+ * wrapper can branch on the real source/object paths or argument topology and
+ * inject inputs only into the final invocation; no synthetic metadata probe
+ * can safely represent that behavior. Accept direct Clang/Zig drivers (plus
+ * Apple's system shim) and conservatively keep wrapper-driven builds on the
+ * uncached path. */
+export declare function compilerDriverSupportsPersistentCache(driver: Pick<CcDriver, "argv" | "targetArgs" | "target">, environmentFingerprint: string): Promise<boolean>;
+/** Complete library archives may skip `ar`, so the selected archiver must be
+ * as inspectable as the compiler. `zig ar` is the already-validated Zig
+ * executable. For the host spelling, accept only the immutable platform
+ * tool locations; a PATH wrapper can branch on the real member topology or
+ * inject mutable inputs that `ar --version` cannot expose. Other archivers
+ * retain runtime-object reuse but rebuild the program member and archive. */
+export declare function archiverSupportsPersistentCache(arArgv: readonly string[], driver: Pick<CcDriver, "argv">): Promise<boolean>;
+export declare function ccVersion(argv: string[], environmentFingerprint?: string, fresh?: boolean): Promise<string>;
+export declare function toolVersionOnce(argv: string[], environmentFingerprint?: string, fresh?: boolean): Promise<string>;
+export {};