veryfront 0.1.85 → 0.1.87

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.85",
+    "version": "0.1.87",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [

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

@@ -12,6 +12,9 @@ export declare class VeryfrontFSAdapter implements FSAdapter {
     private initialized;
     /** Resolves when file list initialization is complete (for coordinating reads) */
     private fileListReadyResolve;
+    /** Single-flight background rewarm when the file list cache disappears */
+    private fileListWarmupPromise;
+    private fileListWarmupKey;
     private projectData?;
     private apiBaseUrl;
     private apiToken;
@@ -29,6 +32,7 @@ export declare class VeryfrontFSAdapter implements FSAdapter {
     constructor(config: FSAdapterConfig);
     initialize(): Promise<void>;
     private isPersistentCacheInvalidated;
+    private scheduleFileListWarmup;
     getPokeMetrics(): {
         received: number;
         invalidationsTriggered: number;

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

@@ -27,6 +27,9 @@ export class VeryfrontFSAdapter {
     initialized = false;
     /** Resolves when file list initialization is complete (for coordinating reads) */
     fileListReadyResolve = null;
+    /** Single-flight background rewarm when the file list cache disappears */
+    fileListWarmupPromise = null;
+    fileListWarmupKey = null;
     projectData;
     apiBaseUrl;
     apiToken;
@@ -94,6 +97,9 @@ export class VeryfrontFSAdapter {
                     hasResult: !!result,
                     resultSize: result?.length ?? 0,
                 });
+                if (!result?.length) {
+                    this.scheduleFileListWarmup("getFileList miss", cacheKey);
+                }
                 return result;
             },
             hasCachedFileList: async () => {
@@ -109,6 +115,9 @@ export class VeryfrontFSAdapter {
                     hasResult,
                     resultSize: result?.length ?? 0,
                 });
+                if (!hasResult) {
+                    this.scheduleFileListWarmup("hasCachedFileList miss", cacheKey);
+                }
                 return hasResult;
             },
             isPersistentCacheInvalidated: (prefix) => this.isPersistentCacheInvalidated(prefix),
@@ -132,6 +141,9 @@ export class VeryfrontFSAdapter {
                 resultSize: result?.length ?? 0,
                 hasContent: result?.filter((f) => f.content)?.length ?? 0,
             });
+            if (!result?.length) {
+                this.scheduleFileListWarmup("getFileListCache miss", cacheKey);
+            }
             return result;
         });
         this.dirOps = new DirectoryOperations(this.client, this.cache, this.normalizer, contentContextGetter);
