@codexa/cli 9.0.31 → 9.0.33

package/workflow.ts

@@ -42,14 +42,14 @@ import {
 } from "./commands/architect";
 import { teamSuggest } from "./commands/team";
 import { initSchema } from "./db/schema";
-import { getDb, closeDb } from "./db/connection";
+import { closeDb, dbGet, dbRun, ensureDatabase, getResolvedDbUrl } 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, GateError } from "./errors";
 
-function checkVersionSync(): void {
+async function checkVersionSync(): Promise<void> {
   // 1. Check CLI vs Plugin (dev repo only — igualdade estrita)
   try {
     const gitRoot = execSync("git rev-parse --show-toplevel", { encoding: "utf-8" }).trim();
@@ -71,19 +71,12 @@ function checkVersionSync(): void {
 
   // 2. Track CLI version in project DB (informativo, migracoes garantem compatibilidade)
   try {
-    const dbPath = join(process.cwd(), ".codexa", "db", "workflow.db");
-    if (!existsSync(dbPath)) return;
-
-    initSchema();
-    const db = getDb();
-    const project = db.query("SELECT cli_version FROM project WHERE id = 'default'").get() as any;
+    await initSchema();
+    const project = await dbGet<any>("SELECT cli_version FROM project WHERE id = 'default'");
     if (!project) return;
 
     if (!project.cli_version) {
-      db.run(
-        `UPDATE project SET cli_version = ? WHERE id = 'default'`,
-        [pkg.version]
-      );
+      await dbRun("UPDATE project SET cli_version = ? WHERE id = 'default'", [pkg.version]);
       console.log(`✓ Versao do CLI (${pkg.version}) registrada no projeto.`);
       return;
     }
@@ -93,10 +86,7 @@ function checkVersionSync(): void {
         `ℹ Projeto configurado com CLI v${project.cli_version}, rodando v${pkg.version}. ` +
         `Migracoes aplicadas automaticamente.`
       );
-      db.run(
-        `UPDATE project SET cli_version = ? WHERE id = 'default'`,
-        [pkg.version]
-      );
+      await dbRun("UPDATE project SET cli_version = ? WHERE id = 'default'", [pkg.version]);
     }
   } catch {
     // DB not available or column doesn't exist yet — skip
@@ -154,8 +144,8 @@ program
   .name("codexa")
   .description(`Codexa Workflow v${pkg.version} - Sistema de workflow para Claude Code`)
   .version(pkg.version)
-  .hook("preAction", () => {
-    checkVersionSync();
+  .hook("preAction", async () => {
+    await checkVersionSync();
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -170,8 +160,8 @@ planCmd
   .option("--from-analysis <id>", "Importar baby steps de analise arquitetural aprovada")
   .option("--max-tasks-per-phase <n>", "Maximo de tasks por fase (padrao: 12)", parseInt)
   .option("--json", "Saida em JSON")
-  .action((description: string, options: { fromAnalysis?: string; maxTasksPerPhase?: number; json?: boolean }) => {
-    planStart(description, options);
+  .action(async (description: string, options: { fromAnalysis?: string; maxTasksPerPhase?: number; json?: boolean }) => {
+    await planStart(description, options);
   });
 
 planCmd
@@ -179,8 +169,8 @@ planCmd
   .description("Mostra o plano atual")
   .option("--json", "Saida em JSON")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action((options) => {
-    planShow(options.json, options.spec);
+  .action(async (options) => {
+    await planShow(options.json, options.spec);
   });
 
 planCmd
@@ -192,16 +182,16 @@ planCmd
   .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, specId: options.spec });
+  .action(async (options) => {
+    await planTaskAdd({ ...options, specId: options.spec });
   });
 
 planCmd
   .command("cancel")
   .description("Cancela a feature atual (soft-cancel, preserva historico)")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action((options) => {
-    planCancel(options.spec);
+  .action(async (options) => {
+    await planCancel(options.spec);
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -214,24 +204,24 @@ checkCmd
   .command("request")
   .description("Solicita aprovacao do plano")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action((options) => {
-    checkRequest(options.spec);
+  .action(async (options) => {
+    await checkRequest(options.spec);
   });
 
 checkCmd
   .command("approve")
   .description("Aprova o plano")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action((options) => {
-    checkApprove(options.spec);
+  .action(async (options) => {
+    await checkApprove(options.spec);
   });
 
 checkCmd
   .command("reject <reason>")
   .description("Rejeita o plano com motivo")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action((reason: string, options) => {
-    checkReject(reason, options.spec);
+  .action(async (reason: string, options) => {
+    await checkReject(reason, options.spec);
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -245,8 +235,8 @@ taskCmd
   .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, options.spec);
+  .action(wrapAction(async (options) => {
+    await taskNext(options.json, options.spec);
   }));
 
 taskCmd
@@ -255,8 +245,8 @@ taskCmd
   .option("--json", "Saida em JSON")
   .option("--minimal-context", "Usar contexto reduzido (~2KB) em vez do completo")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action(wrapAction((ids: string, options) => {
-    taskStart(ids, options.json, options.minimalContext, options.spec);
+  .action(wrapAction(async (ids: string, options) => {
+    await taskStart(ids, options.json, options.minimalContext, options.spec);
   }));
 
 taskCmd
@@ -269,7 +259,7 @@ taskCmd
   .option("--force", "Ignorar validacao de standards (sera registrado)")
   .option("--force-reason <reason>", "Motivo do bypass de validacao")
   .option("--simplify", "Gerar prompt de simplificacao com standards do projeto")
-  .action(wrapAction((id: string, options) => {
+  .action(wrapAction(async (id: string, options) => {
     // Resolver --output-file: ler conteudo do arquivo
     if (options.outputFile && !options.output) {
       try {
@@ -299,7 +289,7 @@ taskCmd
       );
     }
 
-    taskDone(id, {
+    await taskDone(id, {
       checkpoint: options.checkpoint || "",
       files: options.files,
       force: options.force,
@@ -315,8 +305,8 @@ taskCmd
   .option("--json", "Saida em JSON")
   .option("--no-compact", "Nao compactar knowledge antes de avancar")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action(wrapAction((options) => {
-    taskPhaseAdvance({ noCompact: options.compact === false, json: options.json, spec: options.spec });
+  .action(wrapAction(async (options) => {
+    await taskPhaseAdvance({ noCompact: options.compact === false, json: options.json, spec: options.spec });
   }));
 
 // ═══════════════════════════════════════════════════════════════
@@ -328,9 +318,9 @@ program
   .description("Gera prompt de simplificacao com standards do projeto para uma task")
   .option("--audit", "Modo auditoria (apenas relatorio, sem aplicar mudancas)")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action(wrapAction((taskId: string, options) => {
+  .action(wrapAction(async (taskId: string, options) => {
     const { simplifyTask } = require("./commands/simplify");
-    simplifyTask(taskId, { audit: options.audit, specId: options.spec });
+    await simplifyTask(taskId, { audit: options.audit, specId: options.spec });
   }));
 
 // ═══════════════════════════════════════════════════════════════
@@ -343,8 +333,8 @@ program
   .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, specId: options.spec });
+  .action(async (title: string, decision: string, options) => {
+    await decide(title, decision, { ...options, specId: options.spec });
   });
 
 program
@@ -352,8 +342,8 @@ program
   .description("Lista decisoes")
   .option("--json", "Saida em JSON")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action((options) => {
-    listDecisions(options.json, options.spec);
+  .action(async (options) => {
+    await listDecisions(options.json, options.spec);
   });
 
 program
@@ -361,8 +351,8 @@ program
   .description("Revoga uma decisao ativa")
   .option("--reason <text>", "Motivo da revogacao")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action(wrapAction((id: string, options) => {
-    revokeDecision(id, options.reason, options.spec);
+  .action(wrapAction(async (id: string, options) => {
+    await revokeDecision(id, options.reason, options.spec);
   }));
 
 program
@@ -370,8 +360,8 @@ program
   .description("Substitui uma decisao ativa por uma nova")
   .option("--rationale <text>", "Justificativa da nova decisao")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action(wrapAction((id: string, title: string, decision: string, options) => {
-    supersedeDecision(id, title, decision, { rationale: options.rationale, specId: options.spec });
+  .action(wrapAction(async (id: string, title: string, decision: string, options) => {
+    await supersedeDecision(id, title, decision, { rationale: options.rationale, specId: options.spec });
   }));
 
 // ═══════════════════════════════════════════════════════════════
@@ -388,8 +378,8 @@ knowledgeCmd
   .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({
+  .action(async (options) => {
+    await addKnowledge({
       content: options.content,
       category: options.category,
       severity: options.severity,
@@ -406,16 +396,16 @@ knowledgeCmd
   .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, specId: options.spec });
+  .action(async (options) => {
+    await listKnowledge({ ...options, specId: options.spec });
   });
 
 knowledgeCmd
   .command("ack <id>")
   .description("Marca knowledge como lido pela task atual")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action((id: string, options) => {
-    acknowledgeKnowledge(id, options.spec);
+  .action(async (id: string, options) => {
+    await acknowledgeKnowledge(id, options.spec);
   });
 
 knowledgeCmd
@@ -423,8 +413,8 @@ knowledgeCmd
   .description("Resolve/reconhece knowledge item(s) critico(s)")
   .option("--resolution <text>", "Descricao de como o blocker foi resolvido")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action((ids: string, opts: { resolution?: string; spec?: string }) => {
-    resolveKnowledge(ids, opts.resolution, opts.spec);
+  .action(async (ids: string, opts: { resolution?: string; spec?: string }) => {
+    await resolveKnowledge(ids, opts.resolution, opts.spec);
   });
 
 knowledgeCmd
@@ -434,8 +424,8 @@ knowledgeCmd
   .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 });
+  .action(async (options) => {
+    await queryGraph({ ...options, specId: options.spec });
   });
 
 knowledgeCmd
@@ -444,8 +434,8 @@ knowledgeCmd
   .option("--spec <id>", "ID do spec (padrao: todos)")
   .option("--dry-run", "Apenas mostrar o que seria compactado")
   .option("--json", "Saida em JSON")
-  .action((options) => {
-    compactKnowledge({ specId: options.spec, dryRun: options.dryRun, json: options.json });
+  .action(async (options) => {
+    await compactKnowledge({ specId: options.spec, dryRun: options.dryRun, json: options.json });
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -459,8 +449,8 @@ reviewCmd
   .description("Inicia o review")
   .option("--json", "Saida em JSON")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action((options) => {
-    reviewStart(options.json, options.spec);
+  .action(async (options) => {
+    await reviewStart(options.json, options.spec);
   });
 
 reviewCmd
@@ -469,16 +459,16 @@ reviewCmd
   .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 });
+  .action(async (options) => {
+    await reviewApprove({ specId: options.spec, force: options.force, forceReason: options.forceReason });
   });
 
 reviewCmd
   .command("skip")
   .description("Pula o review e finaliza a feature diretamente")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action((options) => {
-    reviewSkip(options.spec);
+  .action(async (options) => {
+    await reviewSkip(options.spec);
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -490,8 +480,8 @@ program
   .description("Mostra status atual")
   .option("--json", "Saida em JSON")
   .option("--spec <id>", "ID do spec (padrao: todos ativos)")
-  .action((options) => {
-    status(options.json, options.spec);
+  .action(async (options) => {
+    await status(options.json, options.spec);
   });
 
 const contextCmd = program.command("context").description("Comandos de contexto");
@@ -501,8 +491,8 @@ contextCmd
   .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, specId: options.spec }); // Sempre JSON
+  .action(async (options) => {
+    await contextExport({ ...options, json: true, specId: options.spec }); // Sempre JSON
   });
 
 contextCmd
@@ -510,8 +500,8 @@ contextCmd
   .description("Mostra secao especifica do contexto (standards, decisions, patterns, knowledge, architecture)")
   .option("--json", "Output JSON")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action((section: string, opts: { json?: boolean; spec?: string }) => {
-    contextDetail(section, opts.json, opts.spec);
+  .action(async (section: string, opts: { json?: boolean; spec?: string }) => {
+    await contextDetail(section, opts.json, opts.spec);
   });
 
 contextCmd
@@ -519,13 +509,10 @@ contextCmd
   .description("Mostra estimativa de uso de contexto para uma task")
   .option("--task <id>", "ID da task")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action(wrapAction((options: { task?: string; spec?: string }) => {
+  .action(wrapAction(async (options: { task?: string; spec?: string }) => {
     const { getContextForSubagent, getMinimalContextForSubagent } = require("./context/generator");
     const { getContextBudget, formatContextWarning } = require("./context/monitor");
-    const { getDb } = require("./db/connection");
-    const { initSchema } = require("./db/schema");
-    initSchema();
-    const db = getDb();
+    await initSchema();
 
     const taskId = options.task ? parseInt(options.task) : null;
     if (!taskId) {
@@ -533,13 +520,15 @@ contextCmd
       return;
     }
 
-    const fullCtx = getContextForSubagent(taskId);
-    const minCtx = getMinimalContextForSubagent(taskId);
+    const fullCtx = await getContextForSubagent(taskId);
+    const minCtx = await getMinimalContextForSubagent(taskId);
 
-    const task = db.query("SELECT spec_id FROM tasks WHERE id = ?").get(taskId) as any;
-    const completedCount = task ? (db.query(
-      "SELECT COUNT(*) as c FROM tasks WHERE spec_id = ? AND status = 'done'"
-    ).get(task.spec_id) as any)?.c || 0 : 0;
+    const task = await dbGet<any>("SELECT spec_id FROM tasks WHERE id = ?", [taskId]);
+    const completedRow = task ? await dbGet<any>(
+      "SELECT COUNT(*) as c FROM tasks WHERE spec_id = ? AND status = 'done'",
+      [task.spec_id]
+    ) : null;
+    const completedCount = completedRow?.c || 0;
 
     const budget = getContextBudget(fullCtx, completedCount);
     const warning = formatContextWarning(budget);
@@ -560,8 +549,8 @@ program
   .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, specId: options.spec });
+  .action(async (options) => {
+    await contextExport({ ...options, json: true, specId: options.spec });
   });
 
 program
@@ -571,16 +560,18 @@ program
   .option("--snapshot <id>", "Mostra detalhes de um snapshot")
   .option("--restore", "Restaura o snapshot especificado")
   .option("--auto", "Restaura o ultimo snapshot automaticamente")
-  .action((options) => {
-    recover(options);
+  .action(async (options) => {
+    await recover(options);
   });
 
 program
   .command("init")
-  .description("Inicializa o banco de dados")
-  .action(() => {
-    initSchema();
-    console.log("\nBanco de dados inicializado em .codexa/db/workflow.db\n");
+  .description("Inicializa o banco de dados no Turso")
+  .action(async () => {
+    await ensureDatabase();
+    await initSchema();
+    const url = getResolvedDbUrl();
+    console.log(`\nBanco de dados inicializado: ${url}\n`);
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -600,16 +591,16 @@ discoverCmd
 discoverCmd
   .command("confirm")
   .description("Confirma e salva a descoberta")
-  .action(() => {
-    discoverConfirm();
+  .action(async () => {
+    await discoverConfirm();
   });
 
 discoverCmd
   .command("show")
   .description("Mostra projeto descoberto")
   .option("--json", "Saida em JSON")
-  .action((options) => {
-    discoverShow(options.json);
+  .action(async (options) => {
+    await discoverShow(options.json);
   });
 
 discoverCmd
@@ -626,15 +617,12 @@ discoverCmd
   .option("--grepai-workspace <name>", "Nome do workspace grepai para busca semantica cross-project. Vazio para remover.")
   .option("--auto-simplify", "Habilitar simplificacao automatica pos-task com standards do projeto")
   .option("--no-auto-simplify", "Desabilitar simplificacao automatica pos-task")
-  .action((options) => {
+  .action(async (options) => {
     // Tratar typecheck-command separadamente
     if (options.typecheckCommand !== undefined) {
-      const { initSchema } = require("./db/schema");
-      const { getDb } = require("./db/connection");
-      initSchema();
-      const db = getDb();
+      await initSchema();
       const value = options.typecheckCommand === "" ? null : options.typecheckCommand;
-      db.run("UPDATE project SET typecheck_command = ? WHERE id = 'default'", [value]);
+      await dbRun("UPDATE project SET typecheck_command = ? WHERE id = 'default'", [value]);
       if (value) {
         console.log(`\n[ok] Typecheck command configurado: ${value}`);
       } else {
@@ -644,17 +632,14 @@ discoverCmd
     }
     // Tratar grepai-workspace separadamente
     if (options.grepaiWorkspace !== undefined) {
-      const { initSchema } = require("./db/schema");
-      const { getDb } = require("./db/connection");
-      initSchema();
-      const db = getDb();
+      await initSchema();
       const value = options.grepaiWorkspace === "" ? null : options.grepaiWorkspace;
       if (value && !isValidWorkspaceName(value)) {
         console.error(`\n[erro] Nome de workspace invalido: "${value}"`);
         console.error("  Use apenas letras, numeros, hifens e underscores (ex: meu-workspace, dotnet_ws)\n");
         return;
       }
-      db.run("UPDATE project SET grepai_workspace = ? WHERE id = 'default'", [value]);
+      await dbRun("UPDATE project SET grepai_workspace = ? WHERE id = 'default'", [value]);
       if (value) {
         console.log(`\n✓ Grepai workspace configurado: ${value}`);
         console.log("  Sera usado em: semantic search (standards), deep-explore agent, grepai trace");
@@ -667,7 +652,7 @@ discoverCmd
     // Tratar auto-simplify
     if (options.autoSimplify !== undefined) {
       const { setAutoSimplify } = require("./commands/simplify");
-      setAutoSimplify(!!options.autoSimplify);
+      await setAutoSimplify(!!options.autoSimplify);
     }
     // Tratar stack options normalmente
     const stackOptions = { ...options };
@@ -675,15 +660,15 @@ discoverCmd
     delete stackOptions.grepaiWorkspace;
     delete stackOptions.autoSimplify;
     if (Object.keys(stackOptions).length > 0) {
-      discoverSetStack(stackOptions);
+      await discoverSetStack(stackOptions);
     }
   });
 
 discoverCmd
   .command("reset", { hidden: true })
   .description("Reseta descoberta para refazer")
-  .action(() => {
-    discoverReset();
+  .action(async () => {
+    await discoverReset();
   });
 
 discoverCmd
@@ -711,11 +696,11 @@ discoverCmd
   .option("--category <cat>", "Filtrar por categoria")
   .option("--show <name>", "Mostra detalhes de um pattern")
   .option("--json", "Saida em JSON")
-  .action((options) => {
+  .action(async (options) => {
     if (options.show) {
-      discoverPatternsShow(options.show, options.json);
+      await discoverPatternsShow(options.show, options.json);
     } else {
-      discoverPatterns({ category: options.category, json: options.json });
+      await discoverPatterns({ category: options.category, json: options.json });
     }
   });
 
@@ -732,8 +717,8 @@ discoverCmd
   .option("--anti-patterns <json>", "JSON array de anti-patterns")
   .option("--confidence <num>", "Confianca 0-1", "0.8")
   .option("--extracted-from <num>", "Numero de arquivos analisados", "1")
-  .action((options) => {
-    discoverPatternAdd({
+  .action(async (options) => {
+    await discoverPatternAdd({
       category: options.category,
       name: options.name,
       scope: options.scope,
@@ -758,8 +743,8 @@ discoverCmd
   .option("--examples <json>", "Novos exemplos JSON")
   .option("--anti-patterns <json>", "Novos anti-patterns JSON")
   .option("--confidence <num>", "Nova confianca 0-1")
-  .action((name, options) => {
-    discoverPatternEdit(name, {
+  .action(async (name, options) => {
+    await discoverPatternEdit(name, {
       category: options.category,
       scope: options.scope,
       appliesTo: options.appliesTo,
@@ -774,15 +759,15 @@ discoverCmd
 discoverCmd
   .command("pattern-remove <name>")
   .description("Remove um implementation pattern")
-  .action((name) => {
-    discoverPatternRemove(name);
+  .action(async (name) => {
+    await discoverPatternRemove(name);
   });
 
 discoverCmd
   .command("refresh-patterns")
   .description("Re-extrai patterns do codigo (requer analise manual)")
-  .action(() => {
-    discoverRefreshPatterns();
+  .action(async () => {
+    await discoverRefreshPatterns();
   });
 
 discoverCmd
@@ -814,8 +799,8 @@ discoverCmd
 discoverCmd
   .command("export-patterns", { hidden: true })
   .description("Regenera arquivo patterns.md")
-  .action(() => {
-    discoverExportPatterns();
+  .action(async () => {
+    await discoverExportPatterns();
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -830,8 +815,8 @@ standardsCmd
   .option("--category <cat>", "Filtrar por categoria")
   .option("--scope <scope>", "Filtrar por escopo")
   .option("--json", "Saida em JSON")
-  .action((options) => {
-    standardsList(options);
+  .action(async (options) => {
+    await standardsList(options);
   });
 
 standardsCmd
@@ -847,13 +832,13 @@ standardsCmd
   .option("--recommended", "Alias para --enforcement recommended")
   .option("--semantic-query <query>", "Query semantica para grepai (ingles)")
   .option("--expect <type>", "Expectativa: no_match ou must_match", "no_match")
-  .action((options) => {
+  .action(async (options) => {
     // Resolver aliases de enforcement
     let enforcement = options.enforcement;
     if (options.required) enforcement = "required";
     if (options.recommended) enforcement = "recommended";
 
-    standardsAdd({
+    await standardsAdd({
       category: options.category,
       scope: options.scope,
       rule: options.rule,
@@ -874,8 +859,8 @@ standardsCmd
   .option("--enforcement <level>", "Novo nivel de enforcement")
   .option("--semantic-query <query>", "Query semantica para grepai (ingles)")
   .option("--expect <type>", "Expectativa: no_match ou must_match")
-  .action((id, options) => {
-    standardsEdit(id, {
+  .action(async (id, options) => {
+    await standardsEdit(id, {
       rule: options.rule,
       examples: options.examples,
       antiExamples: options.antiExamples,
@@ -888,15 +873,15 @@ standardsCmd
 standardsCmd
   .command("remove <id>")
   .description("Remove um standard")
-  .action((id) => {
-    standardsRemove(id);
+  .action(async (id) => {
+    await standardsRemove(id);
   });
 
 standardsCmd
   .command("export")
   .description("Regenera arquivo standards.md")
-  .action(() => {
-    standardsExport();
+  .action(async () => {
+    await standardsExport();
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -910,8 +895,8 @@ productCmd
   .description("Importa PRD existente")
   .option("--file <path>", "Caminho para arquivo PRD")
   .option("--content <text>", "Conteudo do PRD")
-  .action((options) => {
-    productImport(options);
+  .action(async (options) => {
+    await productImport(options);
   });
 
 productCmd
@@ -927,8 +912,8 @@ productCmd
   .option("--constraints <list>", "Restricoes (separadas por virgula)")
   .option("--goal <spec>", "Adiciona objetivo (formato: categoria:texto:prioridade)")
   .option("--feature <spec>", "Adiciona feature (formato: nome:descricao:prioridade)")
-  .action((options) => {
-    productSet(options);
+  .action(async (options) => {
+    await productSet(options);
   });
 
 productCmd
@@ -936,22 +921,22 @@ productCmd
   .description("Mostra contexto de produto")
   .option("--json", "Saida em JSON")
   .option("--pending", "Mostra contexto pendente (nao confirmado)")
-  .action((options) => {
-    productShow(options);
+  .action(async (options) => {
+    await productShow(options);
   });
 
 productCmd
   .command("confirm")
   .description("Confirma e salva o contexto de produto")
-  .action(() => {
-    productConfirm();
+  .action(async () => {
+    await productConfirm();
   });
 
 productCmd
   .command("reset")
   .description("Reseta contexto de produto para refazer")
-  .action(() => {
-    productReset();
+  .action(async () => {
+    await productReset();
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -973,16 +958,16 @@ researchCmd
   .description("Mostra status das bibliotecas detectadas")
   .option("--json", "Saida em JSON")
   .option("--lib <name>", "Filtrar por biblioteca especifica")
-  .action((options) => {
-    researchShow(options);
+  .action(async (options) => {
+    await researchShow(options);
   });
 
 researchCmd
   .command("fill <lib>")
   .description("Gera instrucoes para preencher contexto de uma biblioteca")
   .option("--json", "Saida em JSON")
-  .action((lib: string, options) => {
-    researchFill(lib, options);
+  .action(async (lib: string, options) => {
+    await researchFill(lib, options);
   });
 
 researchCmd
@@ -992,15 +977,15 @@ researchCmd
   .option("--add <libs>", "Adicionar bibliotecas (separadas por virgula)")
   .option("--remove <libs>", "Remover bibliotecas (separadas por virgula)")
   .option("--json", "Saida em JSON")
-  .action((options) => {
-    researchMapAgent(options);
+  .action(async (options) => {
+    await researchMapAgent(options);
   });
 
 researchCmd
   .command("reset")
   .description("Remove todos os contextos de biblioteca")
-  .action(() => {
-    researchReset();
+  .action(async () => {
+    await researchReset();
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -1013,11 +998,11 @@ program
   .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) => {
+  .action(async (options) => {
     if (options.show) {
-      clearShow();
+      await clearShow();
     } else {
-      clearTasks({ force: options.force, specId: options.spec });
+      await clearTasks({ force: options.force, specId: options.spec });
     }
   });
 
@@ -1031,8 +1016,8 @@ architectCmd
   .command("start <description>")
   .description("Inicia nova analise arquitetural")
   .option("--json", "Saida em JSON")
-  .action((description: string, options) => {
-    architectStart(description, options);
+  .action(async (description: string, options) => {
+    await architectStart(description, options);
   });
 
 architectCmd
@@ -1040,8 +1025,8 @@ architectCmd
   .description("Mostra analise atual ou especifica")
   .option("--id <id>", "ID da analise")
   .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectShow(options);
+  .action(async (options) => {
+    await architectShow(options);
   });
 
 architectCmd
@@ -1049,8 +1034,8 @@ architectCmd
   .description("Lista todas as analises")
   .option("--status <status>", "Filtrar por status (pending, approved, implemented, rejected)")
   .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectList(options);
+  .action(async (options) => {
+    await architectList(options);
   });
 
 architectCmd
@@ -1058,8 +1043,8 @@ architectCmd
   .description("Salva analise em arquivo markdown")
   .option("--file <path>", "Caminho do arquivo (default: .codexa/analysis/ARCH-xxx.md)")
   .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectSave(options);
+  .action(async (options) => {
+    await architectSave(options);
   });
 
 architectCmd
@@ -1067,8 +1052,8 @@ architectCmd
   .description("Aprova analise para implementacao")
   .option("--id <id>", "ID da analise")
   .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectApprove(options);
+  .action(async (options) => {
+    await architectApprove(options);
   });
 
 architectCmd
@@ -1076,8 +1061,8 @@ architectCmd
   .description("Exporta baby steps como comandos para criar tasks")
   .option("--id <id>", "ID da analise")
   .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectExport(options);
+  .action(async (options) => {
+    await architectExport(options);
   });
 
 architectCmd
@@ -1085,8 +1070,8 @@ architectCmd
   .description("Cancela analise pendente")
   .option("--id <id>", "ID da analise")
   .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectCancel(options);
+  .action(async (options) => {
+    await architectCancel(options);
   });
 
 // ═══════════════════════════════════════════════════════════════
@@ -1101,8 +1086,8 @@ teamCmd
   .option("--json", "Saida em JSON")
   .option("--phase <phase>", "Fase especifica (imp, rev, architect)")
   .option("--spec <id>", "ID do spec (padrao: mais recente)")
-  .action(wrapAction((options) => {
-    teamSuggest(options);
+  .action(wrapAction(async (options) => {
+    await teamSuggest(options);
   }));
 
 // ═══════════════════════════════════════════════════════════════
@@ -1115,8 +1100,8 @@ pluginCmd
   .command("sync-agents")
   .description("Copia agents do plugin para .claude/agents/ do projeto (resolve limitacao de subagent_type)")
   .option("--force", "Sobrescrever agents existentes")
-  .action((options) => {
-    syncAgents(options);
+  .action(async (options) => {
+    await syncAgents(options);
   });
 
 // Parse e executa