veryfront 0.1.1239 → 0.1.1241

package/esm/src/platform/adapters/fs/cache/file-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/cache/file-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAc,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkC3E;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,CAwBnE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,GAAE,gBAAqB;IAc1C,OAAO,CAAC,UAAU;IAKlB;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IA4BlC;;;OAGG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAmChD;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IA+BnC;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BjD,mEAAmE;IACnE,OAAO,CAAC,aAAa;IAWrB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAezB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAM5B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe1C,8FAA8F;IAC9F,OAAO,CAAC,kBAAkB;IAY1B,qGAAqG;IACrG,OAAO,CAAC,2BAA2B;IAanC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAatC,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBpD,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAa/D,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB7E,KAAK,IAAI,IAAI;IAOb,KAAK,IAAI,UAAU,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;IAazC,YAAY,IAAI,MAAM;IAetB,OAAO,CAAC,qBAAqB;CAoB9B"}
+{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/cache/file-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAc,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkC3E;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,CAwBnE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,GAAE,gBAAqB;IAc1C,OAAO,CAAC,UAAU;IAKlB;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IA4BlC;;;OAGG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAmChD;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IA+BnC;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BjD,mEAAmE;IACnE,OAAO,CAAC,aAAa;IAWrB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAezB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAM5B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB1C,8FAA8F;IAC9F,OAAO,CAAC,kBAAkB;IAY1B,qGAAqG;IACrG,OAAO,CAAC,2BAA2B;IAanC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAatC,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBpD,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAa/D,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB7E,KAAK,IAAI,IAAI;IAOb,KAAK,IAAI,UAAU,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;IAazC,YAAY,IAAI,MAAM;IAetB,OAAO,CAAC,qBAAqB;CAoB9B"}

package/esm/src/platform/adapters/fs/cache/file-cache.js

@@ -255,6 +255,11 @@ export class FileCache {
     deleteAsync(key) {
         return withSpan("platform.fs.cache.deleteAsync", async () => {
             const deletedFromFallback = this.delete(key);
+            // setAsync() publishes distributed writes into the request-scoped
+            // cache before awaiting the backend. Invalidate that view as part of
+            // the same delete, or this request can keep reading a value that the
+            // backend no longer contains.
+            setInRequestCache(key, null);
             const backend = this.getBackend();
             if (backend) {
                 await backend.del(key);

package/esm/src/platform/adapters/fs/veryfront/adapter.d.ts

@@ -20,6 +20,18 @@ export declare class VeryfrontFSAdapter implements FSAdapter {
     /** Single-flight background rewarm when the file list cache disappears */
     private fileListWarmupPromise;
     private fileListWarmupKey;
+    /**
+     * Last listing this adapter fetched or was poked with, kept in memory because
+     * a cache write is not guaranteed to retain it: writes are skipped entirely
+     * when caching is disabled, oversized listings are dropped by the memory
+     * cache, and backend writes can fail. Without this, every module lookup of a
+     * render would miss the cache and await its own full listing fetch -- more
+     * API traffic than the per-file probing this replaced. It expires with the
+     * same TTL as the cache entry it stands in for and is dropped by every
+     * invalidation, so it is never fresher or staler than a retained cache write.
+     */
+    private retainedFileList;
+    private readonly fileListRetentionMs;
     /** Single-flight foreground refresh when a branch preview read misses a newly pushed file. */
     private branchMissRecoveryPromise;
     private branchMissRecoveryGeneration;
@@ -53,6 +65,27 @@ export declare class VeryfrontFSAdapter implements FSAdapter {
     private syncClientContext;
     private getCachedFileListSync;
     private getCachedFileListAsync;
+    /** Keep `files` answerable from memory for as long as a cache write would. */
+    private retainFileList;
+    private clearRetainedFileList;
+    /**
+     * The retained listing, if it still describes the snapshot the caller is
+     * reading. Anything that supersedes the snapshot -- a poke, a refresh, a
+     * branch or token change -- either drops it outright or moves the snapshot
+     * version past it, so a superseded listing can never answer a read.
+     */
+    private readRetainedFileList;
+    /**
+     * Wait for the in-flight file-list warmup for `cacheKey` and return the
+     * fetched listing. SSR module resolution reads this list for every module of
+     * a page; when the cached listing has expired, answering "no list" makes each
+     * module fall back to its own per-file/per-extension API probing (dozens of
+     * sequential fetches per render). Paying for one awaited listing fetch keeps
+     * that fan-out at a single API call while staying exactly as fresh: the
+     * listing is fetched from the API at request time. Warmup failures resolve to
+     * undefined so callers keep the legacy per-file fallback.
+     */
+    private awaitFileListWarmup;
     constructor(config: FSAdapterConfig);
     initialize(): Promise<void>;
     private isPersistentCacheInvalidated;
@@ -64,6 +97,12 @@ export declare class VeryfrontFSAdapter implements FSAdapter {
     private refreshBranchSnapshotAfterMiss;
     private withBranchSnapshotRecovery;
     private scheduleFileListWarmup;
+    /**
+     * Drop every in-memory view of the current source snapshot. Used by pokes
+     * that invalidate without carrying replacement files inline, so the next read
+     * re-derives everything from the API rather than from a superseded listing.
+     */
+    private clearMemoryCaches;
     private markSourceSnapshotChanged;
     private runSourceSnapshotMutation;
     private replaceSourceSnapshot;

package/esm/src/platform/adapters/fs/veryfront/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/adapter.ts"],"names":[],"mappings":"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"}

package/esm/src/platform/adapters/fs/veryfront/adapter.js

@@ -10,7 +10,7 @@ import { buildDirCacheKeyPrefix, buildFileCacheKeyPrefix, buildFileListCacheKey,
 import { isPrefixBeingInvalidated } from "./invalidation-state.js";
 import { WebSocketManager } from "./websocket-manager.js";
 import { fetchFileListForContext, hasContentContextChanged, resolveContentContext, summarizeFileList, toClientContext, } from "./adapter-content-context.js";
-import { buildFileCacheOptions, buildRetryConfig, shouldBackgroundPregenerateStyles, } from "./adapter-helpers.js";
+import { buildFileCacheOptions, buildRetryConfig, DEFAULT_CACHE_TTL_MS, shouldBackgroundPregenerateStyles, } from "./adapter-helpers.js";
 import { isNotFoundLikeError } from "./read-operations-helpers.js";
 import { DEFAULT_VERYFRONT_API_SUCCESS_BODY_BYTES } from "../../veryfront-api-transport.js";
 import { requireBoundedFileReadLimit } from "../../bounded-file-read.js";
@@ -74,6 +74,18 @@ export class VeryfrontFSAdapter {
     // entirely when caching is disabled, and can fail on a backend cache.
     fileListWarmupPromise = null;
     fileListWarmupKey = null;
+    /**
+     * Last listing this adapter fetched or was poked with, kept in memory because
+     * a cache write is not guaranteed to retain it: writes are skipped entirely
+     * when caching is disabled, oversized listings are dropped by the memory
+     * cache, and backend writes can fail. Without this, every module lookup of a
+     * render would miss the cache and await its own full listing fetch -- more
+     * API traffic than the per-file probing this replaced. It expires with the
+     * same TTL as the cache entry it stands in for and is dropped by every
+     * invalidation, so it is never fresher or staler than a retained cache write.
+     */
+    retainedFileList = null;
+    fileListRetentionMs;
     /** Single-flight foreground refresh when a branch preview read misses a newly pushed file. */
     branchMissRecoveryPromise = null;
     branchMissRecoveryGeneration = 0;
@@ -136,24 +148,81 @@ export class VeryfrontFSAdapter {
             return undefined;
         return this.cache.get(cacheKey);
     }
-    async getCachedFileListAsync(noContextMessage, lookupLabel, missReason) {
+    async getCachedFileListAsync(noContextMessage, lookupLabel, missReason, options = {}) {
         const cacheKey = this.getCurrentFileListCacheKey();
         if (!cacheKey) {
             logger.debug(noContextMessage);
             return undefined;
         }
-        const files = await this.cache.getAsync(cacheKey);
+        let files = await this.cache.getAsync(cacheKey);
         logger.debug(`${lookupLabel} lookup`, {
             cacheKey,
             hasResult: !!files,
             resultSize: files?.length ?? 0,
             hasContent: files?.filter((file) => !!file.content)?.length ?? 0,
         });
-        if (!files?.length) {
+        if (files === undefined) {
+            files = this.readRetainedFileList(cacheKey);
+        }
+        if (files === undefined) {
             this.scheduleFileListWarmup(missReason, cacheKey);
+            if (options.waitForWarmup) {
+                files = await this.awaitFileListWarmup(cacheKey) ?? files;
+            }
         }
         return { cacheKey, files };
     }
+    /** Keep `files` answerable from memory for as long as a cache write would. */
+    retainFileList(cacheKey, files) {
+        this.retainedFileList = {
+            cacheKey,
+            files,
+            snapshotVersion: this.sourceSnapshotVersion,
+            retainedAt: Date.now(),
+        };
+    }
+    clearRetainedFileList() {
+        this.retainedFileList = null;
+    }
+    /**
+     * The retained listing, if it still describes the snapshot the caller is
+     * reading. Anything that supersedes the snapshot -- a poke, a refresh, a
+     * branch or token change -- either drops it outright or moves the snapshot
+     * version past it, so a superseded listing can never answer a read.
+     */
+    readRetainedFileList(cacheKey) {
+        const retained = this.retainedFileList;
+        if (!retained)
+            return undefined;
+        if (retained.cacheKey !== cacheKey ||
+            retained.snapshotVersion !== this.sourceSnapshotVersion) {
+            this.clearRetainedFileList();
+            return undefined;
+        }
+        if (Date.now() - retained.retainedAt > this.fileListRetentionMs) {
+            logger.debug("Retained file list expired", { cacheKey });
+            this.clearRetainedFileList();
+            return undefined;
+        }
+        return retained.files;
+    }
+    /**
+     * Wait for the in-flight file-list warmup for `cacheKey` and return the
+     * fetched listing. SSR module resolution reads this list for every module of
+     * a page; when the cached listing has expired, answering "no list" makes each
+     * module fall back to its own per-file/per-extension API probing (dozens of
+     * sequential fetches per render). Paying for one awaited listing fetch keeps
+     * that fan-out at a single API call while staying exactly as fresh: the
+     * listing is fetched from the API at request time. Warmup failures resolve to
+     * undefined so callers keep the legacy per-file fallback.
+     */
+    async awaitFileListWarmup(cacheKey) {
+        const warmupPromise = this.fileListWarmupPromise;
+        if (!warmupPromise || this.fileListWarmupKey !== cacheKey)
+            return undefined;
+        const fetched = await warmupPromise;
+        return fetched === null ? undefined : fetched;
+    }
     constructor(config) {
         this.invalidationCallbacks = config.invalidationCallbacks ?? {};
         this.styleCallbacks = config.styleCallbacks ?? {};
@@ -182,6 +251,7 @@ export class VeryfrontFSAdapter {
         });
         const cacheConfig = buildFileCacheOptions(vf.cache);
         this.cache = new FileCache(cacheConfig);
+        this.fileListRetentionMs = cacheConfig.ttl ?? DEFAULT_CACHE_TTL_MS;
         this.normalizer = new PathNormalizer(config.projectDir);
         // Per-releaseId fetcher registration is done in setContentContext when a
         // release context is resolved, ensuring the correct project-scoped token.
@@ -190,12 +260,14 @@ export class VeryfrontFSAdapter {
             getReleaseId: () => this.contentContext?.releaseId ?? null,
             getContentContext: () => this.contentContext,
             getFileList: async () => {
-                const cached = await this.getCachedFileListAsync("getFileList: no contentContext", "getFileList", "getFileList miss");
+                const cached = await this.getCachedFileListAsync("getFileList: no contentContext", "getFileList", "getFileList miss", {
+                    waitForWarmup: true,
+                });
                 return cached?.files;
             },
             hasCachedFileList: async () => {
-                const cached = await this.getCachedFileListAsync("hasCachedFileList: no contentContext", "hasCachedFileList", "hasCachedFileList miss");
-                return Array.isArray(cached?.files) && cached.files.length > 0;
+                const cached = await this.getCachedFileListAsync("hasCachedFileList: no contentContext", "hasCachedFileList", "hasCachedFileList miss", { waitForWarmup: true });
+                return Array.isArray(cached?.files);
             },
             isPersistentCacheInvalidated: (prefix) => this.isPersistentCacheInvalidated(prefix),
             isReleaseBeingInvalidated: (releaseId) => this.isPersistentCacheInvalidated(buildFileCacheKeyPrefix({
@@ -206,7 +278,7 @@ export class VeryfrontFSAdapter {
         };
         this.statOps = new StatOperations(this.client, this.cache, this.normalizer, contentContextGetter);
         this.readOps = new ReadOperations(this.client, this.cache, this.normalizer, contentContextGetter, (path) => this.statOps.getOriginalApiPath(path), async () => {
-            const cached = await this.getCachedFileListAsync("getFileListCache: no contentContext", "getFileListCache", "getFileListCache miss");
+            const cached = await this.getCachedFileListAsync("getFileListCache: no contentContext", "getFileListCache", "getFileListCache miss", { waitForWarmup: true });
             return cached?.files;
         });
         this.dirOps = new DirectoryOperations(this.client, this.cache, this.normalizer, contentContextGetter);
@@ -220,13 +292,9 @@ export class VeryfrontFSAdapter {
             getContentContext: () => this.contentContext,
             getContentSource: () => this.contentSource,
             getProjectDir: () => this.normalizer.getProjectDir(),
-            clearMemoryCaches: () => {
-                clearCachedReleaseAssetManifests();
-                this.readOps.clearFileListIndex();
-                this.statOps.clearIndex();
-                this.dirOps.clearTree();
-            },
-            replaceSourceSnapshot: (cacheKey, files) => this.replaceSourceSnapshot(cacheKey, files),
+            clearMemoryCaches: () => this.clearMemoryCaches(),
+            getSourceSnapshotVersion: () => this.sourceSnapshotVersion,
+            replaceSourceSnapshot: (cacheKey, files, expectedSnapshotVersion) => this.replaceSourceSnapshot(cacheKey, files, expectedSnapshotVersion),
             pregenerateStyles: (files) => this.triggerCSSPregeneration(files),
         });
         logger.debug("Created", {
@@ -303,15 +371,34 @@ export class VeryfrontFSAdapter {
             releaseId: contentContext.releaseId,
         });
         const cacheKey = buildFileListCacheKey(contentContext);
+        const initializationIdentity = this.getCurrentSourceSnapshotIdentity();
+        const initializationSnapshotVersion = this.sourceSnapshotVersion;
         logger.debug("Step 4: fetchFileList START", { projectSlug, cacheKey });
         try {
             const files = await fetchFileListForContext(this.client, contentContext);
             const fileSummary = summarizeFileList(files);
-            await this.cache.setAsync(cacheKey, files);
-            this.markSourceSnapshotChanged(files);
+            const initialSnapshotApplied = await this.runSourceSnapshotMutation(async () => {
+                const isSnapshotSuperseded = () => this.contentContext !== contentContext ||
+                    this.getCurrentSourceSnapshotIdentity() !== initializationIdentity ||
+                    this.sourceSnapshotVersion !== initializationSnapshotVersion;
+                if (isSnapshotSuperseded())
+                    return false;
+                await this.cache.setAsync(cacheKey, files);
+                if (isSnapshotSuperseded()) {
+                    await this.cache.deleteAsync(cacheKey);
+                    return false;
+                }
+                this.markSourceSnapshotChanged(files, initializationIdentity);
+                // Retain after the generation bump so the first read can reuse the
+                // initialized snapshot even when the configured cache keeps nothing.
+                this.retainFileList(cacheKey, files);
+                return true;
+            });
             this.fileListReadyResolve?.();
             this.fileListReadyResolve = null;
-            logger.debug("Fetched files during initialization", {
+            logger.debug(initialSnapshotApplied
+                ? "Fetched files during initialization"
+                : "Discarded initialization files superseded by a newer source snapshot", {
                 cacheKey,
                 totalFiles: fileSummary.totalFiles,
                 filesWithContent: fileSummary.filesWithContent,
@@ -321,7 +408,9 @@ export class VeryfrontFSAdapter {
             // Trigger CSS pre-generation after the initial file snapshot is ready for
             // published contexts. Branch previews should first try remote metadata
             // recovery on cold starts instead of repopulating the prepared cache here.
-            if (fileSummary.sourceFilesWithContent > 0 && this.shouldBackgroundPregenerateStyles()) {
+            if (initialSnapshotApplied &&
+                fileSummary.sourceFilesWithContent > 0 &&
+                this.shouldBackgroundPregenerateStyles()) {
                 this.triggerCSSPregeneration(files).catch(() => {
                     // Error already logged in triggerCSSPregeneration
                 });
@@ -329,14 +418,15 @@ export class VeryfrontFSAdapter {
             this.initialized = true;
             logger.debug("initialize COMPLETE", {
                 projectSlug,
-                fileCount: files.length,
+                fileCount: initialSnapshotApplied ? files.length : 0,
                 totalDuration: `${(performance.now() - initStartTime).toFixed(2)}ms`,
             });
-            if (contentContext.sourceType === "branch") {
+            const initializedContext = this.contentContext;
+            if (initializedContext?.sourceType === "branch") {
                 logger.debug("Initialized (branch mode)", {
                     projectId: this.client.getProjectId(),
-                    files: files.length,
-                    branch: contentContext.branch,
+                    files: initialSnapshotApplied ? files.length : 0,
+                    branch: initializedContext.branch,
                     proxyMode: this.proxyMode,
                 });
                 this.wsManager.connect(projectId);
@@ -344,14 +434,14 @@ export class VeryfrontFSAdapter {
             }
             logger.debug("Initialized (published mode)", {
                 projectId: this.client.getProjectId(),
-                files: files.length,
-                sourceType: contentContext.sourceType,
-                environmentName: contentContext.environmentName,
-                releaseId: contentContext.releaseId,
+                files: initialSnapshotApplied ? files.length : 0,
+                sourceType: initializedContext?.sourceType,
+                environmentName: initializedContext?.environmentName,
+                releaseId: initializedContext?.releaseId,
             });
             // Keep a WebSocket connection in environment mode to receive deployment pokes.
             // Release mode is immutable, so no need to keep a live connection.
-            if (contentContext.sourceType === "environment") {
+            if (initializedContext?.sourceType === "environment") {
                 this.wsManager.connect(projectId);
             }
         }
@@ -490,11 +580,12 @@ export class VeryfrontFSAdapter {
             return;
         }
         const warmupContext = this.contentContext;
+        const warmupSnapshotVersion = this.sourceSnapshotVersion;
         let warmupPromise = null;
         warmupPromise = (async () => {
             try {
                 const existing = await this.cache.getAsync(effectiveCacheKey);
-                if (existing?.length) {
+                if (existing !== undefined) {
                     logger.debug("Skipping file list warmup because cache is already populated", {
                         reason,
                         cacheKey: effectiveCacheKey,
@@ -511,7 +602,37 @@ export class VeryfrontFSAdapter {
                     releaseId: warmupContext.releaseId,
                 });
                 const files = await fetchFileListForContext(this.client, warmupContext);
-                await this.cache.setAsync(effectiveCacheKey, files);
+                // A WebSocket snapshot can land while this fetch is open. Publishing
+                // the pre-poke listing would roll both the cache and this caller's
+                // answer back to the older draft, so the write is serialized against
+                // snapshot mutations and stands down when one won the race.
+                const applied = await this.runSourceSnapshotMutation(async () => {
+                    if (this.contentContext !== warmupContext ||
+                        this.sourceSnapshotVersion !== warmupSnapshotVersion) {
+                        return false;
+                    }
+                    await this.cache.setAsync(effectiveCacheKey, files);
+                    // A poke can advance the generation while a distributed cache write
+                    // is pending. Remove the value that just landed before releasing the
+                    // mutation lock, so neither this waiter nor a later read sees it.
+                    if (this.contentContext !== warmupContext ||
+                        this.sourceSnapshotVersion !== warmupSnapshotVersion) {
+                        await this.cache.deleteAsync(effectiveCacheKey);
+                        return false;
+                    }
+                    this.retainFileList(effectiveCacheKey, files);
+                    return true;
+                });
+                if (!applied) {
+                    logger.debug("Discarding file list warmup superseded by a newer source snapshot", {
+                        reason,
+                        cacheKey: effectiveCacheKey,
+                    });
+                    // Answer with the snapshot that superseded this fetch rather than
+                    // the listing it carries, so the caller stays as fresh as the poke.
+                    return await this.cache.getAsync(effectiveCacheKey) ?? this.readRetainedFileList(effectiveCacheKey) ??
+                        null;
+                }
                 const fileSummary = summarizeFileList(files);
                 if (fileSummary.sourceFilesWithContent > 0 && this.shouldBackgroundPregenerateStyles()) {
                     this.triggerCSSPregeneration(files).catch(() => {
@@ -546,6 +667,22 @@ export class VeryfrontFSAdapter {
         // That collaborator only needs completion, not the payload.
         this.readOps.setFileListReadyPromise(warmupPromise.then(() => { }));
     }
+    /**
+     * Drop every in-memory view of the current source snapshot. Used by pokes
+     * that invalidate without carrying replacement files inline, so the next read
+     * re-derives everything from the API rather than from a superseded listing.
+     */
+    clearMemoryCaches() {
+        clearCachedReleaseAssetManifests();
+        // An accepted poke may clear memory before its debounced replacement
+        // listing arrives. Advance the generation immediately so an older warmup
+        // cannot repopulate the cache or answer a waiting read in that window.
+        this.sourceSnapshotVersion = nextSourceSnapshotGeneration();
+        this.clearRetainedFileList();
+        this.readOps.clearFileListIndex();
+        this.statOps.clearIndex();
+        this.dirOps.clearTree();
+    }
     markSourceSnapshotChanged(files, identity = this.getCurrentSourceSnapshotIdentity()) {
         this.sourceSnapshotFiles = files;
         this.sourceSnapshotIdentity = identity;
@@ -559,19 +696,34 @@ export class VeryfrontFSAdapter {
         this.sourceSnapshotMutationTail = mutation.then(() => undefined, () => undefined);
         return mutation;
     }
-    replaceSourceSnapshot(cacheKey, files) {
+    replaceSourceSnapshot(cacheKey, files, expectedSnapshotVersion = this.sourceSnapshotVersion) {
+        const expectedContext = this.contentContext;
         return this.runSourceSnapshotMutation(async () => {
-            const context = this.contentContext;
-            if (!context || buildFileListCacheKey(context) !== cacheKey) {
-                logger.debug("Discarding source snapshot for superseded content context", {
+            if (!expectedContext ||
+                this.contentContext !== expectedContext ||
+                this.sourceSnapshotVersion !== expectedSnapshotVersion ||
+                buildFileListCacheKey(expectedContext) !== cacheKey) {
+                logger.debug("Discarding superseded source snapshot", {
                     cacheKey,
                     projectSlug: this.projectSlug,
                 });
-                return;
+                return undefined;
             }
             await this.cache.setAsync(cacheKey, files);
+            if (this.contentContext !== expectedContext ||
+                this.sourceSnapshotVersion !== expectedSnapshotVersion) {
+                // A newer poke invalidated this replacement while its distributed
+                // cache write was pending. Remove the value that just landed and leave
+                // memory empty so the next read derives the newer snapshot.
+                await this.cache.deleteAsync(cacheKey);
+                return undefined;
+            }
             this.readOps.clearFileListIndex();
             this.markSourceSnapshotChanged(files);
+            // Retain after the version bump so the poked listing -- not the one it
+            // replaced -- is what later reads see when the cache keeps nothing.
+            this.retainFileList(cacheKey, files);
+            return this.sourceSnapshotVersion;
         });
     }
     async invalidateDerivedSourceCaches() {
@@ -608,15 +760,17 @@ export class VeryfrontFSAdapter {
         const previousVersion = this.sourceSnapshotVersion;
         const files = await fetchFileListForContext(this.client, refreshContext);
         const result = await this.runSourceSnapshotMutation(async () => {
-            if (this.contentContext !== refreshContext ||
+            const isSnapshotSuperseded = () => this.contentContext !== refreshContext ||
                 this.getCurrentSourceSnapshotIdentity() !== refreshIdentity ||
-                this.sourceSnapshotVersion !== previousVersion) {
+                this.sourceSnapshotVersion !== previousVersion;
+            if (isSnapshotSuperseded()) {
                 return { applied: false, sourceChanged: false };
             }
             const sourceChanged = !sourceSnapshotsEqual(previousFiles, files);
             if (sourceChanged) {
                 this.fileListWarmupPromise = null;
                 this.fileListWarmupKey = null;
+                this.clearRetainedFileList();
                 this.readOps.clearFileListIndex();
                 this.statOps.clearIndex();
                 this.dirOps.clearTree();
@@ -626,11 +780,21 @@ export class VeryfrontFSAdapter {
                     this.cache.deleteByPrefixAsync(buildDirCacheKeyPrefix(refreshContext)),
                     this.cache.deleteAsync(cacheKey),
                 ]);
+                if (isSnapshotSuperseded()) {
+                    return { applied: false, sourceChanged: false };
+                }
             }
             await this.cache.setAsync(cacheKey, files);
-            this.branchMissRecoveryFailures.clear();
+            if (isSnapshotSuperseded()) {
+                await this.cache.deleteAsync(cacheKey);
+                return { applied: false, sourceChanged: false };
+            }
             if (sourceChanged) {
                 await this.invalidateDerivedSourceCaches();
+                if (isSnapshotSuperseded()) {
+                    await this.cache.deleteAsync(cacheKey);
+                    return { applied: false, sourceChanged: false };
+                }
                 // Publish freshness only after every cache derived from the previous
                 // snapshot has been invalidated. Concurrent followers remain attached
                 // to the refresh singleflight until this point.
@@ -641,6 +805,8 @@ export class VeryfrontFSAdapter {
                 this.sourceSnapshotIdentity = refreshIdentity;
                 this.sourceSnapshotCheckedAt = Date.now();
             }
+            this.branchMissRecoveryFailures.clear();
+            this.retainFileList(cacheKey, files);
             return { applied: true, sourceChanged };
         });
         if (!result.applied) {
@@ -770,6 +936,7 @@ export class VeryfrontFSAdapter {
         this.exactReadInitializationGeneration++;
         this.fileListWarmupPromise = null;
         this.fileListWarmupKey = null;
+        this.clearRetainedFileList();
         this.branchMissRecoveryPromise = null;
         this.branchMissRecoveryGeneration++;
         this.branchMissRecoveryFailures.clear();
@@ -804,12 +971,12 @@ export class VeryfrontFSAdapter {
         // populates it for a release-backed context, so returning early meant the
         // list was empty on every request for the life of the process. Wait for the
         // fetch this read just started, then look again.
-        if (options.waitForWarmup && cacheKey && !files?.length && this.fileListWarmupPromise) {
+        if (options.waitForWarmup && cacheKey && files === undefined && this.fileListWarmupPromise) {
             // Take what the fetch returned rather than re-reading the cache: with
             // caching disabled, or a failed backend write, the cache keeps nothing
             // and correctness would depend on a write that never happened.
             const fetched = await this.fileListWarmupPromise;
-            files = fetched?.length
+            files = fetched !== null
                 ? fetched
                 : await this.cache.getAsync(cacheKey);
         }
@@ -883,6 +1050,7 @@ export class VeryfrontFSAdapter {
     }
     invalidateRequestAuthoritySnapshot() {
         this.cache.clear();
+        this.clearRetainedFileList();
         this.readOps.clearFileListIndex();
         this.statOps.clearIndex();
         this.dirOps.clearTree();
@@ -945,6 +1113,7 @@ export class VeryfrontFSAdapter {
             this.dirOps.clearTree();
             this.fileListWarmupPromise = null;
             this.fileListWarmupKey = null;
+            this.clearRetainedFileList();
             this.branchMissRecoveryPromise = null;
             this.branchMissRecoveryGeneration++;
             this.branchMissRecoveryFailures.clear();

package/esm/src/platform/adapters/fs/veryfront/file-list-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-list-index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/file-list-index.ts"],"names":[],"mappings":"AAIA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,yBAAyB,GAAG,KAAK,CAAC;IACtE,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAeD,qBAAa,aAAa;IAStB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IARpC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAA8B;gBAG/B,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC,aAAA;IAG1F,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI7C,KAAK,IAAI,IAAI;YAYC,WAAW;IAWnB,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK3D,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8C3D,oBAAoB,CACxB,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAMnD,cAAc,CAClB,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,mBAAmB,CAAC;YA6BjB,UAAU;CAoGzB"}
+{"version":3,"file":"file-list-index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/file-list-index.ts"],"names":[],"mappings":"AAIA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,yBAAyB,GAAG,KAAK,CAAC;IACtE,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,aAAa;IAStB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IARpC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAA8B;gBAG/B,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC,aAAA;IAG1F,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI7C,KAAK,IAAI,IAAI;YAYC,WAAW;IAWnB,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK3D,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4C3D,oBAAoB,CACxB,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAMnD,cAAc,CAClB,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,mBAAmB,CAAC;YA6BjB,UAAU;CAiGzB"}

package/esm/src/platform/adapters/fs/veryfront/file-list-index.js

@@ -1,14 +1,5 @@
 import { logger as baseLogger } from "../../../../utils/index.js";
 const logger = baseLogger.component("read-operations");
-function hashPreview(content) {
-    return content
-        .slice(0, 100)
-        .split("")
-        .reduce((h, c) => ((h << 5) - h + c.charCodeAt(0)) | 0, 0);
-}
-function previewText(content, max = 80) {
-    return content.length > max ? `${content.slice(0, max)}...` : content;
-}
 const INDEX_STALENESS_LIMIT_MS = 5 * 60 * 1000; // 5 minutes
 export class FileListIndex {
     getFileListCache;
@@ -80,8 +71,6 @@ export class FileListIndex {
         logger.debug("FILE_LIST_CACHE_HIT - serving from file list cache", {
             path: normalizedPath,
             contentLength: content.length,
-            contentHash: hashPreview(content),
-            contentPreview: previewText(content, 200).replace(/\n/g, "\\n"),
         });
         return {
             status: "hit",
@@ -165,7 +154,6 @@ export class FileListIndex {
             filesWithContent: fileList.filter((f) => f.content).length,
             sampleFilePath: cacheCheckSample?.path,
             sampleContentLength: cacheCheckSample?.content?.length,
-            sampleContentPreview: cacheCheckSample?.content?.slice(0, 200)?.replace(/\n/g, "\\n"),
         });
         const indexKey = `${fileList.length}:${fileList[0]?.path ?? ""}:${fileList[fileList.length - 1]?.path ?? ""}`;
         if (this.index && this.pathSet && this.indexKey === indexKey) {
@@ -196,8 +184,6 @@ export class FileListIndex {
             indexedWithContent: index.size,
             sampleFilePath: sampleFile?.path,
             sampleContentLength: sampleContent?.length,
-            sampleContentHash: sampleContent ? hashPreview(sampleContent) : undefined,
-            sampleContentPreview: sampleContent?.slice(0, 200)?.replace(/\n/g, "\\n"),
         });
         return {
             content: index,

package/esm/src/platform/adapters/fs/veryfront/read-operations-helpers.d.ts

@@ -31,7 +31,6 @@ interface BuildReadFetchStateOptions {
 export declare function assertProjectSourcePath(normalizedPath: string): void;
 export declare function buildReadFetchState(options: BuildReadFetchStateOptions): ReadFetchState;
 export declare function getResolvedCacheKey(cacheKeyPrefix: string, normalizedResolvedPath: string): string;
-export declare function buildContentPreview(content: string, max?: number): string;
 export declare function buildExtensionCandidatePaths(basePath: string): string[];
 export declare function splitKnownFileExtension(apiPath: string): {
     originalExtension: string;

package/esm/src/platform/adapters/fs/veryfront/read-operations-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-operations-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,iCAAiC,EAAE,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,UAAU,uBAAuB;IAC/B,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,0BAA0B;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAOpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,cAAc,CA2BvF;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,sBAAsB,EAAE,MAAM,GAC7B,MAAM,CAER;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,MAAM,CAErE;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASxD;AAED,4FAA4F;AAC5F,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAEvE"}
+{"version":3,"file":"read-operations-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,iCAAiC,EAAE,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,UAAU,uBAAuB;IAC/B,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,0BAA0B;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAOpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,cAAc,CA2BvF;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,sBAAsB,EAAE,MAAM,GAC7B,MAAM,CAER;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASxD;AAED,4FAA4F;AAC5F,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAEvE"}

package/esm/src/platform/adapters/fs/veryfront/read-operations-helpers.js

@@ -40,9 +40,6 @@ export function buildReadFetchState(options) {
 export function getResolvedCacheKey(cacheKeyPrefix, normalizedResolvedPath) {
     return `${cacheKeyPrefix}:${normalizedResolvedPath}`;
 }
-export function buildContentPreview(content, max = 80) {
-    return content.length > max ? `${content.slice(0, max)}...` : content;
-}
 export function buildExtensionCandidatePaths(basePath) {
     return READ_OPERATION_EXTENSION_PRIORITY.map((ext) => `${basePath}${ext}`);
 }