ttsc 0.31.0 → 0.31.2

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

@@ -1,9 +1,11 @@
+import { PluginBuildEnvironmentWitness } from "./PluginBuildEnvironmentWitness";
+import { PluginContentIdentities } from "./PluginContentIdentities";
 import { SourcePluginWorkspace } from "./SourcePluginWorkspace";
 /**
  * Observe Go-selected packages under the native builder's workspace policy.
  *
- * Metadata does not compile dependencies or certify a later build. A cold
- * build repeats ownership admission in its proven, materialized workspace.
+ * Metadata does not compile dependencies or certify a later build. A cold build
+ * repeats ownership admission in its proven, materialized workspace.
  *
  * @evidence contracts/common.md#principled-implementation The selected Go tool, effective environment, shared workspace writer and actual copied package inputs determine package names and errors; Go remains the build-constraint and package-validity authority.
  * @evidence contracts/common.md#clear-and-simple-design One namespace separates contextual observation, metadata framing and ownership admission; source-only contributions are observed inside their selected host module.
@@ -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,21 +112,21 @@ 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.
      *
-     * Nested transform sources retain their admitted source-module layout but
-     * use unchanged generic host root manifests in scratch. Their outer module
-     * graph and toolchain are not source-only build authority. Module-root and
-     * check sources retain their actual owning module. Executable proposals must
-     * agree in the actual own module; linked proposals in each chosen actual host.
+     * Nested transform sources retain their admitted source-module layout but use
+     * unchanged generic host root manifests in scratch. Their outer module graph
+     * and toolchain are not source-only build authority. Module-root and check
+     * sources retain their actual owning module. Executable proposals must agree
+     * in the actual own module; linked proposals in each chosen actual host.
      *
      * @evidence contracts/common.md#principled-implementation Candidate tool selection occurs at the original owning module and effective environment; only prospective nested source-only manifests change in owned scratch before Go interprets the normal generated workspace.
      * @evidence contracts/common.md#clear-and-simple-design One grouping pass shares each module/proposal context and returns whether actual own-module observation already occurred.
@@ -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,17 +13,21 @@ 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");
 /**
  * Observe Go-selected packages under the native builder's workspace policy.
  *
- * Metadata does not compile dependencies or certify a later build. A cold
- * build repeats ownership admission in its proven, materialized workspace.
+ * Metadata does not compile dependencies or certify a later build. A cold build
+ * repeats ownership admission in its proven, materialized workspace.
  *
  * @evidence contracts/common.md#principled-implementation The selected Go tool, effective environment, shared workspace writer and actual copied package inputs determine package names and errors; Go remains the build-constraint and package-validity authority.
  * @evidence contracts/common.md#clear-and-simple-design One namespace separates contextual observation, metadata framing and ownership admission; source-only contributions are observed inside their selected host module.
@@ -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.
@@ -80,25 +102,38 @@ var NativeSourcePackages;
                 const contributor = { source: input.source, name: input.name };
                 SourcePluginAdmission_1.SourcePluginAdmission.requireContributorPackage(opts.pluginName, contributor);
                 const target = node_path_1.default.resolve(scratch, input.entry);
-                if (node_path_1.default.relative(scratch, target).startsWith("..") || target === scratch)
+                if (node_path_1.default.relative(scratch, target).startsWith("..") ||
+                    target === scratch)
                     throw new Error("ttsc: invalid package selection target");
                 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];
             }
-            let reader = opts.readers?.get(goBinary);
-            if (reader === undefined) {
-                reader = SourcePluginWorkspace_1.SourcePluginWorkspace.createGoModReader(goBinary, opts.pluginName, env);
-                opts.readers?.set(goBinary, reader);
-            }
+            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 };
@@ -120,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);
@@ -139,9 +174,13 @@ var NativeSourcePackages;
                 pluginName: first.label,
                 env,
                 readers,
+                identities,
+                readings,
                 packages: group.map(({ entry }) => ({ entry })),
             });
-            group.forEach(({ index }, offset) => { output[index] = observations[offset]; });
+            group.forEach(({ index }, offset) => {
+                output[index] = observations[offset];
+            });
         }
         return output;
     }
@@ -149,11 +188,11 @@ var NativeSourcePackages;
     /**
      * Propose ownership with the candidate-selected tool before final admission.
      *
-     * Nested transform sources retain their admitted source-module layout but
-     * use unchanged generic host root manifests in scratch. Their outer module
-     * graph and toolchain are not source-only build authority. Module-root and
-     * check sources retain their actual owning module. Executable proposals must
-     * agree in the actual own module; linked proposals in each chosen actual host.
+     * Nested transform sources retain their admitted source-module layout but use
+     * unchanged generic host root manifests in scratch. Their outer module graph
+     * and toolchain are not source-only build authority. Module-root and check
+     * sources retain their actual owning module. Executable proposals must agree
+     * in the actual own module; linked proposals in each chosen actual host.
      *
      * @evidence contracts/common.md#principled-implementation Candidate tool selection occurs at the original owning module and effective environment; only prospective nested source-only manifests change in owned scratch before Go interprets the normal generated workspace.
      * @evidence contracts/common.md#clear-and-simple-design One grouping pass shares each module/proposal context and returns whether actual own-module observation already occurred.
@@ -161,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);
@@ -178,7 +217,12 @@ var NativeSourcePackages;
         for (const group of groups.values()) {
             const first = inputs[group[0].index];
             const observations = inspect({
-                source: first.source, pluginName: first.label, env, readers,
+                source: first.source,
+                pluginName: first.label,
+                env,
+                readers,
+                identities,
+                readings,
                 proposal: !group[0].ownModule,
                 packages: group.map(({ entry }) => ({ entry })),
             });
@@ -206,7 +250,14 @@ var NativeSourcePackages;
         if (entries.length === 0)
             return [];
         OwnedSynchronousProcess_1.OwnedSynchronousProcess.checkpoint();
-        const result = (0, spawnGoTool_1.spawnGoTool)(opts.goBinary, ["list", ...GoSourceInputs_1.GoSourceInputs.BUILD_FLAGS, "-find", "-e", "-json=Dir,Name,GoFiles,CgoFiles,Error", ...entries], { cwd: opts.cwd, encoding: "utf8", env: opts.env, windowsHide: true });
+        const result = (0, spawnGoTool_1.spawnGoTool)(opts.goBinary, [
+            "list",
+            ...GoSourceInputs_1.GoSourceInputs.BUILD_FLAGS,
+            "-find",
+            "-e",
+            "-json=Dir,Name,GoFiles,CgoFiles,Error",
+            ...entries,
+        ], { cwd: opts.cwd, encoding: "utf8", env: opts.env, windowsHide: true });
         OwnedSynchronousProcess_1.OwnedSynchronousProcess.checkpoint();
         if (result.error !== undefined)
             throw new Error(SourcePluginWorkspace_1.SourcePluginWorkspace.goSpawnFailureMessage(`selecting Go packages for plugin "${opts.pluginName}"`, opts.pluginName, opts.goBinary, opts.cwd, result.error));
@@ -214,7 +265,8 @@ var NativeSourcePackages;
             throw new Error(`ttsc: selecting Go packages for plugin "${opts.pluginName}" failed:\n${result.stderr || result.stdout}`);
         const packages = parse(result.stdout);
         const selected = new Map(packages.map((input) => [
-            input.Dir === undefined ? undefined : node_fs_1.default.realpathSync.native(input.Dir), input,
+            input.Dir === undefined ? undefined : node_fs_1.default.realpathSync.native(input.Dir),
+            input,
         ]));
         return opts.entries.map((entry) => {
             const dir = node_fs_1.default.realpathSync.native(node_path_1.default.resolve(opts.cwd, entry));
@@ -240,7 +292,8 @@ var NativeSourcePackages;
     function kind(input, label, expected) {
         if (input.Error !== undefined)
             throw new Error(`ttsc: plugin "${label}" Go package selection failed: ${input.Error.Err}`);
-        if (input.Name === undefined || (input.GoFiles?.length ?? 0) + (input.CgoFiles?.length ?? 0) === 0)
+        if (input.Name === undefined ||
+            (input.GoFiles?.length ?? 0) + (input.CgoFiles?.length ?? 0) === 0)
             throw new Error(`ttsc: plugin "${label}" source has no Go-selected production files: ${input.Dir ?? "unknown package"}`);
         const actual = input.Name === "main" ? "executable" : "linked";
         if (expected !== undefined && actual !== expected)
@@ -297,8 +350,10 @@ var NativeSourcePackages;
                 if ((record.Dir !== undefined && typeof record.Dir !== "string") ||
                     (record.Name !== undefined && typeof record.Name !== "string") ||
                     [record.GoFiles, record.CgoFiles].some((files) => files !== undefined &&
-                        (!Array.isArray(files) || files.some((file) => typeof file !== "string"))) ||
-                    (record.Error !== undefined && (record.Error === null || typeof record.Error.Err !== "string")))
+                        (!Array.isArray(files) ||
+                            files.some((file) => typeof file !== "string"))) ||
+                    (record.Error !== undefined &&
+                        (record.Error === null || typeof record.Error.Err !== "string")))
                     throw new Error("ttsc: invalid Go package metadata fields");
                 packages.push(record);
                 start = -1;
@@ -314,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

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

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

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

@@ -54,20 +54,51 @@ export declare namespace PluginBuildEnvironmentReadings {
      * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The operation borrows a process-owned record and retains no request history.
      */
     function cached(directory: string): string | undefined;
