@neetru/cli 2.11.1 → 2.11.3

package/README.md

@@ -1,141 +1,141 @@
-# @neetru/cli
-
-> Developer Kit oficial da Neetru — scaffolding, IA Neetru-aware, deploy de produtos SaaS, gestão de workspaces, bancos isolados por produto, e mais 40+ comandos pra operar todo o ecossistema Neetru via terminal.
-
-<p>
-  <img alt="npm" src="https://img.shields.io/npm/v/@neetru/cli?logo=npm">
-  <img alt="downloads" src="https://img.shields.io/npm/dm/@neetru/cli?logo=npm">
-  <img alt="Node" src="https://img.shields.io/badge/node-%3E%3D22-339933?logo=node.js&logoColor=white">
-  <img alt="license" src="https://img.shields.io/badge/license-MIT-22c55e">
-</p>
-
-## Instalação
-
-```bash
-npm install -g @neetru/cli
-```
-
-Bootstrap completo da máquina dev (Node, gcloud, Docker, Firebase CLI, deps NPM, GCP ADC):
-
-```bash
-neetru bootstrap
-```
-
-Login no Core via OAuth Device Code Flow:
-
-```bash
-neetru login
-```
-
-Validar estado:
-
-```bash
-neetru doctor
-```
-
-## Quickstart — criar produto SaaS novo
-
-```bash
-neetru new gestovendas --env=dev --tier=dev --customer=neetru
-```
-
-Cria produto + workspace + scaffold local Next.js 15 + instala deps + abre cockpit no browser.
-
-## Comandos principais
-
-| Comando | O que faz |
-|---|---|
-| `neetru bootstrap` | Setup da máquina dev (binários + deps + ADC) |
-| `neetru login` / `logout` / `whoami` | Auth OAuth Device Code Flow |
-| `neetru doctor` | Diagnóstico saúde (5 checks rápidos) |
-| `neetru new <slug>` | Criar produto completo (registry + workspace + scaffold) |
-| `neetru init <name>` | Só scaffold local Next.js + Firebase |
-| `neetru add <feature>` | Adicionar features ao scaffold (auth, billing, etc) |
-| `neetru deploy` | Pipeline de deploy interativo (cloud-run / vm / workspace) |
-| `neetru build` | Empacotar produto em tarball pra deploy |
-| `neetru promote` | Promover dev → staging → prod |
-| `neetru env switch <target>` | Trocar `NEETRU_ENV` no `.env.local` |
-| `neetru env set --service=X --set KEY=VAL` | Setar env vars de serviço Cloud Run |
-| `neetru ar create <name>` | Criar repositório Artifact Registry |
-| `neetru hosting create-mapping --service=X --domain=Y` | Domain mapping |
-| `neetru db create --product=X --engine=postgres` | Criar banco por produto |
-| `neetru db engines` | Listar engines disponíveis (firestore, postgres, mysql) |
-| `neetru cloud-run pause/resume/delete <service>` | Controle Cloud Run |
-| `neetru products list/create/update` | Registry de produtos |
-| `neetru workspaces create/list/get/advance` | Instâncias por cliente |
-| `neetru deployments create/rollback` | Histórico de deploys |
-| `neetru tenants list/create/update/suspend` | Gerenciar tenants |
-| `neetru audit tail` | Tail de `audit_logs/` em tempo real |
-| `neetru billing summary` | Resumo de billing |
-| `neetru servers list/provision/deactivate` | Gerenciar servidores |
-| `neetru agent release/yank/canary` | Gerenciar releases do agente |
-| `neetru support tickets list/reply/assign` | Suporte inbox staff |
-| `neetru dns zones list` / `hosting list` | Listar DNS + customer domains |
-| `neetru builds list` | Listar Cloud Build |
-| `neetru dr exports/restore` | Disaster Recovery |
-| `neetru logs` | Ver logs de produtos |
-| `neetru status` | Visão geral do ecossistema |
-| `neetru open <produto>` | Abrir cockpit do produto no browser |
-| `neetru ai` | REPL IA Neetru-aware (Claude/OpenAI/Gemini) |
-| `neetru ui` | Menu interativo do CLI |
-| `neetru publish` | Publicar produto no catálogo público |
-| `neetru upgrade` | Auto-update do CLI |
-| `neetru autocomplete <bash\|zsh\|pwsh>` | Gerar script autocomplete |
-
-**Atalhos:** `neetru ar` = `artifact-registry`, `neetru menu` = `ui`.
-
-40+ subcomandos. Quase todos suportam `--json` pra automação.
-
-## Configuração
-
-Token Bearer fica em `~/.config/neetru-cli/auth.json` (chmod 0600 em Unix, NTFS ACL em Windows) — gerado por `neetru login` via OAuth Device Code Flow. Configs gerais ficam em `~/.config/neetru-cli/config.json` (Linux/macOS) ou `%APPDATA%\neetru-cli\config.json` (Windows):
-
-| Chave | Valor |
-|---|---|
-| `neetruApiUrl` | URL base do Core (default `https://api.neetru.com`). **Allowlist** desde 2.11.0: `*.neetru.com` + `localhost`; demais hosts exigem `--allow-untrusted-url` |
-| `defaultModel` | `claude` / `openai` / `gemini` / `auto` (REPL `neetru ai`) |
-| `telemetry.enabled` | Telemetry opt-in (default `false`) — desde 2.11.0 emite eventos anônimos pra `/api/sdk/v1/telemetry/log` |
-| `neetruApiKey` | **(legado)** Token em Conf — substituído por `auth.json`. Será removido em 2.12.0 |
-
-```bash
-neetru config set telemetry.enabled true
-neetru config get neetruApiUrl
-neetru config path           # mostra caminho do config file
-neetru config set neetruApiUrl https://staging.neetru.com   # subdomínio neetru.com — OK
-neetru config set neetruApiUrl http://my-proxy.local --allow-untrusted-url   # explicit opt-in
-```
-
-## Output JSON
-
-```bash
-neetru products list --json | jq '.[] | select(.status == "ativo")'
-neetru audit tail --json | jq 'select(.action | startswith("billing"))'
-```
-
-## Auth & Segurança
-
-- **OAuth Device Code Flow** (RFC 8628) pra login interativo — não armazena password
-- **Tokens** salvos em `~/.config/neetru-cli/auth.json` (chmod 0600 em Unix, NTFS ACL em Windows). Desde 2.11.0 o resolver canônico (`getActiveTokenSync`) prefere esse arquivo sobre o Conf storage legado (que será removido em 2.12.0)
-- **URL allowlist** (desde 2.11.0): `neetruApiUrl` rejeita hosts fora de `*.neetru.com` + `localhost` sem `--allow-untrusted-url` — fecha vetor de exfiltração do Bearer token
-- **Rate-limit** por método HTTP: GET 120/min, POST/PUT/PATCH 30/min, DELETE 5/min
-- **Step-up MFA** (TOTP) obrigatório em operações destrutivas: `--mfa-token <code>` ou prompt
-- **Dry-run** disponível em comandos de mutação: `--dry-run` mostra efeito SEM aplicar
-- **Telemetry** opt-in (desde 2.11.0): habilitando `telemetry.enabled=true` o CLI emite `{command, durationMs, ok, exitCode}` anônimo via `installId` UUID. Zero token/path/email/env vazam
-
-## Stack
-
-- TypeScript 5 ESM-first
-- Node 22+ (LTS)
-- Sem `node-fetch`/`axios`: fetch global nativo
-- Commander 11 (CLI framework) + Inquirer 12 (prompts) + Chalk 5 + Ora (spinners)
-
-## Mais info
-
-- **Repo:** [github.com/Neetru/neetru-core](https://github.com/Neetru/neetru-core)
-- **Docs:** [docs.neetru.com](https://docs.neetru.com)
-- **SDK complementar:** `npm install @neetru/sdk`
-- **Issues / suporte:** abrir issue no repo ou `neetru support`
-
-## Licença
-
-MIT © Neetru
+# @neetru/cli
+
+> Developer Kit oficial da Neetru — scaffolding, IA Neetru-aware, deploy de produtos SaaS, gestão de workspaces, bancos isolados por produto, e mais 40+ comandos pra operar todo o ecossistema Neetru via terminal.
+
+<p>
+  <img alt="npm" src="https://img.shields.io/npm/v/@neetru/cli?logo=npm">
+  <img alt="downloads" src="https://img.shields.io/npm/dm/@neetru/cli?logo=npm">
+  <img alt="Node" src="https://img.shields.io/badge/node-%3E%3D22-339933?logo=node.js&logoColor=white">
+  <img alt="license" src="https://img.shields.io/badge/license-MIT-22c55e">
+</p>
+
+## Instalação
+
+```bash
+npm install -g @neetru/cli
+```
+
+Bootstrap completo da máquina dev (Node, gcloud, Docker, Firebase CLI, deps NPM, GCP ADC):
+
+```bash
+neetru bootstrap
+```
+
+Login no Core via OAuth Device Code Flow:
+
+```bash
+neetru login
+```
+
+Validar estado:
+
+```bash
+neetru doctor
+```
+
+## Quickstart — criar produto SaaS novo
+
+```bash
+neetru new gestovendas --env=dev --tier=dev --customer=neetru
+```
+
+Cria produto + workspace + scaffold local Next.js 15 + instala deps + abre cockpit no browser.
+
+## Comandos principais
+
+| Comando | O que faz |
+|---|---|
+| `neetru bootstrap` | Setup da máquina dev (binários + deps + ADC) |
+| `neetru login` / `logout` / `whoami` | Auth OAuth Device Code Flow |
+| `neetru doctor` | Diagnóstico saúde (5 checks rápidos) |
+| `neetru new <slug>` | Criar produto completo (registry + workspace + scaffold) |
+| `neetru init <name>` | Só scaffold local Next.js + Firebase |
+| `neetru add <feature>` | Adicionar features ao scaffold (auth, billing, etc) |
+| `neetru deploy` | Pipeline de deploy interativo (cloud-run / vm / workspace) |
+| `neetru build` | Empacotar produto em tarball pra deploy |
+| `neetru promote` | Promover dev → staging → prod |
+| `neetru env switch <target>` | Trocar `NEETRU_ENV` no `.env.local` |
+| `neetru env set --service=X --set KEY=VAL` | Setar env vars de serviço Cloud Run |
+| `neetru ar create <name>` | Criar repositório Artifact Registry |
+| `neetru hosting create-mapping --service=X --domain=Y` | Domain mapping |
+| `neetru db create --product=X --engine=postgres` | Criar banco por produto |
+| `neetru db engines` | Listar engines disponíveis (firestore, postgres, mysql) |
+| `neetru cloud-run pause/resume/delete <service>` | Controle Cloud Run |
+| `neetru products list/create/update` | Registry de produtos |
+| `neetru workspaces create/list/get/advance` | Instâncias por cliente |
+| `neetru deployments create/rollback` | Histórico de deploys |
+| `neetru tenants list/create/update/suspend` | Gerenciar tenants |
+| `neetru audit tail` | Tail de `audit_logs/` em tempo real |
+| `neetru billing summary` | Resumo de billing |
+| `neetru servers list/provision/deactivate` | Gerenciar servidores |
+| `neetru agent release/yank/canary` | Gerenciar releases do agente |
+| `neetru support tickets list/reply/assign` | Suporte inbox staff |
+| `neetru dns zones list` / `hosting list` | Listar DNS + customer domains |
+| `neetru builds list` | Listar Cloud Build |
+| `neetru dr exports/restore` | Disaster Recovery |
+| `neetru logs` | Ver logs de produtos |
+| `neetru status` | Visão geral do ecossistema |
+| `neetru open <produto>` | Abrir cockpit do produto no browser |
+| `neetru ai` | REPL IA Neetru-aware (Claude/OpenAI/Gemini) |
+| `neetru ui` | Menu interativo do CLI |
+| `neetru publish` | Publicar produto no catálogo público |
+| `neetru upgrade` | Auto-update do CLI |
+| `neetru autocomplete <bash\|zsh\|pwsh>` | Gerar script autocomplete |
+
+**Atalhos:** `neetru ar` = `artifact-registry`, `neetru menu` = `ui`.
+
+40+ subcomandos. Quase todos suportam `--json` pra automação.
+
+## Configuração
+
+Token Bearer fica em `~/.config/neetru-cli/auth.json` (chmod 0600 em Unix, NTFS ACL em Windows) — gerado por `neetru login` via OAuth Device Code Flow. Configs gerais ficam em `~/.config/neetru-cli/config.json` (Linux/macOS) ou `%APPDATA%\neetru-cli\config.json` (Windows):
+
+| Chave | Valor |
+|---|---|
+| `neetruApiUrl` | URL base do Core (default `https://api.neetru.com`). **Allowlist** desde 2.11.0: `*.neetru.com` + `localhost`; demais hosts exigem `--allow-untrusted-url` |
+| `defaultModel` | `claude` / `openai` / `gemini` / `auto` (REPL `neetru ai`) |
+| `telemetry.enabled` | Telemetry opt-in (default `false`) — desde 2.11.0 emite eventos anônimos pra `/api/sdk/v1/telemetry/log` |
+| `neetruApiKey` | **(legado)** Token em Conf — substituído por `auth.json`. Será removido em 2.12.0 |
+
+```bash
+neetru config set telemetry.enabled true
+neetru config get neetruApiUrl
+neetru config path           # mostra caminho do config file
+neetru config set neetruApiUrl https://staging.neetru.com   # subdomínio neetru.com — OK
+neetru config set neetruApiUrl http://my-proxy.local --allow-untrusted-url   # explicit opt-in
+```
+
+## Output JSON
+
+```bash
+neetru products list --json | jq '.[] | select(.status == "ativo")'
+neetru audit tail --json | jq 'select(.action | startswith("billing"))'
+```
+
+## Auth & Segurança
+
+- **OAuth Device Code Flow** (RFC 8628) pra login interativo — não armazena password
+- **Tokens** salvos em `~/.config/neetru-cli/auth.json` (chmod 0600 em Unix, NTFS ACL em Windows). Desde 2.11.0 o resolver canônico (`getActiveTokenSync`) prefere esse arquivo sobre o Conf storage legado (que será removido em 2.12.0)
+- **URL allowlist** (desde 2.11.0): `neetruApiUrl` rejeita hosts fora de `*.neetru.com` + `localhost` sem `--allow-untrusted-url` — fecha vetor de exfiltração do Bearer token
+- **Rate-limit** por método HTTP: GET 120/min, POST/PUT/PATCH 30/min, DELETE 5/min
+- **Step-up MFA** (TOTP) obrigatório em operações destrutivas: `--mfa-token <code>` ou prompt
+- **Dry-run** disponível em comandos de mutação: `--dry-run` mostra efeito SEM aplicar
+- **Telemetry** opt-in (desde 2.11.0): habilitando `telemetry.enabled=true` o CLI emite `{command, durationMs, ok, exitCode}` anônimo via `installId` UUID. Zero token/path/email/env vazam
+
+## Stack
+
+- TypeScript 5 ESM-first
+- Node 22+ (LTS)
+- Sem `node-fetch`/`axios`: fetch global nativo
+- Commander 11 (CLI framework) + Inquirer 12 (prompts) + Chalk 5 + Ora (spinners)
+
+## Mais info
+
+- **Repo:** [github.com/Neetru/neetru-core](https://github.com/Neetru/neetru-core)
+- **Docs:** [docs.neetru.com](https://docs.neetru.com)
+- **SDK complementar:** `npm install @neetru/sdk`
+- **Issues / suporte:** abrir issue no repo ou `neetru support`
+
+## Licença
+
+MIT © Neetru

package/dist/commands/ai.js

@@ -10,14 +10,14 @@ const PROMPT_PREFIX = chalk.hex('#1E90FF').bold('  › ');
 const ASSISTANT_PREFIX = chalk.dim('  ◆ ');
 // Help público — sem /modelo (orchestrator escolhe). /debug:model é o
 // override avançado pra quem quer forçar.
-const HELP_TEXT = `
-  Comandos:
-    /sair  /exit         encerrar sessão
-    /limpar /clear       limpar histórico de contexto
-    /agentes <pergunta>  consultar 2+ modelos em paralelo e comparar
-    /auth                rodar wizard de configuração (claude/codex/gemini)
-    /help                mostrar este texto
-    /debug:model <nome>  forçar modelo (claude|openai|gemini|auto)
+const HELP_TEXT = `
+  Comandos:
+    /sair  /exit         encerrar sessão
+    /limpar /clear       limpar histórico de contexto
+    /agentes <pergunta>  consultar 2+ modelos em paralelo e comparar
+    /auth                rodar wizard de configuração (claude/codex/gemini)
+    /help                mostrar este texto
+    /debug:model <nome>  forçar modelo (claude|openai|gemini|auto)
 `.trim();
 /**
  * Checa se o usuário tem pelo menos uma cred (local OU descoberta). Se zero,

package/dist/commands/autocomplete.js

@@ -84,49 +84,49 @@ export const TOP_LEVEL_COMMANDS = [
 ];
 function bashScript() {
     const cmds = TOP_LEVEL_COMMANDS.join(' ');
-    return `# neetru CLI bash completion (v2.10.2)
-_neetru_complete() {
-  local cur prev
-  COMPREPLY=()
-  cur="\${COMP_WORDS[COMP_CWORD]}"
-  prev="\${COMP_WORDS[COMP_CWORD-1]}"
-  if [ \${COMP_CWORD} -eq 1 ]; then
-    COMPREPLY=( $(compgen -W "${cmds}" -- "\${cur}") )
-    return 0
-  fi
-}
-complete -F _neetru_complete neetru
+    return `# neetru CLI bash completion (v2.10.2)
+_neetru_complete() {
+  local cur prev
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  if [ \${COMP_CWORD} -eq 1 ]; then
+    COMPREPLY=( $(compgen -W "${cmds}" -- "\${cur}") )
+    return 0
+  fi
+}
+complete -F _neetru_complete neetru
 `;
 }
 function zshScript() {
     // Formato compsys do zsh.
     const cmds = TOP_LEVEL_COMMANDS.map((c) => `    '${c}'`).join('\n');
-    return `#compdef neetru
-# neetru CLI zsh completion (v2.10.2)
-_neetru() {
-  local -a commands
-  commands=(
-${cmds}
-  )
-  if (( CURRENT == 2 )); then
-    _describe 'command' commands
-  fi
-}
-_neetru "$@"
+    return `#compdef neetru
+# neetru CLI zsh completion (v2.10.2)
+_neetru() {
+  local -a commands
+  commands=(
+${cmds}
+  )
+  if (( CURRENT == 2 )); then
+    _describe 'command' commands
+  fi
+}
+_neetru "$@"
 `;
 }
 function pwshScript() {
     const cmds = TOP_LEVEL_COMMANDS.map((c) => `    '${c}'`).join(',\n');
-    return `# neetru CLI PowerShell completion (v2.10.2)
-Register-ArgumentCompleter -Native -CommandName neetru -ScriptBlock {
-  param($wordToComplete, $commandAst, $cursorPosition)
-  $commands = @(
-${cmds}
-  )
-  $commands | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
-    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
-  }
-}
+    return `# neetru CLI PowerShell completion (v2.10.2)
+Register-ArgumentCompleter -Native -CommandName neetru -ScriptBlock {
+  param($wordToComplete, $commandAst, $cursorPosition)
+  $commands = @(
+${cmds}
+  )
+  $commands | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+  }
+}
 `;
 }
 export function generateAutocompleteScript(shell) {

package/dist/commands/db.js

@@ -213,64 +213,64 @@ export async function runDbStatus(dbId, opts = {}) {
 }
 // pdv #7 fix: template diferenciado por família de engine.
 /** Template para engines NoSQL (firestore-instance). */
-const SCHEMA_STARTER_NOSQL = (productId, engine) => `/**
- * Schema do banco "${productId}" — ${ENGINE_LABELS[engine] ?? engine}.
- *
- * Gerado por \`neetru db init\`.
- * Edite este arquivo com as collections do seu produto.
- * Rode \`neetru db apply\` pra enviar a definição ao Core.
- *
- * Para bancos NoSQL (Firestore), o schema define a estrutura esperada
- * dos documentos. O Core usa essa definição para validação e auditoria —
- * o banco em si é schemaless (primeira escrita cria a estrutura).
- *
- * Documentação: https://core.neetru.com/docs/dev/db/nosql-schema
- */
-
-// Exemplo de collection com tipagem TypeScript pura:
-
-export interface Produto {
-  id: string;
-  nome: string;
-  preco: number;
-  ativo: boolean;
-  criadoEm: Date;
-}
-
-export interface Pedido {
-  id: string;
-  produtoId: string;
-  quantidade: number;
-  total: number;
-  status: 'pendente' | 'pago' | 'cancelado';
-  criadoEm: Date;
-}
-
-// Exporte as collections que o SDK vai usar:
-// import { createNeetruClient } from '@neetru/sdk';
-// const neetru = createNeetruClient({ ... });
-// const produtos = neetru.db.collection<Produto>('produtos');
-// const pedidos = neetru.db.collection<Pedido>('pedidos');
+const SCHEMA_STARTER_NOSQL = (productId, engine) => `/**
+ * Schema do banco "${productId}" — ${ENGINE_LABELS[engine] ?? engine}.
+ *
+ * Gerado por \`neetru db init\`.
+ * Edite este arquivo com as collections do seu produto.
+ * Rode \`neetru db apply\` pra enviar a definição ao Core.
+ *
+ * Para bancos NoSQL (Firestore), o schema define a estrutura esperada
+ * dos documentos. O Core usa essa definição para validação e auditoria —
+ * o banco em si é schemaless (primeira escrita cria a estrutura).
+ *
+ * Documentação: https://core.neetru.com/docs/dev/db/nosql-schema
+ */
+
+// Exemplo de collection com tipagem TypeScript pura:
+
+export interface Produto {
+  id: string;
+  nome: string;
+  preco: number;
+  ativo: boolean;
+  criadoEm: Date;
+}
+
+export interface Pedido {
+  id: string;
+  produtoId: string;
+  quantidade: number;
+  total: number;
+  status: 'pendente' | 'pago' | 'cancelado';
+  criadoEm: Date;
+}
+
+// Exporte as collections que o SDK vai usar:
+// import { createNeetruClient } from '@neetru/sdk';
+// const neetru = createNeetruClient({ ... });
+// const produtos = neetru.db.collection<Produto>('produtos');
+// const pedidos = neetru.db.collection<Pedido>('pedidos');
 `;
 /** Template padrão para engines SQL (PostgreSQL/MySQL). */
-const SCHEMA_STARTER_SQL = (productId, engine) => `/**
- * Schema do banco "${productId}" — ${ENGINE_LABELS[engine] ?? engine}.
- *
- * Gerado por \`neetru db init\`.
- * Edite este arquivo e rode \`neetru db apply\` pra enviar a migração ao Core.
- */
-
-// Exemplo com DrizzleORM (PostgreSQL):
-// import { pgTable, serial, text, timestamp } from 'drizzle-orm/pg-core';
-//
-// export const usuarios = pgTable('usuarios', {
-//   id: serial('id').primaryKey(),
-//   email: text('email').notNull().unique(),
-//   criadoEm: timestamp('criado_em').defaultNow(),
-// });
-
-// Remova o comentário acima e adapte ao seu schema.
-export {};
+const SCHEMA_STARTER_SQL = (productId, engine) => `/**
+ * Schema do banco "${productId}" — ${ENGINE_LABELS[engine] ?? engine}.
+ *
+ * Gerado por \`neetru db init\`.
+ * Edite este arquivo e rode \`neetru db apply\` pra enviar a migração ao Core.
+ */
+
+// Exemplo com DrizzleORM (PostgreSQL):
+// import { pgTable, serial, text, timestamp } from 'drizzle-orm/pg-core';
+//
+// export const usuarios = pgTable('usuarios', {
+//   id: serial('id').primaryKey(),
+//   email: text('email').notNull().unique(),
+//   criadoEm: timestamp('criado_em').defaultNow(),
+// });
+
+// Remova o comentário acima e adapte ao seu schema.
+export {};
 `;
 /** Conteúdo do `db/schema.ts` gerado durante o init. */
 const SCHEMA_STARTER = (productId, engine) => {

package/dist/commands/deploy.d.ts

@@ -1,3 +1,14 @@
+/**
+ * bug_a5786e03 (2026-05-31): o Core/agente só conhecem os stacks canônicos
+ * `node|docker|php-apache|static` (PRODUCT_STACKS). `nextjs` é um alias de
+ * conveniência da CLI — gera um Dockerfile Next.js (ensureDockerfile) e roda
+ * como `node` no agente VM (`next start` + reverse-proxy; o stack `docker` do
+ * agente nem é implementado em VM) e o Cloud Run builda o Dockerfile igual.
+ * Mandar `nextjs` literal ao Core dava 400 "invalid enum". Mapeamos pro stack
+ * canônico ANTES de enviar; o `--stack=nextjs` continua válido pro usuário e
+ * pra geração do Dockerfile.
+ */
+export declare function toCoreStack(stack: string | undefined): string | undefined;
 export interface DeployOptions {
     product?: string;
     version?: string;

package/dist/commands/deploy.js

@@ -32,6 +32,19 @@ import { readDbJson, schemaFingerprint } from '../lib/db-local/index.js';
 import { assertIamReady } from '../lib/iam-preflight.js';
 import { getActiveTokenSync } from '../lib/token-resolver.js';
 import { safeExit } from '../utils/safe-exit.js';
+/**
+ * bug_a5786e03 (2026-05-31): o Core/agente só conhecem os stacks canônicos
+ * `node|docker|php-apache|static` (PRODUCT_STACKS). `nextjs` é um alias de
+ * conveniência da CLI — gera um Dockerfile Next.js (ensureDockerfile) e roda
+ * como `node` no agente VM (`next start` + reverse-proxy; o stack `docker` do
+ * agente nem é implementado em VM) e o Cloud Run builda o Dockerfile igual.
+ * Mandar `nextjs` literal ao Core dava 400 "invalid enum". Mapeamos pro stack
+ * canônico ANTES de enviar; o `--stack=nextjs` continua válido pro usuário e
+ * pra geração do Dockerfile.
+ */
+export function toCoreStack(stack) {
+    return stack === 'nextjs' ? 'node' : stack;
+}
 const TERMINAL_STATUSES = new Set(['success', 'failed', 'cancelled']);
 /** Estágios de ambiente válidos para o deploy workspace. */
 const WORKSPACE_ENVS = new Set(['dev', 'staging', 'prod']);
@@ -1053,7 +1066,8 @@ export async function runDeploy(opts) {
     const body = {
         productSlug,
         version: artifact.manifest?.version ?? opts.version ?? '0.0.0',
-        stack: opts.stack ?? artifact.manifest?.stack ?? 'node',
+        // bug_a5786e03: mapeia nextjs→node (Core/agente não conhecem `nextjs`).
+        stack: toCoreStack(opts.stack ?? artifact.manifest?.stack) ?? 'node',
         target,
         artifactUrl: artifact.artifactUrl,
         artifactSha256: artifact.artifactSha256,