@neetru/cli 2.27.0 → 2.28.0

package/dist/commands/deploy.js

@@ -47,6 +47,27 @@ import { safeExit } from '../utils/safe-exit.js';
 export function toCoreStack(stack) {
     return stack === 'nextjs' ? 'node' : stack;
 }
+function scopedLog(json) {
+    if (!json)
+        return log;
+    const noop = (_msg) => { };
+    return { info: noop, warn: noop, dim: noop, success: noop, heading: noop, error: log.error };
+}
+/** Emite UMA linha JSON de erro no stdout. */
+function emitDeployJsonError(code, message) {
+    console.log(JSON.stringify({ ok: false, error: code, message }));
+}
+/**
+ * Falha terminal: em --json imprime `{ok:false,error,message}` no stdout; senão
+ * mostra a mensagem humana no stderr. Sempre encerra (safeExit é `never`).
+ */
+function deployFail(json, code, message, exitCode = 1) {
+    if (json)
+        emitDeployJsonError(code, message);
+    else
+        log.error(message);
+    safeExit(exitCode);
+}
 /**
  * GAP-M1-8: os 3 call-sites de deploy caíam em `?? '0.0.0'` quando não havia
  * manifest de build (sem `neetru build` local, ex: redeploy direto de um
@@ -56,12 +77,11 @@ export function toCoreStack(stack) {
  * Core com uma versão sem sentido (regressão ante o histórico real do
  * produto). Agora falha alto e explícito em vez de inventar um placeholder.
  */
