veryfront 0.1.1042 → 0.1.1043

package/esm/cli/shared/config.d.ts

@@ -18,11 +18,13 @@ export type VeryfrontConfig = InferSchema<ReturnType<typeof getVeryfrontConfigSc
 export declare const getResolvedConfigSchema: () => import("../../src/internal-agents/schema.js").Schema<import("../../src/extensions/schema/schema-validator.js").InferShape<{
     apiUrl: import("../../src/internal-agents/schema.js").Schema<string>;
     apiToken: import("../../src/internal-agents/schema.js").Schema<string>;
+    apiTokenSource: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
     projectSlug: import("../../src/internal-agents/schema.js").Schema<string>;
 }>>;
 export declare const ResolvedConfigSchema: import("../../src/internal-agents/schema.js").Schema<import("../../src/extensions/schema/schema-validator.js").InferShape<{
     apiUrl: import("../../src/internal-agents/schema.js").Schema<string>;
     apiToken: import("../../src/internal-agents/schema.js").Schema<string>;
+    apiTokenSource: import("../../src/internal-agents/schema.js").Schema<string | undefined>;
     projectSlug: import("../../src/internal-agents/schema.js").Schema<string>;
 }>>;
 export type ResolvedConfig = InferSchema<ReturnType<typeof getResolvedConfigSchema>>;

package/esm/cli/shared/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/config.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAGxE,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,2BAA2B,CAAC;AA6BzF,eAAO,MAAM,wBAAwB;;IAGjC,mDAAmD;;;;GAKtD,CAAC;AACF,eAAO,MAAM,qBAAqB;;IAN9B,mDAAmD;;;;GAMkB,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC;AAEvF,eAAO,MAAM,uBAAuB;;;;GAMnC,CAAC;AACF,eAAO,MAAM,oBAAoB;;;;GAAsC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAErF,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA2CxF;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAatF;AA4ED,eAAO,MAAM,aAAa,gBAJH,MAAM,QAAQ,iBAAiB,KAAG,OAAO,CAAC,cAAc,CAIvB,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,gBAZX,MAAM,QAAQ,iBAAiB,KAAG,OAAO,CAAC,cAAc,CAYhB,CAAC;AAUhE,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACrC;AAED,eAAO,MAAM,iBAAiB;;;;GAM7B,CAAC;AACF,eAAO,MAAM,cAAc;;;;GAAgC,CAAC;AAC5D,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AAEzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CA+GjE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/config.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAGxE,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,2BAA2B,CAAC;AA8BzF,eAAO,MAAM,wBAAwB;;IAGjC,mDAAmD;;;;GAKtD,CAAC;AACF,eAAO,MAAM,qBAAqB;;IAN9B,mDAAmD;;;;GAMkB,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC;AAEvF,eAAO,MAAM,uBAAuB;;;;;GAOnC,CAAC;AACF,eAAO,MAAM,oBAAoB;;;;;GAAsC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAGrF,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA2CxF;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAatF;AAmHD,eAAO,MAAM,aAAa,gBAJH,MAAM,QAAQ,iBAAiB,KAAG,OAAO,CAAC,cAAc,CAIvB,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,gBAZX,MAAM,QAAQ,iBAAiB,KAAG,OAAO,CAAC,cAAc,CAYhB,CAAC;AAUhE,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACrC;AAED,eAAO,MAAM,iBAAiB;;;;GAM7B,CAAC;AACF,eAAO,MAAM,cAAc;;;;GAAgC,CAAC;AAC5D,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AAEzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAuHjE"}

package/esm/cli/shared/config.js

@@ -9,6 +9,7 @@ import { defineSchema, lazySchema } from "../../src/schemas/index.js";
 import { join } from "../../src/platform/compat/path/index.js";
 import { createFileSystem, cwd, getEnv } from "../../src/platform/index.js";
 import { getEnvironmentConfig } from "../../src/config/index.js";
+import { getEnvSource } from "../../src/utils/env-loader.js";
 import { cliLogger, VERSION } from "../utils/index.js";
 import { readToken } from "../auth/token-store.js";
 import { ensureAuthenticated } from "../auth/login.js";
@@ -44,6 +45,7 @@ export const VeryfrontConfigSchema = lazySchema(getVeryfrontConfigSchema);
 export const getResolvedConfigSchema = defineSchema((v) => v.object({
     apiUrl: v.string(),
     apiToken: v.string(),
+    apiTokenSource: v.enum(["env", "env-file", "config-file", "token-store"]).optional(),
     projectSlug: v.string(),
 }));
 export const ResolvedConfigSchema = lazySchema(getResolvedConfigSchema);
