@neetru/cli 2.2.0 → 2.4.0

package/dist/index.js

@@ -5,22 +5,30 @@ import { CLI_VERSION } from './version.js';
 const program = new Command();
 program
     .name('neetru')
-    .description('Neetru Developer Kit — scaffold, AI assistant e deploy para produtos SaaS')
+    .description('Operar o Neetru Developer Kit (scaffold, AI, deploy)')
     .version(CLI_VERSION);
 // ── neetru ai ─────────────────────────────────────────────────────────
 program
     .command('ai')
-    .description('REPL interativo com IA Neetru-aware (Claude / OpenAI / Gemini)')
+    .description('Abrir REPL de IA Neetru-aware (Claude/OpenAI/Gemini)')
     .option('-m, --model <model>', 'modelo: claude | openai | gemini | auto', 'auto')
     .action(async (opts) => {
     const { runAiRepl } = await import('./commands/ai.js');
     await runAiRepl({ model: opts.model });
 });
+program
+    .command('ui')
+    .alias('menu')
+    .description('Abrir a interface interativa do Neetru CLI')
+    .action(async () => {
+    const { runTerminalUi } = await import('./commands/ui.js');
+    await runTerminalUi();
+});
 // ── neetru init ───────────────────────────────────────────────────────
 // v2.1.1 — prompt interativo de caminho + merge mode + preserva arquivos
 program
     .command('init <name>')
-    .description('Scaffold de novo produto SaaS Neetru (interativo — escolhe new subdir | merge cwd | custom path)')
+    .description('Inicializar scaffold de produto SaaS Neetru')
     .option('--type <type>', 'nextjs | node-api', 'nextjs')
     .option('--here', 'init no cwd atual (modo merge — preserva existentes)')
     .option('--path <path>', 'custom path target')
@@ -41,7 +49,7 @@ program
 // Cria produto + workspace + scaffold local + abre painel — single command.
 program
     .command('new <name>')
-    .description('Macro: cria produto + workspace + scaffold + abre painel (end-to-end)')
+    .description('Criar produto, workspace, scaffold e abrir painel')
     .option('--product-slug <slug>', 'slug do produto (default: derivado de <name>)')
     .option('--env <env>', 'dev (default) | staging | prod', 'dev')
     .option('--tier <tier>', 'standard (default) | dev | enterprise', 'standard')
@@ -61,27 +69,56 @@ program
         json: !!opts.json,
     });
 });
+// ── neetru auth ───────────────────────────────────────────────────────
+// Wave D — detecta Claude Code/Codex/Gemini instalados e reaproveita creds.
+const authCmd = program
+    .command('auth')
+    .description('Gerenciar credenciais de IA (Claude, Codex, Gemini)');
+authCmd
+    .command('status')
+    .description('Listar provedores detectados e estado das credenciais')
+    .option('--json', 'saída JSON')
+    .action(async (opts) => {
+    const { runAuthStatus } = await import('./commands/auth.js');
+    await runAuthStatus({ json: !!opts.json });
+});
+authCmd
+    .command('setup')
+    .description('Wizard interativo: detectar, instalar, configurar')
+    .option('--json', 'modo não-interativo (equivalente a pull)')
+    .action(async (opts) => {
+    const { runAuthSetup } = await import('./commands/auth.js');
+    await runAuthSetup({ json: !!opts.json });
+});
+authCmd
+    .command('pull')
+    .description('Copiar creds dos CLIs detectados pra config do Neetru')
+    .option('--json', 'saída JSON')
+    .action(async (opts) => {
+    const { runAuthPull } = await import('./commands/auth.js');
+    await runAuthPull({ json: !!opts.json });
+});
 // ── neetru config ─────────────────────────────────────────────────────
 const configCmd = program
     .command('config')
-    .description('Gerenciar configurações do CLI (chaves de API, modelo padrão)');
+    .description('Gerenciar configurações do CLI');
 configCmd
     .command('set <key> <value>')
-    .description('Define uma configuração')
+    .description('Definir valor de configuração')
     .action(async (key, value) => {
     const { configSet } = await import('./commands/config.js');
     configSet(key, value);
 });
 configCmd
     .command('get [key]')
-    .description('Lê configuração(ões)')
+    .description('Ler configuração por chave (ou todas)')
     .action(async (key) => {
     const { configGet } = await import('./commands/config.js');
     configGet(key);
 });
 configCmd
     .command('path')
