@neetru/cli 2.7.5 → 2.9.1

package/dist/index.js

@@ -2,6 +2,16 @@
 import { Command } from 'commander';
 import { log } from './utils/logger.js';
 import { CLI_VERSION } from './version.js';
+// pdv #6 fix: fecha stdin antes de qualquer process.exit() para evitar a
+// asserção libuv "!(handle->flags & UV_HANDLE_CLOSING)" no Windows.
+// stdin fica aberto como handle libuv quando inquirer/ora o pegam; destruir
+// antes do exit garante que o loop de eventos drene limpo.
+process.on('exit', () => {
+    try {
+        process.stdin.destroy();
+    }
+    catch { /* silencioso — handle pode já estar fechado */ }
+});
 const program = new Command();
 program
     .name('neetru')
@@ -56,6 +66,7 @@ program
     .option('--customer <customerId>', 'customerId dono do workspace (default: self)')
     .option('--skip-init', 'pula o scaffold local')
     .option('--skip-open', 'pula a abertura do browser')
+    .option('--skip-db-init', 'pula o 5º passo de inicialização do banco de dados')
     .option('--json', 'saída em JSON (machine-readable)')
     .action(async (name, opts) => {
     const { runNewMacro } = await import('./commands/new.js');
@@ -66,6 +77,7 @@ program
         customer: opts.customer,
         skipInit: !!opts.skipInit,
         skipOpen: !!opts.skipOpen,
+        skipDbInit: !!opts.skipDbInit,
         json: !!opts.json,
     });
 });
@@ -150,6 +162,19 @@ program
     const { runWhoami } = await import('./commands/whoami.js');
     await runWhoami({ json: !!opts.json });
 });
+// ── neetru dev ────────────────────────────────────────────────────────
+// Banco local Docker + watch de schema (M1 GAP-M1-4).
+// "salvar = aplicado" — cada save no schema roda o pipeline neetru db apply
+// contra o banco dev-local do produto.
+program
+    .command('dev')
+    .description('Rodar banco Docker local + watch de schema (dev-local)')
+    .option('--db <name>', 'banco alvo do .neetru/db.json (default: único registrado)')
+    .option('--schema <path>', 'caminho do arquivo de schema (default: db/schema.ts)')
+    .action(async (opts) => {
+    const { runDev } = await import('./commands/dev.js');
+    await runDev({ db: opts.db, schema: opts.schema });
+});
 // ── neetru build ──────────────────────────────────────────────────────
 program
     .command('build')
@@ -189,6 +214,7 @@ program
     .option('--env <env>', 'ambiente alvo: dev | staging | prod', 'dev')
     .option('--local-artifact', 'F-11: NÃO faz upload pra GCS — manda file:// pro Core (só funciona se o agent compartilha FS com este CLI)')
     .option('--non-interactive', 'falha em vez de perguntar (modo CI)')
+    .option('--force', 'ignora o gate de schema e prossegue mesmo com divergência de fingerprint')
     .action(async (opts) => {
     const { runDeploy } = await import('./commands/deploy.js');
     await runDeploy({
@@ -208,6 +234,7 @@ program
         env: opts.env,
         localArtifact: !!opts.localArtifact,
         nonInteractive: !!opts.nonInteractive,
+        force: !!opts.force,
     });
 });
 // ── neetru status ─────────────────────────────────────────────────────
@@ -222,6 +249,47 @@ program
     const { runSurfaceStatus } = await import('./commands/surface-status.js');
     await runSurfaceStatus({ clientId: opts.clientId, json: !!opts.json });
 });