+    /**
+     * Qualify a batch in one synchronous observation transaction. Shared SDK
+     * paths and the complete variable identity are read once, even when several
+     * plugin directories use them. Missing readings remain explicitly missing.
+     *
+     * WARNING (#1712): this map belongs only to the following synchronous proof.
+     * Never retain it across an await, delivery, build boundary or publication. A
+     * process-permanent positive witness would miss changed Go tools and GOENV
+     * files (#1516); independently checking it in every helper instead multiplies
+     * a thousands-file GOROOT scan by modules and proof layers.
+     *
+     * @evidence contracts/common.md#principled-implementation One current variable snapshot and native path observation are compared against each reading's own expected witness; conflicting expected states cannot both pass.
+     * @evidence contracts/common.md#clear-and-simple-design One batch operation owns shared validation without changing synchronous reads or native worker publication boundaries.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Undefined is retained for absent or stale authority; no positive verdict survives this explicit observation transaction.
+     * @evidence contracts/common.md#meaningful-documentation Native paragraphs state scope, missing semantics and the performance/correctness regressions prevented by the lifetime restriction.
+     * @evidence contracts/portability.md#os-neutral-implementation Existing native witness keys preserve filesystem, link and ambient-variable distinctions; no platform case assumption is added.
+     * @evidence contracts/performance.md#efficient-algorithms Full variables are indexed once; each distinct witnessed path is queried once while each reading compares its own witness entries. Work is proportional to variable bytes, total witness entries and unique native dependencies rather than repeated native SDK scans.
+     * @evidence contracts/performance.md#reuse-equivalent-work Only current native observations within this synchronous batch are shared; the returned digests do not authorize reuse after another asynchronous boundary.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The native observation map is call-local and the digest map transfers to its immediate proof caller; no handle or historical registry is acquired.
+     */
+    function cachedAll(directories: Iterable<string>): ReadonlyMap<string, string | undefined>;
     /**
      * Read synchronously for clients whose API owns synchronous native work.
      * Explicit refresh preserves the original fresh-comparison semantics.
      *
+     * WARNING (#1725): the map above ends with the process, and every consumer
+     * that proves a plugin-source state starts a new one: a bundler worker, a
+     * capability host, the language server. Without the project's record store
+     * each of them walked and hashed the whole GOROOT (1.7 s for the bundled
+     * toolchain) on its first proof. A caller that names its project lets a miss
+     * prove the SDK and executables from the plugin cache's records.
+     *
+     * @param directory Plugin source directory whose build environment is read.
+     * @param refresh Bypass a cached reading.
+     * @param projectRoot Project whose plugin cache root holds the records.
      * @evidence contracts/common.md#principled-implementation The same native reader constructs a digest paired with its pre-read witness; optional cached reuse validates current variables/metadata. A fresh synchronous reading is published without a separate post-read qualification here and relies on the native reader's premises.
      * @evidence contracts/common.md#clear-and-simple-design The synchronous boundary shares cached authority and delegates fresh observation to its owning reader.
      * @evidence contracts/common.md#prohibited-implementation-shortcuts A requested refresh actually probes the selected native toolchain.
      * @evidence contracts/common.md#meaningful-documentation Native prose identifies the synchronous execution owner and explicit refresh meaning.
      * @evidence contracts/portability.md#os-neutral-implementation Native Go selection and filesystem witnesses remain delegated to the shared reader.
      * @evidence contracts/performance.md#efficient-algorithms Hits pay complete variable-text indexing and native witness queries. Misses/refresh merge environment values, perform actual toolchain/SDK/content work, then rebuild the full variable-text key for publication; native/path/file/name/value bytes contribute cost beyond invocation count.
-     * @evidence contracts/performance.md#reuse-equivalent-work Synchronous and asynchronous clients share the same qualified readings.
+     * @evidence contracts/performance.md#reuse-equivalent-work Synchronous and asynchronous clients share the same qualified readings; a miss of a caller naming its project takes SDK and executable digests from the record store across processes.
      * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Retention belongs to the namespace; this call publishes one replacement record.
      */
