@codexa/cli 9.0.3 → 9.0.4

package/workflow.ts

@@ -6,7 +6,7 @@ import { checkRequest, checkApprove, checkReject } from "./commands/check";
 import { taskNext, taskStart, taskDone } from "./commands/task";
 import { decide, listDecisions } from "./commands/decide";
 import { reviewStart, reviewApprove, reviewSkip } from "./commands/review";
-import { addKnowledge, listKnowledge, acknowledgeKnowledge, queryGraph, resolveKnowledge } from "./commands/knowledge";
+import { addKnowledge, listKnowledge, acknowledgeKnowledge, queryGraph, resolveKnowledge, compactKnowledge } from "./commands/knowledge";
 import { status, contextExport, recover, contextUpdate, contextDetail } from "./commands/utils";
 import {
   discoverStart,
@@ -40,12 +40,12 @@ import {
   architectCancel,
 } from "./commands/architect";
 import { initSchema } from "./db/schema";
-import { getDb } from "./db/connection";
+import { getDb, closeDb } from "./db/connection";
 import { execSync } from "child_process";
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 import pkg from "./package.json";
-import { CodexaError, ValidationError } from "./errors";
+import { CodexaError, ValidationError, GateError } from "./errors";
 
 function checkVersionSync(): void {
   // 1. Check CLI vs Plugin (dev repo only)
@@ -103,9 +103,27 @@ function checkVersionSync(): void {
 function handleError(e: unknown): never {
   if (e instanceof CodexaError) {
     console.error(`\n${e.message}\n`);
+
+    // v9.3: Exibir diagnostico e passos de recuperacao para falhas de gate
+    if (e instanceof GateError && e.recovery) {
+      console.error("\u2500".repeat(50));
+      console.error("DIAGNOSTICO:");
+      console.error(`  ${e.recovery.diagnostic}\n`);
+      console.error("PASSOS PARA CORRIGIR:");
+      for (const step of e.recovery.steps) {
+        console.error(`  \u2192 ${step}`);
+      }
+      if (e.recovery.command) {
+        console.error(`\nPara mais detalhes: ${e.recovery.command}`);
+      }
+      console.error();
+    }
+
+    closeDb();
     process.exit(e.exitCode);
   }
   console.error(`\n[ERRO INESPERADO] ${(e as Error).message}\n`);
+  closeDb();
   process.exit(1);
 }
 
@@ -114,10 +132,14 @@ function wrapAction<T extends (...args: any[]) => any>(fn: T): T {
     try {
       const result = fn(...args);
       if (result instanceof Promise) {
-        return result.catch(handleError);
+        return result.catch((e) => {
+          closeDb();
+          handleError(e);
+        });
       }
       return result;
     } catch (e) {
+      closeDb();
       handleError(e);
     }
   }) as T;
@@ -130,15 +152,7 @@ program
   .description(`Codexa Workflow v${pkg.version} - Sistema de workflow para Claude Code`)
   .version(pkg.version)
   .hook("preAction", () => {
-    try {
-      checkVersionSync();
-    } catch (e) {
-      if (e instanceof CodexaError) {
-        console.error(`\n${e.message}\n`);
-        process.exit(e.exitCode);
-      }
-      throw e;
-    }
+    checkVersionSync();
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -160,8 +174,9 @@ planCmd
   .command("show")
   .description("Mostra o plano atual")
   .option("--json", "Saida em JSON")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action((options) => {
-    planShow(options.json);
+    planShow(options.json, options.spec);
   });
 
 planCmd
@@ -172,15 +187,17 @@ planCmd
   .option("--depends <ids>", "IDs das tasks que esta depende (ex: 1,2)")
   .option("--files <files>", "Arquivos esperados (ex: src/a.ts,src/b.ts)")
   .option("--sequential", "Marca como sequencial (nao paralelizavel)")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action((options) => {
-    planTaskAdd(options);
+    planTaskAdd({ ...options, specId: options.spec });
   });
 
 planCmd
   .command("cancel")
   .description("Cancela a feature atual (soft-cancel, preserva historico)")
-  .action(() => {
-    planCancel();
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
+  .action((options) => {
+    planCancel(options.spec);
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -192,22 +209,25 @@ const checkCmd = program.command("check").description("Comandos da fase CHECK");
 checkCmd
   .command("request")
   .description("Solicita aprovacao do plano")
-  .action(() => {
-    checkRequest();
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
+  .action((options) => {
+    checkRequest(options.spec);
   });
 
 checkCmd
   .command("approve")
   .description("Aprova o plano")
-  .action(() => {
-    checkApprove();
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
+  .action((options) => {
+    checkApprove(options.spec);
   });
 
 checkCmd
   .command("reject <reason>")
   .description("Rejeita o plano com motivo")
-  .action((reason: string) => {
-    checkReject(reason);
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
+  .action((reason: string, options) => {
+    checkReject(reason, options.spec);
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -220,8 +240,9 @@ taskCmd
   .command("next")
   .description("Mostra proximas tasks disponiveis")
   .option("--json", "Saida em JSON")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action(wrapAction((options) => {
-    taskNext(options.json);
+    taskNext(options.json, options.spec);
   }));
 
 taskCmd
@@ -229,8 +250,9 @@ taskCmd
   .description("Inicia task(s) - pode ser multiplas separadas por virgula")
   .option("--json", "Saida em JSON")
   .option("--full-context", "Incluir contexto completo (modo legado)")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action(wrapAction((ids: string, options) => {
-    taskStart(ids, options.json, options.fullContext);
+    taskStart(ids, options.json, options.fullContext, options.spec);
   }));
 
 taskCmd
@@ -290,16 +312,18 @@ program
   .description("Registra uma decisao")
   .option("--rationale <text>", "Justificativa da decisao")
   .option("--force", "Ignorar deteccao de conflitos")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action((title: string, decision: string, options) => {
-    decide(title, decision, options);
+    decide(title, decision, { ...options, specId: options.spec });
   });
 
 program
   .command("decisions")
   .description("Lista decisoes")
   .option("--json", "Saida em JSON")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action((options) => {
-    listDecisions(options.json);
+    listDecisions(options.json, options.spec);
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -315,12 +339,14 @@ knowledgeCmd
   .requiredOption("--category <cat>", "Categoria (discovery, decision, blocker, pattern, constraint)")
   .option("--severity <level>", "Severidade (info, warning, critical)", "info")
   .option("--broadcast <target>", "Destino (all ou IDs separados por virgula)", "all")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action((options) => {
     addKnowledge({
       content: options.content,
       category: options.category,
       severity: options.severity,
       broadcastTo: options.broadcast,
+      specId: options.spec,
     });
   });
 
@@ -331,23 +357,26 @@ knowledgeCmd
   .option("--category <cat>", "Filtrar por categoria")
   .option("--severity <level>", "Filtrar por severidade (critical, warning, info)")
   .option("--json", "Saida em JSON")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action((options) => {
-    listKnowledge(options);
+    listKnowledge({ ...options, specId: options.spec });
   });
 
 knowledgeCmd
   .command("ack <id>")
   .description("Marca knowledge como lido pela task atual")
-  .action((id: string) => {
-    acknowledgeKnowledge(id);
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
+  .action((id: string, options) => {
+    acknowledgeKnowledge(id, options.spec);
   });
 
 knowledgeCmd
   .command("resolve <ids>")
   .description("Resolve/reconhece knowledge item(s) critico(s)")
   .option("--resolution <text>", "Descricao de como o blocker foi resolvido")
-  .action((ids: string, opts: { resolution?: string }) => {
-    resolveKnowledge(ids, opts.resolution);
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
+  .action((ids: string, opts: { resolution?: string; spec?: string }) => {
+    resolveKnowledge(ids, opts.resolution, opts.spec);
   });
 
 knowledgeCmd
@@ -356,8 +385,19 @@ knowledgeCmd
   .option("--file <path>", "Buscar relacoes de um arquivo")
   .option("--decision <id>", "Buscar arquivos afetados por uma decisao")
   .option("--json", "Saida em JSON")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
+  .action((options) => {
+    queryGraph({ ...options, specId: options.spec });
+  });
+
+knowledgeCmd
+  .command("compact")
+  .description("Compacta knowledge (merge similares, arquivar antigos)")
+  .option("--spec <id>", "ID do spec (padrao: todos)")
+  .option("--dry-run", "Apenas mostrar o que seria compactado")
+  .option("--json", "Saida em JSON")
   .action((options) => {
-    queryGraph(options);
+    compactKnowledge({ specId: options.spec, dryRun: options.dryRun, json: options.json });
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -370,22 +410,27 @@ reviewCmd
   .command("start")
   .description("Inicia o review")
   .option("--json", "Saida em JSON")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action((options) => {
-    reviewStart(options.json);
+    reviewStart(options.json, options.spec);
   });
 
 reviewCmd
   .command("approve")
   .description("Aprova o review e finaliza a feature")
-  .action(() => {
-    reviewApprove();
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
+  .option("--force", "Aprovar mesmo com score baixo (<50)")
+  .option("--force-reason <reason>", "Motivo para aprovacao forcada")
+  .action((options) => {
+    reviewApprove({ specId: options.spec, force: options.force, forceReason: options.forceReason });
   });
 
 reviewCmd
   .command("skip")
   .description("Pula o review e finaliza a feature diretamente")
-  .action(() => {
-    reviewSkip();
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
+  .action((options) => {
+    reviewSkip(options.spec);
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -396,8 +441,9 @@ program
   .command("status")
   .description("Mostra status atual")
   .option("--json", "Saida em JSON")
+  .option("--spec <id>", "ID do spec (padrao: todos ativos)")
   .action((options) => {
-    status(options.json);
+    status(options.json, options.spec);
   });
 
 const contextCmd = program.command("context").description("Comandos de contexto");
@@ -406,8 +452,9 @@ contextCmd
   .command("export")
   .description("Exporta contexto para subagent")
   .option("--task <id>", "ID da task especifica")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action((options) => {
-    contextExport({ ...options, json: true }); // Sempre JSON
+    contextExport({ ...options, json: true, specId: options.spec }); // Sempre JSON
   });
 
 contextCmd
@@ -416,16 +463,18 @@ contextCmd
   .option("--approach <text>", "Adiciona nova abordagem descoberta")
   .option("--pattern <text>", "Registra padrao identificado no codigo")
   .option("--constraint <text>", "Adiciona nova limitacao encontrada")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action((options) => {
-    contextUpdate(options);
+    contextUpdate({ ...options, specId: options.spec });
   });
 
 contextCmd
   .command("detail <section>")
   .description("Mostra secao especifica do contexto (standards, decisions, patterns, knowledge, architecture)")
   .option("--json", "Output JSON")
-  .action((section: string, opts: { json?: boolean }) => {
-    contextDetail(section, opts.json);
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
+  .action((section: string, opts: { json?: boolean; spec?: string }) => {
+    contextDetail(section, opts.json, opts.spec);
   });
 
 // Manter compatibilidade: context sem subcomando = export
@@ -433,8 +482,9 @@ program
   .command("ctx")
   .description("Alias para context export (compatibilidade)")
   .option("--task <id>", "ID da task especifica")
+  .option("--spec <id>", "ID do spec (padrao: mais recente)")
   .action((options) => {
-    contextExport({ ...options, json: true });
+    contextExport({ ...options, json: true, specId: options.spec });
   });
 
 program
@@ -500,7 +550,7 @@ discoverCmd
   });
 
 discoverCmd
-  .command("reset")
+  .command("reset", { hidden: true })
   .description("Reseta descoberta para refazer")
   .action(() => {
     discoverReset();
@@ -568,7 +618,7 @@ discoverCmd
   });
 
 discoverCmd
-  .command("pattern-edit <name>")
+  .command("pattern-edit <name>", { hidden: true })
   .description("Edita um implementation pattern")
   .option("--category <cat>", "Nova categoria")
   .option("--scope <scope>", "Novo escopo")
@@ -618,7 +668,7 @@ discoverCmd
   });
 
 discoverCmd
-  .command("analyze-file <path>")
+  .command("analyze-file <path>", { hidden: true })
   .description("Analisa estrutura de um arquivo (imports, exports, convencoes)")
   .option("--json", "Saida em JSON")
   .action((path, options) => {
@@ -627,7 +677,7 @@ discoverCmd
 
 // v9.0: Analise profunda com metadata enriquecida + grepai
 discoverCmd
-  .command("analyze-deep <files...>")
+  .command("analyze-deep <files...>", { hidden: true })
   .description("Analise profunda de arquivos (hooks, patterns, directives)")
   .option("--json", "Saida em JSON")
   .action((files, options) => {
@@ -637,7 +687,7 @@ discoverCmd
 
 // v9.0: Anti-patterns de gate bypasses
 discoverCmd
-  .command("extract-anti-patterns")
+  .command("extract-anti-patterns", { hidden: true })
   .description("Extrai anti-patterns do historico de gate bypasses")
   .action(() => {
     const { extractAntiPatternsFromHistory } = require("./commands/patterns");
@@ -645,7 +695,7 @@ discoverCmd
   });
 
 discoverCmd
-  .command("export-patterns")
+  .command("export-patterns", { hidden: true })
   .description("Regenera arquivo patterns.md")
   .action(() => {
     discoverExportPatterns();
@@ -863,11 +913,12 @@ program
   .description("Limpa tasks/features mantendo configuracoes do projeto (standards, patterns, PRD)")
   .option("--force", "Confirma a limpeza (sem isso apenas mostra o que sera removido)")
   .option("--show", "Mostra estado atual dos arquivos do workflow")
+  .option("--spec <id>", "Limpa apenas o spec especificado")
   .action((options) => {
     if (options.show) {
       clearShow();
     } else {
-      clearTasks({ force: options.force });
+      clearTasks({ force: options.force, specId: options.spec });
     }
   });