-    .description('Mostra o caminho do arquivo de configuração')
+    .description('Mostrar caminho do arquivo de configuração')
     .action(async () => {
     const { configPath } = await import('./commands/config.js');
     configPath();
@@ -89,7 +126,7 @@ configCmd
 // ── neetru login ──────────────────────────────────────────────────────
 program
     .command('login')
-    .description('Autentica o CLI via Device Code OAuth (RFC 8628)')
+    .description('Autenticar CLI via Device Code OAuth (RFC 8628)')
     .option('--token <token>', 'token nrt_<keyId>_<secret> (modo CI/legado, pula browser)')
     .option('--json', 'saída em JSON (machine-readable)')
     .action(async (opts) => {
@@ -99,7 +136,7 @@ program
 // ── neetru logout ─────────────────────────────────────────────────────
 program
     .command('logout')
-    .description('Apaga as credenciais locais (~/.config/neetru-cli/auth.json + cache legado)')
+    .description('Remover credenciais locais do CLI')
     .action(async () => {
     const { runLogout } = await import('./commands/logout.js');
     await runLogout();
@@ -107,7 +144,7 @@ program
 // ── neetru whoami ─────────────────────────────────────────────────────
 program
     .command('whoami')
-    .description('Mostra a identidade da chave CLI corrente')
+    .description('Mostrar identidade da chave CLI corrente')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
     const { runWhoami } = await import('./commands/whoami.js');
@@ -116,7 +153,7 @@ program
 // ── neetru build ──────────────────────────────────────────────────────
 program
     .command('build')
-    .description('Empacota o produto no diretório atual num tarball pronto para deploy')
+    .description('Construir tarball do produto pronto para deploy')
     .option('--product <slug>', 'override do slug (default: lê neetru.config.json)')
     .option('--stack <stack>', 'node | docker | php-apache | static (default: detectado)')
     .option('--output <dir>', 'diretório de saída', '.neetru-build')
@@ -135,7 +172,7 @@ program
 // ── neetru deploy ─────────────────────────────────────────────────────
 program
     .command('deploy')
-    .description('Deploy do produto via pipeline Neetru Core (interativo por default)')
+    .description('Deployar produto via pipeline do Neetru Core')
     .option('--product <slug>', 'slug do produto')
     .option('--version <version>', 'versão a deployar')
     .option('--stack <stack>', 'node | docker | php-apache | static')
@@ -174,7 +211,7 @@ program
 // delega ao status de workspace legado (backward-compat).
 program
     .command('status')
-    .description('Saúde das superfícies públicas (landing/api/portal/políticas). --client-id = status de workspace')
+    .description('Verificar saúde das superfícies públicas do Core')
     .option('--client-id <id>', 'oauthClientId do workspace (status de workspace legado)')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
@@ -184,10 +221,10 @@ program
 // ── neetru tenants ────────────────────────────────────────────────────
 const tenantsCmd = program
     .command('tenants')
-    .description('Control plane — inspeção de tenants (read-only)');
+    .description('Gerenciar tenants (read-only)');
 tenantsCmd
     .command('list')
-    .description('Lista tenants (filtros --status / --product)')
+    .description('Listar tenants')
     .option('--status <status>', 'ativo | em provisionamento | suspenso | arquivado')
     .option('--product <productId>', 'filtra por productId')
     .option('--limit <n>', 'máximo de resultados (default 100, max 500)')
@@ -202,8 +239,8 @@ tenantsCmd
     });
 });
 tenantsCmd
-    .command('get <id>')
-    .description('Detalha um tenant pelo ID')
+    .command('get [id]')
+    .description('Mostrar detalhes de um tenant')
     .option('--json', 'saída em JSON')
     .action(async (id, opts) => {
     const { runTenantsGet } = await import('./commands/tenants.js');
@@ -211,12 +248,12 @@ tenantsCmd
 });
 tenantsCmd
     .command('create')
-    .description('Cria um tenant (status inicial: em provisionamento)')
-    .requiredOption('--name <name>', 'nome do tenant')
-    .requiredOption('--slug <slug>', 'slug do tenant')
-    .requiredOption('--customer <customerId>', 'id do customer')
-    .requiredOption('--product <productId>', 'id do produto')
-    .requiredOption('--env <env>', 'dev | staging | prod')
+    .description('Criar tenant (status inicial: em provisionamento)')
+    .option('--name <name>', 'nome do tenant')
+    .option('--slug <slug>', 'slug do tenant')
+    .option('--customer <customerId>', 'id do customer')
+    .option('--product <productId>', 'id do produto (interativo se ausente)')
+    .option('--env <env>', 'dev | staging | prod (default: dev)')
     .option('--domain <domain>', 'domínio primário')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
@@ -232,13 +269,13 @@ tenantsCmd
     });
 });
 tenantsCmd
-    .command('update <id>')
-    .description('Atualiza dados de um tenant existente')
-    .requiredOption('--name <name>', 'nome do tenant')
-    .requiredOption('--slug <slug>', 'slug do tenant')
-    .requiredOption('--customer <customerId>', 'id do customer')
-    .requiredOption('--product <productId>', 'id do produto')
-    .requiredOption('--env <env>', 'dev | staging | prod')
+    .command('update [id]')
+    .description('Atualizar dados de um tenant')
+    .option('--name <name>', 'nome do tenant')
+    .option('--slug <slug>', 'slug do tenant')
+    .option('--customer <customerId>', 'id do customer')
+    .option('--product <productId>', 'id do produto (interativo se ausente)')
+    .option('--env <env>', 'dev | staging | prod (default: dev)')
     .option('--domain <domain>', 'domínio primário')
     .option('--json', 'saída em JSON')
     .action(async (id, opts) => {
@@ -254,8 +291,8 @@ tenantsCmd
     });
 });
 tenantsCmd
-    .command('suspend <id>')
-    .description('Suspende um tenant (destrutivo — confirmação interativa)')
+    .command('suspend [id]')
+    .description('Suspender tenant (destrutivo — exige confirmação)')
     .option('--yes', 'pula a confirmação interativa (modo script)')
     .option('--force', 'alias de --yes')
     .option('--json', 'saída em JSON')
@@ -264,8 +301,8 @@ tenantsCmd
     await runTenantsSuspend(id, { yes: !!opts.yes, force: !!opts.force, json: !!opts.json });
 });
 tenantsCmd
