@codexa/cli 8.6.15 → 9.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexa/cli",
-  "version": "8.6.15",
+  "version": "9.0.2",
   "description": "Orchestrated workflow system for Claude Code - manages feature development through parallel subagents with structured phases, gates, and quality enforcement.",
   "type": "module",
   "bin": {

package/protocol/subagent-protocol.ts

@@ -18,12 +18,12 @@ export interface Knowledge {
   severity: "info" | "warning" | "critical";
 }
 
-// v8.0: Raciocínio do subagent
+// v9.0: Raciocinio do subagent (approach OBRIGATORIO para status "completed")
 export interface Reasoning {
-  approach: string;           // Como abordou o problema
+  approach: string;           // OBRIGATORIO: Como abordou o problema (min 20 chars)
   challenges?: string[];      // Desafios encontrados
   alternatives?: string[];    // Alternativas consideradas
-  recommendations?: string;   // Recomendações para próximas tasks
+  recommendations?: string;   // Recomendacoes para proximas tasks
 }
 
 export interface SubagentReturn {
@@ -222,6 +222,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 +240,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);
@@ -282,7 +288,7 @@ export function parseSubagentReturn(input: string): ParseResult {
     }
   }
 
-  // v8.0: reasoning (opcional, mas validar estrutura se presente)
+  // v9.0: reasoning (validar estrutura se presente)
   if (parsed.reasoning !== undefined) {
     if (typeof parsed.reasoning !== "object" || parsed.reasoning === null) {
       errors.push("Campo 'reasoning' deve ser um objeto");
@@ -305,6 +311,24 @@ export function parseSubagentReturn(input: string): ParseResult {
     }
   }
 
+  // v9.0: Validacao de reasoning obrigatorio para status "completed" (Gate 4.4)
+  if (parsed.status === "completed") {
+    if (!parsed.reasoning || typeof parsed.reasoning !== "object") {
+      errors.push(
+        "Status 'completed' requer campo 'reasoning' com pelo menos 'approach'. " +
+        "Isso preserva contexto entre tasks. Exemplo: {\"reasoning\": {\"approach\": \"Descreva como abordou o problema\"}}"
+      );
+    } else {
+      const r = parsed.reasoning as Record<string, unknown>;
+      if (!r.approach || typeof r.approach !== "string" || (r.approach as string).length < 20) {
+        errors.push(
+          "Campo 'reasoning.approach' obrigatorio com minimo 20 caracteres para status 'completed'. " +
+          "Descreva COMO voce abordou o problema, nao apenas O QUE fez."
+        );
+      }
+    }
+  }
+
   // v8.5: utilities_created (opcional, validar estrutura se presente)
   if (parsed.utilities_created !== undefined) {
     if (!Array.isArray(parsed.utilities_created)) {
@@ -392,6 +416,9 @@ export function formatValidationErrors(result: ParseResult): string {
   "summary": "Resumo do que foi feito (10-500 chars)",
   "files_created": ["path/to/file.ts"],
   "files_modified": ["path/to/other.ts"],
+  "reasoning": {
+    "approach": "OBRIGATORIO (min 20 chars): Como abordou o problema e POR QUE tomou essas decisoes"
+  },
   "patterns_discovered": ["Pattern identificado"],
   "decisions_made": [{"title": "...", "decision": "..."}],
   "blockers": ["Bloqueio se status != completed"],

package/workflow.ts

@@ -6,8 +6,8 @@ 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 } from "./commands/knowledge";
-import { status, contextExport, recover, contextUpdate } from "./commands/utils";
+import { addKnowledge, listKnowledge, acknowledgeKnowledge, queryGraph, resolveKnowledge } from "./commands/knowledge";
+import { status, contextExport, recover, contextUpdate, contextDetail } from "./commands/utils";
 import {
   discoverStart,
   discoverConfirm,
@@ -190,8 +190,9 @@ 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) => {
-    taskStart(ids, options.json);
+    taskStart(ids, options.json, options.fullContext);
   });
 
 taskCmd
@@ -199,10 +200,33 @@ taskCmd
   .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) => {
+    // Resolver --output-file: ler conteudo do arquivo
+    if (options.outputFile && !options.output) {
+      try {
+        options.output = readFileSync(options.outputFile, "utf-8");
+      } catch (e) {
+        console.error(`\n[ERRO] Nao foi possivel ler arquivo: ${options.outputFile}`);
+        console.error(`  ${(e as Error).message}\n`);
+        process.exit(1);
+      }
+    }
+
+    // Resolver stdin: --output - (le de stdin)
+    if (options.output === "-") {
+      try {
+        options.output = readFileSync("/dev/stdin", "utf-8");
+      } catch (e) {
+        console.error("\n[ERRO] Nao foi possivel ler de stdin.");
+        console.error(`  ${(e as Error).message}\n`);
+        process.exit(1);
+      }
+    }
+
     // Checkpoint obrigatorio se nao houver --output
     if (!options.output && !options.checkpoint) {
       console.error("\n[ERRO] Checkpoint obrigatorio.");
@@ -280,6 +304,14 @@ knowledgeCmd
     acknowledgeKnowledge(id);
   });
 
+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);
+  });
+
 knowledgeCmd
   .command("graph")
   .description("Consulta o knowledge graph (relacoes entre arquivos, decisoes, patterns)")
@@ -351,6 +383,14 @@ contextCmd
     contextUpdate(options);
   });
 
+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);
+  });
+
 // Manter compatibilidade: context sem subcomando = export
 program
   .command("ctx")
@@ -541,6 +581,25 @@ discoverCmd
     patternsAnalyze(path, options.json);
   });
 
+// v9.0: Analise profunda com metadata enriquecida + grepai
+discoverCmd
+  .command("analyze-deep <files...>")
+  .description("Analise profunda de arquivos (hooks, patterns, directives)")
+  .option("--json", "Saida em JSON")
+  .action((files, options) => {
+    const { patternsAnalyzeDeep } = require("./commands/patterns");
+    patternsAnalyzeDeep(files, options.json);
+  });
+
+// v9.0: Anti-patterns de gate bypasses
+discoverCmd
+  .command("extract-anti-patterns")
+  .description("Extrai anti-patterns do historico de gate bypasses")
+  .action(() => {
+    const { extractAntiPatternsFromHistory } = require("./commands/patterns");
+    extractAntiPatternsFromHistory();
+  });
+
 discoverCmd
   .command("export-patterns")
   .description("Regenera arquivo patterns.md")