veryfront 0.1.86 → 0.1.87

package/esm/deno.js

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

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"}

package/esm/src/rendering/page-resolution/page-resolver.js

@@ -56,10 +56,16 @@ export class PageResolver {
                 }
             }
             else {
-                // Auto mode stays structural: a single resolved route must not pin router mode
-                // for projects that are still transitioning between app/ and pages/.
-                pageInfo = await getAppRouteEntity(this.projectDir, slug, this.adapter, appDirName);
-                if (!pageInfo) {
+                // Auto mode stays structural: detect the dominant router once, then keep
+                // pages fallback available for mixed or in-transition projects.
+                const useAppRouter = await detectAppRouter(this.projectDir, this.config, this.adapter, { projectId: this.projectId });
+                if (useAppRouter) {
+                    pageInfo = await getAppRouteEntity(this.projectDir, slug, this.adapter, appDirName);
+                    if (!pageInfo) {
+                        pageInfo = await getEntityBySlug(this.projectDir, slug, this.adapter);
+                    }
+                }
+                else {
                     pageInfo = await getEntityBySlug(this.projectDir, slug, this.adapter);
                 }
             }

package/esm/src/utils/version.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.1.59";
+export declare const VERSION = "0.1.87";
 export declare const SERVER_START_TIME: number;
 export interface BuildVersion {
     framework: string;

package/esm/src/utils/version.js

@@ -1,6 +1,6 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.59";
+export const VERSION = "0.1.87";
 export const SERVER_START_TIME = Date.now();
 export function createBuildVersion(projectUpdatedAt) {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.86",
+  "version": "0.1.87",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

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

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

@@ -8,7 +8,12 @@ import {
 const logger = baseLogger.component("content-metrics");
 
 type FileType = "page" | "layout" | "component" | "api" | "data" | "config" | "other";
-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 PerRequestMetrics {
   startTime: number;
@@ -52,7 +57,13 @@ function createFreshRequestMetrics(): PerRequestMetrics {
     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/src/src/platform/adapters/fs/veryfront/file-list-index.ts

@@ -7,6 +7,13 @@ interface FileListCacheEntry {
   content?: string;
 }
 
+export interface FileListMatchResult {
+  status: "unavailable" | "missing" | "present_without_content" | "hit";
+  fresh: boolean;
+  path?: string;
+  content?: string;
+}
+
 function hashPreview(content: string): number {
   return content
     .slice(0, 100)
@@ -22,8 +29,10 @@ const INDEX_STALENESS_LIMIT_MS = 5 * 60 * 1000; // 5 minutes
 
 export class FileListIndex {
   private index: Map<string, string> | null = null;
+  private pathSet: Set<string> | null = null;
   private indexKey: string | null = null;
   private indexBuiltAt = 0;
+  private indexFresh = false;
   private readyPromise: Promise<void> | null = null;
 
   constructor(
@@ -39,8 +48,10 @@ export class FileListIndex {
 
     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 });
   }
 
@@ -56,21 +67,39 @@ export class FileListIndex {
   }
 
   async lookup(normalizedPath: string): Promise<string | undefined> {
+    const match = await this.match(normalizedPath);
+    return match.status === "hit" ? match.content : undefined;
+  }
+
+  async match(normalizedPath: string): Promise<FileListMatchResult> {
     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", {
@@ -80,26 +109,60 @@ export class FileListIndex {
       contentPreview: previewText(content, 200).replace(/\n/g, "\\n"),
     });
 
-    return content;
+    return {
+      status: "hit",
+      fresh: snapshot.fresh,
+      path: normalizedPath,
+      content,
+    };
   }
 
   async findFirstWithContent(
     normalizedPaths: string[],
   ): Promise<{ path: string; content: string } | undefined> {
+    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: string[],
+  ): Promise<FileListMatchResult> {
     await this.ensureReady();
 
-    const index = await this.getOrBuild();
-    if (!index) return undefined;
+    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 };
   }
 
-  private async getOrBuild(): Promise<Map<string, string> | null> {
+  private async getOrBuild(): Promise<
+    {
+      content: Map<string, string>;
+      paths: Set<string>;
+      fresh: boolean;
+    } | null
+  > {
     if (!this.getFileListCache) {
       logger.debug("getOrBuildFileListIndex: no getFileListCache function");
       return null;
@@ -118,7 +181,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<string>(),
+            fresh: false,
+          };
         }
         logger.debug("getOrBuildFileListIndex: in-memory index too stale, discarding", {
           indexSize: this.index.size,
@@ -126,7 +194,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",
@@ -146,19 +216,28 @@ export class FileListIndex {
     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<string, string>();
+    const pathSet = new Set<string>();
     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;
@@ -171,6 +250,10 @@ export class FileListIndex {
       sampleContentPreview: sampleContent?.slice(0, 200)?.replace(/\n/g, "\\n"),
     });
 
-    return index;
+    return {
+      content: index,
+      paths: pathSet,
+      fresh: true,
+    };
   }
 }

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

@@ -6,6 +6,8 @@ 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;
@@ -78,6 +80,10 @@ export function getResolvedCacheKey(
   return `${cacheKeyPrefix}:${normalizedResolvedPath}`;
 }
 
+export function buildExtensionCandidatePaths(basePath: string): string[] {
+  return READ_OPERATION_EXTENSION_PRIORITY.map((ext) => `${basePath}${ext}`);
+}
+
 export function splitKnownFileExtension(
   apiPath: string,
 ): { originalExtension: string; basePath: string } | null {
@@ -95,3 +101,7 @@ export function isNotFoundLikeError(error: unknown): boolean {
   const errorMessage = error instanceof Error ? error.message : String(error);
   return errorMessage.includes("404") || errorMessage.includes("Not Found");
 }
+
+export function createNotFoundLikeError(path: string): NotFoundLikeError {
+  return Object.assign(new Error(`404 Not Found: ${path}`), { code: "ENOENT" });
+}

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

@@ -3,13 +3,15 @@ import { withSpan } from "../../../../observability/tracing/otlp-setup.js";
 import type { VeryfrontApiClient } from "../../veryfront-api-client/index.js";
 import { FileCache } from "../cache/file-cache.js";
 import { logContentMetric, type MissReason } from "./content-metrics.js";
-import { FileListIndex } from "./file-list-index.js";
+import { FileListIndex, type FileListMatchResult } from "./file-list-index.js";
 import { InFlightRequestDeduper } from "./in-flight-dedupe.js";
 import { getRequestScopedFile, setRequestScopedFile } from "./multi-project-adapter.js";
 import { PathNormalizer } from "./path-normalizer.js";
 import {
   assertProjectSourcePath,
+  buildExtensionCandidatePaths,
   buildReadFetchState,
+  createNotFoundLikeError,
   getResolvedCacheKey,
   isNotFoundLikeError,
   READ_OPERATION_EXTENSION_PRIORITY as EXTENSION_PRIORITY,
@@ -184,17 +186,23 @@ export class ReadOperations {
     skipPersistentCaches: boolean,
     isPreviewMode: boolean,
     ctx: ResolvedContentContext | null,
-  ): Promise<string | null> {
+  ): Promise<FileListMatchResult> {
     // File list cache is enabled for BOTH preview and production modes.
     // The file list is an in-memory index built from API response at init, updated by WebSocket pokes.
     // This is safe because:
     // - 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",
@@ -204,24 +212,12 @@ 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" as MissReason,
-      isPreviewMode,
-    });
-    logger.debug("Skipping file list cache due to invalidation", {
-      path: normalizedPath,
-      cacheKeyPrefix,
-    });
-    return null;
+    return match;
   }
 
   private setupInFlightFetch(
@@ -232,6 +228,7 @@ export class ReadOperations {
     isProduction: boolean,
     isPreviewMode: boolean,
     ctx: ResolvedContentContext | null,
+    missReason: MissReason,
   ): Promise<string> {
     const cleanupResult = this.inFlightRequests.cleanup();
     if (cleanupResult) {
@@ -249,11 +246,10 @@ export class ReadOperations {
     }
 
     // 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") as MissReason,
+      missReason,
       isPreviewMode,
     });
 
@@ -377,10 +373,10 @@ export class ReadOperations {
     isProduction: boolean,
     ctx: ResolvedContentContext | null,
     isPreviewMode: boolean,
-  ): Promise<string | null> {
-    const candidatePaths = EXTENSION_PRIORITY.map((ext) => `${normalizedPath}${ext}`);
-    const resolved = await this.fileListIndex.findFirstWithContent(candidatePaths);
-    if (!resolved) return null;
+  ): Promise<FileListMatchResult> {
+    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);
 
@@ -402,7 +398,7 @@ export class ReadOperations {
 
     this.cacheResolvedContent(cacheKey, resolvedCacheKey, resolved.content, isProduction);
 
-    return resolved.content;
+    return resolved;
   }
 
   private cacheResolvedContent(
@@ -472,7 +468,7 @@ export class ReadOperations {
     );
     if (persistentCached) return persistentCached;
 
-    const fileListCached = await this.getFileListCacheHit(
+    const fileListMatch = await this.getFileListCacheHit(
       normalizedPath,
       cacheKeyPrefix,
       cacheKey,
@@ -481,7 +477,19 @@ export class ReadOperations {
       isPreviewMode,
       ctx,
     );
-    if (fileListCached) return fileListCached;
+    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) {
@@ -493,7 +501,47 @@ export class ReadOperations {
           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(
@@ -506,6 +554,10 @@ export class ReadOperations {
       if (resolved) return resolved;
     }
 
+    if (fileListMatch.status === "missing" && fileListMatch.fresh) {
+      throw createNotFoundLikeError(normalizedPath);
+    }
+
     return this.setupInFlightFetch(
       normalizedPath,
       apiPath,
@@ -514,6 +566,11 @@ export class ReadOperations {
       isProduction,
       isPreviewMode,
       ctx,
+      skipPersistentCaches
+        ? "invalidation"
+        : fileListMatch.status === "missing" && fileListMatch.fresh
+        ? "not_in_filelist"
+        : "no_filelist_cache",
     );
   }
 

package/src/src/rendering/page-resolution/page-resolver.ts

@@ -86,15 +86,26 @@ export class PageResolver {
             primeRouterDetectionCache(cacheKey, "pages");
           }
         } else {
-          // Auto mode stays structural: a single resolved route must not pin router mode
-          // for projects that are still transitioning between app/ and pages/.
-          pageInfo = await getAppRouteEntity(
+          // Auto mode stays structural: detect the dominant router once, then keep
+          // pages fallback available for mixed or in-transition projects.
+          const useAppRouter = await detectAppRouter(
             this.projectDir,
-            slug,
+            this.config,
             this.adapter,
-            appDirName,
+            { projectId: this.projectId },
           );
-          if (!pageInfo) {
+
+          if (useAppRouter) {
+            pageInfo = await getAppRouteEntity(
+              this.projectDir,
+              slug,
+              this.adapter,
+              appDirName,
+            );
+            if (!pageInfo) {
+              pageInfo = await getEntityBySlug(this.projectDir, slug, this.adapter);
+            }
+          } else {
             pageInfo = await getEntityBySlug(this.projectDir, slug, this.adapter);
           }
         }

package/src/src/utils/version.ts

@@ -1,6 +1,6 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.59";
+export const VERSION = "0.1.87";
 
 export const SERVER_START_TIME: number = Date.now();