-    .command('reactivate <id>')
-    .description('Reativa um tenant suspenso')
+    .command('reactivate [id]')
+    .description('Reativar tenant suspenso')
     .option('--json', 'saída em JSON')
     .action(async (id, opts) => {
     const { runTenantsReactivate } = await import('./commands/tenants.js');
@@ -274,10 +311,10 @@ tenantsCmd
 // ── neetru audit ──────────────────────────────────────────────────────
 const auditCmd = program
     .command('audit')
-    .description('Control plane — trilha de auditoria do Core (read-only)');
+    .description('Consultar trilha de auditoria do Core (read-only)');
 auditCmd
     .command('tail')
-    .description('Últimos N eventos de audit_logs (mais recente primeiro)')
+    .description('Listar últimos eventos de audit_logs')
     .option('-n, --limit <n>', 'número de eventos (default 50, max 200)')
     .option('--action <substring>', 'filtra por substring da ação (ex: billing, tenant.create)')
     .option('--severity <level>', 'info | warning | critical')
@@ -296,10 +333,10 @@ auditCmd
 // ── neetru billing ────────────────────────────────────────────────────
 const billingCmd = program
     .command('billing')
-    .description('Control plane — billing/contabilidade (read-only)');
+    .description('Consultar billing e contabilidade (read-only)');
 billingCmd
     .command('summary')
-    .description('Sumário contábil do mês corrente (MRR, invoices, subscriptions)')
+    .description('Mostrar sumário contábil do mês (MRR, invoices, subs)')
     .option('--year <YYYY>', 'ano (default: corrente)')
     .option('--month <1-12>', 'mês (default: corrente)')
     .option('--json', 'saída em JSON')
@@ -310,18 +347,24 @@ billingCmd
 // ── neetru servers ────────────────────────────────────────────────────
 const serversCmd = program
     .command('servers')
-    .description('Control plane — inventário de servers (read-only)');
+    .description('Gerenciar servers e inventário de VMs');
 serversCmd
     .command('list')
-    .description('Lista servers (filtros --status / --provider / --capacity)')
-    .option('--status <status>', 'online (operacional + heartbeat fresco)')
+    .description('Listar servers')
+    .option('--status <status>', 'online | operacional (ativo) ou offline | desconectado (inativo)')
     .option('--provider <provider>', 'hetzner | digitalocean | aws | ...')
     .option('--capacity', 'inclui colunas de RAM/CPU/disco')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
+    const STATUS_ALIASES = {
+        operacional: 'online',
+        desconectado: 'offline',
+    };
+    const rawStatus = opts.status;
+    const resolvedStatus = rawStatus ? (STATUS_ALIASES[rawStatus] ?? rawStatus) : undefined;
     const { runServersList } = await import('./commands/servers.js');
     await runServersList({
-        status: opts.status,
+        status: resolvedStatus,
         provider: opts.provider,
         capacity: !!opts.capacity,
         json: !!opts.json,
@@ -329,10 +372,10 @@ serversCmd
 });
 serversCmd
     .command('provision')
-    .description('Provisiona uma VM GCP (admin only) — cria server + registration token')
-    .requiredOption('--name <name>', 'nome do servidor')
-    .requiredOption('--zone <zone>', 'zona GCP (ex: us-central1-a)')
-    .requiredOption('--machine-type <type>', 'machine type GCP (ex: e2-small)')
+    .description('Provisionar VM GCP e gerar registration token (admin)')
+    .option('--name <name>', 'nome do servidor')
+    .option('--zone <zone>', 'zona GCP (ex: us-central1-a)')
+    .option('--machine-type <type>', 'machine type GCP (ex: e2-small)')
     .option('--tenant <tenantId>', 'tenant associado')
     .option('--customer <customerId>', 'customer associado')
     .option('--json', 'saída em JSON')
@@ -348,8 +391,8 @@ serversCmd
     });
 });
 serversCmd
-    .command('deactivate <serverId>')
-    .description('Desativa um server (destrutivo top-tier — confirmação + step-up MFA)')
+    .command('deactivate [serverId]')
+    .description('Desativar server (destrutivo top-tier — exige MFA)')
     .option('--yes', 'pula a confirmação interativa (modo script)')
     .option('--force', 'alias de --yes')
     .option('--dry-run', 'valida e mostra o efeito sem aplicar')
@@ -366,8 +409,8 @@ serversCmd
     });
 });
 serversCmd
-    .command('dispatch <serverId> <commandType>')
-    .description('Enfileira um comando pro agente Linux do server')
+    .command('dispatch [serverId] [commandType]')
+    .description('Enfileirar comando para o agente Linux do server')
     .option('--params <json>', 'objeto JSON de params do comando')
     .option('--json', 'saída em JSON')
     .action(async (id, commandType, opts) => {
@@ -377,14 +420,14 @@ serversCmd
 // ── neetru workspaces ─────────────────────────────────────────────────
 const workspacesCmd = program
     .command('workspaces')
-    .description('Control plane — runtime shared de workspaces');
+    .description('Gerenciar workspaces compartilhados');
 workspacesCmd
     .command('create')
-    .description('Cria um workspace (devolve OAuth client secret one-time)')
-    .requiredOption('--product <productId>', 'id do produto')
-    .requiredOption('--customer <customerId>', 'id do customer')
-    .requiredOption('--env <env>', 'dev | staging | prod')
-    .requiredOption('--tier <tier>', 'dev | standard | enterprise')
+    .description('Criar workspace (retorna OAuth secret one-time)')
+    .option('--product <productId>', 'id do produto (interativo se ausente)')
+    .option('--customer <customerId>', 'id do customer (default: self/Neetru)')
+    .option('--env <env>', 'dev | staging | prod (default: dev)')
+    .option('--tier <tier>', 'dev | standard | enterprise (default: standard)')
     .option('--name <name>', 'label do workspace')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
@@ -399,10 +442,10 @@ workspacesCmd
     });
 });
 workspacesCmd
-    .command('advance <workspaceId>')
-    .description('Promove uma versão de bundle pra "running" no workspace')
-    .requiredOption('--product <slug>', 'productSlug do bundle')
-    .requiredOption('--version <version>', 'versão do bundle a ativar')
+    .command('advance [workspaceId]')
+    .description('Promover versão de bundle para running no workspace')
+    .option('--product <slug>', 'productSlug do bundle (interativo se ausente)')
+    .option('--version <version>', 'versão do bundle a ativar')
     .option('--json', 'saída em JSON')
     .action(async (id, opts) => {
     const { runWorkspacesAdvance } = await import('./commands/workspaces.js');
@@ -414,7 +457,7 @@ workspacesCmd
 });
 workspacesCmd
     .command('list')
-    .description('Lista workspaces (filtros --product / --env / --status)')
+    .description('Listar workspaces')
     .option('--product <productId>', 'filtra por productId')
     .option('--env <env>', 'dev | staging | prod')
     .option('--status <status>', 'active | paused | provisioning | …')
@@ -429,16 +472,16 @@ workspacesCmd
     });
 });
 workspacesCmd