+// ── neetru customers ──────────────────────────────────────────────────
+// pdv #2 fix: operadores podem criar customers pelo CLI sem abrir o painel.
+// Customer = empresa/PJ que paga (CRM comercial).
+// Tenant = instância do produto para esse customer.
+const customersCmd = program
+    .command('customers')
+    .description('Gerenciar customers (empresa/PJ que paga o serviço Neetru)');
+customersCmd
+    .command('list')
+    .description('Listar customers')
+    .option('--status <status>', 'ativo | em prospecção | suspenso | arquivado')
+    .option('--search <texto>', 'busca por nome, email ou CNPJ')
+    .option('--json', 'saída em JSON')
+    .action(async (opts) => {
+    const { runCustomersList } = await import('./commands/customers.js');
+    await runCustomersList({ status: opts.status, search: opts.search, json: !!opts.json });
+});
+customersCmd
+    .command('get <id>')
+    .description('Mostrar detalhes de um customer')
+    .option('--json', 'saída em JSON')
+    .action(async (id, opts) => {
+    const { runCustomersGet } = await import('./commands/customers.js');
+    await runCustomersGet(id, { json: !!opts.json });
+});
+customersCmd
+    .command('create')
+    .description('Criar customer (empresa/PJ) — necessário antes de criar workspace')
+    .option('--name <nome>', 'nome do customer (razão social ou nome comercial)')
+    .option('--email <email>', 'email de contato')
+    .option('--tax-id <cnpj>', 'CNPJ ou CPF (opcional)')
+    .option('--json', 'saída em JSON')
+    .action(async (opts) => {
+    const { runCustomersCreate } = await import('./commands/customers.js');
+    await runCustomersCreate({
+        name: opts.name,
+        email: opts.email,
+        taxId: opts.taxId,
+        json: !!opts.json,
+    });
+});
 // ── neetru tenants ────────────────────────────────────────────────────
 const tenantsCmd = program
     .command('tenants')
@@ -252,7 +320,10 @@ tenantsCmd
 });
 tenantsCmd
     .command('create')
-    .description('Criar tenant (status inicial: em provisionamento)')
+    .description('[STAFF-ONLY] Criar tenant sem OAuth client/secret.\n' +
+    'DEPRECATED: para uso normal (ambiente completo com OAuth), use:\n' +
+    '  neetru workspaces create\n' +
+    'Este comando permanece para casos staff-only (registro de tenant pré-existente).')
     .option('--name <name>', 'nome do tenant')
     .option('--slug <slug>', 'slug do tenant')
     .option('--customer <customerId>', 'id do customer')
@@ -433,6 +504,8 @@ workspacesCmd
     .option('--env <env>', 'dev | staging | prod (default: dev)')
     .option('--tier <tier>', 'dev | standard | enterprise (default: standard)')
     .option('--name <name>', 'label do workspace')
+    .option('--bind-config', 'grava tenantId retornado no neetru.config.json do cwd')
+    .option('--force-duplicate', 'cria mesmo que já exista ambiente ativo para produto+env')
     .option('--json', 'saída em JSON')
     .action(async (opts) => {
     const { runWorkspacesCreate } = await import('./commands/workspaces.js');
@@ -442,6 +515,8 @@ workspacesCmd
         env: opts.env,
         tier: opts.tier,
         name: opts.name,
+        bindConfig: !!opts.bindConfig,
+        forceDuplicate: !!opts.forceDuplicate,
         json: !!opts.json,
     });
 });
@@ -728,17 +803,23 @@ productsCmd
     const { runProductsUnpublish } = await import('./commands/products.js');
     await runProductsUnpublish(slug, { json: !!opts.json });
 });
-// ── neetru products db (Phase A — per-product DB isolation) ────────────
-const productsDbCmd = productsCmd
-    .command('db')
-    .description('Gerenciar bancos isolados por produto');
-productsDbCmd
+// ── neetru admin database (Phase A — plano de controle staff de bancos) ───────
+// D-1: renomeado de `neetru products db` → `neetru admin database`.
+//      Alias `neetru products db` emite aviso de remoção.
+// D-2: `status` (que era WRITE nesta árvore) renomeado para `set-status`.
+const adminCmd = program
+    .command('admin')
+    .description('Comandos de administração do plano de controle staff');
+const adminDatabaseCmd = adminCmd
+    .command('database')
+    .description('Plano de controle staff — bancos isolados por produto (fleet-wide)');
+adminDatabaseCmd
     .command('list')
-    .description('Listar bancos de produtos')
-    .option('--product-id <id>', 'ID do produto')
+    .description('[Staff] Listar bancos de todos os produtos')
+    .option('--product-id <id>', 'filtrar por ID de 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')
+    .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({
@@ -748,25 +829,25 @@ productsDbCmd
         json: !!opts.json,
     });
 });
