onveloz 0.0.0-beta.26 → 0.0.0-beta.27

package/dist/{deploy-tui-DGRYRsf_.mjs → deploy-tui-D_pzq4Tu.mjs}

@@ -27,6 +27,25 @@ function buildStageOrder(steps) {
 	}
 	return order;
 }
+/** Matches the pre-start log section header written by the reconciler. */
+const PRE_START_HEADER_RE = /^──\s*Logs do comando pre-start/;
+/** Matches the pre-start unavailable message. */
+const PRE_START_UNAVAILABLE_RE = /^──\s*Logs do comando pre-start indisponíveis/;
+/** Matches the crash log section header written by the reconciler. */
+const CRASH_LOG_HEADER_RE = /^──\s*Logs do container \(crash\)/;
+/** Matches the crash logs unavailable message. */
+const CRASH_LOG_UNAVAILABLE_RE = /^──\s*Logs do container indisponíveis/;
+/** Lines that mark the beginning of the deploy/rollout phase. */
+const DEPLOY_PHASE_MARKERS = [
+	/^Realizando deploy/,
+	/^Atualizando serviço/,
+	/^Criando serviço/,
+	/^Waiting for rollout/,
+	/^Updating deployment/,
+	/^Creating K8s deployment/
+];
+/** Lines that indicate the pre-start command is starting. */
+const PRE_START_MARKER_RE = /^Executando comando pre-start:/;
 const RUNTIME_LINE_PATTERNS = [
 	/^[\u26A0\u{1F680}]/u,
 	/^\{.*"(?:level|msg|pid)"/,
@@ -40,6 +59,14 @@ const RUNTIME_LINE_PATTERNS = [
 function isRuntimeLine(content) {
 	return RUNTIME_LINE_PATTERNS.some((p) => p.test(content.trim()));
 }
+function isPreStartLine(content) {
+	const trimmed = content.trim();
+	return PRE_START_MARKER_RE.test(trimmed) || PRE_START_HEADER_RE.test(trimmed) || PRE_START_UNAVAILABLE_RE.test(trimmed);
+}
+function isDeployPhaseLine(content) {
+	const trimmed = content.trim();
+	return DEPLOY_PHASE_MARKERS.some((p) => p.test(trimmed)) || CRASH_LOG_HEADER_RE.test(trimmed) || CRASH_LOG_UNAVAILABLE_RE.test(trimmed);
+}
 function parseBuildSteps(rawText) {
 	const rawLines = rawText.split("\n");
 	let currentPhase = 0;
@@ -172,22 +199,61 @@ function parseBuildSteps(rawText) {
 		generalCount++;
 		const generalStep = allSteps[entry.origIdx];
 		if (generalCount === totalGenerals && totalGenerals > 1) {
+			const finalizationLines = [];
+			const preStartLines = [];
 			const deployLines = [];
 			const healthLines = [];
-			let hitRuntime = false;
+			let phase = "finalization";
+			let inCrashLogBlock = false;
 			for (const line of generalStep.lines) {
-				if (!hitRuntime && isRuntimeLine(line.content)) hitRuntime = true;
-				if (hitRuntime) healthLines.push(line);
-				else deployLines.push(line);
+				const content = line.content.trim();
+				if (CRASH_LOG_HEADER_RE.test(content) || PRE_START_HEADER_RE.test(content)) inCrashLogBlock = true;
+				if (phase === "finalization" && isPreStartLine(content)) phase = "prestart";
+				else if ((phase === "finalization" || phase === "prestart") && isDeployPhaseLine(content)) phase = "deploy";
+				else if ((phase === "finalization" || phase === "deploy") && !inCrashLogBlock && isRuntimeLine(content)) phase = "health";
+				switch (phase) {
+					case "finalization":
+						finalizationLines.push(line);
+						break;
+					case "prestart":
+						preStartLines.push(line);
+						break;
+					case "deploy":
+						deployLines.push(line);
+						break;
+					case "health":
+						healthLines.push(line);
+						break;
+				}
 			}
-			if (deployLines.length > 0) result.push({
+			const hasPreStartError = preStartLines.some((l) => /pre-start falhou|FAILED/i.test(l.content));
+			const hasDeployError = deployLines.some((l) => /DEPLOY FAILED/i.test(l.content));
+			if (finalizationLines.length > 0) result.push({
 				stepNumber: null,
 				title: "Finalização",
 				duration: null,
 				status: "done",
+				lines: finalizationLines,
+				phase: generalStep.phase,
+				startedAt: finalizationLines[0]?.timestamp ?? generalStep.startedAt
+			});
+			if (preStartLines.length > 0) result.push({
+				stepNumber: null,
+				title: "Pre-start",
+				duration: null,
+				status: hasPreStartError ? "error" : "done",
+				lines: preStartLines,
+				phase: generalStep.phase,
+				startedAt: preStartLines[0]?.timestamp ?? null
+			});
+			if (deployLines.length > 0) result.push({
+				stepNumber: null,
+				title: "Deploy",
+				duration: null,
+				status: hasDeployError ? "error" : "done",
 				lines: deployLines,
 				phase: generalStep.phase,
-				startedAt: deployLines[0]?.timestamp ?? generalStep.startedAt
+				startedAt: deployLines[0]?.timestamp ?? null
 			});
 			if (healthLines.length > 0) result.push({
 				stepNumber: null,

package/dist/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { Cli, middleware, z } from "incur";
-import { exec, execFile, execSync } from "node:child_process";
+import { exec, execSync } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { z as z$1 } from "zod";
@@ -9,11 +9,11 @@ import { RPCLink } from "@orpc/client/fetch";
 import { createHash } from "node:crypto";
 import { homedir, platform, tmpdir } from "node:os";
 import chalk from "chalk";
+import { createAuthClient } from "better-auth/client";
+import { deviceAuthorizationClient } from "better-auth/client/plugins";
 import * as readline from "node:readline";
 import { createInterface } from "node:readline";
 import ora from "ora";
-import { createAuthClient } from "better-auth/client";
-import { deviceAuthorizationClient } from "better-auth/client/plugins";
 import net from "node:net";
 import WebSocket from "ws";
 import { link, mkdir, mkdtemp, readdir, rm, stat } from "node:fs/promises";
@@ -761,13 +761,17 @@ async function promptMultiSelect(question, options) {
 	}
 	return indices.map((i) => options[i].value);
 }
+function openBrowser(url) {
+	return new Promise((resolve$1) => {
+		const os = platform();
+		exec(os === "darwin" ? `open "${url}"` : os === "win32" ? `start "" "${url}"` : `xdg-open "${url}"`, (error) => {
+			resolve$1(!error);
+		});
+	});
+}
 
 //#endregion
 //#region src/commands/login.ts
-function openBrowser$1(url) {
-	const os = platform();
-	exec(os === "darwin" ? `open "${url}"` : os === "win32" ? `start "" "${url}"` : `xdg-open "${url}"`, () => {});
-}
 const CLIENT_ID = "veloz-cli";
 async function performLogin(apiUrl) {
 	const config = loadConfig$1();
@@ -789,10 +793,15 @@ async function performLogin(apiUrl) {
 	console.log();
 	console.log(chalk.white(`  Código de verificação: ${chalk.bold.cyan(data.user_code)}`));
 	console.log();
-	console.log(chalk.dim("  Se o navegador não abrir, acesse manualmente:"));
-	console.log(chalk.dim(`  ${verificationUrl}`));
+	if (!await openBrowser(verificationUrl)) {
+		info("Não foi possível abrir o navegador. Acesse manualmente:");
+		console.log();
+		console.log(`  ${chalk.bold(verificationUrl)}`);
+	} else {
+		console.log(chalk.dim("  Se o navegador não abrir, acesse manualmente:"));
+		console.log(chalk.dim(`  ${verificationUrl}`));
+	}
 	console.log();
-	openBrowser$1(verificationUrl);
 	const pollSpinner = spinner("Aguardando autorização no navegador...");
 	const token = await pollForToken(authClient, data.device_code, data.interval || 5);
 	if (!token) {
@@ -1179,7 +1188,7 @@ envGroup.command("list", {
 		serviceName: z.string(),
 		vars: z.array(z.object({
 			key: z.string(),
-			maskedValue: z.string(),
+			value: z.string(),
 			updatedAt: z.string()
 		}))
 	})),
@@ -1202,12 +1211,15 @@ envGroup.command("list", {
 				});
 				continue;
 			}
-			for (const v of envVars) console.log(`  ${chalk.bold(v.key)}  ${chalk.dim(v.maskedValue)}  ${new Date(v.updatedAt).toLocaleDateString("pt-BR")}`);
+			for (const v of envVars) {
+				const displayValue = v.value ?? v.maskedValue;
+				console.log(`  ${chalk.bold(v.key)}  ${chalk.dim(displayValue)}  ${new Date(v.updatedAt).toLocaleDateString("pt-BR")}`);
+			}
 			result.push({
 				serviceName: service.name,
 				vars: envVars.map((v) => ({
 					key: v.key,
-					maskedValue: v.maskedValue,
+					value: v.value ?? v.maskedValue,
 					updatedAt: v.updatedAt instanceof Date ? v.updatedAt.toISOString() : String(v.updatedAt)
 				}))
 			});
@@ -1379,7 +1391,7 @@ envGroup.command("export", {
 	options: z.object({ service: z.string().optional().describe("Serviço alvo (chave ou nome)") }),
 	output: z.object({ vars: z.array(z.object({
 		key: z.string(),
-		maskedValue: z.string()
+		value: z.string()
 	})) }),
 	async run(c) {
 		const serviceId = await resolveServiceId(c.options.service);
@@ -1392,19 +1404,21 @@ envGroup.command("export", {
 			info("Nenhuma variável de ambiente para exportar.");
 			return { vars: [] };
 		}
-		const envContent = envVars.map((v) => `${v.key}=${v.maskedValue}`).join("\n");
+		const isDecrypted = envVars.some((v) => v.value !== null && v.value !== void 0);
+		const envContent = envVars.map((v) => `${v.key}=${v.value ?? v.maskedValue}`).join("\n");
 		if (c.args.arquivo) {
 			writeFileSync(resolve(process.cwd(), c.args.arquivo), envContent + "\n", "utf-8");
 			success(`Variáveis exportadas para ${chalk.bold(c.args.arquivo)}`);
-			console.log(chalk.dim("Nota: Valores estão mascarados por segurança."));
+			if (!isDecrypted) console.log(chalk.dim("Nota: Valores estão mascarados por segurança."));
 		} else {
-			console.log(chalk.bold("\n# Variáveis de Ambiente (valores mascarados)\n"));
+			if (isDecrypted) console.log(chalk.bold("\n# Variáveis de Ambiente\n"));
+			else console.log(chalk.bold("\n# Variáveis de Ambiente (valores mascarados)\n"));
 			console.log(envContent);
 			console.log();
 		}
 		return { vars: envVars.map((v) => ({
 			key: v.key,
-			maskedValue: v.maskedValue
+			value: v.value ?? v.maskedValue
 		})) };
 	}
 });
@@ -3985,12 +3999,6 @@ logsGroup.command("query-help", {
 
 //#endregion
 //#region src/commands/github.ts
-function openBrowser(url) {
-	const os = platform();
-	execFile(os === "darwin" ? "open" : os === "win32" ? "start" : "xdg-open", os === "win32" ? ["", url] : [url], (error) => {
-		if (error) warn(`Não foi possível abrir o navegador: ${error.message}`);
-	});
-}
 const githubGroup = Cli.create("github", { description: "Gerenciar integração com GitHub" });
 githubGroup.command("setup", {
 	description: "Configurar GitHub App para deploy automático via webhook",
@@ -4102,10 +4110,18 @@ githubGroup.command("setup", {
 				projectId
 			};
 		}
-		openBrowser(installation.installUrl);
+		const opened = await openBrowser(installation.installUrl);
 		console.log();
-		info("Aguardando instalação do GitHub App...");
-		console.log(chalk.dim("  Instale o app no navegador e volte aqui."));
+		if (opened) {
+			info("Aguardando instalação do GitHub App...");
+			console.log(chalk.dim("  Instale o app no navegador e volte aqui."));
+		} else {
+			info("Não foi possível abrir o navegador. Abra o link abaixo manualmente:");
+			console.log();
+			console.log(`  ${chalk.bold(installation.installUrl)}`);
+			console.log();
+			console.log(chalk.dim("  Instale o app e volte aqui."));
+		}
 		console.log();
 		const pollSpinner = spinner("Aguardando instalação...");
 		const maxAttempts = 60;
@@ -4258,6 +4274,25 @@ const TERMINAL_STATUSES = new Set([
 
 //#endregion
 //#region src/lib/deploy-stream.ts
+const DASHBOARD_BASE = process.env.VELOZ_WEB_URL || "https://app.onveloz.com";
+/**
+* Fetch deployment details from the API and enrich a DeployStreamResult
+* with metadata useful for agents (failReason, commit info, duration, dashboard link).
+*/
+async function enrichResult(client, result) {
+	try {
+		const d = await client.deployments.get({ deploymentId: result.deploymentId });
+		const service = await client.services.get({ serviceId: d.serviceId }).catch(() => null);
+		const projectId = service ? service.projectId : null;
+		result.failReason = d.failReason ?? null;
+		result.errorSummary = d.errorSummary ?? null;
+		result.commitSha = d.commitSha ?? null;
+		result.branch = d.branch ?? null;
+		if (d.startedAt && d.finishedAt) result.durationSeconds = Math.round((new Date(d.finishedAt).getTime() - new Date(d.startedAt).getTime()) / 1e3);
+		if (projectId) result.dashboardUrl = `${DASHBOARD_BASE}/projetos/${projectId}/servicos/${d.serviceId}/deploys/${d.id}`;
+	} catch {}
+	return result;
+}
 async function fetchDeployUrls$1(client, serviceId) {
 	try {
 		return (await client.domains.list({ serviceId })).map((d) => `https://${d.domain}`);
@@ -4397,7 +4432,7 @@ async function streamDeploymentLogs(deploymentId, serviceId, serviceName) {
 	const isTTY = !mcp && process.stdout.isTTY;
 	const isGHA = !mcp && process.env.GITHUB_ACTIONS === "true";
 	if (isTTY && !isVerbose) {
-		const { renderDeployTUI } = await import("./deploy-tui-DGRYRsf_.mjs");
+		const { renderDeployTUI } = await import("./deploy-tui-D_pzq4Tu.mjs");
 		return renderDeployTUI(deploymentId, serviceId, serviceName);
 	}
 	const allLogLines = [];
@@ -4470,13 +4505,13 @@ async function streamDeploymentLogs(deploymentId, serviceId, serviceName) {
 		}
 		if (!mcp) process.exit(1);
 	}
-	return {
+	return enrichResult(client, {
 		deploymentId,
 		status: finalStatus,
 		logs: allLogLines.filter((l) => l.trim()),
 		urls,
 		serviceName
-	};
+	});
 }
 
 //#endregion
@@ -5283,7 +5318,7 @@ const LOGO_LINES = [
 ];
 const BRAND_COLOR = "#FF4D00";
 function getVersion() {
-	return "0.0.0-beta.26";
+	return "0.0.0-beta.27";
 }
 function printBanner(subtitle) {
 	const version = getVersion();
@@ -6011,32 +6046,6 @@ function checkDockerfileLockFiles(basePath) {
 * and public/ and does not simplify the setup on this platform.
 */
 /**
-* Prisma needs `prisma generate` in the build step.
-* Without it, the Prisma client won't be generated and the app will crash.
-*/
-function checkPrismaGenerate(basePath) {
-	const pkgPath = resolve(basePath, "package.json");
-	if (!existsSync(pkgPath)) return null;
-	try {
-		const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-		const allDeps = {
-			...pkg.dependencies,
-			...pkg.devDependencies
-		};
-		if (!("prisma" in allDeps) && !("@prisma/client" in allDeps)) return null;
-		const scripts = pkg.scripts || {};
-		const buildScript = scripts.build || "";
-		const postinstall = scripts.postinstall || "";
-		if (buildScript.includes("prisma generate") || postinstall.includes("prisma generate") || buildScript.includes("prisma db push")) return null;
-		return {
-			message: "Prisma detectado mas prisma generate nao esta no build/postinstall",
-			hint: "Adicione \"prisma generate\" ao postinstall ou build → onveloz.com/docs/best-practices#prisma--prisma-generate-no-build"
-		};
-	} catch {
-		return null;
-	}
-}
-/**
 * Detect if the app hardcodes a port that doesn't match the configured port.
 * Common issue: app listens on 8080 but service port is 3000.
 */
@@ -6270,7 +6279,6 @@ function runPreDeployChecks(basePath = ".") {
 	const checks = [
 		checkNitroPreset,
 		checkDockerfileLockFiles,
-		checkPrismaGenerate,
 		checkPortMismatch,
 		checkEnvFileCommitted,
 		checkSvelteKitAdapter,
@@ -6333,24 +6341,50 @@ async function fetchLatestVersion() {
 		return null;
 	}
 }
-async function autoUpdate() {
-	if (process.env.VELOZ_MCP === "true") return;
-	const pm = detectPackageManager();
-	if (!pm) return;
-	const currentVersion = "0.0.0-beta.26";
-	const latestVersion = await fetchLatestVersion();
-	if (!latestVersion || latestVersion === currentVersion) return;
-	const installCmd = getInstallCommand(pm, latestVersion);
-	const spin = spinner(`Atualizando CLI ${chalk.dim(currentVersion)} → ${chalk.bold(latestVersion)}...`);
+function getCurrentVersion() {
+	return "0.0.0-beta.27";
+}
+/**
+* Install a specific CLI version. Returns true on success.
+*/
+function installVersion(pm, version) {
+	const installCmd = getInstallCommand(pm, version);
+	const spin = spinner(`Atualizando CLI ${chalk.dim(getCurrentVersion())} → ${chalk.bold(version)}...`);
 	try {
 		execSync(installCmd, { stdio: "ignore" });
 		spin.stop();
-		console.log(chalk.green(`\n✓ CLI atualizada: ${chalk.bold(latestVersion)}\n`));
+		console.log(chalk.green(`\n✓ CLI atualizada: ${chalk.bold(version)}\n`));
+		return true;
 	} catch {
 		spin.stop();
 		console.log(chalk.yellow(`\n⚠ Não foi possível atualizar automaticamente. Execute manualmente:\n  ${installCmd}\n`));
+		return false;
 	}
 }
+/**
+* Re-exec the CLI with the same args so the new binary runs.
+* Used after auto-update during `veloz deploy`.
+*/
+function reExec() {
+	execSync(`veloz ${process.argv.slice(2).join(" ")}`, {
+		stdio: "inherit",
+		env: {
+			...process.env,
+			VELOZ_SKIP_UPDATE: "true"
+		}
+	});
+	process.exit(0);
+}
+async function autoUpdate() {
+	if (process.env.VELOZ_MCP === "true") return;
+	if (process.env.VELOZ_SKIP_UPDATE === "true") return;
+	const pm = detectPackageManager();
+	if (!pm) return;
+	const currentVersion = getCurrentVersion();
+	const latestVersion = await fetchLatestVersion();
+	if (!latestVersion || latestVersion === currentVersion) return;
+	if (installVersion(pm, latestVersion)) reExec();
+}
 
 //#endregion
 //#region src/lib/deploy-databases.ts
@@ -6595,7 +6629,6 @@ function prepareServicesForDeploy(services) {
 	}
 	return services.map((svc) => {
 		const serviceConf = resolveServiceConf(velozConfig, svc.serviceId);
-		warnIfEphemeralFsDetected(detectLocalRepo(serviceConf?.rootDirectory || "."), serviceConf, svc.serviceName);
 		return {
 			serviceId: svc.serviceId,
 			serviceName: svc.serviceName,
@@ -6604,13 +6637,12 @@ function prepareServicesForDeploy(services) {
 		};
 	});
 }
-async function triggerDeploy(serviceId, serviceName, preDetection) {
+async function triggerDeploy(serviceId, serviceName) {
 	const sizeInBytes = await calculateDirectorySize(process.cwd());
 	const sizeMB = Math.round(sizeInBytes / (1024 * 1024) * 10) / 10;
 	const client = await getClient();
 	const velozConfig = loadConfig();
 	const serviceConf = resolveServiceConf(velozConfig, serviceId);
-	warnIfEphemeralFsDetected(preDetection ?? detectLocalRepo(), serviceConf, serviceName ?? void 0);
 	const warnings = runPreDeployChecks(serviceConf?.rootDirectory || ".");
 	if (warnings.length > 0) printDeployWarnings(warnings);
 	const spinUpload = spinner(serviceName ? `Fazendo upload ${chalk.bold(serviceName)}...` : "Fazendo upload do código...");
@@ -6637,25 +6669,6 @@ async function triggerDeploy(serviceId, serviceName, preDetection) {
 		untrackDeployment(deployment.id);
 	}
 }
-function warnIfEphemeralFsDetected(detection, serviceConf, serviceLabel) {
-	if (!detection.usesNodeFs || (serviceConf?.volumes?.length ?? 0) > 0) return;
-	warn(`Uso de fs/node:fs detectado${serviceLabel ? ` no serviço ${chalk.bold(serviceLabel)}` : ""}. O filesystem do container é efêmero; configure um volume em veloz.json ou use 'veloz volumes create'.`);
-}
-async function maybeConfigurePersistentVolume(serviceConfig, detection, opts, serviceLabel) {
-	if (!detection.usesNodeFs || (serviceConfig.volumes?.length ?? 0) > 0) return;
-	if (opts.yes) return;
-	if (!await promptConfirm(`Deseja adicionar um volume persistente para ${serviceLabel}?`, true)) return;
-	const name = await prompt(`Nome do volume ${chalk.dim("(data)")}:`) || "data";
-	const mountPath = await prompt(`Mount path ${chalk.dim("(/data)")}:`) || "/data";
-	const sizeInput = await prompt(`Tamanho em GB ${chalk.dim("(10)")}:`);
-	const parsedSize = Number.parseInt(sizeInput || "10", 10);
-	serviceConfig.volumes = [{
-		name,
-		mountPath,
-		sizeGb: Number.isInteger(parsedSize) && parsedSize >= 10 ? parsedSize : 10
-	}];
-	info(`Volume persistente configurado para ${serviceLabel}.`);
-}
 async function findServicesFromConfig() {
 	const config = loadConfig();
 	if (!config) return [];
@@ -6951,7 +6964,7 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 				if (newPort) app.port = parseInt(newPort, 10) || app.port;
 			}
 		}
-		let config$1 = {
+		let config = {
 			version: "1.0",
 			project: {
 				id: projectId,
@@ -6982,7 +6995,7 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 				service: service$1,
 				app
 			});
-			config$1.services[app.root] = {
+			config.services[app.root] = {
 				id: service$1.id,
 				name: service$1.name,
 				type: "web",
@@ -6994,21 +7007,20 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 					port: app.port ?? 3e3
 				}
 			};
-			await maybeConfigurePersistentVolume(config$1.services[app.root], detectLocalRepo(app.root), opts, app.name);
 		}
-		saveConfig(config$1);
+		saveConfig(config);
 		info(`Arquivo ${getConfigFileName()} criado na raiz do projeto.`);
 		if (!opts.yes) for (const { service: service$1, app } of createdServices) {
 			console.log(chalk.cyan(`\n── Configurando variáveis: ${app.name} ──\n`));
 			const serviceDetection = detectLocalRepo(app.root);
-			await promptEnvVars(service$1.id, serviceDetection.envVars.map((v) => v.key), config$1);
+			await promptEnvVars(service$1.id, serviceDetection.envVars.map((v) => v.key), config);
 		}
-		config$1 = await provisionDatabases(config$1, { yes: opts.yes ?? false });
+		config = await provisionDatabases(config, { yes: opts.yes ?? false });
 		await deployServices(createdServices.map(({ service: service$1, app }) => ({
 			serviceId: service$1.id,
 			serviceName: app.name,
 			projectId,
-			serviceConfig: resolveServiceConf(config$1, service$1.id)
+			serviceConfig: resolveServiceConf(config, service$1.id)
 		})), {
 			projectRoot: process.cwd(),
 			output: createDeployOutput()
@@ -7072,7 +7084,7 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 	});
 	success(`Serviço criado: ${chalk.bold(service.name)}`);
 	if (!opts.yes) await promptEnvVars(service.id, detection.envVars.map((v) => v.key), null);
-	const config = {
+	saveConfig({
 		version: "1.0",
 		project: {
 			id: projectId,
@@ -7094,9 +7106,7 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 			}
 		} },
 		created: (/* @__PURE__ */ new Date()).toISOString()
-	};
-	await maybeConfigurePersistentVolume(config.services.main, detection, opts, service.name);
-	saveConfig(config);
+	});
 	info(`Arquivo ${getConfigFileName()} criado na raiz do projeto.`);
 	return service.id;
 }
@@ -7286,7 +7296,6 @@ async function addServiceFlow(existingConfig, opts) {
 					port: app.port ?? 3e3
 				}
 			};
-			await maybeConfigurePersistentVolume(updatedConfig$1.services[configKey], detectLocalRepo(app.root), opts, serviceName);
 		}
 		const newServices = {};
 		for (const { app } of createdServices) {
@@ -7401,7 +7410,6 @@ async function addServiceFlow(existingConfig, opts) {
 		},
 		updated: (/* @__PURE__ */ new Date()).toISOString()
 	};
-	await maybeConfigurePersistentVolume(updatedConfig.services[serviceKey], detection, opts, service.name);
 	const newServiceEntry = updatedConfig.services[serviceKey];
 	patchConfig((raw) => {
 		raw.services[serviceKey] = newServiceEntry;
@@ -7435,7 +7443,7 @@ async function resolveOrgIfNeeded(nonInteractive) {
 }
 function registerDeploy(cli$1) {
 	cli$1.command("deploy", {
-		description: "Fazer deploy do serviço",
+		description: "Fazer deploy do serviço. Returns streamed progress events. The last event (type='result') contains: deploymentId, status (LIVE/BUILD_FAILED/DEPLOY_FAILED/FAILED/CANCELLED), urls, failReason, errorSummary, commitSha, branch, durationSeconds, dashboardUrl, and logs.",
 		middleware: [requireAuth],
 		options: z.object({
 			all: z.boolean().optional().describe("Deploy todos os serviços do monorepo"),
@@ -7642,7 +7650,6 @@ async function cliDeployFlow(opts) {
 			serviceName = project.services.find((s) => s.id === serviceId$1)?.name ?? "";
 		}
 		const selectedService = project.services.find((s) => s.id === serviceId$1);
-		const detection = detectLocalRepo();
 		const detectedType = selectedService?.type?.toLowerCase() ?? "web";
 		saveConfig({
 			version: "1.0",
@@ -7662,7 +7669,7 @@ async function cliDeployFlow(opts) {
 		info(`Arquivo ${getConfigFileName()} criado na raiz do projeto.`);
 		const freshConfig = loadConfig();
 		if (freshConfig) await provisionDatabases(freshConfig, { yes: opts.yes ?? false });
-		await triggerDeploy(serviceId$1, void 0, detection);
+		await triggerDeploy(serviceId$1);
 		return;
 	}
 	if (project && project.services.length === 0) {
@@ -7955,13 +7962,64 @@ async function pruneRemovedEntries(config, existingConfig, services, databases)
 	return config;
 }
 
+//#endregion
+//#region src/commands/update.ts
+function registerUpdate(cli$1) {
+	cli$1.command("update", {
+		description: "Atualizar a CLI para a versão mais recente",
+		output: z.object({
+			updated: z.boolean(),
+			version: z.string().nullable()
+		}),
+		async run() {
+			const pm = detectPackageManager();
+			if (!pm) {
+				warn("Instalação de desenvolvimento detectada. Use 'pnpm cli:install' para atualizar.");
+				return {
+					updated: false,
+					version: null
+				};
+			}
+			const currentVersion = getCurrentVersion();
+			info(`Versão atual: ${chalk.bold(currentVersion)}`);
+			const latestVersion = await fetchLatestVersion();
+			if (!latestVersion) {
+				warn("Não foi possível verificar a versão mais recente.");
+				return {
+					updated: false,
+					version: null
+				};
+			}
+			if (latestVersion === currentVersion) {
+				info(`Você já está na versão mais recente ${chalk.bold(currentVersion)}.`);
+				return {
+					updated: false,
+					version: currentVersion
+				};
+			}
+			if (!installVersion(pm, latestVersion)) {
+				console.log(chalk.dim(`  Execute manualmente: ${getInstallCommand(pm, latestVersion)}`));
+				return {
+					updated: false,
+					version: null
+				};
+			}
+			return {
+				updated: true,
+				version: latestVersion
+			};
+		}
+	});
+}
+
 //#endregion
 //#region src/index.ts
 if (process.argv.includes("--mcp")) process.env.VELOZ_MCP = "true";
 const cli = Cli.create("veloz", {
-	version: "0.0.0-beta.26",
+	version: "0.0.0-beta.27",
 	description: "CLI da plataforma Veloz — deploy rápido para o Brasil",
-	env: z.object({ VELOZ_ENV: z.string().optional().describe("Ambiente alvo (ex: preview, staging)") })
+	env: z.object({ VELOZ_ENV: z.string().optional().describe("Ambiente alvo (ex: preview, staging)") }),
+	mcp: { command: "npx -y onveloz --mcp" }
 });
 cli.use(async (c, next) => {
 	const env = c.env.VELOZ_ENV;
@@ -8033,6 +8091,7 @@ registerDeploy(cli);
 registerUse(cli);
 registerWhoami(cli);
 registerPull(cli);
+registerUpdate(cli);
 cli.serve();
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "onveloz",
-  "version": "0.0.0-beta.26",
+  "version": "0.0.0-beta.27",
   "description": "CLI da plataforma Veloz — deploy rápido para o Brasil",
   "keywords": [
     "brasil",