-    .command('get <workspaceId>')
-    .description('Detalha um workspace pelo ID')
+    .command('get [workspaceId]')
+    .description('Mostrar detalhes de um workspace')
     .option('--json', 'saída em JSON')
     .action(async (id, opts) => {
     const { runWorkspacesGet } = await import('./commands/workspaces.js');
     await runWorkspacesGet(id, { json: !!opts.json });
 });
 workspacesCmd
-    .command('open <workspaceId>')
-    .description('Abre o painel do workspace no browser (core.neetru.com/workspaces/<id>)')
+    .command('open [workspaceId]')
+    .description('Abrir painel do workspace no browser')
     .action(async (id) => {
     const { runWorkspacesOpen } = await import('./commands/workspaces.js');
     await runWorkspacesOpen(id);
@@ -446,15 +489,15 @@ workspacesCmd
 // ── neetru deployments ────────────────────────────────────────────────
 const deploymentsCmd = program
     .command('deployments')
-    .description('Control plane — recurso deployments/ (paridade com a UI)');
+    .description('Gerenciar deployments do Core');
 deploymentsCmd
     .command('create')
-    .description('Cria um deployment (dispara comando deploy pro agente)')
-    .requiredOption('--product <productId>', 'id do produto')
-    .requiredOption('--tenant <tenantId>', 'id do tenant alvo')
-    .requiredOption('--version <version>', 'versão a deployar')
-    .requiredOption('--env <env>', 'dev | staging | prod')
-    .requiredOption('--server <serverId>', 'id do server alvo')
+    .description('Criar deployment (dispara comando para o agente)')
+    .option('--product <productId>', 'id do produto (interativo se ausente)')
+    .option('--tenant <tenantId>', 'id do tenant alvo (interativo se ausente)')
+    .option('--version <version>', 'versao a deployar')
+    .option('--env <env>', 'dev | staging | prod (default: dev)')
+    .option('--server <serverId>', 'id do server alvo (interativo se ausente)')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
     const { runDeploymentsCreate } = await import('./commands/deployments.js');
@@ -469,7 +512,7 @@ deploymentsCmd
 });
 deploymentsCmd
     .command('rollback <deploymentId>')
-    .description('Rollback de um deployment (destrutivo top-tier — confirmação + step-up MFA)')
+    .description('Reverter deployment (destrutivo top-tier — exige MFA)')
     .option('--yes', 'pula a confirmação interativa (modo script)')
     .option('--force', 'alias de --yes')
     .option('--dry-run', 'valida e mostra o efeito sem aplicar')
@@ -488,10 +531,10 @@ deploymentsCmd
 // ── neetru cloud-run ──────────────────────────────────────────────────
 const cloudRunCmd = program
     .command('cloud-run')
-    .description('Control plane — serviços Cloud Run (admin only)');
+    .description('Gerenciar serviços Cloud Run (admin)');
 cloudRunCmd
     .command('pause <service>')
-    .description('Pausa um serviço Cloud Run (scale-to-zero)')
+    .description('Pausar serviço Cloud Run (scale-to-zero)')
     .option('--json', 'saída em JSON')
     .action(async (service, opts) => {
     const { runCloudRunPause } = await import('./commands/cloud-run.js');
@@ -499,7 +542,7 @@ cloudRunCmd
 });
 cloudRunCmd
     .command('resume <service>')
-    .description('Retoma um serviço Cloud Run pausado')
+    .description('Retomar serviço Cloud Run pausado')
     .option('--min-instances <n>', 'minInstanceCount')
     .option('--max-instances <n>', 'maxInstanceCount')
     .option('--json', 'saída em JSON')
@@ -513,7 +556,7 @@ cloudRunCmd
 });
 cloudRunCmd
     .command('delete <service>')
-    .description('Exclui um serviço Cloud Run (IRREVERSÍVEL — confirmação + step-up MFA)')
+    .description('Remover serviço Cloud Run (IRREVERSÍVEL — exige MFA)')
     .option('--yes', 'pula a confirmação interativa (modo script)')
     .option('--force', 'alias de --yes')
     .option('--dry-run', 'valida e mostra o efeito sem aplicar')
@@ -532,10 +575,10 @@ cloudRunCmd
 // ── neetru api-catalog ────────────────────────────────────────────────
 const apiCatalogCmd = program
     .command('api-catalog')
-    .description('Control plane — registry de APIs versionadas (apis/)');
+    .description('Gerenciar catálogo de APIs versionadas');
 apiCatalogCmd
     .command('create <slug>')
-    .description('Registra uma nova API no catálogo')
+    .description('Registrar nova API no catálogo')
     .requiredOption('--name <name>', 'nome da API')
     .requiredOption('--base-url <url>', 'base URL')
     .requiredOption('--version <version>', 'versão')
@@ -565,7 +608,7 @@ apiCatalogCmd
 });
 apiCatalogCmd
     .command('update <slug>')
-    .description('Atualiza uma entrada do catálogo (slug é imutável)')
+    .description('Atualizar entrada do catálogo (slug imutável)')
     .requiredOption('--name <name>', 'nome da API')
     .requiredOption('--base-url <url>', 'base URL')
     .requiredOption('--version <version>', 'versão')
@@ -595,7 +638,7 @@ apiCatalogCmd
 });
 apiCatalogCmd
     .command('archive <slug>')
-    .description('Soft-delete de uma API (--unarchive reativa)')
+    .description('Arquivar API por soft-delete (--unarchive reverte)')
     .option('--unarchive', 'reativa em vez de arquivar')
     .option('--yes', 'pula a confirmação interativa (modo script)')
     .option('--force', 'alias de --yes')
@@ -611,7 +654,7 @@ apiCatalogCmd
 });
 apiCatalogCmd
     .command('delete <slug>')
-    .description('Delete físico de uma API (IRREVERSÍVEL — confirmação + step-up MFA)')
+    .description('Remover API fisicamente (IRREVERSÍVEL — exige MFA)')
     .option('--yes', 'pula a confirmação interativa (modo script)')
     .option('--force', 'alias de --yes')
     .option('--dry-run', 'valida e mostra o efeito sem aplicar')
