veryfront 0.1.1237 → 0.1.1239

package/esm/cli/commands/build/error-handler.js

@@ -1,14 +1,52 @@
 import { brand, dim } from "../../ui/index.js";
 import { cliLogger, isVerbose, logError } from "../../utils/index.js";
+import { sanitizeTerminalDiagnosticText } from "../../../src/errors/index.js";
 import { exit, getStdout } from "../../../src/platform/index.js";
+const STACK_FRAME_WITH_PARENS = /^(\s*at\s+.*\()(file:\/\/\/[^)\r\n]+|\/[^)\r\n]+|[A-Za-z]:[\\/][^)\r\n]+)(:\d+:\d+\).*)$/;
+const STACK_FRAME_DIRECT = /^(\s*at\s+(?:async\s+)?)(file:\/\/\/[^\r\n]+|\/[^\r\n]+|[A-Za-z]:[\\/][^\r\n]+)(:\d+:\d+.*)$/;
+function sanitizeStackFrame(line) {
+    const sanitized = sanitizeTerminalDiagnosticText(line);
+    const match = STACK_FRAME_WITH_PARENS.exec(sanitized) ??
+        STACK_FRAME_DIRECT.exec(sanitized);
+    if (!match)
+        return sanitized;
+    const sourceName = match[2]
+        .replace(/^file:\/\/\//, "")
+        .replaceAll("\\", "/")
+        .split("/")
+        .at(-1) || "source";
+    return `${match[1]}<REDACTED>/${sourceName}${match[3]}`;
+}
+function deepestErrorCause(error) {
+    const seen = new Set();
+    let current = error;
+    for (let depth = 0; depth < 8; depth++) {
+        if (seen.has(current))
+            break;
+        seen.add(current);
+        const cause = Object.getOwnPropertyDescriptor(current, "cause");
+        if (!cause || !("value" in cause) || !(cause.value instanceof Error))
+            break;
+        current = cause.value;
+    }
+    return current;
+}
 export function handleBuildError(error) {
     getStdout()?.write?.(`\r${" ".repeat(80)}\r`);
     const message = error instanceof Error ? error.message : String(error);
     console.log();
     logError(message);
-    if (isVerbose() && error instanceof Error && error.stack) {
-        cliLogger.error(`\n${dim("Stack trace:")}`);
-        cliLogger.error(dim(error.stack.split("\n").slice(1, 5).join("\n")));
+    const diagnosticError = error instanceof Error ? deepestErrorCause(error) : undefined;
+    if (isVerbose() && diagnosticError?.stack) {
+        const isUnderlyingCause = diagnosticError !== error;
+        cliLogger.error(`\n${dim(isUnderlyingCause ? "Underlying stack trace:" : "Stack trace:")}`);
+        const firstLine = isUnderlyingCause ? 0 : 1;
+        const stack = diagnosticError.stack.split("\n").slice(firstLine, 5)
+            .map(sanitizeStackFrame).join("\n");
+        cliLogger.error(dim(stack));
+    }
+    else if (diagnosticError && diagnosticError !== error) {
+        cliLogger.error(`  Run ${brand("veryfront build --verbose")} to show the underlying stack trace.`);
     }
     cliLogger.error(`  Run ${brand("veryfront build --help")} for usage.`);
     cliLogger.error("");

package/esm/cli/commands/build/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/build/handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAQ3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;GAe9B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;GAAiC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;GAazB,CAAC;AAEH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BxE"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/build/handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAQ3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;GAe9B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;GAAiC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;GAaA,CAAC;AAE5B,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BxE"}

package/esm/cli/commands/build/handler.js

@@ -41,7 +41,7 @@ export const parseBuildArgs = createArgParser(BuildArgsSchema, {
     include: { keys: ["include"], type: "array" },
     exclude: { keys: ["exclude"], type: "array" },
     dryRun: CommonArgs.dryRun,
-});
+}, { rejectUnknown: true });
 export async function handleBuildCommand(args) {
     showHeader();
     const opts = parseArgsOrThrow(parseBuildArgs, "build", args);

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,OAAO,EAAE,KAAK,YAAY,EAA2B,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM1F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAQD,wBAAsB,cAAc,CAClC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CAQvE;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACrB,WAAW,CAEb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBtC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,MAAM,OAAO,CAAC,IAAI,CAAuB,EAChD,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAmB,GAC1D,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6SzE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,OAAO,EAAE,KAAK,YAAY,EAA2B,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM1F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAQD,wBAAsB,cAAc,CAClC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CAQvE;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACrB,WAAW,CAEb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBtC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,MAAM,OAAO,CAAC,IAAI,CAAuB,EAChD,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAmB,GAC1D,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6TzE"}

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

@@ -25,7 +25,7 @@ import { createStagedPushOptions, pushCommand } from "../push/index.js";
 import { createProjectSelector } from "./project-selector.js";
 import { createDevLogController } from "./log-controller.js";
 import { findAvailablePort, isPortAvailable, isPortInUseError } from "./port-fallback.js";
-import { listInferenceOptions } from "./inference-status.js";
+import { advertisesCloudGateway, listInferenceOptions } from "./inference-status.js";
 function authStatus(identity) {
     return isApiKeyIdentity(identity)
         ? "Authenticated with an API key"
@@ -272,6 +272,19 @@ export function devCommand(options) {
         if (inferenceOptions.length > 0) {
             console.log(`  ${dim("Inference")} ${brand(inferenceOptions.join(", "))}`);
         }
+        // The banner reports configured paths, and it must not block Ready on a
+        // network round-trip (see `void authReady` above). But an expired stored
+        // session still has a nonempty token, so the gateway would be advertised
+        // and then fail on first request. The validation is already in flight —
+        // let it correct the record rather than delay the banner.
+        if (advertisesCloudGateway(inferenceOptions)) {
+            void authReady.then(() => {
+                if (identity)
+                    return;
+                console.log(`  ${warning("!")} Veryfront Cloud session is not valid; gateway inference will fail. ` +
+                    `Run ${brand("veryfront login")} to renew it.`);
+            });
+        }
         if (mcpServer && isVerbose()) {
             console.log(`  ${dim("MCP")} ${brand(`http://localhost:${mcpPort}/mcp`)}`);
         }

package/esm/cli/commands/dev/inference-status.d.ts

@@ -7,6 +7,12 @@ export interface InferenceEnvironment {
     googleApiKey?: string;
     mistralApiKey?: string;
 }
+/**
+ * Whether a rendered option list claims the Cloud gateway. Callers use this to
+ * decide if a stored session still needs validating — the gateway is the only
+ * option whose credential the CLI can check itself.
+ */
+export declare function advertisesCloudGateway(options: readonly string[]): boolean;
 /** Return the inference paths the current dev process can use without exposing credentials. */
 export declare function listInferenceOptions(environment: InferenceEnvironment): string[];
 //# sourceMappingURL=inference-status.d.ts.map

package/esm/cli/commands/dev/inference-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inference-status.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/inference-status.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAgBhF"}
+{"version":3,"file":"inference-status.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/inference-status.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAQD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE1E;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAmBhF"}

package/esm/cli/commands/dev/inference-status.js

@@ -1,11 +1,23 @@
+const CLOUD_GATEWAY_LABEL = "Veryfront Cloud AI Gateway";
 function isSet(value) {
     return Boolean(value?.trim());
 }
+/**
+ * Whether a rendered option list claims the Cloud gateway. Callers use this to
+ * decide if a stored session still needs validating — the gateway is the only
+ * option whose credential the CLI can check itself.
+ */
+export function advertisesCloudGateway(options) {
+    return options.includes(CLOUD_GATEWAY_LABEL);
+}
 /** Return the inference paths the current dev process can use without exposing credentials. */
 export function listInferenceOptions(environment) {
     const options = [];
-    if (isSet(environment.apiToken) && isSet(environment.projectSlug)) {
-        options.push("Veryfront Cloud AI Gateway");
+    // The gateway authenticates on the token alone. A freshly scaffolded project
+    // has no linked slug yet and its chat route still answers, so gating this on
+    // `projectSlug` hid the one inference path `veryfront login` sets up.
+    if (isSet(environment.apiToken)) {
+        options.push(CLOUD_GATEWAY_LABEL);
     }
     if (isSet(environment.openaiApiKey)) {
         options.push(isSet(environment.openaiBaseUrl) ? "OpenAI-compatible service" : "OpenAI direct");

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/command.ts"],"names":[],"mappings":"AAsBA,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAkCf"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/command.ts"],"names":[],"mappings":"AA4FA,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAoCf"}

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

@@ -1,8 +1,68 @@
 import { getConfig } from "../../../src/config/index.js";
 import { cliLogger } from "../../utils/index.js";
 import { createError, toError } from "../../../src/errors/index.js";
+import { parseExtensionManifest } from "../../../src/extensions/index.js";
+import { exists, join, readTextFile } from "../../../src/fs/index.js";
 import { generateIntegration } from "./integration-generator.js";
 import { isScaffoldType, scaffoldProjectFile } from "../../scaffold/engine.js";
+const PROJECT_MARKERS = [
+    "veryfront.config.ts",
+    "veryfront.config.js",
+    "veryfront.config.mjs",
+    // Legacy, but still read and merged by the CLI config loader, so a project
+    // identified only by this file is a real project. `veryfront.config.json` is
+    // deliberately absent — the loader does not recognise that name.
+    "veryfront.json",
+];
+// Deno accepts JSONC grammar for `deno.json` as well as `deno.jsonc`, matching
+// `src/extensions/discovery.ts`. Parsing those with strict JSON makes a
+// commented manifest look like no evidence at all and fires a false warning.
+const PROJECT_MANIFESTS = [
+    { name: "package.json", syntax: "json" },
+    { name: "deno.json", syntax: "jsonc" },
+    { name: "deno.jsonc", syntax: "jsonc" },
+];
+/**
+ * `generate` writes into whatever directory it is invoked from, so running it
+ * one level above the project (or in the wrong terminal tab) silently produces
+ * a stray `app/` tree. `dev` already warns in this situation; match it rather
+ * than failing, so scaffolding into a not-yet-configured directory still works.
+ */
+async function looksLikeVeryfrontProject(projectDir) {
+    for (const marker of PROJECT_MARKERS) {
+        if (await exists(join(projectDir, marker)))
+            return true;
+    }
+    for (const manifest of PROJECT_MANIFESTS) {
+        const path = join(projectDir, manifest.name);
+        if (!(await exists(path)))
+            continue;
+        try {
+            const parsed = parseExtensionManifest(await readTextFile(path), manifest.syntax, manifest.name);
+            const specifiers = [
+                ...Object.keys(parsed.dependencies ?? {}),
+                ...Object.keys(parsed.devDependencies ?? {}),
+                ...Object.keys(parsed.imports ?? {}),
+            ];
+            if (specifiers.some((s) => s === "veryfront" || s.startsWith("veryfront/"))) {
+                return true;
+            }
+        }
+        catch {
+            // An unparseable manifest is not evidence either way; keep looking.
+        }
+    }
+    return false;
+}
+async function warnIfOutsideProject(projectDir) {
+    if (await looksLikeVeryfrontProject(projectDir))
+        return;
+    // Deliberately no path: `projectDir` is an absolute machine path, which
+    // AGENTS.md forbids in user-facing output. The directory is where the user
+    // already is, so naming it adds nothing they cannot see.
+    cliLogger.warn(`The current directory does not look like a Veryfront project; scaffolding here anyway. ` +
+        `Run this from your project root, or create one with "npm create veryfront".`);
+}
 async function getPreferredRouter(projectDir) {
     try {
         const { runtime } = await import("../../../src/platform/index.js");
@@ -20,6 +80,7 @@ async function getPreferredRouter(projectDir) {
     return "app-router";
 }
 export async function generateCommand(projectDir, type, name) {
+    await warnIfOutsideProject(projectDir);
     const preferred = await getPreferredRouter(projectDir);
     if (type === "integration") {
         await generateIntegration(projectDir, { name: name || undefined });

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;AAOjC,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,YAAY,CAAC;AAezE,UAAU,uBAAuB;IAC/B,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACzD;AAyFD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,YAAY,GAAE,uBAA4B,GACzC,OAAO,CAAC,IAAI,CAAC,CAoPf"}
+{"version":3,"file":"init-command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/init-command.ts"],"names":[],"mappings":"AAAA;;;iCAGiC;AAOjC,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,YAAY,CAAC;AAezE,UAAU,uBAAuB;IAC/B,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACzD;AAyFD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,YAAY,GAAE,uBAA4B,GACzC,OAAO,CAAC,IAAI,CAAC,CA8Of"}

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

@@ -212,47 +212,39 @@ export async function initCommand(options, dependencies = {}) {
         }
         else {
             const { chdir } = await import("../../../src/platform/index.js");
-            const { ensureAuthenticated, readToken } = await import("../../auth/index.js");
+            const { ensureAuthenticated } = await import("../../auth/index.js");
             const { deployCommand } = await import("../deploy/index.js");
-            const authResult = await ensureAuthenticated();
+            const authResult = await ensureAuthenticated(undefined, createdProjectDir);
             if (!authResult) {
                 if (!quiet)
                     console.log();
                 log(`  Authentication required for --deploy. ${manualDeployHint}`);
             }
             else {
-                const token = await readToken();
-                if (!token) {
-                    if (!quiet)
-                        console.log();
-                    log(`  Could not read auth token. ${manualDeployHint}`);
+                if (!quiet)
+                    console.log();
+                log(`  Deploying project...`);
+                try {
+                    chdir(createdProjectDir);
+                    const deployment = await deployCommand({
+                        projectDir: createdProjectDir,
+                        branch: "main",
+                        env: "production",
+                        force: true,
+                        dryRun: false,
+                        quiet: true,
+                    });
+                    if (!deployment) {
+                        throw new Error("Deploy completed without a verified result.");
+                    }
+                    deployedUrl = deployment.url;
                 }
-                else {
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
                     if (!quiet)
                         console.log();
-                    log(`  Deploying project...`);
-                    try {
-                        chdir(createdProjectDir);
-                        const deployment = await deployCommand({
-                            projectDir: createdProjectDir,
-                            branch: "main",
-                            env: "production",
-                            force: true,
-                            dryRun: false,
-                            quiet: true,
-                        });
-                        if (!deployment) {
-                            throw new Error("Deploy completed without a verified result.");
-                        }
-                        deployedUrl = deployment.url;
-                    }
-                    catch (error) {
-                        const message = error instanceof Error ? error.message : String(error);
-                        if (!quiet)
-                            console.log();
-                        log(`  Deploy failed: ${message}`);
-                        log(`  Your project was created locally. ${manualDeployHint}`);
-                    }
+                    log(`  Deploy failed: ${message}`);
+                    log(`  Your project was created locally. ${manualDeployHint}`);
                 }
             }
         }

package/esm/cli/commands/install/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/install/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAgC,MAAM,YAAY,CAAC;AA+CtF,eAAO,MAAM,QAAQ,EAAE,MAAM,EAAyD,CAAC;AAEvF,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAE1C;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,QAAQ,CAExD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWlE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/install/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAgC,MAAM,YAAY,CAAC;AA+CtF,eAAO,MAAM,QAAQ,EAAE,MAAM,EAAyD,CAAC;AAEvF,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAE1C;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,QAAQ,CAExD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlE"}

package/esm/cli/commands/install/registry.js

@@ -1,4 +1,3 @@
-import manifest from "../../../templates/manifest.js";
 import { AIToolIdSchema, AIToolSchema } from "./types.js";
 const AI_TOOLS_RAW = [
     {
@@ -60,12 +59,10 @@ export function isValidToolId(id) {
 }
 export function getTemplateContent(toolId) {
     const { template } = getToolById(toolId);
-    const entry = manifest.templates;
-    const aiRule = entry[`ai-rules:${template}`];
-    if (!aiRule)
-        throw new Error(`Template not found in manifest: ${template}`);
-    const content = aiRule.files[template];
-    if (!content)
-        throw new Error(`Template file not found in manifest: ${template}`);
-    return Promise.resolve(content);
+    return import("../../../templates/loader.js").then(async ({ loadAiRuleTemplate }) => {
+        const content = await loadAiRuleTemplate(template);
+        if (!content)
+            throw new Error(`Template file not found in manifest: ${template}`);
+        return content;
+    });
 }

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

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

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

@@ -29,7 +29,9 @@ export const loginHelp = {
         "veryfront login --token",
     ],
     notes: [
-        "Without options, prompts for authentication method",
+        "Without options, a valid session returns immediately. Use an explicit method to sign in again. If veryfront.json contains apiToken, remove or replace it before using another method to switch accounts",
+        "If VERYFRONT_API_TOKEN is set in your shell, unset or replace it before using another method to switch accounts.",
+        "Explicit methods (--google, --github, --microsoft, --token) are not supported with --json. Combining them with --json returns a usage error.",
         "OAuth methods open browser for authentication",
         "Token is stored in ~/.config/veryfront/token",
         "Exits 1 when no credential was obtained, so scripts can gate on it",

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

@@ -103,6 +103,7 @@ interface ProjectFile {
     type: string;
     created_at: string;
     updated_at: string;
+    version_id?: string;
 }
 /** Validate a remote file path as a canonical relative POSIX path. */
 export declare function validateRemoteFilePath(filePath: string): string;

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;AAwBhC;;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,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAsCD,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmB/D;AAkDD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAcjF;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,CAoBjG;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;AA2eD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2LpE"}
+{"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;AA+BhC;;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,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAuCD,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmB/D;AAkDD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAcjF;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,CAoBjG;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;AAgiBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2LpE"}

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

@@ -23,6 +23,7 @@ import { CommonArgs, createArgParser } from "../../shared/args.js";
 import { createIgnoreChecker, loadIgnorePatterns } from "../../sync/ignore.js";
 import { getProjectTarget } from "../../shared/deployment-provenance.js";
 import { ensurePulledProjectBootstrap, isPulledProjectBootstrapPath, planPulledProjectBootstrap, preflightPulledProjectBootstrap, } from "./project-bootstrap.js";
+import { computeContentDigest, preflightSyncState, SYNC_STATE_RELATIVE_PATH, writeSyncTarget, } from "../../sync/state.js";
 /**
  * Schema factory for pull command arguments
  */
@@ -317,12 +318,11 @@ async function findGitRoot(projectDir) {
         return null;
     }
 }
-function isUntrackedPushReceipt(statusLine) {
-    if (!statusLine.startsWith("?? "))
+function isLocalMetadataStatus(statusLine) {
+    if (statusLine.length < 4)
         return false;
     const path = statusLine.slice(3).replace(/\\/g, "/");
-    return path === ".veryfront/push-receipt.json" ||
-        path.endsWith("/.veryfront/push-receipt.json");
+    return [".veryfront/push-receipt.json", SYNC_STATE_RELATIVE_PATH].some((relativePath) => path === relativePath || path.endsWith(`/${relativePath}`));
 }
 async function assertCleanGitWorktrees(projectDirs) {
     const gitRoots = new Set();
@@ -349,7 +349,7 @@ async function assertCleanGitWorktrees(projectDirs) {
                 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));
+        const dirty = (status.stdout ?? "").split("\n").some((line) => line !== "" && !isLocalMetadataStatus(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.`,
@@ -416,6 +416,36 @@ async function confirmPullWrite(projectDir, writeCount, deleteCount, bootstrapWr
     const action = actions.join(" and ");
     return await confirmPrompt(`This will ${action} in ${projectDir}. Continue?`, false);
 }
+function syncBranchForPullSource(source) {
+    switch (source.type) {
+        case "main":
+            return "main";
+        case "branch":
+            return source.name;
+        case "environment":
+        case "release":
+            return null;
+    }
+}
+async function recordPullSyncTarget(projectDir, config, project, source, writeOps) {
+    const branch = syncBranchForPullSource(source);
+    if (!branch)
+        return;
+    const files = {};
+    for (const op of writeOps) {
+        files[op.relativePath] = {
+            digest: await computeContentDigest(op.content),
+            ...(op.versionId ? { versionId: op.versionId } : {}),
+        };
+    }
+    await writeSyncTarget(projectDir, {
+        controlPlane: config.apiUrl,
+        projectId: project.id,
+        projectSlug: project.slug,
+        branch,
+        files,
+    });
+}
 async function pullSingleProject(projectSlug, projectDir, source, force, dryRun, prune, config, quiet = false) {
     const sourceLabel = formatPullSource(source);
     let spinner = quiet
@@ -459,7 +489,11 @@ async function pullSingleProject(projectSlug, projectDir, source, force, dryRun,
                 detail: `Veryfront returned invalid content for file "${file.path}". No local files were changed.`,
             });
         }
-        writeOps.push({ ...op, content: file.content });
+        writeOps.push({
+            ...op,
+            content: file.content,
+            ...(file.version_id ? { versionId: file.version_id } : {}),
+        });
     }
     let deleteOps = [];
     if (prune) {
@@ -499,6 +533,9 @@ async function pullSingleProject(projectSlug, projectDir, source, force, dryRun,
             return { written: 0, deleted: 0, cancelled: true };
         }
     }
+    if (!dryRun && syncBranchForPullSource(source)) {
+        await preflightSyncState(projectDir);
+    }
     if (!hasFileOperations) {
         await ensurePulledProjectBootstrap({
             projectDir,
@@ -510,6 +547,9 @@ async function pullSingleProject(projectSlug, projectDir, source, force, dryRun,
             quiet,
             plan: bootstrapPlan,
         });
+        if (!dryRun) {
+            await recordPullSyncTarget(projectDir, config, project, source, writeOps);
+        }
         return { written: 0, deleted: 0, cancelled: false };
     }
     spinner = quiet ? createNoopSpinner() : createSpinner(`Writing files to ${projectDir}...`);
@@ -533,6 +573,9 @@ async function pullSingleProject(projectSlug, projectDir, source, force, dryRun,
         quiet,
         plan: bootstrapPlan,
     });
+    if (!dryRun) {
+        await recordPullSyncTarget(projectDir, config, project, source, writeOps);
+    }
     if (!quiet) {
         if (dryRun) {
             logInfo(`Dry run complete for ${projectSlug}. Would write ${writeResult.written} and delete ${deleteResult.deleted} files.`);

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,WAgDtB,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,WAuDtB,CAAC"}

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

@@ -24,6 +24,10 @@ export const pushHelp = {
             flag: "--prune",
             description: "Delete managed remote files that are missing locally",
         },
+        {
+            flag: "-f, --force",
+            description: "Intentionally overwrite remote changes and bypass concurrency guards",
+        },
         {
             flag: "-q, --quiet",
             description: "Suppress progress and summary output",
@@ -40,6 +44,9 @@ export const pushHelp = {
         "Use --branch to create or update an isolated branch preview",
         "Preview branch names use lowercase letters, numbers, and hyphens",
         "By default, push uploads local files and preserves remote-only files",
+        "Push rejects files changed remotely since the last pull or push",
+        "Run pull and reconcile changes with Git before retrying a rejected push",
+        "Use --force only when you intend to overwrite remote changes",
         "Use --prune to remove managed remote files that are missing locally",
         "Run veryfront deploy when the preview is ready for an environment",
         ".vfignore excludes matching local files and preserves matching remote files",

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

@@ -3,6 +3,7 @@ import { type ApiClient, type ResolvedConfig } from "../../shared/config.js";
 import { type IgnoreChecker } from "../../sync/ignore.js";
 import { type PullSource } from "../pull/index.js";
 import { type GitSource } from "../../shared/deployment-provenance.js";
+import { type PlannedDelete, type PlannedUpload } from "./plan.js";
 /**
  * Schema factory for push command arguments
  */
@@ -10,7 +11,7 @@ export declare const getPushArgsSchema: () => import("../../../src/internal-agen
     projectSlug: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
     projectDir: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
     branch: import("../../../src/internal-agents/schema.js").Schema<string>;
-    /** Deprecated compatibility flag; invoking push already authorizes the operation. */
+    /** Intentionally overwrite remote changes and bypass concurrency guards. */
     force: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     prune: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     dryRun: import("../../../src/internal-agents/schema.js").Schema<boolean>;
@@ -20,7 +21,7 @@ export declare const PushArgsSchema: import("../../../src/internal-agents/schema
     projectSlug: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
     projectDir: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
     branch: import("../../../src/internal-agents/schema.js").Schema<string>;
-    /** Deprecated compatibility flag; invoking push already authorizes the operation. */
+    /** Intentionally overwrite remote changes and bypass concurrency guards. */
     force: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     prune: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     dryRun: import("../../../src/internal-agents/schema.js").Schema<boolean>;
@@ -34,7 +35,7 @@ declare const parseKnownPushArgs: (args: import("../../shared/types.js").ParsedA
     projectSlug: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
     projectDir: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
     branch: import("../../../src/internal-agents/schema.js").Schema<string>;
-    /** Deprecated compatibility flag; invoking push already authorizes the operation. */
+    /** Intentionally overwrite remote changes and bypass concurrency guards. */
     force: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     prune: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     dryRun: import("../../../src/internal-agents/schema.js").Schema<boolean>;
@@ -51,7 +52,7 @@ export interface PushOptions {
     projectDir?: string;
     /** Branch name to update (defaults to main) */
     branch?: string;
-    /** Deprecated compatibility flag; invoking push already authorizes the operation. */
+    /** Intentionally overwrite remote changes and bypass concurrency guards. */
     force?: boolean;
     /** Prune remote files that are missing locally. */
     prune?: boolean;
@@ -63,7 +64,7 @@ export interface PushOptions {
 /**
  * File upload operation
  */
-export interface UploadOp {
+export interface UploadOp extends PlannedUpload {
     /** Relative path from project root (sent to API) */
     path: string;
     content: string;
@@ -85,9 +86,19 @@ interface BranchListItem {
     id: string;
     name: string;
 }
+interface EnsuredBranch extends BranchListItem {
+    created: boolean;
+}
+interface PushRemoteTarget {
+    branchId: string | null;
+    remoteFiles: RemoteFile[];
+    source: PullSource;
+    branchExists: boolean;
+}
 interface RemoteFile {
     path: string;
     content?: string;
+    version_id?: string;
 }
 export declare function scanLocalFiles(projectDir: string, ignoreChecker: IgnoreChecker): Promise<UploadOp[]>;
 export declare function capturePushSourceSnapshot(projectDir: string, ignoreChecker: IgnoreChecker): Promise<PushSourceSnapshot>;
@@ -113,19 +124,19 @@ export declare function buildPushUrls(projectSlug: string, branchName: string):
     preview: string;
 };
 export declare function createBranch(client: ApiClient, projectSlug: string, branchName: string): Promise<BranchResponse>;
-export declare function ensureBranch(client: ApiClient, projectSlug: string, branchName: string): Promise<BranchListItem>;
-export declare function resolvePushRemoteFiles(client: ApiClient, projectSlug: string, branchName: string, mainFiles: RemoteFile[]): Promise<{
-    branchId: string | null;
-    remoteFiles: RemoteFile[];
-    source: PullSource;
-}>;
+export declare function ensureBranch(client: ApiClient, projectSlug: string, branchName: string): Promise<EnsuredBranch>;
+export declare function resolvePushRemoteFiles(client: ApiClient, projectSlug: string, branchName: string, mainFiles: RemoteFile[]): Promise<PushRemoteTarget>;
 export declare function uploadFiles(client: ApiClient, projectSlug: string, branchId: string | null, ops: UploadOp[], dryRun: boolean): Promise<{
     uploaded: number;
     failed: number;
+    conflicts: string[];
+    applied: string[];
 }>;
-export declare function deleteFiles(client: ApiClient, projectSlug: string, branchId: string | null, paths: string[], dryRun: boolean): Promise<{
+export declare function deleteFiles(client: ApiClient, projectSlug: string, branchId: string | null, ops: PlannedDelete[], dryRun: boolean): Promise<{
     deleted: number;
     failed: number;
+    conflicts: string[];
+    applied: string[];
 }>;
 export declare function recordPushReceipt(client: ApiClient, config: ResolvedConfig, projectDir: string, branch: string, snapshot: PushSourceSnapshot, ignoreChecker: IgnoreChecker, pushedSourceDigest?: string): Promise<void>;
 export declare function pushCommand(options?: PushOptions): Promise<void>;