ttsc 0.26.1 → 0.27.0

package/lib/compiler/internal/sharedHostHelpers.js

@@ -3,12 +3,51 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.TSGO_ARGS_ENV = void 0;
+exports.clearInheritedTsgoArgs = clearInheritedTsgoArgs;
+exports.inheritedSidecarEnv = inheritedSidecarEnv;
 exports.resolvePluginConfigDir = resolvePluginConfigDir;
 exports.isLinkedTransform = isLinkedTransform;
 exports.assertSharedHostCompatibility = assertSharedHostCompatibility;
 exports.selectSharedHostPlugin = selectSharedHostPlugin;
 exports.linkedTransformPlugins = linkedTransformPlugins;
 const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Environment channel carrying the JSON-encoded tsgo argv ttsc forwards to a
+ * native sidecar. Mirrors `driver.TsgoArgsEnv` on the Go side; see
+ * `runBuild.ts::createNativeTsgoArgs` for why the payload is not a CLI flag.
+ */
+exports.TSGO_ARGS_ENV = "TTSC_TSGO_ARGS";
+/**
+ * Drop a forwarded-tsgo payload this invocation did not publish itself.
+ *
+ * Every sidecar env starts from `process.env`, so a ttsc that is itself running
+ * inside a plugin sidecar — `@ttsc/lint` evaluating a config file through
+ * `ttsx`, for instance — would otherwise hand the outer run's `--strict` to its
+ * own sidecars, and `driver.LoadProgram` would apply it. The forwarded argv is
+ * per-invocation state the spawning host owns, the same rule
+ * `TTSC_PLUGIN_CONFIG_DIR` already follows. A caller that named the variable
+ * explicitly keeps it.
+ */
+function clearInheritedTsgoArgs(env, callerEnv) {
+    if (callerEnv?.[exports.TSGO_ARGS_ENV] === undefined) {
+        delete env[exports.TSGO_ARGS_ENV];
+    }
+}
+/**
+ * The `{ ...process.env, ...callerEnv }` a child process inherits, minus a
+ * forwarded-tsgo payload this lane never published.
+ *
+ * Use it at every spawn whose child can reach `driver.LoadProgram` — the
+ * `api-compile` / `api-transform` hosts, and the plugin loader, whose `ttsx`
+ * descriptor evaluation compiles a project of its own. One rule at every site
+ * beats four sites each reasoning about whether the variable could be present.
+ */
+function inheritedSidecarEnv(callerEnv) {
+    const env = { ...process.env, ...callerEnv };
+    clearInheritedTsgoArgs(env, callerEnv);
+    return env;
+}
 /**
  * Resolve the caller-declared plugin config anchor to an absolute path, or
  * `undefined` when the caller did not declare one.

package/lib/compiler/internal/sharedHostHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"sharedHostHelpers.js","sourceRoot":"","sources":["../../../src/compiler/internal/sharedHostHelpers.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,0DAA6B;AAI7B;;;;;;;;;;;GAWG;AACH,gCAAuC,OAGtC;IACC,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,eAAe,KAAK,EAAE,EAAE,CAAC;QAC5E,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,2BAAkC,MAA+B;IAC/D,OAAO,MAAM,CAAC,KAAK,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,uCACE,OAA2C,EAC3C,IAAiC;IAEjC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IACD,MAAM,aAAa,GAAG;QACpB,GAAG,IAAI,GAAG,CACR,OAAO;aACJ,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;aAC9C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAClC;KACF,CAAC;IACF,IAAI,aAAa,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GACV,IAAI,KAAK,MAAM;QACb,CAAC,CAAC,8DAA8D;QAChE,CAAC,CAAC,2EAA2E,CAAC;IAClF,MAAM,IAAI,KAAK,CACb,QAAQ;QACN,MAAM;QACN,iEAAiE,CACpE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,gCACE,OAA2C;IAE3C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAE,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,gCACE,OAA2C;IAE3C,OAAO,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"sharedHostHelpers.js","sourceRoot":"","sources":["../../../src/compiler/internal/sharedHostHelpers.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,0DAA6B;AAI7B;;;;GAIG;AACU,QAAA,aAAa,GAAG,gBAAgB,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,gCACE,GAAsB,EACtB,SAAwC;IAExC,IAAI,SAAS,EAAE,CAAC,QAAA,aAAa,CAAC,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,GAAG,CAAC,QAAA,aAAa,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,6BACE,SAAwC;IAExC,MAAM,GAAG,GAAsB,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC;IAChE,sBAAsB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,gCAAuC,OAGtC;IACC,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,eAAe,KAAK,EAAE,EAAE,CAAC;QAC5E,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,2BAAkC,MAA+B;IAC/D,OAAO,MAAM,CAAC,KAAK,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,uCACE,OAA2C,EAC3C,IAAiC;IAEjC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IACD,MAAM,aAAa,GAAG;QACpB,GAAG,IAAI,GAAG,CACR,OAAO;aACJ,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;aAC9C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAClC;KACF,CAAC;IACF,IAAI,aAAa,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GACV,IAAI,KAAK,MAAM;QACb,CAAC,CAAC,8DAA8D;QAChE,CAAC,CAAC,2EAA2E,CAAC;IAClF,MAAM,IAAI,KAAK,CACb,QAAQ;QACN,MAAM;QACN,iEAAiE,CACpE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,gCACE,OAA2C;IAE3C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAE,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,gCACE,OAA2C;IAE3C,OAAO,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC3C,CAAC"}

package/lib/compiler/internal/startResidentTransform.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startResidentTransform = startResidentTransform;
 const node_path_1 = __importDefault(require("node:path"));
+const resolveNodeBinary_1 = require("../../internal/resolveNodeBinary");
 const loadProjectPlugins_1 = require("../../plugin/internal/loadProjectPlugins");
 const readProjectConfig_1 = require("./project/readProjectConfig");
 const residentTransformProcess_1 = require("./residentTransformProcess");
@@ -38,7 +39,7 @@ function startResidentTransform(context) {
         cacheDir: context.cacheDir ?? context.env?.TTSC_CACHE_DIR,
         cwd,
         entries: context.plugins,
-        env: { ...process.env, ...context.env },
+        env: (0, sharedHostHelpers_1.inheritedSidecarEnv)(context.env),
         pluginConfigDir: context.pluginConfigDir,
         projectRoot: context.projectRoot,
         tsconfig: project.path,
@@ -60,7 +61,7 @@ function startResidentTransform(context) {
         ],
         binary: host.binary,
         cwd: project.root,
-        env: residentEnv(context, tsgoBinary, loaded.nativePlugins),
+        env: residentEnv(context, project.root, tsgoBinary, loaded.nativePlugins),
     });
     return { process: resident, projectRoot: project.root };
 }
@@ -73,11 +74,10 @@ function startResidentTransform(context) {
  * wrapper's temp-dir ancestry, and forwards linked transform plugins via
  * `TTSC_LINKED_PLUGINS_JSON`.
  */
