ttsc 0.31.1 → 0.31.2

package/lib/internal/javascriptRuntimeCapabilities.js

@@ -9,6 +9,7 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const captureProcessOutput_1 = require("../compiler/internal/captureProcessOutput");
 const SidecarEnvironment_1 = require("../compiler/internal/sharedHost/SidecarEnvironment");
+const PluginLoadAnswers_1 = require("../plugin/internal/source/PluginLoadAnswers");
 const E2ETrace_1 = require("./E2ETrace");
 const OwnedSynchronousProcess_1 = require("./OwnedSynchronousProcess");
 const isSpawnSyncFdExhaustion_1 = require("./isSpawnSyncFdExhaustion");
@@ -23,24 +24,48 @@ const spawnSyncWithLowDescriptors_1 = require("./spawnSyncWithLowDescriptors");
  * Cache-ineligible candidates do not acquire executable proofs used only by
  * cache lookup and publication.
  *
- * @evidence contracts/common.md#principled-implementation A child reports its own feature availability and executable; byte-aware before/after identity and same-executable proof authorize reuse only for a stable absolute runtime without NODE_OPTIONS preload authority.
+ * With a record store, the executable identity is proven from metadata and a
+ * probe answer recorded for that identity is reused by a later process (#1723);
+ * a recorded answer must still name an executable this runtime is.
+ *
+ * @param runtime The interpreter to probe.
+ * @param env Caller environment merged over this process's.
+ * @param cwd Working directory of the probe.
+ * @param identities Optional record store of the caller's plugin cache.
+ * @evidence contracts/common.md#principled-implementation A child reports its own feature availability and executable; byte-aware before/after identity and same-executable proof authorize reuse only for a stable absolute runtime without NODE_OPTIONS preload authority, in process or through an answer recorded under that identity.
  * @evidence contracts/common.md#clear-and-simple-design One probe owner coordinates identity, spawning and parsing; the shared fingerprint helper owns file-content proof and the low-descriptor helper owns the POSIX launch distinction.
  * @evidence contracts/common.md#prohibited-implementation-shortcuts Feature availability comes from the actual interpreter rather than its name; descriptor fallback handles a supported kernel constraint and failures produce unsupported capabilities, not fabricated success.
  * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain measured capabilities, reuse restrictions and freshness, with comments separating platform launch and cache permission from tags.
  * @evidence contracts/portability.md#os-neutral-implementation Shared environment merge and lookup apply native name identity to caller precedence and NODE_OPTIONS preload authority, including Windows aliases; Node spawn receives an executable and argv without shell syntax, and only POSIX descriptor exhaustion uses the isolated broker.
- * @evidence contracts/performance.md#efficient-algorithms Environment merge/name handling first decides cache eligibility. Eligible hits read B executable bytes; eligible misses acquire before/after content proofs around the actual probe. Ineligible calls retain the fresh child without reading executable bytes solely for the forbidden cache. Probe spawning/parsing, a possible descriptor-exhaustion retry and capture-file reads add text/environment/native lookup costs and transient output storage; this adapter sets no explicit byte quota.
- * @evidence contracts/performance.md#reuse-equivalent-work Stable absolute candidates that report their own executable share measured capability results, including false feature flags; changed executable bytes, link/target identity, preload options or wrapper identity require another probe, while failed probes without executable identity are not reused.
+ * @evidence contracts/performance.md#efficient-algorithms Environment merge/name handling first decides cache eligibility. Eligible hits prove the executable from a record (three stats and one small read) or read B executable bytes; eligible misses acquire before/after identities around the actual probe. Ineligible calls retain the fresh child without reading executable bytes solely for the forbidden cache. Probe spawning/parsing, a possible descriptor-exhaustion retry and capture-file reads add text/environment/native lookup costs and transient output storage; this adapter sets no explicit byte quota.
+ * @evidence contracts/performance.md#reuse-equivalent-work Stable absolute candidates that report their own executable share measured capability results, including false feature flags, within the process and across processes through the record store keyed by the full identity; changed executable bytes, link/target identity, preload options or wrapper identity require another probe, while failed probes without executable identity are not reused.
  * @evidence contracts/performance.md#bound-retention-and-release-resources The synchronous probe owns child completion and fallback captures; finally attempts capture close/removal, whose helper suppresses cleanup failures, so native/file release is unconfirmed on failure. Capability entries retain absolute spellings and path/identity text with no eviction quota; failed identity validation can remove an entry. Returned capability copies transfer to callers.
  */
-function javascriptRuntimeCapabilities(runtime, env, cwd) {
+function javascriptRuntimeCapabilities(runtime, env, cwd, identities) {
     const effectiveEnv = SidecarEnvironment_1.SidecarEnvironment.merge(process.env, env);
     const cacheKey = runtimeCapabilityCacheKey(runtime, effectiveEnv);
-    const beforeIdentity = cacheKey === undefined ? undefined : (0, runtimeExecutableIdentity_1.runtimeExecutableIdentity)(runtime);
+    const beforeIdentity = cacheKey === undefined
+        ? undefined
+        : (0, runtimeExecutableIdentity_1.runtimeExecutableIdentity)(runtime, identities);
     if (cacheKey !== undefined && beforeIdentity !== undefined) {
         const cached = runtimeCapabilityCache.get(cacheKey);
         if (cached?.identity === beforeIdentity)
             return { ...cached.capabilities };
         runtimeCapabilityCache.delete(cacheKey);
+        // WARNING (#1723): a launch is a new process, so the memo above is empty
+        // on every CLI run. The same proven executable answers the same probe; the
+        // record store carries that answer across processes.
+        const recorded = recordedCapabilities(PluginLoadAnswers_1.PluginLoadAnswers.read(identities, RUNTIME_CAPABILITIES, [
+            cacheKey,
+            beforeIdentity,
+        ]), runtime);
+        if (recorded !== undefined) {
+            runtimeCapabilityCache.set(cacheKey, {
+                capabilities: { ...recorded },
+                identity: beforeIdentity,
+            });
+            return recorded;
+        }
     }
     const args = [
         "-e",
@@ -104,7 +129,9 @@ function javascriptRuntimeCapabilities(runtime, env, cwd) {
     // false for either feature and still be reused under the executable proof.
     // This removes a process spawn from the common path without
     // authorizing a replaced or redirected runtime in a long-lived host.
-    const afterIdentity = cacheKey === undefined ? undefined : (0, runtimeExecutableIdentity_1.runtimeExecutableIdentity)(runtime);
+    const afterIdentity = cacheKey === undefined
+        ? undefined
+        : (0, runtimeExecutableIdentity_1.runtimeExecutableIdentity)(runtime, identities);
     if (cacheKey !== undefined &&
         capabilities.executable !== undefined &&
         beforeIdentity !== undefined &&
@@ -114,9 +141,32 @@ function javascriptRuntimeCapabilities(runtime, env, cwd) {
             capabilities: { ...capabilities },
             identity: afterIdentity,
         });
+        PluginLoadAnswers_1.PluginLoadAnswers.write(identities, RUNTIME_CAPABILITIES, [cacheKey, afterIdentity], capabilities);
     }
     return capabilities;
 }
+/** Answer family of measured runtime capabilities (`PluginLoadAnswers`). */
+const RUNTIME_CAPABILITIES = "javascript-runtime-capabilities";
+/**
+ * A recorded probe answer in the shape the probe produces, still naming an
+ * executable this runtime is, or `undefined`.
+ */
+function recordedCapabilities(value, runtime) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const recorded = value;
+    if (typeof recorded.bun !== "boolean" ||
+        typeof recorded.registerHooks !== "boolean" ||
+        typeof recorded.executable !== "string" ||
+        !node_path_1.default.isAbsolute(recorded.executable) ||
+        !sameRuntimeExecutable(runtime, recorded.executable))
+        return undefined;
+    return {
+        bun: recorded.bun,
+        executable: recorded.executable,
+        registerHooks: recorded.registerHooks,
+    };
+}
 const runtimeCapabilityCache = new Map();
 /** True when a probe ran the candidate itself rather than a mutable wrapper. */
 function sameRuntimeExecutable(candidate, executable) {

package/lib/internal/javascriptRuntimeCapabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"javascriptRuntimeCapabilities.js","sourceRoot":"","sources":["../../src/internal/javascriptRuntimeCapabilities.ts"],"names":[],"mappings":";;;;;;AAAA,4EAA8C;AAC9C,sDAAyB;AACzB,0DAA6B;AAE7B,oFAAiF;AACjF,2FAAwF;AACxF,yCAAsC;AAEtC,uEAAoE;AACpE,uEAAoE;AACpE,2EAAwE;AACxE,+EAA4E;AAE5E;;;;;;;;;;;;;;;;;GAiBG;AACH,uCACE,OAAe,EACf,GAAsB,EACtB,GAAW;IAEX,MAAM,YAAY,GAAG,uCAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,yBAAyB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,cAAc,GAClB,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,qDAAyB,EAAC,OAAO,CAAC,CAAC;IAC1E,IAAI,QAAQ,KAAK,SAAS,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,MAAM,EAAE,QAAQ,KAAK,cAAc;YAAE,OAAO,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QAC3E,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,oNAAoN;KACrN,CAAC;IACF,MAAM,OAAO,GAAG;QACd,GAAG;QACH,QAAQ,EAAE,MAAe;QACzB,GAAG,EAAE,YAAY;QACjB,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,IAAI;KAClB,CAAC;IACF,IAAI,MAAM,GAAG,mBAAQ,CAAC,WAAW,CAC/B,OAAO,EACP,IAAI,EACJ,OAAO,EACP,0BAA0B,EAC1B,GAAG,EAAE,CACH,iDAAuB,CAAC,MAAM,CAAS,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;QAC9D,4BAAY,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CACjD,CAAC;IACF,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAA,iDAAuB,EAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAA,2CAAoB,GAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,yDAA2B,EAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;gBAClE,MAAM,EAAE,OAAO,CAAC,UAAU;gBAC1B,MAAM,EAAE,OAAO,CAAC,UAAU;aAC3B,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAW,CAAC;YACxD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAW,CAAC;YACxD,MAAM,GAAG;gBACP,GAAG,OAAO;gBACV,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC;gBAC9B,MAAM;gBACN,MAAM;aACP,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,YAAY,GAAmC;QACjD,GAAG,EAAE,KAAK;QACV,aAAa,EAAE,KAAK;KACrB,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,CAAC,MAAM,CAC6B,CAAC;YAC7C,YAAY,GAAG;gBACb,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,IAAI;gBACxB,GAAG,CAAC,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;oBACzC,mBAAI,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC;oBAChC,CAAC,CAAC,EAAE,UAAU,EAAE,mBAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;oBACjD,CAAC,CAAC,EAAE,CAAC;gBACP,aAAa,EAAE,MAAM,CAAC,aAAa,KAAK,IAAI;aAC7C,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;IACH,CAAC;IACD,6EAA6E;IAC7E,2EAA2E;IAC3E,0FAA0F;IAC1F,2EAA2E;IAC3E,0EAA0E;IAC1E,4EAA4E;IAC5E,2EAA2E;IAC3E,4DAA4D;IAC5D,qEAAqE;IACrE,MAAM,aAAa,GACjB,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,qDAAyB,EAAC,OAAO,CAAC,CAAC;IAC1E,IACE,QAAQ,KAAK,SAAS;QACtB,YAAY,CAAC,UAAU,KAAK,SAAS;QACrC,cAAc,KAAK,SAAS;QAC5B,cAAc,KAAK,aAAa;QAChC,qBAAqB,CAAC,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,EACvD,CAAC;QACD,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE;YACnC,YAAY,EAAE,EAAE,GAAG,YAAY,EAAE;YACjC,QAAQ,EAAE,aAAa;SACxB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAOD,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAuC,CAAC;AAE9E,gFAAgF;AAChF,SAAS,qBAAqB,CAAC,SAAiB,EAAE,UAAkB;IAClE,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,iBAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,eAAe,GAAG,iBAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO,CACL,CAAC,cAAc,CAAC,GAAG,KAAK,EAAE;YACxB,cAAc,CAAC,GAAG,KAAK,eAAe,CAAC,GAAG;YAC1C,cAAc,CAAC,GAAG,KAAK,eAAe,CAAC,GAAG,CAAC;YAC7C,iBAAE,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,iBAAE,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CACzE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,SAAS,yBAAyB,CAChC,OAAe,EACf,GAAsB;IAEtB,IACE,CAAC,mBAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QACzB,uCAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE;QAEpD,OAAO,SAAS,CAAC;IACnB,OAAO,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"javascriptRuntimeCapabilities.js","sourceRoot":"","sources":["../../src/internal/javascriptRuntimeCapabilities.ts"],"names":[],"mappings":";;;;;;AAAA,4EAA8C;AAC9C,sDAAyB;AACzB,0DAA6B;AAE7B,oFAAiF;AACjF,2FAAwF;AAExF,mFAAgF;AAChF,yCAAsC;AAEtC,uEAAoE;AACpE,uEAAoE;AACpE,2EAAwE;AACxE,+EAA4E;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,uCACE,OAAe,EACf,GAAsB,EACtB,GAAW,EACX,UAA0C;IAE1C,MAAM,YAAY,GAAG,uCAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,yBAAyB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,cAAc,GAClB,QAAQ,KAAK,SAAS;QACpB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAA,qDAAyB,EAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACrD,IAAI,QAAQ,KAAK,SAAS,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,MAAM,EAAE,QAAQ,KAAK,cAAc;YAAE,OAAO,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QAC3E,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,yEAAyE;QACzE,2EAA2E;QAC3E,qDAAqD;QACrD,MAAM,QAAQ,GAAG,oBAAoB,CACnC,qCAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,EAAE;YACvD,QAAQ;YACR,cAAc;SACf,CAAC,EACF,OAAO,CACR,CAAC;QACF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE;gBACnC,YAAY,EAAE,EAAE,GAAG,QAAQ,EAAE;gBAC7B,QAAQ,EAAE,cAAc;aACzB,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,oNAAoN;KACrN,CAAC;IACF,MAAM,OAAO,GAAG;QACd,GAAG;QACH,QAAQ,EAAE,MAAe;QACzB,GAAG,EAAE,YAAY;QACjB,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,IAAI;KAClB,CAAC;IACF,IAAI,MAAM,GAAG,mBAAQ,CAAC,WAAW,CAC/B,OAAO,EACP,IAAI,EACJ,OAAO,EACP,0BAA0B,EAC1B,GAAG,EAAE,CACH,iDAAuB,CAAC,MAAM,CAAS,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;QAC9D,4BAAY,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CACjD,CAAC;IACF,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAA,iDAAuB,EAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAA,2CAAoB,GAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,yDAA2B,EAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;gBAClE,MAAM,EAAE,OAAO,CAAC,UAAU;gBAC1B,MAAM,EAAE,OAAO,CAAC,UAAU;aAC3B,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAW,CAAC;YACxD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAW,CAAC;YACxD,MAAM,GAAG;gBACP,GAAG,OAAO;gBACV,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC;gBAC9B,MAAM;gBACN,MAAM;aACP,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,YAAY,GAAmC;QACjD,GAAG,EAAE,KAAK;QACV,aAAa,EAAE,KAAK;KACrB,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,CAAC,MAAM,CAC6B,CAAC;YAC7C,YAAY,GAAG;gBACb,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,IAAI;gBACxB,GAAG,CAAC,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;oBACzC,mBAAI,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC;oBAChC,CAAC,CAAC,EAAE,UAAU,EAAE,mBAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;oBACjD,CAAC,CAAC,EAAE,CAAC;gBACP,aAAa,EAAE,MAAM,CAAC,aAAa,KAAK,IAAI;aAC7C,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;IACH,CAAC;IACD,6EAA6E;IAC7E,2EAA2E;IAC3E,0FAA0F;IAC1F,2EAA2E;IAC3E,0EAA0E;IAC1E,4EAA4E;IAC5E,2EAA2E;IAC3E,4DAA4D;IAC5D,qEAAqE;IACrE,MAAM,aAAa,GACjB,QAAQ,KAAK,SAAS;QACpB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAA,qDAAyB,EAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACrD,IACE,QAAQ,KAAK,SAAS;QACtB,YAAY,CAAC,UAAU,KAAK,SAAS;QACrC,cAAc,KAAK,SAAS;QAC5B,cAAc,KAAK,aAAa;QAChC,qBAAqB,CAAC,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,EACvD,CAAC;QACD,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE;YACnC,YAAY,EAAE,EAAE,GAAG,YAAY,EAAE;YACjC,QAAQ,EAAE,aAAa;SACxB,CAAC,CAAC;QACH,qCAAiB,CAAC,KAAK,CACrB,UAAU,EACV,oBAAoB,EACpB,CAAC,QAAQ,EAAE,aAAa,CAAC,EACzB,YAAY,CACb,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,4EAA4E;AAC5E,MAAM,oBAAoB,GAAG,iCAAiC,CAAC;AAE/D;;;GAGG;AACH,SAAS,oBAAoB,CAC3B,KAAc,EACd,OAAe;IAEf,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,QAAQ,GAAG,KAAgD,CAAC;IAClE,IACE,OAAO,QAAQ,CAAC,GAAG,KAAK,SAAS;QACjC,OAAO,QAAQ,CAAC,aAAa,KAAK,SAAS;QAC3C,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ;QACvC,CAAC,mBAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC;QACrC,CAAC,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC;QAEpD,OAAO,SAAS,CAAC;IACnB,OAAO;QACL,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,aAAa,EAAE,QAAQ,CAAC,aAAa;KACtC,CAAC;AACJ,CAAC;AAOD,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAuC,CAAC;AAE9E,gFAAgF;AAChF,SAAS,qBAAqB,CAAC,SAAiB,EAAE,UAAkB;IAClE,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,iBAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,eAAe,GAAG,iBAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO,CACL,CAAC,cAAc,CAAC,GAAG,KAAK,EAAE;YACxB,cAAc,CAAC,GAAG,KAAK,eAAe,CAAC,GAAG;YAC1C,cAAc,CAAC,GAAG,KAAK,eAAe,CAAC,GAAG,CAAC;YAC7C,iBAAE,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,iBAAE,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CACzE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,SAAS,yBAAyB,CAChC,OAAe,EACf,GAAsB;IAEtB,IACE,CAAC,mBAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QACzB,uCAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE;QAEpD,OAAO,SAAS,CAAC;IACnB,OAAO,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/lib/internal/pluginSource.d.ts

@@ -22,5 +22,6 @@ export * from "../plugin/internal/source/pluginSourceDigest";
 export * from "../plugin/internal/source/pluginSourceState";
 export * from "../plugin/internal/source/pluginSourceStateHolds";
 export * from "../plugin/internal/source/processPluginBuildEnvironment";
+export * from "../plugin/internal/source/provenPluginSourceDigest";
 export * from "../plugin/internal/source/PluginBuildEnvironmentReadings";
 export * from "../plugin/internal/source/prunesPluginSourceDirectory";

package/lib/internal/pluginSource.js

@@ -38,6 +38,7 @@ __exportStar(require("../plugin/internal/source/pluginSourceDigest"), exports);
 __exportStar(require("../plugin/internal/source/pluginSourceState"), exports);
 __exportStar(require("../plugin/internal/source/pluginSourceStateHolds"), exports);
 __exportStar(require("../plugin/internal/source/processPluginBuildEnvironment"), exports);
+__exportStar(require("../plugin/internal/source/provenPluginSourceDigest"), exports);
 __exportStar(require("../plugin/internal/source/PluginBuildEnvironmentReadings"), exports);
 __exportStar(require("../plugin/internal/source/prunesPluginSourceDirectory"), exports);
 //# sourceMappingURL=pluginSource.js.map

package/lib/internal/pluginSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"pluginSource.js","sourceRoot":"","sources":["../../src/internal/pluginSource.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;GAeG;AACH,qFAAmE;AACnE,gFAA8D;AAC9D,+EAA6D;AAC7D,uFAAqE;AACrE,+EAA6D;AAC7D,8EAA4D;AAC5D,mFAAiE;AACjE,0FAAwE;AACxE,2FAAyE;AACzE,wFAAsE"}
+{"version":3,"file":"pluginSource.js","sourceRoot":"","sources":["../../src/internal/pluginSource.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;GAeG;AACH,qFAAmE;AACnE,gFAA8D;AAC9D,+EAA6D;AAC7D,uFAAqE;AACrE,+EAA6D;AAC7D,8EAA4D;AAC5D,mFAAiE;AACjE,0FAAwE;AACxE,qFAAmE;AACnE,2FAAyE;AACzE,wFAAsE"}

package/lib/internal/resolveNodeBinary.d.ts

@@ -1,9 +1,14 @@
+import type { PluginContentIdentities } from "../plugin/internal/source/PluginContentIdentities";
 /**
  * Locate a real Node runtime for ttsx and native JavaScript config loaders.
  *
  * Bun can directly evaluate a descriptor, but it does not implement the
  * synchronous `module.registerHooks` contract used by those loaders.
  *
+ * @param env Effective environment naming `TTSC_NODE_BINARY`.
+ * @param cwd Working directory of the probes.
+ * @param identities Optional record store that lets probes of an unchanged
+ *   runtime be answered across processes (#1723).
  * @evidence contracts/common.md#principled-implementation Ordered candidates are accepted only after an actual runtime probe reports non-Bun registerHooks support and its absolute executable; names alone do not establish the loader capability.
  * @evidence contracts/common.md#clear-and-simple-design Candidate precedence and duplicate suppression remain here, while the shared probe owns launch, capability parsing and freshness policy.
  * @evidence contracts/common.md#prohibited-implementation-shortcuts The node spelling is a supported final discovery candidate, not an assumed successful runtime; incompatible candidates are skipped without patching modules or globals.
@@ -13,4 +18,4 @@
  * @evidence contracts/performance.md#efficient-algorithms At most four candidate slots are inspected with first-usable short-circuiting and exact-spelling deduplication. Environment-key/spelling work and delegated executable-byte identity, environment merge, native probing/parsing or descriptor-exhaustion retry costs dominate; four slots do not bound executable bytes, output text or native work.
  * @evidence contracts/performance.md#reuse-equivalent-work Exact duplicate spellings share one candidate probe within this call. The probe owner additionally reuses stable absolute same-executable capabilities only while byte/link/target identity and no-preload authority hold; relative, wrapper, changed and unproven failed candidates need fresh observation.
  */
-export declare function resolveNodeBinary(env?: NodeJS.ProcessEnv, cwd?: string): string | undefined;
+export declare function resolveNodeBinary(env?: NodeJS.ProcessEnv, cwd?: string, identities?: PluginContentIdentities.Store): string | undefined;

package/lib/internal/resolveNodeBinary.js

@@ -9,6 +9,10 @@ const javascriptRuntimeCapabilities_1 = require("./javascriptRuntimeCapabilities
  * Bun can directly evaluate a descriptor, but it does not implement the
  * synchronous `module.registerHooks` contract used by those loaders.
  *
+ * @param env Effective environment naming `TTSC_NODE_BINARY`.
+ * @param cwd Working directory of the probes.
+ * @param identities Optional record store that lets probes of an unchanged
+ *   runtime be answered across processes (#1723).
  * @evidence contracts/common.md#principled-implementation Ordered candidates are accepted only after an actual runtime probe reports non-Bun registerHooks support and its absolute executable; names alone do not establish the loader capability.
  * @evidence contracts/common.md#clear-and-simple-design Candidate precedence and duplicate suppression remain here, while the shared probe owns launch, capability parsing and freshness policy.
  * @evidence contracts/common.md#prohibited-implementation-shortcuts The node spelling is a supported final discovery candidate, not an assumed successful runtime; incompatible candidates are skipped without patching modules or globals.
@@ -18,7 +22,7 @@ const javascriptRuntimeCapabilities_1 = require("./javascriptRuntimeCapabilities
  * @evidence contracts/performance.md#efficient-algorithms At most four candidate slots are inspected with first-usable short-circuiting and exact-spelling deduplication. Environment-key/spelling work and delegated executable-byte identity, environment merge, native probing/parsing or descriptor-exhaustion retry costs dominate; four slots do not bound executable bytes, output text or native work.
  * @evidence contracts/performance.md#reuse-equivalent-work Exact duplicate spellings share one candidate probe within this call. The probe owner additionally reuses stable absolute same-executable capabilities only while byte/link/target identity and no-preload authority hold; relative, wrapper, changed and unproven failed candidates need fresh observation.
  */
-function resolveNodeBinary(env = process.env, cwd = process.cwd()) {
+function resolveNodeBinary(env = process.env, cwd = process.cwd(), identities) {
     const candidates = [
         SidecarEnvironment_1.SidecarEnvironment.read(env, "TTSC_NODE_BINARY"),
         SidecarEnvironment_1.SidecarEnvironment.read(process.env, "TTSC_NODE_BINARY"),
@@ -32,7 +36,7 @@ function resolveNodeBinary(env = process.env, cwd = process.cwd()) {
         if (seen.has(candidate))
             continue;
         seen.add(candidate);
-        const capabilities = (0, javascriptRuntimeCapabilities_1.javascriptRuntimeCapabilities)(candidate, env, cwd);
+        const capabilities = (0, javascriptRuntimeCapabilities_1.javascriptRuntimeCapabilities)(candidate, env, cwd, identities);
         if (!capabilities.bun &&
             capabilities.registerHooks &&
             capabilities.executable !== undefined) {

package/lib/internal/resolveNodeBinary.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveNodeBinary.js","sourceRoot":"","sources":["../../src/internal/resolveNodeBinary.ts"],"names":[],"mappings":";;;AAAA,2FAAwF;AACxF,mFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,2BACE,GAAG,GAAsB,OAAO,CAAC,GAAG,EACpC,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE;IAE3B,MAAM,UAAU,GAAG;QACjB,uCAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC;QAChD,uCAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,kBAAkB,CAAC;QACxD,OAAO,CAAC,QAAQ;QAChB,MAAM;KACP,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QACjE,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpB,MAAM,YAAY,GAAG,IAAA,6DAA6B,EAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACxE,IACE,CAAC,YAAY,CAAC,GAAG;YACjB,YAAY,CAAC,aAAa;YAC1B,YAAY,CAAC,UAAU,KAAK,SAAS,EACrC,CAAC;YACD,OAAO,YAAY,CAAC,UAAU,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"resolveNodeBinary.js","sourceRoot":"","sources":["../../src/internal/resolveNodeBinary.ts"],"names":[],"mappings":";;;AAAA,2FAAwF;AAExF,mFAAgF;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,2BACE,GAAG,GAAsB,OAAO,CAAC,GAAG,EACpC,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE,EAC3B,UAA0C;IAE1C,MAAM,UAAU,GAAG;QACjB,uCAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC;QAChD,uCAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,kBAAkB,CAAC;QACxD,OAAO,CAAC,QAAQ;QAChB,MAAM;KACP,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QACjE,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpB,MAAM,YAAY,GAAG,IAAA,6DAA6B,EAChD,SAAS,EACT,GAAG,EACH,GAAG,EACH,UAAU,CACX,CAAC;QACF,IACE,CAAC,YAAY,CAAC,GAAG;YACjB,YAAY,CAAC,aAAa;YAC1B,YAAY,CAAC,UAAU,KAAK,SAAS,EACrC,CAAC;YACD,OAAO,YAAY,CAAC,UAAU,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/internal/runtimeExecutableIdentity.d.ts

@@ -1,20 +1,29 @@
+import { PluginContentIdentities } from "../plugin/internal/source/PluginContentIdentities";
 /**
  * Fingerprint an absolute executable's spelling, target and actual bytes.
  *
  * A changed link, file, or read failure yields no reusable identity. Metadata
- * brackets the streamed read; it is not used to reuse an earlier content hash.
- * Concurrent writes that evade every filesystem observation remain outside this
- * snapshot guarantee.
+ * brackets the streamed read. Concurrent writes that evade every filesystem
+ * observation remain outside this snapshot guarantee.
  *
- * @evidence contracts/common.md#principled-implementation The identity joins lexical-link metadata, the selected physical file metadata and SHA-256 of that opened file; matching metadata alone cannot authorize reuse after bytes change. Descriptor and pathname observations must still agree after reading.
- * @evidence contracts/common.md#clear-and-simple-design This one native owner supplies the same content proof to runtime capability and plugin caches; callers decide whether their other inputs permit reuse.
- * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported Node filesystem and crypto APIs inspect the actual candidate; no fixture identity, foreign mutation or metadata-only shortcut substitutes for content.
- * @evidence contracts/common.md#meaningful-documentation Native prose explains absolute-path scope, failure meaning, hash freshness and the remaining concurrent-mutation limitation, with separate prose and tags.
- * @evidence contracts/portability.md#os-neutral-implementation Node native realpath and bigint stat preserve link/target identity on supported hosts; absolute paths use native platform semantics, and unreadable or non-regular targets cannot be reused.
- * @evidence contracts/performance.md#efficient-algorithms A sequential read hashes B bytes with one 64 KiB buffer instead of a complete executable allocation. Native path/realpath/stat observations and serialized physical spelling/metadata add text/lookup costs; B and spelling lengths have no quota here. Returned identity storage includes the physical path as well as the fixed-length digest.
- *
- * @evidenceExclude contracts/performance.md#reuse-equivalent-work This operation establishes whether later work is equivalent; retaining a digest by metadata would reproduce the stale-byte defect it must prevent.
+ * With a record store, the bytes of an unchanged executable are proven from its
+ * metadata instead of streamed again (`PluginContentIdentities`, #1723): the
+ * recorded digest stands only while the physical file's identity, size and both
+ * stamps match the record and its modification stamp is separable from a
+ * reference the store minted. A plugin load asks for this identity several
+ * times, and every launch is a new process, so streaming an 85 MB runtime each
+ * time cost about 0.9 s per launch. Without a store, or when that proof is
+ * unavailable, the file is streamed as before.
  *
- * @evidence contracts/performance.md#bound-retention-and-release-resources One descriptor and one fixed buffer belong to this synchronous call; finally attempts closure after read/observation failures as well as success. A close failure returns no identity but cannot confirm native release. Returned path/metadata/digest text transfers to the caller and no helper history survives. Opt-in opened/closed/close-failed observations carry one trace-only call id and actual descriptor, PID/thread and already observed physical identity. The existing finally performs the single close; no observer retries it or converts an unavailable identity to success. An observed close is release of this Node descriptor, not proof that an OS image lock or another actor has released the executable.
+ * @param runtime The executable, absolute.
+ * @param identities Optional record store of the caller's plugin cache.
+ * @evidence contracts/common.md#principled-implementation The identity joins lexical-link metadata, the selected physical file metadata and the SHA-256 of that file's bytes, streamed under metadata brackets or proven by a record whose separable signature still matches; descriptor and pathname observations must still agree after a read.
+ * @evidence contracts/common.md#clear-and-simple-design This one native owner supplies the same identity to runtime capability and plugin caches; the record store owns metadata reuse and a private helper owns the bracketed stream.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Metadata alone never stands for bytes: reuse needs a record written under unchanged separable metadata around an actual read, which a same-tick rewrite or restored timestamps cannot satisfy because change time and the minted reference move.
+ * @evidence contracts/common.md#meaningful-documentation Native prose explains absolute-path scope, failure meaning, the record proof and the remaining concurrent-mutation limitation, with separate prose and tags.
+ * @evidence contracts/portability.md#os-neutral-implementation Node native realpath and bigint stat preserve link/target identity on supported hosts; absolute paths use native platform semantics, and unreadable or non-regular targets cannot be reused.
+ * @evidence contracts/performance.md#efficient-algorithms A proven record costs three stats and one small file read; otherwise a sequential read hashes B bytes with one 64 KiB buffer instead of a complete executable allocation. Native path/realpath/stat observations and serialized metadata add text/lookup costs.
+ * @evidence contracts/performance.md#reuse-equivalent-work Processes share an executable digest only through the record store's separable-signature proof; without a store every call streams the file.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources One descriptor and one fixed buffer belong to a streamed read; finally attempts closure after read/observation failures as well as success. A close failure returns no identity but cannot confirm native release. Opt-in opened/closed/close-failed observations carry one trace-only call id and actual descriptor, PID/thread and already observed physical identity. Records belong to the single-file collector.
  */
-export declare function runtimeExecutableIdentity(runtime: string): string | undefined;
+export declare function runtimeExecutableIdentity(runtime: string, identities?: PluginContentIdentities.Store): string | undefined;

package/lib/internal/runtimeExecutableIdentity.js

@@ -8,55 +8,41 @@ const node_crypto_1 = __importDefault(require("node:crypto"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_worker_threads_1 = require("node:worker_threads");
+const PluginContentIdentities_1 = require("../plugin/internal/source/PluginContentIdentities");
 const E2ETrace_1 = require("./E2ETrace");
 /**
  * Fingerprint an absolute executable's spelling, target and actual bytes.
  *
  * A changed link, file, or read failure yields no reusable identity. Metadata
- * brackets the streamed read; it is not used to reuse an earlier content hash.
- * Concurrent writes that evade every filesystem observation remain outside this
- * snapshot guarantee.
+ * brackets the streamed read. Concurrent writes that evade every filesystem
+ * observation remain outside this snapshot guarantee.
  *
- * @evidence contracts/common.md#principled-implementation The identity joins lexical-link metadata, the selected physical file metadata and SHA-256 of that opened file; matching metadata alone cannot authorize reuse after bytes change. Descriptor and pathname observations must still agree after reading.
- * @evidence contracts/common.md#clear-and-simple-design This one native owner supplies the same content proof to runtime capability and plugin caches; callers decide whether their other inputs permit reuse.
- * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported Node filesystem and crypto APIs inspect the actual candidate; no fixture identity, foreign mutation or metadata-only shortcut substitutes for content.
- * @evidence contracts/common.md#meaningful-documentation Native prose explains absolute-path scope, failure meaning, hash freshness and the remaining concurrent-mutation limitation, with separate prose and tags.
- * @evidence contracts/portability.md#os-neutral-implementation Node native realpath and bigint stat preserve link/target identity on supported hosts; absolute paths use native platform semantics, and unreadable or non-regular targets cannot be reused.
- * @evidence contracts/performance.md#efficient-algorithms A sequential read hashes B bytes with one 64 KiB buffer instead of a complete executable allocation. Native path/realpath/stat observations and serialized physical spelling/metadata add text/lookup costs; B and spelling lengths have no quota here. Returned identity storage includes the physical path as well as the fixed-length digest.
- *
- * @evidenceExclude contracts/performance.md#reuse-equivalent-work This operation establishes whether later work is equivalent; retaining a digest by metadata would reproduce the stale-byte defect it must prevent.
+ * With a record store, the bytes of an unchanged executable are proven from its
+ * metadata instead of streamed again (`PluginContentIdentities`, #1723): the
+ * recorded digest stands only while the physical file's identity, size and both
+ * stamps match the record and its modification stamp is separable from a
+ * reference the store minted. A plugin load asks for this identity several
+ * times, and every launch is a new process, so streaming an 85 MB runtime each
+ * time cost about 0.9 s per launch. Without a store, or when that proof is
+ * unavailable, the file is streamed as before.
  *
- * @evidence contracts/performance.md#bound-retention-and-release-resources One descriptor and one fixed buffer belong to this synchronous call; finally attempts closure after read/observation failures as well as success. A close failure returns no identity but cannot confirm native release. Returned path/metadata/digest text transfers to the caller and no helper history survives. Opt-in opened/closed/close-failed observations carry one trace-only call id and actual descriptor, PID/thread and already observed physical identity. The existing finally performs the single close; no observer retries it or converts an unavailable identity to success. An observed close is release of this Node descriptor, not proof that an OS image lock or another actor has released the executable.
+ * @param runtime The executable, absolute.
+ * @param identities Optional record store of the caller's plugin cache.
+ * @evidence contracts/common.md#principled-implementation The identity joins lexical-link metadata, the selected physical file metadata and the SHA-256 of that file's bytes, streamed under metadata brackets or proven by a record whose separable signature still matches; descriptor and pathname observations must still agree after a read.
+ * @evidence contracts/common.md#clear-and-simple-design This one native owner supplies the same identity to runtime capability and plugin caches; the record store owns metadata reuse and a private helper owns the bracketed stream.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Metadata alone never stands for bytes: reuse needs a record written under unchanged separable metadata around an actual read, which a same-tick rewrite or restored timestamps cannot satisfy because change time and the minted reference move.
+ * @evidence contracts/common.md#meaningful-documentation Native prose explains absolute-path scope, failure meaning, the record proof and the remaining concurrent-mutation limitation, with separate prose and tags.
+ * @evidence contracts/portability.md#os-neutral-implementation Node native realpath and bigint stat preserve link/target identity on supported hosts; absolute paths use native platform semantics, and unreadable or non-regular targets cannot be reused.
+ * @evidence contracts/performance.md#efficient-algorithms A proven record costs three stats and one small file read; otherwise a sequential read hashes B bytes with one 64 KiB buffer instead of a complete executable allocation. Native path/realpath/stat observations and serialized metadata add text/lookup costs.
+ * @evidence contracts/performance.md#reuse-equivalent-work Processes share an executable digest only through the record store's separable-signature proof; without a store every call streams the file.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources One descriptor and one fixed buffer belong to a streamed read; finally attempts closure after read/observation failures as well as success. A close failure returns no identity but cannot confirm native release. Opt-in opened/closed/close-failed observations carry one trace-only call id and actual descriptor, PID/thread and already observed physical identity. Records belong to the single-file collector.
  */
-function runtimeExecutableIdentity(runtime) {
+function runtimeExecutableIdentity(runtime, identities) {
     if (!node_path_1.default.isAbsolute(runtime))
         return undefined;
     const startedAt = new Date().toISOString();
-    let descriptor;
-    let traceLease;
     let stage = "lexical-stat";
-    const unavailable = (reason, expected, observed, observations) => {
-        E2ETrace_1.E2ETrace.capabilityResolution("runtime-executable-identity-unavailable", {
-            runtime,
-            stage,
-            reason,
-            expected,
-            observed,
-            expectedAtimeNs: observations === undefined
-                ? undefined
-                : String(observations.before.atimeNs),
-            observedAtimeNs: observations === undefined
-                ? undefined
-                : String(observations.after.atimeNs),
-            expectedBirthtimeNs: observations === undefined
-                ? undefined
-                : String(observations.before.birthtimeNs),
-            observedBirthtimeNs: observations === undefined
-                ? undefined
-                : String(observations.after.birthtimeNs),
-        });
-        return undefined;
-    };
+    let refused;
     try {
         const lexical = node_fs_1.default.lstatSync(runtime, { bigint: true });
         stage = "physical-realpath";
@@ -64,68 +50,23 @@ function runtimeExecutableIdentity(runtime) {
         stage = "physical-stat";
         const physical = node_fs_1.default.statSync(physicalPath, { bigint: true });
         if (!physical.isFile())
-            return unavailable("not-regular", undefined, fileIdentity(physical));
-        stage = "open";
-        descriptor = node_fs_1.default.openSync(physicalPath, "r");
-        if (process.env.TTSC_E2E_TRACE) {
-            traceLease = {
-                callId: String(++identityTraceOrdinal),
-                runtime,
-                physicalPath,
-                descriptor,
-                pid: process.pid,
-                threadId: node_worker_threads_1.threadId,
-                dev: String(physical.dev),
-                ino: String(physical.ino),
-            };
-            E2ETrace_1.E2ETrace.capabilityResolution("runtime-executable-identity-opened", traceLease);
-        }
-        stage = "opened-stat";
-        const opened = node_fs_1.default.fstatSync(descriptor, { bigint: true });
-        if (fileIdentity(opened) !== fileIdentity(physical))
-            return unavailable("opened-file-changed", fileIdentity(physical), fileIdentity(opened));
-        const hash = node_crypto_1.default.createHash("sha256");
-        const buffer = Buffer.allocUnsafe(64 * 1024);
-        let remaining = opened.size;
-        stage = "read";
-        while (remaining > 0n) {
-            const requested = remaining > BigInt(buffer.length) ? buffer.length : Number(remaining);
-            const length = node_fs_1.default.readSync(descriptor, buffer, 0, requested, null);
-            if (length === 0)
-                return unavailable("premature-eof", String(opened.size), String(opened.size - remaining));
-            hash.update(buffer.subarray(0, length));
-            remaining -= BigInt(length);
-        }
-        stage = "post-read-opened-stat";
-        const afterOpened = node_fs_1.default.fstatSync(descriptor, { bigint: true });
-        if (fileIdentity(afterOpened) !== fileIdentity(opened))
-            return unavailable("opened-file-changed-during-read", fileIdentity(opened), fileIdentity(afterOpened), { before: opened, after: afterOpened });
-        stage = "post-read-realpath";
-        const afterPath = node_fs_1.default.realpathSync.native(runtime);
-        if (afterPath !== physicalPath)
-            return unavailable("physical-target-changed", physicalPath, afterPath);
-        stage = "post-read-lexical-stat";
-        const afterLexical = node_fs_1.default.lstatSync(runtime, { bigint: true });
-        if (fileIdentity(afterLexical) !== fileIdentity(lexical))
-            return unavailable("lexical-file-changed-during-read", fileIdentity(lexical), fileIdentity(afterLexical));
-        stage = "post-read-physical-stat";
-        const afterPhysical = node_fs_1.default.statSync(physicalPath, { bigint: true });
-        if (fileIdentity(afterPhysical) !== fileIdentity(physical))
-            return unavailable("physical-file-changed-during-read", fileIdentity(physical), fileIdentity(afterPhysical));
-        const digest = hash.digest("hex");
-        E2ETrace_1.E2ETrace.capabilityResolution("runtime-executable-identity-observed", {
-            runtime,
-            physicalPath,
-            startedAt,
-            finishedAt: new Date().toISOString(),
-            lexical: fileIdentity(lexical),
-            physical: fileIdentity(physical),
-            digest,
-            openedAtimeNs: String(opened.atimeNs),
-            afterOpenedAtimeNs: String(afterOpened.atimeNs),
-            openedBirthtimeNs: String(opened.birthtimeNs),
-            afterOpenedBirthtimeNs: String(afterOpened.birthtimeNs),
-        });
+            return unavailable(runtime, {
+                stage,
+                reason: "not-regular",
+                observed: fileIdentity(physical),
+            });
+        const read = () => {
+            const streamed = streamDigest(runtime, physicalPath, physical, lexical, {
+                startedAt,
+            });
+            if (typeof streamed === "string")
+                return streamed;
+            refused = streamed;
+            throw new Error(streamed.reason);
+        };
+        const digest = identities === undefined
+            ? read()
+            : PluginContentIdentities_1.PluginContentIdentities.digest(identities, "executable", physicalPath, (references) => PluginContentIdentities_1.PluginContentIdentities.fileObservation(references, physicalPath), read);
         return [
             physicalPath,
             fileIdentity(lexical),
@@ -134,7 +75,48 @@ function runtimeExecutableIdentity(runtime) {
         ].join("\0");
     }
     catch (error) {
-        return unavailable("filesystem-error", undefined, error instanceof Error ? error.message : String(error));
+        return unavailable(runtime, refused ?? {
+            stage,
+            reason: "filesystem-error",
+            observed: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+function unavailable(runtime, failure) {
+    E2ETrace_1.E2ETrace.capabilityResolution("runtime-executable-identity-unavailable", {
+        runtime,
+        stage: failure.stage,
+        reason: failure.reason,
+        expected: failure.expected,
+        observed: failure.observed,
+        expectedAtimeNs: failure.observations === undefined
+            ? undefined
+            : String(failure.observations.before.atimeNs),
+        observedAtimeNs: failure.observations === undefined
+            ? undefined
+            : String(failure.observations.after.atimeNs),
+        expectedBirthtimeNs: failure.observations === undefined
+            ? undefined
+            : String(failure.observations.before.birthtimeNs),
+        observedBirthtimeNs: failure.observations === undefined
+            ? undefined
+            : String(failure.observations.after.birthtimeNs),
+    });
+    return undefined;
+}
+/**
+ * Stream the physical file's bytes between metadata observations of the open
+ * descriptor, the physical path and the lexical spelling, returning the digest
+ * or what moved. The descriptor is closed in finally; a failed close refuses
+ * the identity.
+ */
+function streamDigest(runtime, physicalPath, physical, lexical, timing) {
+    let stage = "open";
+    let descriptor;
+    let traceLease;
+    let result;
+    try {
+        result = observe();
     }
     finally {
         if (descriptor !== undefined) {
@@ -149,11 +131,119 @@ function runtimeExecutableIdentity(runtime) {
                         ...traceLease,
                         error: error instanceof Error ? error.message : String(error),
                     });
-                stage = "close";
-                return unavailable("descriptor-close-error", undefined, error instanceof Error ? error.message : String(error));
+                // A digest whose descriptor could not be closed is refused, as before.
+                result = {
+                    stage: "close",
+                    reason: "descriptor-close-error",
+                    observed: error instanceof Error ? error.message : String(error),
+                };
             }
         }
     }
+    return result;
+    function observe() {
+        try {
+            descriptor = node_fs_1.default.openSync(physicalPath, "r");
+            if (process.env.TTSC_E2E_TRACE) {
+                traceLease = {
+                    callId: String(++identityTraceOrdinal),
+                    runtime,
+                    physicalPath,
+                    descriptor,
+                    pid: process.pid,
+                    threadId: node_worker_threads_1.threadId,
+                    dev: String(physical.dev),
+                    ino: String(physical.ino),
+                };
+                E2ETrace_1.E2ETrace.capabilityResolution("runtime-executable-identity-opened", traceLease);
+            }
+            stage = "opened-stat";
+            const opened = node_fs_1.default.fstatSync(descriptor, { bigint: true });
+            if (fileIdentity(opened) !== fileIdentity(physical))
+                return {
+                    stage,
+                    reason: "opened-file-changed",
+                    expected: fileIdentity(physical),
+                    observed: fileIdentity(opened),
+                };
+            const hash = node_crypto_1.default.createHash("sha256");
+            const buffer = Buffer.allocUnsafe(64 * 1024);
+            let remaining = opened.size;
+            stage = "read";
+            while (remaining > 0n) {
+                const requested = remaining > BigInt(buffer.length) ? buffer.length : Number(remaining);
+                const length = node_fs_1.default.readSync(descriptor, buffer, 0, requested, null);
+                if (length === 0)
+                    return {
+                        stage,
+                        reason: "premature-eof",
+                        expected: String(opened.size),
+                        observed: String(opened.size - remaining),
+                    };
+                hash.update(buffer.subarray(0, length));
+                remaining -= BigInt(length);
+            }
+            stage = "post-read-opened-stat";
+            const afterOpened = node_fs_1.default.fstatSync(descriptor, { bigint: true });
+            if (fileIdentity(afterOpened) !== fileIdentity(opened))
+                return {
+                    stage,
+                    reason: "opened-file-changed-during-read",
+                    expected: fileIdentity(opened),
+                    observed: fileIdentity(afterOpened),
+                    observations: { before: opened, after: afterOpened },
+                };
+            stage = "post-read-realpath";
+            const afterPath = node_fs_1.default.realpathSync.native(runtime);
+            if (afterPath !== physicalPath)
+                return {
+                    stage,
+                    reason: "physical-target-changed",
+                    expected: physicalPath,
+                    observed: afterPath,
+                };
+            stage = "post-read-lexical-stat";
+            const afterLexical = node_fs_1.default.lstatSync(runtime, { bigint: true });
+            if (fileIdentity(afterLexical) !== fileIdentity(lexical))
+                return {
+                    stage,
+                    reason: "lexical-file-changed-during-read",
+                    expected: fileIdentity(lexical),
+                    observed: fileIdentity(afterLexical),
+                };
+            stage = "post-read-physical-stat";
+            const afterPhysical = node_fs_1.default.statSync(physicalPath, { bigint: true });
+            if (fileIdentity(afterPhysical) !== fileIdentity(physical))
+                return {
+                    stage,
+                    reason: "physical-file-changed-during-read",
+                    expected: fileIdentity(physical),
+                    observed: fileIdentity(afterPhysical),
+                };
+            const digest = hash.digest("hex");
+            E2ETrace_1.E2ETrace.capabilityResolution("runtime-executable-identity-observed", {
+                runtime,
+                physicalPath,
+                startedAt: timing.startedAt,
+                finishedAt: new Date().toISOString(),
+                lexical: fileIdentity(lexical),
+                physical: fileIdentity(physical),
+                digest,
+                openedAtimeNs: String(opened.atimeNs),
+                afterOpenedAtimeNs: String(afterOpened.atimeNs),
+                openedBirthtimeNs: String(opened.birthtimeNs),
+                afterOpenedBirthtimeNs: String(afterOpened.birthtimeNs),
+            });
+            return digest;
+        }
+        catch (error) {
+            return {
+                stage,
+                reason: "filesystem-error",
+                observed: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
 }
 // Trace-only ordinal distinguishes sequential uses of a reused descriptor.
 let identityTraceOrdinal = 0;