-export function resolveDeployVersion(manifestVersion, explicitVersion) {
+export function resolveDeployVersion(manifestVersion, explicitVersion, json) {
     const version = manifestVersion ?? explicitVersion;
     if (!version) {
-        log.error('Versão não detectada (sem manifest de build local) e --version não foi informado. ' +
+        deployFail(json, 'version_required', 'Versão não detectada (sem manifest de build local) e --version não foi informado. ' +
             'Passe --version <versão real> explicitamente — nunca assuma um placeholder.');
-        safeExit(1);
     }
     return version;
 }
@@ -106,7 +126,10 @@ function isTty() {
     return !!process.stdout.isTTY && !!process.stdin.isTTY;
 }
 function ensureNonInteractive(opts) {
-    return !!opts.nonInteractive || !isTty();
+    // SETOR 5.1: --json implica não-interativo — um consumidor de JSON não pode
+    // responder prompts. Isso já pula todos os blocos `if (!nonInteractive)`
+    // (Resumo/confirmação), mantendo o stdout limpo.
+    return !!opts.nonInteractive || !!opts.json || !isTty();
 }
 async function loadLocalConfig(cwd) {
     for (const filename of ['neetru.config.json', '.neetru.json']) {
@@ -195,12 +218,13 @@ const SDK_CRED_ENV_KEYS = new Set([
     'NEETRU_API_KEY',
     'NEETRU_CLIENT_ID',
 ]);
-async function loadEnvFile(envFile, target = 'cloud-run') {
+async function loadEnvFile(envFile, target = 'cloud-run', json) {
+    const lg = scopedLog(json);
     const content = await fsp.readFile(envFile, 'utf8');
     const out = {};
     if (target === 'vm') {
         // (3) Lembrete único: a credencial SDK não precisa ir no --env-file.
-        log.info('A credencial SDK é injetada automaticamente na VM pelo Core/agente — ' +
+        lg.info('A credencial SDK é injetada automaticamente na VM pelo Core/agente — ' +
             'você NÃO precisa passar --env-file pra ela.');
     }
     for (const line of content.split(/\r?\n/)) {
@@ -223,27 +247,27 @@ async function loadEnvFile(envFile, target = 'cloud-run') {
             }
             else if (open === '"' || open === "'") {
                 // aspas sem fechamento correspondente — avisa e mantém o valor sem a aspas inicial
-                log.warn(`Aspas sem fechamento em valor de env (variável: ${k}) — aspas inicial removida`);
+                lg.warn(`Aspas sem fechamento em valor de env (variável: ${k}) — aspas inicial removida`);
                 v = v.slice(1);
             }
         }
         if (!k)
             continue;
         if (isDangerousEnvKey(k)) {
-            log.warn(`Variável de ambiente ignorada (nome não permitido): ${k}`);
+            lg.warn(`Variável de ambiente ignorada (nome não permitido): ${k}`);
             continue;
         }
         // (2) Credencial SDK: injetada server-side pelo Core/agente. Dropar SEMPRE,
         // inclusive NEETRU_CLIENT_ID (que não bate em isSecretEnvVarKey por não ter
         // KEY/TOKEN/SECRET no nome).
         if (SDK_CRED_ENV_KEYS.has(k)) {
-            log.warn(`Credencial SDK ignorada (${k}): a cred SDK é injetada server-side ` +
+            lg.warn(`Credencial SDK ignorada (${k}): a cred SDK é injetada server-side ` +
                 'pelo Core/agente — ignorando do --env-file.');
             continue;
         }
         // (1) Segredos são dropados aqui (o Core rejeitaria com HTTP 400).
         if (isSecretEnvVarKey(k)) {
-            log.warn(`Variável com aparência de segredo ignorada (${k}): segredos não podem ` +
+            lg.warn(`Variável com aparência de segredo ignorada (${k}): segredos não podem ` +
                 'ir no deploy via env (vazariam no Firestore, legível por todo o staff). ' +
                 'Use o Secret Manager e referencie por nome na VM.');
             continue;
@@ -260,8 +284,7 @@ async function pickProduct(opts, nonInteractive, cwd) {
     if (local?.slug)
         return local.slug;
     if (nonInteractive) {
-        log.error('--product <slug> é obrigatório em modo não interativo.');
-        safeExit(1);
+        deployFail(opts.json, 'product_required', '--product <slug> é obrigatório em modo não interativo.');
     }
     const spinner = ora({ text: 'Buscando catálogo…', color: 'blue' }).start();
     let catalog;
@@ -271,11 +294,10 @@ async function pickProduct(opts, nonInteractive, cwd) {
     }
     catch (err) {
         spinner.fail('Não consegui buscar o catálogo.');
-        handleApiError(err);
+        handleApiError(err, opts.json);
     }
     if (catalog.products.length === 0) {
-        log.error('Nenhum produto público encontrado. Crie um via `neetru publish` antes.');
-        safeExit(1);
+        deployFail(opts.json, 'no_products', 'Nenhum produto público encontrado. Crie um via `neetru publish` antes.');
     }
     const { slug } = await inquirer.prompt([
         {
@@ -322,7 +344,7 @@ async function pickServer(opts, nonInteractive) {
     }
     catch (err) {
         spinner.fail('Não consegui listar servers.');
-        handleApiError(err);
+        handleApiError(err, opts.json);
     }
     // bug_d9ee266e (CRITICAL 27/05): `--server <id>` explicito DEVE bypass
     // o filtro `?status=online`. Antes, se a list voltasse vazia (race entre
@@ -344,23 +366,26 @@ async function pickServer(opts, nonInteractive) {
             describeSpinner.stop();
             if (describe?.server)
                 return describe.server;
-            log.error(`Server "${opts.server}" nao encontrado.`);
-            safeExit(1);
+            deployFail(opts.json, 'server_not_found', `Server "${opts.server}" nao encontrado.`);
         }
         catch (err) {
             describeSpinner.fail(`Server "${opts.server}" nao encontrado.`);
-            handleApiError(err);
+            handleApiError(err, opts.json);
         }
     }
     if (resp.servers.length === 0) {
-        log.error('Nenhum servidor online encontrado.');
-        log.dim('  Provisione um com: POST /api/cli/v1/servers/provision');
-        log.dim('  Ou passe --server <id> explicito se ja sabe o id.');
+        if (opts.json) {
+            emitDeployJsonError('no_servers_online', 'Nenhum servidor online encontrado.');
+        }
+        else {
+            log.error('Nenhum servidor online encontrado.');
+            log.dim('  Provisione um com: POST /api/cli/v1/servers/provision');
+            log.dim('  Ou passe --server <id> explicito se ja sabe o id.');
+        }
         safeExit(1);
     }
     if (nonInteractive) {
-        log.error('--server <id> é obrigatório em modo não interativo.');
-        safeExit(1);
+        deployFail(opts.json, 'server_required', '--server <id> é obrigatório em modo não interativo.');
     }
     const { serverId } = await inquirer.prompt([
         {
@@ -428,7 +453,7 @@ function shouldKeepLocalArtifact(opts) {
  *
  * @returns `gs://...` canônico pra usar como artifactUrl no POST de deploy.
  */
-async function uploadArtifactToGcs(tarballAbs, productSlug, envName, sizeBytes) {
+async function uploadArtifactToGcs(tarballAbs, productSlug, envName, sizeBytes, json) {
     const filename = path.basename(tarballAbs);
     // Pede signed URL ao Core.
     const signSpinner = ora({
@@ -451,7 +476,7 @@ async function uploadArtifactToGcs(tarballAbs, productSlug, envName, sizeBytes)
     }
     catch (err) {
         signSpinner.fail('Falha ao obter signed URL.');
-        handleApiError(err);
+        handleApiError(err, json);
     }
     // PUT direto pro GCS com 1 retry. global.fetch nativo (Node 18+) aceita
     // ReadableStream e respeita Content-Length quando duplex='half'.
@@ -494,10 +519,9 @@ async function uploadArtifactToGcs(tarballAbs, productSlug, envName, sizeBytes)
             await attempt(2);
         }
         catch (err) {
-            log.error(`Upload do artifact falhou após 2 tentativas: ${err.message}. ` +
+            deployFail(json, 'artifact_upload_failed', `Upload do artifact falhou após 2 tentativas: ${err.message}. ` +
                 'Verifique conectividade com storage.googleapis.com ou rode com --local-artifact ' +
-                'se o agente está na mesma máquina.');
-            safeExit(4);
+                'se o agente está na mesma máquina.', 4);
         }
     }
     return { artifactUrl: signed.gcsPath, deployId: signed.deployId };
@@ -523,12 +547,12 @@ async function resolveArtifact(opts, productSlug, envName, cwd) {
     }
     // Decide se vamos fazer upload pra GCS ou manter file://.
     const keepLocal = shouldKeepLocalArtifact(opts);
+    const lg = scopedLog(opts.json);
     // Caso 2: --artifact <file> local.
     if (opts.artifact) {
         const abs = path.resolve(cwd, opts.artifact);
         if (!fileExists(abs)) {
-            log.error(`Artifact não encontrado: ${abs}`);
-            safeExit(1);
+            deployFail(opts.json, 'artifact_not_found', `Artifact não encontrado: ${abs}`);
         }
         const { createHash } = await import('node:crypto');
         const hash = createHash('sha256');
@@ -538,14 +562,14 @@ async function resolveArtifact(opts, productSlug, envName, cwd) {
         const stat = await fsp.stat(abs);
         const sha256 = hash.digest('hex');
         if (keepLocal) {
-            log.warn('Modo --local-artifact: mandando file:// pro Core. Só funciona se o agent compartilha FS com este CLI.');
+            lg.warn('Modo --local-artifact: mandando file:// pro Core. Só funciona se o agent compartilha FS com este CLI.');
             return {
                 artifactUrl: `file://${abs.replace(/\\/g, '/')}`,
                 artifactSha256: sha256,
                 artifactSizeBytes: stat.size,
             };
         }
-        const uploaded = await uploadArtifactToGcs(abs, productSlug, envName, stat.size);
+        const uploaded = await uploadArtifactToGcs(abs, productSlug, envName, stat.size, opts.json);
         return {
             artifactUrl: uploaded.artifactUrl,
             artifactSha256: sha256,
@@ -567,7 +591,7 @@ async function resolveArtifact(opts, productSlug, envName, cwd) {
         }
     }
     if (!manifest) {
-        log.info('Nenhum artifact encontrado. Rodando `neetru build`…');
+        lg.info('Nenhum artifact encontrado. Rodando `neetru build`…');
         // bug_d80cbe84: passa --stack e --env-file do deploy pro build, para que
         // `neetru deploy --stack=nextjs` não ignore a flag ao chamar runBuild
         // internamente. Sem isso, o build sempre detectava a stack do cwd (podendo
@@ -584,11 +608,15 @@ async function resolveArtifact(opts, productSlug, envName, cwd) {
             stack: opts.stack,
             envFile: opts.envFile,
             targetEnv: deployEnvToBuildTargetEnv(envName),
+            // SETOR 5.1: em deploy --json, o build interno roda em silêncio (stdout
+            // limpo, subprocessos → stderr) e NÃO emite a linha JSON dele — o deploy
+            // emite a linha final única.
+            quiet: opts.json,
         });
     }
     const tarAbs = path.resolve(cwd, manifest.tarball);
     if (keepLocal) {
-        log.warn('Modo --local-artifact: mandando file:// pro Core. Só funciona se o agent compartilha FS com este CLI.');
+        lg.warn('Modo --local-artifact: mandando file:// pro Core. Só funciona se o agent compartilha FS com este CLI.');
         return {
             artifactUrl: `file://${tarAbs.replace(/\\/g, '/')}`,
             artifactSha256: manifest.sha256,
@@ -596,7 +624,7 @@ async function resolveArtifact(opts, productSlug, envName, cwd) {
             manifest,
         };
     }
-    const uploaded = await uploadArtifactToGcs(tarAbs, productSlug, envName, manifest.sizeBytes);
+    const uploaded = await uploadArtifactToGcs(tarAbs, productSlug, envName, manifest.sizeBytes, opts.json);
     return {
         artifactUrl: uploaded.artifactUrl,
         artifactSha256: manifest.sha256,
@@ -605,7 +633,7 @@ async function resolveArtifact(opts, productSlug, envName, cwd) {
         deployId: uploaded.deployId,
     };
 }
-async function pollDeploymentStatus(deploymentId) {
+async function pollDeploymentStatus(deploymentId, json) {
     const start = Date.now();
     const timeoutMs = 20 * 60 * 1000; // 20min
     let lastStatus = '';
@@ -622,7 +650,7 @@ async function pollDeploymentStatus(deploymentId) {
                 continue;
             }
             spinner.fail('Falha ao consultar status.');
-            handleApiError(err);
+            handleApiError(err, json);
         }
         if (resp.status !== lastStatus) {
             spinner.text = `Status: ${chalk.bold(resp.status)} · ${resp.steps
@@ -659,10 +687,9 @@ async function resolveWorkspaceSource(opts, cwd) {
             };
         }
     }
-    log.error('Nenhum arquivo de source encontrado para o deploy workspace. ' +
+    deployFail(opts.json, 'source_not_found', 'Nenhum arquivo de source encontrado para o deploy workspace. ' +
         'Crie um handler.ts (ou src/handler.ts), aponte com --artifact <arquivo>, ' +
         'ou defina "source" no neetru.config.json.');
-    safeExit(1);
 }
 /**
  * bug_eae4bef6: limiar acima do qual o source é enviado via GCS (signed URL)
@@ -681,8 +708,7 @@ const WORKSPACE_SOURCE_GCS_THRESHOLD_BYTES = 1.5 * 1024 * 1024;
  */
 async function runWorkspaceDeploy(opts, productSlug, envName, cwd, nonInteractive) {
     if (!WORKSPACE_ENVS.has(envName)) {
-        log.error(`Ambiente inválido: "${envName}". Use dev, staging ou prod.`);
-        safeExit(1);
+        deployFail(opts.json, 'invalid_env', `Ambiente inválido: "${envName}". Use dev, staging ou prod.`);
     }
     const source = await resolveWorkspaceSource(opts, cwd);
     const sourceSizeBytes = Buffer.byteLength(source.content, 'utf8');
@@ -728,7 +754,7 @@ async function runWorkspaceDeploy(opts, productSlug, envName, cwd, nonInteractiv
         }
         catch (err) {
             uploadSpinner.fail('Falha ao obter signed URL para source.');
-            handleApiError(err);
+            handleApiError(err, opts.json);
         }
         // PUT direto pra GCS com o conteúdo do source.
         // bug_bf0c8c33: usar o contentType RETORNADO pelo servidor (uploadResult.contentType)
@@ -753,11 +779,11 @@ async function runWorkspaceDeploy(opts, productSlug, envName, cwd, nonInteractiv
         }
         catch (uploadErr) {
             uploadSpinner.fail(`Upload do source falhou: ${uploadErr.message}`);
-            handleApiError(uploadErr);
+            handleApiError(uploadErr, opts.json);
         }
         deployBody = {
             productSlug,
-            version: resolveDeployVersion(undefined, opts.version),
+            version: resolveDeployVersion(undefined, opts.version, opts.json),
             target: 'workspace',
             environmentId: envName,
             // gcsPath retornado pelo upload-url é o path `gs://bucket/object`.
@@ -768,7 +794,7 @@ async function runWorkspaceDeploy(opts, productSlug, envName, cwd, nonInteractiv
         // Caminho normal (source pequeno, embutido inline no JSON).
         deployBody = {
             productSlug,
-            version: resolveDeployVersion(undefined, opts.version),
+            version: resolveDeployVersion(undefined, opts.version, opts.json),
             target: 'workspace',
             environmentId: envName,
             source: source.content,
@@ -787,16 +813,41 @@ async function runWorkspaceDeploy(opts, productSlug, envName, cwd, nonInteractiv
     }
     catch (err) {
         spinner.fail('Falha ao publicar.');
-        handleApiError(err);
+        handleApiError(err, opts.json);
     }
     if (resp.status === 'live') {
         spinner.succeed(`Deploy ${chalk.bold('live')} · ${resp.deploymentId}`);
-        if (resp.url)
+        if (opts.json) {
+            console.log(JSON.stringify({
+                ok: true,
+                status: 'live',
+                target: 'workspace',
+                deploymentId: resp.deploymentId,
+                environmentId: resp.environmentId,
+                url: resp.url ? `https://${resp.url}` : null,
+            }));
+        }
+        else if (resp.url) {
             log.success(`Live em https://${resp.url}`);
+        }
         safeExit(0);
     }
     spinner.fail(`Deploy ${chalk.bold(resp.status)}.`);
-    log.error(resp.error ?? `Deploy terminou com status ${resp.status}`);
+    const wsErr = resp.error ?? `Deploy terminou com status ${resp.status}`;
+    if (opts.json) {
+        console.log(JSON.stringify({
+            ok: false,
+            error: 'deploy_failed',
+            message: wsErr,
+            status: resp.status,
+            target: 'workspace',
+            deploymentId: resp.deploymentId,
+            environmentId: resp.environmentId,
+        }));
+    }
+    else {
+        log.error(wsErr);
+    }
     safeExit(1);
 }
 /**
@@ -908,13 +959,12 @@ function buildArtifactRegistryUri(registry, productSlug, envName, opts, gcloudPr
     // Caso 3: só host (1 segmento) — precisa de projectId.
     const host = segments[0];
     if (!gcloudProject) {
-        log.error('Não foi possível detectar o GCP project automaticamente.\n' +
+        deployFail(opts.json, 'gcp_project_undetected', 'Não foi possível detectar o GCP project automaticamente.\n' +
             '  Opções:\n' +
             '    1. Configure via: gcloud config set project <SEU_PROJECT_ID>\n' +
             '    2. Passe o registry completo:\n' +
             `       --registry=${host}/<project-id>/<repo-name>\n` +
             '    3. Passe a imagem já pronta: --image=<uri-completa>');
-        safeExit(1);
     }
     const repoName = opts.registryRepo ?? `${productSlug}-${envName}`;
     return `${host}/${gcloudProject}/${repoName}/${productSlug}:${tag}`;
@@ -935,13 +985,18 @@ function buildArtifactRegistryUri(registry, productSlug, envName, opts, gcloudPr
 async function resolveCloudRunImage(opts, productSlug, envName, cwd) {
     if (opts.image)
         return opts.image;
+    const lg = scopedLog(opts.json);
+    // SETOR 5.1: em --json, o stdout do docker/gcloud é roteado pro stderr (fd 2)
+    // pra manter o stdout do CLI 100% JSON puro.
+    const crStdio = opts.json
+        ? ['inherit', 2, 2]
+        : 'inherit';
     const cfg = (await loadLocalConfig(cwd));
     const registry = opts.registry ?? cfg?.registry;
     if (!registry) {
-        log.error('Sem imagem pra deployar. Passe --image <uri> com a imagem já pushada, ' +
+        deployFail(opts.json, 'image_required', 'Sem imagem pra deployar. Passe --image <uri> com a imagem já pushada, ' +
             'ou defina o registry (--registry <host|host/project/repo> ou "registry" no neetru.config.json) ' +
             'pra build automático via Cloud Build.');
-        safeExit(1);
     }
     // ── Detecta project GCP (necessário para URI completa) ─────────────────────
     const gcloudProject = getGcloudProject();
@@ -959,7 +1014,7 @@ async function resolveCloudRunImage(opts, productSlug, envName, cwd) {
     if (!hasDockerfile) {
         const stack = opts.stack;
         if (stack === 'node' || stack === 'nextjs') {
-            log.warn(`Dockerfile não encontrado em ${cwd}.\n` +
+            lg.warn(`Dockerfile não encontrado em ${cwd}.\n` +
                 `  Gerando template automático para --stack=${stack}…`);
             const { tmpDir, dockerfilePath } = await generateDockerfileTemplate(stack, cwd);
             generatedDockerfileDir = tmpDir;
@@ -970,13 +1025,13 @@ async function resolveCloudRunImage(opts, productSlug, envName, cwd) {
             try {
                 const content = await fsp.readFile(dockerfilePath, 'utf8');
                 await fsp.writeFile(destDockerfile, content, { flag: 'wx' });
-                log.dim(`  Dockerfile temporário gerado em ${cwd}/Dockerfile`);
+                lg.dim(`  Dockerfile temporário gerado em ${cwd}/Dockerfile`);
             }
             catch (err) {
                 if (err.code === 'EEXIST') {
                     // Outro processo criou um Dockerfile no intervalo assíncrono — usar o
                     // existente sem sobrescrever; não marcar como gerado (não apagar no finally).
-                    log.warn(`Dockerfile encontrado em ${cwd} (criado durante geração automática). Usando o existente.`);
+                    lg.warn(`Dockerfile encontrado em ${cwd} (criado durante geração automática). Usando o existente.`);
                     generatedDockerfileDir = null; // não remover no finally
                 }
                 else {
@@ -985,43 +1040,38 @@ async function resolveCloudRunImage(opts, productSlug, envName, cwd) {
             }
         }
         else if (stack === 'docker') {
-            log.error(`Dockerfile não encontrado em ${cwd}.\n` +
+            deployFail(opts.json, 'dockerfile_required', `Dockerfile não encontrado em ${cwd}.\n` +
                 '  --stack=docker exige que você forneça um Dockerfile no projeto.\n' +
                 '  Crie um Dockerfile ou use --stack=node para template automático.');
-            safeExit(1);
         }
         else {
-            log.error(`Dockerfile não encontrado em ${cwd}.\n` +
+            deployFail(opts.json, 'dockerfile_required', `Dockerfile não encontrado em ${cwd}.\n` +
                 '  Opções:\n' +
                 '    1. Adicione um Dockerfile ao projeto.\n' +
                 '    2. Use --stack=node ou --stack=nextjs para template automático.\n' +
                 '    3. Passe --image=<uri> com imagem já construída.');
-            safeExit(1);
         }
     }
     // ── Build + Push ─────────────────────────────────────────────────────────────
-    log.info(`Buildando imagem ${chalk.bold(imageUri)}…`);
+    lg.info(`Buildando imagem ${chalk.bold(imageUri)}…`);
     try {
         if (opts.buildLocal) {
             // ── Modo local: docker build + docker push (exige Docker instalado) ──────
-            const build = spawnSync('docker', ['build', '-t', imageUri, '.'], { cwd: buildContext, stdio: 'inherit' });
+            const build = spawnSync('docker', ['build', '-t', imageUri, '.'], { cwd: buildContext, stdio: crStdio });
             if (build.error) {
                 const enoent = build.error.code === 'ENOENT';
-                log.error(enoent
+                deployFail(opts.json, 'docker_build_failed', enoent
                     ? 'docker não encontrado no PATH. Remova --build-local pra usar Cloud Build remoto.'
                     : `Falha ao rodar docker build: ${build.error.message}`);
-                safeExit(1);
             }
             if (build.status !== 0) {
-                log.error(`docker build falhou (exit ${build.status}).`);
-                safeExit(1);
+                deployFail(opts.json, 'docker_build_failed', `docker build falhou (exit ${build.status}).`);
             }
-            log.info('Push da imagem pro Artifact Registry…');
-            const push = spawnSync('docker', ['push', imageUri], { cwd: buildContext, stdio: 'inherit' });
+            lg.info('Push da imagem pro Artifact Registry…');
+            const push = spawnSync('docker', ['push', imageUri], { cwd: buildContext, stdio: crStdio });
             if (push.error || push.status !== 0) {
-                log.error(`docker push falhou${push.status !== null && push.status !== 0 ? ` (exit ${push.status})` : ''}. ` +
+                deployFail(opts.json, 'docker_push_failed', `docker push falhou${push.status !== null && push.status !== 0 ? ` (exit ${push.status})` : ''}. ` +
                     'Verifique a autenticação: gcloud auth configure-docker <host>.');
-                safeExit(1);
             }
         }
         else {
@@ -1033,24 +1083,22 @@ async function resolveCloudRunImage(opts, productSlug, envName, cwd) {
             if (gcloudProject)
                 gcloudArgs.push(`--project=${gcloudProject}`);
             gcloudArgs.push(buildContext);
-            log.info(`Usando Cloud Build remoto (sem Docker local).\n` +
+            lg.info(`Usando Cloud Build remoto (sem Docker local).\n` +
                 `  Comando: gcloud ${gcloudArgs.join(' ')}`);
-            const submit = spawnSync('gcloud', gcloudArgs, { cwd: buildContext, stdio: 'inherit' });
+            const submit = spawnSync('gcloud', gcloudArgs, { cwd: buildContext, stdio: crStdio });
             if (submit.error) {
                 const enoent = submit.error.code === 'ENOENT';
-                log.error(enoent
+                deployFail(opts.json, 'gcloud_build_failed', enoent
                     ? 'gcloud não encontrado no PATH. Instale o Google Cloud CLI: https://cloud.google.com/sdk/docs/install\n' +
                         '  Ou use --build-local com Docker instalado.'
                     : `Falha ao rodar gcloud builds submit: ${submit.error.message}`);
-                safeExit(1);
             }
             if (submit.status !== 0) {
-                log.error(`gcloud builds submit falhou (exit ${submit.status}).\n` +
+                deployFail(opts.json, 'gcloud_build_failed', `gcloud builds submit falhou (exit ${submit.status}).\n` +
                     '  Verifique:\n' +
                     '    1. Autenticação: gcloud auth login\n' +
                     '    2. APIs habilitadas: Cloud Build API + Artifact Registry API\n' +
                     `    3. Repositório AR existe: ${imageUri.split('/').slice(0, 3).join('/')}`);
-                safeExit(1);
             }
         }
     }
@@ -1075,15 +1123,14 @@ async function resolveCloudRunImage(opts, productSlug, envName, cwd) {
  */
 async function runCloudRunDeploy(opts, productSlug, envName, cwd, nonInteractive) {
     if (!WORKSPACE_ENVS.has(envName)) {
-        log.error(`Ambiente inválido: "${envName}". Use dev, staging ou prod.`);
-        safeExit(1);
+        deployFail(opts.json, 'invalid_env', `Ambiente inválido: "${envName}". Use dev, staging ou prod.`);
     }
     // Fix bug_ec17af083d7045a1a00f24255efb716c:
     // Cloud Run exige uma imagem de container — não um tarball source.
     // Se o dev passou --artifact (útil pra target=vm/workspace), informamos
     // claramente o que fazer em vez de silenciosamente ignorar a flag.
     if (opts.artifact || opts.artifactUrl) {
-        log.error('target=cloud-run não aceita --artifact / --artifact-url (tarball source).\n' +
+        deployFail(opts.json, 'artifact_not_supported_cloud_run', 'target=cloud-run não aceita --artifact / --artifact-url (tarball source).\n' +
             '  Cloud Run precisa de uma imagem de container OCI já buildada e pushada.\n' +
             '\n' +
             '  Opções:\n' +
@@ -1096,7 +1143,6 @@ async function runCloudRunDeploy(opts, productSlug, envName, cwd, nonInteractive
             '\n' +
             '    3. Mude o target pra vm ou workspace se quiser usar o tarball:\n' +
             '       --target=vm --artifact=' + (opts.artifact ?? opts.artifactUrl ?? '<file>'));
-        safeExit(1);
     }
     // bug_863ae5: pre-flight IAM check — abort cedo se SA Core não tiver permissão.
     // MASTER-HIGH-048 (2.11.0): prefere auth.json sobre Conf legado.
@@ -1107,7 +1153,7 @@ async function runCloudRunDeploy(opts, productSlug, envName, cwd, nonInteractive
     const imageUrl = await resolveCloudRunImage(opts, productSlug, envName, cwd);
     let envVars;
     if (opts.envFile) {
-        envVars = await loadEnvFile(path.resolve(cwd, opts.envFile));
+        envVars = await loadEnvFile(path.resolve(cwd, opts.envFile), 'cloud-run', opts.json);
     }
     if (!nonInteractive) {
         log.heading('Resumo');
@@ -1130,7 +1176,7 @@ async function runCloudRunDeploy(opts, productSlug, envName, cwd, nonInteractive
             method: 'POST',
             body: {
                 productSlug,
-                version: resolveDeployVersion(undefined, opts.version),
+                version: resolveDeployVersion(undefined, opts.version, opts.json),
                 target: 'cloud-run',
                 environmentId: envName,
                 imageUrl,
@@ -1141,17 +1187,46 @@ async function runCloudRunDeploy(opts, productSlug, envName, cwd, nonInteractive
     }
     catch (err) {
         spinner.fail('Falha ao publicar.');
-        handleApiError(err);
+        handleApiError(err, opts.json);
     }
     if (resp.status === 'live') {
         spinner.succeed(`Deploy ${chalk.bold('live')} · ${resp.deploymentId}`);
-        if (resp.url)
-            log.success(`Live em ${resp.url}`);
-        log.dim(`  serviço: ${resp.serviceName}${resp.revision ? ` · revision ${resp.revision}` : ''}`);
+        if (opts.json) {
+            console.log(JSON.stringify({
+                ok: true,
+                status: 'live',
+                target: 'cloud-run',
+                deploymentId: resp.deploymentId,
+                environmentId: resp.environmentId,
+                service: resp.serviceName,
+                url: resp.url ?? null,
+                revision: resp.revision ?? null,
+            }));
+        }
+        else {
+            if (resp.url)
+                log.success(`Live em ${resp.url}`);
+            log.dim(`  serviço: ${resp.serviceName}${resp.revision ? ` · revision ${resp.revision}` : ''}`);
+        }
         safeExit(0);
     }
     spinner.fail(`Deploy ${chalk.bold(resp.status)}.`);
-    log.error(resp.error ?? `Deploy terminou com status ${resp.status}`);
+    const crErr = resp.error ?? `Deploy terminou com status ${resp.status}`;
+    if (opts.json) {
+        console.log(JSON.stringify({
+            ok: false,
+            error: 'deploy_failed',
+            message: crErr,
+            status: resp.status,
+            target: 'cloud-run',
+            deploymentId: resp.deploymentId,
+            environmentId: resp.environmentId,
+            service: resp.serviceName,
+        }));
+    }
+    else {
+        log.error(crErr);
+    }
     safeExit(1);
 }
 /**
@@ -1193,13 +1268,20 @@ async function checkSchemaGate(cwd, opts) {
     const localFp = schemaFingerprint(schemaContent);
     if (localFp === lastApplied)
         return true;
+    const lg = scopedLog(opts.json);
     // Divergência detectada — avisa e pede confirmação.
-    log.warn(`Schema local diverge do aplicado — rode \`neetru db apply\` antes de publicar.`);
-    log.dim(`  fingerprint local:    ${localFp.slice(0, 16)}…`);
-    log.dim(`  último aplicado:      ${lastApplied.slice(0, 16)}…`);
-    if (opts.nonInteractive) {
-        log.error('Deploy bloqueado: schema diverge e modo não-interativo não permite confirmação. ' +
-            'Rode `neetru db apply` ou passe --force.');
+    lg.warn(`Schema local diverge do aplicado — rode \`neetru db apply\` antes de publicar.`);
+    lg.dim(`  fingerprint local:    ${localFp.slice(0, 16)}…`);
+    lg.dim(`  último aplicado:      ${lastApplied.slice(0, 16)}…`);
+    // --json implica não-interativo (via ensureNonInteractive), então a
+    // divergência bloqueia aqui e emite a linha JSON de erro (o caller safeExit).
+    if (opts.nonInteractive || opts.json) {
+        const msg = 'Deploy bloqueado: schema diverge e modo não-interativo não permite confirmação. ' +
+            'Rode `neetru db apply` ou passe --force.';
+        if (opts.json)
+            emitDeployJsonError('schema_drift', msg);
+        else
+            log.error(msg);
         return false;
     }
     const { continuar } = await inquirer.prompt([
@@ -1217,7 +1299,8 @@ async function checkSchemaGate(cwd, opts) {
     return true;
 }
 export async function runDeploy(opts) {
-    log.banner();
+    if (!opts.json)
+        log.banner();
     const cwd = process.cwd();
     const nonInteractive = ensureNonInteractive(opts);
     const productSlug = await pickProduct(opts, nonInteractive, cwd);
@@ -1247,7 +1330,7 @@ export async function runDeploy(opts) {
     // motivou o guard antigo (Core rejeitava sem --port); o Core agora ignora
     // porta em deploy VM, então exigi-la aqui só atrapalharia scripts/CI.
     // --port continua aceito (compat) mas é ignorado com WARN — ver abaixo.
-    if (target === 'vm' && opts.port) {
+    if (target === 'vm' && opts.port && !opts.json) {
         log.warn('A porta é gerenciada pelo Core; --port é ignorado em deploy staging/prod.');
     }
     const { domain } = await pickDomain(opts, nonInteractive, productSlug);
@@ -1259,7 +1342,7 @@ export async function runDeploy(opts) {
     // EnvVars.
     let envVars;
     if (opts.envFile) {
-        envVars = await loadEnvFile(path.resolve(cwd, opts.envFile), target);
+        envVars = await loadEnvFile(path.resolve(cwd, opts.envFile), target, opts.json);
     }
     // Confirmação interativa.
     if (!nonInteractive) {
@@ -1286,7 +1369,7 @@ export async function runDeploy(opts) {
     }
     const body = {
         productSlug,
-        version: resolveDeployVersion(artifact.manifest?.version, opts.version),
+        version: resolveDeployVersion(artifact.manifest?.version, opts.version, opts.json),
         // bug_a5786e03: mapeia nextjs→node (Core/agente não conhecem `nextjs`).
         stack: toCoreStack(opts.stack ?? artifact.manifest?.stack) ?? 'node',
         target,
@@ -1323,16 +1406,48 @@ export async function runDeploy(opts) {
     }
     catch (err) {
         dispatchSpinner.fail('Falha ao criar deploy.');
-        handleApiError(err);
+        handleApiError(err, opts.json);
     }
-    const final = await pollDeploymentStatus(deploy.deploymentId);
+    const final = await pollDeploymentStatus(deploy.deploymentId, opts.json);
     if (final.status !== 'success') {
-        console.log('\n' + formatDeployConsole(final.steps));
-        log.error(final.lastError ?? `Deploy terminou com status ${final.status}`);
+        const vmErr = final.lastError ?? `Deploy terminou com status ${final.status}`;
+        if (opts.json) {
+            console.log(JSON.stringify({
+                ok: false,
+                error: 'deploy_failed',
+                message: vmErr,
+                status: final.status,
+                target: 'vm',
+                deploymentId: deploy.deploymentId,
+                serverId: final.serverId,
+                steps: final.steps,
+            }));
+        }
+        else {
+            console.log('\n' + formatDeployConsole(final.steps));
+            log.error(vmErr);
+        }
         safeExit(1);
     }
-    if (final.domain)
+    if (opts.json) {
+        console.log(JSON.stringify({
+            ok: true,
+            status: 'success',
+            target: 'vm',
+            deploymentId: deploy.deploymentId,
+            product: final.productSlug ?? productSlug,
+            version: final.version,
+            environmentId: envName,
+            serverId: final.serverId,
+            domain: final.domain,
+            url: final.domain ? `https://${final.domain}` : null,
+            artifactUrl: artifact.artifactUrl,
+            steps: final.steps,
+        }));
+    }
+    else if (final.domain) {
         log.success(`Live em https://${final.domain}`);
+    }
     safeExit(0);
 }
 //# sourceMappingURL=deploy.js.map