-productsDbCmd
+adminDatabaseCmd
     .command('engines')
-    .description('Listar engines de banco suportados')
+    .description('[Staff] Listar engines de banco suportados')
     .option('--json')
     .action(async (opts) => {
     const { runDbEngines } = await import('./commands/products-db.js');
     await runDbEngines({ json: !!opts.json });
 });
-productsDbCmd
+adminDatabaseCmd
     .command('create')
-    .description('Criar banco de produto (Phase A: registra + audit)')
+    .description('[Staff] Registrar banco de produto no plano de controle (Phase A)')
     .option('--product-id <id>', 'ID do produto')
-    .option('--label <label>', 'Nome descritivo do banco')
+    .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('--env <env>', 'ambiente: dev-local | 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')
+    .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({
@@ -780,26 +861,132 @@ productsDbCmd
         json: !!opts.json,
     });
 });
+adminDatabaseCmd
+    .command('get [id]')
+    .description('[Staff] 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 });
+});
+// gestovendas #12 fix: alias `status` → `get` (skill /neetru documenta como `status`).
+adminDatabaseCmd
+    .command('status [id]')
+    .description('[Staff] Alias de `get` — mostrar detalhes e status de um banco')
+    .option('--json')
+    .action(async (id, opts) => {
+    const { runDbGet } = await import('./commands/products-db.js');
+    await runDbGet(id, { json: !!opts.json });
+});
+// D-2: `set-status` é ESCRITA explícita. `status` era ambíguo com o READ em `neetru db status`.
+adminDatabaseCmd
+    .command('set-status [id] [status]')
+    .description('[Staff] ESCRITA — forçar status do ciclo de vida de um banco (active/failed/archived/…)')
+    .option('--reason <text>', 'motivo da mudança de status')
+    .option('--json')
+    .action(async (id, status, opts) => {
+    const { runDbSetStatus } = await import('./commands/products-db.js');
+    await runDbSetStatus(id, status, { reason: opts.reason, json: !!opts.json });
+});
+adminDatabaseCmd
+    .command('retry [id]')
+    .description('[Staff] Reenfileirar provisionamento de banco com falha')
+    .option('--json')
+    .action(async (id, opts) => {
+    const { runDbRetry } = await import('./commands/products-db.js');
+    await runDbRetry(id, { json: !!opts.json });
+});
+adminDatabaseCmd
+    .command('rotate [id]')
+    .description('[Staff] Rotacionar credenciais do banco')
+    .option('--json')
+    .action(async (id, opts) => {
+    const { runDbRotate } = await import('./commands/products-db.js');
+    await runDbRotate(id, { json: !!opts.json });
+});
+adminDatabaseCmd
+    .command('delete [id]')
+    .description('[Staff] Arquivar banco por soft-delete')
+    .option('--json')
+    .action(async (id, opts) => {
+    const { runDbDelete } = await import('./commands/products-db.js');
+    await runDbDelete(id, { json: !!opts.json });
+});
+// ── neetru products db (alias de remoção — D-1) ────────────────────────────
+// Emite aviso informando o novo caminho. Mantém subcomandos funcionais por
+// compatibilidade temporária mas deixa claro que foi renomeado.
+const productsDbCmd = productsCmd
+    .command('db')
+    .description('[RENOMEADO] Use `neetru admin database`. Este alias emite aviso.')
+    .hook('preAction', () => {
+    process.stderr.write('\nAviso: `neetru products db` foi renomeado para `neetru admin database`.\n' +
+        'Por favor, atualize seus scripts. Este alias será removido em breve.\n\n');
+});
+// gestovendas #2 / pdv #5 fix: alias `list` aceita --product (slug legado) OU
+// --product-id (novo). Se slug recebido, passa como productId para o Core.
+// O Core tenta resolver slug → id server-side (fallback); se o Core não suportar,
+// o operador vê mensagem específica do servidor e não um erro de sintaxe.
+productsDbCmd
+    .command('list')
+    .description('[RENOMEADO — use: neetru admin database list]')
+    .option('--product-id <id>', 'ID do produto (novo)')
+    .option('--product <slugOrId>', 'slug ou ID do produto (legado — use --product-id)')
+    .option('--engine <engine>')
+    .option('--status <status>')
+    .option('--json')
+    .action(async (opts) => {
+    // Tradução de flag: --product (legado) → productId (novo).
+    const productId = opts.productId ?? opts.product;
+    if (opts.product && !opts.productId) {
+        process.stderr.write(`[DEPRECATED] Use --product-id em vez de --product.\n` +
+            `  Próxima major remove o suporte a --product neste alias.\n`);
+    }
+    const { runDbList } = await import('./commands/products-db.js');
+    await runDbList({ productId, engine: opts.engine, status: opts.status, json: !!opts.json });
+});
+productsDbCmd
+    .command('engines')
+    .description('[RENOMEADO — use: neetru admin database engines]')
+    .option('--json')
+    .action(async (opts) => {
+    const { runDbEngines } = await import('./commands/products-db.js');
+    await runDbEngines({ json: !!opts.json });
+});
+productsDbCmd
+    .command('create')
+    .description('[RENOMEADO — use: neetru admin database create]')
+    .option('--product-id <id>')
+    .option('--label <label>')
+    .option('--engine <engine>')
+    .option('--env <env>')
+    .option('--region <region>', '', 'us-central1')
+    .option('--server-id <serverId>')
+    .option('--replica-count <n>')
+    .option('--json')
+    .action(async (opts) => {
+    const { runDbCreate } = await import('./commands/products-db.js');
+    await runDbCreate({ productId: opts.productId, label: opts.label, engine: opts.engine, env: opts.env, region: opts.region, serverId: opts.serverId, replicaCount: opts.replicaCount, json: !!opts.json });
+});
 productsDbCmd
     .command('get [id]')