@@ -130,16 +132,44 @@ function resolveTenantProjectReference() {
         getEnv("TENANT_PROJECT_ID") ||
         undefined;
 }
+async function resolveApiTokenForMode(env, configFile, interactive) {
+    const envToken = env.apiToken;
+    const envSource = envToken ? getEnvSource("VERYFRONT_API_TOKEN") : { source: "unset" };
+    const storedToken = await readToken(env);
+    if (envToken && envSource.source !== "env-file") {
+        return {
+            apiToken: envToken,
+            apiTokenSource: "env",
+        };
+    }
+    if (configFile?.apiToken) {
+        return { apiToken: configFile.apiToken, apiTokenSource: "config-file" };
+    }
+    if (interactive && envToken && envSource.source === "env-file" && storedToken) {
+        return { apiToken: storedToken, apiTokenSource: "token-store" };
+    }
+    if (envToken) {
+        return {
+            apiToken: envToken,
+            apiTokenSource: envSource.source === "env-file" ? "env-file" : "env",
+        };
+    }
+    if (storedToken) {
+        return { apiToken: storedToken, apiTokenSource: "token-store" };
+    }
+    return { apiToken: null };
+}
 async function resolveConfigBase(projectDir, env, interactive) {
     const dir = projectDir ?? cwd();
     const configFile = await readConfigFile(dir);
     const apiUrl = resolveCliApiUrl(env, configFile?.apiUrl);
-    let apiToken = env.apiToken ?? configFile?.apiToken ?? (await readToken(env));
+    let { apiToken, apiTokenSource } = await resolveApiTokenForMode(env, configFile, interactive);
     if (!apiToken && interactive) {
         const userInfo = await ensureAuthenticated(env);
         if (!userInfo)
             throw new Error("Authentication required for this operation.");
         apiToken = (await readToken(env)) ?? null;
+        apiTokenSource = apiToken ? "token-store" : undefined;
         if (!apiToken)
             throw new Error("Authentication failed. Please try again.");
     }
@@ -153,7 +183,7 @@ async function resolveConfigBase(projectDir, env, interactive) {
     if (!projectSlug) {
         throw new Error("Could not determine project reference. Set VERYFRONT_PROJECT_SLUG, TENANT_PROJECT_SLUG, VERYFRONT_PROJECT_ID, or add projectSlug to veryfront.config.ts");
     }
-    return { apiUrl, apiToken, projectSlug };
+    return { apiUrl, apiToken, ...(apiTokenSource ? { apiTokenSource } : {}), projectSlug };
 }
 function createConfigResolver(interactive) {
     return (projectDir, env) => resolveConfigByMode(projectDir, env, interactive);
@@ -177,6 +207,13 @@ export const getApiErrorSchema = defineSchema((v) => v.object({
 export const ApiErrorSchema = lazySchema(getApiErrorSchema);
 export function createApiClient(config) {
     const { apiUrl, apiToken } = config;
+    function addTokenSourceHint(message, status) {
+        if (config.apiTokenSource !== "env-file")
+            return message;
+        if (status !== 401 && status !== 403 && status !== 404)
+            return message;
+        return `${message}. VERYFRONT_API_TOKEN was loaded from a project .env file. For management commands, run 'veryfront login' and remove or rename the project runtime token, or pass a management token explicitly in the shell.`;
+    }
     async function requestOnce(method, url, body) {
         const response = await fetch(url, {
             method,
@@ -199,6 +236,7 @@ export function createApiClient(config) {
             catch {
                 // Keep default error message if JSON parsing fails
             }
+            errorMessage = addTokenSourceHint(errorMessage, response.status);
             const err = new Error(errorMessage);
             err.status = response.status;
             throw err;

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.1042",
+    "version": "0.1.1043",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {

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

@@ -9,6 +9,7 @@ export declare class StatOperations extends VeryfrontOperationsBase {
     private pathMapping;
     private readonly apiSearchCircuitBreaker;
     stat(path: string): Promise<FileInfo>;
+    private statWithoutSpan;
     private ensureIndexBuilt;
     private buildIndex;
     clearIndex(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"stat-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/stat-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAuB/D,qBAAa,cAAe,SAAQ,uBAAuB;IACzD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,aAAa,CAA8B;IAEnD,OAAO,CAAC,sBAAsB,CAA6B;IAC3D,OAAO,CAAC,qBAAqB,CAA8B;IAE3D,OAAO,CAAC,WAAW,CAAkC;IAErD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAGrC;IAEH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;YAkHvB,gBAAgB;YAwChB,UAAU;IAkDxB,UAAU,IAAI,IAAI;IAMlB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;YAIpC,cAAc;IAU5B,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,qBAAqB;YAQf,sBAAsB;YA8EtB,iBAAiB;IAS/B,OAAO,CAAC,gBAAgB;IA6DlB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA0F1F"}
+{"version":3,"file":"stat-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/stat-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAiC/D,qBAAa,cAAe,SAAQ,uBAAuB;IACzD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,aAAa,CAA8B;IAEnD,OAAO,CAAC,sBAAsB,CAA6B;IAC3D,OAAO,CAAC,qBAAqB,CAA8B;IAE3D,OAAO,CAAC,WAAW,CAAkC;IAErD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAGrC;IAEH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;YAIvB,eAAe;YA4Gf,gBAAgB;YAwChB,UAAU;IAkDxB,UAAU,IAAI,IAAI;IAMlB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;YAIpC,cAAc;IAU5B,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,qBAAqB;YAQf,sBAAsB;YA8EtB,iBAAiB;IAS/B,OAAO,CAAC,gBAAgB;IA6DlB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBtC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA0F1F"}

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

@@ -1,7 +1,8 @@
 import { logger as baseLogger } from "../../../../utils/index.js";
 import { isFrameworkSourcePath } from "../../../../utils/path-utils.js";
 import { VeryfrontOperationsBase } from "./base-operations.js";
-import { createError, toError } from "../../../../errors/index.js";
+import { createError, toError, VeryfrontError } from "../../../../errors/index.js";
+import { fromError } from "../../../../errors/veryfront-error.js";
 import { buildStatCacheKeyPrefix } from "./cache-keys.js";
 import { STAT_OPERATION_EXTENSION_PRIORITY as EXTENSION_PRIORITY } from "./extension-priority.js";
 import { collectParentDirectories, normalizeIndexedFilePath, resolveByExtensionPriority, resolveIndexByExtensionPriority, sortPathsByExtensionPriority, stripKnownExtension, } from "./stat-operations-helpers.js";
@@ -12,6 +13,13 @@ const logger = baseLogger.component("stat-operations");
 const NOT_FOUND_SENTINEL = "__NOT_FOUND__";
 const API_SEARCH_CIRCUIT_BREAKER_THRESHOLD = 5;
 const API_SEARCH_CIRCUIT_BREAKER_COOLDOWN_MS = 30_000;
+function isFileNotFoundError(error) {
+    if (error instanceof VeryfrontError && error.slug === "file-not-found") {
+        return true;
+    }
+    const veryfrontError = fromError(error);
+    return veryfrontError?.type === "file" && veryfrontError.message.startsWith("File not found:");
+}
 export class StatOperations extends VeryfrontOperationsBase {
     fileIndex = null;
     directoryIndex = null;
@@ -24,100 +32,101 @@ export class StatOperations extends VeryfrontOperationsBase {
         cooldownMs: API_SEARCH_CIRCUIT_BREAKER_COOLDOWN_MS,
     });
     stat(path) {
-        return withSpan("fs.veryfront.stat", async () => {
-            const normalizedPath = this.normalizer.normalize(path);
-            const ctx = this.contextProvider?.getContentContext();
-            const cacheKey = `${buildStatCacheKeyPrefix(ctx)}:${normalizedPath}`;
-            logger.debug("stat called", { path, normalizedPath, cacheKey });
-            await this.ensureIndexBuilt();
-            const fileIdx = this.fileIndex;
-            const dirIdx = this.directoryIndex;
-            if (!fileIdx || !dirIdx) {
-                logger.debug("stat - no index available", { normalizedPath });
-                throw toError(createError({
-                    type: "file",
-                    message: `Index not available for: ${normalizedPath}`,
-                }));
-            }
-            const file = fileIdx.get(normalizedPath);
-            if (file) {
-                logger.debug("stat found file", { normalizedPath });
-                return {
-                    size: file.size,
-                    mtime: new Date(file.updated_at),
-                    isDirectory: false,
-                    isFile: true,
-                    isSymlink: false,
-                };
-            }
-            if (dirIdx.has(normalizedPath)) {
-                logger.debug("stat found directory", { normalizedPath });
-                return {
-                    size: 0,
-                    mtime: new Date(),
-                    isDirectory: true,
-                    isFile: false,
-                    isSymlink: false,
-                };
-            }
-            // File not in index - try API pattern search as fallback for project files
-            // Skip for framework paths (node_modules, _veryfront, etc.)
-            if (!isFrameworkSourcePath(normalizedPath) && this.apiSearchCircuitBreaker.canSearch()) {
-                const hasKnownExt = EXTENSION_PRIORITY.some((ext) => normalizedPath.endsWith(ext));
-                if (hasKnownExt) {
-                    logger.debug("stat file not in index, trying API search", {
-                        normalizedPath,
-                        indexSize: fileIdx.size,
-                    });
-                    try {
-                        // Search for the exact file path
-                        const matches = await this.client.searchFiles(normalizedPath);
-                        this.apiSearchCircuitBreaker.recordSuccess();
-                        const exactMatch = matches.find((m) => m.path === normalizedPath);
-                        if (exactMatch) {
-                            logger.debug("stat found via API search", { normalizedPath });
-                            // Add to index for future lookups
-                            fileIdx.set(normalizedPath, {
-                                id: exactMatch.id,
-                                version_id: undefined,
-                                path: normalizedPath,
-                                content: undefined,
-                                type: "file",
-                                size: 0,
-                                updated_at: new Date().toISOString(),
-                            });
-                            return {
-                                size: 0,
-                                mtime: new Date(),
-                                isDirectory: false,
-                                isFile: true,
-                                isSymlink: false,
-                            };
-                        }
+        return withSpan("fs.veryfront.stat", () => this.statWithoutSpan(path), { "fs.path": path });
+    }
+    async statWithoutSpan(path) {
+        const normalizedPath = this.normalizer.normalize(path);
+        const ctx = this.contextProvider?.getContentContext();
+        const cacheKey = `${buildStatCacheKeyPrefix(ctx)}:${normalizedPath}`;
+        logger.debug("stat called", { path, normalizedPath, cacheKey });
+        await this.ensureIndexBuilt();
+        const fileIdx = this.fileIndex;
+        const dirIdx = this.directoryIndex;
+        if (!fileIdx || !dirIdx) {
+            logger.debug("stat - no index available", { normalizedPath });
+            throw toError(createError({
+                type: "file",
+                message: `Index not available for: ${normalizedPath}`,
+            }));
+        }
+        const file = fileIdx.get(normalizedPath);
+        if (file) {
+            logger.debug("stat found file", { normalizedPath });
+            return {
+                size: file.size,
+                mtime: new Date(file.updated_at),
+                isDirectory: false,
+                isFile: true,
+                isSymlink: false,
+            };
+        }
+        if (dirIdx.has(normalizedPath)) {
+            logger.debug("stat found directory", { normalizedPath });
+            return {
+                size: 0,
+                mtime: new Date(),
+                isDirectory: true,
+                isFile: false,
+                isSymlink: false,
+            };
+        }
+        // File not in index - try API pattern search as fallback for project files
+        // Skip for framework paths (node_modules, _veryfront, etc.)
+        if (!isFrameworkSourcePath(normalizedPath) && this.apiSearchCircuitBreaker.canSearch()) {
+            const hasKnownExt = EXTENSION_PRIORITY.some((ext) => normalizedPath.endsWith(ext));
+            if (hasKnownExt) {
+                logger.debug("stat file not in index, trying API search", {
+                    normalizedPath,
+                    indexSize: fileIdx.size,
+                });
+                try {
+                    // Search for the exact file path
+                    const matches = await this.client.searchFiles(normalizedPath);
+                    this.apiSearchCircuitBreaker.recordSuccess();
+                    const exactMatch = matches.find((m) => m.path === normalizedPath);
+                    if (exactMatch) {
+                        logger.debug("stat found via API search", { normalizedPath });
+                        // Add to index for future lookups
+                        fileIdx.set(normalizedPath, {
+                            id: exactMatch.id,
+                            version_id: undefined,
+                            path: normalizedPath,
+                            content: undefined,
+                            type: "file",
+                            size: 0,
+                            updated_at: new Date().toISOString(),
+                        });
+                        return {
+                            size: 0,
+                            mtime: new Date(),
+                            isDirectory: false,
+                            isFile: true,
+                            isSymlink: false,
+                        };
                     }
-                    catch (error) {
-                        const result = this.apiSearchCircuitBreaker.recordFailure();
-                        if (result.tripped) {
-                            logger.warn("stat API search circuit breaker tripped", {
-                                failures: result.failures,
-                            });
-                        }
-                        logger.debug("stat API search failed", {
-                            normalizedPath,
-                            error: error instanceof Error ? error.message : String(error),
+                }
+                catch (error) {
+                    const result = this.apiSearchCircuitBreaker.recordFailure();
+                    if (result.tripped) {
+                        logger.warn("stat API search circuit breaker tripped", {
+                            failures: result.failures,
                         });
                     }
+                    logger.debug("stat API search failed", {
+                        normalizedPath,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
                 }
             }
-            logger.debug("stat file not found (not in index)", {
-                normalizedPath,
-                indexSize: fileIdx.size,
-            });
-            throw toError(createError({
-                type: "file",
-                message: `File not found: ${normalizedPath}`,
-            }));
-        }, { "fs.path": path });
+        }
+        logger.debug("stat file not found (not in index)", {
+            normalizedPath,
+            indexSize: fileIdx.size,
+        });
+        throw toError(createError({
+            type: "file",
+            message: `File not found: ${normalizedPath}`,
+        }));
     }
     async ensureIndexBuilt() {
         if (this.fileIndex && this.directoryIndex) {
@@ -357,15 +366,18 @@ export class StatOperations extends VeryfrontOperationsBase {
         return null;
     }
     async exists(path) {
-        const normalizedPath = this.normalizer.normalize(path);
-        try {
-            await this.stat(normalizedPath);
-            return true;
-        }
-        catch (_) {
-            /* expected: stat throws when file does not exist */
-            return false;
-        }
+        return withSpan("fs.veryfront.exists", async () => {
+            try {
+                await this.statWithoutSpan(path);
+                return true;
+            }
+            catch (error) {
+                if (isFileNotFoundError(error)) {
+                    return false;
+                }
+                throw error;
+            }
+        }, { "fs.path": path });
     }
     async resolveFile(basePath, options) {
         const resolveStart = performance.now();

package/esm/src/skill/path-safety.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-safety.d.ts","sourceRoot":"","sources":["../../../src/src/skill/path-safety.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAkFtE;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAmEjB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBnB"}
+{"version":3,"file":"path-safety.d.ts","sourceRoot":"","sources":["../../../src/src/skill/path-safety.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AA2FtE;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAmEjB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CA2BnB"}

package/esm/src/skill/path-safety.js

@@ -10,11 +10,19 @@ import * as dntShim from "../../_dnt.shims.js";
 import { validatePath } from "../security/index.js";
 import { isAbsolute, join, relative, resolve } from "../platform/compat/path/index.js";
 import { exists, readDir, stat } from "../platform/compat/fs.js";
-import { createError, toError } from "../errors/veryfront-error.js";
+import { VeryfrontError } from "../errors/index.js";
+import { createError, fromError, toError } from "../errors/veryfront-error.js";
 function isInsideDir(baseDir, targetPath) {
     const rel = relative(baseDir, targetPath);
     return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
 }
+function isFileNotFoundError(error) {
+    if (error instanceof VeryfrontError && error.slug === "file-not-found") {
+        return true;
+    }
+    const veryfrontError = fromError(error);
+    return veryfrontError?.type === "file" && veryfrontError.message.startsWith("File not found:");
+}
 async function pathExists(path, fsAdapter) {
     return fsAdapter ? await fsAdapter.exists(path) : await exists(path);
 }
@@ -148,7 +156,16 @@ export async function validateSkillPath(skillRoot, requestedPath, allowedSubdirs
  */
 export async function listSkillSubdir(skillRoot, subdir, fsAdapter) {
     const dirPath = join(skillRoot, subdir);
-    const dirExists = fsAdapter ? await fsAdapter.exists(dirPath) : await exists(dirPath);
+    let dirExists;
+    try {
+        dirExists = fsAdapter ? await fsAdapter.exists(dirPath) : await exists(dirPath);
+    }
+    catch (error) {
+        if (isFileNotFoundError(error)) {
+            return [];
+        }
+        throw error;
+    }
     if (!dirExists) {
         return [];
     }

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

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.1042";
+export declare const VERSION = "0.1.1043";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.1042";
+export const VERSION = "0.1.1043";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.1042",
+  "version": "0.1.1043",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -330,9 +330,9 @@
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "ws": "8.21.0",
-    "@veryfront/ext-bundler-esbuild": "0.1.1042",
-    "@veryfront/ext-content-mdx": "0.1.1042",
-    "@veryfront/ext-css-tailwind": "0.1.1042"
+    "@veryfront/ext-bundler-esbuild": "0.1.1043",
+    "@veryfront/ext-content-mdx": "0.1.1043",
+    "@veryfront/ext-css-tailwind": "0.1.1043"
   },
   "devDependencies": {
     "@types/node": "20.9.0"