-function residentEnv(context, tsgoBinary, nativePlugins) {
+function residentEnv(context, projectRoot, tsgoBinary, nativePlugins) {
     const pluginConfigDir = (0, sharedHostHelpers_1.resolvePluginConfigDir)(context);
     const env = {
         ...process.env,
-        TTSC_NODE_BINARY: process.env.TTSC_NODE_BINARY ?? process.execPath,
         ...(pluginConfigDir === undefined
             ? {}
             : { TTSC_PLUGIN_CONFIG_DIR: pluginConfigDir }),
@@ -86,6 +86,11 @@ function residentEnv(context, tsgoBinary, nativePlugins) {
             node_path_1.default.join(__dirname, "..", "..", "launcher", "ttsx.js"),
         ...context.env,
     };
+    const node = (0, resolveNodeBinary_1.resolveNodeBinary)(env, projectRoot);
+    if (node === undefined)
+        delete env.TTSC_NODE_BINARY;
+    else
+        env.TTSC_NODE_BINARY = node;
     // The anchor is per-invocation state owned by this host: when this run
     // declared none (and the caller's env does not name one), drop any value
     // inherited from an ancestor ttsc process so a nested build never
@@ -94,6 +99,9 @@ function residentEnv(context, tsgoBinary, nativePlugins) {
         context.env?.TTSC_PLUGIN_CONFIG_DIR === undefined) {
         delete env.TTSC_PLUGIN_CONFIG_DIR;
     }
+    // This lane forwards no tsgo argv of its own, so anything inherited belongs
+    // to an outer ttsc run and must not reach the resident sidecar.
+    (0, sharedHostHelpers_1.clearInheritedTsgoArgs)(env, context.env);
     const linked = (0, sharedHostHelpers_1.linkedTransformPlugins)(nativePlugins);
     if (linked.length !== 0) {
         env.TTSC_LINKED_PLUGINS_JSON = serializeNativePlugins(linked);

package/lib/compiler/internal/startResidentTransform.js.map

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

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

@@ -20,6 +20,9 @@ export declare function transformProjectInMemory(options: ITtscCompilerContext):
     dependencies?: Record<string, string[]>;
     dependenciesComplete?: string[];
     graph?: ITtscCompilerTransformation.IReferenceGraph;
+    hostInputHashes?: Record<string, string | null>;
+    hostInputRealpaths?: Record<string, string | null>;
+    hostInputs?: string[];
     result: TtscBuildResult;
     typescript: Record<string, string>;
     volatile?: string[];

package/lib/compiler/internal/transformProjectInMemory.js

@@ -5,11 +5,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.transformProjectInMemory = transformProjectInMemory;
 const node_path_1 = __importDefault(require("node:path"));
+const resolveNodeBinary_1 = require("../../internal/resolveNodeBinary");
 const loadProjectPlugins_1 = require("../../plugin/internal/loadProjectPlugins");
 const buildNativeCompiler_1 = require("./buildNativeCompiler");
 const paths_1 = require("./paths");
 const createNativeProjectContextArgs_1 = require("./project/createNativeProjectContextArgs");
-const readProjectConfig_1 = require("./project/readProjectConfig");
 const resolveBinary_1 = require("./resolveBinary");
 const resolveTsgo_1 = require("./resolveTsgo");
 const runBuild_1 = require("./runBuild");
@@ -32,26 +32,39 @@ const spawnNative_1 = require("./spawnNative");
  */
 function transformProjectInMemory(options) {
     const cwd = node_path_1.default.resolve(options.cwd ?? process.cwd());
-    const project = (0, readProjectConfig_1.readProjectConfig)({
+    const loaded = (0, loadProjectPlugins_1.loadProjectPlugins)({
+        binary: (0, resolveBinary_1.resolveBinary)(options) ?? "",
+        cacheDir: options.cacheDir ?? options.env?.TTSC_CACHE_DIR,
         cwd,
+        entries: options.plugins,
+        env: (0, sharedHostHelpers_1.inheritedSidecarEnv)(options.env),
+        pluginConfigDir: options.pluginConfigDir,
         projectRoot: options.projectRoot,
         tsconfig: options.tsconfig,
     });
-    if (hasConfiguredPlugins(options, project)) {
-        return transformProjectWithPlugins(options, cwd, project);
+    if (loaded.nativePlugins.length !== 0) {
+        return transformProjectWithPlugins(options, loaded);
     }
-    return transformProjectWithNativeHost(options, project);
-}
-/** Return true when the project or the call-level options declare any plugins. */
-function hasConfiguredPlugins(options, project) {
-    return (0, loadProjectPlugins_1.hasProjectPluginEntries)(project, options.plugins);
+    return transformProjectWithNativeHost(options, loaded.project, loaded);
 }
 /**
  * Transform via the built-in native compiler host (`cmd/ttsc api-transform`).
  * Used when no user plugins are configured, or as the fallback transformer when
  * check-stage plugins pass and no transform-stage plugins are declared.
  */
-function transformProjectWithNativeHost(options, project) {
+function transformProjectWithNativeHost(options, project, baseline) {
+    // Capture the project inputs before the native host observes them. Pairing a
+    // post-build hash with an earlier result can bless a torn generation when a
+    // config changes during the child process.
+    // Plugin discovery already ran in loadProjectPlugins. The native host only
+    // consumes the resolved config chain here, so dependency package manifests
+    // must not become per-project universal inputs a second time.
+    const projectHostInputs = (0, loadProjectPlugins_1.collectProjectHostInputs)(project, false);
+    const projectHostInputHashes = (0, loadProjectPlugins_1.hashHostInputPaths)(projectHostInputs);
+    const projectHostInputRealpaths = (0, loadProjectPlugins_1.realpathHostInputPaths)(projectHostInputs);
+    const observedHostInputs = mergeHostInputs(baseline?.hostInputs, projectHostInputs);
+    const observedHostInputHashes = mergeCompatibleHostInputHashes(baseline?.hostInputHashes ?? {}, projectHostInputHashes, baseline?.hostInputs ?? [], projectHostInputs);
+    const observedHostInputRealpaths = mergeCompatibleHostInputHashes(baseline?.hostInputRealpaths ?? {}, projectHostInputRealpaths, baseline?.hostInputs ?? [], projectHostInputs);
     const binary = (0, buildNativeCompiler_1.buildNativeCompiler)({
         cacheBaseDir: project.root,
         cacheDir: options.cacheDir ?? options.env?.TTSC_CACHE_DIR,
@@ -59,14 +72,21 @@ function transformProjectWithNativeHost(options, project) {
     });
     const res = (0, spawnNative_1.spawnNative)(binary, ["api-transform", "--cwd", project.root, "--tsconfig", project.path], {
         cwd: project.root,
-        env: { ...process.env, ...options.env },
+        env: (0, sharedHostHelpers_1.inheritedSidecarEnv)(options.env),
     });
     if (res.error) {
         throw new Error(`ttsc: failed to spawn native compiler host ${binary}: ${res.error.message}`);
     }
     const output = parseNativeTransformOutput((0, spawnNative_1.outputText)(res.stdout), (0, spawnNative_1.outputText)(res.stderr));
+    const finalObservedHostInputHashes = revalidateHostInputHashes(observedHostInputHashes, observedHostInputs);
+    const finalOutputHostInputHashes = revalidateHostInputHashes(output.hostInputHashes ?? {}, output.hostInputs ?? []);
+    const finalObservedHostInputRealpaths = revalidateHostInputRealpaths(observedHostInputRealpaths, observedHostInputs);
+    const finalOutputHostInputRealpaths = revalidateHostInputRealpaths(output.hostInputRealpaths ?? {}, output.hostInputs ?? []);
     return {
         ...envelopeSideChannels(output),
+        hostInputHashes: mergeCompatibleHostInputHashes(finalObservedHostInputHashes, finalOutputHostInputHashes, observedHostInputs, output.hostInputs),
+        hostInputRealpaths: mergeCompatibleHostInputHashes(finalObservedHostInputRealpaths, finalOutputHostInputRealpaths, observedHostInputs, output.hostInputs),
+        hostInputs: mergeHostInputs(observedHostInputs, output.hostInputs),
         result: {
             diagnostics: output.diagnostics,
             status: res.status ?? 1,
@@ -76,17 +96,8 @@ function transformProjectWithNativeHost(options, project) {
         typescript: output.typescript,
     };
 }
-function transformProjectWithPlugins(options, cwd, project) {
-    const loaded = (0, loadProjectPlugins_1.loadProjectPlugins)({
-        binary: (0, resolveBinary_1.resolveBinary)(options) ?? "",
-        cacheDir: options.cacheDir ?? options.env?.TTSC_CACHE_DIR,
-        cwd,
-        entries: options.plugins,
-        env: { ...process.env, ...options.env },
-        pluginConfigDir: options.pluginConfigDir,
-        projectRoot: options.projectRoot,
-        tsconfig: project.path,
-    });
+function transformProjectWithPlugins(options, loaded) {
+    const { project } = loaded;
     const checks = loaded.nativePlugins.filter((plugin) => plugin.stage === "check");
     const transformers = loaded.nativePlugins.filter((plugin) => plugin.stage === "transform");
     const tsgoBinary = loaded.nativePlugins.length === 0
@@ -95,14 +106,22 @@ function transformProjectWithPlugins(options, cwd, project) {
     const checked = runNativeChecks(options, project, tsgoBinary, loaded.nativePlugins, checks);
     if (checked.status !== 0) {
         return {
+            hostInputHashes: revalidateHostInputHashes(loaded.hostInputHashes, loaded.hostInputs),
+            hostInputRealpaths: revalidateHostInputRealpaths(loaded.hostInputRealpaths, loaded.hostInputs),
+            hostInputs: loaded.hostInputs,
             result: checked,
             typescript: {},
         };
     }
     if (transformers.length === 0) {
         const transformed = transformProjectWithNativeHost(options, project);
+        const finalLoadedHostInputHashes = revalidateHostInputHashes(loaded.hostInputHashes, loaded.hostInputs);
+        const finalLoadedHostInputRealpaths = revalidateHostInputRealpaths(loaded.hostInputRealpaths, loaded.hostInputs);
         return {
             ...envelopeSideChannels(transformed),
+            hostInputHashes: mergeCompatibleHostInputHashes(finalLoadedHostInputHashes, transformed.hostInputHashes, loaded.hostInputs, transformed.hostInputs),
+            hostInputRealpaths: mergeCompatibleHostInputHashes(finalLoadedHostInputRealpaths, transformed.hostInputRealpaths, loaded.hostInputs, transformed.hostInputs),
+            hostInputs: mergeHostInputs(loaded.hostInputs, transformed.hostInputs),
             result: (0, runBuild_1.appendBuildOutput)(checked, transformed.result),
             typescript: transformed.typescript,
         };
@@ -111,7 +130,7 @@ function transformProjectWithPlugins(options, cwd, project) {
     const plugin = (0, sharedHostHelpers_1.selectSharedHostPlugin)(transformers);
     const res = (0, spawnNative_1.spawnNative)(plugin.binary, createNativeTransformArgs(project, transformers, (0, sharedHostHelpers_1.resolvePluginConfigDir)(options)), {
         cwd: project.root,
-        env: nativePluginEnv(options, tsgoBinary, loaded.nativePlugins, plugin),
+        env: nativePluginEnv(options, project.root, tsgoBinary, loaded.nativePlugins, plugin),
     });
     if (res.error) {
         throw new Error(`ttsc.transform: failed to spawn ${plugin.binary}: ${res.error.message}`);
@@ -123,12 +142,41 @@ function transformProjectWithPlugins(options, cwd, project) {
         stdout: "",
         stderr: (0, spawnNative_1.outputText)(res.stderr),
     };
+    const finalLoadedHostInputHashes = revalidateHostInputHashes(loaded.hostInputHashes, loaded.hostInputs);
+    const finalOutputHostInputHashes = revalidateHostInputHashes(output.hostInputHashes ?? {}, output.hostInputs ?? []);
+    const finalLoadedHostInputRealpaths = revalidateHostInputRealpaths(loaded.hostInputRealpaths, loaded.hostInputs);
+    const finalOutputHostInputRealpaths = revalidateHostInputRealpaths(output.hostInputRealpaths ?? {}, output.hostInputs ?? []);
     return {
         ...envelopeSideChannels(output),
+        hostInputHashes: mergeCompatibleHostInputHashes(finalLoadedHostInputHashes, finalOutputHostInputHashes, loaded.hostInputs, output.hostInputs),
+        hostInputRealpaths: mergeCompatibleHostInputHashes(finalLoadedHostInputRealpaths, finalOutputHostInputRealpaths, loaded.hostInputs, output.hostInputs),
+        hostInputs: mergeHostInputs(loaded.hostInputs, output.hostInputs),
         result: (0, runBuild_1.appendBuildOutput)(checked, result),
         typescript: output.typescript,
     };
 }
+/** Keep evaluation proof only when the same input still has the same state. */
+function revalidateHostInputHashes(initial, inputs) {
+    const current = (0, loadProjectPlugins_1.hashHostInputPaths)(inputs);
+    return Object.fromEntries(inputs.flatMap((input) => {
+        const absolute = node_path_1.default.resolve(input);
+        return Object.prototype.hasOwnProperty.call(initial, absolute) &&
+            initial[absolute] === current[absolute]
+            ? [[absolute, current[absolute]]]
+            : [];
+    }));
+}
+/** Keep evaluation proof only while each lexical path selects the same target. */
+function revalidateHostInputRealpaths(initial, inputs) {
+    const current = (0, loadProjectPlugins_1.realpathHostInputPaths)(inputs);
+    return Object.fromEntries(inputs.flatMap((input) => {
+        const absolute = node_path_1.default.resolve(input);
+        return Object.prototype.hasOwnProperty.call(initial, absolute) &&
+            initial[absolute] === current[absolute]
+            ? [[absolute, current[absolute]]]
+            : [];
+    }));
+}
 /**
  * Collect the optional advisory envelope fields (`dependencies`,
  * `dependenciesComplete`, `graph`, `volatile`) into a spreadable object,
@@ -147,6 +195,54 @@ function envelopeSideChannels(output) {
         ...(output.volatile === undefined ? {} : { volatile: output.volatile }),
     };
 }
+/** Merge JavaScript- and native-host universal inputs by absolute path. */
+function mergeHostInputs(...groups) {
+    return [
+        ...new Set(groups.flatMap((group) => (group ?? []).map((file) => node_path_1.default.resolve(file)))),
+    ].sort();
+}
+/** Keep only native/descriptor fingerprints that agree on shared paths. */
+function mergeCompatibleHostInputHashes(first, second, firstInputs, secondInputs) {
+    const firstDeclared = new Set(firstInputs.map((input) => node_path_1.default.resolve(input)));
+    const secondDeclared = new Set((secondInputs ?? []).map((input) => node_path_1.default.resolve(input)));
+    const output = Object.fromEntries(Object.entries(first).flatMap(([file, hash]) => {
+        const absolute = node_path_1.default.resolve(file);
+        return firstDeclared.has(absolute) ? [[absolute, hash]] : [];
+    }));
+    const unproven = new Set();
+    for (const input of firstInputs) {
+        const absolute = node_path_1.default.resolve(input);
+        if (!Object.prototype.hasOwnProperty.call(first, absolute)) {
+            delete output[absolute];
+            unproven.add(absolute);
+        }
+    }
+    for (const input of secondInputs ?? []) {
+        const absolute = node_path_1.default.resolve(input);
+        if (!Object.prototype.hasOwnProperty.call(second ?? {}, absolute)) {
+            delete output[absolute];
+            unproven.add(absolute);
+        }
+    }
+    for (const [file, hash] of Object.entries(second ?? {})) {
+        const absolute = node_path_1.default.resolve(file);
+        if (!secondDeclared.has(absolute))
+            continue;
+        if (unproven.has(absolute))
+            continue;
+        if (Object.prototype.hasOwnProperty.call(output, absolute) &&
+            output[absolute] !== hash) {
+            // Two evaluation stages observed different states. Dropping proof makes
+            // persistent adapters replace the generation without turning advisory
+            // cache metadata into a user-facing compile failure.
+            delete output[absolute];
+            unproven.add(absolute);
+            continue;
+        }
+        output[absolute] = hash;
+    }
+    return output;
+}
 /**
  * Run every check-stage plugin in sequence, short-circuiting on the first
  * failure. Returns the aggregated `TtscBuildResult` (status 0 when all pass).
@@ -161,7 +257,7 @@ function runNativeChecks(options, project, tsgoBinary, nativePlugins, checks) {
     for (const plugin of checks) {
         const res = (0, spawnNative_1.spawnNative)(plugin.binary, createNativeCheckArgs(project, nativePlugins, plugin, (0, sharedHostHelpers_1.resolvePluginConfigDir)(options)), {
             cwd: project.root,
-            env: nativePluginEnv(options, tsgoBinary, nativePlugins, plugin),
+            env: nativePluginEnv(options, project.root, tsgoBinary, nativePlugins, plugin),
         });
         if (res.error) {
             throw new Error(`ttsc.transform.check: failed to spawn ${plugin.binary}: ${res.error.message}`);
@@ -223,11 +319,10 @@ function serializeNativePlugins(plugins) {
  * instead of the wrapper's temp-dir ancestry. For transform plugins, also
  * passes `TTSC_LINKED_PLUGINS_JSON` when linked sources are present.
  */
-function nativePluginEnv(options, tsgoBinary, nativePlugins, plugin) {
+function nativePluginEnv(options, projectRoot, tsgoBinary, nativePlugins, plugin) {
     const pluginConfigDir = (0, sharedHostHelpers_1.resolvePluginConfigDir)(options);
     const env = {
         ...process.env,
-        TTSC_NODE_BINARY: process.env.TTSC_NODE_BINARY ?? process.execPath,
         ...(pluginConfigDir === undefined
             ? {}
             : { TTSC_PLUGIN_CONFIG_DIR: pluginConfigDir }),
@@ -236,6 +331,11 @@ function nativePluginEnv(options, tsgoBinary, nativePlugins, plugin) {
             node_path_1.default.join(__dirname, "..", "..", "launcher", "ttsx.js"),
         ...options.env,
     };
+    const node = (0, resolveNodeBinary_1.resolveNodeBinary)(env, projectRoot);
+    if (node === undefined)
+        delete env.TTSC_NODE_BINARY;
+    else
+        env.TTSC_NODE_BINARY = node;
     // The anchor is per-invocation state owned by this host: when this run
     // declared none (and the caller's env does not name one), drop any value
     // inherited from an ancestor ttsc process so a nested build never
@@ -244,6 +344,9 @@ function nativePluginEnv(options, tsgoBinary, nativePlugins, plugin) {
         options.env?.TTSC_PLUGIN_CONFIG_DIR === undefined) {
         delete env.TTSC_PLUGIN_CONFIG_DIR;
     }
+    // This lane forwards no tsgo argv of its own, so anything inherited belongs
+    // to an outer ttsc run and must not reach these sidecars.
+    (0, sharedHostHelpers_1.clearInheritedTsgoArgs)(env, options.env);
     if (plugin?.stage === "transform") {
         const linked = (0, sharedHostHelpers_1.linkedTransformPlugins)(nativePlugins ?? []);
         if (linked.length !== 0) {
@@ -277,11 +380,17 @@ function parseNativeTransformOutput(stdout, stderr) {
         const dependencies = parseDependencyLists(parsed.dependencies);
         const dependenciesComplete = parseFileList(parsed.dependenciesComplete);
         const graph = parseReferenceGraph(parsed.graph);
+        const hostInputHashes = parseHostInputHashes(parsed.hostInputHashes);
+        const hostInputRealpaths = parseHostInputRealpaths(parsed.hostInputRealpaths);
+        const hostInputs = parseFileList(parsed.hostInputs);
         const volatile = parseFileList(parsed.volatile);
         return {
             ...(dependencies === undefined ? {} : { dependencies }),
             ...(dependenciesComplete === undefined ? {} : { dependenciesComplete }),
             ...(graph === undefined ? {} : { graph }),
+            ...(hostInputHashes === undefined ? {} : { hostInputHashes }),
+            ...(hostInputRealpaths === undefined ? {} : { hostInputRealpaths }),
+            ...(hostInputs === undefined ? {} : { hostInputs }),
             ...(volatile === undefined ? {} : { volatile }),
             diagnostics: Array.isArray(parsed.diagnostics) ? parsed.diagnostics : [],
             typescript: parsed.typescript,
@@ -295,6 +404,39 @@ function parseNativeTransformOutput(stdout, stderr) {
             "ttsc: native transform host returned no output");
     }
 }
+/** Parse native evaluation-time SHA-256/null host-input fingerprints. */
+function parseHostInputHashes(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const output = {};
+    for (const [file, hash] of Object.entries(value)) {
+        if (!node_path_1.default.isAbsolute(file) ||
+            (hash !== null &&
+                (typeof hash !== "string" || !/^[0-9a-f]{64}$/.test(hash)))) {
+            continue;
+        }
+        output[node_path_1.default.resolve(file)] = hash;
+    }
+    return Object.keys(output).length === 0 ? undefined : output;
+}
+/** Parse native evaluation-time realpath/null host-input identities. */
+function parseHostInputRealpaths(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const output = {};
+    for (const [file, realpath] of Object.entries(value)) {
+        if (!node_path_1.default.isAbsolute(file) ||
+            (realpath !== null &&
+                (typeof realpath !== "string" || !node_path_1.default.isAbsolute(realpath)))) {
+            continue;
+        }
+        output[node_path_1.default.resolve(file)] =
+            realpath === null ? null : node_path_1.default.resolve(realpath);
+    }
+    return Object.keys(output).length === 0 ? undefined : output;
+}
 /**
  * Normalize the optional `dependencies` envelope field into a record of string
  * arrays, or `undefined` when absent or carrying nothing usable.
@@ -315,11 +457,34 @@ function parseDependencyLists(value) {
     }
     return Object.keys(output).length === 0 ? undefined : output;
 }
+/**
+ * Normalize graph adjacency while retaining every well-formed node key.
+ *
+ * A leaf is intentionally encoded as an empty target array. Its key still
+ * declares graph membership and lets persistent hosts bind the compiler-time
+ * input proof for that source. A node needs a non-empty source key and an array
+ * value; invalid array members are filtered without erasing a valid node.
+ */
+function parseGraphEdges(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const output = {};
+    for (const [key, entries] of Object.entries(value)) {
+        if (key.length === 0 || !Array.isArray(entries)) {
+            continue;
+        }
+        output[key] = entries.filter((entry) => typeof entry === "string");
+    }
+    return Object.keys(output).length === 0 ? undefined : output;
+}
 /**
  * Normalize the optional `graph` envelope section with the same tolerance as
- * `dependencies`: non-object sections are dropped, edge entries that are not
- * string arrays are dropped, and non-string list members are filtered. A
- * section carrying nothing usable collapses to `undefined`.
+ * `dependencies`: non-object sections are dropped, empty source keys and edge
+ * entries that are not arrays are dropped, and non-string list members are
+ * filtered. Empty arrays remain as graph nodes because leaf membership binds
+ * compiler input proof. A section carrying nothing usable collapses to
+ * `undefined`.
  *
  * `candidates` is the one optional member, so an empty one is left off the
  * result instead of being materialized as `{}`. The host omits the key when it
@@ -333,23 +498,62 @@ function parseReferenceGraph(value) {
     }
     const section = value;
     const candidates = parseDependencyLists(section.candidates) ?? {};
-    const edges = parseDependencyLists(section.edges) ?? {};
+    const edges = parseGraphEdges(section.edges) ?? {};
     const globals = parseFileList(section.globals) ?? [];
     const configs = parseFileList(section.configs) ?? [];
+    const inputHashes = parseGraphInputHashes(section.inputHashes);
+    const inputRealpaths = parseGraphInputRealpaths(section.inputRealpaths);
     if (Object.keys(candidates).length === 0 &&
         Object.keys(edges).length === 0 &&
         globals.length === 0 &&
         configs.length === 0) {
         return undefined;
     }
-    return Object.keys(candidates).length === 0
-        ? { configs, edges, globals }
-        : { candidates, configs, edges, globals };
+    return {
+        ...(Object.keys(candidates).length === 0 ? {} : { candidates }),
+        configs,
+        edges,
+        globals,
+        ...(inputHashes === undefined ? {} : { inputHashes }),
+        ...(inputRealpaths === undefined ? {} : { inputRealpaths }),
+    };
+}
+/** Parse graph-keyed compiler-time content/null observations. */
+function parseGraphInputHashes(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const output = {};
+    for (const [file, hash] of Object.entries(value)) {
+        if (file.length === 0 ||
+            (hash !== null &&
+                (typeof hash !== "string" || !/^[0-9a-f]{64}$/.test(hash)))) {
+            continue;
+        }
+        output[file] = hash;
+    }
+    return Object.keys(output).length === 0 ? undefined : output;
+}
+/** Parse graph-keyed compiler-time physical/null identities. */
+function parseGraphInputRealpaths(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const output = {};
+    for (const [file, realpath] of Object.entries(value)) {
+        if (file.length === 0 ||
+            (realpath !== null &&
+                (typeof realpath !== "string" || !node_path_1.default.isAbsolute(realpath)))) {
+            continue;
+        }
+        output[file] = realpath === null ? null : node_path_1.default.resolve(realpath);
+    }
+    return Object.keys(output).length === 0 ? undefined : output;
 }
 /**
  * Normalize an optional string-list envelope field (`dependenciesComplete`,
- * `volatile`, and the `globals`/`configs` graph sections), or `undefined` when
- * absent or carrying nothing usable.
+ * `hostInputs`, `volatile`, and the `globals`/`configs` graph sections), or
+ * `undefined` when absent or carrying nothing usable.
  */
 function parseFileList(value) {
     if (!Array.isArray(value)) {