-    .description('Mostrar detalhes de um banco')
+    .description('[RENOMEADO — use: neetru admin database get]')
     .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('Atualizar status de um banco de produto')
+    .command('set-status [id] [status]')
+    .description('[RENOMEADO — use: neetru admin database set-status]')
     .option('--reason <text>')
     .option('--json')
     .action(async (id, status, opts) => {
-    const { runDbStatus } = await import('./commands/products-db.js');
-    await runDbStatus(id, status, { reason: opts.reason, json: !!opts.json });
+    const { runDbSetStatus } = await import('./commands/products-db.js');
+    await runDbSetStatus(id, status, { reason: opts.reason, json: !!opts.json });
 });
 productsDbCmd
     .command('retry [id]')
-    .description('Reenfileirar provisionamento de banco')
+    .description('[RENOMEADO — use: neetru admin database retry]')
     .option('--json')
     .action(async (id, opts) => {
     const { runDbRetry } = await import('./commands/products-db.js');
@@ -807,7 +994,7 @@ productsDbCmd
 });
 productsDbCmd
     .command('rotate [id]')
-    .description('Rotacionar credenciais do banco (admin)')
+    .description('[RENOMEADO — use: neetru admin database rotate]')
     .option('--json')
     .action(async (id, opts) => {
     const { runDbRotate } = await import('./commands/products-db.js');
@@ -815,7 +1002,7 @@ productsDbCmd
 });
 productsDbCmd
     .command('delete [id]')
-    .description('Arquivar banco por soft-delete (admin)')
+    .description('[RENOMEADO — use: neetru admin database delete]')
     .option('--json')
     .action(async (id, opts) => {
     const { runDbDelete } = await import('./commands/products-db.js');
@@ -916,6 +1103,74 @@ program
         ctaLabel: opts.ctaLabel,
     });
 });