@@ -630,10 +673,10 @@ apiCatalogCmd
 // ── neetru products ───────────────────────────────────────────────────
 const productsCmd = program
     .command('products')
-    .description('Control plane — registry interno de produtos SaaS (read-only)');
+    .description('Gerenciar registry de produtos SaaS internos');
 productsCmd
     .command('list')
-    .description('Lista produtos internos (registry products/, filtro --status)')
+    .description('Listar produtos internos')
     .option('--status <status>', 'ativo | beta | descontinuado')
     .option('--limit <n>', 'máximo de resultados (default 100, max 500)')
     .option('--json', 'saída em JSON')
@@ -643,7 +686,7 @@ productsCmd
 });
 productsCmd
     .command('create')
-    .description('Cria um produto SaaS interno (interativo por default; --yes pra non-interactive)')
+    .description('Criar produto SaaS interno (interativo por default)')
     .option('--name <name>', 'nome do produto (interativo se ausente)')
     .option('--slug <slug>', 'slug (auto-derivado de --name se ausente)')
     .option('--description <text>', 'descrição (opcional)')
@@ -666,16 +709,16 @@ productsCmd
     });
 });
 productsCmd
-    .command('publish <slug>')
-    .description('Publica um produto no catálogo público (published=true)')
+    .command('publish [slug]')
+    .description('Publicar produto no catálogo público')
     .option('--json', 'saída em JSON')
     .action(async (slug, opts) => {
     const { runProductsPublish } = await import('./commands/products.js');
     await runProductsPublish(slug, { json: !!opts.json });
 });
 productsCmd
