@codexa/cli 8.6.0 → 8.6.9

package/commands/knowledge.ts

@@ -1,362 +1,362 @@
-import { getDb } from "../db/connection";
-import { initSchema, getRelatedDecisions, getRelatedFiles, findContradictions } from "../db/schema";
-
-type KnowledgeCategory = "discovery" | "decision" | "blocker" | "pattern" | "constraint";
-type KnowledgeSeverity = "info" | "warning" | "critical";
-
-interface AddKnowledgeOptions {
-  content: string;
-  category: KnowledgeCategory;
-  severity?: KnowledgeSeverity;
-  broadcastTo?: string;
-}
-
-function getActiveSpec(): any {
-  const db = getDb();
-  return db
-    .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
-    .get();
-}
-
-function getCurrentTask(specId: string): any {
-  const db = getDb();
-  return db
-    .query("SELECT * FROM tasks WHERE spec_id = ? AND status = 'running' LIMIT 1")
-    .get(specId);
-}
-
-export function addKnowledge(options: AddKnowledgeOptions): void {
-  initSchema();
-
-  const db = getDb();
-  const now = new Date().toISOString();
-
-  const spec = getActiveSpec();
-  if (!spec) {
-    console.error("\nNenhuma feature ativa.\n");
-    process.exit(1);
-  }
-
-  const currentTask = getCurrentTask(spec.id);
-  if (!currentTask) {
-    console.error("\nNenhuma task em execucao.");
-    console.error("Knowledge so pode ser adicionado durante execucao de uma task.\n");
-    process.exit(1);
-  }
-
-  const validCategories: KnowledgeCategory[] = ["discovery", "decision", "blocker", "pattern", "constraint"];
-  if (!validCategories.includes(options.category)) {
-    console.error(`\nCategoria invalida: ${options.category}`);
-    console.error(`Validas: ${validCategories.join(", ")}\n`);
-    process.exit(1);
-  }
-
-  const severity = options.severity || "info";
-  const broadcastTo = options.broadcastTo || "all";
-
-  db.run(
-    `INSERT INTO knowledge (spec_id, task_origin, category, content, severity, broadcast_to, created_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?)`,
-    [spec.id, currentTask.id, options.category, options.content, severity, broadcastTo, now]
-  );
-
-  const severityIcon = {
-    info: "i",
-    warning: "!",
-    critical: "X",
-  }[severity];
-
-  console.log(`\n[${severityIcon}] Knowledge registrado`);
-  console.log(`Categoria: ${options.category}`);
-  console.log(`Severidade: ${severity}`);
-  console.log(`Origem: Task #${currentTask.number}`);
-  console.log(`Broadcast: ${broadcastTo}`);
-  console.log(`Conteudo: ${options.content}\n`);
-}
-
-export function listKnowledge(options: {
-  unread?: boolean;
-  category?: string;
-  severity?: string;  // v8.0: Filtro por severidade
-  json?: boolean;
-}): void {
-  initSchema();
-
-  const db = getDb();
-
-  const spec = getActiveSpec();
-  if (!spec) {
-    if (options.json) {
-      console.log(JSON.stringify({ knowledge: [], message: "Nenhuma feature ativa" }));
-      return;
-    }
-    console.error("\nNenhuma feature ativa.\n");
-    process.exit(1);
-  }
-
-  let query = "SELECT * FROM knowledge WHERE spec_id = ?";
-  const params: any[] = [spec.id];
-
-  if (options.category) {
-    query += " AND category = ?";
-    params.push(options.category);
-  }
-
-  // v8.0: Filtro por severidade (critical mostra só critical, warning mostra warning+critical)
-  if (options.severity) {
-    if (options.severity === "critical") {
-      query += " AND severity = 'critical'";
-    } else if (options.severity === "warning") {
-      query += " AND severity IN ('warning', 'critical')";
-    }
-    // info mostra tudo (comportamento padrão)
-  }
-
-  query += " ORDER BY severity DESC, created_at DESC";
-
-  const knowledge = db.query(query).all(...params) as any[];
-
-  // Filtrar unread se solicitado
-  let filtered = knowledge;
-  if (options.unread) {
-    const currentTask = getCurrentTask(spec.id);
-    if (currentTask) {
-      filtered = knowledge.filter((k) => {
-        if (!k.acknowledged_by) return true;
-        const acked = JSON.parse(k.acknowledged_by) as number[];
-        return !acked.includes(currentTask.id);
-      });
-    }
-  }
-
-  if (options.json) {
-    console.log(JSON.stringify({ knowledge: filtered }));
-    return;
-  }
-
-  if (filtered.length === 0) {
-    console.log("\nNenhum knowledge encontrado.\n");
-    return;
-  }
-
-  console.log(`\nKnowledge Broadcast (${filtered.length}):`);
-  console.log(`${"─".repeat(60)}`);
-
-  const severityIcon = {
-    info: "i",
-    warning: "!",
-    critical: "X",
-  };
-
-  for (const k of filtered) {
-    const icon = severityIcon[k.severity as KnowledgeSeverity] || "?";
-    const taskOrigin = k.task_origin ? `Task #${k.task_origin}` : "Sistema";
-    console.log(`[${icon}] #${k.id} (${k.category}) - ${taskOrigin}`);
-    console.log(`    ${k.content}`);
-    console.log(`    Broadcast: ${k.broadcast_to} | ${k.created_at}`);
-    console.log();
-  }
-}
-
-export function acknowledgeKnowledge(knowledgeId: string): void {
-  initSchema();
-
-  const db = getDb();
-
-  const spec = getActiveSpec();
-  if (!spec) {
-    console.error("\nNenhuma feature ativa.\n");
-    process.exit(1);
-  }
-
-  const currentTask = getCurrentTask(spec.id);
-  if (!currentTask) {
-    console.error("\nNenhuma task em execucao.\n");
-    process.exit(1);
-  }
-
-  const kid = parseInt(knowledgeId);
-  const knowledge = db.query("SELECT * FROM knowledge WHERE id = ?").get(kid) as any;
-
-  if (!knowledge) {
-    console.error(`\nKnowledge #${kid} nao encontrado.\n`);
-    process.exit(1);
-  }
-
-  const acknowledged = knowledge.acknowledged_by
-    ? (JSON.parse(knowledge.acknowledged_by) as number[])
-    : [];
-
-  if (!acknowledged.includes(currentTask.id)) {
-    acknowledged.push(currentTask.id);
-    db.run("UPDATE knowledge SET acknowledged_by = ? WHERE id = ?", [
-      JSON.stringify(acknowledged),
-      kid,
-    ]);
-  }
-
-  console.log(`\nKnowledge #${kid} marcado como lido pela Task #${currentTask.number}.\n`);
-}
-
-export function getKnowledgeForTask(specId: string, taskId: number): any[] {
-  const db = getDb();
-
-  // Buscar todo knowledge da spec e filtrar em codigo
-  // Fix: LIKE '%taskId%' causava substring match (taskId=1 matchava "1,10,11")
-  const knowledge = db
-    .query(
-      `SELECT * FROM knowledge
-       WHERE spec_id = ?
-       ORDER BY severity DESC, created_at DESC
-       LIMIT 50`
-    )
-    .all(specId) as any[];
-
-  return knowledge.filter((k) => {
-    if (k.broadcast_to === 'all') return true;
-    const targets = k.broadcast_to.split(',').map((t: string) => parseInt(t.trim(), 10));
-    return targets.includes(taskId);
-  }).slice(0, 20);
-}
-
-export function getUnreadKnowledgeForTask(specId: string, taskId: number): any[] {
-  const all = getKnowledgeForTask(specId, taskId);
-
-  return all.filter((k) => {
-    if (!k.acknowledged_by) return true;
-    const acked = JSON.parse(k.acknowledged_by) as number[];
-    return !acked.includes(taskId);
-  });
-}
-
-// v8.1: Consultar knowledge_graph - encontrar relacoes para arquivo, decisao ou pattern
-export function queryGraph(options: {
-  file?: string;
-  decision?: string;
-  contradictions?: boolean;
-  json?: boolean;
-}): void {
-  initSchema();
-  const db = getDb();
-
-  const spec = getActiveSpec();
-  if (!spec) {
-    console.error("\nNenhuma feature ativa.\n");
-    process.exit(1);
-  }
-
-  // Buscar contradicoes
-  if (options.contradictions) {
-    const contradictions = findContradictions(spec.id);
-
-    if (options.json) {
-      console.log(JSON.stringify({ contradictions }));
-      return;
-    }
-
-    if (contradictions.length === 0) {
-      console.log("\nNenhuma contradicao detectada.\n");
-      return;
-    }
-
-    console.log(`\nContradicoes detectadas (${contradictions.length}):`);
-    console.log(`${"─".repeat(50)}`);
-    for (const c of contradictions) {
-      console.log(`  [!] "${c.decision1}" <-> "${c.decision2}"`);
-      console.log(`      Detectada em: ${c.createdAt}\n`);
-    }
-    return;
-  }
-
-  // Buscar relacoes para um arquivo
-  if (options.file) {
-    const decisions = getRelatedDecisions(options.file, "file");
-    const relatedFiles = db.query(`
-      SELECT DISTINCT kg.target_id as file, kg.relation
-      FROM knowledge_graph kg
-      WHERE kg.source_id = ? AND kg.target_type = 'file'
-      UNION
-      SELECT DISTINCT kg.source_id as file, kg.relation
-      FROM knowledge_graph kg
-      WHERE kg.target_id = ? AND kg.source_type = 'file'
-    `).all(options.file, options.file) as any[];
-
-    if (options.json) {
-      console.log(JSON.stringify({ file: options.file, decisions, relatedFiles }));
-      return;
-    }
-
-    console.log(`\nRelacoes para: ${options.file}`);
-    console.log(`${"─".repeat(50)}`);
-
-    if (decisions.length > 0) {
-      console.log(`\nDecisoes que afetam este arquivo:`);
-      for (const d of decisions) {
-        console.log(`  - ${d.title}: ${d.decision}`);
-      }
-    }
-
-    if (relatedFiles.length > 0) {
-      console.log(`\nArquivos relacionados:`);
-      for (const f of relatedFiles) {
-        console.log(`  - ${f.file} (${f.relation})`);
-      }
-    }
-
-    if (decisions.length === 0 && relatedFiles.length === 0) {
-      console.log("  Nenhuma relacao encontrada.");
-    }
-    console.log();
-    return;
-  }
-
-  // Buscar arquivos afetados por uma decisao
-  if (options.decision) {
-    const files = getRelatedFiles(options.decision, "decision");
-
-    if (options.json) {
-      console.log(JSON.stringify({ decision: options.decision, files }));
-      return;
-    }
-
-    console.log(`\nArquivos afetados pela decisao "${options.decision}":`);
-    console.log(`${"─".repeat(50)}`);
-    if (files.length > 0) {
-      for (const f of files) {
-        console.log(`  - ${f}`);
-      }
-    } else {
-      console.log("  Nenhum arquivo relacionado encontrado.");
-    }
-    console.log();
-    return;
-  }
-
-  // Sem opcao: mostrar resumo do grafo
-  const totalRelations = db.query(
-    "SELECT COUNT(*) as c FROM knowledge_graph WHERE spec_id = ?"
-  ).get(spec.id) as any;
-
-  const relationTypes = db.query(
-    "SELECT relation, COUNT(*) as c FROM knowledge_graph WHERE spec_id = ? GROUP BY relation ORDER BY c DESC"
-  ).all(spec.id) as any[];
-
-  if (options.json) {
-    console.log(JSON.stringify({ totalRelations: totalRelations.c, relationTypes }));
-    return;
-  }
-
-  console.log(`\nKnowledge Graph: ${totalRelations.c} relacoes`);
-  console.log(`${"─".repeat(50)}`);
-  if (relationTypes.length > 0) {
-    for (const rt of relationTypes) {
-      console.log(`  ${rt.relation}: ${rt.c}`);
-    }
-  } else {
-    console.log("  Grafo vazio. Relacoes serao criadas automaticamente durante a execucao.");
-  }
-  console.log(`\nComandos:`);
-  console.log(`  knowledge graph --file <path>           Relacoes de um arquivo`);
-  console.log(`  knowledge graph --decision <id>         Arquivos afetados por decisao`);
-  console.log(`  knowledge graph --contradictions        Detectar contradicoes\n`);
+import { getDb } from "../db/connection";
+import { initSchema, getRelatedDecisions, getRelatedFiles, findContradictions } from "../db/schema";
+
+type KnowledgeCategory = "discovery" | "decision" | "blocker" | "pattern" | "constraint";
+type KnowledgeSeverity = "info" | "warning" | "critical";
+
+interface AddKnowledgeOptions {
+  content: string;
+  category: KnowledgeCategory;
+  severity?: KnowledgeSeverity;
+  broadcastTo?: string;
+}
+
+function getActiveSpec(): any {
+  const db = getDb();
+  return db
+    .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
+    .get();
+}
+
+function getCurrentTask(specId: string): any {
+  const db = getDb();
+  return db
+    .query("SELECT * FROM tasks WHERE spec_id = ? AND status = 'running' LIMIT 1")
+    .get(specId);
+}
+
+export function addKnowledge(options: AddKnowledgeOptions): void {
+  initSchema();
+
+  const db = getDb();
+  const now = new Date().toISOString();
+
+  const spec = getActiveSpec();
+  if (!spec) {
+    console.error("\nNenhuma feature ativa.\n");
+    process.exit(1);
+  }
+
+  const currentTask = getCurrentTask(spec.id);
+  if (!currentTask) {
+    console.error("\nNenhuma task em execucao.");
+    console.error("Knowledge so pode ser adicionado durante execucao de uma task.\n");
+    process.exit(1);
+  }
+
+  const validCategories: KnowledgeCategory[] = ["discovery", "decision", "blocker", "pattern", "constraint"];
+  if (!validCategories.includes(options.category)) {
+    console.error(`\nCategoria invalida: ${options.category}`);
+    console.error(`Validas: ${validCategories.join(", ")}\n`);
+    process.exit(1);
+  }
+
+  const severity = options.severity || "info";
+  const broadcastTo = options.broadcastTo || "all";
+
+  db.run(
+    `INSERT INTO knowledge (spec_id, task_origin, category, content, severity, broadcast_to, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    [spec.id, currentTask.id, options.category, options.content, severity, broadcastTo, now]
+  );
+
+  const severityIcon = {
+    info: "i",
+    warning: "!",
+    critical: "X",
+  }[severity];
+
+  console.log(`\n[${severityIcon}] Knowledge registrado`);
+  console.log(`Categoria: ${options.category}`);
+  console.log(`Severidade: ${severity}`);
+  console.log(`Origem: Task #${currentTask.number}`);
+  console.log(`Broadcast: ${broadcastTo}`);
+  console.log(`Conteudo: ${options.content}\n`);
+}
+
+export function listKnowledge(options: {
+  unread?: boolean;
+  category?: string;
+  severity?: string;  // v8.0: Filtro por severidade
+  json?: boolean;
+}): void {
+  initSchema();
+
+  const db = getDb();
+
+  const spec = getActiveSpec();
+  if (!spec) {
+    if (options.json) {
+      console.log(JSON.stringify({ knowledge: [], message: "Nenhuma feature ativa" }));
+      return;
+    }
+    console.error("\nNenhuma feature ativa.\n");
+    process.exit(1);
+  }
+
+  let query = "SELECT * FROM knowledge WHERE spec_id = ?";
+  const params: any[] = [spec.id];
+
+  if (options.category) {
+    query += " AND category = ?";
+    params.push(options.category);
+  }
+
+  // v8.0: Filtro por severidade (critical mostra só critical, warning mostra warning+critical)
+  if (options.severity) {
+    if (options.severity === "critical") {
+      query += " AND severity = 'critical'";
+    } else if (options.severity === "warning") {
+      query += " AND severity IN ('warning', 'critical')";
+    }
+    // info mostra tudo (comportamento padrão)
+  }
+
+  query += " ORDER BY severity DESC, created_at DESC";
+
+  const knowledge = db.query(query).all(...params) as any[];
+
+  // Filtrar unread se solicitado
+  let filtered = knowledge;
+  if (options.unread) {
+    const currentTask = getCurrentTask(spec.id);
+    if (currentTask) {
+      filtered = knowledge.filter((k) => {
+        if (!k.acknowledged_by) return true;
+        const acked = JSON.parse(k.acknowledged_by) as number[];
+        return !acked.includes(currentTask.id);
+      });
+    }
+  }
+
+  if (options.json) {
+    console.log(JSON.stringify({ knowledge: filtered }));
+    return;
+  }
+
+  if (filtered.length === 0) {
+    console.log("\nNenhum knowledge encontrado.\n");
+    return;
+  }
+
+  console.log(`\nKnowledge Broadcast (${filtered.length}):`);
+  console.log(`${"─".repeat(60)}`);
+
+  const severityIcon = {
+    info: "i",
+    warning: "!",
+    critical: "X",
+  };
+
+  for (const k of filtered) {
+    const icon = severityIcon[k.severity as KnowledgeSeverity] || "?";
+    const taskOrigin = k.task_origin ? `Task #${k.task_origin}` : "Sistema";
+    console.log(`[${icon}] #${k.id} (${k.category}) - ${taskOrigin}`);
+    console.log(`    ${k.content}`);
+    console.log(`    Broadcast: ${k.broadcast_to} | ${k.created_at}`);
+    console.log();
+  }
+}
+
+export function acknowledgeKnowledge(knowledgeId: string): void {
+  initSchema();
+
+  const db = getDb();
+
+  const spec = getActiveSpec();
+  if (!spec) {
+    console.error("\nNenhuma feature ativa.\n");
+    process.exit(1);
+  }
+
+  const currentTask = getCurrentTask(spec.id);
+  if (!currentTask) {
+    console.error("\nNenhuma task em execucao.\n");
+    process.exit(1);
+  }
+
+  const kid = parseInt(knowledgeId);
+  const knowledge = db.query("SELECT * FROM knowledge WHERE id = ?").get(kid) as any;
+
+  if (!knowledge) {
+    console.error(`\nKnowledge #${kid} nao encontrado.\n`);
+    process.exit(1);
+  }
+
+  const acknowledged = knowledge.acknowledged_by
+    ? (JSON.parse(knowledge.acknowledged_by) as number[])
+    : [];
+
+  if (!acknowledged.includes(currentTask.id)) {
+    acknowledged.push(currentTask.id);
+    db.run("UPDATE knowledge SET acknowledged_by = ? WHERE id = ?", [
+      JSON.stringify(acknowledged),
+      kid,
+    ]);
+  }
+
+  console.log(`\nKnowledge #${kid} marcado como lido pela Task #${currentTask.number}.\n`);
+}
+
+export function getKnowledgeForTask(specId: string, taskId: number): any[] {
+  const db = getDb();
+
+  // Buscar todo knowledge da spec e filtrar em codigo
+  // Fix: LIKE '%taskId%' causava substring match (taskId=1 matchava "1,10,11")
+  const knowledge = db
+    .query(
+      `SELECT * FROM knowledge
+       WHERE spec_id = ?
+       ORDER BY severity DESC, created_at DESC
+       LIMIT 50`
+    )
+    .all(specId) as any[];
+
+  return knowledge.filter((k) => {
+    if (k.broadcast_to === 'all') return true;
+    const targets = k.broadcast_to.split(',').map((t: string) => parseInt(t.trim(), 10));
+    return targets.includes(taskId);
+  }).slice(0, 20);
+}
+
+export function getUnreadKnowledgeForTask(specId: string, taskId: number): any[] {
+  const all = getKnowledgeForTask(specId, taskId);
+
+  return all.filter((k) => {
+    if (!k.acknowledged_by) return true;
+    const acked = JSON.parse(k.acknowledged_by) as number[];
+    return !acked.includes(taskId);
+  });
+}
+
+// v8.1: Consultar knowledge_graph - encontrar relacoes para arquivo, decisao ou pattern
+export function queryGraph(options: {
+  file?: string;
+  decision?: string;
+  contradictions?: boolean;
+  json?: boolean;
+}): void {
+  initSchema();
+  const db = getDb();
+
+  const spec = getActiveSpec();
+  if (!spec) {
+    console.error("\nNenhuma feature ativa.\n");
+    process.exit(1);
+  }
+
+  // Buscar contradicoes
+  if (options.contradictions) {
+    const contradictions = findContradictions(spec.id);
+
+    if (options.json) {
+      console.log(JSON.stringify({ contradictions }));
+      return;
+    }
+
+    if (contradictions.length === 0) {
+      console.log("\nNenhuma contradicao detectada.\n");
+      return;
+    }
+
+    console.log(`\nContradicoes detectadas (${contradictions.length}):`);
+    console.log(`${"─".repeat(50)}`);
+    for (const c of contradictions) {
+      console.log(`  [!] "${c.decision1}" <-> "${c.decision2}"`);
+      console.log(`      Detectada em: ${c.createdAt}\n`);
+    }
+    return;
+  }
+
+  // Buscar relacoes para um arquivo
+  if (options.file) {
+    const decisions = getRelatedDecisions(options.file, "file");
+    const relatedFiles = db.query(`
+      SELECT DISTINCT kg.target_id as file, kg.relation
+      FROM knowledge_graph kg
+      WHERE kg.source_id = ? AND kg.target_type = 'file'
+      UNION
+      SELECT DISTINCT kg.source_id as file, kg.relation
+      FROM knowledge_graph kg
+      WHERE kg.target_id = ? AND kg.source_type = 'file'
+    `).all(options.file, options.file) as any[];
+
+    if (options.json) {
+      console.log(JSON.stringify({ file: options.file, decisions, relatedFiles }));
+      return;
+    }
+
+    console.log(`\nRelacoes para: ${options.file}`);
+    console.log(`${"─".repeat(50)}`);
+
+    if (decisions.length > 0) {
+      console.log(`\nDecisoes que afetam este arquivo:`);
+      for (const d of decisions) {
+        console.log(`  - ${d.title}: ${d.decision}`);
+      }
+    }
+
+    if (relatedFiles.length > 0) {
+      console.log(`\nArquivos relacionados:`);
+      for (const f of relatedFiles) {
+        console.log(`  - ${f.file} (${f.relation})`);
+      }
+    }
+
+    if (decisions.length === 0 && relatedFiles.length === 0) {
+      console.log("  Nenhuma relacao encontrada.");
+    }
+    console.log();
+    return;
+  }
+
+  // Buscar arquivos afetados por uma decisao
+  if (options.decision) {
+    const files = getRelatedFiles(options.decision, "decision");
+
+    if (options.json) {
+      console.log(JSON.stringify({ decision: options.decision, files }));
+      return;
+    }
+
+    console.log(`\nArquivos afetados pela decisao "${options.decision}":`);
+    console.log(`${"─".repeat(50)}`);
+    if (files.length > 0) {
+      for (const f of files) {
+        console.log(`  - ${f}`);
+      }
+    } else {
+      console.log("  Nenhum arquivo relacionado encontrado.");
+    }
+    console.log();
+    return;
+  }
+
+  // Sem opcao: mostrar resumo do grafo
+  const totalRelations = db.query(
+    "SELECT COUNT(*) as c FROM knowledge_graph WHERE spec_id = ?"
+  ).get(spec.id) as any;
+
+  const relationTypes = db.query(
+    "SELECT relation, COUNT(*) as c FROM knowledge_graph WHERE spec_id = ? GROUP BY relation ORDER BY c DESC"
+  ).all(spec.id) as any[];
+
+  if (options.json) {
+    console.log(JSON.stringify({ totalRelations: totalRelations.c, relationTypes }));
+    return;
+  }
+
+  console.log(`\nKnowledge Graph: ${totalRelations.c} relacoes`);
+  console.log(`${"─".repeat(50)}`);
+  if (relationTypes.length > 0) {
+    for (const rt of relationTypes) {
+      console.log(`  ${rt.relation}: ${rt.c}`);
+    }
+  } else {
+    console.log("  Grafo vazio. Relacoes serao criadas automaticamente durante a execucao.");
+  }
+  console.log(`\nComandos:`);
+  console.log(`  knowledge graph --file <path>           Relacoes de um arquivo`);
+  console.log(`  knowledge graph --decision <id>         Arquivos afetados por decisao`);
+  console.log(`  knowledge graph --contradictions        Detectar contradicoes\n`);
 }