+// ── neetru marketplace ────────────────────────────────────────────────
+const marketplaceCmd = program
+    .command('marketplace')
+    .description('Central de artefatos do ecossistema Neetru (skills, SDK, templates)');
+const marketplaceSkillsCmd = marketplaceCmd
+    .command('skills')
+    .description('Gerenciar Skills do Claude Code');
+marketplaceSkillsCmd
+    .command('install')
+    .description('Clonar neetru-libs e instalar skills em ~/.claude/skills/')
+    .action(async () => {
+    const { runSkillsInstall } = await import('./commands/marketplace.js');
+    await runSkillsInstall();
+});
+marketplaceSkillsCmd
+    .command('update')
+    .description('Atualizar cache neetru-libs (git pull) e re-copiar skills instaladas')
+    .action(async () => {
+    const { runSkillsUpdate } = await import('./commands/marketplace.js');
+    await runSkillsUpdate();
+});
+marketplaceSkillsCmd
+    .command('list')
+    .description('Listar skills disponíveis no cache local')
+    .action(async () => {
+    const { runSkillsList } = await import('./commands/marketplace.js');
+    await runSkillsList();
+});
+marketplaceSkillsCmd
+    .command('uninstall')
+    .description('Remover skills de ~/.claude/skills/ (pede confirmação)')
+    .option('--yes', 'pular confirmação interativa')
+    .action(async (opts) => {
+    const { runSkillsUninstall } = await import('./commands/marketplace.js');
+    await runSkillsUninstall({ yes: !!opts.yes });
+});
+const marketplaceSdkCmd = marketplaceCmd
+    .command('sdk')
+    .description('Gerenciar @neetru/sdk no projeto atual');
+marketplaceSdkCmd
+    .command('init')
+    .description('Adicionar @neetru/sdk ao package.json e criar src/neetru.ts')
+    .action(async () => {
+    const { runSdkInit } = await import('./commands/marketplace.js');
+    await runSdkInit();
+});
+marketplaceSdkCmd
+    .command('templates')
+    .description('Listar templates de feature disponíveis (auth, billing, usage…)')
+    .action(async () => {
+    const { runSdkTemplates } = await import('./commands/marketplace.js');
+    await runSdkTemplates();
+});
+marketplaceSdkCmd
+    .command('add <template>')
+    .description('Copiar template de feature pra src/ do projeto atual')
+    .option('--force', 'sobrescrever arquivos existentes')
+    .action(async (template, opts) => {
+    const { runSdkAddTemplate } = await import('./commands/marketplace.js');
+    await runSdkAddTemplate(template, { force: !!opts.force });
+});
+marketplaceCmd
+    .command('browse')
+    .description('Abrir https://github.com/Neetru/neetru-libs no browser')
+    .action(async () => {
+    const { runMarketplaceBrowse } = await import('./commands/marketplace.js');
+    await runMarketplaceBrowse();
+});
 // ── neetru add ────────────────────────────────────────────────────────
 program
     .command('add <feature>')
@@ -972,33 +1227,144 @@ envCmd
     });
 });
 // ── neetru db ─────────────────────────────────────────────────────────
+// M1 — árvore completa de banco por produto.
+// Subcomandos novos: list, status, apply, migrations list/confirm.
+// Subcomandos legados (Sprint 10): init --out, migrate, seed.
 const dbCmd = program
     .command('db')
-    .description('Gerenciar schema, migrations e seed do produto');
+    .description('Gerenciar schema, migrations e banco isolado do produto');
+// ── neetru db list ────────────────────────────────────────────────────
+dbCmd
+    .command('list')
+    .description('Listar bancos do produto (GET /api/cli/v1/db)')
+    .option('--product-id <id>', 'filtrar por ID de produto')
+    .option('--engine <engine>', 'filtrar por engine (cloud-sql-postgres, vm-postgres-single, …)')
+    .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/db.js');
+    await runDbList({
+        productId: opts.productId,
+        engine: opts.engine,
+        status: opts.status,
+        json: !!opts.json,
+    });
+});
+// ── neetru db status <dbId> ───────────────────────────────────────────
+dbCmd
+    .command('status <dbId>')
+    .description('Detalhar banco + status de provisionamento/saúde')
+    .option('--json', 'saída em JSON estruturado')
+    .action(async (dbId, opts) => {
+    const { runDbStatus } = await import('./commands/db.js');
+    await runDbStatus(dbId, { json: !!opts.json });
+});
+// ── neetru db init ────────────────────────────────────────────────────
+// D-3: opções legadas --out e --force removidas. db init faz UMA coisa.
+// D-4: --env aceita dev-local (canônico) ou dev (alias explícito com aviso).
 dbCmd
     .command('init')
