veryfront 0.1.1021 → 0.1.1023

package/esm/cli/commands/open/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/open/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,WAgBtB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/open/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,WAqBtB,CAAC"}

package/esm/cli/commands/open/command-help.js

@@ -4,12 +4,17 @@ export const openHelp = {
     description: "Open project URLs in the browser",
     usage: "veryfront open [options]",
     options: [
+        {
+            flag: "-p, --project-slug <slug>",
+            description: "Project slug to open (overrides inferred project)",
+        },
         { flag: "--env <name>", description: "Open a specific environment URL" },
         { flag: "--studio", description: "Open Veryfront Studio" },
         { flag: "--json", description: "Output URL as JSON instead of opening" },
     ],
     examples: [
         "veryfront open",
+        "veryfront open -p my-project",
         "veryfront open --env staging",
         "veryfront open --studio",
         "veryfront open --json",

package/esm/cli/commands/pull/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pull/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,WAqDtB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pull/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,WA2DtB,CAAC"}

package/esm/cli/commands/pull/command-help.js

@@ -2,8 +2,12 @@ export const pullHelp = {
     name: "pull",
     category: "deploy",
     description: "Download project files from Veryfront remote",
-    usage: "veryfront pull [options]",
+    usage: "veryfront pull [project-slug] [options]",
     options: [
+        {
+            flag: "-p, --project-slug <slug>",
+            description: "Project slug to pull (overrides inferred project)",
+        },
         {
             flag: "--projects <slugs>",
             description: "Comma-separated list of project slugs to pull",
@@ -35,6 +39,8 @@ export const pullHelp = {
     ],
     examples: [
         "veryfront pull",
+        "veryfront pull veryfront-based-38c7d03a",
+        "veryfront pull -p veryfront-based-38c7d03a --dir ./veryfront-based",
         "veryfront pull --dir ./my-project",
         "veryfront pull --branch feature-header",
         "veryfront pull --env production",

package/esm/cli/commands/pull/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pull/command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAM3E,OAAO,EACL,eAAe,EAIhB,MAAM,wBAAwB,CAAC;AAOhC;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;GAY7B,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;GAAgC,CAAC;AAE5D,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;GAUxB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAKlE;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AA2CD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAWjF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EAC1C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,WAAW,EAAE,CAAC,CAoBxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAmBjG;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EAC1C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,MAAM,CAAC,CAQjB;AA8ID;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuGpE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pull/command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAM3E,OAAO,EACL,eAAe,EAIhB,MAAM,wBAAwB,CAAC;AAgBhC;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;GAY7B,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;GAAgC,CAAC;AAE5D,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;GAUxB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAKlE;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAyDD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAWjF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EAC1C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,WAAW,EAAE,CAAC,CAoBxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAmBjG;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EAC1C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAwND;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8IpE"}

package/esm/cli/commands/pull/command.js

@@ -13,9 +13,11 @@ import { resolveCliApiUrl } from "../../shared/constants.js";
 import { cwd } from "../../../src/platform/index.js";
 import { createFileSystem } from "../../../src/platform/index.js";
 import { createApiClient, readConfigFile, resolveConfigWithAuth, } from "../../shared/config.js";
-import { confirmPrompt, logInfo, logSuccess, logWarning } from "../../utils/index.js";
+import { confirmPrompt, isTTY, logInfo, logSuccess, logWarning } from "../../utils/index.js";
 import { createNoopSpinner, createSpinner } from "../../ui/index.js";
+import { isInteractive } from "../../shared/interactive.js";
 import { getApiTokenEnv, getEnvironmentConfig } from "../../../src/config/index.js";
+import { ERROR_REGISTRY, getErrorBySlug, INVALID_ARGUMENT, RESOURCE_NOT_FOUND, VeryfrontError, } from "../../../src/errors/index.js";
 import { withSpan } from "../../../src/observability/tracing/otlp-setup.js";
 import { CommonArgs, createArgParser } from "../../shared/args.js";
 /**
@@ -195,6 +197,41 @@ function formatPullSource(source) {
             return "main";
     }
 }
+function describeError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function errorStatus(error) {
+    const status = error?.status;
+    return typeof status === "number" ? status : undefined;
+}
+function errorSlug(error) {
+    const slug = error?.slug;
+    return typeof slug === "string" ? slug : undefined;
+}
+function pullProjectListError(projectSlug, sourceLabel, error) {
+    const message = [
+        `Failed to list files for project "${projectSlug}" from ${sourceLabel}: ${describeError(error)}.`,
+        "Check that the project slug is exact, the selected branch/env/release exists, and your token has access.",
+    ].join(" ");
+    const status = errorStatus(error);
+    if (status === 404) {
+        return RESOURCE_NOT_FOUND.create({ detail: message, cause: error, status });
+    }
+    const wrapped = new Error(message, { cause: error });
+    if (typeof status === "number") {
+        wrapped.status = status;
+    }
+    return wrapped;
+}
+async function confirmPullWrite(projectDir) {
+    if (isInteractive() && !isTTY()) {
+        throw INVALID_ARGUMENT.create({
+            detail: `Pull requires confirmation before writing files, but no interactive prompt is available. ` +
+                `Re-run with --force to write into ${projectDir} without prompting.`,
+        });
+    }
+    return await confirmPrompt(`This will overwrite local files in ${projectDir}. Continue?`, false);
+}
 async function pullSingleProject(projectSlug, projectDir, source, force, dryRun, config, quiet = false) {
     const sourceLabel = formatPullSource(source);
     let spinner = quiet
@@ -205,13 +242,16 @@ async function pullSingleProject(projectSlug, projectDir, source, force, dryRun,
     try {
         files = await listAllFiles(client, projectSlug, source);
     }
+    catch (error) {
+        throw pullProjectListError(projectSlug, sourceLabel, error);
+    }
     finally {
         spinner.stop();
     }
     if (files.length === 0) {
         if (!quiet)
             logInfo(`No files to pull from ${projectSlug}.`);
-        return { written: 0, skipped: 0 };
+        return { written: 0, skipped: 0, cancelled: false };
     }
     const writeOps = [];
     for (const file of files) {
@@ -227,10 +267,10 @@ async function pullSingleProject(projectSlug, projectDir, source, force, dryRun,
         cliLogger.info(`\nFound ${files.length} files to ${dryRun ? "pull" : "write"} from ${projectSlug}.`);
     }
     if (!force && !dryRun) {
-        const confirmed = await confirmPrompt(`This will overwrite local files in ${projectDir}. Continue?`, false);
+        const confirmed = await confirmPullWrite(projectDir);
         if (!confirmed) {
             cliLogger.info("Pull cancelled.");
-            return { written: 0, skipped: 0 };
+            return { written: 0, skipped: 0, cancelled: true };
         }
     }
     spinner = quiet ? createNoopSpinner() : createSpinner(`Writing files to ${projectDir}...`);
@@ -246,7 +286,31 @@ async function pullSingleProject(projectSlug, projectDir, source, force, dryRun,
                 logWarning(`Skipped ${result.skipped} files due to errors.`);
         }
     }
-    return result;
+    return { ...result, cancelled: false };
+}
+function formatProjectCount(count) {
+    return `${count} project${count === 1 ? "" : "s"}`;
+}
+function failedProjectsDetail(failedProjects) {
+    const names = failedProjects.map(({ project }) => project).join(", ");
+    const details = failedProjects.map(({ project, message }) => `${project}: ${message}`).join(" ");
+    return `Failed to pull ${formatProjectCount(failedProjects.length)}: ${names}. ${details}`;
+}
+function isErrorSlug(slug) {
+    return typeof slug === "string" && slug in ERROR_REGISTRY;
+}
+function structuredFailureAggregate(failedProjects, detail) {
+    if (failedProjects.length === 1) {
+        const error = failedProjects[0]?.error;
+        if (error instanceof VeryfrontError)
+            return error;
+    }
+    const slug = failedProjects[0]?.slug;
+    if (!isErrorSlug(slug))
+        return null;
+    if (!failedProjects.every((failure) => failure.slug === slug))
+        return null;
+    return getErrorBySlug(slug).create({ detail });
 }
 /**
  * Pull files from Veryfront API
@@ -285,23 +349,30 @@ export function pullCommand(options = {}) {
             await pullSingleProject(config.projectSlug, projectDir, source, force, dryRun, config, quiet);
             return;
         }
-        const fs = createFileSystem();
         let totalWritten = 0;
-        let totalSkipped = 0;
+        let totalSkippedFiles = 0;
+        const failedProjects = [];
+        const cancelledProjects = [];
         for (const project of projects) {
             const targetDir = join(projectDir, project);
-            if (!dryRun)
-                await fs.mkdir(targetDir, { recursive: true });
             if (!quiet)
                 cliLogger.info(`\n--- Pulling ${project} into ${targetDir} ---`);
             try {
                 const result = await pullSingleProject(project, targetDir, source, force, dryRun, config, quiet);
                 totalWritten += result.written;
-                totalSkipped += result.skipped;
+                totalSkippedFiles += result.skipped;
+                if (result.cancelled)
+                    cancelledProjects.push(project);
             }
             catch (error) {
-                cliLogger.error(`Failed to pull ${project}:`, error);
-                totalSkipped++;
+                cliLogger.error(`Failed to pull ${project}: ${describeError(error)}`);
+                failedProjects.push({
+                    project,
+                    message: describeError(error),
+                    status: errorStatus(error),
+                    slug: errorSlug(error),
+                    error,
+                });
             }
         }
         if (!quiet) {
@@ -309,11 +380,31 @@ export function pullCommand(options = {}) {
             if (dryRun) {
                 logInfo(`Dry run complete. Would write ${totalWritten} files total across ${projects.length} projects.`);
             }
-            else {
+            else if (totalWritten > 0) {
                 logSuccess(`Pulled ${totalWritten} files total across ${projects.length} projects.`);
-                if (totalSkipped > 0)
-                    logWarning(`Skipped ${totalSkipped} files due to errors.`);
             }
+            else {
+                logInfo(`No files were pulled across ${projects.length} projects.`);
+            }
+            if (cancelledProjects.length > 0) {
+                logWarning(`Cancelled ${formatProjectCount(cancelledProjects.length)}: ${cancelledProjects.join(", ")}.`);
+            }
+            if (failedProjects.length > 0) {
+                logWarning(`Failed to pull ${formatProjectCount(failedProjects.length)}: ${failedProjects.map(({ project }) => project).join(", ")}.`);
+            }
+            if (totalSkippedFiles > 0) {
+                logWarning(`Skipped ${totalSkippedFiles} files due to write errors.`);
+            }
+        }
+        if (failedProjects.length > 0) {
+            const detail = failedProjectsDetail(failedProjects);
+            if (failedProjects.every((failure) => failure.slug === "resource-not-found" || failure.status === 404)) {
+                throw RESOURCE_NOT_FOUND.create({ detail });
+            }
+            const structuredError = structuredFailureAggregate(failedProjects, detail);
+            if (structuredError)
+                throw structuredError;
+            throw new Error(detail);
         }
     }, { "cli.dryRun": options.dryRun ?? false, "cli.source_type": source.type });
 }

package/esm/cli/commands/push/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/push/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,WAoCtB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/push/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,WAyCtB,CAAC"}

package/esm/cli/commands/push/command-help.js

@@ -8,6 +8,10 @@ export const pushHelp = {
             flag: "-d, --dir <path>",
             description: "Source directory (default: current directory)",
         },
+        {
+            flag: "-p, --project-slug <slug>",
+            description: "Project slug to push to (overrides inferred project)",
+        },
         {
             flag: "-b, --branch <name>",
             description: "Branch name (default: cli/push-<timestamp>, use 'main' for direct push)",
@@ -23,6 +27,7 @@ export const pushHelp = {
     ],
     examples: [
         "veryfront push",
+        "veryfront push -p my-project",
         "veryfront push --dir ./my-project",
         "veryfront push --branch feature-header",
         "veryfront push --branch main             # Push directly to main",

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

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/args.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,gFAAgF;AAChF,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GACzC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,oEAAoE;IACpE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2EAA2E;IAC3E,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChD,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;KACrB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO;CACzB,CAAC;AAmBF;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,OAAO,GACZ,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAclD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAChB,CAAC,IAAI,EAAE,UAAU,KAAK,eAAe,CAAC,CAAC,CAAC,CAU1C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,eAAe,CAAC,CAAC,CAAC,EAChD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,GACf,CAAC,CAQH;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAaY,CAAC;AAqFpC,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAgBvD"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/args.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,gFAAgF;AAChF,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GACzC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,oEAAoE;IACpE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2EAA2E;IAC3E,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChD,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;KACrB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO;CACzB,CAAC;AAmBF;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,OAAO,GACZ,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAclD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAChB,CAAC,IAAI,EAAE,UAAU,KAAK,eAAe,CAAC,CAAC,CAAC,CAU1C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,eAAe,CAAC,CAAC,CAAC,EAChD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,GACf,CAAC,CAQH;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAaY,CAAC;AAuFpC,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAgBvD"}

package/esm/cli/shared/args.js

@@ -168,10 +168,14 @@ function parse(args, options = {}) {
             const next = args[i + 1];
             if (isValue(next)) {
                 setValue(key, next);
+                if (key !== short)
+                    setValue(short, next);
                 i++;
                 continue;
             }
             setValue(key, true);
+            if (key !== short)
+                setValue(short, true);
             continue;
         }
         result._.push(arg);

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

@@ -5,7 +5,7 @@ export type ServerMode = InferSchema<ReturnType<typeof getServerModeSchema>>;
 export interface ParsedArgs {
     _: (string | number)[];
     port?: number;
-    p?: number;
+    p?: number | string;
     __explicit?: Record<string, true>;
     help?: boolean;
     h?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAExE,eAAO,MAAM,mBAAmB,oEAAmE,CAAC;AACpG,eAAO,MAAM,gBAAgB,8DAAkC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IACb,4DAA4D;IAC5D,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,CAAC,CAAC,EAAE,UAAU,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAExE,eAAO,MAAM,mBAAmB,oEAAmE,CAAC;AACpG,eAAO,MAAM,gBAAgB,8DAAkC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IACb,4DAA4D;IAC5D,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,CAAC,CAAC,EAAE,UAAU,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/esm/cli/utils/index.d.ts

@@ -28,6 +28,10 @@ export declare function promptUser(message: string): Promise<string>;
  */
 export declare function promptPassword(message: string): string;
 export declare function confirmPrompt(message: string, defaultValue?: boolean): Promise<boolean>;
+export declare function ensureConfirmPromptAvailable(options: {
+    interactive: boolean;
+    stdoutTTY: boolean;
+}): void;
 /** Exit the process with the given code. */
 export declare function exitProcess(code: number): void;
 export {};

package/esm/cli/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/index.ts"],"names":[],"mappings":"AAuBA,KAAK,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAMjD,eAAO,MAAM,SAAS,EAAE;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,SAAS,CAAC;IAC/D,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,SAAS,CAAC;CAYhD,CAAC;AAEF,eAAO,MAAM,OAAO,QAAwE,CAAC;AAC7F,eAAO,MAAM,uBAAuB,OAAmB,CAAC;AAExD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqBjD;AAED,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,wBAAgB,QAAQ,IAAI,IAAI,CAa/B;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC9D,IAAI,CAmBN;AAKD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGrD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGnD;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3D;AAOD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAuCtD;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,YAAY,UAAQ,GACnB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/index.ts"],"names":[],"mappings":"AAwBA,KAAK,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAMjD,eAAO,MAAM,SAAS,EAAE;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,SAAS,CAAC;IAC/D,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,SAAS,CAAC;CAYhD,CAAC;AAEF,eAAO,MAAM,OAAO,QAAwE,CAAC;AAC7F,eAAO,MAAM,uBAAuB,OAAmB,CAAC;AAExD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqBjD;AAED,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,wBAAgB,QAAQ,IAAI,IAAI,CAa/B;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC9D,IAAI,CAmBN;AAKD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGrD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGnD;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3D;AAOD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAuCtD;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,YAAY,UAAQ,GACnB,OAAO,CAAC,OAAO,CAAC,CAclB;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,IAAI,CAOP;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C"}

package/esm/cli/utils/index.js

@@ -1,4 +1,5 @@
 import denoConfig from "../../deno.js";
+import { INVALID_ARGUMENT } from "../../src/errors/index.js";
 import { exit, getEnv, isStdoutTTY, onSignal, promptSync, readStdinByteSync, setRawMode, writeStdout, } from "../../src/platform/index.js";
 import { DEFAULT_DEV_PORT } from "../shared/constants.js";
 import { bold, brand, dim, error as errorColor, muted, shouldUseColor, success as successColor, warning as warningColor, } from "../ui/colors.js";
@@ -154,10 +155,10 @@ export function promptPassword(message) {
 }
 export async function confirmPrompt(message, defaultValue = false) {
     const { isInteractive } = await import("../shared/interactive.js");
-    if (!isInteractive())
+    const interactive = isInteractive();
+    if (!interactive)
         return true;
-    if (!isTTY())
-        return defaultValue;
+    ensureConfirmPromptAvailable({ interactive, stdoutTTY: isTTY() });
     const hint = defaultValue ? "[Y/n]" : "[y/N]";
     const response = await promptUser(`${message} ${hint} `);
     if (!response)
@@ -165,6 +166,13 @@ export async function confirmPrompt(message, defaultValue = false) {
     const normalized = response.toLowerCase().trim();
     return normalized === "y" || normalized === "yes";
 }
+export function ensureConfirmPromptAvailable(options) {
+    if (!options.interactive || options.stdoutTTY)
+        return;
+    throw INVALID_ARGUMENT.create({
+        detail: "Confirmation required but no interactive prompt is available. Re-run with --yes to confirm without prompting, or use --force when the command supports it.",
+    });
+}
 /** Exit the process with the given code. */
 export function exitProcess(code) {
     exit(code);

package/esm/deno.js

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

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

@@ -15,6 +15,10 @@ export declare class VeryfrontFSAdapter implements FSAdapter {
     /** Single-flight background rewarm when the file list cache disappears */
     private fileListWarmupPromise;
     private fileListWarmupKey;
+    /** Single-flight foreground refresh when a branch preview read misses a newly pushed file. */
+    private branchMissRecoveryPromise;
+    private branchMissRecoveryGeneration;
+    private readonly branchMissRecoveryFailures;
     private projectData?;
     private apiBaseUrl;
     private apiToken;
@@ -38,6 +42,12 @@ export declare class VeryfrontFSAdapter implements FSAdapter {
     initialize(): Promise<void>;
     private isPersistentCacheInvalidated;
     private shouldBackgroundPregenerateStyles;
+    private getBranchMissRecoveryKey;
+    private hasRecentBranchMissRecoveryFailure;
+    private shouldRecoverBranchMiss;
+    private shouldRecoverBranchMissResult;
+    private refreshBranchSnapshotAfterMiss;
+    private withBranchSnapshotRecovery;
     private scheduleFileListWarmup;
     refreshSourceSnapshot(reason?: string): Promise<void>;
     getPokeMetrics(): {

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":"AAEA,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EACd,SAAS,EACT,eAAe,EAEf,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAgEnE,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,WAAW,CAAS;IAE5B,kFAAkF;IAClF,OAAO,CAAC,oBAAoB,CAA6B;IACzD,0EAA0E;IAC1E,OAAO,CAAC,qBAAqB,CAA8B;IAC3D,OAAO,CAAC,iBAAiB,CAAuB;IAChD,8FAA8F;IAC9F,OAAO,CAAC,yBAAyB,CAA8B;IAC/D,OAAO,CAAC,4BAA4B,CAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAA6B;IAExE,OAAO,CAAC,WAAW,CAAC,CAAU;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAAmB;IAEpC,4DAA4D;IAC5D,OAAO,CAAC,aAAa,CAAuB;IAE5C,+CAA+C;IAC/C,OAAO,CAAC,aAAa,CAAgB;IACrC,iGAAiG;IACjG,OAAO,CAAC,cAAc,CAAuC;IAC7D,mFAAmF;IACnF,OAAO,CAAC,SAAS,CAAU;IAE3B,OAAO,CAAC,0BAA0B;IAIlC,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,qBAAqB;YAMf,sBAAsB;gBA4BxB,MAAM,EAAE,eAAe;IAmI7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyJjC,OAAO,CAAC,4BAA4B;IAIpC,OAAO,CAAC,iCAAiC;IAOzC,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,kCAAkC;IAU1C,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,6BAA6B;YAkBvB,8BAA8B;YAsB9B,0BAA0B;IAwDxC,OAAO,CAAC,sBAAsB;IA0ExB,qBAAqB,CAAC,MAAM,SAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDrE,cAAc,IAAI;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;IAIK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKhD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAYhD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKrC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUtC,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAYzB,OAAO,IAAI,IAAI;IAef,aAAa,IAAI,UAAU;IAI3B,cAAc,IAAI,OAAO,GAAG,SAAS;IAI/B,iBAAiB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAwC7E,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOpD,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMrD,0BAA0B,CAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IA0BvD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,iBAAiB,IAAI,IAAI;IAIzB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAK7C,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC,kBAAkB,IAAI,IAAI;IAK1B,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAwDxD,iBAAiB,IAAI,sBAAsB,GAAG,IAAI;IAWlD,SAAS,IAAI,kBAAkB;YAIjB,iBAAiB;IAK/B;;;;;OAKG;YACW,uBAAuB;CAsCtC"}

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

@@ -6,14 +6,16 @@ import { PathNormalizer } from "./path-normalizer.js";
 import { ReadOperations } from "./read-operations.js";
 import { DirectoryOperations } from "./directory-operations.js";
 import { StatOperations } from "./stat-operations.js";
-import { buildFileCacheKeyPrefix, buildFileListCacheKey } from "./cache-keys.js";
+import { buildDirCacheKeyPrefix, buildFileCacheKeyPrefix, buildFileListCacheKey, buildStatCacheKeyPrefix, } from "./cache-keys.js";
 import { isPrefixBeingInvalidated } from "./invalidation-state.js";
 import { WebSocketManager } from "./websocket-manager.js";
 import { fetchFileListForContext, hasContentContextChanged, resolveContentContext, summarizeFileList, toClientContext, } from "./adapter-content-context.js";
 import { buildFileCacheOptions, buildRetryConfig, shouldBackgroundPregenerateStyles, } from "./adapter-helpers.js";
+import { isNotFoundLikeError } from "./read-operations-helpers.js";
 import { clearCachedReleaseAssetManifests, registerManifestFetcherForRelease, unregisterManifestFetcherForRelease, } from "../../../../release-assets/manifest-cache.js";
 import { parseReleaseAssetManifest } from "../../../../release-assets/manifest-schema.js";
 const logger = baseLogger.component("veryfront-fs-adapter");
+const BRANCH_MISS_RECOVERY_FAILURE_TTL_MS = 5_000;
 /**
  * Build a project-scoped manifest fetcher backed by the given API client.
  *
@@ -43,6 +45,10 @@ export class VeryfrontFSAdapter {
     /** Single-flight background rewarm when the file list cache disappears */
     fileListWarmupPromise = null;
     fileListWarmupKey = null;
+    /** Single-flight foreground refresh when a branch preview read misses a newly pushed file. */
+    branchMissRecoveryPromise = null;
+    branchMissRecoveryGeneration = 0;
+    branchMissRecoveryFailures = new Map();
     projectData;
     apiBaseUrl;
     apiToken;
@@ -312,6 +318,113 @@ export class VeryfrontFSAdapter {
         // pregenerate through the WebSocket path after branch content changes.
         return shouldBackgroundPregenerateStyles(this.contentContext);
     }
+    getBranchMissRecoveryKey(path) {
+        const normalizedPath = this.normalizer.normalize(path);
+        const branch = this.requestBranch ?? this.contentContext?.branch ?? "main";
+        return `${this.projectSlug}:${branch}:${normalizedPath}`;
+    }
+    hasRecentBranchMissRecoveryFailure(key) {
+        const failedAt = this.branchMissRecoveryFailures.get(key);
+        if (!failedAt)
+            return false;
+        if (Date.now() - failedAt < BRANCH_MISS_RECOVERY_FAILURE_TTL_MS)
+            return true;
+        this.branchMissRecoveryFailures.delete(key);
+        return false;
+    }
+    shouldRecoverBranchMiss(path, error) {
+        if (this.contentContext?.sourceType !== "branch")
+            return false;
+        if (!isNotFoundLikeError(error))
+            return false;
+        const recoveryKey = this.getBranchMissRecoveryKey(path);
+        return !this.hasRecentBranchMissRecoveryFailure(recoveryKey);
+    }
+    shouldRecoverBranchMissResult(path, result, options) {
+        if (this.contentContext?.sourceType !== "branch")
+            return false;
+        if (!options?.isRecoverableMissResult?.(result))
+            return false;
+        if (options.requirePendingSourceInvalidation &&
+            !this.isPersistentCacheInvalidated(buildFileCacheKeyPrefix(this.contentContext))) {
+            return false;
+        }
+        const recoveryKey = this.getBranchMissRecoveryKey(path);
+        return !this.hasRecentBranchMissRecoveryFailure(recoveryKey);
+    }
+    async refreshBranchSnapshotAfterMiss(path) {
+        let recoveryPromise = this.branchMissRecoveryPromise;
+        let ownsRecovery = false;
+        let recoveryGeneration = this.branchMissRecoveryGeneration;
+        if (!recoveryPromise) {
+            const normalizedPath = this.normalizer.normalize(path);
+            recoveryPromise = this.refreshSourceSnapshot(`branch-miss:${normalizedPath}`);
+            this.branchMissRecoveryPromise = recoveryPromise;
+            recoveryGeneration = ++this.branchMissRecoveryGeneration;
+            ownsRecovery = true;
+        }
+        try {
+            await recoveryPromise;
+        }
+        finally {
+            if (ownsRecovery && this.branchMissRecoveryGeneration === recoveryGeneration) {
+                this.branchMissRecoveryPromise = null;
+            }
+        }
+    }
+    async withBranchSnapshotRecovery(path, operation, options) {
+        try {
+            const result = await operation();
+            if (!this.shouldRecoverBranchMissResult(path, result, options))
+                return result;
+            const recoveryKey = this.getBranchMissRecoveryKey(path);
+            try {
+                await this.refreshBranchSnapshotAfterMiss(path);
+            }
+            catch (refreshError) {
+                this.branchMissRecoveryFailures.set(recoveryKey, Date.now());
+                logger.warn("Branch snapshot recovery failed after result miss", {
+                    path: this.normalizer.normalize(path),
+                    projectSlug: this.projectSlug,
+                    branch: this.requestBranch ?? this.contentContext?.branch,
+                    error: refreshError instanceof Error ? refreshError.message : String(refreshError),
+                });
+                return result;
+            }
+            const retryResult = await operation();
+            if (options?.isRecoverableMissResult?.(retryResult)) {
+                this.branchMissRecoveryFailures.set(recoveryKey, Date.now());
+            }
+            return retryResult;
+        }
+        catch (error) {
+            if (!this.shouldRecoverBranchMiss(path, error))
+                throw error;
+            const recoveryKey = this.getBranchMissRecoveryKey(path);
+            try {
+                await this.refreshBranchSnapshotAfterMiss(path);
+            }
+            catch (refreshError) {
+                this.branchMissRecoveryFailures.set(recoveryKey, Date.now());
+                logger.warn("Branch snapshot recovery failed after not-found miss", {
+                    path: this.normalizer.normalize(path),
+                    projectSlug: this.projectSlug,
+                    branch: this.requestBranch ?? this.contentContext?.branch,
+                    error: refreshError instanceof Error ? refreshError.message : String(refreshError),
+                });
+                throw error;
+            }
+            try {
+                return await operation();
+            }
+            catch (retryError) {
+                if (isNotFoundLikeError(retryError)) {
+                    this.branchMissRecoveryFailures.set(recoveryKey, Date.now());
+                }
+                throw retryError;
+            }
+        }
+    }
     scheduleFileListWarmup(reason, cacheKey) {
         if (!this.initialized || !this.contentContext)
             return;
@@ -393,10 +506,16 @@ export class VeryfrontFSAdapter {
         this.readOps.clearFileListIndex();
         this.statOps.clearIndex();
         this.dirOps.clearTree();
-        await this.cache.deleteAsync(cacheKey);
+        await Promise.all([
+            this.cache.deleteByPrefixAsync(buildFileCacheKeyPrefix(refreshContext)),
+            this.cache.deleteByPrefixAsync(buildStatCacheKeyPrefix(refreshContext)),
+            this.cache.deleteByPrefixAsync(buildDirCacheKeyPrefix(refreshContext)),
+            this.cache.deleteAsync(cacheKey),
+        ]);
         const files = await fetchFileListForContext(this.client, refreshContext);
         await this.cache.setAsync(cacheKey, files);
         const fileSummary = summarizeFileList(files);
+        this.branchMissRecoveryFailures.clear();
         if (fileSummary.sourceFilesWithContent > 0 && this.shouldBackgroundPregenerateStyles()) {
             this.triggerCSSPregeneration(files).catch(() => {
                 // Error already logged in triggerCSSPregeneration
@@ -419,31 +538,43 @@ export class VeryfrontFSAdapter {
     }
     async readFile(path) {
         await this.ensureInitialized();
-        return this.readOps.readTextFile(path);
+        return this.withBranchSnapshotRecovery(path, () => this.readOps.readTextFile(path));
     }
     async readFileBytes(path) {
         await this.ensureInitialized();
-        return this.readOps.readFile(path);
+        return this.withBranchSnapshotRecovery(path, () => this.readOps.readFile(path));
     }
     async readTextFile(path) {
         await this.ensureInitialized();
-        return this.readOps.readTextFile(path);
+        return this.withBranchSnapshotRecovery(path, () => this.readOps.readTextFile(path));
     }
     async readdir(path) {
         await this.ensureInitialized();
-        return this.dirOps.readdir(path);
+        return this.withBranchSnapshotRecovery(path, () => this.dirOps.readdir(path), {
+            isRecoverableMissResult: (entries) => entries.length === 0,
+            requirePendingSourceInvalidation: true,
+        });
     }
     async stat(path) {
         await this.ensureInitialized();
-        return this.statOps.stat(path);
+        return this.withBranchSnapshotRecovery(path, () => this.statOps.stat(path));
     }
     async exists(path) {
         await this.ensureInitialized();
-        return this.statOps.exists(path);
+        try {
+            await this.withBranchSnapshotRecovery(path, () => this.statOps.stat(path));
+            return true;
+        }
+        catch (_) {
+            return false;
+        }
     }
     async resolveFile(basePath, options) {
         await this.ensureInitialized();
-        return this.statOps.resolveFile(basePath, options);
+        return this.withBranchSnapshotRecovery(basePath, () => this.statOps.resolveFile(basePath, options), {
+            isRecoverableMissResult: (resolvedPath) => resolvedPath === null,
+            requirePendingSourceInvalidation: true,
+        });
     }
     dispose() {
         this.wsManager.dispose();
@@ -453,6 +584,9 @@ export class VeryfrontFSAdapter {
         this.initialized = false;
         this.fileListWarmupPromise = null;
         this.fileListWarmupKey = null;
+        this.branchMissRecoveryPromise = null;
+        this.branchMissRecoveryGeneration++;
+        this.branchMissRecoveryFailures.clear();
         logger.debug("Disposed");
     }
     getCacheStats() {
@@ -576,6 +710,9 @@ export class VeryfrontFSAdapter {
             this.dirOps.clearTree();
             this.fileListWarmupPromise = null;
             this.fileListWarmupKey = null;
+            this.branchMissRecoveryPromise = null;
+            this.branchMissRecoveryGeneration++;
+            this.branchMissRecoveryFailures.clear();
             logger.debug("Cleared index and dirTree due to context change", {
                 oldContext,
                 newContext: context,

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

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.1021";
+export declare const VERSION = "0.1.1023";
 //# 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.1021";
+export const VERSION = "0.1.1023";

package/package.json

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