veryfront 0.1.1062 → 0.1.1063

package/esm/cli/commands/demo/demo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/demo/demo.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqDH,KAAK,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AA6Y9D,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AA+DD,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4G1E"}
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/demo/demo.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqDH,KAAK,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AA6Y9D,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AA+DD,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmH1E"}

package/esm/cli/commands/demo/demo.js

@@ -482,7 +482,8 @@ export async function demoCommand(options = {}) {
         console.log();
         console.log(`  ${dim("1.")} Edit your app in ${brand(`${projectName}/`)}`);
         console.log(`  ${dim("2.")} Run ${brand("veryfront dev")} to start developing`);
-        console.log(`  ${dim("3.")} Run ${brand("veryfront deploy")} to publish changes`);
+        console.log(`  ${dim("3.")} Run ${brand("veryfront push --branch main")} to upload changes`);
+        console.log(`  ${dim("4.")} Run ${brand("veryfront deploy --branch main --env production")} to create a release and deploy`);
         console.log();
         console.log(`  ${dim("Learn more at https://veryfront.com/docs")}`);
         console.log();

package/esm/cli/commands/demo/steps.js

@@ -40,12 +40,12 @@ export const DEMO_STEPS = [
     },
     {
         id: "deploy",
-        title: "Deploy to Production",
+        title: "Create a Release and Deploy",
         description: [
-            "Deploy your app to Veryfront's global edge network with a single command.",
-            "No build step required - we handle that for you.",
+            "The demo pushed your source to main when it created the project.",
+            "Now create a release from that source and deploy it to production.",
         ],
-        command: "veryfront deploy",
+        command: "veryfront deploy --branch main --env production",
         hasAction: true,
     },
     {

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

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

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

@@ -18,18 +18,23 @@ export const deployHelp = {
         },
         {
             flag: "-f, --force",
-            description: "Deploy without confirmation",
+            description: "Skip confirmation for compatibility (prefer global --yes)",
         },
         {
             flag: "--dry-run",
             description: "Preview without executing",
         },
+        {
+            flag: "-q, --quiet",
+            description: "Suppress progress and summary output",
+        },
     ],
     examples: [
         "veryfront deploy",
         "veryfront deploy --env staging",
         "veryfront deploy --branch feature-x --env preview",
         "veryfront deploy --release-name v1.2.0",
+        "veryfront deploy --branch main --env production --yes",
         "veryfront deploy --dry-run",
     ],
     notes: [

package/esm/cli/commands/init/init-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/init-command.ts"],"names":[],"mappings":"AAAA;;;iCAGiC;AAWjC,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,YAAY,CAAC;AA6PzE;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8arE"}
+{"version":3,"file":"init-command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/init-command.ts"],"names":[],"mappings":"AAAA;;;iCAGiC;AAWjC,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,YAAY,CAAC;AA6PzE;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA+arE"}

package/esm/cli/commands/init/init-command.js

@@ -463,14 +463,15 @@ export async function initCommand(options) {
         const { writeProjectSlug } = await import("../../shared/config.js");
         const { pushCommand } = await import("../push/index.js");
         const { deployCommand } = await import("../deploy/index.js");
+        const manualDeployHint = `Run ${brand("veryfront push --branch main")}, then ${brand("veryfront deploy --branch main --env production")} to deploy later.`;
         const authResult = await ensureAuthenticated();
         if (!authResult) {
-            log(`\n  Authentication required for --deploy. Run ${brand("veryfront push")} to deploy later.`);
+            log(`\n  Authentication required for --deploy. ${manualDeployHint}`);
         }
         else {
             const token = await readToken();
             if (!token) {
-                log(`\n  Could not read auth token. Run ${brand("veryfront push")} to deploy later.`);
+                log(`\n  Could not read auth token. ${manualDeployHint}`);
             }
             else {
                 const slug = `${projectName ?? "my-app"}-${randomSuffix()}`;
@@ -499,7 +500,7 @@ export async function initCommand(options) {
                 catch (error) {
                     const message = error instanceof Error ? error.message : String(error);
                     log(`\n  Deploy failed: ${message}`);
-                    log(`  Your project was created locally. Run ${brand("veryfront push")} to deploy later.`);
+                    log(`  Your project was created locally. ${manualDeployHint}`);
                 }
             }
         }
@@ -531,7 +532,7 @@ export async function initCommand(options) {
         successContent.push("", `${green("Live:")} https://${deployedSlug}.production.veryfront.com`);
     }
     if (!deployedSlug) {
-        successContent.push("", `${brand("veryfront push")}   ${dim("→ share a preview")}`, `${brand("veryfront deploy")} ${dim("→ go live")}`);
+        successContent.push("", `${brand("veryfront push --branch main")} ${dim("→ upload source")}`, `${brand("veryfront deploy --branch main --env production")} ${dim("→ create a release and go live")}`);
     }
     if (!quiet) {
         console.log("");

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,WA2DtB,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,WAuEtB,CAAC"}

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

@@ -30,11 +30,19 @@ export const pullHelp = {
         },
         {
             flag: "-f, --force",
-            description: "Force overwrite without confirmation",
+            description: "Skip confirmation for compatibility (prefer global --yes)",
         },
         {
             flag: "--dry-run",
-            description: "Show what would be written without writing",
+            description: "Show what would be written or deleted without changing files",
+        },
+        {
+            flag: "--prune",
+            description: "Delete managed local files missing from the selected source",
+        },
+        {
+            flag: "-q, --quiet",
+            description: "Suppress progress and summary output",
         },
     ],
     examples: [
@@ -47,8 +55,10 @@ export const pullHelp = {
         "veryfront pull --release v1.2.0",
         "veryfront pull --projects project-a,project-b,project-c",
         "veryfront pull --projects my-app --dir ./apps",
+        "veryfront pull --branch studio-change --prune --dry-run",
+        "veryfront pull --branch studio-change --prune --yes",
         "veryfront pull --dry-run",
-        "veryfront pull --force",
+        "veryfront pull --yes",
     ],
     notes: [
         "Requires VERYFRONT_API_TOKEN env var or veryfront.json config",
@@ -56,5 +66,7 @@ export const pullHelp = {
         "With --projects, each project is pulled into a subdirectory named after the slug",
         'Projects list can also be specified in veryfront.json: { "projects": ["slug1", "slug2"] }',
         "Priority order: --env > --release > --branch > main",
+        "--prune requires a clean Git worktree; --prune --dry-run can preview anywhere",
+        "--prune never removes ignored or unsupported files",
     ],
 };

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

@@ -20,6 +20,7 @@ export declare const getPullArgsSchema: () => import("../../../src/internal-agen
     release: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
     force: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     dryRun: import("../../../src/internal-agents/schema.js").Schema<boolean>;
+    prune: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     quiet: import("../../../src/internal-agents/schema.js").Schema<boolean>;
 }>>;
 export declare const PullArgsSchema: import("../../../src/internal-agents/schema.js").Schema<import("../../../src/extensions/schema/schema-validator.js").InferShape<{
@@ -31,6 +32,7 @@ export declare const PullArgsSchema: import("../../../src/internal-agents/schema
     release: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
     force: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     dryRun: import("../../../src/internal-agents/schema.js").Schema<boolean>;
+    prune: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     quiet: import("../../../src/internal-agents/schema.js").Schema<boolean>;
 }>>;
 export type PullArgs = InferSchema<ReturnType<typeof getPullArgsSchema>>;
@@ -46,6 +48,7 @@ export declare const parsePullArgs: (args: import("../../shared/types.js").Parse
     release: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
     force: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     dryRun: import("../../../src/internal-agents/schema.js").Schema<boolean>;
+    prune: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     quiet: import("../../../src/internal-agents/schema.js").Schema<boolean>;
 }>>;
 /**
@@ -79,10 +82,12 @@ export interface PullOptions {
     env?: string;
     /** Release version to pull from (e.g., "v1.2.0") */
     release?: string;
-    /** Force overwrite without confirmation */
+    /** Skip confirmation without changing overwrite semantics */
     force?: boolean;
     /** Dry run - show what would be written without writing */
     dryRun?: boolean;
+    /** Delete managed local files that are absent from the selected source */
+    prune?: boolean;
     /** Quiet mode - suppress spinner/progress output */
     quiet?: boolean;
 }
@@ -98,6 +103,8 @@ interface ProjectFile {
     created_at: string;
     updated_at: string;
 }
+/** Validate a remote file path as a canonical relative POSIX path. */
+export declare function validateRemoteFilePath(filePath: string): string;
 /**
  * Build the files list URL based on pull source
  */

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;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"}
+{"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;AAiBhC;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;GAa7B,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;;;;;;;;;;;GAWxB,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,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,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;AAkCD,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmB/D;AA+CD;;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,CAKjB;AAkdD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoKpE"}

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

@@ -7,11 +7,11 @@
  * @module cli/commands/pull
  */
 import { defineSchema, lazySchema } from "../../../src/schemas/index.js";
-import { dirname, join, normalize, resolve } from "../../../src/platform/compat/path/index.js";
+import { dirname, isAbsolute, join, relative, resolve } from "../../../src/platform/compat/path/index.js";
+import { isNotFoundError, lstat } from "../../../src/fs/index.js";
 import { cliLogger } from "../../utils/index.js";
 import { resolveCliApiUrl } from "../../shared/constants.js";
-import { cwd } from "../../../src/platform/index.js";
-import { createFileSystem } from "../../../src/platform/index.js";
+import { createFileSystem, cwd, env, runCommand } from "../../../src/platform/index.js";
 import { createApiClient, readConfigFile, resolveConfigWithAuth, } from "../../shared/config.js";
 import { confirmPrompt, isTTY, logInfo, logSuccess, logWarning } from "../../utils/index.js";
 import { createNoopSpinner, createSpinner } from "../../ui/index.js";
@@ -20,6 +20,7 @@ import { getApiTokenEnv, getEnvironmentConfig } from "../../../src/config/index.
 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";
+import { createIgnoreChecker, loadIgnorePatterns } from "../../sync/ignore.js";
 /**
  * Schema factory for pull command arguments
  */
@@ -32,6 +33,7 @@ export const getPullArgsSchema = defineSchema((v) => v.object({
     release: v.string().optional(),
     force: v.boolean().default(false),
     dryRun: v.boolean().default(false),
+    prune: v.boolean().default(false),
     quiet: v.boolean().default(false),
 }));
 export const PullArgsSchema = lazySchema(getPullArgsSchema);
@@ -47,6 +49,7 @@ export const parsePullArgs = createArgParser(PullArgsSchema, {
     release: CommonArgs.release,
     force: CommonArgs.force,
     dryRun: CommonArgs.dryRun,
+    prune: { keys: ["prune"], type: "boolean" },
     quiet: CommonArgs.quiet,
 });
 /**
@@ -62,26 +65,59 @@ export function resolvePullSource(options) {
         return { type: "branch", name: options.branch };
     return { type: "main" };
 }
-/**
- * Validate and sanitize file path to prevent path traversal attacks.
- * Ensures the resolved path is within the project directory.
- *
- * @param filePath - The file path from API to validate
- * @param projectDir - The project directory base path
- * @returns Sanitized absolute path
- * @throws Error if path attempts to escape project directory
- */
-function validateFilePath(filePath, projectDir) {
-    const normalizedPath = normalize(filePath);
-    if (normalizedPath.startsWith("/") || normalizedPath.startsWith("..")) {
-        throw new Error(`Invalid file path: "${filePath}" - paths must be relative and cannot escape project directory`);
+/** Validate a remote file path as a canonical relative POSIX path. */
+export function validateRemoteFilePath(filePath) {
+    if (filePath.length === 0 ||
+        filePath.includes("\\") ||
+        filePath.includes("\0") ||
+        isAbsolute(filePath)) {
+        throw new Error(`Invalid file path: "${filePath}" - expected a relative POSIX path`);
     }
-    const fullPath = resolve(projectDir, normalizedPath);
+    const segments = filePath.split("/");
+    if (segments.some((segment) => segment === "" || segment === "." || segment === "..")) {
+        throw new Error(`Invalid file path: "${filePath}" - path must be canonical`);
+    }
+    if (segments.some((segment) => [".git", ".veryfront"].includes(segment.toLowerCase()))) {
+        throw new Error(`Invalid file path: "${filePath}" - reserved local metadata path`);
+    }
+    return filePath;
+}
+/** Resolve a validated remote path and reject local symlink traversal. */
+async function validateFilePath(filePath, projectDir) {
+    const canonicalPath = validateRemoteFilePath(filePath);
     const resolvedProjectDir = resolve(projectDir);
-    if (!fullPath.startsWith(resolvedProjectDir + "/") && fullPath !== resolvedProjectDir) {
+    const fullPath = resolve(resolvedProjectDir, canonicalPath);
+    const destinationRelativePath = relative(resolvedProjectDir, fullPath).replace(/\\/g, "/");
+    if (destinationRelativePath === ".." ||
+        destinationRelativePath.startsWith("../") ||
+        isAbsolute(destinationRelativePath)) {
         throw new Error(`Invalid file path: "${filePath}" - resolved path escapes project directory`);
     }
-    return fullPath;
+    const segments = canonicalPath.split("/");
+    let currentPath = resolvedProjectDir;
+    for (const [index, segment] of segments.entries()) {
+        currentPath = join(currentPath, segment);
+        let info;
+        try {
+            info = await lstat(currentPath);
+        }
+        catch (error) {
+            if (isNotFoundError(error))
+                break;
+            throw error;
+        }
+        if (info.isSymlink) {
+            throw new Error(`Invalid file path: "${filePath}" - symbolic links are not allowed in pull destinations`);
+        }
+        const isFinal = index === segments.length - 1;
+        if (!isFinal && !info.isDirectory) {
+            throw new Error(`Invalid file path: "${filePath}" - a parent path is not a directory`);
+        }
+        if (isFinal && info.isDirectory) {
+            throw new Error(`Invalid file path: "${filePath}" - destination is a directory`);
+        }
+    }
+    return { path: fullPath, relativePath: canonicalPath };
 }
 /**
  * Build the files list URL based on pull source
@@ -143,19 +179,23 @@ export function buildFileContentUrl(projectSlug, path, source) {
 export async function getFileContent(client, projectSlug, path, source) {
     const url = buildFileContentUrl(projectSlug, path, source);
     const response = await client.get(url);
-    // Ensure text files end with a trailing newline (POSIX standard)
-    const content = response.content;
-    if (content && !content.endsWith("\n"))
-        return content + "\n";
-    return content;
+    return response.content;
 }
 /** Concurrency limit for parallel file fetches */
 const CONCURRENCY = 20;
-async function processFile(op, client, projectSlug, source, fs) {
+async function fetchFile(op, client, projectSlug, source) {
     try {
         const content = await getFileContent(client, projectSlug, op.relativePath, source);
+        return { success: true, op: { ...op, content } };
+    }
+    catch (error) {
+        return { success: false, path: op.relativePath, error: error };
+    }
+}
+async function writePreparedFile(op, fs) {
+    try {
         await fs.mkdir(dirname(op.path), { recursive: true });
-        await fs.writeTextFile(op.path, content);
+        await fs.writeTextFile(op.path, op.content);
         return { success: true, path: op.relativePath };
     }
     catch (error) {
@@ -166,24 +206,176 @@ async function writeFiles(ops, client, projectSlug, source, dryRun) {
     if (dryRun) {
         for (const op of ops)
             cliLogger.info(`  Would write: ${op.relativePath}`);
-        return { written: ops.length, skipped: 0 };
+        return { written: ops.length, failed: 0 };
     }
     const fs = createFileSystem();
-    let written = 0;
-    let skipped = 0;
+    const prepared = [];
+    let failed = 0;
     for (let i = 0; i < ops.length; i += CONCURRENCY) {
         const batch = ops.slice(i, i + CONCURRENCY);
-        const results = await Promise.all(batch.map((op) => processFile(op, client, projectSlug, source, fs)));
+        const results = await Promise.all(batch.map((op) => fetchFile(op, client, projectSlug, source)));
+        for (const result of results) {
+            if (result.success) {
+                prepared.push(result.op);
+                continue;
+            }
+            cliLogger.error(`Failed to fetch ${result.path}:`, result.error);
+            failed++;
+        }
+    }
+    if (failed > 0)
+        return { written: 0, failed };
+    let written = 0;
+    for (let i = 0; i < prepared.length; i += CONCURRENCY) {
+        const batch = prepared.slice(i, i + CONCURRENCY);
+        const results = await Promise.all(batch.map((op) => writePreparedFile(op, fs)));
         for (const result of results) {
             if (result.success) {
                 written++;
                 continue;
             }
             cliLogger.error(`Failed to write ${result.path}:`, result.error);
-            skipped++;
+            failed++;
+        }
+    }
+    return { written, failed };
+}
+async function listManagedLocalFiles(projectDir, ignoreChecker) {
+    const fs = createFileSystem();
+    if (!(await fs.exists(projectDir)))
+        return [];
+    const files = [];
+    async function walk(currentDir) {
+        const entries = await fs.readDir(currentDir);
+        for await (const entry of entries) {
+            const path = join(currentDir, entry.name);
+            const relativePath = relative(projectDir, path).replace(/\\/g, "/");
+            if (ignoreChecker.isIgnored(relativePath))
+                continue;
+            if (entry.isSymlink) {
+                if (ignoreChecker.isSupportedExtension(entry.name)) {
+                    throw new Error(`Veryfront pull with --prune does not support symbolic links: "${relativePath}". Remove the link and run veryfront pull again.`);
+                }
+                continue;
+            }
+            if (entry.isDirectory) {
+                await walk(path);
+                continue;
+            }
+            if (!ignoreChecker.isSupportedExtension(entry.name))
+                continue;
+            files.push({ path, relativePath });
+        }
+    }
+    await walk(projectDir);
+    return files;
+}
+async function deleteLocalFiles(ops, dryRun) {
+    if (dryRun) {
+        for (const op of ops)
+            cliLogger.info(`  Would delete: ${op.relativePath}`);
+        return { deleted: ops.length, failed: 0 };
+    }
+    const fs = createFileSystem();
+    let deleted = 0;
+    let failed = 0;
+    for (const op of ops) {
+        try {
+            await fs.remove(op.path);
+            deleted++;
+        }
+        catch (error) {
+            cliLogger.error(`Failed to delete ${op.relativePath}:`, error);
+            failed++;
+        }
+    }
+    return { deleted, failed };
+}
+function cleanGitEnvironment() {
+    const gitEnv = env();
+    for (const key of Object.keys(gitEnv)) {
+        if (key.startsWith("GIT_"))
+            delete gitEnv[key];
+    }
+    return gitEnv;
+}
+async function nearestExistingDirectory(path) {
+    let current = resolve(path);
+    while (true) {
+        try {
+            const info = await lstat(current);
+            if (info.isDirectory)
+                return current;
+        }
+        catch (error) {
+            if (!isNotFoundError(error))
+                throw error;
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+async function findGitRoot(projectDir) {
+    const cwd = await nearestExistingDirectory(projectDir);
+    if (!cwd)
+        return null;
+    try {
+        const repository = await runCommand("git", {
+            args: ["rev-parse", "--show-toplevel"],
+            cwd,
+            clearEnv: true,
+            env: cleanGitEnvironment(),
+            capture: true,
+            timeoutMs: 5_000,
+        });
+        const root = repository.stdout?.trim();
+        return repository.success && root ? resolve(root) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function isUntrackedPushReceipt(statusLine) {
+    if (!statusLine.startsWith("?? "))
+        return false;
+    const path = statusLine.slice(3).replace(/\\/g, "/");
+    return path === ".veryfront/push-receipt.json" ||
+        path.endsWith("/.veryfront/push-receipt.json");
+}
+async function assertCleanGitWorktrees(projectDirs) {
+    const gitRoots = new Set();
+    for (const projectDir of projectDirs) {
+        const gitRoot = await findGitRoot(projectDir);
+        if (!gitRoot) {
+            throw INVALID_ARGUMENT.create({
+                detail: `Pull with --prune requires ${projectDir} to be inside a Git worktree. Clone or initialize the repository, or use --dry-run to preview without deleting files.`,
+            });
+        }
+        gitRoots.add(gitRoot);
+    }
+    for (const gitRoot of gitRoots) {
+        const status = await runCommand("git", {
+            args: ["status", "--porcelain=v1", "--untracked-files=all"],
+            cwd: gitRoot,
+            clearEnv: true,
+            env: cleanGitEnvironment(),
+            capture: true,
+            timeoutMs: 5_000,
+        });
+        if (!status.success) {
+            throw INVALID_ARGUMENT.create({
+                detail: "Veryfront could not verify that the Git worktree is clean before pruning files.",
+            });
+        }
+        const dirty = (status.stdout ?? "").split("\n").some((line) => line !== "" && !isUntrackedPushReceipt(line));
+        if (dirty) {
+            throw INVALID_ARGUMENT.create({
+                detail: `Pull with --prune requires a clean Git worktree at ${gitRoot}. Commit or stash local changes, then run the command again.`,
+            });
         }
     }
-    return { written, skipped };
 }
 function formatPullSource(source) {
     switch (source.type) {
@@ -223,16 +415,22 @@ function pullProjectListError(projectSlug, sourceLabel, error) {
     }
     return wrapped;
 }
-async function confirmPullWrite(projectDir) {
+async function confirmPullWrite(projectDir, writeCount, deleteCount) {
     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.`,
+                `Re-run with --yes to write into ${projectDir} without prompting.`,
         });
     }
-    return await confirmPrompt(`This will overwrite local files in ${projectDir}. Continue?`, false);
+    const actions = [];
+    if (writeCount > 0)
+        actions.push(`overwrite ${writeCount} local files`);
+    if (deleteCount > 0)
+        actions.push(`delete ${deleteCount} managed local files`);
+    const action = actions.join(" and ");
+    return await confirmPrompt(`This will ${action} in ${projectDir}. Continue?`, false);
 }
-async function pullSingleProject(projectSlug, projectDir, source, force, dryRun, config, quiet = false) {
+async function pullSingleProject(projectSlug, projectDir, source, force, dryRun, prune, config, quiet = false) {
     const sourceLabel = formatPullSource(source);
     let spinner = quiet
         ? createNoopSpinner()
@@ -248,45 +446,75 @@ async function pullSingleProject(projectSlug, projectDir, source, force, dryRun,
     finally {
         spinner.stop();
     }
-    if (files.length === 0) {
-        if (!quiet)
-            logInfo(`No files to pull from ${projectSlug}.`);
-        return { written: 0, skipped: 0, cancelled: false };
-    }
+    const pruneIgnoreChecker = prune
+        ? createIgnoreChecker(await loadIgnorePatterns(projectDir))
+        : null;
     const writeOps = [];
+    const remotePaths = new Set();
     for (const file of files) {
         try {
-            writeOps.push({ path: validateFilePath(file.path, projectDir), relativePath: file.path });
+            const op = await validateFilePath(file.path, projectDir);
+            if (remotePaths.has(op.relativePath)) {
+                throw new Error(`Duplicate remote file path: "${op.relativePath}"`);
+            }
+            remotePaths.add(op.relativePath);
+            if (pruneIgnoreChecker &&
+                (pruneIgnoreChecker.isIgnored(op.relativePath) ||
+                    !pruneIgnoreChecker.isSupportedExtension(op.relativePath))) {
+                continue;
+            }
+            writeOps.push(op);
         }
         catch (error) {
-            if (!quiet)
-                cliLogger.warn(`Skipping invalid file path: ${file.path}`, error);
+            throw INVALID_ARGUMENT.create({
+                detail: `Veryfront returned an invalid file path "${file.path}": ${describeError(error)}. No local files were changed.`,
+                cause: error,
+            });
         }
     }
+    let deleteOps = [];
+    if (pruneIgnoreChecker) {
+        const managedRemotePaths = new Set(writeOps.map((op) => op.relativePath));
+        const localFiles = await listManagedLocalFiles(projectDir, pruneIgnoreChecker);
+        deleteOps = localFiles.filter((file) => !managedRemotePaths.has(file.relativePath));
+    }
+    if (writeOps.length === 0 && deleteOps.length === 0) {
+        if (!quiet)
+            logInfo(`No files to pull from ${projectSlug}.`);
+        return { written: 0, deleted: 0, cancelled: false };
+    }
     if (!quiet) {
-        cliLogger.info(`\nFound ${files.length} files to ${dryRun ? "pull" : "write"} from ${projectSlug}.`);
+        const deleteSummary = deleteOps.length > 0 ? ` and ${deleteOps.length} to delete` : "";
+        cliLogger.info(`\nFound ${writeOps.length} files to ${dryRun ? "pull" : "write"}${deleteSummary} from ${projectSlug}.`);
     }
     if (!force && !dryRun) {
-        const confirmed = await confirmPullWrite(projectDir);
+        const confirmed = await confirmPullWrite(projectDir, writeOps.length, deleteOps.length);
         if (!confirmed) {
             cliLogger.info("Pull cancelled.");
-            return { written: 0, skipped: 0, cancelled: true };
+            return { written: 0, deleted: 0, cancelled: true };
         }
     }
     spinner = quiet ? createNoopSpinner() : createSpinner(`Writing files to ${projectDir}...`);
-    const result = await writeFiles(writeOps, client, projectSlug, source, dryRun);
+    const writeResult = await writeFiles(writeOps, client, projectSlug, source, dryRun);
+    if (writeResult.failed > 0) {
+        spinner.stop();
+        throw new Error(`Failed to pull ${writeResult.failed} file${writeResult.failed === 1 ? "" : "s"}. No local files were pruned. Review git status and restore a clean worktree before retrying if any files were written.`);
+    }
+    const deleteResult = await deleteLocalFiles(deleteOps, dryRun);
     spinner.stop();
+    if (deleteResult.failed > 0) {
+        throw new Error(`Failed to prune ${deleteResult.failed} local file${deleteResult.failed === 1 ? "" : "s"}. Some files may have changed. Review git status and restore a clean worktree before retrying.`);
+    }
     if (!quiet) {
         if (dryRun) {
-            logInfo(`Dry run complete for ${projectSlug}. Would write ${result.written} files.`);
+            logInfo(`Dry run complete for ${projectSlug}. Would write ${writeResult.written} and delete ${deleteResult.deleted} files.`);
         }
         else {
-            logSuccess(`Pulled ${result.written} files from ${projectSlug} (${sourceLabel}).`);
-            if (result.skipped > 0)
-                logWarning(`Skipped ${result.skipped} files due to errors.`);
+            const deletion = deleteResult.deleted > 0 ? ` and deleted ${deleteResult.deleted}` : "";
+            logSuccess(`Pulled ${writeResult.written} files${deletion} from ${projectSlug} (${sourceLabel}).`);
         }
     }
-    return { ...result, cancelled: false };
+    return { written: writeResult.written, deleted: deleteResult.deleted, cancelled: false };
 }
 function formatProjectCount(count) {
     return `${count} project${count === 1 ? "" : "s"}`;
@@ -318,7 +546,7 @@ function structuredFailureAggregate(failedProjects, detail) {
 export function pullCommand(options = {}) {
     const source = resolvePullSource(options);
     return withSpan("cli.command.pull", async () => {
-        const { projectSlug: slugOverride, projects: projectsOverride, projectDir = cwd(), force = false, dryRun = false, quiet = false, } = options;
+        const { projectSlug: slugOverride, projects: projectsOverride, projectDir = cwd(), force = false, dryRun = false, prune = false, quiet = false, } = options;
         const spinner = quiet ? createNoopSpinner() : createSpinner("Resolving configuration...");
         const configFile = await readConfigFile(projectDir);
         const projects = projectsOverride ?? configFile?.projects;
@@ -344,13 +572,26 @@ export function pullCommand(options = {}) {
                 projectSlug: "",
             };
         }
+        if (prune && !dryRun) {
+            spinner.update("Checking Git worktree...");
+            const targetDirs = projects?.length
+                ? projects.map((project) => join(projectDir, project))
+                : [projectDir];
+            try {
+                await assertCleanGitWorktrees(targetDirs);
+            }
+            catch (error) {
+                spinner.stop();
+                throw error;
+            }
+        }
         spinner.stop();
         if (!projects?.length) {
-            await pullSingleProject(config.projectSlug, projectDir, source, force, dryRun, config, quiet);
+            await pullSingleProject(config.projectSlug, projectDir, source, force, dryRun, prune, config, quiet);
             return;
         }
         let totalWritten = 0;
-        let totalSkippedFiles = 0;
+        let totalDeleted = 0;
         const failedProjects = [];
         const cancelledProjects = [];
         for (const project of projects) {
@@ -358,9 +599,9 @@ export function pullCommand(options = {}) {
             if (!quiet)
                 cliLogger.info(`\n--- Pulling ${project} into ${targetDir} ---`);
             try {
-                const result = await pullSingleProject(project, targetDir, source, force, dryRun, config, quiet);
+                const result = await pullSingleProject(project, targetDir, source, force, dryRun, prune, config, quiet);
                 totalWritten += result.written;
-                totalSkippedFiles += result.skipped;
+                totalDeleted += result.deleted;
                 if (result.cancelled)
                     cancelledProjects.push(project);
             }
@@ -378,10 +619,14 @@ export function pullCommand(options = {}) {
         if (!quiet) {
             cliLogger.info("");
             if (dryRun) {
-                logInfo(`Dry run complete. Would write ${totalWritten} files total across ${projects.length} projects.`);
+                logInfo(`Dry run complete. Would write ${totalWritten} and delete ${totalDeleted} files total across ${projects.length} projects.`);
             }
             else if (totalWritten > 0) {
-                logSuccess(`Pulled ${totalWritten} files total across ${projects.length} projects.`);
+                const deletion = totalDeleted > 0 ? ` and deleted ${totalDeleted}` : "";
+                logSuccess(`Pulled ${totalWritten} files${deletion} total across ${projects.length} projects.`);
+            }
+            else if (totalDeleted > 0) {
+                logSuccess(`Deleted ${totalDeleted} files across ${projects.length} projects.`);
             }
             else {
                 logInfo(`No files were pulled across ${projects.length} projects.`);
@@ -392,9 +637,6 @@ export function pullCommand(options = {}) {
             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);
@@ -406,5 +648,9 @@ export function pullCommand(options = {}) {
                 throw structuredError;
             throw new Error(detail);
         }
-    }, { "cli.dryRun": options.dryRun ?? false, "cli.source_type": source.type });
+    }, {
+        "cli.dryRun": options.dryRun ?? false,
+        "cli.prune": options.prune ?? 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,WAyCtB,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,WA+CtB,CAAC"}

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

@@ -1,7 +1,7 @@
 export const pushHelp = {
     name: "push",
     category: "deploy",
-    description: "Create a branch and upload local files to Veryfront",
+    description: "Upload local source files to a Veryfront branch",
     usage: "veryfront push [options]",
     options: [
         {
@@ -18,12 +18,16 @@ export const pushHelp = {
         },
         {
             flag: "-f, --force",
-            description: "Push without confirmation",
+            description: "Skip confirmation for compatibility (prefer global --yes)",
         },
         {
             flag: "--dry-run",
             description: "Show what would be uploaded without uploading",
         },
+        {
+            flag: "-q, --quiet",
+            description: "Suppress progress and summary output",
+        },
     ],
     examples: [
         "veryfront push",
@@ -31,12 +35,14 @@ export const pushHelp = {
         "veryfront push --dir ./my-project",
         "veryfront push --branch feature-header",
         "veryfront push --branch main             # Push directly to main",
+        "veryfront push --branch main --yes       # Non-interactive CI push",
         "veryfront push --dry-run",
     ],
     notes: [
         "Requires VERYFRONT_API_TOKEN env var or veryfront.json config",
-        "Creates a new branch for each push - merge in Studio",
-        "Use --branch=main to push directly without creating a branch",
-        "Uploads all files using their relative paths",
+        "Without --branch, creates a timestamped branch that you can review in Studio",
+        "Use --branch main to update the existing Veryfront main branch",
+        "Uploads supported text source files using their relative paths",
+        ".vfignore controls which supported files are excluded",
     ],
 };

package/esm/cli/commands/push/command.d.ts

@@ -1,8 +1,8 @@
 /**
- * Push command - Upload local project files to a new Veryfront branch
+ * Push command - Upload local project files to a Veryfront branch
  *
  * Scans local files and uploads them to the API using relative paths.
- * Creates a new branch for the changes which can be merged in Studio.
+ * Creates a branch when the requested branch does not already exist.
  *
  * @module cli/commands/push
  */
@@ -52,7 +52,7 @@ export interface PushOptions {
     projectDir?: string;
     /** Branch name to create (auto-generated if not provided) */
     branch?: string;
-    /** Force push without confirmation */
+    /** Skip confirmation without changing push semantics */
     force?: boolean;
     /** Dry run - show what would be uploaded without uploading */
     dryRun?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/push/command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/push/command.ts"],"names":[],"mappings":"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"}

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

@@ -1,8 +1,8 @@
 /**
- * Push command - Upload local project files to a new Veryfront branch
+ * Push command - Upload local project files to a Veryfront branch
  *
  * Scans local files and uploads them to the API using relative paths.
- * Creates a new branch for the changes which can be merged in Studio.
+ * Creates a branch when the requested branch does not already exist.
  *
  * @module cli/commands/push
  */
@@ -19,6 +19,7 @@ import { withSpan } from "../../../src/observability/tracing/otlp-setup.js";
 import { createIgnoreChecker, loadIgnorePatterns } from "../../sync/ignore.js";
 import { listAllFiles } from "../pull/index.js";
 import { CommonArgs, createArgParser } from "../../shared/args.js";
+import { isNotFoundError, lstat } from "../../../src/fs/index.js";
 import { areSourceFilesTracked, clearPushReceipt, computeSourceDigest, getProjectTarget, normalizeControlPlane, resolveGitSource, writePushReceipt, } from "../../shared/deployment-provenance.js";
 /**
  * Schema factory for push command arguments
@@ -107,12 +108,29 @@ function projectSlugConflictError(error, source) {
     }
     return new Error(`${error.message} ${action}, then run veryfront push again.`);
 }
+async function sourceFilesForGitTracking(projectDir, files) {
+    const ignorePath = join(projectDir, ".vfignore");
+    let ignoreInfo;
+    try {
+        ignoreInfo = await lstat(ignorePath);
+    }
+    catch (error) {
+        if (isNotFoundError(error))
+            return files;
+        throw error;
+    }
+    if (ignoreInfo.isSymlink || !ignoreInfo.isFile) {
+        throw new Error(".vfignore must be a regular file inside the project and cannot be a symbolic link.");
+    }
+    return [...files, { path: ".vfignore", content: "" }];
+}
 export async function capturePushSourceSnapshot(projectDir, ignoreChecker) {
     const gitSourceBefore = await resolveGitSource(projectDir);
     const files = await scanLocalFiles(projectDir, ignoreChecker);
+    const trackedSourceFiles = await sourceFilesForGitTracking(projectDir, files);
     const [sourceDigest, filesTracked] = await Promise.all([
         computeSourceDigest(files),
-        areSourceFilesTracked(projectDir, files),
+        areSourceFilesTracked(projectDir, trackedSourceFiles),
     ]);
     const gitSource = await resolveGitSource(projectDir);
     if (!gitSourcesMatch(gitSourceBefore, gitSource))
@@ -409,14 +427,17 @@ export function pushCommand(options = {}) {
             spinner.update("Uploading files...");
             uploadResult = await uploadFiles(client, config.projectSlug, branchId, ops, false);
         }
+        if (uploadResult.failed > 0) {
+            spinner.stop();
+            throw new Error(`Push failed for ${uploadResult.failed} file${uploadResult.failed === 1 ? "" : "s"}. Remote files were not deleted.`);
+        }
         if (toDelete.length > 0) {
             spinner.update("Deleting removed files...");
             deleteResult = await deleteFiles(client, config.projectSlug, branchId, toDelete, false);
         }
-        const failedTotal = uploadResult.failed + deleteResult.failed;
-        if (failedTotal > 0) {
+        if (deleteResult.failed > 0) {
             spinner.stop();
-            throw new Error(`Push failed for ${failedTotal} file${failedTotal === 1 ? "" : "s"}`);
+            throw new Error(`Push failed for ${deleteResult.failed} file${deleteResult.failed === 1 ? "" : "s"} during deletion`);
         }
         spinner.update("Verifying push target...");
         try {

package/esm/cli/help/tips.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tips.d.ts","sourceRoot":"","sources":["../../../src/cli/help/tips.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAKrC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CASzC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAI3D;AAQD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE"}
+{"version":3,"file":"tips.d.ts","sourceRoot":"","sources":["../../../src/cli/help/tips.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAKrC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CASzC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CASzC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAI3D;AAQD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE"}

package/esm/cli/help/tips.js

@@ -24,8 +24,9 @@ export function getInitTemplates() {
 }
 export function getPostBuildTips() {
     return `\n  ${dim("Next steps:")}\n` +
-        `    ${dim("•")} ${cyan("veryfront serve")}     Preview locally\n` +
-        `    ${dim("•")} ${cyan("veryfront deploy")}    Deploy to production\n`;
+        `    ${dim("•")} ${cyan("veryfront serve")}                                  Preview locally\n` +
+        `    ${dim("•")} ${cyan("veryfront push --branch main")}                     Upload source\n` +
+        `    ${dim("•")} ${cyan("veryfront deploy --branch main --env production")} Create a release and deploy\n`;
 }
 export function getPostDeployTips() {
     return `\n  ${dim("Next steps:")}\n` +

package/esm/cli/skills/core-skills.js

@@ -73,30 +73,30 @@ Create a Veryfront app with AI capabilities.
     {
         metadata: {
             name: "deploy-safely",
-            description: "Build, test, deploy, and verify with rollback on failure",
+            description: "Build, test, push, deploy, and verify with rollback through Git on failure",
             metadata: { version: "1.0.0" },
         },
         skillMd: `# Deploy Safely
 
-Build, test, deploy, and verify with rollback on failure.
+Build and test the reviewed Git source, then push it to Veryfront before creating a release and deployment. If verification fails, revert the Git commit and run the normal delivery sequence again.
 
 ## Steps
 
-1. \`veryfront build --json\`, abort if success: false
+1. \`veryfront build --json\`, abort if success is false
 2. \`veryfront test --json\`, abort if any test fails
-3. \`veryfront push --branch <branch> --force\`, abort if any upload fails
+3. \`veryfront push --branch <branch> --yes\`, abort if any upload fails
 4. \`veryfront deploy --env <environment> --branch <branch> --yes --json\`
 5. Record the project, environment, release, deployment, and commit IDs
 6. Use vf_get_errors to verify no runtime errors after deploy
-7. If errors: redeploy previous version
+7. If errors: run \`git revert <bad-commit>\` and \`git push origin <branch>\`, then let CI run steps 3 and 4 or repeat them manually
 
 ## Error Recovery
 
 - **Build fails**: Check vf_get_errors, fix and retry
-- **Tests fail**: Read JSON output, fix failing tests
-- **Push fails**: Fix failed uploads before retrying deploy
+- **Tests fail**: Read the JSON output, fix failing tests
+- **Push fails**: Fix the upload failure and rerun Push before Deploy
 - **Deploy fails**: Check environment, auth, branch
-- **Post-deploy errors**: Redeploy previous release`,
+- **Post-deploy errors**: Revert the failing Git commit, push the revert, then run the normal Push and Deploy sequence`,
         directory: "core:deploy-safely",
     },
     {

package/esm/cli/sync/ignore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../../../src/cli/sync/ignore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyDH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzC,6CAA6C;IAC7C,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACjD;AAOD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoB/E;AAmED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CAyB9E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,aAAa,CAE1D"}
+{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../../../src/cli/sync/ignore.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0DH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzC,6CAA6C;IAC7C,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACjD;AAOD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsC/E;AAmED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CAyB9E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,aAAa,CAE1D"}

package/esm/cli/sync/ignore.js

@@ -4,6 +4,7 @@
 import { join } from "../../src/platform/compat/path/index.js";
 import { createFileSystem } from "../../src/platform/index.js";
 import { cliLogger } from "../utils/index.js";
+import { isNotFoundError, lstat } from "../../src/fs/index.js";
 /** Default patterns always ignored */
 const DEFAULT_IGNORE_PATTERNS = [
     // Directories
@@ -59,9 +60,22 @@ export async function loadIgnorePatterns(projectPath) {
     const fs = createFileSystem();
     const ignorePath = join(projectPath, ".vfignore");
     const patterns = [...DEFAULT_IGNORE_PATTERNS];
+    let ignoreInfo;
     try {
-        if (!(await fs.exists(ignorePath)))
+        ignoreInfo = await lstat(ignorePath);
+    }
+    catch (error) {
+        if (isNotFoundError(error))
             return patterns;
+        cliLogger.debug("Failed to read .vfignore:", error);
+        throw new Error("Failed to read .vfignore. Fix the file permissions or path and try again.", {
+            cause: error,
+        });
+    }
+    if (ignoreInfo.isSymlink || !ignoreInfo.isFile) {
+        throw new Error(".vfignore must be a regular file inside the project and cannot be a symbolic link.");
+    }
+    try {
         const content = await fs.readTextFile(ignorePath);
         const customPatterns = content
             .split("\n")
@@ -71,6 +85,9 @@ export async function loadIgnorePatterns(projectPath) {
     }
     catch (error) {
         cliLogger.debug("Failed to read .vfignore:", error);
+        throw new Error("Failed to read .vfignore. Fix the file permissions or path and try again.", {
+            cause: error,
+        });
     }
     return patterns;
 }

package/esm/cli/utils/env-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-prompt.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/env-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAOD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAiF1B;AAkCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BzE"}
+{"version":3,"file":"env-prompt.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/env-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAOD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAiF1B;AAkCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CA0CzE"}

package/esm/cli/utils/env-prompt.js

@@ -115,13 +115,15 @@ async function promptForSingleEnvVar(envVar) {
  * Generates content for .gitignore to ensure .env is not committed
  */
 export function generateGitignoreContent(existingContent) {
-    const requiredEntries = ["# Environment files", ".env", ".env.local", ".env.*.local", ""];
+    const environmentEntries = [".env", ".env.local", ".env.*.local"];
     if (!existingContent) {
         return [
             "# Dependencies",
             "node_modules/",
             "",
-            ...requiredEntries,
+            "# Environment files",
+            ...environmentEntries,
+            "",
             "# Build output",
             "dist/",
             ".veryfront/",
@@ -135,7 +137,18 @@ export function generateGitignoreContent(existingContent) {
             "",
         ].join("\n");
     }
-    if (existingContent.includes(".env"))
+    const existingEntries = new Set(existingContent.split(/\r?\n/).map((line) => line.trim()).filter(Boolean));
+    const additions = [];
+    const missingEnvironmentEntries = environmentEntries.filter((entry) => !existingEntries.has(entry));
+    if (missingEnvironmentEntries.length > 0) {
+        additions.push("# Environment files", ...missingEnvironmentEntries);
+    }
+    if (!existingEntries.has(".veryfront/") && !existingEntries.has(".veryfront")) {
+        if (additions.length > 0)
+            additions.push("");
+        additions.push("# Veryfront local state", ".veryfront/");
+    }
+    if (additions.length === 0)
         return existingContent;
-    return `${existingContent.trimEnd()}\n\n${requiredEntries.join("\n")}`;
+    return `${existingContent.trimEnd()}\n\n${additions.join("\n")}\n`;
 }

package/esm/deno.js

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

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

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

package/package.json

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