ttsc 0.31.1 → 0.31.3

package/lib/plugin/internal/readCapabilityResolution.js

@@ -5,9 +5,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readCapabilityResolution = readCapabilityResolution;
 const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
 const CapabilityResolutionFormat_1 = require("./CapabilityResolutionFormat");
 const hashHostInputPaths_1 = require("./load/hashHostInputPaths");
 const realpathHostInputPaths_1 = require("./load/realpathHostInputPaths");
+const PluginContentIdentities_1 = require("./source/PluginContentIdentities");
 const pluginSourceFilesSignature_1 = require("./source/pluginSourceFilesSignature");
 const pluginSourceStateHolds_1 = require("./source/pluginSourceStateHolds");
 const recordCacheFileUse_1 = require("./source/recordCacheFileUse");
@@ -70,10 +72,11 @@ function readCapabilityResolution(options) {
     // old one still exists.
     const sources = Object.entries(entry.pluginSources);
     const evidence = sources.some(([, source]) => source.signature !== undefined)
-        ? CapabilityResolutionFormat_1.CapabilityResolutionFormat.sourceEvidence(CapabilityResolutionFormat_1.CapabilityResolutionFormat.clockReference(file))
+        ? PluginContentIdentities_1.PluginContentIdentities.sourceEvidence(PluginContentIdentities_1.PluginContentIdentities.mintReference(node_path_1.default.dirname(file)))
         : undefined;
+    const projectRoot = node_path_1.default.resolve(options.cwd);
     for (const [directory, source] of sources)
-        if (!pluginSourceProven(directory, source, evidence))
+        if (!pluginSourceProven(directory, source, evidence, projectRoot))
             return null;
     for (const plugin of entry.plugins)
         if (!node_fs_1.default.existsSync(plugin.binary))
@@ -90,7 +93,7 @@ function readCapabilityResolution(options) {
  * tick, which only a fresh reference rules out. The build environment is proven
  * either way.
  */
-function pluginSourceProven(directory, source, evidence) {
+function pluginSourceProven(directory, source, evidence, projectRoot) {
     try {
         const now = source.signature === undefined || evidence === undefined
             ? undefined
@@ -99,8 +102,8 @@ function pluginSourceProven(directory, source, evidence) {
             now.separable &&
             now.signature === source.signature &&
             source.digest !== undefined
-            ? { sourceDigest: source.digest }
-            : {});
+            ? { projectRoot, sourceDigest: source.digest }
+            : { projectRoot });
     }
     catch {
         return false;

package/lib/plugin/internal/readCapabilityResolution.js.map

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

package/lib/plugin/internal/source/GoEnvironmentReading.d.ts

@@ -1,4 +1,5 @@
 import { PluginBuildEnvironmentWitness } from "./PluginBuildEnvironmentWitness";
+import type { PluginContentIdentities } from "./PluginContentIdentities";
 /**
  * Acquire current Go values together with their environment-file evidence.
  * Build digests and syntax readers share this owner; a file-location hint is
@@ -27,6 +28,11 @@ export declare namespace GoEnvironmentReading {
      * one witnessed. A file that keeps moving between runs leaves the reading
      * unwitnessable, so a kept reading or a build keyed on it never holds.
      *
+     * The location hint also comes from the record store when one is supplied, so
+     * a new process witnesses the right file on its first run instead of running
+     * `go env` once only to learn the name.
+     *
+     * @param identities Optional record store carrying the hint across processes.
      * @returns The parsed object, or `undefined` when native acquisition or JSON
      *   object decoding failed.
      * @evidence contracts/common.md#principled-implementation Actual Go supplies values and the environment-file path; pre-read metadata and bounded rediscovery preserve the earliest file witness instead of attaching a later state to an earlier read.
@@ -35,8 +41,8 @@ export declare namespace GoEnvironmentReading {
      * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain why file discovery can repeat and distinguish unavailable acquisition from current authority.
      * @evidence contracts/portability.md#os-neutral-implementation Go reports its actual environment-file location; native path metadata and the existing Go process owner supply observation and execution semantics.
      * @evidence contracts/performance.md#efficient-algorithms Hashing the complete tool/environment identity and up to three native Go queries process full name/value/output bytes. Requested keys contribute argument bytes; file discovery uses metadata rather than an SDK walk.
-     * @evidence contracts/performance.md#reuse-equivalent-work Only file-location discovery hints are shared across equal selected-tool/environment identities. Current Go values and file authority are reacquired for every call.
-     * @evidence contracts/performance.md#bound-retention-and-release-resources The module retains one file-location hint per historical tool/environment identity, without eviction, but no positive reading or native handle. Command capture/retirement belongs to spawnGoTool and the caller owns the transferred witness.
+     * @evidence contracts/performance.md#reuse-equivalent-work Only file-location discovery hints are shared: in process across equal selected-tool/environment identities, and through the record store across equal selected tools and location variables, since the reading verifies any hint against the file Go reports. Current Go values and file authority are reacquired for every call.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The module retains one file-location hint per historical tool/environment identity, without eviction, but no positive reading or native handle; persisted hints belong to the single-file collector. Command capture/retirement belongs to spawnGoTool and the caller owns the transferred witness.
      */
-    function read(goBinary: string, cwd: string, env: NodeJS.ProcessEnv, keys: readonly string[], witness: PluginBuildEnvironmentWitness.Record | undefined): Record<string, unknown> | undefined;
+    function read(goBinary: string, cwd: string, env: NodeJS.ProcessEnv, keys: readonly string[], witness: PluginBuildEnvironmentWitness.Record | undefined, identities?: PluginContentIdentities.Store): Record<string, unknown> | undefined;
 }

package/lib/plugin/internal/source/GoEnvironmentReading.js

@@ -5,8 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GoEnvironmentReading = void 0;
 const node_crypto_1 = __importDefault(require("node:crypto"));
+const SidecarEnvironment_1 = require("../../../compiler/internal/sharedHost/SidecarEnvironment");
 const GoSourceInputs_1 = require("./GoSourceInputs");
 const PluginBuildEnvironmentWitness_1 = require("./PluginBuildEnvironmentWitness");
+const PluginLoadAnswers_1 = require("./PluginLoadAnswers");
 const spawnGoTool_1 = require("./spawnGoTool");
 /**
  * Acquire current Go values together with their environment-file evidence.
@@ -29,6 +31,26 @@ var GoEnvironmentReading;
      * which lets a reading witness that file before `go env` reads it.
      */
     const goEnvironmentFiles = new Map();
+    /**
+     * Answer family that carries the same location hint across processes, so a
+     * new process does not run `go env` once merely to learn it (#1722). A wrong
+     * or stale hint only costs the existing rediscovery run.
+     */
+    const ENVIRONMENT_FILE_HINT = "go-environment-file";
+    /**
+     * What chooses the file's location: `GOENV`, else `os.UserConfigDir()`
+     * (`%AppData%`, `$XDG_CONFIG_HOME`, `$HOME`, Plan 9's `$home`). The hint
+     * across processes is keyed by these alone, because a launch rarely repeats
+     * every unrelated variable, such as a per-run trace path, and a hint that
+     * misses costs the rediscovery run on every launch.
+     */
+    const LOCATION_VARIABLES = [
+        "GOENV",
+        "APPDATA",
+        "XDG_CONFIG_HOME",
+        "HOME",
+        "home",
+    ];
     /**
      * Run `go env -json` for the requested keys and `GOENV`, the file `go env -w`
      * writes, witnessing that file before the run reads it.
@@ -42,6 +64,11 @@ var GoEnvironmentReading;
      * one witnessed. A file that keeps moving between runs leaves the reading
      * unwitnessable, so a kept reading or a build keyed on it never holds.
      *
+     * The location hint also comes from the record store when one is supplied, so
+     * a new process witnesses the right file on its first run instead of running
+     * `go env` once only to learn the name.
+     *
+     * @param identities Optional record store carrying the hint across processes.
      * @returns The parsed object, or `undefined` when native acquisition or JSON
      *   object decoding failed.
      * @evidence contracts/common.md#principled-implementation Actual Go supplies values and the environment-file path; pre-read metadata and bounded rediscovery preserve the earliest file witness instead of attaching a later state to an earlier read.
@@ -50,10 +77,10 @@ var GoEnvironmentReading;
      * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain why file discovery can repeat and distinguish unavailable acquisition from current authority.
      * @evidence contracts/portability.md#os-neutral-implementation Go reports its actual environment-file location; native path metadata and the existing Go process owner supply observation and execution semantics.
      * @evidence contracts/performance.md#efficient-algorithms Hashing the complete tool/environment identity and up to three native Go queries process full name/value/output bytes. Requested keys contribute argument bytes; file discovery uses metadata rather than an SDK walk.
-     * @evidence contracts/performance.md#reuse-equivalent-work Only file-location discovery hints are shared across equal selected-tool/environment identities. Current Go values and file authority are reacquired for every call.
-     * @evidence contracts/performance.md#bound-retention-and-release-resources The module retains one file-location hint per historical tool/environment identity, without eviction, but no positive reading or native handle. Command capture/retirement belongs to spawnGoTool and the caller owns the transferred witness.
+     * @evidence contracts/performance.md#reuse-equivalent-work Only file-location discovery hints are shared: in process across equal selected-tool/environment identities, and through the record store across equal selected tools and location variables, since the reading verifies any hint against the file Go reports. Current Go values and file authority are reacquired for every call.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The module retains one file-location hint per historical tool/environment identity, without eviction, but no positive reading or native handle; persisted hints belong to the single-file collector. Command capture/retirement belongs to spawnGoTool and the caller owns the transferred witness.
      */
-    function read(goBinary, cwd, env, keys, witness) {
+    function read(goBinary, cwd, env, keys, witness, identities) {
         const memo = node_crypto_1.default.createHash("sha256").update(goBinary);
         for (const [key, value] of Object.entries(env).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)) {
             if (value !== undefined)
@@ -61,6 +88,12 @@ var GoEnvironmentReading;
         }
         const memoKey = memo.digest("hex");
         let named = goEnvironmentFiles.get(memoKey);
+        if (named === undefined) {
+            const hinted = PluginLoadAnswers_1.PluginLoadAnswers.read(identities, ENVIRONMENT_FILE_HINT, hintKey(goBinary, env));
+            if (hinted === null || typeof hinted === "string")
+                named = hinted;
+        }
+        const remembered = named;
         for (let attempt = 0; attempt < 3; attempt += 1) {
             if (named !== undefined && named !== null)
                 PluginBuildEnvironmentWitness_1.PluginBuildEnvironmentWitness.add(witness, named);
@@ -89,22 +122,35 @@ var GoEnvironmentReading;
                 parsed.GOENV !== "off"
                 ? parsed.GOENV
                 : null;
-            if (reported === named)
+            if (reported === named) {
+                goEnvironmentFiles.set(memoKey, named);
+                if (named !== remembered)
+                    PluginLoadAnswers_1.PluginLoadAnswers.write(identities, ENVIRONMENT_FILE_HINT, hintKey(goBinary, env), named);
                 return parsed;
+            }
             if (named !== undefined && named !== null)
                 witness?.delete(named);
             named = reported;
             goEnvironmentFiles.set(memoKey, named);
             // No file to witness: the reading depends on none.
-            if (named === null)
-                return parsed;
-            if (witness === undefined)
+            if (named === null || witness === undefined) {
+                if (named !== remembered)
+                    PluginLoadAnswers_1.PluginLoadAnswers.write(identities, ENVIRONMENT_FILE_HINT, hintKey(goBinary, env), named);
                 return parsed;
+            }
         }
         if (named !== undefined && named !== null)
             PluginBuildEnvironmentWitness_1.PluginBuildEnvironmentWitness.refuse(witness, named);
         return undefined;
     }
     GoEnvironmentReading.read = read;
+    // A wrong hint is safe: the reading compares it with the `GOENV` Go reports
+    // and runs again with the reported file witnessed.
+    function hintKey(goBinary, env) {
+        return [
+            goBinary,
+            LOCATION_VARIABLES.map((name) => SidecarEnvironment_1.SidecarEnvironment.read(env, name) ?? null),
+        ];
+    }
 })(GoEnvironmentReading || (exports.GoEnvironmentReading = GoEnvironmentReading = {}));
 //# sourceMappingURL=GoEnvironmentReading.js.map

package/lib/plugin/internal/source/GoEnvironmentReading.js.map

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

package/lib/plugin/internal/source/NativeSourcePackages.d.ts

@@ -1,3 +1,5 @@
+import { PluginBuildEnvironmentWitness } from "./PluginBuildEnvironmentWitness";
+import { PluginContentIdentities } from "./PluginContentIdentities";
 import { SourcePluginWorkspace } from "./SourcePluginWorkspace";
 /**
  * Observe Go-selected packages under the native builder's workspace policy.
@@ -11,7 +13,7 @@ import { SourcePluginWorkspace } from "./SourcePluginWorkspace";
  * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes metadata selection from compilation and later materialized admission.
  * @evidence contracts/portability.md#os-neutral-implementation Native path/fs operations and the shared Go tool selector preserve environment-name and path identity without blanket case folding; Go itself applies target platform and cgo selection.
  * @evidence contracts/performance.md#efficient-algorithms One list command observes all distinct package entries in each prepared context. Context materialization traverses and copies admitted host/contributor files; workspace setup delegates manifest commands and list skips dependency loading. Framing and JSON parsing process complete output bytes, and retained results scale with selected packages/files.
- * @evidence contracts/performance.md#reuse-equivalent-work Entries are deduplicated within a contextual observation; callers group equivalent module contexts for one load. No metadata result is cached across source, environment or toolchain changes. Cold admission uses the already prepared real build workspace.
+ * @evidence contracts/performance.md#reuse-equivalent-work Entries are deduplicated within a contextual observation; callers group equivalent module contexts for one load. With a record store, a successful selection is answered across loads and processes under an identity built from the content of everything Go reads, so any source, overlay, contributor, manifest, Go variable or toolchain change observes Go again (#1721); erroneous selections are never recorded. Cold admission uses the already prepared real build workspace.
  * @evidence contracts/performance.md#bound-retention-and-release-resources Each metadata scratch has finally-based retirement-aware cleanup, and capture resources belong to spawnGoTool. Unknown native retirement retains scratch under the existing scope; results and complete output remain caller-owned with no independent byte ceiling.
  */
 export declare namespace NativeSourcePackages {
@@ -41,6 +43,32 @@ export declare namespace NativeSourcePackages {
             Err: string;
         };
     }
+    /**
+     * One load's readings, shared by its package selections and its builds:
+     * source directory digests and module build-environment digests, each by
+     * absolute directory. The builds fill and report the same maps, so a load
+     * reads each directory and each module's toolchain once.
+     *
+     * @evidence contracts/common.md#principled-implementation Both maps carry readings already taken in this load under its fixed effective environment; builds still take their own environment reading with a witness.
+     * @evidence contracts/common.md#clear-and-simple-design Two maps already owned by the loader travel together.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The maps never outlive the load; cross-process reuse belongs to the record store.
+     * @evidence contracts/common.md#meaningful-documentation Members state their keys and values.
+     * @evidence contracts/portability.md#os-neutral-implementation Keys are native absolute paths.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms A record type runs no algorithm.
+     * @evidence contracts/performance.md#reuse-equivalent-work Selections and builds of one load share one reading per directory and module.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The loader owns both maps for one load.
+     */
+    interface SelectionReadings {
+        /** `pluginSourceDigest` of each directory this load read. */
+        sources?: Map<string, string>;
+        /** Build-environment digest of each module root this load read. */
+        environments?: Map<string, string>;
+        /**
+         * Witness of each reading in `environments`, so a build of the same
+         * directory keys on that reading instead of probing Go again.
+         */
+        witnesses?: Map<string, PluginBuildEnvironmentWitness.Record>;
+    }
     /**
      * Observe entries together in a private module layout for their context.
      *
@@ -50,7 +78,7 @@ export declare namespace NativeSourcePackages {
      * @evidence contracts/common.md#meaningful-documentation Native prose states this operation's authority and delegated boundaries; fields retain separate native comments.
      * @evidence contracts/portability.md#os-neutral-implementation Native copy/path and selected tool/environment owners preserve platform identity; contribution target containment is checked.
      * @evidence contracts/performance.md#efficient-algorithms Copies admitted host/contributor bytes and enumerates entries; workspace setup reads manifests and one list command skips dependencies.
-     * @evidence contracts/performance.md#reuse-equivalent-work All entries share one prepared context; optional readers are scoped to one load and the same selected tool/effective environment.
+     * @evidence contracts/performance.md#reuse-equivalent-work All entries share one prepared context; optional readers are scoped to one load and the same selected tool/effective environment. A supplied record store answers an equal selection without copying or running Go, under the content identity of the module, contributors, overlays, proposal manifests, toolchain/environment digest, Go variables, entries and command; an answer is recorded only when the copies matched their keyed digests, no package reported an error and the overlays still held their digests after Go ran.
      * @evidence contracts/performance.md#bound-retention-and-release-resources Finally releases owned scratch through retirement authority; unknown native closure defers removal and capture cleanup remains delegated.
      */
     function inspect(opts: {
@@ -64,6 +92,16 @@ export declare namespace NativeSourcePackages {
         }[];
         readers?: Map<string, SourcePluginWorkspace.GoModReader>;
         proposal?: boolean;
+        /**
+         * Record store under which an equal selection is answered without Go
+         * (#1721); without it every load runs the full observation.
+         */
+        identities?: PluginContentIdentities.Store;
+        /**
+         * The load's source and environment readings, shared with its builds so one
+         * load reads each directory and each module's toolchain once.
+         */
+        readings?: SelectionReadings;
     }): Package[];
     /**
      * Group one load's standalone candidates by their actual owning module.
@@ -74,13 +112,13 @@ export declare namespace NativeSourcePackages {
      * @evidence contracts/common.md#meaningful-documentation Native prose states this operation's authority and delegated boundaries; fields retain separate native comments.
      * @evidence contracts/portability.md#os-neutral-implementation Native module roots retain their selected spelling, without blanket case folding.
      * @evidence contracts/performance.md#efficient-algorithms One grouping pass plus contextual copies and metadata work for each distinct module; output storage scales with input population.
-     * @evidence contracts/performance.md#reuse-equivalent-work Equivalent entries in a module share one list; overlay module observations share the load's selected-tool readers, without global metadata caching.
+     * @evidence contracts/performance.md#reuse-equivalent-work Equivalent entries in a module share one list; overlay module observations share the load's selected-tool readers, and the load's readings and record store reach each contextual observation so equal selections are answered from their content identity.
      * @evidence contracts/performance.md#bound-retention-and-release-resources Grouping/maps/results live for this call/load; scratch and native captures remain with inspect/read.
      */
     function ownPackages(inputs: readonly {
         source: string;
         label: string;
-    }[], env: NodeJS.ProcessEnv, readers?: Map<string, SourcePluginWorkspace.GoModReader>): Package[];
+    }[], env: NodeJS.ProcessEnv, readers?: Map<string, SourcePluginWorkspace.GoModReader>, identities?: PluginContentIdentities.Store, readings?: SelectionReadings): Package[];
     /**
      * Propose ownership with the candidate-selected tool before final admission.
      *
@@ -96,14 +134,14 @@ export declare namespace NativeSourcePackages {
      * @evidence contracts/common.md#meaningful-documentation Native prose states deterministic proposal authority and mandatory final ownership confirmation.
      * @evidence contracts/portability.md#os-neutral-implementation Native module/tool/environment owners preserve candidate-relative tool and source layout identity.
      * @evidence contracts/performance.md#efficient-algorithms Groups inputs by module and actual/prospective mode, copies each admitted module once per context, and batches entries through Go metadata; retained work scales with source bytes and distinct contexts.
-     * @evidence contracts/performance.md#reuse-equivalent-work Equivalent entries share one observation and per-load manifest readers; no result crosses a load or changed context.
+     * @evidence contracts/performance.md#reuse-equivalent-work Equivalent entries share one observation and per-load manifest readers; a result crosses loads only through the record store's content identity, so a changed context observes Go again.
      * @evidence contracts/performance.md#bound-retention-and-release-resources Group records live for this call; scratch/process cleanup remains with inspect and no independent output byte cap is imposed.
      */
     function propose(inputs: readonly {
         source: string;
         label: string;
         ownModule?: boolean;
-    }[], env: NodeJS.ProcessEnv, readers?: Map<string, SourcePluginWorkspace.GoModReader>): Array<{
+    }[], env: NodeJS.ProcessEnv, readers?: Map<string, SourcePluginWorkspace.GoModReader>, identities?: PluginContentIdentities.Store, readings?: SelectionReadings): Array<{
         observation: Package;
         ownModule: boolean;
     }>;

