@codexa/cli 9.0.21 → 9.0.23

package/commands/decide.ts

@@ -107,10 +107,20 @@ export function detectConflicts(
 
     // Verificar sobreposicao alta de keywords (mesmo topico, decisoes diferentes?)
     if (conflicts.every((c) => c.id !== existing.id)) {
+      // v10.1: Skip exact duplicates (same title+decision = not a conflict)
+      if (
+        newTitle.trim().toLowerCase() === existing.title?.trim().toLowerCase() &&
+        newDecision.trim().toLowerCase() === existing.decision?.trim().toLowerCase()
+      ) {
+        continue;
+      }
+
       const intersection = [...newKeywords].filter((k) => existingKeywords.has(k));
       const similarity = intersection.length / Math.max(newKeywords.size, existingKeywords.size);
 
-      if (similarity > 0.4 && intersection.length >= 3) {
+      // v10.1: Raised threshold from 0.4 to 0.7 to reduce false positives
+      // Complementary decisions (e.g. "Use REST" + "Use JWT") were falsely flagged
+      if (similarity > 0.7 && intersection.length >= 3) {
         conflicts.push({
           id: existing.id,
           title: existing.title,

package/commands/review.ts

@@ -4,6 +4,7 @@ import { enforceGate } from "../gates/validator";
 import { resolveSpec } from "./spec-resolver";
 import { CodexaError, GateError } from "../errors";
 import { cleanupContextFiles } from "../context/file-writer";
+import { simplifyAudit } from "./simplify";
 
 // ═══════════════════════════════════════════════════════════════
 // P1-2: Review Score — Threshold Automatico
@@ -264,6 +265,17 @@ export function reviewStart(json: boolean = false, specId?: string): void {
     console.log(`\nNenhum desvio encontrado.`);
   }
 
+  // v10.1: Simplify audit
+  try {
+    const simplifyContextPath = simplifyAudit(spec.id);
+    if (simplifyContextPath) {
+      console.log(`\nAuditoria de Simplificacao:`);
+      console.log(`  Prompt gerado com standards do projeto`);
+      console.log(`  Contexto: ${simplifyContextPath}`);
+      console.log(`  Invoque o simplifier agent em modo audit para analise de qualidade`);
+    }
+  } catch { /* nao-critico */ }
+
   if (score.total < 50) {
     console.log(`\n[!] Score abaixo de 50. Aprovacao requer: review approve --force --force-reason "motivo"`);
   } else {

package/commands/simplify.ts

@@ -0,0 +1,142 @@
+// ═══════════════════════════════════════════════════════════════
+// SIMPLIFY COMMAND (v10.1)
+// Generates simplification prompts enriched with Codexa standards.
+// Used post-task (Option A) and pre-review (Option C).
+// ═══════════════════════════════════════════════════════════════
+
+import { getDb } from "../db/connection";
+import { initSchema } from "../db/schema";
+import { resolveSpec } from "./spec-resolver";
+import { getAgentDomain, domainToScope } from "../context/domains";
+import { CodexaError } from "../errors";
+import {
+  buildSimplifyPrompt,
+  writeSimplifyContext,
+  type SimplifyFile,
+  type SimplifyMode,
+} from "../simplify/prompt-builder";
+
+// ═══════════════════════════════════════════════════════════════
+// SIMPLIFY FOR TASK (Option A)
+// ═══════════════════════════════════════════════════════════════
+
+export function simplifyTask(
+  taskId: string,
+  options: { audit?: boolean; specId?: string } = {}
+): void {
+  initSchema();
+
+  const db = getDb();
+  const id = parseInt(taskId);
+  const task = db.query("SELECT * FROM tasks WHERE id = ?").get(id) as any;
+
+  if (!task) {
+    throw new CodexaError(`Task #${id} nao encontrada.`);
+  }
+
+  if (task.status !== "done") {
+    throw new CodexaError(
+      `Task #${id} nao esta concluida (status: ${task.status}). Complete com 'task done' primeiro.`
+    );
+  }
+
+  // Get files from artifacts
+  const artifacts = db
+    .query(
+      "SELECT path, action FROM artifacts WHERE spec_id = ? AND task_ref = ?"
+    )
+    .all(task.spec_id, task.number) as any[];
+
+  if (artifacts.length === 0) {
+    console.log(`\nTask #${task.number} nao tem arquivos registrados. Nada para simplificar.\n`);
+    return;
+  }
+
+  const files: SimplifyFile[] = artifacts.map((a: any) => ({
+    path: a.path,
+    action: a.action === "created" ? "created" as const : "modified" as const,
+  }));
+
+  // Determine agent domain for scope filtering
+  const domain = getAgentDomain(task.agent);
+  const scope = domainToScope(domain);
+  const mode: SimplifyMode = options.audit ? "audit" : "refactor";
+
+  // Build prompt with standards
+  const prompt = buildSimplifyPrompt(files, scope, mode);
+
+  // Write context file
+  const contextPath = writeSimplifyContext(`task-${task.number}`, prompt);
+
+  // Output
+  const modeLabel = mode === "audit" ? "AUDITORIA" : "REFATORACAO";
+  console.log(`\n${"=".repeat(55)}`);
+  console.log(`SIMPLIFY (${modeLabel}) — Task #${task.number}`);
+  console.log(`${"=".repeat(55)}`);
+  console.log(`  Arquivos: ${files.length}`);
+  console.log(`  Scope: ${scope}`);
+  console.log(`  Modo: ${mode}`);
+  console.log(`  Contexto: ${contextPath}`);
+  console.log(`\n  O orchestrador deve invocar o simplifier agent com o prompt acima.`);
+  console.log(`  Leia o contexto com: Read ${contextPath}`);
+  console.log(`${"=".repeat(55)}\n`);
+}
+
+// ═══════════════════════════════════════════════════════════════
+// SIMPLIFY AUDIT FOR REVIEW (Option C)
+// ═══════════════════════════════════════════════════════════════
+
+export function simplifyAudit(specId?: string): string | null {
+  initSchema();
+
+  const db = getDb();
+  const spec = resolveSpec(specId, ["implementing", "reviewing"]);
+
+  // Get all feature artifacts
+  const artifacts = db
+    .query("SELECT DISTINCT path, action FROM artifacts WHERE spec_id = ?")
+    .all(spec.id) as any[];
+
+  if (artifacts.length === 0) {
+    return null;
+  }
+
+  const files: SimplifyFile[] = artifacts.map((a: any) => ({
+    path: a.path,
+    action: a.action === "created" ? "created" as const : "modified" as const,
+  }));
+
+  // Use "all" scope for review (covers all domains)
+  const prompt = buildSimplifyPrompt(files, "all", "audit");
+
+  // Write context file
+  const contextPath = writeSimplifyContext(`audit-${spec.id}`, prompt);
+
+  return contextPath;
+}
+
+// ═══════════════════════════════════════════════════════════════
+// AUTO-SIMPLIFY CHECK
+// ═══════════════════════════════════════════════════════════════
+
+export function isAutoSimplifyEnabled(): boolean {
+  try {
+    const db = getDb();
+    const project = db
+      .query("SELECT auto_simplify FROM project WHERE id = 'default'")
+      .get() as any;
+    return project?.auto_simplify === 1;
+  } catch {
+    return false;
+  }
+}
+
+export function setAutoSimplify(enabled: boolean): void {
+  initSchema();
+  const db = getDb();
+  db.run(
+    "UPDATE project SET auto_simplify = ?, updated_at = ? WHERE id = 'default'",
+    [enabled ? 1 : 0, new Date().toISOString()]
+  );
+  console.log(`\nauto_simplify ${enabled ? "habilitado" : "desabilitado"}.\n`);
+}

package/commands/task.ts

@@ -16,6 +16,8 @@ import { getModelForTask } from "../context/model-profiles";
 import { getContextBudget, formatContextWarning, estimateTokens } from "../context/monitor";
 import { invalidateCache } from "../context/cache";
 import { cleanupContextFiles } from "../context/file-writer";
+import { isAutoSimplifyEnabled } from "./simplify";
+import { buildSimplifyPrompt, writeSimplifyContext, type SimplifyFile } from "../simplify/prompt-builder";
 
 export function taskNext(json: boolean = false, specId?: string): void {
   initSchema();
@@ -369,7 +371,7 @@ export function taskStart(ids: string, json: boolean = false, minimalContext: bo
   console.log(`\nAo concluir, use: task done <id> --checkpoint "resumo"\n`);
 }
 
-export function taskDone(id: string, options: { checkpoint: string; files?: string; force?: boolean; forceReason?: string; output?: string }): void {
+export function taskDone(id: string, options: { checkpoint: string; files?: string; force?: boolean; forceReason?: string; output?: string; simplify?: boolean }): void {
   initSchema();
 
   const taskId = parseInt(id);
@@ -505,6 +507,26 @@ export function taskDone(id: string, options: { checkpoint: string; files?: stri
 
   // Nota: Validacao de standards agora e feita pelo Gate 4.2 (standards-follow) em enforceGate
 
+  // v10.1: Simplify pos-task (opt-in)
+  try {
+    const shouldSimplify = options.simplify || isAutoSimplifyEnabled();
+    if (shouldSimplify && expectedFiles.length > 0) {
+      const domain = getAgentDomain(task.agent);
+      const scope = domainToScope(domain);
+      const simplifyFiles: SimplifyFile[] = expectedFiles.map((f: string) => ({
+        path: f,
+        action: (subagentData?.files_created?.includes(f) ? "created" : "modified") as "created" | "modified",
+      }));
+
+      const prompt = buildSimplifyPrompt(simplifyFiles, scope, "refactor");
+      const contextPath = writeSimplifyContext(`task-${task.number}`, prompt);
+
+      console.log(`\n[simplify] Prompt gerado com ${simplifyFiles.length} arquivo(s) e standards do projeto`);
+      console.log(`[simplify] Contexto: ${contextPath}`);
+      console.log(`[simplify] Invoque o simplifier agent com o prompt acima`);
+    }
+  } catch { /* nao-critico: nao falhar task done por simplify */ }
+
   // v9.0: Atualizar patterns incrementalmente com arquivos da task
   try {
     if (subagentData && subagentData.status === "completed") {

package/db/schema.ts

@@ -496,6 +496,13 @@ const MIGRATIONS: Migration[] = [
       db.exec(`ALTER TABLE context ADD COLUMN current_phase INTEGER DEFAULT 1`);
     },
   },
+  {
+    version: "10.1.0",
+    description: "Adicionar auto_simplify na tabela project para simplificacao automatica pos-task",
+    up: (db) => {
+      db.exec(`ALTER TABLE project ADD COLUMN auto_simplify INTEGER DEFAULT 0`);
+    },
+  },
 ];
 
 export function runMigrations(): void {

package/gates/validator.ts

@@ -493,9 +493,17 @@ function executeCheck(check: string, context: any): { passed: boolean; details?:
         .all(dcTask.spec_id) as any[];
       if (existingDecisions.length === 0) return { passed: true };
 
+      // v10.1: Filter out decisions from the CURRENT task.
+      // processSubagentReturn() already saved them to DB before this gate runs,
+      // so without filtering, the new decisions would match against themselves.
+      const priorDecisions = existingDecisions.filter(
+        (d: any) => d.task_ref !== dcTask.number
+      );
+      if (priorDecisions.length === 0) return { passed: true };
+
       const allConflicts: string[] = [];
       for (const dec of context.subagentData.decisions_made) {
-        const analysis = detectConflicts(dec.title, dec.decision, existingDecisions);
+        const analysis = detectConflicts(dec.title, dec.decision, priorDecisions);
         if (analysis.hasConflict) {
           for (const conflict of analysis.conflictingDecisions) {
             allConflicts.push(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexa/cli",
-  "version": "9.0.21",
+  "version": "9.0.23",
   "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

@@ -316,20 +316,35 @@ export function parseSubagentReturn(input: string): ParseResult {
     }
   }
 
-  // v9.0: Validacao de reasoning obrigatorio para status "completed" (Gate 4.4)
+  // v9.0: Validacao de reasoning para status "completed" (Gate 4.4)
+  // v10.1: Auto-derive reasoning from summary when missing (graceful degradation)
   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\"}}"
-      );
+      // Auto-derive reasoning from summary instead of hard-failing
+      const summary = typeof parsed.summary === "string" ? parsed.summary : "";
+      if (summary.length >= 20) {
+        parsed.reasoning = { approach: summary };
+        console.warn("[protocol] reasoning ausente — auto-derivado do summary");
+      } else {
+        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."
-        );
+        // Auto-derive approach from summary if approach is too short
+        const summary = typeof parsed.summary === "string" ? parsed.summary : "";
+        if (summary.length >= 20) {
+          (parsed.reasoning as Record<string, unknown>).approach = summary;
+          console.warn("[protocol] reasoning.approach insuficiente — auto-derivado do summary");
+        } else {
+          errors.push(
+            "Campo 'reasoning.approach' obrigatorio com minimo 20 caracteres para status 'completed'. " +
+            "Descreva COMO voce abordou o problema, nao apenas O QUE fez."
+          );
+        }
       }
     }
   }

package/workflow.ts

@@ -269,6 +269,7 @@ taskCmd
   .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")
+  .option("--simplify", "Gerar prompt de simplificacao com standards do projeto")
   .action(wrapAction((id: string, options) => {
     // Resolver --output-file: ler conteudo do arquivo
     if (options.outputFile && !options.output) {
@@ -305,6 +306,7 @@ taskCmd
       force: options.force,
       forceReason: options.forceReason,
       output: options.output,
+      simplify: options.simplify,
     });
   }));
 
@@ -318,6 +320,20 @@ taskCmd
     taskPhaseAdvance({ noCompact: options.compact === false, json: options.json, spec: options.spec });
   }));
 
+// ═══════════════════════════════════════════════════════════════
+// SIMPLIFY (v10.1)
+// ═══════════════════════════════════════════════════════════════
+
+program
+  .command("simplify <taskId>")
+  .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) => {
+    const { simplifyTask } = require("./commands/simplify");
+    simplifyTask(taskId, { audit: options.audit, specId: options.spec });
+  }));
+
 // ═══════════════════════════════════════════════════════════════
 // DECISOES
 // ═══════════════════════════════════════════════════════════════
@@ -610,6 +626,8 @@ discoverCmd
   .option("--testing <value>", "Testing (vitest, jest, playwright)")
   .option("--typecheck-command <cmd>", "Comando custom de typecheck (ex: 'mypy --strict', 'go vet ./...'). Vazio para usar preset automatico.")
   .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) => {
     // Tratar typecheck-command separadamente
     if (options.typecheckCommand !== undefined) {
@@ -648,10 +666,16 @@ discoverCmd
       // Auto-regenerate deep-explore agent with new workspace config
       ensureDeepExploreAgent();
     }
+    // Tratar auto-simplify
+    if (options.autoSimplify !== undefined) {
+      const { setAutoSimplify } = require("./commands/simplify");
+      setAutoSimplify(!!options.autoSimplify);
+    }
     // Tratar stack options normalmente
     const stackOptions = { ...options };
     delete stackOptions.typecheckCommand;
     delete stackOptions.grepaiWorkspace;
+    delete stackOptions.autoSimplify;
     if (Object.keys(stackOptions).length > 0) {
       discoverSetStack(stackOptions);
     }