@neetru/cli 2.7.4 → 2.8.0

package/dist/index.js

@@ -56,6 +56,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 +67,7 @@ program
         customer: opts.customer,
         skipInit: !!opts.skipInit,
         skipOpen: !!opts.skipOpen,
+        skipDbInit: !!opts.skipDbInit,
         json: !!opts.json,
     });
 });
@@ -150,6 +152,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 +204,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 +224,7 @@ program
         env: opts.env,
         localArtifact: !!opts.localArtifact,
         nonInteractive: !!opts.nonInteractive,
+        force: !!opts.force,
     });
 });
 // ── neetru status ─────────────────────────────────────────────────────
@@ -728,17 +745,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 +771,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 +803,112 @@ 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 });
+});
+// 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');
+});
+productsDbCmd
+    .command('list')
+    .description('[RENOMEADO — use: neetru admin database list]')
+    .option('--product-id <id>')
+    .option('--engine <engine>')
+    .option('--status <status>')
+    .option('--json')
+    .action(async (opts) => {
+    const { runDbList } = await import('./commands/products-db.js');
+    await runDbList({ productId: opts.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 +916,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 +924,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');
@@ -972,33 +1081,140 @@ 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)')
     .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,
+    });
 });
+// ── 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')
+    .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,
+    });
 });
+// ── 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('seed')
-    .description('Executar script de seed do produto')
-    .option('--script <path>', 'caminho custom do script de seed')
+    .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('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 { 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 { runDbSeed } = await import('./commands/db.js');
-    await runDbSeed({ script: opts.script });
+    const { runDbHosts } = await import('./commands/db.js');
+    await runDbHosts({ json: !!opts.json });
 });
 // ── neetru fn ─────────────────────────────────────────────────────────
 const fnCmd = program