package/lib/plugin/internal/source/NativeSourcePackages.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NativeSourcePackages = 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"));
 const SidecarEnvironment_1 = require("../../../compiler/internal/sharedHost/SidecarEnvironment");
@@ -12,9 +13,13 @@ const SourceNativeRetirement_1 = require("../../../internal/SourceNativeRetireme
 const createCanonicalTempDirectory_1 = require("../../../internal/createCanonicalTempDirectory");
 const GoSourceInputs_1 = require("./GoSourceInputs");
 const GoToolResolution_1 = require("./GoToolResolution");
+const PluginContentIdentities_1 = require("./PluginContentIdentities");
+const PluginLoadAnswers_1 = require("./PluginLoadAnswers");
 const SourcePluginAdmission_1 = require("./SourcePluginAdmission");
 const SourcePluginWorkspace_1 = require("./SourcePluginWorkspace");
 const ensureExecutableGoToolchain_1 = require("./ensureExecutableGoToolchain");
+const hashPluginBuildEnvironment_1 = require("./hashPluginBuildEnvironment");
+const pluginSourceDigest_1 = require("./pluginSourceDigest");
 const resolveGoCompiler_1 = require("./resolveGoCompiler");
 const resolvePluginGoModule_1 = require("./resolvePluginGoModule");
 const spawnGoTool_1 = require("./spawnGoTool");
@@ -30,7 +35,7 @@ const spawnGoTool_1 = require("./spawnGoTool");
  * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes metadata selection from compilation and later materialized admission.
  * @evidence contracts/portability.md#os-neutral-implementation Native path/fs operations and the shared Go tool selector preserve environment-name and path identity without blanket case folding; Go itself applies target platform and cgo selection.
  * @evidence contracts/performance.md#efficient-algorithms One list command observes all distinct package entries in each prepared context. Context materialization traverses and copies admitted host/contributor files; workspace setup delegates manifest commands and list skips dependency loading. Framing and JSON parsing process complete output bytes, and retained results scale with selected packages/files.
- * @evidence contracts/performance.md#reuse-equivalent-work Entries are deduplicated within a contextual observation; callers group equivalent module contexts for one load. No metadata result is cached across source, environment or toolchain changes. Cold admission uses the already prepared real build workspace.
+ * @evidence contracts/performance.md#reuse-equivalent-work Entries are deduplicated within a contextual observation; callers group equivalent module contexts for one load. With a record store, a successful selection is answered across loads and processes under an identity built from the content of everything Go reads, so any source, overlay, contributor, manifest, Go variable or toolchain change observes Go again (#1721); erroneous selections are never recorded. Cold admission uses the already prepared real build workspace.
  * @evidence contracts/performance.md#bound-retention-and-release-resources Each metadata scratch has finally-based retirement-aware cleanup, and capture resources belong to spawnGoTool. Unknown native retirement retains scratch under the existing scope; results and complete output remain caller-owned with no independent byte ceiling.
  */
 var NativeSourcePackages;
@@ -44,7 +49,7 @@ var NativeSourcePackages;
      * @evidence contracts/common.md#meaningful-documentation Native prose states this operation's authority and delegated boundaries; fields retain separate native comments.
      * @evidence contracts/portability.md#os-neutral-implementation Native copy/path and selected tool/environment owners preserve platform identity; contribution target containment is checked.
      * @evidence contracts/performance.md#efficient-algorithms Copies admitted host/contributor bytes and enumerates entries; workspace setup reads manifests and one list command skips dependencies.
-     * @evidence contracts/performance.md#reuse-equivalent-work All entries share one prepared context; optional readers are scoped to one load and the same selected tool/effective environment.
+     * @evidence contracts/performance.md#reuse-equivalent-work All entries share one prepared context; optional readers are scoped to one load and the same selected tool/effective environment. A supplied record store answers an equal selection without copying or running Go, under the content identity of the module, contributors, overlays, proposal manifests, toolchain/environment digest, Go variables, entries and command; an answer is recorded only when the copies matched their keyed digests, no package reported an error and the overlays still held their digests after Go ran.
      * @evidence contracts/performance.md#bound-retention-and-release-resources Finally releases owned scratch through retirement authority; unknown native closure defers removal and capture cleanup remains delegated.
      */
     function inspect(opts) {
@@ -53,6 +58,18 @@ var NativeSourcePackages;
         const compiler = (0, resolveGoCompiler_1.resolveGoCompiler)(env);
         const goBinary = GoToolResolution_1.GoToolResolution.resolveGoToolForBuild(compiler.binary, env, moduleRoot);
         (0, ensureExecutableGoToolchain_1.ensureExecutableGoToolchain)(goBinary, compiler.bundled);
+        // WARNING (#1721): never drop this lookup or narrow its identity. Without
+        // it every warm launch and every unplugin generation copied the module
+        // twice and ran `go list` twice (6 s+ on Windows) to rediscover an answer
+        // its unchanged inputs already determined.
+        const identity = opts.identities === undefined
+            ? undefined
+            : selectionIdentity(opts, moduleRoot, goBinary, env, opts.identities);
+        if (identity !== undefined) {
+            const recalled = recallSelection(PluginLoadAnswers_1.PluginLoadAnswers.read(opts.identities, SELECTION_ANSWER, identity), moduleRoot, opts.packages.length);
+            if (recalled !== undefined)
+                return recalled;
+        }
         const scratch = (0, createCanonicalTempDirectory_1.createCanonicalTempDirectory)("ttsc-package-selection-");
         let taskFailure;
         try {
@@ -61,6 +78,11 @@ var NativeSourcePackages;
                 retainedPaths: [scratch],
             });
             SourcePluginWorkspace_1.SourcePluginWorkspace.materialize(moduleRoot, scratch);
+            // An answer is recorded only for the copy its identity describes: a
+            // module edited between the identity reading and the copy observed
+            // other bytes than the key names.
+            let copiesKeyed = identity === undefined ||
+                (0, pluginSourceDigest_1.pluginSourceDigest)(scratch) === identity.module;
             if (opts.proposal === true) {
                 // Only root manifests change. Relative Go inputs retain the source
                 // module layout, while its irrelevant graph/toolchain stays inactive.
@@ -86,16 +108,32 @@ var NativeSourcePackages;
                 if (node_fs_1.default.existsSync(target))
                     throw new Error(`ttsc: package selection target already exists: ${target}`);
                 SourcePluginWorkspace_1.SourcePluginWorkspace.materialize(input.source, target);
+                if (identity !== undefined)
+                    copiesKeyed &&=
+                        (0, pluginSourceDigest_1.pluginSourceDigest)(target) ===
+                            identity.entries.find((entry) => entry[0] === input.entry)?.[2];
             }
-            const reader = SourcePluginWorkspace_1.SourcePluginWorkspace.createGoModReader(goBinary, opts.pluginName, env, opts.readers);
+            const reader = SourcePluginWorkspace_1.SourcePluginWorkspace.createGoModReader(goBinary, opts.pluginName, env, opts.readers, opts.identities);
             SourcePluginWorkspace_1.SourcePluginWorkspace.writeGoWork(scratch, SourcePluginWorkspace_1.SourcePluginWorkspace.findTtscOverlayDirs(), goBinary, opts.pluginName, env, reader);
-            return read({
+            const observed = read({
                 cwd: scratch,
                 entries: opts.packages.map((input) => input.entry),
                 env: GoSourceInputs_1.GoSourceInputs.goBuildEnv(goBinary, undefined, env),
                 goBinary,
                 pluginName: opts.pluginName,
             });
+            if (identity !== undefined &&
+                copiesKeyed &&
+                observed.every((input) => input.Error === undefined) &&
+                JSON.stringify(overlayDigests(opts.identities)) ===
+                    JSON.stringify(identity.overlays))
+                PluginLoadAnswers_1.PluginLoadAnswers.write(opts.identities, SELECTION_ANSWER, identity, observed.map((input) => ({
+                    ...input,
+                    Dir: input.Dir === undefined
+                        ? undefined
+                        : node_path_1.default.relative(scratch, input.Dir),
+                })));
+            return observed;
         }
         catch (error) {
             taskFailure = { error };
@@ -117,10 +155,10 @@ var NativeSourcePackages;
      * @evidence contracts/common.md#meaningful-documentation Native prose states this operation's authority and delegated boundaries; fields retain separate native comments.
      * @evidence contracts/portability.md#os-neutral-implementation Native module roots retain their selected spelling, without blanket case folding.
      * @evidence contracts/performance.md#efficient-algorithms One grouping pass plus contextual copies and metadata work for each distinct module; output storage scales with input population.
-     * @evidence contracts/performance.md#reuse-equivalent-work Equivalent entries in a module share one list; overlay module observations share the load's selected-tool readers, without global metadata caching.
+     * @evidence contracts/performance.md#reuse-equivalent-work Equivalent entries in a module share one list; overlay module observations share the load's selected-tool readers, and the load's readings and record store reach each contextual observation so equal selections are answered from their content identity.
      * @evidence contracts/performance.md#bound-retention-and-release-resources Grouping/maps/results live for this call/load; scratch and native captures remain with inspect/read.
      */
-    function ownPackages(inputs, env, readers = new Map()) {
+    function ownPackages(inputs, env, readers = new Map(), identities, readings) {
         const groups = new Map();
         inputs.forEach((input, index) => {
             const target = (0, resolvePluginGoModule_1.resolvePluginGoModule)(input.source, input.label);
@@ -136,6 +174,8 @@ var NativeSourcePackages;
                 pluginName: first.label,
                 env,
                 readers,
+                identities,
+                readings,
                 packages: group.map(({ entry }) => ({ entry })),
             });
             group.forEach(({ index }, offset) => {
@@ -160,10 +200,10 @@ var NativeSourcePackages;
      * @evidence contracts/common.md#meaningful-documentation Native prose states deterministic proposal authority and mandatory final ownership confirmation.
      * @evidence contracts/portability.md#os-neutral-implementation Native module/tool/environment owners preserve candidate-relative tool and source layout identity.
      * @evidence contracts/performance.md#efficient-algorithms Groups inputs by module and actual/prospective mode, copies each admitted module once per context, and batches entries through Go metadata; retained work scales with source bytes and distinct contexts.
-     * @evidence contracts/performance.md#reuse-equivalent-work Equivalent entries share one observation and per-load manifest readers; no result crosses a load or changed context.
+     * @evidence contracts/performance.md#reuse-equivalent-work Equivalent entries share one observation and per-load manifest readers; a result crosses loads only through the record store's content identity, so a changed context observes Go again.
      * @evidence contracts/performance.md#bound-retention-and-release-resources Group records live for this call; scratch/process cleanup remains with inspect and no independent output byte cap is imposed.
      */
-    function propose(inputs, env, readers = new Map()) {
+    function propose(inputs, env, readers = new Map(), identities, readings) {
         const groups = new Map();
         inputs.forEach((input, index) => {
             const target = (0, resolvePluginGoModule_1.resolvePluginGoModule)(input.source, input.label);
@@ -181,6 +221,8 @@ var NativeSourcePackages;
                 pluginName: first.label,
                 env,
                 readers,
+                identities,
+                readings,
                 proposal: !group[0].ownModule,
                 packages: group.map(({ entry }) => ({ entry })),
             });
@@ -327,4 +369,104 @@ var NativeSourcePackages;
 function genericHostSource() {
     return node_path_1.default.resolve(__dirname, "../../../..", "cmd/utility-host");
 }
+/** Answer family of package selections (`PluginLoadAnswers`). */
+const SELECTION_ANSWER = "go-package-selection";
+/** Fields `read` asks Go for; part of the selection identity. */
+const SELECTION_FIELDS = "-json=Dir,Name,GoFiles,CgoFiles,Error";
+function selectionIdentity(opts, moduleRoot, goBinary, env, identities) {
+    try {
+        const readings = opts.readings ?? {};
+        const directory = (root) => {
+            const resolved = node_path_1.default.resolve(root);
+            let digest = readings.sources?.get(resolved);
+            if (digest === undefined) {
+                digest = PluginContentIdentities_1.PluginContentIdentities.sourceDirectory(identities, resolved);
+                readings.sources?.set(resolved, digest);
+            }
+            return digest;
+        };
+        const resolvedRoot = node_path_1.default.resolve(moduleRoot);
+        let environment = readings.environments?.get(resolvedRoot);
+        if (environment === undefined) {
+            const hash = node_crypto_1.default.createHash("sha256");
+            const witness = new Map();
+            (0, hashPluginBuildEnvironment_1.hashPluginBuildEnvironment)(hash, goBinary, moduleRoot, env, { readFile: (location) => node_fs_1.default.readFileSync(location) }, witness, identities);
+            environment = hash.digest("hex");
+            readings.environments?.set(resolvedRoot, environment);
+            readings.witnesses?.set(resolvedRoot, witness);
+        }
+        const host = opts.proposal === true
+            ? (0, resolvePluginGoModule_1.resolvePluginGoModule)(genericHostSource(), opts.pluginName).moduleRoot
+            : undefined;
+        return {
+            format: 1,
+            command: [
+                "list",
+                ...GoSourceInputs_1.GoSourceInputs.BUILD_FLAGS,
+                "-find",
+                "-e",
+                SELECTION_FIELDS,
+            ],
+            mode: opts.proposal === true ? "proposal" : "actual",
+            module: directory(moduleRoot),
+            environment,
+            variables: Object.entries(GoSourceInputs_1.GoSourceInputs.goBuildEnv(goBinary, undefined, env))
+                .filter((entry) => entry[1] !== undefined && /^(GO|CGO_)/i.test(entry[0]))
+                .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0)),
+            manifests: host === undefined
+                ? null
+                : ["go.mod", "go.sum"].map((name) => fileDigest(node_path_1.default.join(host, name))),
+            overlays: SourcePluginWorkspace_1.SourcePluginWorkspace.findTtscOverlayDirs().map(directory),
+            entries: opts.packages.map((input) => [
+                input.entry,
+                input.name ?? null,
+                input.source === undefined ? null : directory(input.source),
+            ]),
+        };
+    }
+    catch {
+        // An identity that cannot be formed only costs the real observation.
+        return undefined;
+    }
+}
+/** The digest of every overlay module, in the generated workspace's order. */
+function overlayDigests(identities) {
+    return SourcePluginWorkspace_1.SourcePluginWorkspace.findTtscOverlayDirs().map((directory) => PluginContentIdentities_1.PluginContentIdentities.sourceDirectory(identities, directory));
+}
+/** A small manifest's content digest, or null when it does not exist. */
+function fileDigest(file) {
+    try {
+        return node_crypto_1.default
+            .createHash("sha256")
+            .update(node_fs_1.default.readFileSync(file))
+            .digest("hex");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+}
+/**
+ * A recorded selection rebased onto the module it now describes, or `undefined`
+ * when the record does not have the shape `read` produces.
+ */
+function recallSelection(value, moduleRoot, count) {
+    if (!Array.isArray(value) || value.length !== count)
+        return undefined;
+    try {
+        const packages = NativeSourcePackages.parse(value.map((input) => JSON.stringify(input)).join("\n"));
+        if (packages.length !== count)
+            return undefined;
+        return packages.map((input) => ({
+            ...input,
+            Dir: input.Dir === undefined
+                ? undefined
+                : node_path_1.default.resolve(moduleRoot, input.Dir),
+        }));
+    }
+    catch {
+        return undefined;
+    }
+}
 //# sourceMappingURL=NativeSourcePackages.js.map