@codexa/cli 8.5.0 → 8.6.0

package/protocol/process-return.ts

@@ -1,451 +1,451 @@
-/**
- * Process Subagent Return
- *
- * Este modulo processa automaticamente o retorno de um subagent,
- * extraindo e registrando:
- * - Knowledge broadcast
- * - Decisions
- * - Artifacts (files created/modified)
- * - Patterns descobertos
- */
-
-import { getDb } from "../db/connection";
-import { SubagentReturn, Knowledge } from "./subagent-protocol";
-import { addReasoning, addGraphRelation, getRelatedFiles, upsertUtility } from "../db/schema";
-import { extractUtilitiesFromFile, inferScopeFromPath } from "../commands/patterns";
-
-interface ProcessResult {
-  success: boolean;
-  knowledgeAdded: number;
-  decisionsAdded: number;
-  artifactsAdded: number;
-  patternsAdded: number;
-  reasoningAdded: number;  // v8.0
-  relationsAdded: number;  // v8.0
-  utilitiesRegistered: number;  // v8.5
-  errors: string[];
-}
-
-function getNextDecisionId(specId: string): string {
-  const db = getDb();
-  const last = db
-    .query("SELECT id FROM decisions WHERE spec_id = ? ORDER BY created_at DESC LIMIT 1")
-    .get(specId) as any;
-
-  if (!last) return "DEC-001";
-
-  const num = parseInt(last.id.replace("DEC-", "")) + 1;
-  return `DEC-${num.toString().padStart(3, "0")}`;
-}
-
-/**
- * Processa o retorno de um subagent e registra automaticamente
- * todos os dados extraidos no banco
- */
-export function processSubagentReturn(
-  specId: string,
-  taskId: number,
-  taskNumber: number,
-  data: SubagentReturn
-): ProcessResult {
-  const db = getDb();
-  const now = new Date().toISOString();
-  const result: ProcessResult = {
-    success: true,
-    knowledgeAdded: 0,
-    decisionsAdded: 0,
-    artifactsAdded: 0,
-    patternsAdded: 0,
-    reasoningAdded: 0,
-    relationsAdded: 0,
-    utilitiesRegistered: 0,
-    errors: [],
-  };
-
-  // 1. Registrar Knowledge Broadcast (v8.3: com deduplicacao)
-  if (data.knowledge_to_broadcast && data.knowledge_to_broadcast.length > 0) {
-    for (const k of data.knowledge_to_broadcast) {
-      try {
-        // v8.3: Deduplicacao - verificar se knowledge identico ja existe
-        const existing = db.query(
-          `SELECT id FROM knowledge WHERE spec_id = ? AND category = ? AND content = ? LIMIT 1`
-        ).get(specId, k.category, k.content) as any;
-
-        if (existing) continue; // Skip duplicata
-
-        db.run(
-          `INSERT INTO knowledge (spec_id, task_origin, category, content, severity, broadcast_to, created_at)
-           VALUES (?, ?, ?, ?, ?, 'all', ?)`,
-          [specId, taskId, k.category, k.content, k.severity, now]
-        );
-        result.knowledgeAdded++;
-      } catch (e) {
-        result.errors.push(`Erro ao registrar knowledge: ${(e as Error).message}`);
-      }
-    }
-  }
-
-  // 2. Registrar Decisions
-  if (data.decisions_made && data.decisions_made.length > 0) {
-    for (const dec of data.decisions_made) {
-      try {
-        const decisionId = getNextDecisionId(specId);
-        db.run(
-          `INSERT INTO decisions (id, spec_id, task_ref, title, decision, rationale, status, created_at)
-           VALUES (?, ?, ?, ?, ?, ?, 'active', ?)`,
-          [decisionId, specId, taskNumber, dec.title, dec.decision, dec.rationale || null, now]
-        );
-        result.decisionsAdded++;
-      } catch (e) {
-        result.errors.push(`Erro ao registrar decision: ${(e as Error).message}`);
-      }
-    }
-  }
-
-  // 2b. v8.3: Deteccao automatica de contradicoes entre decisoes
-  if (data.decisions_made && data.decisions_made.length > 0) {
-    try {
-      const existingDecisions = db.query(
-        "SELECT id, title, decision FROM decisions WHERE spec_id = ? AND status = 'active'"
-      ).all(specId) as any[];
-
-      const allTaskFiles = [...data.files_created, ...data.files_modified];
-
-      for (const newDec of data.decisions_made) {
-        for (const existingDec of existingDecisions) {
-          // Skip se mesma decisao (recem adicionada)
-          if (existingDec.title === newDec.title) continue;
-
-          const newDecLower = `${newDec.title} ${newDec.decision}`.toLowerCase();
-          const existDecLower = `${existingDec.title} ${existingDec.decision}`.toLowerCase();
-
-          // Verificar overlap de arquivos
-          const existingDecFiles = getRelatedFiles(existingDec.id, "decision");
-          const fileOverlap = allTaskFiles.some(f => existingDecFiles.includes(f));
-
-          if (fileOverlap) {
-            // Heuristica de keywords opostos
-            const opposites = [
-              ['usar', 'nao usar'], ['usar', 'evitar'],
-              ['use', 'avoid'], ['add', 'remove'],
-              ['incluir', 'excluir'], ['habilitar', 'desabilitar'],
-              ['enable', 'disable'], ['create', 'delete'],
-              ['client', 'server'], ['sync', 'async'],
-            ];
-
-            let isContradiction = false;
-            for (const [word1, word2] of opposites) {
-              if ((newDecLower.includes(word1) && existDecLower.includes(word2)) ||
-                  (newDecLower.includes(word2) && existDecLower.includes(word1))) {
-                isContradiction = true;
-                break;
-              }
-            }
-
-            if (isContradiction) {
-              const newDecId = db.query(
-                "SELECT id FROM decisions WHERE spec_id = ? AND title = ? ORDER BY created_at DESC LIMIT 1"
-              ).get(specId, newDec.title) as any;
-
-              if (newDecId) {
-                addGraphRelation(specId, {
-                  sourceType: "decision",
-                  sourceId: newDecId.id,
-                  targetType: "decision",
-                  targetId: existingDec.id,
-                  relation: "contradicts",
-                  strength: 0.7,
-                  metadata: { reason: "Arquivos sobrepostos com semantica oposta" },
-                });
-                result.relationsAdded++;
-              }
-            }
-          }
-        }
-      }
-    } catch (e) {
-      // Nao-critico: nao falhar processamento por deteccao de contradicoes
-      result.errors.push(`Aviso contradicoes: ${(e as Error).message}`);
-    }
-  }
-
-  // 3. Registrar Artifacts (files_created e files_modified)
-  const allFiles = [
-    ...data.files_created.map((f) => ({ path: f, action: "created" })),
-    ...data.files_modified.map((f) => ({ path: f, action: "modified" })),
-  ];
-
-  for (const file of allFiles) {
-    try {
-      db.run(
-        `INSERT OR REPLACE INTO artifacts (spec_id, task_ref, path, action, created_at)
-         VALUES (?, ?, ?, ?, ?)`,
-        [specId, taskNumber, file.path, file.action, now]
-      );
-      result.artifactsAdded++;
-    } catch (e) {
-      result.errors.push(`Erro ao registrar artifact: ${(e as Error).message}`);
-    }
-  }
-
-  // 4. Registrar Patterns descobertos no contexto
-  if (data.patterns_discovered && data.patterns_discovered.length > 0) {
-    try {
-      const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(specId) as any;
-      const currentPatterns = context?.patterns ? JSON.parse(context.patterns) : [];
-
-      for (const pattern of data.patterns_discovered) {
-        currentPatterns.push({
-          pattern,
-          detected_at: now,
-          source_task: taskNumber,
-        });
-        result.patternsAdded++;
-      }
-
-      db.run(
-        "UPDATE context SET patterns = ?, updated_at = ? WHERE spec_id = ?",
-        [JSON.stringify(currentPatterns), now, specId]
-      );
-    } catch (e) {
-      result.errors.push(`Erro ao registrar patterns: ${(e as Error).message}`);
-    }
-  }
-
-  // 4b. v8.3: Broadcast patterns como knowledge (com deduplicacao)
-  if (data.patterns_discovered && data.patterns_discovered.length > 0) {
-    for (const pattern of data.patterns_discovered) {
-      try {
-        const content = `Pattern descoberto: ${pattern}`;
-        const existing = db.query(
-          `SELECT id FROM knowledge WHERE spec_id = ? AND category = 'pattern' AND content = ? LIMIT 1`
-        ).get(specId, content) as any;
-
-        if (!existing) {
-          db.run(
-            `INSERT INTO knowledge (spec_id, task_origin, category, content, severity, broadcast_to, created_at)
-             VALUES (?, ?, 'pattern', ?, 'info', 'all', ?)`,
-            [specId, taskId, content, now]
-          );
-        }
-      } catch { /* ignore */ }
-    }
-  }
-
-  // 5. Se status for blocked ou needs_decision, registrar como knowledge critico
-  if (data.status === "blocked" && data.blockers) {
-    for (const blocker of data.blockers) {
-      try {
-        db.run(
-          `INSERT INTO knowledge (spec_id, task_origin, category, content, severity, broadcast_to, created_at)
-           VALUES (?, ?, 'blocker', ?, 'critical', 'all', ?)`,
-          [specId, taskId, blocker, now]
-        );
-        result.knowledgeAdded++;
-      } catch (e) {
-        result.errors.push(`Erro ao registrar blocker: ${(e as Error).message}`);
-      }
-    }
-  }
-
-  // 6. v8.0: Registrar Reasoning no reasoning_log
-  if (data.reasoning) {
-    try {
-      // Abordagem principal
-      if (data.reasoning.approach) {
-        addReasoning(specId, taskId, {
-          category: "decision",
-          thought: `Abordagem: ${data.reasoning.approach}`,
-          relatedFiles: [...data.files_created, ...data.files_modified],
-          importance: "normal",
-        });
-        result.reasoningAdded++;
-      }
-
-      // Desafios encontrados
-      if (data.reasoning.challenges && data.reasoning.challenges.length > 0) {
-        for (const challenge of data.reasoning.challenges) {
-          addReasoning(specId, taskId, {
-            category: "challenge",
-            thought: challenge,
-            relatedFiles: [...data.files_created, ...data.files_modified],
-            importance: "high",
-          });
-          result.reasoningAdded++;
-        }
-      }
-
-      // Alternativas consideradas
-      if (data.reasoning.alternatives && data.reasoning.alternatives.length > 0) {
-        for (const alt of data.reasoning.alternatives) {
-          addReasoning(specId, taskId, {
-            category: "decision",
-            thought: `Alternativa considerada: ${alt}`,
-            relatedFiles: [...data.files_created, ...data.files_modified],
-            importance: "normal",
-          });
-          result.reasoningAdded++;
-        }
-      }
-
-      // Recomendações para próximas tasks
-      if (data.reasoning.recommendations) {
-        addReasoning(specId, taskId, {
-          category: "recommendation",
-          thought: data.reasoning.recommendations,
-          relatedFiles: [...data.files_created, ...data.files_modified],
-          importance: "high",
-        });
-        result.reasoningAdded++;
-      }
-    } catch (e) {
-      result.errors.push(`Erro ao registrar reasoning: ${(e as Error).message}`);
-    }
-  }
-
-  // 7. v8.0: Criar relações no knowledge graph
-  try {
-    // Relação: task -> arquivos criados
-    for (const file of data.files_created) {
-      addGraphRelation(specId, {
-        sourceType: "task",
-        sourceId: String(taskId),
-        targetType: "file",
-        targetId: file,
-        relation: "creates",
-        strength: 1.0,
-      });
-      result.relationsAdded++;
-    }
-
-    // Relação: task -> arquivos modificados
-    for (const file of data.files_modified) {
-      addGraphRelation(specId, {
-        sourceType: "task",
-        sourceId: String(taskId),
-        targetType: "file",
-        targetId: file,
-        relation: "modifies",
-        strength: 1.0,
-      });
-      result.relationsAdded++;
-    }
-
-    // Relação: decision -> arquivos (se houver decisions)
-    if (data.decisions_made) {
-      for (const dec of data.decisions_made) {
-        const decisionId = getNextDecisionId(specId);
-        for (const file of [...data.files_created, ...data.files_modified]) {
-          addGraphRelation(specId, {
-            sourceType: "decision",
-            sourceId: decisionId,
-            targetType: "file",
-            targetId: file,
-            relation: "implements",
-            strength: 0.8,
-          });
-          result.relationsAdded++;
-        }
-      }
-    }
-
-    // Relação: pattern -> arquivos (se patterns descobertos)
-    if (data.patterns_discovered) {
-      for (const pattern of data.patterns_discovered) {
-        for (const file of data.files_created) {
-          addGraphRelation(specId, {
-            sourceType: "pattern",
-            sourceId: pattern,
-            targetType: "file",
-            targetId: file,
-            relation: "extracted_from",
-            strength: 0.9,
-          });
-          result.relationsAdded++;
-        }
-      }
-    }
-  } catch (e) {
-    result.errors.push(`Erro ao criar relações: ${(e as Error).message}`);
-  }
-
-  // 8. v8.5: Registrar utilities de arquivos criados/modificados (DRY map)
-  try {
-    // 8a. Usar utilities declaradas pelo subagent (metadata mais rica)
-    if (data.utilities_created && data.utilities_created.length > 0) {
-      for (const util of data.utilities_created) {
-        upsertUtility({
-          filePath: util.file,
-          utilityName: util.name,
-          utilityType: util.type || "function",
-          scope: inferScopeFromPath(util.file),
-          signature: util.signature,
-          description: util.description,
-        }, specId, taskNumber);
-        result.utilitiesRegistered++;
-      }
-    }
-
-    // 8b. Fallback: escanear exports de arquivos criados/modificados
-    for (const file of allFiles.map(f => f.path)) {
-      const utilities = extractUtilitiesFromFile(file);
-      const scope = inferScopeFromPath(file);
-      for (const util of utilities) {
-        upsertUtility({
-          filePath: file,
-          utilityName: util.name,
-          utilityType: util.type,
-          scope,
-          signature: util.signature,
-        }, specId, taskNumber);
-        result.utilitiesRegistered++;
-      }
-    }
-  } catch (e) {
-    // Nao-critico: nao falhar processamento por extracao de utilities
-    result.errors.push(`Aviso utilities: ${(e as Error).message}`);
-  }
-
-  result.success = result.errors.length === 0;
-  return result;
-}
-
-/**
- * Formata o resultado do processamento para exibicao
- */
-export function formatProcessResult(result: ProcessResult): string {
-  let output = "\n[i] Retorno do subagent processado automaticamente:\n";
-
-  if (result.knowledgeAdded > 0) {
-    output += `    + ${result.knowledgeAdded} knowledge(s) registrado(s) para broadcast\n`;
-  }
-  if (result.decisionsAdded > 0) {
-    output += `    + ${result.decisionsAdded} decisao(es) registrada(s)\n`;
-  }
-  if (result.artifactsAdded > 0) {
-    output += `    + ${result.artifactsAdded} artefato(s) registrado(s)\n`;
-  }
-  if (result.patternsAdded > 0) {
-    output += `    + ${result.patternsAdded} pattern(s) adicionado(s) ao contexto\n`;
-  }
-  // v8.0: Novas métricas
-  if (result.reasoningAdded > 0) {
-    output += `    + ${result.reasoningAdded} raciocinio(s) registrado(s) no historico\n`;
-  }
-  if (result.relationsAdded > 0) {
-    output += `    + ${result.relationsAdded} relacao(oes) criada(s) no grafo de conhecimento\n`;
-  }
-  // v8.5: Utilities registradas
-  if (result.utilitiesRegistered > 0) {
-    output += `    + ${result.utilitiesRegistered} utilidade(s) registrada(s) no mapa DRY\n`;
-  }
-
-  if (result.errors.length > 0) {
-    output += "\n[!] Erros durante processamento:\n";
-    for (const error of result.errors) {
-      output += `    - ${error}\n`;
-    }
-  }
-
-  return output;
+/**
+ * Process Subagent Return
+ *
+ * Este modulo processa automaticamente o retorno de um subagent,
+ * extraindo e registrando:
+ * - Knowledge broadcast
+ * - Decisions
+ * - Artifacts (files created/modified)
+ * - Patterns descobertos
+ */
+
+import { getDb } from "../db/connection";
+import { SubagentReturn, Knowledge } from "./subagent-protocol";
+import { addReasoning, addGraphRelation, getRelatedFiles, upsertUtility } from "../db/schema";
+import { extractUtilitiesFromFile, inferScopeFromPath } from "../commands/patterns";
+
+interface ProcessResult {
+  success: boolean;
+  knowledgeAdded: number;
+  decisionsAdded: number;
+  artifactsAdded: number;
+  patternsAdded: number;
+  reasoningAdded: number;  // v8.0
+  relationsAdded: number;  // v8.0
+  utilitiesRegistered: number;  // v8.5
+  errors: string[];
+}
+
+function getNextDecisionId(specId: string): string {
+  const db = getDb();
+  const last = db
+    .query("SELECT id FROM decisions WHERE spec_id = ? ORDER BY created_at DESC LIMIT 1")
+    .get(specId) as any;
+
+  if (!last) return "DEC-001";
+
+  const num = parseInt(last.id.replace("DEC-", "")) + 1;
+  return `DEC-${num.toString().padStart(3, "0")}`;
+}
+
+/**
+ * Processa o retorno de um subagent e registra automaticamente
+ * todos os dados extraidos no banco
+ */
+export function processSubagentReturn(
+  specId: string,
+  taskId: number,
+  taskNumber: number,
+  data: SubagentReturn
+): ProcessResult {
+  const db = getDb();
+  const now = new Date().toISOString();
+  const result: ProcessResult = {
+    success: true,
+    knowledgeAdded: 0,
+    decisionsAdded: 0,
+    artifactsAdded: 0,
+    patternsAdded: 0,
+    reasoningAdded: 0,
+    relationsAdded: 0,
+    utilitiesRegistered: 0,
+    errors: [],
+  };
+
+  // 1. Registrar Knowledge Broadcast (v8.3: com deduplicacao)
+  if (data.knowledge_to_broadcast && data.knowledge_to_broadcast.length > 0) {
+    for (const k of data.knowledge_to_broadcast) {
+      try {
+        // v8.3: Deduplicacao - verificar se knowledge identico ja existe
+        const existing = db.query(
+          `SELECT id FROM knowledge WHERE spec_id = ? AND category = ? AND content = ? LIMIT 1`
+        ).get(specId, k.category, k.content) as any;
+
+        if (existing) continue; // Skip duplicata
+
+        db.run(
+          `INSERT INTO knowledge (spec_id, task_origin, category, content, severity, broadcast_to, created_at)
+           VALUES (?, ?, ?, ?, ?, 'all', ?)`,
+          [specId, taskId, k.category, k.content, k.severity, now]
+        );
+        result.knowledgeAdded++;
+      } catch (e) {
+        result.errors.push(`Erro ao registrar knowledge: ${(e as Error).message}`);
+      }
+    }
+  }
+
+  // 2. Registrar Decisions
+  if (data.decisions_made && data.decisions_made.length > 0) {
+    for (const dec of data.decisions_made) {
+      try {
+        const decisionId = getNextDecisionId(specId);
+        db.run(
+          `INSERT INTO decisions (id, spec_id, task_ref, title, decision, rationale, status, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, 'active', ?)`,
+          [decisionId, specId, taskNumber, dec.title, dec.decision, dec.rationale || null, now]
+        );
+        result.decisionsAdded++;
+      } catch (e) {
+        result.errors.push(`Erro ao registrar decision: ${(e as Error).message}`);
+      }
+    }
+  }
+
+  // 2b. v8.3: Deteccao automatica de contradicoes entre decisoes
+  if (data.decisions_made && data.decisions_made.length > 0) {
+    try {
+      const existingDecisions = db.query(
+        "SELECT id, title, decision FROM decisions WHERE spec_id = ? AND status = 'active'"
+      ).all(specId) as any[];
+
+      const allTaskFiles = [...data.files_created, ...data.files_modified];
+
+      for (const newDec of data.decisions_made) {
+        for (const existingDec of existingDecisions) {
+          // Skip se mesma decisao (recem adicionada)
+          if (existingDec.title === newDec.title) continue;
+
+          const newDecLower = `${newDec.title} ${newDec.decision}`.toLowerCase();
+          const existDecLower = `${existingDec.title} ${existingDec.decision}`.toLowerCase();
+
+          // Verificar overlap de arquivos
+          const existingDecFiles = getRelatedFiles(existingDec.id, "decision");
+          const fileOverlap = allTaskFiles.some(f => existingDecFiles.includes(f));
+
+          if (fileOverlap) {
+            // Heuristica de keywords opostos
+            const opposites = [
+              ['usar', 'nao usar'], ['usar', 'evitar'],
+              ['use', 'avoid'], ['add', 'remove'],
+              ['incluir', 'excluir'], ['habilitar', 'desabilitar'],
+              ['enable', 'disable'], ['create', 'delete'],
+              ['client', 'server'], ['sync', 'async'],
+            ];
+
+            let isContradiction = false;
+            for (const [word1, word2] of opposites) {
+              if ((newDecLower.includes(word1) && existDecLower.includes(word2)) ||
+                  (newDecLower.includes(word2) && existDecLower.includes(word1))) {
+                isContradiction = true;
+                break;
+              }
+            }
+
+            if (isContradiction) {
+              const newDecId = db.query(
+                "SELECT id FROM decisions WHERE spec_id = ? AND title = ? ORDER BY created_at DESC LIMIT 1"
+              ).get(specId, newDec.title) as any;
+
+              if (newDecId) {
+                addGraphRelation(specId, {
+                  sourceType: "decision",
+                  sourceId: newDecId.id,
+                  targetType: "decision",
+                  targetId: existingDec.id,
+                  relation: "contradicts",
+                  strength: 0.7,
+                  metadata: { reason: "Arquivos sobrepostos com semantica oposta" },
+                });
+                result.relationsAdded++;
+              }
+            }
+          }
+        }
+      }
+    } catch (e) {
+      // Nao-critico: nao falhar processamento por deteccao de contradicoes
+      result.errors.push(`Aviso contradicoes: ${(e as Error).message}`);
+    }
+  }
+
+  // 3. Registrar Artifacts (files_created e files_modified)
+  const allFiles = [
+    ...data.files_created.map((f) => ({ path: f, action: "created" })),
+    ...data.files_modified.map((f) => ({ path: f, action: "modified" })),
+  ];
+
+  for (const file of allFiles) {
+    try {
+      db.run(
+        `INSERT OR REPLACE INTO artifacts (spec_id, task_ref, path, action, created_at)
+         VALUES (?, ?, ?, ?, ?)`,
+        [specId, taskNumber, file.path, file.action, now]
+      );
+      result.artifactsAdded++;
+    } catch (e) {
+      result.errors.push(`Erro ao registrar artifact: ${(e as Error).message}`);
+    }
+  }
+
+  // 4. Registrar Patterns descobertos no contexto
+  if (data.patterns_discovered && data.patterns_discovered.length > 0) {
+    try {
+      const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(specId) as any;
+      const currentPatterns = context?.patterns ? JSON.parse(context.patterns) : [];
+
+      for (const pattern of data.patterns_discovered) {
+        currentPatterns.push({
+          pattern,
+          detected_at: now,
+          source_task: taskNumber,
+        });
+        result.patternsAdded++;
+      }
+
+      db.run(
+        "UPDATE context SET patterns = ?, updated_at = ? WHERE spec_id = ?",
+        [JSON.stringify(currentPatterns), now, specId]
+      );
+    } catch (e) {
+      result.errors.push(`Erro ao registrar patterns: ${(e as Error).message}`);
+    }
+  }
+
+  // 4b. v8.3: Broadcast patterns como knowledge (com deduplicacao)
+  if (data.patterns_discovered && data.patterns_discovered.length > 0) {
+    for (const pattern of data.patterns_discovered) {
+      try {
+        const content = `Pattern descoberto: ${pattern}`;
+        const existing = db.query(
+          `SELECT id FROM knowledge WHERE spec_id = ? AND category = 'pattern' AND content = ? LIMIT 1`
+        ).get(specId, content) as any;
+
+        if (!existing) {
+          db.run(
+            `INSERT INTO knowledge (spec_id, task_origin, category, content, severity, broadcast_to, created_at)
+             VALUES (?, ?, 'pattern', ?, 'info', 'all', ?)`,
+            [specId, taskId, content, now]
+          );
+        }
+      } catch { /* ignore */ }
+    }
+  }
+
+  // 5. Se status for blocked ou needs_decision, registrar como knowledge critico
+  if (data.status === "blocked" && data.blockers) {
+    for (const blocker of data.blockers) {
+      try {
+        db.run(
+          `INSERT INTO knowledge (spec_id, task_origin, category, content, severity, broadcast_to, created_at)
+           VALUES (?, ?, 'blocker', ?, 'critical', 'all', ?)`,
+          [specId, taskId, blocker, now]
+        );
+        result.knowledgeAdded++;
+      } catch (e) {
+        result.errors.push(`Erro ao registrar blocker: ${(e as Error).message}`);
+      }
+    }
+  }
+
+  // 6. v8.0: Registrar Reasoning no reasoning_log
+  if (data.reasoning) {
+    try {
+      // Abordagem principal
+      if (data.reasoning.approach) {
+        addReasoning(specId, taskId, {
+          category: "decision",
+          thought: `Abordagem: ${data.reasoning.approach}`,
+          relatedFiles: [...data.files_created, ...data.files_modified],
+          importance: "normal",
+        });
+        result.reasoningAdded++;
+      }
+
+      // Desafios encontrados
+      if (data.reasoning.challenges && data.reasoning.challenges.length > 0) {
+        for (const challenge of data.reasoning.challenges) {
+          addReasoning(specId, taskId, {
+            category: "challenge",
+            thought: challenge,
+            relatedFiles: [...data.files_created, ...data.files_modified],
+            importance: "high",
+          });
+          result.reasoningAdded++;
+        }
+      }
+
+      // Alternativas consideradas
+      if (data.reasoning.alternatives && data.reasoning.alternatives.length > 0) {
+        for (const alt of data.reasoning.alternatives) {
+          addReasoning(specId, taskId, {
+            category: "decision",
+            thought: `Alternativa considerada: ${alt}`,
+            relatedFiles: [...data.files_created, ...data.files_modified],
+            importance: "normal",
+          });
+          result.reasoningAdded++;
+        }
+      }
+
+      // Recomendações para próximas tasks
+      if (data.reasoning.recommendations) {
+        addReasoning(specId, taskId, {
+          category: "recommendation",
+          thought: data.reasoning.recommendations,
+          relatedFiles: [...data.files_created, ...data.files_modified],
+          importance: "high",
+        });
+        result.reasoningAdded++;
+      }
+    } catch (e) {
+      result.errors.push(`Erro ao registrar reasoning: ${(e as Error).message}`);
+    }
+  }
+
+  // 7. v8.0: Criar relações no knowledge graph
+  try {
+    // Relação: task -> arquivos criados
+    for (const file of data.files_created) {
+      addGraphRelation(specId, {
+        sourceType: "task",
+        sourceId: String(taskId),
+        targetType: "file",
+        targetId: file,
+        relation: "creates",
+        strength: 1.0,
+      });
+      result.relationsAdded++;
+    }
+
+    // Relação: task -> arquivos modificados
+    for (const file of data.files_modified) {
+      addGraphRelation(specId, {
+        sourceType: "task",
+        sourceId: String(taskId),
+        targetType: "file",
+        targetId: file,
+        relation: "modifies",
+        strength: 1.0,
+      });
+      result.relationsAdded++;
+    }
+
+    // Relação: decision -> arquivos (se houver decisions)
+    if (data.decisions_made) {
+      for (const dec of data.decisions_made) {
+        const decisionId = getNextDecisionId(specId);
+        for (const file of [...data.files_created, ...data.files_modified]) {
+          addGraphRelation(specId, {
+            sourceType: "decision",
+            sourceId: decisionId,
+            targetType: "file",
+            targetId: file,
+            relation: "implements",
+            strength: 0.8,
+          });
+          result.relationsAdded++;
+        }
+      }
+    }
+
+    // Relação: pattern -> arquivos (se patterns descobertos)
+    if (data.patterns_discovered) {
+      for (const pattern of data.patterns_discovered) {
+        for (const file of data.files_created) {
+          addGraphRelation(specId, {
+            sourceType: "pattern",
+            sourceId: pattern,
+            targetType: "file",
+            targetId: file,
+            relation: "extracted_from",
+            strength: 0.9,
+          });
+          result.relationsAdded++;
+        }
+      }
+    }
+  } catch (e) {
+    result.errors.push(`Erro ao criar relações: ${(e as Error).message}`);
+  }
+
+  // 8. v8.5: Registrar utilities de arquivos criados/modificados (DRY map)
+  try {
+    // 8a. Usar utilities declaradas pelo subagent (metadata mais rica)
+    if (data.utilities_created && data.utilities_created.length > 0) {
+      for (const util of data.utilities_created) {
+        upsertUtility({
+          filePath: util.file,
+          utilityName: util.name,
+          utilityType: util.type || "function",
+          scope: inferScopeFromPath(util.file),
+          signature: util.signature,
+          description: util.description,
+        }, specId, taskNumber);
+        result.utilitiesRegistered++;
+      }
+    }
+
+    // 8b. Fallback: escanear exports de arquivos criados/modificados
+    for (const file of allFiles.map(f => f.path)) {
+      const utilities = extractUtilitiesFromFile(file);
+      const scope = inferScopeFromPath(file);
+      for (const util of utilities) {
+        upsertUtility({
+          filePath: file,
+          utilityName: util.name,
+          utilityType: util.type,
+          scope,
+          signature: util.signature,
+        }, specId, taskNumber);
+        result.utilitiesRegistered++;
+      }
+    }
+  } catch (e) {
+    // Nao-critico: nao falhar processamento por extracao de utilities
+    result.errors.push(`Aviso utilities: ${(e as Error).message}`);
+  }
+
+  result.success = result.errors.length === 0;
+  return result;
+}
+
+/**
+ * Formata o resultado do processamento para exibicao
+ */
+export function formatProcessResult(result: ProcessResult): string {
+  let output = "\n[i] Retorno do subagent processado automaticamente:\n";
+
+  if (result.knowledgeAdded > 0) {
+    output += `    + ${result.knowledgeAdded} knowledge(s) registrado(s) para broadcast\n`;
+  }
+  if (result.decisionsAdded > 0) {
+    output += `    + ${result.decisionsAdded} decisao(es) registrada(s)\n`;
+  }
+  if (result.artifactsAdded > 0) {
+    output += `    + ${result.artifactsAdded} artefato(s) registrado(s)\n`;
+  }
+  if (result.patternsAdded > 0) {
+    output += `    + ${result.patternsAdded} pattern(s) adicionado(s) ao contexto\n`;
+  }
+  // v8.0: Novas métricas
+  if (result.reasoningAdded > 0) {
+    output += `    + ${result.reasoningAdded} raciocinio(s) registrado(s) no historico\n`;
+  }
+  if (result.relationsAdded > 0) {
+    output += `    + ${result.relationsAdded} relacao(oes) criada(s) no grafo de conhecimento\n`;
+  }
+  // v8.5: Utilities registradas
+  if (result.utilitiesRegistered > 0) {
+    output += `    + ${result.utilitiesRegistered} utilidade(s) registrada(s) no mapa DRY\n`;
+  }
+
+  if (result.errors.length > 0) {
+    output += "\n[!] Erros durante processamento:\n";
+    for (const error of result.errors) {
+      output += `    - ${error}\n`;
+    }
+  }
+
+  return output;
 }