@neetru/cli 2.8.0 → 2.9.3

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')
@@ -239,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')
@@ -269,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')
@@ -450,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');
@@ -459,6 +515,8 @@ workspacesCmd
         env: opts.env,
         tier: opts.tier,
         name: opts.name,
+        bindConfig: !!opts.bindConfig,
+        forceDuplicate: !!opts.forceDuplicate,
         json: !!opts.json,
     });
 });
@@ -811,6 +869,15 @@ adminDatabaseCmd
     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]')
@@ -845,6 +912,57 @@ adminDatabaseCmd
     const { runDbDelete } = await import('./commands/products-db.js');
     await runDbDelete(id, { json: !!opts.json });
 });
+// ── neetru admin sdk-credential ────────────────────────────────────────────
+// Gerencia credenciais OIDC (SDK) por produto — create / list / revoke.
+// Resolve bug_599d2f033e024bc194aa07639cd26c84: bootstrap CI/IaC desbloqueado.
+// Internamente usa `oidc_clients/{clientId}` no Core (canônico pós-devkit).
+const adminSdkCredentialCmd = adminCmd
+    .command('sdk-credential')
+    .description('Gerenciar credenciais OIDC (SDK) de produtos — create / list / revoke');
+adminSdkCredentialCmd
+    .command('create')
+    .description('[Staff] Criar credencial OIDC para produto — exibe clientSecret ONE-TIME')
+    .requiredOption('--product-id <id>', 'ID do produto')
+    .requiredOption('--name <label>', 'nome/label da credencial (ex: "Backend Prod")')
+    .option('--scopes <escopos>', 'escopos separados por vírgula (ex: "entitlements.read,usage.write")')
+    .option('--mfa-token <code>', 'código TOTP para step-up MFA (se exigido pelo servidor)')
+    .option('--json', 'saída em JSON (machine-readable)')
+    .action(async (opts) => {
+    const { runSdkCredentialCreate } = await import('./commands/admin/sdk-credential.js');
+    await runSdkCredentialCreate({
+        productId: opts.productId,
+        name: opts.name,
+        scopes: opts.scopes,
+        mfaToken: opts.mfaToken,
+        json: !!opts.json,
+    });
+});
+adminSdkCredentialCmd
+    .command('list')
+    .description('[Staff] Listar credenciais OIDC de um produto')
+    .requiredOption('--product-id <id>', 'ID do produto')
+    .option('--json', 'saída em JSON')
+    .action(async (opts) => {
+    const { runSdkCredentialList } = await import('./commands/admin/sdk-credential.js');
+    await runSdkCredentialList({
+        productId: opts.productId,
+        json: !!opts.json,
+    });
+});
+adminSdkCredentialCmd
+    .command('revoke <clientId>')
+    .description('[Staff] Revogar credencial OIDC (status → desativado, irreversível)')
+    .requiredOption('--product-id <id>', 'ID do produto dono da credencial')
+    .option('--mfa-token <code>', 'código TOTP para step-up MFA')
+    .option('--json', 'saída em JSON')
+    .action(async (clientId, opts) => {
+    const { runSdkCredentialRevoke } = await import('./commands/admin/sdk-credential.js');
+    await runSdkCredentialRevoke(clientId, {
+        productId: opts.productId,
+        mfaToken: opts.mfaToken,
+        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.
@@ -855,16 +973,27 @@ const productsDbCmd = productsCmd
     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>')
+    .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: opts.productId, engine: opts.engine, status: opts.status, json: !!opts.json });
+    await runDbList({ productId, engine: opts.engine, status: opts.status, json: !!opts.json });
 });
 productsDbCmd
     .command('engines')
@@ -1025,6 +1154,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>')
@@ -1124,6 +1321,7 @@ dbCmd
     .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({
@@ -1132,6 +1330,7 @@ dbCmd
         env: opts.env,
         productId: opts.productId,
         yes: !!opts.yes,
+        json: !!opts.json,
     });
 });
 // ── neetru db apply ───────────────────────────────────────────────────
@@ -1144,6 +1343,7 @@ dbCmd
     .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({
@@ -1152,6 +1352,7 @@ dbCmd
         schemaPath: opts.schema,
         dryRun: !!opts.dryRun,
         yes: !!opts.yes,
+        json: !!opts.json,
     });
 });
 // ── neetru db migrations ──────────────────────────────────────────────
@@ -1436,6 +1637,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')
@@ -1572,9 +1884,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)')