@codexa/cli 9.0.1 → 9.0.3

package/protocol/subagent-protocol.ts

@@ -27,6 +27,8 @@ export interface Reasoning {
 }
 
 export interface SubagentReturn {
+  // v9.1: Versao do protocolo (opcional por compatibilidade)
+  protocol_version?: string;
   status: "completed" | "blocked" | "needs_decision";
   summary: string;
   files_created: string[];
@@ -58,11 +60,14 @@ const VALID_STATUSES = ["completed", "blocked", "needs_decision"];
 const VALID_KNOWLEDGE_CATEGORIES = ["discovery", "decision", "blocker", "pattern", "constraint"];
 const VALID_SEVERITIES = ["info", "warning", "critical"];
 
+// v9.1: Versao atual do protocolo de subagentes
+export const CURRENT_PROTOCOL_VERSION = "9.1";
+
 /**
  * Extrai JSON de uma string que pode conter texto misto
  * Subagents podem retornar texto com JSON embutido
  */
-function extractJsonFromText(text: string): string | null {
+export function extractJsonFromText(text: string): string | null {
   // Tenta encontrar JSON em bloco de codigo
   const codeBlockMatch = text.match(/```(?:json)?\s*([\s\S]*?)```/);
   if (codeBlockMatch) {
@@ -222,6 +227,8 @@ export function parseSubagentReturn(input: string): ParseResult {
       errors: [
         `JSON invalido: ${(e as Error).message}`,
         "Verifique se o JSON esta bem formatado.",
+        "Dica: Caracteres como ! $ ` em double-quotes causam problemas no shell.",
+        "Use aspas simples ou --output-file /tmp/result.json para evitar escaping.",
       ],
       rawInput: input,
     };
@@ -238,6 +245,10 @@ export function parseSubagentReturn(input: string): ParseResult {
   const summaryError = validateString(parsed.summary, "summary", 10, 500);
   if (summaryError) errors.push(summaryError);
 
+  // files_created / files_modified: default para [] se ausentes
+  if (parsed.files_created === undefined) parsed.files_created = [];
+  if (parsed.files_modified === undefined) parsed.files_modified = [];
+
   // files_created
   const filesCreatedError = validateStringArray(parsed.files_created, "files_created");
   if (filesCreatedError) errors.push(filesCreatedError);
@@ -344,6 +355,17 @@ export function parseSubagentReturn(input: string): ParseResult {
     }
   }
 
+  // v9.1: protocol_version (opcional, warn on mismatch)
+  if (parsed.protocol_version !== undefined) {
+    if (typeof parsed.protocol_version !== "string") {
+      errors.push("Campo 'protocol_version' deve ser string");
+    } else if (parsed.protocol_version !== CURRENT_PROTOCOL_VERSION) {
+      console.warn(
+        `[protocol] Versao do protocolo: esperado ${CURRENT_PROTOCOL_VERSION}, recebido ${parsed.protocol_version}`
+      );
+    }
+  }
+
   // 5. Validacoes semanticas
 
   // Se blocked, deve ter blockers
@@ -370,6 +392,7 @@ export function parseSubagentReturn(input: string): ParseResult {
 
   // Cast para tipo correto
   const data: SubagentReturn = {
+    protocol_version: parsed.protocol_version as string | undefined,
     status: parsed.status as SubagentReturn["status"],
     summary: parsed.summary as string,
     files_created: parsed.files_created as string[],
@@ -406,6 +429,7 @@ export function formatValidationErrors(result: ParseResult): string {
   output += "\n" + "─".repeat(50) + "\n";
   output += "O retorno deve seguir o formato:\n\n";
   output += `{
+  "protocol_version": "9.1",
   "status": "completed | blocked | needs_decision",
   "summary": "Resumo do que foi feito (10-500 chars)",
   "files_created": ["path/to/file.ts"],

package/workflow.ts

@@ -22,12 +22,14 @@ import {
   discoverPatternRemove,
   discoverRefreshPatterns,
   discoverExportPatterns,
+  discoverIncremental,
 } from "./commands/discover";
 import { clearTasks, clearShow } from "./commands/clear";
 import { standardsList, standardsAdd, standardsEdit, standardsRemove, standardsExport } from "./commands/standards";
 import { productGuide, productImport, productSet, productGoalAdd, productFeatureAdd, productConfirm, productShow, productReset } from "./commands/product";
 import { researchStart, researchShow, researchFill, researchMapAgent, researchReset } from "./commands/research";
 import { patternsExtract, patternsAnalyze } from "./commands/patterns";
+import { syncAgents } from "./commands/sync";
 import {
   architectStart,
   architectShow,
@@ -43,6 +45,7 @@ import { execSync } from "child_process";
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 import pkg from "./package.json";
+import { CodexaError, ValidationError } from "./errors";
 
 function checkVersionSync(): void {
   // 1. Check CLI vs Plugin (dev repo only)
@@ -52,10 +55,11 @@ function checkVersionSync(): void {
     if (existsSync(pluginJson)) {
       const plugin = JSON.parse(readFileSync(pluginJson, "utf-8"));
       if (plugin.version && plugin.version !== pkg.version) {
-        console.error(`\n✘ Versao incompativel: CLI=${pkg.version} Plugin=${plugin.version}`);
-        console.error(`  O CLI e o plugin DEVEM ter a mesma versao.`);
-        console.error(`  Atualize o CLI: bun add -g @codexa/cli@${plugin.version}\n`);
-        process.exit(1);
+        throw new CodexaError(
+          `✘ Versao incompativel: CLI=${pkg.version} Plugin=${plugin.version}\n` +
+          `  O CLI e o plugin DEVEM ter a mesma versao.\n` +
+          `  Atualize o CLI: bun add -g @codexa/cli@${plugin.version}`
+        );
       }
     }
   } catch {
@@ -83,25 +87,59 @@ function checkVersionSync(): void {
     }
 
     if (project.cli_version !== pkg.version) {
-      console.error(`\n✘ Versao incompativel: CLI=${pkg.version} Projeto=${project.cli_version}`);
-      console.error(`  O projeto foi configurado com CLI v${project.cli_version} mas voce esta usando v${pkg.version}.`);
-      console.error(`  Opcoes:`);
-      console.error(`    1. Atualize o CLI: bun add -g @codexa/cli@${project.cli_version}`);
-      console.error(`    2. Reconfigure o projeto: codexa discover reset && codexa discover start\n`);
-      process.exit(1);
+      throw new CodexaError(
+        `✘ Versao incompativel: CLI=${pkg.version} Projeto=${project.cli_version}\n` +
+        `  O projeto foi configurado com CLI v${project.cli_version} mas voce esta usando v${pkg.version}.\n` +
+        `  Opcoes:\n` +
+        `    1. Atualize o CLI: bun add -g @codexa/cli@${project.cli_version}\n` +
+        `    2. Reconfigure o projeto: codexa discover reset && codexa discover start`
+      );
     }
   } catch {
     // DB not available or column doesn't exist yet — skip
   }
 }
 
+function handleError(e: unknown): never {
+  if (e instanceof CodexaError) {
+    console.error(`\n${e.message}\n`);
+    process.exit(e.exitCode);
+  }
+  console.error(`\n[ERRO INESPERADO] ${(e as Error).message}\n`);
+  process.exit(1);
+}
+
+function wrapAction<T extends (...args: any[]) => any>(fn: T): T {
+  return ((...args: any[]) => {
+    try {
+      const result = fn(...args);
+      if (result instanceof Promise) {
+        return result.catch(handleError);
+      }
+      return result;
+    } catch (e) {
+      handleError(e);
+    }
+  }) as T;
+}
+
 const program = new Command();
 
 program
   .name("codexa")
   .description(`Codexa Workflow v${pkg.version} - Sistema de workflow para Claude Code`)
   .version(pkg.version)
-  .hook("preAction", () => checkVersionSync());
+  .hook("preAction", () => {
+    try {
+      checkVersionSync();
+    } catch (e) {
+      if (e instanceof CodexaError) {
+        console.error(`\n${e.message}\n`);
+        process.exit(e.exitCode);
+      }
+      throw e;
+    }
+  });
 
 // ═══════════════════════════════════════════════════════════════
 // FASE: PLAN
@@ -182,33 +220,56 @@ taskCmd
   .command("next")
   .description("Mostra proximas tasks disponiveis")
   .option("--json", "Saida em JSON")
-  .action((options) => {
+  .action(wrapAction((options) => {
     taskNext(options.json);
-  });
+  }));
 
 taskCmd
   .command("start <ids>")
   .description("Inicia task(s) - pode ser multiplas separadas por virgula")
   .option("--json", "Saida em JSON")
   .option("--full-context", "Incluir contexto completo (modo legado)")
-  .action((ids: string, options) => {
+  .action(wrapAction((ids: string, options) => {
     taskStart(ids, options.json, options.fullContext);
-  });
+  }));
 
 taskCmd
   .command("done <id>")
   .description("Completa uma task")
   .option("--checkpoint <text>", "Resumo do que foi feito (extraido automaticamente de --output)")
   .option("--output <json>", "Retorno JSON do subagent (processa automaticamente)")
+  .option("--output-file <path>", "Ler retorno JSON de arquivo (evita problemas de shell escaping)")
   .option("--files <files>", "Arquivos criados/modificados (extraido automaticamente de --output)")
   .option("--force", "Ignorar validacao de standards (sera registrado)")
   .option("--force-reason <reason>", "Motivo do bypass de validacao")
-  .action((id: string, options) => {
+  .action(wrapAction((id: string, options) => {
+    // Resolver --output-file: ler conteudo do arquivo
+    if (options.outputFile && !options.output) {
+      try {
+        options.output = readFileSync(options.outputFile, "utf-8");
+      } catch (e) {
+        throw new ValidationError(
+          `[ERRO] Nao foi possivel ler arquivo: ${options.outputFile}\n  ${(e as Error).message}`
+        );
+      }
+    }
+
+    // Resolver stdin: --output - (le de stdin)
+    if (options.output === "-") {
+      try {
+        options.output = readFileSync("/dev/stdin", "utf-8");
+      } catch (e) {
+        throw new ValidationError(
+          `[ERRO] Nao foi possivel ler de stdin.\n  ${(e as Error).message}`
+        );
+      }
+    }
+
     // Checkpoint obrigatorio se nao houver --output
     if (!options.output && !options.checkpoint) {
-      console.error("\n[ERRO] Checkpoint obrigatorio.");
-      console.error("Use: --checkpoint 'resumo' ou --output '{json do subagent}'\n");
-      process.exit(1);
+      throw new ValidationError(
+        "[ERRO] Checkpoint obrigatorio.\nUse: --checkpoint 'resumo' ou --output '{json do subagent}'"
+      );
     }
 
     taskDone(id, {
@@ -218,7 +279,7 @@ taskCmd
       forceReason: options.forceReason,
       output: options.output,
     });
-  });
+  }));
 
 // ═══════════════════════════════════════════════════════════════
 // DECISOES
@@ -294,7 +355,6 @@ knowledgeCmd
   .description("Consulta o knowledge graph (relacoes entre arquivos, decisoes, patterns)")
   .option("--file <path>", "Buscar relacoes de um arquivo")
   .option("--decision <id>", "Buscar arquivos afetados por uma decisao")
-  .option("--contradictions", "Detectar contradicoes entre decisoes")
   .option("--json", "Saida em JSON")
   .action((options) => {
     queryGraph(options);
@@ -454,6 +514,13 @@ discoverCmd
     await discoverRefresh(options);
   });
 
+discoverCmd
+  .command("incremental")
+  .description("Atualiza discover incrementalmente (arquivos modificados desde ultimo discover)")
+  .action(async () => {
+    await discoverIncremental();
+  });
+
 // ─────────────────────────────────────────────────────────────────
 // PATTERNS (v7.4)
 // ─────────────────────────────────────────────────────────────────
@@ -872,5 +939,19 @@ architectCmd
     architectCancel(options);
   });
 
+// ═══════════════════════════════════════════════════════════════
+// PLUGIN
+// ═══════════════════════════════════════════════════════════════
+
+const pluginCmd = program.command("plugin").description("Comandos de gestao do plugin");
+
+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);
+  });
+
 // Parse e executa
 program.parse();