-    .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')
+    .description('Registrar banco no Core + gravar .neetru/db.json + scaffoldar db/schema.ts')
+    .option('--name <name>', 'nome do banco (interativo se ausente)')
+    .option('--engine <engine>', 'engine: cloud-sql-postgres | vm-postgres-single | firestore-instance | …')
+    .option('--env <env>', 'ambiente: dev-local (padrão) | staging | production')
+    .option('--product-id <id>', 'override do productId (default: slug do neetru.config.json)')
+    .option('-y, --yes', 'modo não-interativo (usa defaults)')
+    .option('--json', 'saída em JSON estruturado')
     .action(async (opts) => {
     const { runDbInit } = await import('./commands/db.js');
-    await runDbInit({ out: opts.out, force: !!opts.force });
+    await runDbInit({
+        name: opts.name,
+        engine: opts.engine,
+        env: opts.env,
+        productId: opts.productId,
+        yes: !!opts.yes,
+        json: !!opts.json,
+    });
 });
+// ── neetru db apply ───────────────────────────────────────────────────
+// D-4: --env usa dev-local como default canônico.
 dbCmd
-    .command('migrate <toVersion>')
-    .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');
-    await runDbMigrate({ toVersion, fromVersion: opts.from });
+    .command('apply')
+    .description('Executar pipeline de migração + enviar ao Core (POST /api/cli/v1/db/migrations/push)')
+    .option('--db <name>', 'banco alvo (interativo se mais de um registrado)')
+    .option('--env <env>', 'ambiente alvo: dev-local (padrão) | staging | production')
+    .option('--schema <path>', 'caminho do schema (default: db/schema.ts)')
+    .option('--dry-run', 'calcula o diff mas NÃO envia ao Core')
+    .option('-y, --yes', 'pula a confirmação interativa')
+    .option('--json', 'saída em JSON estruturado')
+    .action(async (opts) => {
+    const { runDbApply } = await import('./commands/db.js');
+    await runDbApply({
+        dbName: opts.db,
+        env: opts.env,
+        schemaPath: opts.schema,
+        dryRun: !!opts.dryRun,
+        yes: !!opts.yes,
+        json: !!opts.json,
+    });
+});
+// ── neetru db migrations ──────────────────────────────────────────────
+const dbMigrationsCmd = dbCmd
+    .command('migrations')
+    .description('Operar migrações de banco');
+dbMigrationsCmd
+    .command('list')
+    .description('Listar migrações registradas (GET /api/cli/v1/db/migrations)')
+    .option('--db <dbId>', 'filtrar por ID do banco')
+    .option('--json', 'saída em JSON estruturado')
+    .action(async (opts) => {
+    const { runDbMigrationsList } = await import('./commands/db.js');
+    await runDbMigrationsList({ dbId: opts.db, json: !!opts.json });
 });
+dbMigrationsCmd
+    .command('confirm <migrationId>')
+    .description('Confirmar migração destrutiva (POST /api/cli/v1/db/migrations/[id]/confirm — exige MFA)')
+    .requiredOption('--mfa <token>', 'código TOTP step-up MFA')
+    .option('--json', 'saída em JSON')
+    .action(async (migrationId, opts) => {
+    const { runDbMigrationsConfirm } = await import('./commands/db.js');
+    await runDbMigrationsConfirm(migrationId, { mfa: opts.mfa, json: !!opts.json });
+});
+// D-3: neetru db migrate removido (legado Sprint 10 cortado).
+// ── neetru db backups <dbId> ──────────────────────────────────────────
+dbCmd
+    .command('backups <dbId>')
+    .description('Listar backups de um banco (GET /api/cli/v1/db/[id]/backups)')
+    .option('--json', 'saída em JSON estruturado')
+    .action(async (dbId, opts) => {
+    const { runDbBackups } = await import('./commands/db.js');
+    await runDbBackups(dbId, { json: !!opts.json });
+});
+// ── neetru db restore <dbId> ──────────────────────────────────────────
+dbCmd
+    .command('restore <dbId>')
+    .description('Restaurar banco a partir de backup (POST /api/cli/v1/db/[id]/restore — exige MFA)')
+    .requiredOption('--mfa <token>', 'código TOTP step-up MFA (obrigatório — operação destrutiva)')
+    .option('--json', 'saída em JSON')
+    .action(async (dbId, opts) => {
+    const { runDbRestore } = await import('./commands/db.js');
+    await runDbRestore(dbId, { mfa: opts.mfa, json: !!opts.json });
+});
+// ── neetru db hosts ───────────────────────────────────────────────────
+// Alias: também acessível via `neetru db-hosts` (top-level).
 dbCmd