@@ -280,6 +292,65 @@ export class VeryfrontFSAdapter {
     isPersistentCacheInvalidated(prefix) {
         return isPrefixBeingInvalidated(prefix);
     }
+    scheduleFileListWarmup(reason, cacheKey) {
+        if (!this.initialized || !this.contentContext)
+            return;
+        const effectiveCacheKey = cacheKey ?? buildFileListCacheKey(this.contentContext);
+        if (this.fileListWarmupPromise && this.fileListWarmupKey === effectiveCacheKey) {
+            logger.debug("File list warmup already in progress", {
+                reason,
+                cacheKey: effectiveCacheKey,
+            });
+            return;
+        }
+        const warmupContext = this.contentContext;
+        let warmupPromise = null;
+        warmupPromise = (async () => {
+            try {
+                const existing = await this.cache.getAsync(effectiveCacheKey);
+                if (existing?.length) {
+                    logger.debug("Skipping file list warmup because cache is already populated", {
+                        reason,
+                        cacheKey: effectiveCacheKey,
+                        fileCount: existing.length,
+                    });
+                    return;
+                }
+                logger.debug("Starting file list warmup", {
+                    reason,
+                    cacheKey: effectiveCacheKey,
+                    sourceType: warmupContext.sourceType,
+                    branch: warmupContext.branch,
+                    environmentName: warmupContext.environmentName,
+                    releaseId: warmupContext.releaseId,
+                });
+                const files = await fetchFileListForContext(this.client, warmupContext);
+                await this.cache.setAsync(effectiveCacheKey, files);
+                logger.debug("File list warmup complete", {
+                    reason,
+                    cacheKey: effectiveCacheKey,
+                    totalFiles: files.length,
+                    filesWithContent: files.filter((file) => file.content).length,
+                });
+            }
+            catch (error) {
+                logger.warn("File list warmup failed", {
+                    reason,
+                    cacheKey: effectiveCacheKey,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            finally {
+                if (warmupPromise && this.fileListWarmupPromise === warmupPromise) {
+                    this.fileListWarmupPromise = null;
+                    this.fileListWarmupKey = null;
+                }
+            }
+        })();
+        this.fileListWarmupPromise = warmupPromise;
+        this.fileListWarmupKey = effectiveCacheKey;
+        this.readOps.setFileListReadyPromise(warmupPromise);
+    }
     getPokeMetrics() {
         return this.wsManager.getPokeMetrics();
     }
@@ -317,6 +388,8 @@ export class VeryfrontFSAdapter {
         this.statOps.clearIndex();
         this.dirOps.clearTree();
         this.initialized = false;
+        this.fileListWarmupPromise = null;
+        this.fileListWarmupKey = null;
         logger.debug("Disposed");
     }
     getCacheStats() {
@@ -342,6 +415,7 @@ export class VeryfrontFSAdapter {
                 hasFiles: !!files,
                 fileCount: files?.length ?? 0,
             });
+            this.scheduleFileListWarmup("getAllSourceFiles miss", cacheKey);
             return [];
         }
         const fileSummary = summarizeFileList(files);
@@ -429,6 +503,8 @@ export class VeryfrontFSAdapter {
         if (contextChanged) {
             this.statOps.clearIndex();
             this.dirOps.clearTree();
+            this.fileListWarmupPromise = null;
+            this.fileListWarmupKey = null;
             logger.debug("Cleared index and dirTree due to context change", {
                 oldContext,
                 newContext: context,

package/esm/src/platform/adapters/fs/veryfront/content-metrics.d.ts

@@ -1,4 +1,4 @@
-export type MissReason = "cold_start" | "not_in_filelist" | "invalidation" | "no_filelist_cache";
+export type MissReason = "cold_start" | "not_in_filelist" | "invalidation" | "no_filelist_cache" | "indexed_without_content";
 interface CumulativeMetrics {
     requestScopedHits: number;
     persistentCacheHits: number;

package/esm/src/platform/adapters/fs/veryfront/content-metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-metrics.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/content-metrics.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,iBAAiB,GAAG,cAAc,GAAG,mBAAmB,CAAC;AAejG,UAAU,iBAAiB;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAsCD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,iBAAiB,CAC/B,cAAc,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE,IAAI,CAuCN;AAED,KAAK,kBAAkB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,eAAe,GACf,eAAe,GACf,wBAAwB,GACxB,YAAY,CAAC;AAEjB,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,GACA,IAAI,CAyCN;AAED,wBAAgB,yBAAyB,IAAI,iBAAiB,GAAG;IAC/D,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAOA;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}
+{"version":3,"file":"content-metrics.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/content-metrics.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,iBAAiB,GACjB,cAAc,GACd,mBAAmB,GACnB,yBAAyB,CAAC;AAe9B,UAAU,iBAAiB;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AA4CD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,iBAAiB,CAC/B,cAAc,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE,IAAI,CAuCN;AAED,KAAK,kBAAkB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,eAAe,GACf,eAAe,GACf,wBAAwB,GACxB,YAAY,CAAC;AAEjB,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,GACA,IAAI,CAyCN;AAED,wBAAgB,yBAAyB,IAAI,iBAAiB,GAAG;IAC/D,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAOA;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}

package/esm/src/platform/adapters/fs/veryfront/content-metrics.js

@@ -20,7 +20,13 @@ function createFreshRequestMetrics() {
         networkFetches: 0,
         networkMs: 0,
         fetchesByType: { page: 0, layout: 0, component: 0, api: 0, data: 0, config: 0, other: 0 },
-        missReasons: { cold_start: 0, not_in_filelist: 0, invalidation: 0, no_filelist_cache: 0 },
+        missReasons: {
+            cold_start: 0,
+            not_in_filelist: 0,
+            invalidation: 0,
+            no_filelist_cache: 0,
+            indexed_without_content: 0,
+        },
         isPreviewMode: null,
         filesAccessed: new Set(),
     };

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

@@ -2,21 +2,31 @@ interface FileListCacheEntry {
     path: string;
     content?: string;
 }
+export interface FileListMatchResult {
+    status: "unavailable" | "missing" | "present_without_content" | "hit";
+    fresh: boolean;
+    path?: string;
+    content?: string;
+}
 export declare class FileListIndex {
     private readonly getFileListCache?;
     private index;
+    private pathSet;
     private indexKey;
     private indexBuiltAt;
+    private indexFresh;
     private readyPromise;
     constructor(getFileListCache?: (() => Promise<Array<FileListCacheEntry> | undefined>) | undefined);
     setReadyPromise(promise: Promise<void>): void;
     clear(): void;
     private ensureReady;
     lookup(normalizedPath: string): Promise<string | undefined>;
+    match(normalizedPath: string): Promise<FileListMatchResult>;
     findFirstWithContent(normalizedPaths: string[]): Promise<{
         path: string;
         content: string;
     } | undefined>;
+    findFirstMatch(normalizedPaths: string[]): Promise<FileListMatchResult>;
     private getOrBuild;
 }
 export {};

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,qBAAa,aAAa;IAOtB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IANpC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,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;YAUC,WAAW;IAWnB,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA4B3D,oBAAoB,CACxB,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;YAc3C,UAAU;CA0EzB"}
+{"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"}

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

@@ -13,8 +13,10 @@ const INDEX_STALENESS_LIMIT_MS = 5 * 60 * 1000; // 5 minutes
 export class FileListIndex {
     getFileListCache;
     index = null;
+    pathSet = null;
     indexKey = null;
     indexBuiltAt = 0;
+    indexFresh = false;
     readyPromise = null;
     constructor(getFileListCache) {
         this.getFileListCache = getFileListCache;
@@ -27,8 +29,10 @@ export class FileListIndex {
             return;
         const indexedWithContent = this.index.size;
         this.index = null;
+        this.pathSet = null;
         this.indexKey = null;
         this.indexBuiltAt = 0;
+        this.indexFresh = false;
         logger.debug("Cleared file list index", { indexedWithContent });
     }
     async ensureReady() {
@@ -43,19 +47,35 @@ export class FileListIndex {
         }
     }
     async lookup(normalizedPath) {
+        const match = await this.match(normalizedPath);
+        return match.status === "hit" ? match.content : undefined;
+    }
+    async match(normalizedPath) {
         await this.ensureReady();
-        const index = await this.getOrBuild();
-        if (!index) {
+        const snapshot = await this.getOrBuild();
+        if (!snapshot) {
             logger.debug("No file list cache available");
-            return undefined;
+            return { status: "unavailable", fresh: false };
         }
-        const content = index.get(normalizedPath);
-        if (!content) {
+        if (!snapshot.paths.has(normalizedPath)) {
             logger.debug("Content not in file list index", {
                 path: normalizedPath,
-                indexSize: index.size,
+                indexSize: snapshot.content.size,
+                fresh: snapshot.fresh,
             });
-            return undefined;
+            return { status: "missing", fresh: snapshot.fresh };
+        }
+        const content = snapshot.content.get(normalizedPath);
+        if (!content) {
+            logger.debug("File list index contains path without inline content", {
+                path: normalizedPath,
+                fresh: snapshot.fresh,
+            });
+            return {
+                status: "present_without_content",
+                fresh: snapshot.fresh,
+                path: normalizedPath,
+            };
         }
         logger.debug("FILE_LIST_CACHE_HIT - serving from file list cache", {
             path: normalizedPath,
@@ -63,19 +83,43 @@ export class FileListIndex {
             contentHash: hashPreview(content),
             contentPreview: previewText(content, 200).replace(/\n/g, "\\n"),
         });
-        return content;
+        return {
+            status: "hit",
+            fresh: snapshot.fresh,
+            path: normalizedPath,
+            content,
+        };
     }
     async findFirstWithContent(normalizedPaths) {
-        await this.ensureReady();
-        const index = await this.getOrBuild();
-        if (!index)
+        const match = await this.findFirstMatch(normalizedPaths);
+        if (match.status !== "hit" || !match.path || !match.content)
             return undefined;
+        return { path: match.path, content: match.content };
+    }
+    async findFirstMatch(normalizedPaths) {
+        await this.ensureReady();
+        const snapshot = await this.getOrBuild();
+        if (!snapshot)
+            return { status: "unavailable", fresh: false };
         for (const path of normalizedPaths) {
-            const content = index.get(path);
-            if (content)
-                return { path, content };
+            if (!snapshot.paths.has(path))
+                continue;
+            const content = snapshot.content.get(path);
+            if (content) {
+                return {
+                    status: "hit",
+                    fresh: snapshot.fresh,
+                    path,
+                    content,
+                };
+            }
+            return {
+                status: "present_without_content",
+                fresh: snapshot.fresh,
+                path,
+            };
         }
-        return undefined;
+        return { status: "missing", fresh: snapshot.fresh };
     }
     async getOrBuild() {
         if (!this.getFileListCache) {
@@ -95,7 +139,12 @@ export class FileListIndex {
                         indexSize: this.index.size,
                         indexAgeMs: age,
                     });
-                    return this.index;
+                    this.indexFresh = false;
+                    return {
+                        content: this.index,
+                        paths: this.pathSet ?? new Set(),
+                        fresh: false,
+                    };
                 }
                 logger.debug("getOrBuildFileListIndex: in-memory index too stale, discarding", {
                     indexSize: this.index.size,
@@ -103,7 +152,9 @@ export class FileListIndex {
                     staleLimitMs: INDEX_STALENESS_LIMIT_MS,
                 });
                 this.index = null;
+                this.pathSet = null;
                 this.indexKey = null;
+                this.indexFresh = false;
             }
             logger.debug("[ReadOperations] getOrBuildFileListIndex: getFileListCache returned null/undefined");
             return null;
@@ -117,18 +168,27 @@ export class FileListIndex {
             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.indexKey === indexKey) {
+        if (this.index && this.pathSet && this.indexKey === indexKey) {
             this.indexBuiltAt = Date.now();
-            return this.index;
+            this.indexFresh = true;
+            return {
+                content: this.index,
+                paths: this.pathSet,
+                fresh: true,
+            };
         }
         const index = new Map();
+        const pathSet = new Set();
         for (const file of fileList) {
+            pathSet.add(file.path);
             if (file.content)
                 index.set(file.path, file.content);
         }
         this.index = index;
+        this.pathSet = pathSet;
         this.indexKey = indexKey;
         this.indexBuiltAt = Date.now();
+        this.indexFresh = true;
         const sampleFile = fileList.find((f) => /welcome/i.test(f.path));
         const sampleContent = sampleFile?.content;
         logger.debug("Built file list index", {
@@ -139,6 +199,10 @@ export class FileListIndex {
             sampleContentHash: sampleContent ? hashPreview(sampleContent) : undefined,
             sampleContentPreview: sampleContent?.slice(0, 200)?.replace(/\n/g, "\\n"),
         });
-        return index;
+        return {
+            content: index,
+            paths: pathSet,
+            fresh: true,
+        };
     }
 }

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

@@ -1,6 +1,9 @@
 import { READ_OPERATION_EXTENSION_PRIORITY } from "./extension-priority.js";
 import type { ResolvedContentContext } from "./types.js";
 export { READ_OPERATION_EXTENSION_PRIORITY };
+export type NotFoundLikeError = Error & {
+    code?: string;
+};
 interface ReadContextProviderLike {
     isProductionMode: () => boolean;
     isPersistentCacheInvalidated?: (prefix: string) => boolean;
@@ -28,9 +31,11 @@ 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 buildExtensionCandidatePaths(basePath: string): string[];
 export declare function splitKnownFileExtension(apiPath: string): {
     originalExtension: string;
     basePath: string;
 } | null;
 export declare function isNotFoundLikeError(error: unknown): boolean;
+export declare function createNotFoundLikeError(path: string): NotFoundLikeError;
 //# sourceMappingURL=read-operations-helpers.d.ts.map

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,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,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASxD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG3D"}
+{"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,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG3D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAEvE"}

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

@@ -40,6 +40,9 @@ export function buildReadFetchState(options) {
 export function getResolvedCacheKey(cacheKeyPrefix, normalizedResolvedPath) {
     return `${cacheKeyPrefix}:${normalizedResolvedPath}`;
 }
+export function buildExtensionCandidatePaths(basePath) {
+    return READ_OPERATION_EXTENSION_PRIORITY.map((ext) => `${basePath}${ext}`);
+}
 export function splitKnownFileExtension(apiPath) {
     const extMatch = apiPath.match(/\.(tsx|ts|jsx|js|mdx|md)$/);
     if (!extMatch)
@@ -54,3 +57,6 @@ export function isNotFoundLikeError(error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     return errorMessage.includes("404") || errorMessage.includes("Not Found");
 }
+export function createNotFoundLikeError(path) {
+    return Object.assign(new Error(`404 Not Found: ${path}`), { code: "ENOENT" });
+}

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

@@ -1 +1 @@
-{"version":3,"file":"read-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAStD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IACvD,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,OAAO,CACzB,KAAK,CAAC;QACJ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GAAG,SAAS,CACf,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,0EAA0E;IAC1E,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,+CAA+C;IAC/C,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAUD,qBAAa,cAAc;IAWvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAfpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAI9B;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA6B;gBAGnD,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,sBAAsB,YAAA,EACxC,kBAAkB,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,aAAA,EAC7C,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAC/C,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CACtD,aAAA;IAKH,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIrD,kBAAkB,IAAI,IAAI;IAK1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY3C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3C,OAAO,CAAC,mBAAmB;YAsBb,+BAA+B;YA0C/B,mBAAmB;IAgDjC,OAAO,CAAC,kBAAkB;YAoFZ,2BAA2B;YA8D3B,uCAAuC;IAmCrD,OAAO,CAAC,oBAAoB;YAgBd,YAAY;YAgGZ,qBAAqB;YA8DrB,qBAAqB;YAgDrB,+BAA+B;YA8D/B,iBAAiB;CAyBhC"}
+{"version":3,"file":"read-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAWtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IACvD,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,OAAO,CACzB,KAAK,CAAC;QACJ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GAAG,SAAS,CACf,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,0EAA0E;IAC1E,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,+CAA+C;IAC/C,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAUD,qBAAa,cAAc;IAWvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAfpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAI9B;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA6B;gBAGnD,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,sBAAsB,YAAA,EACxC,kBAAkB,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,aAAA,EAC7C,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAC/C,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CACtD,aAAA;IAKH,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIrD,kBAAkB,IAAI,IAAI;IAK1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY3C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3C,OAAO,CAAC,mBAAmB;YAsBb,+BAA+B;YA0C/B,mBAAmB;IA0CjC,OAAO,CAAC,kBAAkB;YAoFZ,2BAA2B;YA8D3B,uCAAuC;IAmCrD,OAAO,CAAC,oBAAoB;YAgBd,YAAY;YA6JZ,qBAAqB;YA8DrB,qBAAqB;YAgDrB,+BAA+B;YA8D/B,iBAAiB;CAyBhC"}

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

@@ -4,7 +4,7 @@ import { logContentMetric } from "./content-metrics.js";
 import { FileListIndex } from "./file-list-index.js";
 import { InFlightRequestDeduper } from "./in-flight-dedupe.js";
 import { getRequestScopedFile, setRequestScopedFile } from "./multi-project-adapter.js";
-import { assertProjectSourcePath, buildReadFetchState, getResolvedCacheKey, isNotFoundLikeError, READ_OPERATION_EXTENSION_PRIORITY as EXTENSION_PRIORITY, splitKnownFileExtension, } from "./read-operations-helpers.js";
+import { assertProjectSourcePath, buildExtensionCandidatePaths, buildReadFetchState, createNotFoundLikeError, getResolvedCacheKey, isNotFoundLikeError, READ_OPERATION_EXTENSION_PRIORITY as EXTENSION_PRIORITY, splitKnownFileExtension, } from "./read-operations-helpers.js";
 export { endRequestMetrics, getContentMetricsSnapshot, resetContentMetrics, startRequestMetrics, } from "./content-metrics.js";
 const logger = baseLogger.component("read-operations");
 const IN_FLIGHT_REQUEST_TIMEOUT_MS = 15_000;
@@ -113,10 +113,15 @@ export class ReadOperations {
         // - File list is refreshed on every WebSocket poke (websocket-manager.ts:483-500)
         // - Request-scoped cache ensures consistency within a single render
         // - Persistent cache is only written for production mode (to avoid staleness risk in preview)
-        if (!skipPersistentCaches) {
-            const fileListContent = await this.fileListIndex.lookup(normalizedPath);
-            if (!fileListContent)
-                return null;
+        if (skipPersistentCaches) {
+            logger.debug("Skipping file list cache due to invalidation", {
+                path: normalizedPath,
+                cacheKeyPrefix,
+            });
+            return { status: "unavailable", fresh: false };
+        }
+        const match = await this.fileListIndex.match(normalizedPath);
+        if (match.status === "hit" && match.content) {
             logContentMetric("FILE_LIST_HIT", {
                 path: normalizedPath,
                 mode: ctx?.sourceType ?? "unknown",
@@ -126,25 +131,13 @@ export class ReadOperations {
             // Only cache to persistent storage for production mode
             // Preview mode uses file list cache directly without persisting (fresher, WebSocket-driven)
             if (isProduction) {
-                this.cache.set(cacheKey, fileListContent);
+                this.cache.set(cacheKey, match.content);
             }
-            setRequestScopedFile(cacheKey, fileListContent);
-            return fileListContent;
+            setRequestScopedFile(cacheKey, match.content);
         }
-        // Skip only happens during cache invalidation (both preview and production)
-        logContentMetric("CACHE_MISS", {
-            path: normalizedPath,
-            mode: ctx?.sourceType ?? "unknown",
-            missReason: "invalidation",
-            isPreviewMode,
-        });
-        logger.debug("Skipping file list cache due to invalidation", {
-            path: normalizedPath,
-            cacheKeyPrefix,
-        });
-        return null;
+        return match;
     }
-    setupInFlightFetch(normalizedPath, apiPath, cacheKey, isPublished, isProduction, isPreviewMode, ctx) {
+    setupInFlightFetch(normalizedPath, apiPath, cacheKey, isPublished, isProduction, isPreviewMode, ctx, missReason) {
         const cleanupResult = this.inFlightRequests.cleanup();
         if (cleanupResult) {
             logger.warn("Cleaned up in-flight requests", cleanupResult);
@@ -159,11 +152,10 @@ export class ReadOperations {
             return existingEntry.promise;
         }
         // Track why we're making a network fetch (for optimization analysis)
-        const hasFileListCache = !!this.getFileListCache;
         logContentMetric("CACHE_MISS", {
             path: normalizedPath,
             mode: ctx?.sourceType ?? "unknown",
-            missReason: (hasFileListCache ? "not_in_filelist" : "no_filelist_cache"),
+            missReason,
             isPreviewMode,
         });
         // THIS IS A NETWORK FETCH - every call here = API round trip
@@ -248,10 +240,10 @@ export class ReadOperations {
         }
     }
     async tryResolveExtensionlessPathFromFileList(normalizedPath, cacheKeyPrefix, cacheKey, isProduction, ctx, isPreviewMode) {
-        const candidatePaths = EXTENSION_PRIORITY.map((ext) => `${normalizedPath}${ext}`);
-        const resolved = await this.fileListIndex.findFirstWithContent(candidatePaths);
-        if (!resolved)
-            return null;
+        const candidatePaths = buildExtensionCandidatePaths(normalizedPath);
+        const resolved = await this.fileListIndex.findFirstMatch(candidatePaths);
+        if (resolved.status !== "hit" || !resolved.path || !resolved.content)
+            return resolved;
         const resolvedCacheKey = getResolvedCacheKey(cacheKeyPrefix, resolved.path);
         this.extensionResolutionCache.set(normalizedPath, resolved.path);
         logContentMetric("FILE_LIST_HIT", {
@@ -268,7 +260,7 @@ export class ReadOperations {
             resolvedCacheKey: resolvedCacheKey === cacheKey ? undefined : resolvedCacheKey,
         });
         this.cacheResolvedContent(cacheKey, resolvedCacheKey, resolved.content, isProduction);
-        return resolved.content;
+        return resolved;
     }
     cacheResolvedContent(cacheKey, resolvedCacheKey, content, persistToCache) {
         if (persistToCache) {
@@ -309,20 +301,47 @@ export class ReadOperations {
         const persistentCached = await this.getProductionPersistentCacheHit(normalizedPath, cacheKeyPrefix, cacheKey, isProduction, skipPersistentCaches, currentReleaseId, isPrefixInvalidated, ctx);
         if (persistentCached)
             return persistentCached;
-        const fileListCached = await this.getFileListCacheHit(normalizedPath, cacheKeyPrefix, cacheKey, isProduction, skipPersistentCaches, isPreviewMode, ctx);
-        if (fileListCached)
-            return fileListCached;
+        const fileListMatch = await this.getFileListCacheHit(normalizedPath, cacheKeyPrefix, cacheKey, isProduction, skipPersistentCaches, isPreviewMode, ctx);
+        if (fileListMatch.status === "hit" && fileListMatch.content)
+            return fileListMatch.content;
+        if (fileListMatch.status === "present_without_content") {
+            return this.setupInFlightFetch(normalizedPath, apiPath, cacheKey, isPublished, isProduction, isPreviewMode, ctx, "indexed_without_content");
+        }
         if (!hasKnownExt) {
             if (!skipPersistentCaches) {
                 const resolvedFromFileList = await this.tryResolveExtensionlessPathFromFileList(normalizedPath, cacheKeyPrefix, cacheKey, isProduction, ctx, isPreviewMode);
-                if (resolvedFromFileList)
-                    return resolvedFromFileList;
+                if (resolvedFromFileList.status === "hit" && resolvedFromFileList.content) {
+                    return resolvedFromFileList.content;
+                }
+                if (resolvedFromFileList.status === "present_without_content" &&
+                    resolvedFromFileList.path) {
+                    const resolvedCacheKey = getResolvedCacheKey(cacheKeyPrefix, resolvedFromFileList.path);
+                    const resolvedApiPath = this.getOriginalApiPath?.(resolvedFromFileList.path) ??
+                        resolvedFromFileList.path;
+                    const fetchedResolved = await this.setupInFlightFetch(resolvedFromFileList.path, resolvedApiPath, resolvedCacheKey, isPublished, isProduction, isPreviewMode, ctx, "indexed_without_content");
+                    this.extensionResolutionCache.set(normalizedPath, resolvedFromFileList.path);
+                    this.cacheResolvedContent(cacheKey, resolvedCacheKey, fetchedResolved, isProduction && !skipPersistentCaches);
+                    return fetchedResolved;
+                }
+                if (fileListMatch.status === "missing" &&
+                    fileListMatch.fresh &&
+                    resolvedFromFileList.status === "missing" &&
+                    resolvedFromFileList.fresh) {
+                    throw createNotFoundLikeError(normalizedPath);
+                }
             }
             const resolved = await this.tryResolveExtensionlessPath(apiPath, cacheKeyPrefix, cacheKey, isProduction, skipPersistentCaches);
             if (resolved)
                 return resolved;
         }
-        return this.setupInFlightFetch(normalizedPath, apiPath, cacheKey, isPublished, isProduction, isPreviewMode, ctx);
+        if (fileListMatch.status === "missing" && fileListMatch.fresh) {
+            throw createNotFoundLikeError(normalizedPath);
+        }
+        return this.setupInFlightFetch(normalizedPath, apiPath, cacheKey, isPublished, isProduction, isPreviewMode, ctx, skipPersistentCaches
+            ? "invalidation"
+            : fileListMatch.status === "missing" && fileListMatch.fresh
+                ? "not_in_filelist"
+                : "no_filelist_cache");
     }
     async fetchPublishedContent(normalizedPath, apiPath, cacheKey, releaseId, environmentName, shouldCache) {
         logger.debug("Fetching published content", {

package/esm/src/rendering/page-resolution/page-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/page-resolution/page-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAoCvD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,EAAE,mBAAmB;IAOxC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAsDxC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAoCxB,sBAAsB;IAoD9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY1C,aAAa,IAAI,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC;CAShD"}
+{"version":3,"file":"page-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/page-resolution/page-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAoCvD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,EAAE,mBAAmB;IAOxC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiExC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAoCxB,sBAAsB;IAoD9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY1C,aAAa,IAAI,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC;CAShD"}