onveloz 0.0.0-beta.26 → 0.0.0-beta.28

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";
@@ -237,6 +237,192 @@ function resolveServiceSizeFromResources(cpu, memory) {
 	for (const [key, tier] of Object.entries(SERVICE_SIZES)) if (tier.cpu === cpu && tier.memory === memory) return key;
 	return null;
 }
+/** All known flag keys. Used for validation and UI rendering. */
+const PROJECT_FLAG_DEFINITIONS = {
+	cloudflareSaas: {
+		label: "Cloudflare for SaaS",
+		description: "SSL de domínios customizados via Cloudflare (em vez de Let's Encrypt)"
+	},
+	cloudflareTunnel: {
+		label: "Cloudflare Tunnel",
+		description: "Roteamento de tráfego via túnel Cloudflare (em vez de IP direto). Domínios customizados apontam para proxy.onveloz.com"
+	},
+	buildkit: {
+		label: "BuildKit",
+		description: "Build de imagens via BuildKit no cluster (em vez de Depot externo). Mais controle e sem dependência de serviço externo."
+	}
+};
+const PROJECT_FLAG_KEYS = Object.keys(PROJECT_FLAG_DEFINITIONS);
+/**
+* Allowlist of user-configurable PostgreSQL parameters with validation bounds.
+* PGTune-relevant params + commonly tuned settings.
+*/
+const PG_CONFIGURABLE_PARAMS = {
+	shared_buffers: {
+		type: "integer",
+		unit: "MB",
+		min: 16,
+		max: 16384,
+		description: "Memória dedicada para cache de dados do PostgreSQL",
+		requiresRestart: true
+	},
+	effective_cache_size: {
+		type: "integer",
+		unit: "MB",
+		min: 64,
+		max: 65536,
+		description: "Estimativa de memória disponível para cache do sistema operacional",
+		requiresRestart: false
+	},
+	work_mem: {
+		type: "integer",
+		unit: "MB",
+		min: 1,
+		max: 2048,
+		description: "Memória por operação de ordenação/hash",
+		requiresRestart: false
+	},
+	maintenance_work_mem: {
+		type: "integer",
+		unit: "MB",
+		min: 16,
+		max: 2048,
+		description: "Memória para operações de manutenção (VACUUM, CREATE INDEX)",
+		requiresRestart: false
+	},
+	wal_buffers: {
+		type: "integer",
+		unit: "MB",
+		min: 1,
+		max: 64,
+		description: "Memória para buffers de WAL",
+		requiresRestart: true
+	},
+	min_wal_size: {
+		type: "integer",
+		unit: "MB",
+		min: 32,
+		max: 4096,
+		description: "Tamanho mínimo de WAL antes de reciclar",
+		requiresRestart: false
+	},
+	max_wal_size: {
+		type: "integer",
+		unit: "MB",
+		min: 64,
+		max: 16384,
+		description: "Tamanho máximo de WAL antes de forçar checkpoint",
+		requiresRestart: false
+	},
+	max_connections: {
+		type: "integer",
+		min: 20,
+		max: 1e3,
+		description: "Número máximo de conexões simultâneas",
+		requiresRestart: true
+	},
+	random_page_cost: {
+		type: "real",
+		min: .1,
+		max: 10,
+		description: "Custo estimado de leitura aleatória de página (SSD ≈ 1.1, HDD ≈ 4.0)",
+		requiresRestart: false
+	},
+	effective_io_concurrency: {
+		type: "integer",
+		min: 0,
+		max: 1e3,
+		description: "Número de operações de I/O simultâneas (SSD ≈ 200)",
+		requiresRestart: false
+	},
+	max_worker_processes: {
+		type: "integer",
+		min: 1,
+		max: 128,
+		description: "Número máximo de processos worker",
+		requiresRestart: true
+	},
+	max_parallel_workers: {
+		type: "integer",
+		min: 0,
+		max: 128,
+		description: "Número máximo de workers paralelos",
+		requiresRestart: false
+	},
+	max_parallel_workers_per_gather: {
+		type: "integer",
+		min: 0,
+		max: 64,
+		description: "Número máximo de workers por operação Gather",
+		requiresRestart: false
+	},
+	max_parallel_maintenance_workers: {
+		type: "integer",
+		min: 0,
+		max: 64,
+		description: "Número máximo de workers para manutenção paralela",
+		requiresRestart: false
+	},
+	checkpoint_completion_target: {
+		type: "real",
+		min: .1,
+		max: 1,
+		description: "Fração do intervalo de checkpoint para completar a escrita",
+		requiresRestart: false
+	},
+	autovacuum_max_workers: {
+		type: "integer",
+		min: 1,
+		max: 16,
+		description: "Número máximo de processos autovacuum",
+		requiresRestart: true
+	},
+	autovacuum_naptime: {
+		type: "integer",
+		unit: "s",
+		min: 1,
+		max: 86400,
+		description: "Intervalo entre execuções do autovacuum",
+		requiresRestart: false
+	},
+	log_min_duration_statement: {
+		type: "integer",
+		unit: "ms",
+		min: -1,
+		max: 6e5,
+		description: "Log de queries mais lentas que N ms (-1 desabilita)",
+		requiresRestart: false
+	},
+	log_statement: {
+		type: "enum",
+		enumValues: [
+			"none",
+			"ddl",
+			"mod",
+			"all"
+		],
+		description: "Tipos de statements que são logados",
+		requiresRestart: false
+	},
+	statement_timeout: {
+		type: "integer",
+		unit: "ms",
+		min: 0,
+		max: 864e5,
+		description: "Timeout para execução de statements (0 desabilita)",
+		requiresRestart: false
+	},
+	idle_in_transaction_session_timeout: {
+		type: "integer",
+		unit: "ms",
+		min: 0,
+		max: 864e5,
+		description: "Timeout para sessões idle em transação (0 desabilita)",
+		requiresRestart: false
+	}
+};
+/** All user-configurable param keys. */
+const PG_CONFIGURABLE_PARAM_KEYS = Object.keys(PG_CONFIGURABLE_PARAMS);
 
 //#endregion
 //#region ../../packages/config/veloz-config.ts