-    function read(directory: string, refresh?: boolean): string;
+    function read(directory: string, refresh?: boolean, projectRoot?: string): string;
     /**
      * Prepare native authority off the host thread, sharing equivalent concurrent
      * requests. A changed environment or witness during transfer refuses the
@@ -77,6 +108,14 @@ export declare namespace PluginBuildEnvironmentReadings {
      * requests can create a worker after retirement. Refresh bypasses a cached
      * reading but can still share an equivalent in-flight request.
      *
+     * A caller that names its project lets the worker prove the SDK and
+     * executables from the plugin cache's records (#1722). The worker is its own
+     * isolate, so without them it reads the whole GOROOT once per process, which
+     * a bundler or runtime restarting on every edit pays every time.
+     *
+     * @param directory Plugin source directory whose build environment is read.
+     * @param refresh Bypass a cached reading.
+     * @param projectRoot Project whose plugin cache root holds the records.
      * @evidence contracts/common.md#principled-implementation Worker results publish only under their exact current variable identity and still-current native pre-read witness; changed or unwitnessable transfer windows reject instead of publishing authority or retrying indefinitely.
      * @evidence contracts/common.md#clear-and-simple-design Qualified hits return immediately; equivalent misses share one pending promise and exclusive queued worker request.
      * @evidence contracts/common.md#prohibited-implementation-shortcuts Go/environment/SDK preparation occurs in the worker rather than blocking the async host or fabricating a digest from compiler output.
@@ -86,5 +125,5 @@ export declare namespace PluginBuildEnvironmentReadings {
      * @evidence contracts/performance.md#reuse-equivalent-work Pending identity is directory plus complete variables; the warm worker shares native toolchain memos while published authority still requires fresh witness validation.
      * @evidence contracts/performance.md#bound-retention-and-release-resources Pending identity entries are removed in finally at settlement and per-request worker listeners are removed by the terminal path. Idle worker remains unreferenced with lifetime retirement listeners; worker failure initiates termination without awaiting completion. Distinct queued contexts retain environment/witness/promise data without a population bound or timeout, and a stalled producer blocks later queued work.
      */
-    function prepare(directory: string, refresh?: boolean): Promise<string>;
+    function prepare(directory: string, refresh?: boolean, projectRoot?: string): Promise<string>;
 }