ttsc 0.30.4 → 0.31.1

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

@@ -0,0 +1,446 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prunePluginCacheRoot = prunePluginCacheRoot;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const SourceNativeRetirement_1 = require("../../../internal/SourceNativeRetirement");
+const CachePrunePolicy_1 = require("./CachePrunePolicy");
+const PluginBinaryUse_1 = require("./PluginBinaryUse");
+const PluginBuildLockOwner_1 = require("./PluginBuildLockOwner");
+const PluginBuildLockProtocol_1 = require("./PluginBuildLockProtocol");
+const SourceBuildCacheLayout_1 = require("./SourceBuildCacheLayout");
+const acquirePluginBuildLock_1 = require("./acquirePluginBuildLock");
+const inspectPluginBuildLock_1 = require("./inspectPluginBuildLock");
+const reclaimPluginBuildLock_1 = require("./reclaimPluginBuildLock");
+const releasePluginBuildLock_1 = require("./releasePluginBuildLock");
+/**
+ * Attempt age/size-based eviction in the plugin binary cache.
+ *
+ * Normally once a day (unless `force`), entries unused for 30 days are eligible
+ * for removal and, past a 2 GiB threshold, oldest eligible entries are removed
+ * toward 80% of it (`CachePrunePolicy`). A target-sized cohort of recently used
+ * entries, active builds and entries named in `protectedEntries` survive. When
+ * the protected set alone keeps the root over the ceiling, the daily marker is
+ * backdated so a later invocation becomes eligible after the protection window
+ * instead of a day later. Failed removals, protected/live/unknown owners and
+ * incomplete accounting can leave the cache above its thresholds indefinitely.
+ * Exceptions are swallowed; native calls and delegated retries can still block
+ * a build.
+ *
+ * Payload deletion acquires the same v3 per-key lease as a builder. A task
+ * retired while it was still running remains protected until its exact
+ * release-owned completion or proven process absence. Old v2 clients use an
+ * independent namespace, so their liveness check is conservative observation
+ * rather than atomic cross-version serialization. Returned binaries have
+ * independent process-reader reservations. Deletion inspects them under its key
+ * lease and preserves live or unknown consumers, including after a producer has
+ * completed and released its build lease.
+ *
+ * Pending, unknown or malformed native guards protect both payload and lock
+ * history independently of owner PID or age. Older compiler versions do not
+ * implement this protection and cannot safely share quarantined roots.
+ *
+ * Binary eviction preserves coordination roots. A v3 retired generation is
+ * reclaimed only after its holder and every registered observer are provably
+ * gone; their tokens may otherwise still act on that generation. Older v2
+ * generations have no observer registry and remain untouched. Persistent roots
+ * therefore still grow with historical keys even after binaries are evicted.
+ *
+ * @evidence contracts/common.md#principled-implementation Binary deletion acquires a v3 per-key lease and rechecks old v2 plus unfinished retired-task ownership; completed payload work and reusable fence history have distinct proofs, under the cooperating protocol's lifetime premises.
+ * @evidence contracts/common.md#clear-and-simple-design Binary accounting and generation-history reclamation remain separate phases because their ownership lifetimes differ.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Old v2 capabilities are not assumed expired; unknown ownership defers reclamation instead of hiding protocol uncertainty under a timeout.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs distinguish target-sized recent protection, retry behavior and persistent coordination-root growth.
+ * @evidence contracts/portability.md#os-neutral-implementation Root and history-child lstat/realpath checks and payload Dirent selection use observed native kinds and spelling; these sequential observations do not pin pathnames against replacement. Native deletion failures defer eviction without assuming volume case policy.
+ * @evidence contracts/performance.md#efficient-algorithms Age and size phases take two recursive payload metadata snapshots; two entry sorts add O(E log E) comparisons. Work includes entry/path text, native size/timestamp observations, explicit exclusions and repeated per-key owner/generation/observer/reader JSON and liveness scans, plus recursive deletion contents. Binary bytes are not read, but inaccessible size observations can undercount. Delegated lock inspection/retirement can retry without a deadline.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Producers and build locks establish valid binary reuse; this operation selects reclamation candidates.
+ *
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Each deletion attempt owns one v3 lease with finally release/reporting; cleanup failure may retain ownership, and eligible native retries can block indefinitely. Inspection can publish process-lifetime observer records. Removal of payload/history is attempted, not guaranteed: live/unknown readers, protected entries, failures, old v2 history and persistent roots can retain bytes or historical keys without a finite bound. Backdated markers only enable a later invocation.
+ */
+function prunePluginCacheRoot(root, options = {}) {
+    try {
+        const cacheRoot = SourceBuildCacheLayout_1.SourceBuildCacheLayout.canonicalPluginCacheRoot(root);
+        const marker = node_path_1.default.join(cacheRoot, CachePrunePolicy_1.CachePrunePolicy.GC_MARKER_FILE);
+        const now = options.now ?? Date.now();
+        const lastRun = SourceBuildCacheLayout_1.SourceBuildCacheLayout.readTimestamp(marker);
+        if (options.force !== true &&
+            lastRun !== null &&
+            lastRun <= now &&
+            now - lastRun < CachePrunePolicy_1.CachePrunePolicy.GC_INTERVAL_MS) {
+            return;
+        }
+        const remainingBytes = prunePluginCacheEntries(cacheRoot, {
+            maxBytes: options.maxBytes ?? CachePrunePolicy_1.CachePrunePolicy.MAX_BYTES,
+            now,
+            protectedEntries: canonicalPluginCacheProtectedEntries(cacheRoot, options.protectedEntries ?? []),
+            protectedAgeMs: options.protectedAgeMs ?? CachePrunePolicy_1.CachePrunePolicy.PROTECTED_AGE_MS,
+            targetBytes: options.targetBytes ?? CachePrunePolicy_1.CachePrunePolicy.TARGET_BYTES,
+        });
+        pruneRetiredLockGenerations(cacheRoot);
+        const maxBytes = options.maxBytes ?? CachePrunePolicy_1.CachePrunePolicy.MAX_BYTES;
+        const protectedAgeMs = options.protectedAgeMs ?? CachePrunePolicy_1.CachePrunePolicy.PROTECTED_AGE_MS;
+        const markerTimestamp = remainingBytes > maxBytes
+            ? now - CachePrunePolicy_1.CachePrunePolicy.GC_INTERVAL_MS + protectedAgeMs
+            : now;
+        SourceBuildCacheLayout_1.SourceBuildCacheLayout.replaceCacheMetadataFile(marker, `${markerTimestamp}\n`);
+    }
+    catch {
+        // Plugin-cache GC is opportunistic; builds still proceed when it fails.
+    }
+}
+/** Resolve explicit GC exclusions without accepting aliases outside root. */
+function canonicalPluginCacheProtectedEntries(root, entries) {
+    const protectedEntries = new Set();
+    for (const entry of entries) {
+        const candidate = node_path_1.default.resolve(entry);
+        const stats = node_fs_1.default.lstatSync(candidate);
+        if (!stats.isDirectory() || stats.isSymbolicLink()) {
+            throw new Error(`ttsc: unsafe protected plugin cache entry: ${entry}`);
+        }
+        const physical = node_fs_1.default.realpathSync.native(candidate);
+        if (node_path_1.default.dirname(physical) !== root) {
+            throw new Error(`ttsc: protected plugin cache entry escaped root: ${entry}`);
+        }
+        protectedEntries.add(physical);
+    }
+    return protectedEntries;
+}
+/** Evict unused binary entries and then oldest unprotected entries over budget. */
+function prunePluginCacheEntries(root, options) {
+    const entries = collectPluginCacheEntries(root, options.now);
+    for (const entry of entries) {
+        if (options.now - entry.lastUsedAt <= CachePrunePolicy_1.CachePrunePolicy.ENTRY_MAX_AGE_MS ||
+            options.protectedEntries.has(entry.dir) ||
+            pluginCacheEntryHasActiveBuild(entry)) {
+            continue;
+        }
+        removeCacheEntry(entry);
+    }
+    const remaining = collectPluginCacheEntries(root, options.now);
+    let total = remaining.reduce((sum, entry) => sum + entry.size, 0);
+    if (total <= options.maxBytes) {
+        return total;
+    }
+    const protectedEntries = new Set(options.protectedEntries);
+    let protectedBytes = 0;
+    for (const entry of [...remaining].sort((a, b) => b.lastUsedAt - a.lastUsedAt)) {
+        if (pluginCacheEntryHasActiveBuild(entry)) {
+            protectedEntries.add(entry.dir);
+            continue;
+        }
+        if (options.now - entry.lastUsedAt > options.protectedAgeMs)
+            continue;
+        if (protectedBytes >= options.targetBytes)
+            continue;
+        if (protectedBytes + entry.size > options.targetBytes)
+            continue;
+        protectedEntries.add(entry.dir);
+        protectedBytes += entry.size;
+    }
+    for (const entry of remaining.sort((a, b) => a.lastUsedAt - b.lastUsedAt)) {
+        if (total <= options.targetBytes) {
+            return total;
+        }
+        if (protectedEntries.has(entry.dir))
+            continue;
+        if (removeCacheEntry(entry))
+            total -= entry.size;
+    }
+    return total;
+}
+/** Protect a binary while current or previous-protocol ownership may be live. */
+function pluginCacheEntryHasActiveBuild(entry) {
+    const lockDir = `${entry.dir}.lock`;
+    try {
+        if (pluginCacheEntryHasLiveV2Build(entry))
+            return true;
+        return (0, inspectPluginBuildLock_1.inspectPluginBuildLock)(lockDir).state === "active";
+    }
+    catch {
+        // Malformed or unreadable coordination state cannot disprove ownership.
+        return true;
+    }
+}
+/**
+ * Protect an old v2 current owner unless its absence is established. Old
+ * clients do not share the v3 acquisition transaction, so this observation
+ * cannot provide atomic exclusion against a later old-client acquisition.
+ */
+function pluginCacheEntryHasLiveV2Build(entry) {
+    const current = node_path_1.default.join(`${entry.dir}.lock.v2`, "current");
+    try {
+        node_fs_1.default.lstatSync(current);
+    }
+    catch (error) {
+        return error.code !== "ENOENT";
+    }
+    try {
+        const generation = node_fs_1.default
+            .readFileSync(node_path_1.default.join(current, PluginBuildLockProtocol_1.PluginBuildLockProtocol.PLUGIN_BUILD_LOCK_GENERATION_FILE), "utf8")
+            .trim();
+        const owner = readQualifiedPluginCacheTaskOwner(current, generation);
+        return owner === null || !PluginBuildLockOwner_1.PluginBuildLockOwner.gone(owner);
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Protect payloads of retired tasks that may still publish or delete.
+ *
+ * Exact release-owned completion ends payload activity without revoking the
+ * independently retained fence. A live or uncertain holder without that witness
+ * remains protected, even though current ownership has moved on.
+ */
+function pluginCacheEntryHasUnfinishedRetiredTask(lockDir) {
+    const protocolRoot = PluginBuildLockProtocol_1.PluginBuildLockProtocol.pluginBuildLockProtocolDir(lockDir);
+    const retired = node_path_1.default.join(protocolRoot, PluginBuildLockProtocol_1.PluginBuildLockProtocol.PLUGIN_BUILD_LOCK_RETIRED_DIR);
+    if (!isOrdinaryCacheChild(protocolRoot, retired))
+        return true;
+    try {
+        for (const generation of node_fs_1.default.readdirSync(retired)) {
+            const location = node_path_1.default.join(retired, generation);
+            if (!isOrdinaryCacheChild(retired, location))
+                return true;
+            if (PluginBuildLockOwner_1.PluginBuildLockOwner.taskComplete(location, generation))
+                continue;
+            const owner = readQualifiedPluginCacheTaskOwner(location, generation);
+            if (owner === null || !PluginBuildLockOwner_1.PluginBuildLockOwner.gone(owner))
+                return true;
+        }
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Correlate a holder's absence proof with the generation being reclaimed. A
+ * syntactically valid but unrelated owner record cannot authorize payload or
+ * history deletion; its generation and the immutable generation file must
+ * identify this same task.
+ */
+function readQualifiedPluginCacheTaskOwner(location, generation) {
+    if (!PluginBuildLockProtocol_1.PluginBuildLockProtocol.isPluginBuildLockGeneration(generation)) {
+        return null;
+    }
+    try {
+        const recorded = node_fs_1.default
+            .readFileSync(node_path_1.default.join(location, PluginBuildLockProtocol_1.PluginBuildLockProtocol.PLUGIN_BUILD_LOCK_GENERATION_FILE), "utf8")
+            .trim();
+        if (recorded !== generation)
+            return null;
+        const owner = PluginBuildLockOwner_1.PluginBuildLockOwner.read(location);
+        return owner?.generation === generation ? owner : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Snapshot ordinary binary directories separately from coordination roots. */
+function collectPluginCacheEntries(root, now) {
+    const entries = [];
+    let dirents;
+    try {
+        dirents = node_fs_1.default.readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return entries;
+    }
+    for (const dirent of dirents) {
+        if (!dirent.isDirectory() ||
+            dirent.name.endsWith(".lock") ||
+            dirent.name.includes(".lock.")) {
+            continue;
+        }
+        const dir = node_path_1.default.join(root, dirent.name);
+        const lastUsedAt = readCacheEntryLastUsedAt(dir, now);
+        entries.push({
+            dir,
+            lastUsedAt,
+            size: directorySize(dir),
+        });
+    }
+    return entries;
+}
+/** Read usage metadata, falling back to binary or directory timestamps. */
+function readCacheEntryLastUsedAt(dir, now) {
+    const touched = SourceBuildCacheLayout_1.SourceBuildCacheLayout.readTimestamp(node_path_1.default.join(dir, SourceBuildCacheLayout_1.SourceBuildCacheLayout.CACHE_LAST_USED_FILE));
+    if (touched !== null) {
+        return touched;
+    }
+    for (const name of ["plugin", "plugin.exe"]) {
+        try {
+            return node_fs_1.default.statSync(node_path_1.default.join(dir, name)).mtimeMs;
+        }
+        catch { }
+    }
+    try {
+        return node_fs_1.default.statSync(dir).mtimeMs;
+    }
+    catch {
+        return now;
+    }
+}
+/** Sum ordinary payload-file bytes without following listed symbolic entries. */
+function directorySize(dir) {
+    let total = 0;
+    let entries;
+    try {
+        entries = node_fs_1.default.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return total;
+    }
+    for (const entry of entries) {
+        const file = node_path_1.default.join(dir, entry.name);
+        try {
+            if (entry.isDirectory()) {
+                total += directorySize(file);
+            }
+            else if (entry.isFile()) {
+                total += node_fs_1.default.statSync(file).size;
+            }
+        }
+        catch { }
+    }
+    return total;
+}
+/** Remove one binary payload while preserving independent lock capabilities. */
+function removeCacheEntry(entry) {
+    const lockDir = `${entry.dir}.lock`;
+    let lease = null;
+    try {
+        lease = (0, acquirePluginBuildLock_1.acquirePluginBuildLock)(lockDir);
+        if (lease === null) {
+            const observed = (0, inspectPluginBuildLock_1.inspectPluginBuildLock)(lockDir);
+            if (observed.state === "abandoned" && observed.fence.protocol === "v3") {
+                const current = node_path_1.default.join(PluginBuildLockProtocol_1.PluginBuildLockProtocol.pluginBuildLockProtocolDir(lockDir), PluginBuildLockProtocol_1.PluginBuildLockProtocol.PLUGIN_BUILD_LOCK_CURRENT_DIR);
+                const owner = readQualifiedPluginCacheTaskOwner(current, observed.fence.generation);
+                // One proven-dead generation may be retired before one acquisition
+                // retry. A deadline or missing owner never authorizes GC stealing.
+                if (owner !== null &&
+                    owner.generation === observed.fence.generation &&
+                    PluginBuildLockOwner_1.PluginBuildLockOwner.gone(owner) &&
+                    (0, reclaimPluginBuildLock_1.reclaimPluginBuildLock)(lockDir, observed.fence)) {
+                    lease = (0, acquirePluginBuildLock_1.acquirePluginBuildLock)(lockDir);
+                }
+            }
+        }
+        if (lease === null ||
+            pluginCacheEntryHasLiveV2Build(entry) ||
+            pluginCacheEntryHasUnfinishedRetiredTask(lockDir) ||
+            PluginBinaryUse_1.PluginBinaryUse.hasLiveOwners(entry.dir)) {
+            return false;
+        }
+        SourceNativeRetirement_1.SourceNativeRetirement.assertReleasable(PluginBuildLockProtocol_1.PluginBuildLockProtocol.pluginBuildLockProtocolDir(lockDir));
+        node_fs_1.default.rmSync(entry.dir, { recursive: true, force: true });
+        if (node_fs_1.default.existsSync(entry.dir))
+            return false;
+        return true;
+    }
+    catch {
+        // Failed acquisition or native sharing errors defer optional eviction.
+        return false;
+    }
+    finally {
+        if (lease !== null) {
+            try {
+                (0, releasePluginBuildLock_1.releasePluginBuildLock)(lockDir, lease);
+            }
+            catch {
+                // Preserve generation history; never remove a successor to force GC.
+            }
+        }
+    }
+}
+/**
+ * Reclaim v3 tombstones only when their owner and every registered observer are
+ * provably gone. Missing, malformed or unreadable ownership is retained. v2 has
+ * no observer registry and cannot supply this proof.
+ */
+function pruneRetiredLockGenerations(root) {
+    let names;
+    try {
+        names = node_fs_1.default.readdirSync(root);
+    }
+    catch {
+        return;
+    }
+    for (const name of names) {
+        if (!name.endsWith(".lock.v3"))
+            continue;
+        const protocolRoot = node_path_1.default.join(root, name);
+        if (!isOrdinaryCacheChild(root, protocolRoot))
+            continue;
+        const retired = node_path_1.default.join(protocolRoot, PluginBuildLockProtocol_1.PluginBuildLockProtocol.PLUGIN_BUILD_LOCK_RETIRED_DIR);
+        if (!isOrdinaryCacheChild(protocolRoot, retired))
+            continue;
+        let tombstones;
+        try {
+            tombstones = node_fs_1.default.readdirSync(retired);
+        }
+        catch {
+            continue;
+        }
+        for (const tombstone of tombstones) {
+            const location = node_path_1.default.join(retired, tombstone);
+            if (!isOrdinaryCacheChild(retired, location))
+                continue;
+            const owner = readQualifiedPluginCacheTaskOwner(location, tombstone);
+            if (owner === null || !PluginBuildLockOwner_1.PluginBuildLockOwner.gone(owner))
+                continue;
+            const observers = node_path_1.default.join(location, PluginBuildLockProtocol_1.PluginBuildLockProtocol.PLUGIN_BUILD_LOCK_OBSERVERS_DIR);
+            let allObserversGone = true;
+            try {
+                if (!isOrdinaryCacheChild(location, observers)) {
+                    // Absence is the valid no-observer state. A present alias or a
+                    // nonordinary entry cannot prove that registered observers are gone.
+                    node_fs_1.default.lstatSync(observers);
+                    continue;
+                }
+                for (const observer of node_fs_1.default.readdirSync(observers)) {
+                    const observerDirectory = node_path_1.default.join(observers, observer);
+                    if (!isOrdinaryCacheChild(observers, observerDirectory)) {
+                        allObserversGone = false;
+                        break;
+                    }
+                    const holder = PluginBuildLockOwner_1.PluginBuildLockOwner.read(observerDirectory);
+                    if (holder === null || !PluginBuildLockOwner_1.PluginBuildLockOwner.gone(holder)) {
+                        allObserversGone = false;
+                        break;
+                    }
+                }
+            }
+            catch (error) {
+                allObserversGone = error.code === "ENOENT";
+            }
+            if (!allObserversGone)
+                continue;
+            if (SourceNativeRetirement_1.SourceNativeRetirement.isProtected(protocolRoot))
+                continue;
+            try {
+                node_fs_1.default.rmSync(location, { recursive: true, force: true });
+            }
+            catch {
+                // Left for the next pass.
+            }
+        }
+    }
+}
+/** Require an ordinary immediate physical child before tombstone traversal. */
+function isOrdinaryCacheChild(parent, child) {
+    try {
+        const stats = node_fs_1.default.lstatSync(child);
+        return (stats.isDirectory() &&
+            !stats.isSymbolicLink() &&
+            node_path_1.default.dirname(node_fs_1.default.realpathSync.native(child)) === parent);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=prunePluginCacheRoot.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Whether a directory below a plugin source directory, named `name`, never
+ * contributes plugin source: `node_modules`, `.git`, and ttsc's own `.ttsc`.
+ *
+ * Nothing below such a directory can change the source's state
+ * (`pluginSourceState`), so a consumer observing a plugin source directory as a
+ * subtree passes over it rather than watching a nested package tree or a
+ * repository's object store.
+ *
+ * @param name The directory's own name, not its path.
+ * @evidence contracts/common.md#principled-implementation Delegating to GoSourceInputs makes observers exclude exactly the directory names excluded by source copying and cache keying.
+ * @evidence contracts/common.md#clear-and-simple-design The public predicate exposes shared source membership without exporting its Set representation to consumers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Pruned names are the declared source contract, not directories chosen after observing a particular consumer's build output.
+ * @evidence contracts/common.md#meaningful-documentation The prose identifies the owning source state and explains why subtree observers omit nested package and repository trees.
+ *
+ * @evidenceExclude contracts/performance.md#efficient-algorithms The accessor delegates a fixed-name membership query; the owning namespace selects its Set.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work There is no computed result shared across requests beyond the immutable policy definition.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The accessor owns no retained state or handle.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation prunesPluginSourceDirectory computes from its arguments only; it opens no file, builds no path and calls no platform or process API.
+ */
+export declare function prunesPluginSourceDirectory(name: string): boolean;

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

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prunesPluginSourceDirectory = prunesPluginSourceDirectory;
+const GoSourceInputs_1 = require("./GoSourceInputs");
+/**
+ * Whether a directory below a plugin source directory, named `name`, never
+ * contributes plugin source: `node_modules`, `.git`, and ttsc's own `.ttsc`.
+ *
+ * Nothing below such a directory can change the source's state
+ * (`pluginSourceState`), so a consumer observing a plugin source directory as a
+ * subtree passes over it rather than watching a nested package tree or a
+ * repository's object store.
+ *
+ * @param name The directory's own name, not its path.
+ * @evidence contracts/common.md#principled-implementation Delegating to GoSourceInputs makes observers exclude exactly the directory names excluded by source copying and cache keying.
+ * @evidence contracts/common.md#clear-and-simple-design The public predicate exposes shared source membership without exporting its Set representation to consumers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Pruned names are the declared source contract, not directories chosen after observing a particular consumer's build output.
+ * @evidence contracts/common.md#meaningful-documentation The prose identifies the owning source state and explains why subtree observers omit nested package and repository trees.
+ *
+ * @evidenceExclude contracts/performance.md#efficient-algorithms The accessor delegates a fixed-name membership query; the owning namespace selects its Set.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work There is no computed result shared across requests beyond the immutable policy definition.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The accessor owns no retained state or handle.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation prunesPluginSourceDirectory computes from its arguments only; it opens no file, builds no path and calls no platform or process API.
+ */
+function prunesPluginSourceDirectory(name) {
+    return GoSourceInputs_1.GoSourceInputs.shouldPruneDirectory(name);
+}
+//# sourceMappingURL=prunesPluginSourceDirectory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prunesPluginSourceDirectory.js","sourceRoot":"","sources":["../../../../src/plugin/internal/source/prunesPluginSourceDirectory.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAElD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qCAA4C,IAAY;IACtD,OAAO,+BAAc,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { PluginBuildLockFence } from "./PluginBuildLockFence";
+/**
+ * Retire exactly the generation carried by an abandoned observation.
+ *
+ * V3 retires by the observer-protected tombstone identity. Legacy retirement
+ * first confirms its captured fence; old legacy executables cannot provide
+ * atomic cooperation across their deletable path and the v3 namespace.
+ *
+ * Returns false when another retire already made progress or the fence is
+ * invalid; unexpected filesystem failures propagate.
+ *
+ * @evidence contracts/common.md#principled-implementation V3 retirement uses the observed generation's reserved destination; legacy retirement checks its recorded token before using a distinct legacy tombstone path.
+ * @evidence contracts/common.md#clear-and-simple-design One protocol dispatch delegates to the matching retirement primitive without taking acquisition or process-liveness responsibility.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Reclamation uses the caller's observed token rather than refreshing it to a successor or deleting current recursively; the legacy cooperation limitation remains explicit.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs describe the two protocol paths, race result, invalid fences, error propagation and the legacy limit before the tags.
+ * @evidence contracts/portability.md#os-neutral-implementation path.join and retireLockDirectory own native rename differences; Windows sharing refusals use its capability probe instead of weakening retirement to unlinking.
+ * @evidence contracts/performance.md#efficient-algorithms Retirement addresses one deterministic destination rather than scanning historical owners; costs include native path resolution and legacy fence JSON bytes. Eligible Windows refusals add sibling capability probes and synchronous poll waits, without a retry-count or elapsed-time bound; the probe does not establish a peer read as the refusal's cause.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Retirement changes ownership and cannot be reused as a cached boolean; repeated callers must attempt the generation's atomic destination themselves.
+ *
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Retirement transfers ownership into history; cooperating v3 collectors require holder/observer absence before removing it. Eligible native retries can block indefinitely, and best-effort probe removal may leave empty siblings. Legacy clients retain their documented cross-path cooperation limit.
+ */
+export declare function reclaimPluginBuildLock(lockDir: string, fence: PluginBuildLockFence): boolean;

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

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reclaimPluginBuildLock = reclaimPluginBuildLock;
+const node_path_1 = __importDefault(require("node:path"));
+const retireLockDirectory_1 = require("../../../internal/retireLockDirectory");
+const PluginBuildLockProtocol_1 = require("./PluginBuildLockProtocol");
+/**
+ * Retire exactly the generation carried by an abandoned observation.
+ *
+ * V3 retires by the observer-protected tombstone identity. Legacy retirement
+ * first confirms its captured fence; old legacy executables cannot provide
+ * atomic cooperation across their deletable path and the v3 namespace.
+ *
+ * Returns false when another retire already made progress or the fence is
+ * invalid; unexpected filesystem failures propagate.
+ *
+ * @evidence contracts/common.md#principled-implementation V3 retirement uses the observed generation's reserved destination; legacy retirement checks its recorded token before using a distinct legacy tombstone path.
+ * @evidence contracts/common.md#clear-and-simple-design One protocol dispatch delegates to the matching retirement primitive without taking acquisition or process-liveness responsibility.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Reclamation uses the caller's observed token rather than refreshing it to a successor or deleting current recursively; the legacy cooperation limitation remains explicit.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs describe the two protocol paths, race result, invalid fences, error propagation and the legacy limit before the tags.
+ * @evidence contracts/portability.md#os-neutral-implementation path.join and retireLockDirectory own native rename differences; Windows sharing refusals use its capability probe instead of weakening retirement to unlinking.
+ * @evidence contracts/performance.md#efficient-algorithms Retirement addresses one deterministic destination rather than scanning historical owners; costs include native path resolution and legacy fence JSON bytes. Eligible Windows refusals add sibling capability probes and synchronous poll waits, without a retry-count or elapsed-time bound; the probe does not establish a peer read as the refusal's cause.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Retirement changes ownership and cannot be reused as a cached boolean; repeated callers must attempt the generation's atomic destination themselves.
+ *
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Retirement transfers ownership into history; cooperating v3 collectors require holder/observer absence before removing it. Eligible native retries can block indefinitely, and best-effort probe removal may leave empty siblings. Legacy clients retain their documented cross-path cooperation limit.
+ */
+function reclaimPluginBuildLock(lockDir, fence) {
+    if (fence.protocol === "v3") {
+        return PluginBuildLockProtocol_1.PluginBuildLockProtocol.retireV3PluginBuildLock(PluginBuildLockProtocol_1.PluginBuildLockProtocol.pluginBuildLockProtocolDir(lockDir), fence.generation);
+    }
+    return fence.protocol === "legacy"
+        ? retireLegacyPluginBuildLock(lockDir, fence.generation)
+        : false;
+}
+function retireLegacyPluginBuildLock(lockDir, generation) {
+    if (!PluginBuildLockProtocol_1.PluginBuildLockProtocol.isPluginBuildLockGeneration(generation))
+        return false;
+    const captured = PluginBuildLockProtocol_1.PluginBuildLockProtocol.readLegacyPluginBuildLockFence(node_path_1.default.join(lockDir, PluginBuildLockProtocol_1.PluginBuildLockProtocol.PLUGIN_BUILD_LOCK_LEGACY_FENCE_DIR));
+    if (captured?.fence.generation !== generation) {
+        return false;
+    }
+    return (0, retireLockDirectory_1.retireLockDirectory)(lockDir, `${lockDir}.retired-${generation}`, () => PluginBuildLockProtocol_1.PluginBuildLockProtocol.sleepSync(PluginBuildLockProtocol_1.PluginBuildLockProtocol.PLUGIN_BUILD_LOCK_POLL_MS));
+}
+//# sourceMappingURL=reclaimPluginBuildLock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reclaimPluginBuildLock.js","sourceRoot":"","sources":["../../../../src/plugin/internal/source/reclaimPluginBuildLock.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAE7B,+EAA4E;AAE5E,uEAAoE;AAEpE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,gCACE,OAAe,EACf,KAA2B;IAE3B,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,iDAAuB,CAAC,uBAAuB,CACpD,iDAAuB,CAAC,0BAA0B,CAAC,OAAO,CAAC,EAC3D,KAAK,CAAC,UAAU,CACjB,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAChC,CAAC,CAAC,2BAA2B,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC;QACxD,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC;AAED,SAAS,2BAA2B,CAClC,OAAe,EACf,UAAkB;IAElB,IAAI,CAAC,iDAAuB,CAAC,2BAA2B,CAAC,UAAU,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,MAAM,QAAQ,GAAG,iDAAuB,CAAC,8BAA8B,CACrE,mBAAI,CAAC,IAAI,CACP,OAAO,EACP,iDAAuB,CAAC,kCAAkC,CAC3D,CACF,CAAC;IACF,IAAI,QAAQ,EAAE,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAA,yCAAmB,EAAC,OAAO,EAAE,GAAG,OAAO,YAAY,UAAU,EAAE,EAAE,GAAG,EAAE,CAC3E,iDAAuB,CAAC,SAAS,CAC/B,iDAAuB,CAAC,yBAAyB,CAClD,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Record a use of a single-file cache entry by setting its modification time,
+ * which `pruneCacheFileRoot` reads as its last use. A hit that cannot record it
+ * still answers: the entry may then age out a use early and be computed again.
+ *
+ * Pre-existing symbolic or multiply linked entries are left untouched so a
+ * restored alias is rejected by the initial lstat. The later path-based utimes
+ * is a separate operation, not an atomic inode-identity check against
+ * replacement.
+ *
+ * @evidence contracts/common.md#principled-implementation A successful cache hit advances the file's mtime used by age/LRU pruning; a failed refresh cannot invalidate an already obtained answer.
+ * @evidence contracts/common.md#clear-and-simple-design This helper changes only usage metadata and leaves answer validation to the reader and eviction to the collector.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Actual hit usage drives the timestamp, without recognized keys, expected answers or foreign API patches.
+ * @evidence contracts/common.md#meaningful-documentation Separate native paragraphs explain failed-refresh consequences and pre-existing alias rejection without confusing usage metadata with answer validity.
+ * @evidence contracts/portability.md#os-neutral-implementation Node utimes uses native file timestamp semantics; callers supply an owned cache entry and failures are tolerated rather than assuming a platform's open-file permissions.
+ * @evidence contracts/performance.md#efficient-algorithms An lstat admission probe precedes at most one timestamp update, avoiding answer-byte rewrites. Both are synchronous native path operations with path-text and filesystem costs, not a constant elapsed-time bound.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work The owning reader validates equivalent answers; this helper merely records a completed hit.
+ *
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Best-effort mtime updates influence the collector's age/LRU policy using the current wall clock; skipped/failed refreshes or clock changes do not guarantee postponement. This helper retains no handle and provides no storage-size bound.
+ */
+export declare function recordCacheFileUse(file: string): void;