-    .command('seed')
-    .description('Executar script de seed do produto')
-    .option('--script <path>', 'caminho custom do script de seed')
+    .command('hosts')
+    .description('Listar VM hosts de banco e densidade (GET /api/cli/v1/servers?capacity=true&db=true)')
+    .option('--json', 'saída em JSON estruturado')
     .action(async (opts) => {
-    const { runDbSeed } = await import('./commands/db.js');
-    await runDbSeed({ script: opts.script });
+    const { runDbHosts } = await import('./commands/db.js');
+    await runDbHosts({ json: !!opts.json });
+});
+// D-3: neetru db seed removido (legado Sprint 10 cortado).
+// ── neetru db-hosts (top-level alias de `neetru db hosts`) ───────────
+program
+    .command('db-hosts')
+    .description('Listar VM hosts de banco e densidade (alias de `neetru db hosts`)')
+    .option('--json', 'saída em JSON estruturado')
+    .action(async (opts) => {
+    const { runDbHosts } = await import('./commands/db.js');
+    await runDbHosts({ json: !!opts.json });
 });
 // ── neetru fn ─────────────────────────────────────────────────────────
 const fnCmd = program
@@ -1220,6 +1586,117 @@ supportTicketsCmd
     const { runSupportTicketsStatus } = await import('./commands/support.js');
     await runSupportTicketsStatus(id, { to: opts.to, json: !!opts.json });
 });