-    .command('unpublish <slug>')
-    .description('Remove um produto do catálogo público (published=false)')
+    .command('unpublish [slug]')
+    .description('Remover produto do catálogo público')
     .option('--json', 'saída em JSON')
     .action(async (slug, opts) => {
     const { runProductsUnpublish } = await import('./commands/products.js');
@@ -684,14 +727,14 @@ productsCmd
 // ── neetru products db (Phase A — per-product DB isolation) ────────────
 const productsDbCmd = productsCmd
     .command('db')
-    .description('Bancos de dados isolados por produto (firestore-instance | cloud-sql-* | vm-*)');
+    .description('Gerenciar bancos isolados por produto');
 productsDbCmd
     .command('list')
-    .description('Lista bancos. Filtros: --product-id, --engine, --status')
-    .option('--product-id <id>')
-    .option('--engine <engine>')
-    .option('--status <status>')
-    .option('--json')
+    .description('Listar bancos de produtos')
+    .option('--product-id <id>', 'ID do produto')
+    .option('--engine <engine>', 'firestore-instance | cloud-sql-postgres | cloud-sql-mysql | vm-postgres-single | vm-postgres-cluster | vm-mysql-single | vm-mysql-cluster')
+    .option('--status <status>', 'Filtrar por status (ativo, provisionando, falha, arquivado)')
+    .option('--json', 'Saída em JSON estruturado')
     .action(async (opts) => {
     const { runDbList } = await import('./commands/products-db.js');
     await runDbList({
@@ -703,7 +746,7 @@ productsDbCmd
 });
 productsDbCmd
     .command('engines')
-    .description('Lista engines suportados')
+    .description('Listar engines de banco suportados')
     .option('--json')
     .action(async (opts) => {
     const { runDbEngines } = await import('./commands/products-db.js');
@@ -711,22 +754,22 @@ productsDbCmd
 });
 productsDbCmd
     .command('create')
-    .description('Cria um banco (Phase A: registra + audit; provisionamento real é Phase B)')
-    .requiredOption('--product-id <id>')
-    .requiredOption('--label <label>')
-    .requiredOption('--engine <engine>', 'firestore-instance|cloud-sql-postgres|cloud-sql-mysql|vm-postgres-single|vm-postgres-cluster|vm-mysql-single|vm-mysql-cluster')
-    .requiredOption('--environment <env>', 'dev|staging|production')
-    .option('--region <region>', 'região GCP', 'us-central1')
-    .option('--server-id <serverId>', 'target VM (obrigatório pra engines vm-*)')
-    .option('--replica-count <n>', 'pra engines *-cluster (default 2)')
-    .option('--json')
+    .description('Criar banco de produto (Phase A: registra + audit)')
+    .option('--product-id <id>', 'ID do produto')
+    .option('--label <label>', 'Nome descritivo do banco')
+    .option('--engine <engine>', 'firestore-instance | cloud-sql-postgres | cloud-sql-mysql | vm-postgres-single | vm-postgres-cluster | vm-mysql-single | vm-mysql-cluster')
+    .option('--env <env>', 'Ambiente: dev | staging | production')
+    .option('--region <region>', 'Região GCP', 'us-central1')
+    .option('--server-id <serverId>', 'ID da VM alvo (obrigatório para engines vm-*)')
+    .option('--replica-count <n>', 'Número de réplicas para engines *-cluster (padrão 2)')
+    .option('--json', 'Saída em JSON estruturado')
     .action(async (opts) => {
     const { runDbCreate } = await import('./commands/products-db.js');
     await runDbCreate({
         productId: opts.productId,
         label: opts.label,
         engine: opts.engine,
-        environment: opts.environment,
+        env: opts.env,
         region: opts.region,
         serverId: opts.serverId,
         replicaCount: opts.replicaCount,
@@ -734,16 +777,16 @@ productsDbCmd
     });
 });
 productsDbCmd
-    .command('get <id>')
-    .description('Detalhes de um banco')
+    .command('get [id]')
+    .description('Mostrar detalhes de um banco')
     .option('--json')
     .action(async (id, opts) => {
     const { runDbGet } = await import('./commands/products-db.js');
     await runDbGet(id, { json: !!opts.json });
 });
 productsDbCmd
-    .command('status <id> <status>')
-    .description('Atualiza status (requested|provisioning|active|degraded|failed|archived)')
+    .command('status [id] [status]')
+    .description('Atualizar status de um banco de produto')
     .option('--reason <text>')
     .option('--json')
     .action(async (id, status, opts) => {
@@ -751,24 +794,24 @@ productsDbCmd
     await runDbStatus(id, status, { reason: opts.reason, json: !!opts.json });
 });
 productsDbCmd
-    .command('retry <id>')
-    .description('Re-enfileira provisionamento (status failed/degraded → requested)')
+    .command('retry [id]')
+    .description('Reenfileirar provisionamento de banco')
     .option('--json')
     .action(async (id, opts) => {
     const { runDbRetry } = await import('./commands/products-db.js');
     await runDbRetry(id, { json: !!opts.json });
 });
 productsDbCmd
-    .command('rotate <id>')
-    .description('Rotaciona credenciais (admin; Phase A: intent + audit)')
+    .command('rotate [id]')
+    .description('Rotacionar credenciais do banco (admin)')
     .option('--json')
     .action(async (id, opts) => {
     const { runDbRotate } = await import('./commands/products-db.js');
     await runDbRotate(id, { json: !!opts.json });
 });
 productsDbCmd
-    .command('delete <id>')
-    .description('Arquiva o banco (soft-delete; admin)')
+    .command('delete [id]')
+    .description('Arquivar banco por soft-delete (admin)')
     .option('--json')
     .action(async (id, opts) => {
     const { runDbDelete } = await import('./commands/products-db.js');
@@ -777,7 +820,7 @@ productsDbCmd
 // ── neetru logs ───────────────────────────────────────────────────────
 program
     .command('logs')
-    .description('Visualiza logs do workspace; suporta tail contínuo')
+    .description('Visualizar logs do workspace (suporta tail contínuo)')
     .option('--client-id <id>', 'oauthClientId do workspace')
     .option('-f, --follow', 'tail contínuo (poll a cada 5s)')
     .option('-n, --lines <count>', 'número de linhas a buscar', '50')
@@ -802,7 +845,7 @@ program
 // ── neetru validate ───────────────────────────────────────────────────
 program
     .command('validate')
-    .description('Health check da config local + conexão com Core')
+    .description('Validar config local e conexão com o Core')
     .action(async () => {
     const { runValidate } = await import('./commands/validate.js');
     await runValidate();
@@ -810,7 +853,7 @@ program
 // ── neetru open ───────────────────────────────────────────────────────
 program
     .command('open [target]')
-    .description('Abre uma página do painel Neetru no browser')
+    .description('Abrir página do painel Neetru no browser')
     .option('--client-id <id>', 'oauthClientId do workspace (anexa em targets workspace-scoped)')
     .action(async (target, opts) => {
     const { runOpen } = await import('./commands/open.js');
@@ -819,7 +862,7 @@ program
 // ── neetru publish ────────────────────────────────────────────────────
 program
     .command('publish')
-    .description('Publica o produto no catálogo público da landing (public_products)')
+    .description('Publicar produto no catálogo público da landing')
     .option('--draft', 'salva como rascunho (published=false)')
     .option('--unpublish', 'remove o produto da landing (mantém o doc)')
     .option('--slug <slug>', 'override do slug do neetru.config.json')
@@ -850,7 +893,7 @@ program
 // ── neetru add ────────────────────────────────────────────────────────
 program
     .command('add <feature>')
-    .description('v1.3 — copia template (auth | billing | usage | users | support) pra src/lib/neetru/')
+    .description('Adicionar template de feature (auth/billing/usage/...)')
     .option('--force', 'sobrescrever arquivos existentes')
     .action(async (feature, opts) => {
     const { runAdd } = await import('./commands/add.js');
@@ -859,10 +902,10 @@ program
 // ── neetru mocks ──────────────────────────────────────────────────────
 const mocksCmd = program
     .command('mocks')
-    .description('v1.3 — gerenciar fixtures dev (NEETRU_ENV=dev)');
+    .description('Gerenciar fixtures de dev (NEETRU_ENV=dev)');
 mocksCmd
     .command('reset')
-    .description('Reseta .neetru/dev-fixtures.json para {}')
+    .description('Resetar fixtures de dev para vazio')
     .action(async () => {
     const { runMocksReset } = await import('./commands/mocks.js');
     await runMocksReset();
@@ -870,10 +913,10 @@ mocksCmd
 // ── neetru env ────────────────────────────────────────────────────────
 const envCmd = program
     .command('env')
-    .description('v1.3 — gerenciar configuração NEETRU_ENV no .env.local');
+    .description('Gerenciar NEETRU_ENV no .env.local');
 envCmd
     .command('switch <target>')
-    .description('Alterna NEETRU_ENV: dev | workspace | production')
+    .description('Alternar NEETRU_ENV (dev/workspace/production)')
     .action(async (target) => {
     const { runEnvSwitch } = await import('./commands/env.js');
     await runEnvSwitch({ target });
@@ -881,10 +924,10 @@ envCmd
 // ── neetru db ─────────────────────────────────────────────────────────
 const dbCmd = program
     .command('db')
-    .description('v1.4 — gerência de schema/migrations/seed do produto');
+    .description('Gerenciar schema, migrations e seed do produto');
 dbCmd
     .command('init')
-    .description('Cria manifest stub a partir de neetru.config.json')
+    .description('Criar manifest de schema a partir do config')
     .option('--out <path>', 'caminho do manifest (default db/schema.manifest.json)')
     .option('--force', 'sobrescreve se já existir')
     .action(async (opts) => {
@@ -893,7 +936,7 @@ dbCmd
 });
 dbCmd
     .command('migrate <toVersion>')
-    .description('Aplica migration via Core (chama runMigrations Sprint 8)')
+    .description('Aplicar migration de schema via Core')
     .option('--from <fromVersion>', 'versão atual (default: schemaVersion do config)')
     .action(async (toVersion, opts) => {
     const { runDbMigrate } = await import('./commands/db.js');
@@ -901,7 +944,7 @@ dbCmd
 });
 dbCmd
     .command('seed')
-    .description('Executa db/seed.ts no projeto (NEETRU_ENV=dev)')
+    .description('Executar script de seed do produto')
     .option('--script <path>', 'caminho custom do script de seed')
     .action(async (opts) => {
     const { runDbSeed } = await import('./commands/db.js');
@@ -910,10 +953,10 @@ dbCmd
 // ── neetru fn ─────────────────────────────────────────────────────────
 const fnCmd = program
     .command('fn')
-    .description('v1.4 — gestão de Functions/APIs do produto');
+    .description('Gerenciar Functions e APIs do produto');
 fnCmd
     .command('deploy')
-    .description('Registra nova versão da API no catálogo neetru-apis (Sprint 7 stub)')
+    .description('Registrar nova versão da API no catálogo')
     .option('--version <v>', 'versão da API (default: apiVersion do config ou v1)')
     .option('--channel <channel>', 'stable | beta | alpha', 'stable')
     .option('--spec <path>', 'caminho de OpenAPI/JSON schema')
@@ -924,7 +967,7 @@ fnCmd
 // ── neetru promote ────────────────────────────────────────────────────
 program
     .command('promote')
-    .description('v1.4 — solicita promotion entre ambientes (staff-gated). dev→workspace→beta→prod')
+    .description('Solicitar promotion entre ambientes (staff-gated)')
     .requiredOption('--from <env>', 'dev | workspace | beta | prod')
     .requiredOption('--to <env>', 'dev | workspace | beta | prod')
     .option('--product <slug>', 'override do slug do neetru.config.json')
@@ -945,7 +988,7 @@ program
 // ── neetru doctor ─────────────────────────────────────────────────────
 program
     .command('doctor')
-    .description('v2.0 — diagnóstico do CLI: token, core, schema, NEETRU_ENV, version')
+    .description('Diagnosticar saúde do CLI (token, core, schema, env)')
     .option('--json', 'saída em JSON (machine-readable)')
     .action(async (opts) => {
     const { runDoctor } = await import('./commands/doctor.js');
@@ -954,7 +997,7 @@ program
 // ── neetru upgrade ────────────────────────────────────────────────────
 program
     .command('upgrade')
-    .description('v2.0 — verifica latest no npm e exibe instrução de upgrade')
+    .description('Verificar versão mais recente do CLI no npm')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
     const { runUpgrade } = await import('./commands/upgrade.js');
@@ -963,7 +1006,7 @@ program
 // ── neetru autocomplete ───────────────────────────────────────────────
 program
     .command('autocomplete <shell>')
-    .description('v2.0 — gera script de shell completion (bash | zsh | pwsh)')
+    .description('Gerar script de shell completion (bash/zsh/pwsh)')
     .action(async (shell) => {
     const { runAutocomplete } = await import('./commands/autocomplete.js');
     await runAutocomplete(shell);
@@ -971,10 +1014,10 @@ program
 // ── neetru agent release ──────────────────────────────────────────────
 const agentCmd = program
     .command('agent')
-    .description('Operações sobre o binário do Neetru Agent (Linux daemon)');
+    .description('Gerenciar binário do Neetru Agent (Linux daemon)');
 agentCmd
     .command('release')
-    .description('Registra nova release do agente em agent_releases (Firestore)')
+    .description('Registrar nova release do agente em agent_releases')
     .requiredOption('--version <semver>', 'versão (ex: 1.2.0 ou 1.2.0-beta.1)')
     .option('--channel <channel>', 'stable | beta | canary (default: beta)', 'beta')
     .option('--changelog <text|@file>', 'changelog markdown inline ou "@path" pra ler de arquivo')
@@ -996,7 +1039,7 @@ agentCmd
 });
 agentCmd
     .command('yank <version>')
-    .description('Soft-revoke de uma release do agente (destrutivo top-tier — confirmação + step-up MFA)')
+    .description('Revogar release do agente (destrutivo — exige MFA)')
     .requiredOption('--reason <text>', 'motivo do yank (mínimo 5 caracteres)')
     .option('--yes', 'pula a confirmação interativa (modo script)')
     .option('--force', 'alias de --yes')
@@ -1016,10 +1059,10 @@ agentCmd
 });
 const agentCanaryCmd = agentCmd
     .command('canary')
-    .description('Controla o canary rollout de releases do agente');
+    .description('Controlar canary rollout de releases do agente');
 agentCanaryCmd
     .command('start <version>')
-    .description('Inicia o canary rollout de uma release (phase1 = 5%)')
+    .description('Iniciar canary rollout de uma release (phase1 5%)')
     .option('--json', 'saída em JSON')
     .action(async (version, opts) => {
     const { runAgentCanaryStart } = await import('./commands/agent-write.js');
@@ -1027,7 +1070,7 @@ agentCanaryCmd
 });
 agentCanaryCmd
     .command('rollback <version>')
-    .description('Rollback do canary de uma release (destrutivo top-tier — confirmação + step-up MFA)')
+    .description('Reverter canary de uma release (destrutivo — exige MFA)')
     .requiredOption('--reason <text>', 'motivo do rollback (mínimo 5 caracteres)')
     .option('--yes', 'pula a confirmação interativa (modo script)')
     .option('--force', 'alias de --yes')
@@ -1048,13 +1091,13 @@ agentCanaryCmd
 // ── neetru support ───────────────────────────────────────────────────
 const supportCmd = program
     .command('support')
-    .description('Support tickets — inbox staff via CLI (F5 §4.2.6)');
+    .description('Gerenciar suporte ao cliente via CLI');
 const supportTicketsCmd = supportCmd
     .command('tickets')
-    .description('Operações sobre support_tickets');
+    .description('Operar tickets de suporte');
 supportTicketsCmd
     .command('list')
-    .description('Lista tickets com filtros')
+    .description('Listar tickets de suporte')
     .option('--status <s>', 'open | in_progress | resolved | closed')
     .option('--severity <s>', 'sev1 | sev2 | sev3 | sev4')
     .option('--product <id>', 'filtra por productId')
@@ -1076,7 +1119,7 @@ supportTicketsCmd
 });
 supportTicketsCmd
     .command('describe <id>')
-    .description('Detalha um ticket + thread de mensagens')
+    .description('Mostrar ticket com thread de mensagens')
     .option('--json', 'saída em JSON')
     .action(async (id, opts) => {
     const { runSupportTicketsDescribe } = await import('./commands/support.js');
@@ -1084,7 +1127,7 @@ supportTicketsCmd
 });
 supportTicketsCmd
     .command('reply <id>')
-    .description('Anexa mensagem staff ao ticket (transiciona open → in_progress se aplicável)')
+    .description('Responder ticket com mensagem staff')
     .requiredOption('--message <text>', 'corpo da mensagem')
     .option('--json', 'saída em JSON')
     .action(async (id, opts) => {
@@ -1093,7 +1136,7 @@ supportTicketsCmd
 });
 supportTicketsCmd
     .command('assign <id>')
-    .description('Atribui ticket a um staff (uid)')
+    .description('Atribuir ticket a um staff')
     .requiredOption('--to <staffUid>', 'uid do staff destino')
     .option('--json', 'saída em JSON')
     .action(async (id, opts) => {
@@ -1102,7 +1145,7 @@ supportTicketsCmd
 });
 supportTicketsCmd
     .command('status <id>')
-    .description('Transiciona status do ticket (FSM)')
+    .description('Transicionar status do ticket')
     .requiredOption('--to <status>', 'open | in_progress | resolved | closed')
     .option('--json', 'saída em JSON')
     .action(async (id, opts) => {
@@ -1110,23 +1153,27 @@ supportTicketsCmd
     await runSupportTicketsStatus(id, { to: opts.to, json: !!opts.json });
 });
 // ── neetru dns ───────────────────────────────────────────────────────
-const dnsCmd = program.command('dns').description('Cloud DNS — managed zones');
-dnsCmd
+const dnsCmd = program
+    .command('dns')
+    .description('Gerenciar Cloud DNS managed zones');
+const dnsZonesCmd = dnsCmd
     .command('zones')
-    .description('Operações sobre managed zones')
+    .description('Operar managed zones do Cloud DNS');
+dnsZonesCmd
     .command('list')
-    .description('Lista managed zones do projeto')
+    .description('Listar managed zones do projeto')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
     const { runDnsZonesList } = await import('./commands/infra-read.js');
     await runDnsZonesList({ json: !!opts.json });
 });
 // ── neetru hosting ───────────────────────────────────────────────────
-program
+const hostingCmd = program
     .command('hosting')
-    .description('Customer domains — hosting setup')
+    .description('Gerenciar customer domains e hosting setup');
+hostingCmd
     .command('list')
-    .description('Lista customer domains com scope de tenant aplicado')
+    .description('Listar customer domains com scope de tenant')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
     const { runHostingList } = await import('./commands/infra-read.js');
@@ -1135,9 +1182,9 @@ program
 // ── neetru builds ────────────────────────────────────────────────────
 program
     .command('builds')
-    .description('Cloud Build — builds live (status + duração)')
+    .description('Consultar Cloud Build (status e duração)')
     .command('list')
-    .description('Lista Cloud Builds recentes (global + regional)')
+    .description('Listar Cloud Builds recentes (global e regional)')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
     const { runBuildsList } = await import('./commands/infra-read.js');
@@ -1147,13 +1194,13 @@ program
 // Disaster Recovery — listar exports + restore assistido (admin + step-up MFA).
 const drCmd = program
     .command('dr')
-    .description('Disaster Recovery — exports + restore (admin only, RUNBOOK_DR_DRILL)');
+    .description('Operar Disaster Recovery (admin only)');
 const drExportsCmd = drCmd
     .command('exports')
-    .description('Operações sobre exports de Firestore em gs://neetru-backups');
+    .description('Operar exports de Firestore em gs://neetru-backups');
 drExportsCmd
     .command('list')
-    .description('Lista exports disponíveis (sort: mais recente primeiro)')
+    .description('Listar exports de DR disponíveis')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
     const { runDrExportsList } = await import('./commands/dr.js');
@@ -1161,7 +1208,7 @@ drExportsCmd
 });
 drCmd
     .command('restore')
-    .description('Dispara restore Firestore (IRREVERSÍVEL no destino — destrutivo top-tier)')
+    .description('Restaurar Firestore de export (IRREVERSÍVEL — exige MFA)')
     .requiredOption('--gcs-path <path>', 'gs://neetru-backups/firestore-exports/<stamp>/')
     .requiredOption('--target-project <project>', 'projeto GCP de destino (deve ser STAGING)')
     .option('--yes', 'pula a confirmação interativa (modo script)')
@@ -1181,10 +1228,24 @@ drCmd
         json: !!opts.json,
     });
 });
+// ── neetru schema ─────────────────────────────────────────────────────
+// Inspecionar spec OpenAPI do Core — usado pela IA e devs pra entender endpoints.
+{
+    const { registerSchemaCommand } = await import('./commands/schema.js');
+    registerSchemaCommand(program);
+}
 // ── parse ─────────────────────────────────────────────────────────────
-program.parse(process.argv);
 if (!process.argv.slice(2).length) {
-    log.banner();
-    program.outputHelp();
+    if (process.stdin.isTTY && process.stdout.isTTY && process.env.CI !== 'true') {
+        const { runTerminalUi } = await import('./commands/ui.js');
+        await runTerminalUi();
+    }
+    else {
+        log.banner();
+        program.outputHelp();
+    }
+}
+else {
+    program.parse(process.argv);
 }
 //# sourceMappingURL=index.js.map