@@ -761,13 +947,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 +979,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 +1374,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 +1397,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 +1577,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 +1590,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
 		})) };
 	}
 });
@@ -1784,6 +1984,54 @@ volumesGroup.command("sync", {
 
 //#endregion
 //#region src/commands/config.ts
+/**
+* Sync server-side config updates back to veloz.json.
+* Maps server field names to veloz.json service config paths.
+*/
+function syncConfigToVelozJson(serviceKey, updates) {
+	try {
+		if (!loadConfig()) return;
+		patchConfig((raw) => {
+			const svc = raw.services[serviceKey];
+			if (!svc) return;
+			for (const [field, value] of Object.entries(updates)) switch (field) {
+				case "name":
+					svc.name = value;
+					break;
+				case "buildCommand":
+					if (!svc.build) svc.build = {};
+					svc.build.command = value;
+					break;
+				case "startCommand":
+					if (!svc.runtime) svc.runtime = {};
+					svc.runtime.command = value;
+					break;
+				case "preStartCommand":
+					if (!svc.runtime) svc.runtime = {};
+					svc.runtime.preStartCommand = value;
+					break;
+				case "port":
+					if (!svc.runtime) svc.runtime = {};
+					svc.runtime.port = value;
+					break;
+				case "rootDirectory":
+					svc.root = value ?? ".";
+					break;
+				case "instanceCount":
+					if (!svc.resources) svc.resources = {};
+					svc.resources.instances = value;
+					break;
+				case "size":
+					if (!svc.resources) svc.resources = {};
+					svc.resources.size = value;
+					break;
+				case "branch":
+					svc.branch = value;
+					break;
+			}
+		});
+	} catch {}
+}
 function formatValue(value) {
 	if (value === null || value === void 0 || value === "") return chalk.dim("—");
 	return chalk.cyan(String(value));
@@ -1874,7 +2122,8 @@ configGroup.command("set", {
 		instances: "i"
 	},
 	async run(c) {
-		const serviceId = await resolveServiceId(c.options.service);
+		const { key: serviceKey, service } = await resolveService(c.options.service);
+		const serviceId = service.id;
 		const client = await getClient();
 		const updates = {};
 		if (c.options.name) updates.name = c.options.name;
@@ -1898,6 +2147,7 @@ configGroup.command("set", {
 				...updates
 			})
 		});
+		syncConfigToVelozJson(serviceKey, updates);
 		success("Configurações atualizadas com sucesso!");
 		console.log(chalk.dim("\nValores atualizados:"));
 		for (const [key, value] of Object.entries(updates)) {
@@ -1914,7 +2164,8 @@ configGroup.command("edit", {
 	middleware: [requireAuth],
 	options: z.object({ service: z.string().optional().describe("Serviço alvo (chave ou nome)") }),
 	async run(c) {
-		const serviceId = await resolveServiceId(c.options.service);
+		const { key: serviceKey, service: resolved } = await resolveService(c.options.service);
+		const serviceId = resolved.id;
 		const client = await getClient();
 		const svc = await withSpinner({
 			text: "Buscando configurações atuais...",
@@ -1955,6 +2206,7 @@ configGroup.command("edit", {
 				...updates
 			})
 		});
+		syncConfigToVelozJson(serviceKey, updates);
 		success("Configurações atualizadas com sucesso!");
 		info("Execute 'veloz deploy' para aplicar as mudanças.");
 		return { updated: updates };
@@ -1973,7 +2225,8 @@ configGroup.command("reset", {
 	}),
 	async run(c) {
 		requireMcpConfirmation(c.options.userConfirmation, "resetar configurações para os padrões");
-		const serviceId = await resolveServiceId(c.options.service);
+		const { key: serviceKey, service } = await resolveService(c.options.service);
+		const serviceId = service.id;
 		const client = await getClient();
 		const updates = {};
 		if (c.options.all) {
@@ -1997,6 +2250,7 @@ configGroup.command("reset", {
 				...updates
 			})
 		});
+		syncConfigToVelozJson(serviceKey, updates);
 		success("Configurações resetadas para os padrões!");
 		info("Execute 'veloz deploy' para aplicar as mudanças.");
 		return { reset: Object.keys(updates) };
@@ -2707,6 +2961,116 @@ dbGroup.command("tunnel", {
 		});
 	}
 });
+dbGroup.command("config", {
+	description: "Ver ou alterar configuração do PostgreSQL",
+	middleware: [requireAuth],
+	args: z.object({ name: z.string().describe("Nome ou ID do banco de dados") }),
+	options: z.object({
+		set: z.string().optional().describe("Definir parâmetro (formato: chave=valor)"),
+		reset: z.boolean().optional().describe("Resetar para configuração auto-tuned"),
+		params: z.boolean().optional().describe("Listar parâmetros configuráveis"),
+		userConfirmation: z.string().optional()
+	}),
+	output: z.object({
+		params: z.array(z.object({
+			name: z.string(),
+			type: z.string(),
+			unit: z.string().optional(),
+			requiresRestart: z.boolean(),
+			description: z.string()
+		})).optional(),
+		effective: z.record(z.string(), z.string()).optional(),
+		userOverrides: z.record(z.string(), z.string()).optional(),
+		updated: z.boolean().optional(),
+		key: z.string().optional(),
+		value: z.string().optional(),
+		requiresRestart: z.boolean().optional(),
+		reset: z.boolean().optional()
+	}),
+	async run(c) {
+		const db = await resolveDatabaseByName(getProjectId(), c.args.name);
+		const client = await getClient();
+		if (c.options.params) {
+			log(chalk.bold("\n  Parâmetros configuráveis:\n"));
+			log(`  ${chalk.bold("Parâmetro".padEnd(40))}${chalk.bold("Tipo".padEnd(12))}${chalk.bold("Reinício?")}`);
+			log(chalk.dim("  " + "─".repeat(65)));
+			const params = Object.entries(PG_CONFIGURABLE_PARAMS).map(([key, def]) => {
+				const typeLabel = def.unit ? `${def.type} (${def.unit})` : def.type;
+				const restartLabel = def.requiresRestart ? chalk.yellow("Sim") : chalk.green("Não");
+				log(`  ${key.padEnd(40)}${typeLabel.padEnd(12)}${restartLabel}`);
+				return {
+					name: key,
+					type: def.type,
+					unit: def.unit,
+					requiresRestart: def.requiresRestart,
+					description: def.description
+				};
+			});
+			log("");
+			return { params };
+		}
+		if (db.engine !== "postgresql") throw new Error("Configuração personalizada só é suportada para PostgreSQL.");
+		if (c.options.reset) {
+			requireMcpConfirmation(c.options.userConfirmation, `resetar configuração do banco de dados "${db.name}" para auto-tuned`);
+			if (!c.options.userConfirmation && isInteractive()) {
+				if (!await promptConfirm(`Resetar toda a configuração personalizada de "${db.name}" para auto-tuned?`, false)) {
+					info("Operação cancelada.");
+					return {};
+				}
+			}
+			const result = await withSpinner({
+				text: "Resetando configuração...",
+				fn: () => client.databases.resetConfig({ serviceId: db.id })
+			});
+			success("Configuração resetada para auto-tuned.");
+			info("O banco de dados será reiniciado para aplicar as alterações.");
+			return {
+				reset: true,
+				effective: result.effective
+			};
+		}
+		if (c.options.set) {
+			const eqIndex = c.options.set.indexOf("=");
+			if (eqIndex === -1) throw new Error("Formato inválido. Use: --set chave=valor (ex: --set shared_buffers=512MB)");
+			const key = c.options.set.slice(0, eqIndex).trim();
+			const value = c.options.set.slice(eqIndex + 1).trim();
+			const result = await withSpinner({
+				text: `Atualizando ${key}...`,
+				fn: () => client.databases.updateConfig({
+					serviceId: db.id,
+					config: { [key]: value }
+				})
+			});
+			success(`${key} = ${value}`);
+			if (result.requiresRestart) warn("Esta alteração requer reinício do banco de dados para ter efeito.");
+			return {
+				updated: true,
+				key,
+				value,
+				requiresRestart: result.requiresRestart
+			};
+		}
+		const config = await withSpinner({
+			text: "Carregando configuração...",
+			fn: () => client.databases.getConfig({ serviceId: db.id })
+		});
+		log(chalk.bold(`\n  Configuração PostgreSQL — ${db.name}\n`));
+		log(`  ${chalk.bold("Parâmetro".padEnd(40))}${chalk.bold("Valor".padEnd(20))}${chalk.bold("Origem")}`);
+		log(chalk.dim("  " + "─".repeat(70)));
+		for (const [key, value] of Object.entries(config.effective)) {
+			const isOverride = key in config.userOverrides;
+			const originLabel = isOverride ? chalk.cyan("personalizado") : chalk.dim("auto-tuned");
+			const valueLabel = isOverride ? chalk.cyan(value) : value;
+			log(`  ${key.padEnd(40)}${String(valueLabel).padEnd(20)}${originLabel}`);
+		}
+		if (Object.keys(config.userOverrides).length > 0) log(chalk.dim(`\n  ${Object.keys(config.userOverrides).length} parâmetro(s) personalizado(s)`));
+		log("");
+		return {
+			effective: config.effective,
+			userOverrides: config.userOverrides
+		};
+	}
+});
 
 //#endregion
 //#region src/commands/template.ts
@@ -3985,12 +4349,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 +4460,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 +4624,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 +4782,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 +4855,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
@@ -5017,6 +5402,18 @@ function extractEnvVars(files) {
 	}
 	return vars;
 }
+/**
+* Extract the major Node.js version from a package.json string's `engines.node` field.
+* Handles ranges like `>=22`, `^20`, `~18.0`, `22.x`, `20`, `>=22.0.0`.
+* Returns the major version string (e.g. "22") or undefined if not parseable.
+*/
+function detectNodeVersion(pkgJsonStr) {
+	const pkg = safeParsePkg(pkgJsonStr);
+	if (!pkg?.engines?.node) return void 0;
+	const match = pkg.engines.node.trim().match(/(\d+)/);
+	if (!match) return void 0;
+	return match[1];
+}
 function analyzeRepo(files) {
 	const packageManager = detectPackageManager$1(files);
 	const envVars = extractEnvVars(files);
@@ -5034,6 +5431,7 @@ function analyzeRepo(files) {
 		const appPath = filePath.replace("/package.json", "");
 		const appName = nested.name || appPath.split("/").pop() || appPath;
 		let appFramework = detectFramework(content, packageManager);
+		if (!appFramework && !nested.scripts?.start) continue;
 		if (appFramework && rootPkg) {
 			if (rootPkg.scripts?.[`build:${appName}`]) appFramework = {
 				...appFramework,
@@ -5051,7 +5449,8 @@ function analyzeRepo(files) {
 			name: appName,
 			path: appPath,
 			framework: appFramework,
-			usesNodeFs: sourceEntries.some(([srcPath, fileContent]) => srcPath.startsWith(`${appPath}/`) && usesNodeFs(fileContent))
+			usesNodeFs: sourceEntries.some(([srcPath, fileContent]) => srcPath.startsWith(`${appPath}/`) && usesNodeFs(fileContent)),
+			nodeVersion: detectNodeVersion(content)
 		});
 	}
 	return {
@@ -5060,7 +5459,8 @@ function analyzeRepo(files) {
 		envVars,
 		isMonorepo,
 		monorepoApps,
-		usesNodeFs: sourceEntries.some(([, content]) => usesNodeFs(content))
+		usesNodeFs: sourceEntries.some(([, content]) => usesNodeFs(content)),
+		nodeVersion: rootPkgContent ? detectNodeVersion(rootPkgContent) : void 0
 	};
 }
 
@@ -5283,7 +5683,7 @@ const LOGO_LINES = [
 ];
 const BRAND_COLOR = "#FF4D00";
 function getVersion() {
-	return "0.0.0-beta.26";
+	return "0.0.0-beta.28";
 }
 function printBanner(subtitle) {
 	const version = getVersion();
@@ -6011,32 +6411,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 +6644,6 @@ function runPreDeployChecks(basePath = ".") {
 	const checks = [
 		checkNitroPreset,
 		checkDockerfileLockFiles,
-		checkPrismaGenerate,
 		checkPortMismatch,
 		checkEnvFileCommitted,
 		checkSvelteKitAdapter,
@@ -6333,24 +6706,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.28";
+}
+/**
+* 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 +6994,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 +7002,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 +7034,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 [];
@@ -6907,7 +7285,8 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 			buildCommand: a.framework?.buildCommand ?? null,
 			startCommand: a.framework?.startCommand ?? null,
 			port: a.framework?.port ?? 3e3,
-			usesNodeFs: a.usesNodeFs
+			usesNodeFs: a.usesNodeFs,
+			nodeVersion: a.nodeVersion
 		}));
 		let selectedApps;
 		if (opts.yes) if (opts.app) {
@@ -6951,7 +7330,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,
@@ -6974,7 +7353,8 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 					buildCommand: app.buildCommand ?? void 0,
 					startCommand: app.startCommand ?? void 0,
 					port: app.port ?? 3e3,
-					framework: app.framework ?? void 0
+					framework: app.framework ?? void 0,
+					nodeVersion: app.nodeVersion
 				}))
 			});
 			success(`Serviço criado: ${chalk.bold(service$1.name)}`);
@@ -6982,7 +7362,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 +7374,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()
@@ -7067,12 +7446,13 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 			buildCommand: settings.buildCommand ?? void 0,
 			startCommand: settings.startCommand ?? void 0,
 			port: settings.port,
-			framework: settings.framework ?? void 0
+			framework: settings.framework ?? void 0,
+			nodeVersion: detection.nodeVersion
 		}))
 	});
 	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 +7474,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;
 }
@@ -7187,7 +7565,8 @@ async function addServiceFlow(existingConfig, opts) {
 			buildCommand: a.framework?.buildCommand ?? null,
 			startCommand: a.framework?.startCommand ?? null,
 			port: a.framework?.port ?? 3e3,
-			usesNodeFs: a.usesNodeFs
+			usesNodeFs: a.usesNodeFs,
+			nodeVersion: a.nodeVersion
 		}));
 		const availableApps = allApps.filter((a) => !existingRoots.has(a.root));
 		if (availableApps.length === 0) {
@@ -7261,7 +7640,8 @@ async function addServiceFlow(existingConfig, opts) {
 					buildCommand: hasDockerfile ? void 0 : app.buildCommand ?? void 0,
 					startCommand: hasDockerfile ? void 0 : app.startCommand ?? void 0,
 					port: app.port ?? 3e3,
-					framework: hasDockerfile ? "docker" : app.framework ?? void 0
+					framework: hasDockerfile ? "docker" : app.framework ?? void 0,
+					nodeVersion: hasDockerfile ? void 0 : app.nodeVersion
 				}))
 			});
 			success(`Serviço criado: ${chalk.bold(service$1.name)}`);
@@ -7286,7 +7666,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) {
@@ -7373,7 +7752,8 @@ async function addServiceFlow(existingConfig, opts) {
 			buildCommand: settings.buildCommand ?? void 0,
 			startCommand: settings.startCommand ?? void 0,
 			port: settings.port,
-			framework: settings.framework ?? void 0
+			framework: settings.framework ?? void 0,
+			nodeVersion: detection.nodeVersion
 		}))
 	});
 	success(`Serviço criado: ${chalk.bold(service.name)}`);
@@ -7401,7 +7781,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 +7814,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 +8021,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 +8040,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 +8333,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.28",
 	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 +8462,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.28",
   "description": "CLI da plataforma Veloz — deploy rápido para o Brasil",
   "keywords": [
     "brasil",