+// ── neetru bug ───────────────────────────────────────────────────────
+/**
+ * neetru bug — bugs e ocorrências reportados pela CLI, agentes Claude e staff.
+ *
+ * Subcomandos:
+ *   report                — reportar novo bug (interativo ou one-shot via flags)
+ *   list                  — listar bugs abertos (ou com filtros)
+ *   show <id>             — detalhe completo
+ *   claim <id>            — assumir investigação
+ *   resolve <id>          — encerrar (resolved/wont_fix/duplicate)
+ *   comment <id>          — adicionar comentário na thread
+ *
+ * Exemplo rápido (agentes Claude):
+ *   neetru bug report --title "X trava" --body "Stack trace…" --category cli --severity high --actor-type agent_claude --json
+ *   neetru bug list --status open --json
+ */
+const bugCmd = program
+    .command('bug')
+    .description('Reportar, listar e resolver bugs e ocorrências da plataforma');
+bugCmd
+    .command('report')
+    .description('Reportar novo bug (interativo ou flags --title/--body para agentes)')
+    .option('--title <text>', 'título curto do bug')
+    .option('--body <text>', 'descrição detalhada')
+    .option('--category <cat>', 'cli | sdk | core | agent | libs | docs | infra | other', 'other')
+    .option('--severity <sev>', 'critical | high | medium | low', 'medium')
+    .option('--product <id>', 'productId afetado (opcional)')
+    .option('--steps <text>', 'passos para reproduzir (opcional)')
+    .option('--expected <text>', 'comportamento esperado (opcional)')
+    .option('--actual <text>', 'comportamento atual (opcional)')
+    .option('--actor-type <type>', 'cli_principal | agent_claude | staff_session', 'cli_principal')
+    .option('--json', 'saída em JSON (modo não-interativo)')
+    .action(async (opts) => {
+    const { runBugReport } = await import('./commands/bug.js');
+    await runBugReport({
+        title: opts.title,
+        body: opts.body,
+        category: opts.category,
+        severity: opts.severity,
+        product: opts.product,
+        steps: opts.steps,
+        expected: opts.expected,
+        actual: opts.actual,
+        actorType: opts.actorType,
+        json: !!opts.json,
+    });
+});
+bugCmd
+    .command('list')
+    .description('Listar bugs e ocorrências')
+    .option('--status <s>', 'open | triaged | in_progress | resolved | wont_fix | duplicate')
+    .option('--category <cat>', 'cli | sdk | core | agent | libs | docs | infra | other')
+    .option('--assigned-to <uid>', 'filtrar por responsável (uid ou session id)')
+    .option('--product <id>', 'filtrar por productId')
+    .option('--limit <n>', 'máximo de resultados (default 20, max 200)')
+    .option('--json', 'saída em JSON')
+    .action(async (opts) => {
+    const { runBugList } = await import('./commands/bug.js');
+    await runBugList({
+        status: opts.status,
+        category: opts.category,
+        assignedTo: opts.assignedTo,
+        product: opts.product,
+        limit: opts.limit,
+        json: !!opts.json,
+    });
+});
+bugCmd
+    .command('show <id>')
+    .description('Mostrar detalhe completo de um bug')
+    .option('--json', 'saída em JSON')
+    .action(async (id, opts) => {
+    const { runBugShow } = await import('./commands/bug.js');
+    await runBugShow(id, { json: !!opts.json });
+});
+bugCmd
+    .command('claim <id>')
+    .description('Assumir investigação de um bug')
+    .option('--assigned-to <uid>', 'uid ou session id (default: caller)')
+    .option('--json', 'saída em JSON')
+    .action(async (id, opts) => {
+    const { runBugClaim } = await import('./commands/bug.js');
+    await runBugClaim(id, { assignedTo: opts.assignedTo, json: !!opts.json });
+});
+bugCmd
+    .command('resolve <id>')
+    .description('Encerrar um bug como resolvido, wont_fix ou duplicate')
+    .option('--summary <text>', 'resumo do que foi feito / por que não corrigir')
+    .option('--commit <sha>', 'commit SHA que corrige o bug (opcional)')
+    .option('--status <s>', 'resolved | wont_fix | duplicate (default: resolved)', 'resolved')
+    .option('--duplicate-of <id>', 'ID do bug original (obrigatório quando --status duplicate)')
+    .option('--json', 'saída em JSON (modo não-interativo)')
+    .action(async (id, opts) => {
+    const { runBugResolve } = await import('./commands/bug.js');
+    await runBugResolve(id, {
+        summary: opts.summary,
+        commit: opts.commit,
+        status: opts.status,
+        duplicateOf: opts.duplicateOf,
+        json: !!opts.json,
+    });
+});
+bugCmd
+    .command('comment <id>')
+    .description('Adicionar comentário na thread de um bug')
+    .option('--body <text>', 'corpo do comentário')
+    .option('--json', 'saída em JSON (modo não-interativo)')
+    .action(async (id, opts) => {
+    const { runBugComment } = await import('./commands/bug.js');
+    await runBugComment(id, { body: opts.body, json: !!opts.json });
+});
 // ── neetru dns ───────────────────────────────────────────────────────
 const dnsCmd = program
     .command('dns')
@@ -1356,9 +1833,20 @@ drCmd
 // Frente B — docs em GCS + Firestore registry. Desacopla conteúdo de docs
 // do deploy do Core (owner edita markdown direto pelo bucket OU via CLI,
 // sem rebuild).
+//
+// `neetru docs open [topic]` abre documentação no browser. É o ponto de
+// entrada pra quem quer LER docs, não publicar.
 const docsCmd = program
     .command('docs')
-    .description('Gerenciar registry de docs publicados em gs://neetru-docs');
+    .description('Documentação + registry de docs publicados em gs://neetru-docs');
+docsCmd
+    .command('open [topic]')
+    .description('Abrir documentação no browser (ex: sdk, cli, db, webhooks, auth)')
+    .option('--json', 'saída em JSON (imprime URL sem abrir browser)')
+    .action(async (topic, opts) => {
+    const { runDocsOpen } = await import('./commands/docs.js');
+    await runDocsOpen(topic, { json: !!opts.json });
+});
 docsCmd
     .command('publish <file>')
     .description('Publicar arquivo markdown (sobe pro GCS + registry Firestore)')