@codexa/cli 8.6.15 → 9.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexa/cli",
-  "version": "8.6.15",
+  "version": "9.0.1",
   "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 {
@@ -282,7 +282,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 +305,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 +410,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
@@ -280,6 +281,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 +360,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 +558,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")