ttsc 0.34.2 → 0.35.0

package/lib/compiler/internal/build/RuntimeInputProof.js

@@ -0,0 +1,315 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuntimeInputProof = void 0;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Replay the compiler and native input witnesses of a completed runtime build.
+ * Read predicates keep their original text or raw-byte codec; absence, entry
+ * kind, physical target and directory membership remain independent predicates.
+ * Failed or unsupported observations withhold reuse.
+ *
+ * @evidence contracts/common.md#principled-implementation Replay compares generation witnesses with current existence, stat, decoded text, physical identity and directory membership. Native version-one file, optional-file, entry and directory codecs use explicit tags, raw file/link bytes and sorted nul-delimited records. Compiler text strips UTF-8 BOM or decodes even UTF-16LE/BE bytes before SHA-256; host directory presence uses its separate domain marker.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace separates result admission, declared host inputs, compiler predicates and the native version-one codec. Private physical/absence and SHA-256 helpers serve the codecs without merging their meanings.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Unknown codecs, failed reads and producer proof failures decline admission. Only ENOENT/ENOTDIR prove absence; other physical-resolution errors remain unavailable. Following stat classifies compiler views while lstat retains native link kinds; only the producer private output subtree is excluded.
+ * @evidence contracts/common.md#meaningful-documentation Native prose identifies generation proof, codec ownership and refusal semantics; private helper comments identify query, byte, decoded-text and null/error boundaries.
+ * @evidence contracts/portability.md#os-neutral-implementation Native stat, lstat and realpath retain actual kinds, targets and spellings without case assumptions. POSIX directory names/link targets stay raw bytes, Windows names follow the producer UTF-8 codec, and compiler directory entries sort by UTF-8 bytes.
+ * @evidence contracts/performance.md#efficient-algorithms Replay visits recorded predicates and their bytes or immediate directory entries rather than unrelated trees. Hashing and BOM decoding cost O(bytes), including a big-endian copy; directory codecs cost O(N log N) sorting plus encoded bytes and link queries. Physical resolution follows native path/link traversal.
+ * @evidence contracts/performance.md#reuse-equivalent-work Every retained predicate is observed anew to authorize completed-result reuse. Host capture and admission share the producer codec; no path memo, watcher silence or historical hash independently grants authority.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Read buffers, decoded text, paths and sorted directory members are call-local and have no proof-reader byte or entry cap. Synchronous calls retain no handle, watcher, process or historical population; only returned proof values escape.
+ */
+var RuntimeInputProof;
+(function (RuntimeInputProof) {
+    /**
+     * Validate result-level host witnesses and every reported compiler predicate.
+     * The caller independently proves the selected compiler, project membership
+     * and plugin selection; an absent graph alone grants no completeness.
+     *
+     * @evidence contracts/common.md#principled-implementation Explicit incomplete observations and any graph failure reject reuse; host paths require both content and physical witnesses, and rich compiler predicates are replayed under their own codec.
+     * @evidence contracts/common.md#clear-and-simple-design One admission pass delegates individual compiler observations and native codecs.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Missing witness fields never become an empty successful observation, and only the caller-owned private output subtree is excluded.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies result admission and the caller's separate completeness obligations.
+     * @evidence contracts/portability.md#os-neutral-implementation Native path resolution anchors producer-relative graph keys, and current physical paths come from native realpath.
+     * @evidence contracts/performance.md#efficient-algorithms Input and predicate populations drive replay; each read hashes its actual bytes and directories sort immediate entry records.
+     * @evidence contracts/performance.md#reuse-equivalent-work Generation witnesses, rather than an identity-key match, decide whether a completed build remains reusable.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources Temporary path and predicate records are invocation-owned without retained handles or history.
+     */
+    function holds(result, projectRoot, emitDir) {
+        if (result.observationsComplete === false ||
+            Object.keys(result.graph?.inputProofFailures ?? {}).length !== 0)
+            return false;
+        try {
+            for (const file of result.hostInputs ?? []) {
+                const [currentPhysical, hash] = observeHostInput(file);
+                if (!Object.hasOwn(result.hostInputHashes ?? {}, file) ||
+                    !Object.hasOwn(result.hostInputRealpaths ?? {}, file) ||
+                    currentPhysical !== result.hostInputRealpaths[file] ||
+                    hash !== result.hostInputHashes[file])
+                    return false;
+            }
+            const graph = result.graph;
+            for (const [name, observed] of Object.entries(graph?.inputObservations ?? {})) {
+                const file = node_path_1.default.resolve(projectRoot, name);
+                const relative = node_path_1.default.relative(emitDir, file);
+                if (relative === "" ||
+                    (!node_path_1.default.isAbsolute(relative) &&
+                        relative !== ".." &&
+                        !relative.startsWith(".." + node_path_1.default.sep)))
+                    continue;
+                if (!observationHolds(file, observed))
+                    return false;
+            }
+            for (const [name, expected] of Object.entries(graph?.inputHashes ?? {})) {
+                if (Object.hasOwn(graph?.inputObservations ?? {}, name))
+                    continue;
+                const file = node_path_1.default.resolve(projectRoot, name);
+                if (physical(file) !== graph?.inputRealpaths?.[name])
+                    return false;
+                let current = null;
+                try {
+                    if (node_fs_1.default.statSync(file).isFile())
+                        current = textHash(node_fs_1.default.readFileSync(file));
+                }
+                catch (error) {
+                    if (!missing(error))
+                        return false;
+                }
+                if (current !== expected)
+                    return false;
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    RuntimeInputProof.holds = holds;
+    /**
+     * Observe a declared host input under its existing raw-file or directory-kind
+     * codec. Descriptor resolution can declare directories as presence inputs;
+     * those are distinct from compiler source reads and directory enumeration.
+     * Native identity and metadata bracket the observation. Missing paths carry
+     * null witnesses, while unavailable or changing observations throw.
+     *
+     * @evidence contracts/common.md#principled-implementation Raw file bytes and the existing ttsc:host-input:directory domain marker reproduce the descriptor/native host-input contract, with physical identity and full native metadata checked before and after.
+     * @evidence contracts/common.md#clear-and-simple-design One observer supplies the same declared-host codec to input capture and retained-result admission, independently of compiler text and enumeration predicates.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Only ENOENT/ENOTDIR establish absence; unsupported entry kinds, read failures and changing witnesses refuse reuse instead of becoming empty content.
+     * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes directory presence from directory membership, states the producer codec and explains failure semantics.
+     * @evidence contracts/portability.md#os-neutral-implementation Native following stat, realpath and byte reads retain actual host links and physical spellings without OS-name or separator guesses.
+     * @evidence contracts/performance.md#efficient-algorithms File observations hash their complete byte buffer and bracket native metadata; directory presence hashes a fixed marker without scanning members.
+     * @evidence contracts/performance.md#reuse-equivalent-work Capture and admission share the producer's codec, but every invocation observes current witnesses and retains no path-only truth.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources Read buffers and stat records are call-local; synchronous filesystem calls leave no retained handle or watcher.
+     */
+    function observeHostInput(file) {
+        const beforePhysical = physical(file);
+        let before;
+        try {
+            before = node_fs_1.default.statSync(file, { bigint: true });
+        }
+        catch (error) {
+            if (!missing(error))
+                throw error;
+            if (beforePhysical !== null || physical(file) !== null)
+                throw new Error("Host input changed during absence observation.");
+            return [null, null];
+        }
+        if (!before.isFile() && !before.isDirectory())
+            throw new Error("Unsupported runtime host input kind.");
+        const hash = before.isDirectory()
+            ? digest("ttsc:host-input:directory\0")
+            : digest(node_fs_1.default.readFileSync(file));
+        const after = node_fs_1.default.statSync(file, { bigint: true });
+        const signature = (stat) => [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(":");
+        if (signature(before) !== signature(after) ||
+            beforePhysical !== physical(file))
+            throw new Error("Host input changed during observation.");
+        return [beforePhysical, hash];
+    }
+    RuntimeInputProof.observeHostInput = observeHostInput;
+    /** Compare one compiler query record with the corresponding current queries. */
+    function observationHolds(file, observed) {
+        for (const predicate of observed.nativePredicates ?? [])
+            if (predicate.version !== 1 ||
+                !predicate.identityStable ||
+                physical(file) !== predicate.realpath ||
+                nativeDigest(file, predicate.kind) !== predicate.digest)
+                return false;
+        let kind = "missing";
+        try {
+            const stat = node_fs_1.default.statSync(file);
+            kind = stat.isDirectory() ? "directory" : "file";
+        }
+        catch (error) {
+            if (!missing(error))
+                return false;
+        }
+        if (observed.fileExists !== undefined &&
+            observed.fileExists !== (kind === "file"))
+            return false;
+        if (observed.directoryExists !== undefined &&
+            observed.directoryExists !== (kind === "directory"))
+            return false;
+        if (observed.stat !== undefined && observed.stat !== kind)
+            return false;
+        if (observed.readFile !== undefined) {
+            let hash = null;
+            try {
+                if (kind !== "directory")
+                    hash = textHash(node_fs_1.default.readFileSync(file));
+            }
+            catch {
+                /* Compiler read failed. */
+            }
+            if (observed.readFile.ok ? hash !== observed.readFile.hash : hash !== null)
+                return false;
+        }
+        if (observed.realpath !== undefined) {
+            const current = physical(file);
+            if (observed.realpath.ok
+                ? current !== observed.realpath.path
+                : current !== null)
+                return false;
+        }
+        if (observed.accessibleEntries !== undefined) {
+            const directories = [];
+            const files = [];
+            let entries = [];
+            try {
+                entries = node_fs_1.default.readdirSync(file, { withFileTypes: true });
+            }
+            catch {
+                /* Compiler enumeration returns an empty view. */
+            }
+            for (const entry of entries) {
+                try {
+                    const stat = entry.isSymbolicLink()
+                        ? node_fs_1.default.statSync(node_path_1.default.join(file, entry.name))
+                        : entry;
+                    if (stat.isDirectory())
+                        directories.push(entry.name);
+                    else if (stat.isFile())
+                        files.push(entry.name);
+                }
+                catch {
+                    /* Compiler enumeration omits inaccessible link targets. */
+                }
+            }
+            const compare = (a, b) => Buffer.compare(Buffer.from(a), Buffer.from(b));
+            if (JSON.stringify({
+                directories: directories.sort(compare),
+                files: files.sort(compare),
+            }) !== JSON.stringify(observed.accessibleEntries))
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Reproduce native version-one file, optional-file, entry and directory
+     * bytes.
+     */
+    function nativeDigest(file, kind) {
+        if (kind === "file")
+            return digest(node_fs_1.default.readFileSync(file));
+        if (kind === "optional-file") {
+            try {
+                return node_fs_1.default.statSync(file).isFile()
+                    ? digest(Buffer.concat([Buffer.from("file\0"), node_fs_1.default.readFileSync(file)]))
+                    : digest("missing\0");
+            }
+            catch (error) {
+                if (missing(error))
+                    return digest("missing\0");
+                throw error;
+            }
+        }
+        if (kind === "entry") {
+            try {
+                const entry = node_fs_1.default.lstatSync(file);
+                return entry.isSymbolicLink()
+                    ? digest(Buffer.concat([
+                        Buffer.from("symlink\0"),
+                        node_fs_1.default.readlinkSync(file, { encoding: "buffer" }),
+                    ]))
+                    : digest((entry.isDirectory()
+                        ? "directory"
+                        : entry.isFile()
+                            ? "file"
+                            : "other") + "\0");
+            }
+            catch (error) {
+                if (missing(error))
+                    return digest("missing\0");
+                throw error;
+            }
+        }
+        if (kind !== "directory")
+            throw new Error("unsupported native input codec");
+        const records = [];
+        const names = process.platform === "win32"
+            ? node_fs_1.default.readdirSync(file).map((name) => Buffer.from(name))
+            : node_fs_1.default.readdirSync(file, { encoding: "buffer" });
+        for (const name of names) {
+            const target = process.platform === "win32"
+                ? node_path_1.default.join(file, name.toString())
+                : Buffer.concat([Buffer.from(file + node_path_1.default.sep), name]);
+            const entry = node_fs_1.default.lstatSync(target);
+            const entryKind = entry.isDirectory()
+                ? "directory"
+                : entry.isFile()
+                    ? "file"
+                    : entry.isSymbolicLink()
+                        ? "symlink"
+                        : "other";
+            const link = entry.isSymbolicLink()
+                ? node_fs_1.default.readlinkSync(target, { encoding: "buffer" })
+                : Buffer.alloc(0);
+            records.push(Buffer.concat([name, Buffer.from("\0" + entryKind + "\0"), link]));
+        }
+        records.sort(Buffer.compare);
+        return digest(Buffer.concat(records.flatMap((record, index) => index === 0 ? [record] : [Buffer.from([0]), record])));
+    }
+    /** Hash compiler-decoded text, retaining the BOM and UTF-16 producer policy. */
+    function textHash(bytes) {
+        if (bytes.length >= 2 &&
+            ((bytes[0] === 0xff && bytes[1] === 0xfe) ||
+                (bytes[0] === 0xfe && bytes[1] === 0xff))) {
+            const text = Buffer.from(bytes.subarray(2, 2 + Math.floor((bytes.length - 2) / 2) * 2));
+            if (bytes[0] === 0xfe)
+                text.swap16();
+            return digest(Buffer.from(text.toString("utf16le"), "utf8"));
+        }
+        return digest(bytes.length >= 3 &&
+            bytes[0] === 0xef &&
+            bytes[1] === 0xbb &&
+            bytes[2] === 0xbf
+            ? bytes.subarray(3)
+            : bytes);
+    }
+    /** Obtain a current physical coordinate, with null only for native absence. */
+    function physical(file) {
+        try {
+            return node_fs_1.default.realpathSync.native(file);
+        }
+        catch (error) {
+            if (missing(error))
+                return null;
+            throw error;
+        }
+    }
+    /** Classify only native absent-path errors. */
+    function missing(error) {
+        return (typeof error === "object" &&
+            error !== null &&
+            "code" in error &&
+            (error.code === "ENOENT" || error.code === "ENOTDIR"));
+    }
+    /** SHA-256 of supplied text or raw bytes. */
+    function digest(bytes) {
+        return node_crypto_1.default.createHash("sha256").update(bytes).digest("hex");
+    }
+})(RuntimeInputProof || (exports.RuntimeInputProof = RuntimeInputProof = {}));
+//# sourceMappingURL=RuntimeInputProof.js.map

package/lib/compiler/internal/build/RuntimeInputProof.js.map

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

package/lib/compiler/internal/build/TsgoArguments.d.ts

@@ -88,11 +88,12 @@ export declare namespace TsgoArguments {
     /**
      * The forwarded-tsgo payload for a native `build`/`check` emit invocation.
      *
-     * The sidecar builds its Program in-process, so the pinned `rootDir` has to
-     * travel the same channel every other tsgo option takes to it — the host flag
-     * set does not declare `--rootDir`, and `filterHostArgs` would strip it.
+     * The sidecar builds its Program in-process, so runtime source-map defaults
+     * and the pinned `rootDir` travel the same channel as other tsgo options —
+     * the host flag set does not declare `--rootDir`, and `filterHostArgs` would
+     * strip it.
      *
-     * @evidence contracts/common.md#principled-implementation The same private layout root used by direct builds is placed in the sidecar compiler-option channel, preserving declared/composite containment while avoiding a new ordinary config-directory restriction without a new host flag.
+     * @evidence contracts/common.md#principled-implementation The same private layout root and forced runtime source-map default used by direct builds precede user arguments in the sidecar compiler-option channel, preserving explicit overrides and declared/composite containment without a new host flag.
      * @evidence contracts/common.md#clear-and-simple-design Root pinning stays in one helper and general payload ordering/serialization stays in createNativeTsgoArgs.
      * @evidence contracts/common.md#prohibited-implementation-shortcuts The supported environment payload carries compiler options instead of injecting unknown flags into strict foreign host parsers.
      * @evidence contracts/common.md#meaningful-documentation Native prose explains why rootDir travels with compiler options rather than through the host flag set.

package/lib/compiler/internal/build/TsgoArguments.js

@@ -180,11 +180,12 @@ var TsgoArguments;
     /**
      * The forwarded-tsgo payload for a native `build`/`check` emit invocation.
      *
-     * The sidecar builds its Program in-process, so the pinned `rootDir` has to
-     * travel the same channel every other tsgo option takes to it — the host flag
-     * set does not declare `--rootDir`, and `filterHostArgs` would strip it.
+     * The sidecar builds its Program in-process, so runtime source-map defaults
+     * and the pinned `rootDir` travel the same channel as other tsgo options —
+     * the host flag set does not declare `--rootDir`, and `filterHostArgs` would
+     * strip it.
      *
-     * @evidence contracts/common.md#principled-implementation The same private layout root used by direct builds is placed in the sidecar compiler-option channel, preserving declared/composite containment while avoiding a new ordinary config-directory restriction without a new host flag.
+     * @evidence contracts/common.md#principled-implementation The same private layout root and forced runtime source-map default used by direct builds precede user arguments in the sidecar compiler-option channel, preserving explicit overrides and declared/composite containment without a new host flag.
      * @evidence contracts/common.md#clear-and-simple-design Root pinning stays in one helper and general payload ordering/serialization stays in createNativeTsgoArgs.
      * @evidence contracts/common.md#prohibited-implementation-shortcuts The supported environment payload carries compiler options instead of injecting unknown flags into strict foreign host parsers.
      * @evidence contracts/common.md#meaningful-documentation Native prose explains why rootDir travels with compiler options rather than through the host flag set.
@@ -195,7 +196,12 @@ var TsgoArguments;
      * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Returned JSON is transferred to the process boundary; no retained process or cache is owned.
      */
     function createNativeBuildTsgoArgs(execution, options) {
-        return createNativeTsgoArgs(options, pinnedRootDirArgs(execution, options), false);
+        return createNativeTsgoArgs(options, [
+            ...(options.forceRuntimeSourceMap === true
+                ? ["--sourceMap", "true"]
+                : []),
+            ...pinnedRootDirArgs(execution, options),
+        ], false);
     }
     TsgoArguments.createNativeBuildTsgoArgs = createNativeBuildTsgoArgs;
     /**

package/lib/compiler/internal/build/TsgoArguments.js.map

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

package/lib/compiler/internal/build/runBuild.d.ts

@@ -18,7 +18,7 @@ import { WatchInputPublication } from "./WatchInputPublication";
  * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes returned exit failures from thrown setup/launch errors and explains the project-free branch.
  * @evidence contracts/portability.md#os-neutral-implementation Execution selection and spawning use the shared native path/process boundaries with cwd and separate argv, rather than constructing a shell command here.
  * @evidence contracts/performance.md#efficient-algorithms Timing creation and terminal selection make their own flag projections before the selected preparation/execution path. Delegated configuration, plugin, native/provenance and diagnostic work follows its actual input/report sizes; timing formatting scans ledger labels and output. No measured dominance or duration/output ceiling is established by this wrapper.
- * @evidence contracts/performance.md#reuse-equivalent-work A resolved execution context is carried through preparation and execution, so this build does not reload its plugin selection between phases.
+ * @evidence contracts/performance.md#reuse-equivalent-work A resolved execution context is carried through preparation and execution without another plugin load; private runtime requests delegate verified completed-emission reuse to RuntimeBuildCache with current input and producer proofs.
  * @evidence contracts/performance.md#bound-retention-and-release-resources The ledger and execution state are build-owned, while returned output/proof/diagnostic records transfer to the caller; no resident handle or historical build is stored here. Delegated native/probe/artifact acquisition and cleanup may be best effort, and thrown setup can precede some cleanup boundaries. This wrapper supplies no duration/output bound or descendant-release certification.
  */
 export declare function runBuild(options?: RunBuildOptions): TtscBuildResult;
@@ -30,8 +30,8 @@ export declare function runBuild(options?: RunBuildOptions): TtscBuildResult;
  * @evidence contracts/common.md#prohibited-implementation-shortcuts Awaiting changes only publication completion, preserves compiler/plugin selection and project-free terminal behavior, and sends publication failure through existing setup and cleanup rather than bypassing a pending baseline.
  * @evidence contracts/common.md#meaningful-documentation Entry prose states the publication barrier, order before compilation and internal callers' obligation to complete the sequence and deliver rejection.
  * @evidence contracts/portability.md#os-neutral-implementation BuildExecution retains native cwd, path identity and argument-array ownership across suspension; the namespace adds no independent native boundary.
- * @evidence contracts/performance.md#efficient-algorithms Each selected terminal, context, discovery, preparation and compile phase runs once; each publication adds one await and constant sequence state.
- * @evidence contracts/performance.md#reuse-equivalent-work One resolved execution context serves preparation and compilation without reloading plugins; the namespace retains no completed build or in-flight cache.
+ * @evidence contracts/performance.md#efficient-algorithms Each selected terminal, context, discovery and preparation phase runs once; eligible runtime requests add native source/configuration queries and content proofs before restoring or compiling. Each publication adds one await and constant sequence state.
+ * @evidence contracts/performance.md#reuse-equivalent-work One resolved execution context serves preparation and compilation without reloading plugins; the delegated runtime store reuses completed bytes only under current equal input snapshots and valid producer witnesses, with ordinary compilation on any miss.
  * @evidence contracts/performance.md#bound-retention-and-release-resources The invocation owns its sequence, ledger, context and current handoff while callbacks settle. Selected results transfer to the caller, delegated resource ownership and cleanup stay unchanged, and no resident history is retained.
  */
 export declare namespace runBuild {

package/lib/compiler/internal/build/runBuild.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runBuild = runBuild;
 const BuildExecution_1 = require("./BuildExecution");
 const BuildTiming_1 = require("./BuildTiming");
+const RuntimeBuildCache_1 = require("./RuntimeBuildCache");
+const RuntimeBuildInputs_1 = require("./RuntimeBuildInputs");
 const WatchInputPublication_1 = require("./WatchInputPublication");
 /**
  * Run `ttsc` against a tsconfig. Returns once the binary exits so the CLI can
@@ -21,7 +23,7 @@ const WatchInputPublication_1 = require("./WatchInputPublication");
  * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes returned exit failures from thrown setup/launch errors and explains the project-free branch.
  * @evidence contracts/portability.md#os-neutral-implementation Execution selection and spawning use the shared native path/process boundaries with cwd and separate argv, rather than constructing a shell command here.
  * @evidence contracts/performance.md#efficient-algorithms Timing creation and terminal selection make their own flag projections before the selected preparation/execution path. Delegated configuration, plugin, native/provenance and diagnostic work follows its actual input/report sizes; timing formatting scans ledger labels and output. No measured dominance or duration/output ceiling is established by this wrapper.
- * @evidence contracts/performance.md#reuse-equivalent-work A resolved execution context is carried through preparation and execution, so this build does not reload its plugin selection between phases.
+ * @evidence contracts/performance.md#reuse-equivalent-work A resolved execution context is carried through preparation and execution without another plugin load; private runtime requests delegate verified completed-emission reuse to RuntimeBuildCache with current input and producer proofs.
  * @evidence contracts/performance.md#bound-retention-and-release-resources The ledger and execution state are build-owned, while returned output/proof/diagnostic records transfer to the caller; no resident handle or historical build is stored here. Delegated native/probe/artifact acquisition and cleanup may be best effort, and thrown setup can precede some cleanup boundaries. This wrapper supplies no duration/output bound or descendant-release certification.
  */
 function runBuild(options = {}) {
@@ -35,8 +37,8 @@ function runBuild(options = {}) {
  * @evidence contracts/common.md#prohibited-implementation-shortcuts Awaiting changes only publication completion, preserves compiler/plugin selection and project-free terminal behavior, and sends publication failure through existing setup and cleanup rather than bypassing a pending baseline.
  * @evidence contracts/common.md#meaningful-documentation Entry prose states the publication barrier, order before compilation and internal callers' obligation to complete the sequence and deliver rejection.
  * @evidence contracts/portability.md#os-neutral-implementation BuildExecution retains native cwd, path identity and argument-array ownership across suspension; the namespace adds no independent native boundary.
- * @evidence contracts/performance.md#efficient-algorithms Each selected terminal, context, discovery, preparation and compile phase runs once; each publication adds one await and constant sequence state.
- * @evidence contracts/performance.md#reuse-equivalent-work One resolved execution context serves preparation and compilation without reloading plugins; the namespace retains no completed build or in-flight cache.
+ * @evidence contracts/performance.md#efficient-algorithms Each selected terminal, context, discovery and preparation phase runs once; eligible runtime requests add native source/configuration queries and content proofs before restoring or compiling. Each publication adds one await and constant sequence state.
+ * @evidence contracts/performance.md#reuse-equivalent-work One resolved execution context serves preparation and compilation without reloading plugins; the delegated runtime store reuses completed bytes only under current equal input snapshots and valid producer witnesses, with ordinary compilation on any miss.
  * @evidence contracts/performance.md#bound-retention-and-release-resources The invocation owns its sequence, ledger, context and current handoff while callbacks settle. Selected results transfer to the caller, delegated resource ownership and cleanup stay unchanged, and no resident history is retained.
  */
 (function (runBuild) {
@@ -61,8 +63,19 @@ function runBuild(options = {}) {
         const setupStartedAt = process.hrtime.bigint();
         const execution = yield* BuildExecution_1.BuildExecution.resolveExecutionContextSteps(options);
         const prepared = yield* BuildExecution_1.BuildExecution.prepareBuildExecutionSteps(options, timing, execution, setupStartedAt);
+        const build = () => BuildExecution_1.BuildExecution.runPreparedBuild(options, timing, execution, prepared.buildOptions);
+        const proof = prepared.result === undefined
+            ? RuntimeBuildInputs_1.RuntimeBuildInputs.create(prepared.buildOptions, execution)
+            : undefined;
         const result = prepared.result ??
-            BuildExecution_1.BuildExecution.runPreparedBuild(options, timing, execution, prepared.buildOptions);
+            (proof === undefined
+                ? build()
+                : RuntimeBuildCache_1.RuntimeBuildCache.run({
+                    directory: options.runtimeCacheDir,
+                    emitDir: options.isolateOutputsTo,
+                    ...proof,
+                    build,
+                }));
         return BuildTiming_1.BuildTiming.appendTimingOutput(result, timing);
     }
     runBuild.steps = steps;

package/lib/compiler/internal/build/runBuild.js.map

@@ -1 +1 @@
-{"version":3,"file":"runBuild.js","sourceRoot":"","sources":["../../../../src/compiler/internal/build/runBuild.ts"],"names":[],"mappings":";;;AACA,qDAAkD;AAClD,+CAA4C;AAE5C,mEAAgE;AAEhE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,kBAAyB,OAAO,GAAoB,EAAE;IACpD,OAAO,6CAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,WAAiB,QAAQ;IACvB;;;OAGG;IACH,SAAgB,KAAK,CACnB,OAAO,GAAoB,EAAE;QAE7B,OAAO,6CAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAJe,SAAA,KAAK,QAIpB,CAAA;IAED;;;;OAIG;IACH,QAAe,CAAC,CAAC,KAAK,CACpB,OAAwB;QAExB,MAAM,MAAM,GAAG,yBAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,+BAAc,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,WAAW,KAAK,IAAI;YACtB,OAAO,yBAAW,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC/C,MAAM,SAAS,GACb,KAAK,CAAC,CAAC,+BAAc,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,+BAAc,CAAC,0BAA0B,CAC/D,OAAO,EACP,MAAM,EACN,SAAS,EACT,cAAc,CACf,CAAC;QACF,MAAM,MAAM,GACV,QAAQ,CAAC,MAAM;YACf,+BAAc,CAAC,gBAAgB,CAC7B,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,CAAC,YAAY,CACtB,CAAC;QACJ,OAAO,yBAAW,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAzBgB,SAAA,KAAK,QAyBrB,CAAA;AACH,CAAC,EA1CgB,QAAQ,aAhBT,QAAQ,GAgBP,QAAQ,QA0CxB"}
+{"version":3,"file":"runBuild.js","sourceRoot":"","sources":["../../../../src/compiler/internal/build/runBuild.ts"],"names":[],"mappings":";;;AACA,qDAAkD;AAClD,+CAA4C;AAE5C,2DAAwD;AACxD,6DAA0D;AAC1D,mEAAgE;AAEhE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,kBAAyB,OAAO,GAAoB,EAAE;IACpD,OAAO,6CAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,WAAiB,QAAQ;IACvB;;;OAGG;IACH,SAAgB,KAAK,CACnB,OAAO,GAAoB,EAAE;QAE7B,OAAO,6CAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAJe,SAAA,KAAK,QAIpB,CAAA;IAED;;;;OAIG;IACH,QAAe,CAAC,CAAC,KAAK,CACpB,OAAwB;QAExB,MAAM,MAAM,GAAG,yBAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,+BAAc,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,WAAW,KAAK,IAAI;YACtB,OAAO,yBAAW,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC/C,MAAM,SAAS,GACb,KAAK,CAAC,CAAC,+BAAc,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,+BAAc,CAAC,0BAA0B,CAC/D,OAAO,EACP,MAAM,EACN,SAAS,EACT,cAAc,CACf,CAAC;QACF,MAAM,KAAK,GAAG,GAAG,EAAE,CACjB,+BAAc,CAAC,gBAAgB,CAC7B,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,CAAC,YAAY,CACtB,CAAC;QACJ,MAAM,KAAK,GACT,QAAQ,CAAC,MAAM,KAAK,SAAS;YAC3B,CAAC,CAAC,uCAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;YAC7D,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,MAAM,GACV,QAAQ,CAAC,MAAM;YACf,CAAC,KAAK,KAAK,SAAS;gBAClB,CAAC,CAAC,KAAK,EAAE;gBACT,CAAC,CAAC,qCAAiB,CAAC,GAAG,CAAC;oBACpB,SAAS,EAAE,OAAO,CAAC,eAAe;oBAClC,OAAO,EAAE,OAAO,CAAC,gBAAiB;oBAClC,GAAG,KAAK;oBACR,KAAK;iBACN,CAAC,CAAC,CAAC;QACV,OAAO,yBAAW,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAtCgB,SAAA,KAAK,QAsCrB,CAAA;AACH,CAAC,EAvDgB,QAAQ,aAhBT,QAAQ,GAgBP,QAAQ,QAuDxB"}

package/lib/compiler/internal/resolveNativeTypeScriptPackage.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Find native TypeScript from a filename used as a Node resolution anchor.
+ *
+ * The nearest ancestor manifest declaring TypeScript or its npm aliases owns
+ * discovery. Its aliases targeting `typescript` precede the ordinary name. A
+ * manifest reporting a compiler major below 7 belongs to the JavaScript
+ * compiler and is skipped. Missing or nonnumeric version metadata retains the
+ * existing path-discovery behavior; executable availability is the caller's
+ * responsibility. Alias candidates must report the actual package name
+ * `typescript` and a native major. Multiple distinct native alias installs are
+ * ambiguous and require an explicit binary. Read and parse errors propagate,
+ * except a disappeared manifest is treated as an absent candidate.
+ *
+ * @evidence contracts/common.md#principled-implementation Project and ancestor dependency maps supply npm aliases by their declared target; Node resolves those arbitrary names from the caller's filename, and installed name/version metadata verifies native identity. Distinct native alias installs are rejected as ambiguous rather than selected by spelling or declaration order.
+ * @evidence contracts/common.md#clear-and-simple-design One owner selects manifest metadata for executable resolution and plugin version keys so they cannot choose different package names.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The real package identity and npm alias syntax define discovery; no particular alias, consumer identity or guessed executable is embedded.
+ * @evidence contracts/common.md#meaningful-documentation The comment defines anchor semantics, alias precedence, legacy rejection, incomplete metadata behavior and propagated read failures.
+ * @evidence contracts/portability.md#os-neutral-implementation createRequire follows native Node package resolution and synchronous filesystem reads without shell commands or path case assumptions.
+ * @evidence contracts/performance.md#efficient-algorithms The ancestor walk parses its manifests and visits their declared dependency entries once, then resolves and reads only A distinct aliases plus the ordinary name. Sorting alias names costs O(A log A); Node lookup, realpath and manifest bytes contribute delegated costs. Installed dependency trees are never scanned.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Project installations can change between calls, and this operation owns no invalidation source that would justify a retained result.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Synchronous reads retain no open handles and the caller owns the returned metadata.
+ */
+export declare function resolveNativeTypeScriptPackage(from: string): {
+    packageJson: string;
+    manifest: Record<string, unknown>;
+} | undefined;