void 0.7.0 → 0.7.1

package/dist/{auth-cmd-Dx8oPKZC.mjs → auth-cmd-DVKi6dzh.mjs}

@@ -1,6 +1,6 @@
 import { c as R } from "./dist-Dayj3gCK.mjs";
-import { n as PlatformClient, s as getToken, u as removeToken } from "./client-snXOjrp1.mjs";
-import { n as runLoginCommand } from "./login-CkcXUiIu.mjs";
+import { n as PlatformClient, s as getToken, u as removeToken } from "./client-BUdfE3QJ.mjs";
+import { n as runLoginCommand } from "./login-RWUDCfdx.mjs";
 import { execSync } from "node:child_process";
 //#region src/cli/auth-cmd.ts
 async function runAuthCommand(root, args) {

package/dist/{cache-W82I8ihI.mjs → cache-B0BgSTZi.mjs}

@@ -1,7 +1,7 @@
 import { i as dim, n as cliTitle, r as createSpinner } from "./output-BwlcIYSR.mjs";
 import { c as R, g as ge, y as ye } from "./dist-Dayj3gCK.mjs";
 import { r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 import { r as resolveProjectBySlug, t as getRequestedProjectSlug } from "./resolve-project-Br5BR03U.mjs";
 //#region src/cli/cache.ts
 async function runPurgeCacheCommand(root, projectSlug) {

package/dist/{cancel-deploy-BOBTqqh0.mjs → cancel-deploy-D9OFt5gA.mjs}

@@ -1,7 +1,7 @@
 import { n as cliTitle } from "./output-BwlcIYSR.mjs";
 import { c as R, g as ge, v as ue, x as q, y as ye } from "./dist-Dayj3gCK.mjs";
 import { r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 //#region src/cli/cancel-deploy.ts
 const ACTIVE_STATUSES = new Set([
 	"pending",

package/dist/cli/cli.mjs

@@ -162,7 +162,8 @@ function parseDeployArgs(args) {
 				project: { type: "string" },
 				dir: { type: "string" },
 				spa: { type: "boolean" },
-				"skip-build": { type: "boolean" }
+				"skip-build": { type: "boolean" },
+				debug: { type: "boolean" }
 			},
 			allowPositionals: true,
 			strict: true,
@@ -184,7 +185,8 @@ function parseDeployArgs(args) {
 		projectSlug,
 		dir: typeof parsed.values.dir === "string" ? parsed.values.dir : void 0,
 		spa: parsed.values.spa === true ? true : void 0,
-		skipBuild: parsed.values["skip-build"] === true ? true : void 0
+		skipBuild: parsed.values["skip-build"] === true ? true : void 0,
+		debug: parsed.values.debug === true ? true : void 0
 	};
 }
 //#endregion
@@ -768,6 +770,10 @@ const HELP_TREE = {
 			{
 				command: "--skip-build",
 				description: "Skip the build step and use existing output"
+			},
+			{
+				command: "--debug",
+				description: "Mirror the deploy log to stderr (always written to ~/.void/logs)"
 			}
 		],
 		examples: [
@@ -1644,23 +1650,24 @@ else if (command === "deploy") {
 		R.error(err instanceof Error ? err.message : String(err));
 		process.exit(1);
 	}
-	import("../deploy-BPKblFx6.mjs").then((n) => n.t).then(({ runDeploy }) => {
+	import("../deploy-BqXz1ycW.mjs").then((n) => n.t).then(({ runDeploy }) => {
 		runDeploy(root, {
 			projectSlug: deployArgs.projectSlug,
 			dir: deployArgs.dir,
 			spa: deployArgs.spa,
-			skipBuild: deployArgs.skipBuild
+			skipBuild: deployArgs.skipBuild,
+			debug: deployArgs.debug
 		}).catch((err) => {
 			R.error(err.message ?? err);
 			process.exit(1);
 		});
 	});
-} else if (command === "auth") runSubcommandGroup("auth", authSubcommands, parseAuthArgs, (root, parsed) => import("../auth-cmd-Dx8oPKZC.mjs").then(({ runAuthCommand }) => runAuthCommand(root, parsed)));
-else if (command === "project") runSubcommandGroup("project", projectSubcommands, parseProjectArgs, (root, parsed) => import("../project-cmd-B7lQp3F3.mjs").then(({ runProjectCommand }) => runProjectCommand(root, parsed)));
-else if (command === "secret") runSubcommandGroup("secret", secretSubcommands, parseSecretArgs, (root, parsed) => import("../secret-CeRSukgM.mjs").then(({ runSecretCommand }) => runSecretCommand(root, parsed)));
-else if (command === "domain") runSubcommandGroup("domain", domainSubcommands, parseDomainArgs, (root, parsed) => import("../domain-BGofcQ6I.mjs").then(({ runDomainCommand }) => runDomainCommand(root, parsed)));
-else if (command === "db") runSubcommandGroup("db", dbSubcommands, parseDbArgs, (root, parsed) => import("../db-DsRoMcfN.mjs").then(({ runDbCommand }) => runDbCommand(root, parsed)));
-else if (command === "env") runSubcommandGroup("env", envSubcommands, parseEnvArgs, (root, parsed) => import("../env-CyG3tvU0.mjs").then(({ runEnvCommand }) => runEnvCommand(root, parsed)));
+} else if (command === "auth") runSubcommandGroup("auth", authSubcommands, parseAuthArgs, (root, parsed) => import("../auth-cmd-DVKi6dzh.mjs").then(({ runAuthCommand }) => runAuthCommand(root, parsed)));
+else if (command === "project") runSubcommandGroup("project", projectSubcommands, parseProjectArgs, (root, parsed) => import("../project-cmd-ATFi3kRm.mjs").then(({ runProjectCommand }) => runProjectCommand(root, parsed)));
+else if (command === "secret") runSubcommandGroup("secret", secretSubcommands, parseSecretArgs, (root, parsed) => import("../secret-DmjBDxB1.mjs").then(({ runSecretCommand }) => runSecretCommand(root, parsed)));
+else if (command === "domain") runSubcommandGroup("domain", domainSubcommands, parseDomainArgs, (root, parsed) => import("../domain-B-fIU3VE.mjs").then(({ runDomainCommand }) => runDomainCommand(root, parsed)));
+else if (command === "db") runSubcommandGroup("db", dbSubcommands, parseDbArgs, (root, parsed) => import("../db-BIP2kuEt.mjs").then(({ runDbCommand }) => runDbCommand(root, parsed)));
+else if (command === "env") runSubcommandGroup("env", envSubcommands, parseEnvArgs, (root, parsed) => import("../env-BwbZJd2x.mjs").then(({ runEnvCommand }) => runEnvCommand(root, parsed)));
 else if (command === "gen") runSubcommandGroup("gen", genSubcommands, parseGenArgs, (root, parsed) => import("../gen-U0Ktr4Zd.mjs").then(({ runGenCommand }) => runGenCommand(root, parsed)));
 else if (command === "prepare") {
 	const root = process.cwd();
@@ -1679,7 +1686,7 @@ else if (command === "prepare") {
 	});
 } else if (command === "init") {
 	const root = process.cwd();
-	import("../init-C7wS5iGP.mjs").then(({ runInitCommand, parseInitArgs }) => {
+	import("../init-Bb_Qsdq6.mjs").then(({ runInitCommand, parseInitArgs }) => {
 		let initArgs;
 		try {
 			initArgs = parseInitArgs(args.slice(1));
@@ -1692,7 +1699,7 @@ else if (command === "prepare") {
 			process.exit(1);
 		});
 	});
-} else if (command === "mcp") import("../mcp-CaQzfeUi.mjs").then(({ runMcp }) => {
+} else if (command === "mcp") import("../mcp-kZ4zg13a.mjs").then(({ runMcp }) => {
 	runMcp();
 });
 else if (command === "-v" || command === "--version") {
@@ -1768,26 +1775,26 @@ else if (command === "-v" || command === "--version") {
 		const root = process.cwd();
 		switch (cmd) {
 			case "init": {
-				const { runInitCommand, parseInitArgs } = await import("../init-C7wS5iGP.mjs");
+				const { runInitCommand, parseInitArgs } = await import("../init-Bb_Qsdq6.mjs");
 				await runInitCommand(root, parseInitArgs([]));
 				return;
 			}
 			case "deploy": {
-				const { runDeploy } = await import("../deploy-BPKblFx6.mjs").then((n) => n.t);
+				const { runDeploy } = await import("../deploy-BqXz1ycW.mjs").then((n) => n.t);
 				await runDeploy(root);
 				return;
 			}
 			case "mcp": {
-				const { runMcp } = await import("../mcp-CaQzfeUi.mjs");
+				const { runMcp } = await import("../mcp-kZ4zg13a.mjs");
 				runMcp();
 				return;
 			}
-			case "auth": return runSubcommandGroup("auth", authSubcommands, parseAuthArgs, (r, p) => import("../auth-cmd-Dx8oPKZC.mjs").then(({ runAuthCommand }) => runAuthCommand(r, p)));
-			case "project": return runSubcommandGroup("project", projectSubcommands, parseProjectArgs, (r, p) => import("../project-cmd-B7lQp3F3.mjs").then(({ runProjectCommand }) => runProjectCommand(r, p)));
-			case "secret": return runSubcommandGroup("secret", secretSubcommands, parseSecretArgs, (r, p) => import("../secret-CeRSukgM.mjs").then(({ runSecretCommand }) => runSecretCommand(r, p)));
-			case "domain": return runSubcommandGroup("domain", domainSubcommands, parseDomainArgs, (r, p) => import("../domain-BGofcQ6I.mjs").then(({ runDomainCommand }) => runDomainCommand(r, p)));
-			case "db": return runSubcommandGroup("db", dbSubcommands, parseDbArgs, (r, p) => import("../db-DsRoMcfN.mjs").then(({ runDbCommand }) => runDbCommand(r, p)));
-			case "env": return runSubcommandGroup("env", envSubcommands, parseEnvArgs, (r, p) => import("../env-CyG3tvU0.mjs").then(({ runEnvCommand }) => runEnvCommand(r, p)));
+			case "auth": return runSubcommandGroup("auth", authSubcommands, parseAuthArgs, (r, p) => import("../auth-cmd-DVKi6dzh.mjs").then(({ runAuthCommand }) => runAuthCommand(r, p)));
+			case "project": return runSubcommandGroup("project", projectSubcommands, parseProjectArgs, (r, p) => import("../project-cmd-ATFi3kRm.mjs").then(({ runProjectCommand }) => runProjectCommand(r, p)));
+			case "secret": return runSubcommandGroup("secret", secretSubcommands, parseSecretArgs, (r, p) => import("../secret-DmjBDxB1.mjs").then(({ runSecretCommand }) => runSecretCommand(r, p)));
+			case "domain": return runSubcommandGroup("domain", domainSubcommands, parseDomainArgs, (r, p) => import("../domain-B-fIU3VE.mjs").then(({ runDomainCommand }) => runDomainCommand(r, p)));
+			case "db": return runSubcommandGroup("db", dbSubcommands, parseDbArgs, (r, p) => import("../db-BIP2kuEt.mjs").then(({ runDbCommand }) => runDbCommand(r, p)));
+			case "env": return runSubcommandGroup("env", envSubcommands, parseEnvArgs, (r, p) => import("../env-BwbZJd2x.mjs").then(({ runEnvCommand }) => runEnvCommand(r, p)));
 			case "gen": return runSubcommandGroup("gen", genSubcommands, parseGenArgs, (r, p) => import("../gen-U0Ktr4Zd.mjs").then(({ runGenCommand }) => runGenCommand(r, p)));
 			case "prepare": {
 				const { runPrepareCommand } = await import("../prepare-BAtWufvm.mjs");

package/dist/{client-snXOjrp1.mjs → client-BUdfE3QJ.mjs}

@@ -303,9 +303,13 @@ function isExpiredTokenError(error) {
 var PlatformClient = class {
 	baseUrl;
 	authHeaders;
+	cliLog;
 	constructor(token, options) {
 		if (typeof options === "string") this.baseUrl = options;
-		else this.baseUrl = options?.apiUrl ?? getApiUrl(options?.root);
+		else {
+			this.baseUrl = options?.apiUrl ?? getApiUrl(options?.root);
+			this.cliLog = options?.cliLog;
+		}
 		ensureCloudflaredToken(this.baseUrl);
 		this.authHeaders = {
 			Authorization: `Bearer ${token}`,
@@ -395,25 +399,78 @@ var PlatformClient = class {
 		}
 	}
 	async *deploy(projectId, formData) {
-		const res = await fetch(`${this.baseUrl}/projects/${projectId}/deploy`, {
-			method: "POST",
-			headers: { ...this.authHeaders },
-			body: formData
+		const cliLog = this.cliLog;
+		const url = `${this.baseUrl}/projects/${projectId}/deploy`;
+		cliLog?.info("deploy_post", { url });
+		let res;
+		try {
+			res = await fetch(url, {
+				method: "POST",
+				headers: { ...this.authHeaders },
+				body: formData
+			});
+		} catch (err) {
+			cliLog?.error("deploy_fetch_rejected", err, { url });
+			throw err;
+		}
+		const cfRay = res.headers.get("cf-ray");
+		const cfCacheStatus = res.headers.get("cf-cache-status");
+		cliLog?.info("deploy_response", {
+			status: res.status,
+			cfRay,
+			cfCacheStatus,
+			contentType: res.headers.get("content-type")
 		});
 		if (!res.ok) await throwPlatformApiError("Deploy failed", res);
 		const reader = res.body.getReader();
 		const decoder = new TextDecoder();
 		let buffer = "";
-		while (true) {
-			const { done, value } = await reader.read();
-			if (done) break;
-			buffer += decoder.decode(value, { stream: true });
-			let newlineIdx;
-			while ((newlineIdx = buffer.indexOf("\n")) !== -1) {
-				const line = buffer.slice(0, newlineIdx);
-				buffer = buffer.slice(newlineIdx + 1);
-				if (line.trim()) yield JSON.parse(line);
+		let bytesRead = 0;
+		let firstByteAt = null;
+		const startedAt = Date.now();
+		let eventCount = 0;
+		let lastEventName = "<none>";
+		try {
+			while (true) {
+				const { done, value } = await reader.read();
+				if (done) {
+					cliLog?.info("deploy_stream_eof", {
+						bytesRead,
+						eventCount,
+						lastEvent: lastEventName
+					});
+					break;
+				}
+				if (firstByteAt === null) {
+					firstByteAt = Date.now() - startedAt;
+					cliLog?.info("deploy_stream_ttfb", { ttfbMs: firstByteAt });
+				}
+				bytesRead += value.byteLength;
+				buffer += decoder.decode(value, { stream: true });
+				let newlineIdx;
+				while ((newlineIdx = buffer.indexOf("\n")) !== -1) {
+					const line = buffer.slice(0, newlineIdx);
+					buffer = buffer.slice(newlineIdx + 1);
+					if (line.trim()) {
+						const event = JSON.parse(line);
+						eventCount++;
+						lastEventName = event.event ?? "<no-event-field>";
+						cliLog?.info("deploy_event", {
+							eventCount,
+							event: lastEventName,
+							raw: line.slice(0, 200)
+						});
+						yield event;
+					}
+				}
 			}
+		} catch (err) {
+			cliLog?.error("deploy_stream_error", err, {
+				bytesRead,
+				eventCount,
+				lastEvent: lastEventName
+			});
+			throw err;
 		}
 	}
 	async listSecrets(projectId) {

package/dist/{create-project-BIA15W7z.mjs → create-project-CN1pF-OQ.mjs}

@@ -1,7 +1,7 @@
 import { s as import_picocolors } from "./output-BwlcIYSR.mjs";
 import { _ as me, c as R, i as Ee, l as Re, x as q } from "./dist-Dayj3gCK.mjs";
 import { a as writeProjectConfig } from "./project-TqORyHn8.mjs";
-import { o as getSiteDomain, t as PlatformApiError } from "./client-snXOjrp1.mjs";
+import { o as getSiteDomain, t as PlatformApiError } from "./client-BUdfE3QJ.mjs";
 import { n as validateProjectSlug } from "./project-slug-CKam8lF9.mjs";
 import { n as inferDefaultSlug } from "./resolve-project-Br5BR03U.mjs";
 //#region src/cli/prompt.ts

package/dist/{db-DsRoMcfN.mjs → db-BIP2kuEt.mjs}

@@ -2,7 +2,7 @@ import { a as join, o as relative, r as extname, s as resolve } from "./pathe.M-
 import { i as dim, n as cliTitle, s as import_picocolors } from "./output-BwlcIYSR.mjs";
 import { c as R, g as ge, y as ye } from "./dist-Dayj3gCK.mjs";
 import { r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 import { c as getDatabaseDialect, f as readConfig } from "./config-BIa9HwVX.mjs";
 import { n as detectFramework } from "./plugin-inference-oZ6Ybu2_.mjs";
 import { a as writeJournal, i as stripSqlExt, r as readJournal, t as collectMigrations } from "./collect-CjeZgz5D.mjs";

package/dist/{delete-DAP6yDc7.mjs → delete-DJTvwbr-.mjs}

@@ -1,7 +1,7 @@
 import { n as cliTitle, r as createSpinner } from "./output-BwlcIYSR.mjs";
 import { _ as me, c as R, g as ge, l as Re, u as Se, x as q, y as ye } from "./dist-Dayj3gCK.mjs";
 import { i as removeProjectConfig, r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 import { r as resolveProjectBySlug } from "./resolve-project-Br5BR03U.mjs";
 //#region src/cli/delete.ts
 async function runDeleteCommand(root, slug, options) {

package/dist/{deploy-BPKblFx6.mjs → deploy-BqXz1ycW.mjs}

@@ -4,7 +4,7 @@ import { n as cliTitle, r as createSpinner, s as import_picocolors } from "./out
 import { t as findVoidAuthConfig } from "./config-CvHtTM0q.mjs";
 import { c as R, g as ge, u as Se, v as ue, x as q, y as ye } from "./dist-Dayj3gCK.mjs";
 import { a as writeProjectConfig, r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { a as parsePlatformErrorBody, c as getTokenSource, i as isExpiredTokenError, l as isStagingMode, n as PlatformClient, s as getToken, t as PlatformApiError } from "./client-snXOjrp1.mjs";
+import { a as parsePlatformErrorBody, c as getTokenSource, i as isExpiredTokenError, l as isStagingMode, n as PlatformClient, s as getToken, t as PlatformApiError } from "./client-BUdfE3QJ.mjs";
 import { c as getDatabaseDialect, f as readConfig, l as isNodeTarget, p as resolveBindingNames } from "./config-BIa9HwVX.mjs";
 import { i as scanJobsSync, n as scanWebSocketRoutesSync, r as scanQueuesSync, t as scanRoutes } from "./scan-C6HMEIdW.mjs";
 import { c as validateSsrEntry, n as detectFramework, r as inferProjectBindings, t as FRAMEWORK_SCAN_DIRS } from "./plugin-inference-oZ6Ybu2_.mjs";
@@ -16,16 +16,16 @@ import { n as writeDrizzleConfig } from "./config-BzM9Dy7T.mjs";
 import { t as collectMigrations } from "./collect-CjeZgz5D.mjs";
 import { r as validateMigrations, t as assertJournalCoherence } from "./validate-CaMavMxu.mjs";
 import { t as scanPages } from "./scan-Ba4hFwlH.mjs";
-import { n as promptProjectSelection, r as promptProjectSetupAction, t as promptAndCreateProject } from "./create-project-BIA15W7z.mjs";
+import { n as promptProjectSelection, r as promptProjectSetupAction, t as promptAndCreateProject } from "./create-project-CN1pF-OQ.mjs";
 import { r as resolveProjectBySlug, t as getRequestedProjectSlug } from "./resolve-project-Br5BR03U.mjs";
 import { n as lintDuplicateSources, r as mergeRoutingRules, t as lintDestinationSplats } from "./headers-DCXc7mDs.mjs";
-import { t as promptForLoginToken } from "./login-CkcXUiIu.mjs";
+import { t as promptForLoginToken } from "./login-RWUDCfdx.mjs";
 import { i as resolveProjectCommand, n as detectPreset, r as formatProjectCommand, t as FRAMEWORK_PRESETS } from "./preset-D4I73kT4.mjs";
 import { createRequire } from "node:module";
-import { copyFileSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import { copyFileSync, cpSync, createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { build, loadEnv } from "vite";
-import { tmpdir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import { parse } from "jsonc-parser";
 import { execFile, execFileSync, execSync } from "node:child_process";
 import { hash } from "blake3-jit";
@@ -808,11 +808,17 @@ function trimSnippet(body) {
 function appendDeploymentLine(message, deploymentId) {
 	return deploymentId ? `${message}\nDeployment: ${deploymentId}` : message;
 }
+function appendLogLine(message, logPath) {
+	return logPath ? `${message}\nDetailed log: ${logPath}` : message;
+}
+function appendTrailingLines(message, deploymentId, logPath) {
+	return appendLogLine(appendDeploymentLine(message, deploymentId), logPath);
+}
 /**
 * Format a server-emitted `event: 'error'` payload with an optional deployment id.
 */
-function formatDeployFailureMessage(message, deploymentId) {
-	return appendDeploymentLine(message, deploymentId);
+function formatDeployFailureMessage(message, deploymentId, logPath) {
+	return appendTrailingLines(message, deploymentId, logPath);
 }
 /**
 * Format the "stream ended cleanly but no terminal event arrived" case.
@@ -821,8 +827,8 @@ function formatDeployFailureMessage(message, deploymentId) {
 * deploy" message — the server closed the NDJSON stream without emitting
 * `done` or `error`, so there is no underlying error to carry.
 */
-function formatConnectionLostMessage(deploymentId) {
-	return appendDeploymentLine("deploy: Connection lost during deploy.", deploymentId);
+function formatConnectionLostMessage(deploymentId, logPath) {
+	return appendTrailingLines("deploy: Connection lost during deploy.", deploymentId, logPath);
 }
 /**
 * Convert an exception thrown during the deploy NDJSON stream into a
@@ -837,18 +843,172 @@ function formatConnectionLostMessage(deploymentId) {
 *      during deploy: <original>` prefix so the caller can still tell network,
 *      parse, and transport errors apart.
 */
-function formatStreamDeployError(err, deploymentId) {
+function formatStreamDeployError(err, deploymentId, logPath) {
 	if (err instanceof PlatformApiError) {
 		const parsed = parsePlatformErrorBody(err.body);
 		const parsedError = parsed?.error ?? parsed?.message ?? null;
 		const effectiveDeploymentId = parsed?.deployment ?? null ?? deploymentId;
-		if (err.status === 409 && parsedError) return new Error(appendDeploymentLine(`deploy: Deploy failed: ${parsedError}`, effectiveDeploymentId));
+		if (err.status === 409 && parsedError) return new Error(appendTrailingLines(`deploy: Deploy failed: ${parsedError}`, effectiveDeploymentId, logPath));
 		const detail = parsedError ?? trimSnippet(err.body);
 		const base = detail ? `deploy: Deploy failed (HTTP ${err.status}): ${detail}` : `deploy: Deploy failed (HTTP ${err.status}).`;
-		return new Error(appendDeploymentLine(base, effectiveDeploymentId));
+		return new Error(appendTrailingLines(base, effectiveDeploymentId, logPath));
 	}
 	const original = err instanceof Error ? err.message : String(err);
-	return new Error(appendDeploymentLine(`deploy: Connection lost during deploy: '${original}'.`, deploymentId));
+	return new Error(appendTrailingLines(`deploy: Connection lost during deploy: '${original}'.`, deploymentId, logPath));
+}
+//#endregion
+//#region src/cli/log-file.ts
+/**
+* Walk `err.cause` up to 6 levels and return a plain JSON-friendly chain.
+* Skips stack traces deliberately — keeps output line-oriented and readable.
+*/
+function describeErrorChain(err, depth = 0) {
+	if (depth > 5 || err == null) return String(err);
+	if (err instanceof Error) {
+		const node = {
+			name: err.name,
+			message: err.message
+		};
+		const code = err.code;
+		if (code !== void 0) node.code = code;
+		const errno = err.errno;
+		if (errno !== void 0) node.errno = errno;
+		const cause = err.cause;
+		if (cause != null) {
+			const sub = describeErrorChain(cause, depth + 1);
+			if (typeof sub === "object") node.cause = sub;
+			else node.cause = { message: sub };
+		}
+		return node;
+	}
+	return String(err);
+}
+/**
+* Flatten an error and its `cause` chain to a single inline string suitable
+* for stderr skimming. Mirrors `describeErrorChain`'s walk (depth cap 6,
+* same fields, no stack traces) but joins levels with ` -> ` instead of
+* nesting JSON.
+*/
+function formatErrorChainInline(err, depth = 0) {
+	if (depth > 5 || err == null) return String(err);
+	if (err instanceof Error) {
+		let head = err.name ? `${err.name}: ${err.message}` : err.message;
+		const code = err.code;
+		const errno = err.errno;
+		const tags = [];
+		if (code !== void 0) tags.push(`code=${code}`);
+		if (errno !== void 0) tags.push(`errno=${errno}`);
+		if (tags.length > 0) head = `${head} (${tags.join(" ")})`;
+		const cause = err.cause;
+		if (cause != null) return `${head} -> ${formatErrorChainInline(cause, depth + 1)}`;
+		return head;
+	}
+	return String(err);
+}
+function formatStderrLine(level, msg, err, fields) {
+	const parts = [level, msg];
+	if (fields) for (const [k, v] of Object.entries(fields)) {
+		if (v === void 0) continue;
+		let s;
+		if (v == null || typeof v === "number" || typeof v === "boolean") s = String(v);
+		else if (typeof v === "string") s = v.length > 200 ? `${v.slice(0, 200)}...` : v;
+		else try {
+			s = JSON.stringify(v);
+		} catch {
+			s = String(v);
+		}
+		parts.push(`${k}=${s}`);
+	}
+	if (err !== void 0) parts.push(`-> err=${formatErrorChainInline(err)}`);
+	return parts.join(" ");
+}
+function openDeployLog(opts) {
+	const mirror = opts?.mirrorToStderr === true;
+	const startedAt = Date.now();
+	let path = null;
+	let stream = null;
+	let broken = false;
+	let closed = false;
+	try {
+		const dir = join(homedir(), ".void", "logs");
+		mkdirSync(dir, { recursive: true });
+		const filePath = join(dir, `deploy-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.jsonl`);
+		stream = createWriteStream(filePath, {
+			flags: "a",
+			autoClose: true
+		});
+		stream.on("error", () => {
+			broken = true;
+		});
+		path = filePath;
+	} catch {
+		broken = true;
+		path = null;
+		stream = null;
+	}
+	function write(level, msg, err, fields) {
+		if (mirror) try {
+			process.stderr.write(`${formatStderrLine(level, msg, err, fields)}\n`);
+		} catch {}
+		if (broken || !stream || closed) return;
+		const now = Date.now();
+		const record = {
+			ts: now,
+			elapsedMs: now - startedAt,
+			lvl: level,
+			msg
+		};
+		if (fields) {
+			for (const [k, v] of Object.entries(fields)) if (v !== void 0 && k !== "ts" && k !== "elapsedMs" && k !== "lvl" && k !== "msg" && k !== "err") record[k] = v;
+		}
+		if (err !== void 0) record.err = describeErrorChain(err);
+		let line;
+		try {
+			line = `${JSON.stringify(record)}\n`;
+		} catch {
+			line = `${JSON.stringify({
+				ts: now,
+				elapsedMs: now - startedAt,
+				lvl: level,
+				msg,
+				err: "unserializable fields"
+			})}\n`;
+		}
+		try {
+			stream.write(line);
+		} catch {
+			broken = true;
+		}
+	}
+	return {
+		get path() {
+			return path;
+		},
+		info(msg, fields) {
+			write("info", msg, void 0, fields);
+		},
+		warn(msg, fields) {
+			write("warn", msg, void 0, fields);
+		},
+		error(msg, err, fields) {
+			write("error", msg, err, fields);
+		},
+		debug(msg, fields) {
+			write("debug", msg, void 0, fields);
+		},
+		close() {
+			if (closed) return Promise.resolve();
+			closed = true;
+			if (!stream) return Promise.resolve();
+			return new Promise((resolveClose) => {
+				try {
+					stream.end(() => resolveClose());
+				} catch {
+					resolveClose();
+				}
+			});
+		}
+	};
 }
 //#endregion
 //#region src/shared/utils.ts
@@ -1573,6 +1733,28 @@ function resolveDeployWranglerCompat(root, config, buildOutputDir) {
 async function runDeploy(root, options) {
 	console.log();
 	ge(cliTitle("deploy"));
+	const cliLog = openDeployLog({ mirrorToStderr: options?.debug === true || process.env.VOID_DEPLOY_DEBUG === "1" });
+	cliLog.info("deploy_start", {
+		cwd: root,
+		projectSlug: options?.projectSlug,
+		dir: options?.dir,
+		spa: options?.spa === true ? true : void 0,
+		skipBuild: options?.skipBuild === true ? true : void 0,
+		nodeVersion: process.version,
+		platform: process.platform,
+		arch: process.arch
+	});
+	try {
+		await runDeployInner(root, options, cliLog);
+		cliLog.info("deploy_end", { ok: true });
+	} catch (err) {
+		cliLog.error("deploy_end", err, { ok: false });
+		throw err;
+	} finally {
+		await cliLog.close().catch(() => {});
+	}
+}
+async function runDeployInner(root, options, cliLog) {
 	let reauthenticated = false;
 	while (true) try {
 		const token = getToken(root);
@@ -1580,29 +1762,45 @@ async function runDeploy(root, options) {
 			R.error("No auth token found. Run `void auth login` first.");
 			process.exit(1);
 		}
-		const client = new PlatformClient(token, { root });
+		const client = new PlatformClient(token, {
+			root,
+			cliLog
+		});
 		const requestedProjectSlug = getRequestedProjectSlug(options);
 		let config = null;
 		if (requestedProjectSlug) {
 			config = resolveProjectBySlug(await client.listProjects(), requestedProjectSlug);
-			if (!config) if (!process.stdin.isTTY) config = await createProjectFromSlug(root, client, requestedProjectSlug);
+			if (!config) if (!process.stdin.isTTY) config = await createProjectFromSlug(root, client, requestedProjectSlug, cliLog);
 			else {
 				const shouldCreate = await ue({ message: `Project "${requestedProjectSlug}" does not exist. Create it?` });
 				if (q(shouldCreate) || !shouldCreate) {
 					R.info("Deploy cancelled.");
 					process.exit(0);
 				}
-				config = await createProjectFromSlug(root, client, requestedProjectSlug);
+				config = await createProjectFromSlug(root, client, requestedProjectSlug, cliLog);
 			}
 		} else config = readProjectConfig(root);
 		if (!config && !process.stdin.isTTY) {
 			R.error("No project specified. Set `VOID_PROJECT`, pass `--project <slug>`, or commit `.void/project.json`.");
 			process.exit(1);
 		}
-		if (!config) config = await promptDeployProjectConfig(root, client);
+		if (!config) config = await promptDeployProjectConfig(root, client, cliLog);
+		cliLog.info("project_resolved", {
+			projectId: config.projectId,
+			slug: config.slug
+		});
 		const voidConfig = readConfig(root);
+		cliLog.info("config_resolved", {
+			target: voidConfig.target,
+			appType: voidConfig.inference?.appType,
+			output: voidConfig.output
+		});
 		const detected = detectFramework(root);
 		if (detected) {
+			cliLog.info("framework_detected", {
+				name: detected.name,
+				class: detected.class
+			});
 			const gitCommit = options?.skipBuild ? null : getGitCommit(root);
 			const fwPreset = FRAMEWORK_PRESETS[detected.name];
 			if (detected.class === "b" || detected.class === "c") {
@@ -1610,8 +1808,8 @@ async function runDeploy(root, options) {
 					R.error(`No deploy preset found for framework "${detected.name}".`);
 					process.exit(1);
 				}
-				await runFrameworkDeploy(root, config, client, detected, fwPreset, voidConfig, options?.skipBuild, gitCommit);
-			} else await runFullDeploy(root, config, client, fwPreset, options?.skipBuild, gitCommit, detected);
+				await runFrameworkDeploy(root, config, client, detected, fwPreset, voidConfig, options?.skipBuild, gitCommit, cliLog);
+			} else await runFullDeploy(root, config, client, fwPreset, options?.skipBuild, gitCommit, detected, cliLog);
 			return;
 		}
 		let preset = null;
@@ -1641,8 +1839,8 @@ async function runDeploy(root, options) {
 				...preset,
 				buildCommand: resolveStaticBuildCommand(preset, voidConfig.inference?.build, Boolean(options?.dir))
 			};
-			await runStaticDeploy(root, config, client, preset, options?.skipBuild, gitCommit, void 0, void 0, void 0, void 0, voidConfig.routing);
-		} else await runFullDeploy(root, config, client, void 0, options?.skipBuild, gitCommit);
+			await runStaticDeploy(root, config, client, preset, options?.skipBuild, gitCommit, void 0, void 0, void 0, void 0, voidConfig.routing, cliLog);
+		} else await runFullDeploy(root, config, client, void 0, options?.skipBuild, gitCommit, void 0, cliLog);
 		return;
 	} catch (error) {
 		if (isExpiredTokenError(error)) {
@@ -1657,7 +1855,7 @@ async function runDeploy(root, options) {
 		throw error;
 	}
 }
-async function promptDeployProjectConfig(root, client) {
+async function promptDeployProjectConfig(root, client, cliLog) {
 	const projects = await client.listProjects();
 	if (await promptProjectSetupAction("Set up a Void project for deploy:", { includeLink: projects.length > 0 }) === "create") return promptAndCreateProject(root, client);
 	const result = await promptProjectSelection(projects, "Select a project to deploy to:", root, { includeCreate: false });
@@ -1668,6 +1866,10 @@ async function promptDeployProjectConfig(root, client) {
 	};
 	writeProjectConfig(root, config);
 	R.step(`Linked to ${import_picocolors.default.blue(config.slug)}`);
+	cliLog?.info("project_linked", {
+		projectId: config.projectId,
+		slug: config.slug
+	});
 	return config;
 }
 function resolveStaticBuildCommand(preset, buildOverride, hasExplicitDir = false) {
@@ -1729,49 +1931,78 @@ function applyDeployEvent(event, s) {
 	}
 	return { kind: "continue" };
 }
-async function streamDeploy(client, projectId, formData, s) {
+async function streamDeploy(client, projectId, formData, s, cliLog) {
+	const startedAt = Date.now();
 	let deploymentId = null;
 	let interrupted = false;
+	cliLog?.info("stream_start", { projectId });
 	const onSigint = () => {
 		interrupted = true;
 		s.stop("Deploy interrupted");
 		if (deploymentId) R.info(`Deployment: ${deploymentId}`);
 		else R.info("Deployment id was not received before the interrupt.");
+		cliLog?.warn("stream_interrupted", { deploymentId });
+		cliLog?.close().catch(() => {});
 		process.exit(130);
 	};
 	process.once("SIGINT", onSigint);
 	try {
 		for await (const event of client.deploy(projectId, formData)) {
 			const result = applyDeployEvent(event, s);
-			if (result.kind === "start") deploymentId = result.deploymentId;
-			else if (result.kind === "done") return result.event;
-			else if (result.kind === "error") throw new DeployEventError(formatDeployFailureMessage(result.message, deploymentId));
+			if (result.kind === "start") {
+				deploymentId = result.deploymentId;
+				cliLog?.info("stream_deployment_id", { deploymentId });
+			} else if (result.kind === "done") {
+				cliLog?.info("deploy_success", {
+					deploymentId,
+					url: result.event.url,
+					assets: result.event.assets,
+					workers: result.event.workers,
+					durationMs: Date.now() - startedAt
+				});
+				return result.event;
+			} else if (result.kind === "error") {
+				cliLog?.error("deploy_server_error", void 0, {
+					deploymentId,
+					message: result.message
+				});
+				throw new DeployEventError(formatDeployFailureMessage(result.message, deploymentId, cliLog?.path ?? null));
+			}
 		}
 	} catch (err) {
 		if (err instanceof DeployEventError) throw err;
 		if (interrupted) throw err;
+		cliLog?.error("stream_deploy_caught", err, { deploymentId });
 		s.stop("Deploy failed");
-		throw formatStreamDeployError(err, deploymentId);
+		throw formatStreamDeployError(err, deploymentId, cliLog?.path ?? null);
 	} finally {
 		process.removeListener("SIGINT", onSigint);
 	}
+	cliLog?.warn("stream_no_terminal_event", { deploymentId });
 	s.stop("Deploy failed");
-	throw new Error(formatConnectionLostMessage(deploymentId));
+	throw new Error(formatConnectionLostMessage(deploymentId, cliLog?.path ?? null));
 }
 function formatKnownAssetSummary(result, skipped) {
 	const uploaded = result.assets - skipped;
 	return skipped > 0 ? `${result.assets} static asset(s) (${skipped} unchanged, ${uploaded} uploaded)` : `${result.assets} static asset(s)`;
 }
-async function runStaticDeploy(root, config, client, preset, skipBuild, commit, hashedAssetsPrefix, headerRules, redirectRules, fallbackRules, routing) {
+async function runStaticDeploy(root, config, client, preset, skipBuild, commit, hashedAssetsPrefix, headerRules, redirectRules, fallbackRules, routing, cliLog) {
 	const typeLabel = preset.appType === "spa" ? "Static SPA" : "Static Site";
 	R.info(`${typeLabel} deploy`);
+	cliLog?.info("deploy_mode", {
+		mode: "static",
+		appType: preset.appType
+	});
 	if (preset.buildCommand && !skipBuild) {
 		R.step("Building...");
+		cliLog?.info("build_start", { command: preset.buildCommand });
+		const buildStartedAt = Date.now();
 		execSync(preset.buildCommand, {
 			cwd: root,
 			stdio: "inherit"
 		});
-	}
+		cliLog?.info("build_end", { durationMs: Date.now() - buildStartedAt });
+	} else if (skipBuild) cliLog?.info("build_skipped", { reason: "skipBuild" });
 	if (!existsSync(preset.outputDir)) {
 		R.error(`deploy: Output directory '${preset.outputDir}' not found. Run the build first.`);
 		process.exit(1);
@@ -1793,17 +2024,29 @@ async function runStaticDeploy(root, config, client, preset, skipBuild, commit,
 	const s = createSpinner();
 	const onProgress = (msg) => s.message(msg);
 	s.start("Checking for changes...");
+	cliLog?.info("preflight_start", { dir: preset.outputDir });
 	const { assetManifest } = await collectAndHashAssets(preset.outputDir, onProgress);
 	const { needed, skipped } = await client.preflight(config.projectId, assetManifest);
 	s.stop("Checked for changes");
+	cliLog?.info("preflight_end", {
+		total: Object.keys(assetManifest).length,
+		needed: needed.length,
+		skipped
+	});
 	if (skipped > 0) R.info(`Skipping ${skipped} unchanged asset(s)`);
 	s.start("Packaging...");
+	cliLog?.info("package_start", { mode: "static" });
+	const packageStartedAt = Date.now();
 	const neededSet = skipped > 0 ? new Set(needed) : null;
 	const formData = await packageStaticBuild(preset.outputDir, preset.appType, neededSet, hashedAssetsPrefix ?? "assets", headerRules, redirectRules, fallbackRules, onProgress);
 	formData.append("assetManifest", JSON.stringify(assetManifest));
 	formData.append("source", getTokenSource());
 	if (commit) formData.append("commit", commit);
-	const result = await streamDeploy(client, config.projectId, formData, s);
+	cliLog?.info("package_end", {
+		mode: "static",
+		durationMs: Date.now() - packageStartedAt
+	});
+	const result = await streamDeploy(client, config.projectId, formData, s, cliLog);
 	Se([`${typeLabel} — ${formatKnownAssetSummary(result, skipped)}`].join("\n"), result.url);
 	ye("Done!");
 }
@@ -1821,17 +2064,24 @@ function warnRedundantForceOn3xx(count) {
 /**
 * Class B/C framework deploy: build with framework CLI, package with preset output paths.
 */
-async function runFrameworkDeploy(root, config, client, detected, fwPreset, voidConfig, skipBuild, commit) {
+async function runFrameworkDeploy(root, config, client, detected, fwPreset, voidConfig, skipBuild, commit, cliLog) {
 	R.info(`${detected.name} framework deploy`);
+	cliLog?.info("deploy_mode", {
+		mode: "framework",
+		framework: detected.name
+	});
 	const dialect = getDatabaseDialect(voidConfig);
 	const buildCmd = voidConfig.inference?.build ?? formatProjectCommand(root, fwPreset.buildCommand);
 	if (!skipBuild) {
 		R.step(`Building (${buildCmd})...`);
+		cliLog?.info("build_start", { command: buildCmd });
+		const buildStartedAt = Date.now();
 		execSync(voidConfig.inference?.build ?? resolveProjectCommand(root, fwPreset.buildCommand), {
 			cwd: root,
 			stdio: "inherit"
 		});
-	}
+		cliLog?.info("build_end", { durationMs: Date.now() - buildStartedAt });
+	} else cliLog?.info("build_skipped", { reason: "skipBuild" });
 	const workerDir = join(root, fwPreset.workerDir);
 	const assetsDir = join(root, fwPreset.assetsDir);
 	const frameworkAssetIgnorePatterns = fwPreset.workerDir === fwPreset.assetsDir && fwPreset.workerMain === "_worker.js" ? [`/${fwPreset.workerMain}`, "/_routes.json"] : [];
@@ -1931,11 +2181,22 @@ async function runFrameworkDeploy(root, config, client, detected, fwPreset, void
 	const s = createSpinner();
 	const onProgress = (msg) => s.message(msg);
 	s.start("Checking for changes...");
+	cliLog?.info("preflight_start", { dir: assetsDir });
 	const { assetManifest } = await collectAndHashAssets(assetsDir, onProgress, { ignorePatterns: frameworkAssetIgnorePatterns });
 	const { needed, skipped } = await client.preflight(config.projectId, assetManifest, true);
 	s.stop("Checked for changes");
+	cliLog?.info("preflight_end", {
+		total: Object.keys(assetManifest).length,
+		needed: needed.length,
+		skipped
+	});
 	if (skipped > 0) R.info(`Skipping ${skipped} unchanged asset(s)`);
 	s.start("Packaging...");
+	cliLog?.info("package_start", {
+		mode: "framework",
+		framework: detected.name
+	});
+	const packageStartedAt = Date.now();
 	const neededSet = skipped > 0 ? new Set(needed) : null;
 	const formData = await packageFrameworkBuild({
 		frameworkName: detected.name,
@@ -1969,7 +2230,11 @@ async function runFrameworkDeploy(root, config, client, detected, fwPreset, void
 	formData.append("assetManifest", JSON.stringify(assetManifest));
 	formData.append("source", getTokenSource());
 	if (commit) formData.append("commit", commit);
-	const result = await streamDeploy(client, config.projectId, formData, s);
+	cliLog?.info("package_end", {
+		mode: "framework",
+		durationMs: Date.now() - packageStartedAt
+	});
+	const result = await streamDeploy(client, config.projectId, formData, s, cliLog);
 	const summary = [`${result.workers} worker module(s), ${formatKnownAssetSummary(result, skipped)}`];
 	if (result.migrations) summary.push(`${result.migrations} migration(s) applied`);
 	if (schedules.length > 0) summary.push(`${schedules.length} cron job(s) scheduled`);
@@ -1982,10 +2247,16 @@ async function runFrameworkDeploy(root, config, client, detected, fwPreset, void
 	cleanupWrapper(root);
 	ye("Done!");
 }
-async function runFullDeploy(root, config, client, fwPreset, skipBuild, commit, detected) {
+async function runFullDeploy(root, config, client, fwPreset, skipBuild, commit, detected, cliLog) {
+	cliLog?.info("deploy_mode", {
+		mode: "full",
+		framework: detected?.name
+	});
 	if (!skipBuild) {
 		const buildCmd = formatProjectCommand(root, "vite build");
 		R.step(`Building (${buildCmd})...`);
+		cliLog?.info("build_start", { command: buildCmd });
+		const buildStartedAt = Date.now();
 		try {
 			execSync(resolveProjectCommand(root, "vite build"), {
 				cwd: root,
@@ -1995,10 +2266,12 @@ async function runFullDeploy(root, config, client, fwPreset, skipBuild, commit,
 					VOID_DEPLOY_PROJECT_ID: config.projectId
 				}
 			});
+			cliLog?.info("build_end", { durationMs: Date.now() - buildStartedAt });
 		} catch (err) {
+			cliLog?.error("build_failed", err, { durationMs: Date.now() - buildStartedAt });
 			process.exit(getExitCode(err));
 		}
-	}
+	} else cliLog?.info("build_skipped", { reason: "skipBuild" });
 	const frameworkBuildCmd = fwPreset ? formatProjectCommand(root, fwPreset.buildCommand) : void 0;
 	const distDir = resolveDistDir(root, fwPreset, frameworkBuildCmd);
 	let assetsPrefix = "assets";
@@ -2112,11 +2385,12 @@ async function runFullDeploy(root, config, client, fwPreset, skipBuild, commit,
 	if (deployConfig.output === "static" && pageScan && !isSsr) {
 		if (pageScan.pages.every((p) => p.prerender && (p.params.length === 0 && !p.catchAll || p.hasGetPrerenderPaths)) && !(hasRoutes || hasMiddleware || hasWebSockets || authEnabled) && schedules.length === 0 && queues.length === 0) {
 			R.info("All pages prerendered — deploying as static site");
+			cliLog?.info("full_to_static_redirect", { reason: "all_pages_prerendered" });
 			return runStaticDeploy(root, config, client, {
 				buildCommand: null,
 				outputDir: clientDir,
 				appType: "static"
-			}, true, commit, assetsPrefix, headerRules, redirectRules, fallbackRules);
+			}, true, commit, assetsPrefix, headerRules, redirectRules, fallbackRules, void 0, cliLog);
 		}
 	}
 	const uniquePrerenderPaths = deployConfig.output === "static" || isFrameworkMode ? [] : isNodeTarget(deployConfig.target) ? await collectPrerenderPathsNode({
@@ -2146,11 +2420,27 @@ async function runFullDeploy(root, config, client, fwPreset, skipBuild, commit,
 		authEnabled
 	});
 	s.start("Checking for changes...");
+	cliLog?.info("preflight_start", { dir: clientDir });
 	const { assetManifest } = await collectAndHashAssets(clientDir, onProgress);
 	const { needed, skipped } = await client.preflight(config.projectId, assetManifest, true);
 	s.stop("Checked for changes");
+	cliLog?.info("preflight_end", {
+		total: Object.keys(assetManifest).length,
+		needed: needed.length,
+		skipped
+	});
 	if (skipped > 0) R.info(`Skipping ${skipped} unchanged asset(s)`);
 	s.start("Packaging...");
+	cliLog?.info("package_start", {
+		mode: "full",
+		isSsr,
+		hasRoutes,
+		hasMiddleware,
+		hasWebSockets,
+		authEnabled,
+		framework: detected?.name
+	});
+	const packageStartedAt = Date.now();
 	const neededSet = skipped > 0 ? new Set(needed) : null;
 	const formData = await packageBuild(distDir, workerDirName, effectiveBindings, validatedMigrations, schedules, isSsr || hasRoutes || hasMiddleware || hasWebSockets || authEnabled, isFrameworkMode ? detected.name : void 0, revalidate, envVars, queues, uniquePrerenderPaths, assetConfig, {
 		compatibilityDate: wranglerCompat?.compatibilityDate,
@@ -2161,7 +2451,11 @@ async function runFullDeploy(root, config, client, fwPreset, skipBuild, commit,
 	formData.append("assetManifest", JSON.stringify(assetManifest));
 	formData.append("source", getTokenSource());
 	if (commit) formData.append("commit", commit);
-	const result = await streamDeploy(client, config.projectId, formData, s);
+	cliLog?.info("package_end", {
+		mode: "full",
+		durationMs: Date.now() - packageStartedAt
+	});
+	const result = await streamDeploy(client, config.projectId, formData, s, cliLog);
 	const summary = [`${result.workers} worker module(s), ${formatKnownAssetSummary(result, skipped)}`];
 	if (result.migrations) summary.push(`${result.migrations} migration(s) applied`);
 	if (schedules.length > 0) summary.push(`${schedules.length} cron job(s) scheduled`);
@@ -2174,8 +2468,9 @@ async function runFullDeploy(root, config, client, fwPreset, skipBuild, commit,
 	Se(summary.join("\n"), result.url);
 	ye("Done!");
 }
-async function createProjectFromSlug(root, client, slug) {
+async function createProjectFromSlug(root, client, slug, cliLog) {
 	R.step(`Creating project ${import_picocolors.default.blue(slug)}...`);
+	cliLog?.info("project_create_start", { slug });
 	const project = await client.createProject(slug);
 	const config = {
 		projectId: project.id,
@@ -2183,6 +2478,10 @@ async function createProjectFromSlug(root, client, slug) {
 	};
 	writeProjectConfig(root, config);
 	R.success(`Project created: ${import_picocolors.default.blue(config.slug)}`);
+	cliLog?.info("project_create_success", {
+		projectId: config.projectId,
+		slug: config.slug
+	});
 	return config;
 }
 function getGitCommit(root) {

package/dist/{domain-BGofcQ6I.mjs → domain-B-fIU3VE.mjs}

@@ -1,7 +1,7 @@
 import { s as import_picocolors } from "./output-BwlcIYSR.mjs";
 import { c as R, u as Se } from "./dist-Dayj3gCK.mjs";
 import { r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 //#region src/cli/domain.ts
 async function runDomainCommand(root, args) {
 	const token = getToken(root);

package/dist/{env-CyG3tvU0.mjs → env-BwbZJd2x.mjs}

@@ -2,7 +2,7 @@ import { a as join } from "./pathe.M-eThtNZ-D-kmWkCS.mjs";
 import { n as cliTitle } from "./output-BwlcIYSR.mjs";
 import { c as R, g as ge, u as Se, y as ye } from "./dist-Dayj3gCK.mjs";
 import { r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 import { n as generateEnvTypes, t as findEnvFile } from "./env-types-DknSA4SO.mjs";
 import { a as loadUserEnvFile, i as validateProdEnv, n as formatEnvReport, t as fetchRemoteSecretNames } from "./env-validation-DJKjR_8q.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";

package/dist/index.mjs

@@ -3,8 +3,8 @@ import { a as join, n as dirname, o as relative } from "./pathe.M-eThtNZ-D-kmWkC
 import { u as require_picocolors } from "./output-BwlcIYSR.mjs";
 import { n as loadVoidAuthConfig, t as findVoidAuthConfig } from "./config-CvHtTM0q.mjs";
 import { r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { l as isStagingMode, s as getToken } from "./client-snXOjrp1.mjs";
-import { _ as resolveSandboxConfig, a as prerenderPagesNode, c as filterLoadedEnv, d as ensureWranglerCompatibilityDate, f as ensureWranglerNodejsAlsFlag, g as isSandboxEnabled, h as SANDBOX_MIGRATION_TAG, i as prerenderPages, l as resolveRemoteMode, m as syncWranglerBindings, n as resolveDistDir, o as DEFAULT_PROXY_URL, p as readWranglerCompat, r as resolveWorkerDirName, s as STAGING_PROXY_URL, u as stripInternalEnvKeys } from "./deploy-BPKblFx6.mjs";
+import { l as isStagingMode, s as getToken } from "./client-BUdfE3QJ.mjs";
+import { _ as resolveSandboxConfig, a as prerenderPagesNode, c as filterLoadedEnv, d as ensureWranglerCompatibilityDate, f as ensureWranglerNodejsAlsFlag, g as isSandboxEnabled, h as SANDBOX_MIGRATION_TAG, i as prerenderPages, l as resolveRemoteMode, m as syncWranglerBindings, n as resolveDistDir, o as DEFAULT_PROXY_URL, p as readWranglerCompat, r as resolveWorkerDirName, s as STAGING_PROXY_URL, u as stripInternalEnvKeys } from "./deploy-BqXz1ycW.mjs";
 import { c as getDatabaseDialect, f as readConfig, l as isNodeTarget, p as resolveBindingNames } from "./config-BIa9HwVX.mjs";
 import { i as scanJobsSync, n as scanWebSocketRoutesSync, r as scanQueuesSync, t as scanRoutes } from "./scan-C6HMEIdW.mjs";
 import { a as SSR_SERVER_ENTRY_RELATIVE_PATHS, c as validateSsrEntry, d as isIdentifier, f as isLiteral, h as walk, i as SSR_CLIENT_ENTRY_RELATIVE_PATHS, l as inferBindingsFromSource, n as detectFramework, p as isMemberExpression, r as inferProjectBindings, s as validateSsrEntries, t as FRAMEWORK_SCAN_DIRS } from "./plugin-inference-oZ6Ybu2_.mjs";
@@ -4154,7 +4154,7 @@ const STAGING_API_URL = "https://api.staging.void.cloud";
 */
 async function runAiSetupPrompt(root, token, staging, server) {
 	const { select, text, isCancel, log } = await import("./dist-Dayj3gCK.mjs").then((n) => n.p);
-	const { PlatformClient } = await import("./client-snXOjrp1.mjs").then((n) => n.r);
+	const { PlatformClient } = await import("./client-BUdfE3QJ.mjs").then((n) => n.r);
 	const { writeProjectConfig } = await import("./project-TqORyHn8.mjs").then((n) => n.n);
 	const { inferDefaultSlug } = await import("./resolve-project-Br5BR03U.mjs").then((n) => n.i);
 	const client = new PlatformClient(token, staging ? STAGING_API_URL : DEFAULT_API_URL);

package/dist/{init-C7wS5iGP.mjs → init-Bb_Qsdq6.mjs}

@@ -2,15 +2,15 @@ import { a as join, i as isAbsolute, n as dirname, o as relative, s as resolve,
 import { n as cliTitle } from "./output-BwlcIYSR.mjs";
 import { _ as me, c as R, g as ge, i as Ee, u as Se, v as ue, x as q, y as ye } from "./dist-Dayj3gCK.mjs";
 import { a as writeProjectConfig, r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { l as isStagingMode, n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { l as isStagingMode, n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 import { c as getDatabaseDialect, f as readConfig } from "./config-BIa9HwVX.mjs";
 import { n as detectFramework } from "./plugin-inference-oZ6Ybu2_.mjs";
 import { r as parseDotenvFile, t as expandDotenv } from "./dotenv-DwO4ti0Z.mjs";
 import { n as ensureProjectTsconfig, t as createProjectTsconfig } from "./project-tsconfig-DfkESbDL.mjs";
 import { t as MagicString } from "./magic-string.es-D6g9UnIy.mjs";
 import { n as writeDrizzleConfig } from "./config-BzM9Dy7T.mjs";
-import { n as promptProjectSelection, t as promptAndCreateProject } from "./create-project-BIA15W7z.mjs";
-import { t as promptForLoginToken } from "./login-CkcXUiIu.mjs";
+import { n as promptProjectSelection, t as promptAndCreateProject } from "./create-project-CN1pF-OQ.mjs";
+import { t as promptForLoginToken } from "./login-RWUDCfdx.mjs";
 import { r as formatProjectCommand } from "./preset-D4I73kT4.mjs";
 import { n as getAgentById, r as getPackageDir, t as detectAgents } from "./cli/cli.mjs";
 import { n as findInstalledYarnPnpRuntime, r as hasLocalLockfile, t as buildDrizzleKitSpawnEnv } from "./yarn-pnp-BFqMV_bl.mjs";

package/dist/{link-p2R6NbgN.mjs → link-D4d26PCm.mjs}

@@ -1,8 +1,8 @@
 import { n as cliTitle, s as import_picocolors } from "./output-BwlcIYSR.mjs";
 import { _ as me, c as R, g as ge, y as ye } from "./dist-Dayj3gCK.mjs";
 import { a as writeProjectConfig, r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, o as getSiteDomain, s as getToken } from "./client-snXOjrp1.mjs";
-import { n as promptProjectSelection, t as promptAndCreateProject } from "./create-project-BIA15W7z.mjs";
+import { n as PlatformClient, o as getSiteDomain, s as getToken } from "./client-BUdfE3QJ.mjs";
+import { n as promptProjectSelection, t as promptAndCreateProject } from "./create-project-CN1pF-OQ.mjs";
 //#region src/cli/link.ts
 async function runLink(root, slug) {
 	console.log();

package/dist/{list-Bfel-QLc.mjs → list-bQc1eQCZ.mjs}

@@ -1,7 +1,7 @@
 import { a as ensureUtc, i as dim, l as tablePrefix, n as cliTitle, s as import_picocolors } from "./output-BwlcIYSR.mjs";
 import { c as R, g as ge, y as ye } from "./dist-Dayj3gCK.mjs";
 import { r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 import { r as resolveProjectBySlug } from "./resolve-project-Br5BR03U.mjs";
 //#region src/cli/list.ts
 async function runListCommand(root, slug) {

package/dist/{login-CkcXUiIu.mjs → login-RWUDCfdx.mjs}

@@ -1,6 +1,6 @@
 import { n as cliTitle, r as createSpinner, s as import_picocolors } from "./output-BwlcIYSR.mjs";
 import { _ as me, c as R, g as ge, i as Ee, x as q, y as ye } from "./dist-Dayj3gCK.mjs";
-import { c as getTokenSource, d as runLogin, f as saveToken, i as isExpiredTokenError, l as isStagingMode, n as PlatformClient, s as getToken, u as removeToken } from "./client-snXOjrp1.mjs";
+import { c as getTokenSource, d as runLogin, f as saveToken, i as isExpiredTokenError, l as isStagingMode, n as PlatformClient, s as getToken, u as removeToken } from "./client-BUdfE3QJ.mjs";
 //#region src/cli/login.ts
 async function promptForLoginToken(root = process.cwd()) {
 	const provider = await Ee({

package/dist/{logs-DmkrRvx6.mjs → logs-DrkTklop.mjs}

@@ -1,7 +1,7 @@
 import { i as dim, n as cliTitle, s as import_picocolors } from "./output-BwlcIYSR.mjs";
 import { c as R, g as ge, y as ye } from "./dist-Dayj3gCK.mjs";
 import { r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 //#region src/cli/logs.ts
 async function runLogsCommand(root, filter, range, deployment, level) {
 	console.log();

package/dist/{mcp-CaQzfeUi.mjs → mcp-kZ4zg13a.mjs}

@@ -1,6 +1,6 @@
 import { a as join, n as dirname } from "./pathe.M-eThtNZ-D-kmWkCS.mjs";
 import { a as writeProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { createInterface } from "node:readline";

package/dist/{project-cmd-B7lQp3F3.mjs → project-cmd-ATFi3kRm.mjs}

@@ -1,6 +1,6 @@
 import { i as dim, l as tablePrefix, n as cliTitle, s as import_picocolors } from "./output-BwlcIYSR.mjs";
 import { c as R, g as ge, y as ye } from "./dist-Dayj3gCK.mjs";
-import { n as PlatformClient, o as getSiteDomain, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, o as getSiteDomain, s as getToken } from "./client-BUdfE3QJ.mjs";
 //#region src/cli/projects.ts
 async function runProjectsCommand(root) {
 	console.log();
@@ -34,32 +34,32 @@ async function runProjectsCommand(root) {
 //#region src/cli/project-cmd.ts
 async function runProjectCommand(root, args) {
 	if (args.subcommand === "status") {
-		const { runListCommand } = await import("./list-Bfel-QLc.mjs");
+		const { runListCommand } = await import("./list-bQc1eQCZ.mjs");
 		return runListCommand(root, args.name || void 0);
 	}
 	if (args.subcommand === "link") {
-		const { runLink } = await import("./link-p2R6NbgN.mjs");
+		const { runLink } = await import("./link-D4d26PCm.mjs");
 		return runLink(root, args.name || void 0);
 	}
 	if (args.subcommand === "list") return runProjectsCommand(root);
 	if (args.subcommand === "logs") {
-		const { runLogsCommand } = await import("./logs-DmkrRvx6.mjs");
+		const { runLogsCommand } = await import("./logs-DrkTklop.mjs");
 		return runLogsCommand(root, args.filter, args.range, args.deployment || void 0, args.level || void 0);
 	}
 	if (args.subcommand === "rollback") {
-		const { runRollbackCommand } = await import("./rollback-gyC59l7U.mjs");
+		const { runRollbackCommand } = await import("./rollback-BSyita3C.mjs");
 		return runRollbackCommand(root, args.deployId || void 0);
 	}
 	if (args.subcommand === "cancel") {
-		const { runCancelDeployCommand } = await import("./cancel-deploy-BOBTqqh0.mjs");
+		const { runCancelDeployCommand } = await import("./cancel-deploy-D9OFt5gA.mjs");
 		return runCancelDeployCommand(root, args.deployId || void 0);
 	}
 	if (args.subcommand === "delete") {
-		const { runDeleteCommand } = await import("./delete-DAP6yDc7.mjs");
+		const { runDeleteCommand } = await import("./delete-DJTvwbr-.mjs");
 		return runDeleteCommand(root, args.name || void 0, { force: args.force });
 	}
 	if (args.subcommand === "purge-cache") {
-		const { runPurgeCacheCommand } = await import("./cache-W82I8ihI.mjs");
+		const { runPurgeCacheCommand } = await import("./cache-B0BgSTZi.mjs");
 		return runPurgeCacheCommand(root, args.projectSlug || void 0);
 	}
 }

package/dist/{rollback-gyC59l7U.mjs → rollback-BSyita3C.mjs}

@@ -1,7 +1,7 @@
 import { a as ensureUtc, i as dim, n as cliTitle, r as createSpinner, s as import_picocolors } from "./output-BwlcIYSR.mjs";
 import { _ as me, c as R, g as ge, i as Ee, v as ue, x as q, y as ye } from "./dist-Dayj3gCK.mjs";
 import { r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 //#region src/cli/rollback.ts
 async function runRollbackCommand(root, deployId) {
 	console.log();

package/dist/{secret-CeRSukgM.mjs → secret-DmjBDxB1.mjs}

@@ -1,7 +1,7 @@
 import { n as cliTitle } from "./output-BwlcIYSR.mjs";
 import { _ as me, c as R, g as ge, n as Ce, u as Se, v as ue, x as q, y as ye } from "./dist-Dayj3gCK.mjs";
 import { r as readProjectConfig } from "./project-TqORyHn8.mjs";
-import { n as PlatformClient, s as getToken } from "./client-snXOjrp1.mjs";
+import { n as PlatformClient, s as getToken } from "./client-BUdfE3QJ.mjs";
 import { r as resolveProjectBySlug, t as getRequestedProjectSlug } from "./resolve-project-Br5BR03U.mjs";
 import { readFileSync } from "node:fs";
 //#region src/cli/secret.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "void",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/voidzero-dev/void.git",
@@ -307,7 +307,7 @@
     "valibot": ">=1.0.0-beta.7",
     "vite": "^8.0.0",
     "zod": "^3.25.0 || ^4.0.0",
-    "@void/md": "0.7.0"
+    "@void/md": "0.7.1"
   },
   "peerDependenciesMeta": {
     "@void/md": {

package/skills/void/docs/reference/cli.md

@@ -203,19 +203,22 @@ If `--project` is provided, purges that project's cache instead of the linked pr
 ### `void deploy`
 
 ```
-void deploy [--project <name>] [--dir <path>] [--spa] [--skip-build]
+void deploy [--project <name>] [--dir <path>] [--spa] [--skip-build] [--debug]
 ```
 
 Auto-detects your project type and chooses the right pipeline. See [Supported App Types](../guide/app-types.md) and [Deployment](../guide/deployment.md) for details.
 
 For Drizzle projects, deploy performs a read-only schema drift check. If a new migration would be generated, deploy stops and tells you to run `void db generate`, review the migration, commit it yourself, and rerun `void deploy`.
 
-| Flag               | Purpose                                           |
-| ------------------ | ------------------------------------------------- |
-| `--project <name>` | Target a specific project by slug                 |
-| `--dir <path>`     | Deploy a pre-built static directory (skips build) |
-| `--spa`            | Use SPA mode instead of SSG for static deploys    |
-| `--skip-build`     | Skip the build step (use existing build output)   |
+| Flag               | Purpose                                                                      |
+| ------------------ | ---------------------------------------------------------------------------- |
+| `--project <name>` | Target a specific project by slug                                            |
+| `--dir <path>`     | Deploy a pre-built static directory (skips build)                            |
+| `--spa`            | Use SPA mode instead of SSG for static deploys                               |
+| `--skip-build`     | Skip the build step (use existing build output)                              |
+| `--debug`          | Mirror the structured deploy log to stderr (also written to `~/.void/logs/`) |
+
+Every deploy writes a structured JSONL trace to `~/.void/logs/deploy-<timestamp>.jsonl` regardless of `--debug`. On failure the path is printed at the end of the error message so you can attach it when reporting platform issues. `VOID_DEPLOY_DEBUG=1` is accepted as an alternate trigger for stderr mirroring.
 
 Project resolution precedence: