@neetru/cli 2.29.0 → 2.31.0

package/dist/index.js

@@ -157,6 +157,7 @@ program
     .option('--force', 'sobrescreve arquivos existentes em conflito (cuidado!)')
     // -y padronizado com bootstrap (`-y, --yes`) — muscle-memory (auditoria UX 2026-09).
     .option('-y, --yes', 'modo non-interactive (assume defaults, sai com erro se conflito sem flag)')
+    .option('--sem-docs', 'não cria o docs/ do produto (o padrão é rodar `neetru docs init`)')
     .action(async (name, opts) => {
     const { runInit } = await import('./commands/init.js');
     await runInit({
@@ -166,6 +167,7 @@ program
         path: opts.path,
         force: opts.force,
         yes: opts.yes,
+        semDocs: !!opts.semDocs,
     });
 });
 // ── neetru new (macro end-to-end) ─────────────────────────────────────
@@ -181,6 +183,7 @@ program
     .option('--open', 'abre o browser após criar o workspace (opt-in)')
     .option('--skip-open', '(obsoleto — browser não abre por default; use --open para abrir)')
     .option('--skip-db-init', 'pula o 5º passo de inicialização do banco de dados')
+    .option('--sem-docs', 'não cria o docs/ do produto no scaffold')
     .option('--json', 'saída em JSON (machine-readable)')
     .action(async (name, opts) => {
     const { runNewMacro } = await import('./commands/new.js');
@@ -193,6 +196,7 @@ program
         open: !!opts.open,
         skipOpen: !!opts.skipOpen,
         skipDbInit: !!opts.skipDbInit,
+        semDocs: !!opts.semDocs,
         json: !!opts.json,
     });
 });
@@ -309,11 +313,11 @@ program
 // ── neetru dev ────────────────────────────────────────────────────────
 // `neetru dev` (sem subcomando) = banco local Docker + watch de schema (M1
 // GAP-M1-4) — comportamento legado preservado (action + options intactos).
-// `neetru dev up` = ambiente dev-local (banco + agente) via Docker Compose.
+// `neetru dev up` = banco do produto em container via Docker Compose.
 // Subcomando aditivo: a action de `dev` só dispara quando nenhum subcomando casa.
 const devCmd = program
     .command('dev')
-    .description('Ambiente de dev local — banco Docker (default) ou ambiente completo (`dev up`)')
+    .description('Ambiente de dev local — banco Docker + watch de schema (default) ou só o banco (`dev up`)')
     .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) => {
@@ -322,8 +326,8 @@ const devCmd = program
 });
 devCmd
     .command('up')
-    .description('Sobe o ambiente dev-local (banco + agente) via Docker Compose')
-    .option('--core-port <port>', 'porta do app SaaS local (default 3000)')
+    .description('Sobe o banco do produto em container (Docker Compose) e mostra a conexão')
+    .option('--core-port <port>', 'porta do app local mostrada nas instruções (default 3000)')
     .action(async (opts) => {
     const { runDevUp } = await import('./commands/dev-up.js');
     await runDevUp({
@@ -449,6 +453,9 @@ program
     .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')
     .option('--skip-health-probe', 'NÃO faz o GET de saúde a https://<domain>/api/health?deep=1 pós-deploy (default: sempre faz; use só em serviço sem HTTP)')
+    .option('--allow-public-secret <motivo>', 'EMERGÊNCIA: deploya mesmo com segredo (nrt_/npk_/chave privada/env pública sensível) no pacote público. ' +
+    'Motivo obrigatório; fica registrado no deploy. Rotacione a chave depois.')
+    .option('--sem-docs', 'pula a checagem dos docs (só aviso) e a publicação automática (docs.publishOnDeploy)')
     .option('--json', 'saída em JSON estruturado (implica --non-interactive)')
     .action(async (opts) => {
     const { runDeploy } = await import('./commands/deploy.js');
@@ -474,6 +481,8 @@ program
         force: !!opts.force,
         skipHealthProbe: !!opts.skipHealthProbe,
         mfaToken: opts.mfaToken,
+        allowPublicSecret: opts.allowPublicSecret,
+        semDocs: !!opts.semDocs,
         json: !!opts.json,
     });
 });
@@ -1648,7 +1657,7 @@ program
     .option('--channel <channel>', 'filtrar por channel (stdout | stderr | app)')
     .option('--correlation-id <id>', 'filtrar por correlationId (UUID)')
     .option('--json', 'saída em JSON (NDJSON linha a linha, útil para pipes)')
-    .option('--local [path]', 'ler NDJSON local do emulador (dev up) em vez do Core; default .neetru/dev/logs.ndjson')
+    .option('--local [path]', 'ler NDJSON local (coletor do Core local) em vez do Core; default .neetru/dev/logs.ndjson')
     .action(async (opts) => {
     const { runLogs } = await import('./commands/logs.js');
     await runLogs({
@@ -2769,7 +2778,7 @@ drCmd
 // entrada pra quem quer LER docs, não publicar.
 const docsCmd = program
     .command('docs')
-    .description('Documentação + registry de docs publicados em gs://neetru-docs');
+    .description('Docs do produto (init/new/check/sync) + registry de docs do Core em gs://neetru-docs');
 docsCmd
     .command('open [topic]')
     .description('Abrir documentação no browser (ex: sdk, cli, db, webhooks, auth)')
@@ -2837,6 +2846,63 @@ docsCmd
         json: !!opts.json,
     });
 });
+// ── neetru docs init|new|check|sync — docs do PRODUTO ─────────────────
+// PROTOCOLO_DOCS_PRODUTOS_SAAS v1 (2026-10-03). Os subcomandos acima são o
+// control plane dos docs do Core; estes cuidam do `docs/` do repo do produto.
+docsCmd
+    .command('init')
+    .description('Criar o mínimo do primeiro dia do docs/ do produto (idempotente; nunca sobrescreve)')
+    .option('--com-api', 'inclui docs/api/API_V1.md (produto expõe /api/v1) e grava docs.api=true')
+    .option('--migrar', 'repo que já tem docs: só acrescenta frontmatter inferido + relatório (não move nem renomeia nada)')
+    .option('--dry-run', 'mostra o que faria, sem escrever')
+    .option('--json', 'saída em JSON')
+    .action(async (opts) => {
+    const { runDocsInit } = await import('./commands/docs-produto.js');
+    await runDocsInit({ comApi: !!opts.comApi, migrar: !!opts.migrar, dryRun: !!opts.dryRun, json: !!opts.json });
+});
+docsCmd
+    .command('new <tipo> <titulo>')
+    .description('Criar doc a partir do modelo (guia|referencia|arquitetura|adr|runbook|norma|plano|relatorio|incidente|ata|rfc|spec|politica|ameacas)')
+    .option('--categoria <categoria>', 'categoria da taxonomia (ex.: "Integrações")')
+    .option('--subcategoria <subcategoria>', 'subcategoria da categoria (ex.: marketplaces)')
+    .option('--audience <audience>', 'dev-produto | staff | publico (padrão: o da pasta)')
+    .option('--descricao <frase>', 'description (uma frase de 40 a 200 caracteres)')
+    .option('--data <AAAA-MM-DD>', 'data do registro (relatório, incidente, ata); padrão hoje')
+    .option('--dry-run', 'mostra o que faria, sem escrever')
+    .option('--json', 'saída em JSON')
+    .action(async (tipo, titulo, opts) => {
+    const { runDocsNew } = await import('./commands/docs-produto.js');
+    await runDocsNew(tipo, titulo, {
+        categoria: opts.categoria,
+        subcategoria: opts.subcategoria,
+        audience: opts.audience,
+        descricao: opts.descricao,
+        data: opts.data,
+        dryRun: !!opts.dryRun,
+        json: !!opts.json,
+    });
+});
+docsCmd
+    .command('check')
+    .description('Validar os docs do produto (offline; mesmos códigos do Core + PR001–PR004)')
+    .option('--changed', 'só os arquivos alterados contra a branch principal (catraca)')
+    .option('--strict', 'aviso também falha')
+    .option('--offline', 'não consulta a taxonomia do Core (usa a embutida)')
+    .option('--json', 'saída em JSON')
+    .action(async (opts) => {
+    const { runDocsCheck } = await import('./commands/docs-produto.js');
+    await runDocsCheck({ changed: !!opts.changed, strict: !!opts.strict, offline: !!opts.offline, json: !!opts.json });
+});
+docsCmd
+    .command('sync')
+    .description('Publicar os docs do produto no Core (só os sem erro; nada é apagado)')
+    .option('--dry-run', 'mostra o que enviaria, sem enviar')
+    .option('--offline', 'checa com a taxonomia embutida (o envio continua precisando do Core)')
+    .option('--json', 'saída em JSON')
+    .action(async (opts) => {
+    const { runDocsSync } = await import('./commands/docs-produto.js');
+    await runDocsSync({ dryRun: !!opts.dryRun, offline: !!opts.offline, json: !!opts.json });
+});
 // ── neetru webhooks ──────────────────────────────────────────────────
 // Produtos SaaS registram endpoints de webhook pra receber eventos do Core.
 const webhooksCmd = program