@codexa/cli 9.0.2 → 9.0.4

package/commands/architect.ts

@@ -1,13 +1,14 @@
 import { getDb } from "../db/connection";
 import { initSchema } from "../db/schema";
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
+import { CodexaError } from "../errors";
 import { join } from "path";
 
 // ═══════════════════════════════════════════════════════════════
 // TYPES
 // ═══════════════════════════════════════════════════════════════
 
-interface BabyStep {
+export interface BabyStep {
   number: number;
   name: string;
   what: string;
@@ -18,7 +19,7 @@ interface BabyStep {
   dependsOn?: number[];
 }
 
-interface Risk {
+export interface Risk {
   id: string;
   description: string;
   probability: "low" | "medium" | "high";
@@ -35,7 +36,7 @@ interface Alternative {
   whyDiscarded?: string;
 }
 
-interface ArchitecturalDecision {
+export interface ArchitecturalDecision {
   decision: string;
   rationale: string;
 }
@@ -103,23 +104,80 @@ function formatDate(date: Date): string {
 }
 
 // ═══════════════════════════════════════════════════════════════
-// MARKDOWN PARSER (v8.4)
+// MARKDOWN PARSER (v8.4 + v9.0 tolerant matching)
 // ═══════════════════════════════════════════════════════════════
 
-function extractSection(content: string, header: string): string {
-  // Split por headers ## e encontrar a secao correta
+const HEADER_ALIASES: Record<string, string[]> = {
+  "Contexto e Entendimento": [
+    "contexto e entendimento", "context and understanding", "contexto",
+    "entendimento do problema", "understanding", "background",
+  ],
+  "Stack e Arquitetura Atual": [
+    "stack e arquitetura atual", "stack e arquitetura", "current architecture",
+    "arquitetura atual", "stack atual", "tech stack",
+  ],
+  "Solucao Proposta": [
+    "solucao proposta", "proposed solution", "abordagem proposta",
+    "proposta", "solution", "approach",
+  ],
+  "Diagramas": [
+    "diagramas", "diagrams", "diagramas mermaid", "architecture diagrams",
+  ],
+  "Baby Steps": [
+    "baby steps", "passos", "steps", "plano de implementacao",
+    "implementation plan", "implementation steps", "etapas",
+  ],
+  "Riscos e Mitigacoes": [
+    "riscos e mitigacoes", "risks and mitigations", "riscos",
+    "risks", "analise de riscos", "risk analysis",
+  ],
+  "Alternativas Descartadas": [
+    "alternativas descartadas", "alternativas", "alternatives",
+    "discarded alternatives", "alternativas consideradas",
+  ],
+  "Decisoes Arquiteturais": [
+    "decisoes arquiteturais", "architectural decisions",
+    "decisoes", "decisions",
+  ],
+};
+
+export function extractSection(content: string, header: string): string {
   const sections = content.split(/^## /m);
+
+  // Tier 1: Exact startsWith (fast path)
   for (const section of sections) {
     if (section.startsWith(header)) {
-      // Remover o header e retornar o conteudo
       const lines = section.split("\n");
       return lines.slice(1).join("\n").trim();
     }
   }
+
+  // Tier 2: Case-insensitive startsWith
+  const headerLower = header.toLowerCase();
+  for (const section of sections) {
+    if (section.toLowerCase().startsWith(headerLower)) {
+      const lines = section.split("\n");
+      return lines.slice(1).join("\n").trim();
+    }
+  }
+
+  // Tier 3: Alias-based includes matching (case-insensitive)
+  const aliases = HEADER_ALIASES[header] || [];
+  for (const section of sections) {
+    const sectionHeader = section.split("\n")[0]?.toLowerCase().trim() || "";
+    for (const alias of aliases) {
+      if (sectionHeader.includes(alias)) {
+        const lines = section.split("\n");
+        return lines.slice(1).join("\n").trim();
+      }
+    }
+  }
+
+  console.warn(`[architect] Secao "${header}" nao encontrada no .md`);
   return "";
 }
 
-function parseBabySteps(section: string): BabyStep[] {
+export function parseBabySteps(section: string): BabyStep[] {
   if (!section) return [];
   const steps: BabyStep[] = [];
   // Match "### N. Name" or "### Step N: Name"
@@ -152,7 +210,7 @@ function parseBabySteps(section: string): BabyStep[] {
   return steps;
 }
 
-function parseRisks(section: string): Risk[] {
+export function parseRisks(section: string): Risk[] {
   if (!section) return [];
   const risks: Risk[] = [];
   const riskBlocks = section.split(/^###\s+/m).filter(Boolean);
@@ -173,7 +231,7 @@ function parseRisks(section: string): Risk[] {
   return risks;
 }
 
-function parseDiagrams(section: string): { name: string; type: string; content: string }[] {
+export function parseDiagrams(section: string): { name: string; type: string; content: string }[] {
   if (!section) return [];
   const diagrams: { name: string; type: string; content: string }[] = [];
   const diagramRegex = /###\s+(.+)\n[\s\S]*?```mermaid\n([\s\S]*?)```/g;
@@ -192,7 +250,7 @@ function parseDiagrams(section: string): { name: string; type: string; content:
   return diagrams;
 }
 
-function parseDecisionsTable(section: string): ArchitecturalDecision[] {
+export function parseDecisionsTable(section: string): ArchitecturalDecision[] {
   if (!section) return [];
   const decisions: ArchitecturalDecision[] = [];
   const lines = section.split("\n");
@@ -307,7 +365,7 @@ export function architectStart(description: string, options: { json?: boolean }
       console.log(`  Criada: ${pending.created_at}`);
       console.log("\nUse 'architect show' para ver detalhes ou 'architect cancel' para cancelar.\n");
     }
-    process.exit(1);
+    throw new CodexaError("Ja existe uma analise pendente. Use 'architect show' ou 'architect cancel'.");
   }
 
   // Criar nova analise
@@ -509,7 +567,7 @@ export function architectSave(options: { file?: string; json?: boolean }): void
     } else {
       console.log("\n[ERRO] Nenhuma analise pendente encontrada.\n");
     }
-    process.exit(1);
+    throw new CodexaError("Nenhuma analise pendente encontrada.");
   }
 
   // v8.4: Resolver caminho do arquivo .md
@@ -530,7 +588,7 @@ export function architectSave(options: { file?: string; json?: boolean }): void
       console.log(`\n[ERRO] Arquivo nao encontrado: ${filePath}`);
       console.log("O agente architect deve escrever o .md antes de chamar 'architect save'.\n");
     }
-    process.exit(1);
+    throw new CodexaError(`Arquivo nao encontrado: ${filePath}`);
   }
 
   const content = readFileSync(filePath, "utf-8");
@@ -640,7 +698,7 @@ export function architectApprove(options: { id?: string; json?: boolean }): void
     } else {
       console.log("\n[ERRO] Analise nao encontrada.\n");
     }
-    process.exit(1);
+    throw new CodexaError("Analise nao encontrada.");
   }
 
   if (analysis.status !== "pending") {
@@ -649,7 +707,7 @@ export function architectApprove(options: { id?: string; json?: boolean }): void
     } else {
       console.log(`\n[ERRO] Analise ja esta com status '${analysis.status}'.\n`);
     }
-    process.exit(1);
+    throw new CodexaError(`Analise ja esta com status '${analysis.status}'.`);
   }
 
   db.run(
@@ -693,7 +751,7 @@ export function architectExport(options: { id?: string; json?: boolean }): void
       console.log("\n[ERRO] Nenhuma analise aprovada encontrada.");
       console.log("Use 'architect approve' primeiro.\n");
     }
-    process.exit(1);
+    throw new CodexaError("Nenhuma analise aprovada encontrada. Use 'architect approve' primeiro.");
   }
 
   const babySteps: BabyStep[] = analysis.baby_steps ? JSON.parse(analysis.baby_steps) : [];

package/commands/check.ts

@@ -1,15 +1,14 @@
 import { getDb } from "../db/connection";
 import { initSchema } from "../db/schema";
 import { enforceGate } from "../gates/validator";
+import { resolveSpec } from "./spec-resolver";
 
-export function checkRequest(): void {
+export function checkRequest(specId?: string): void {
   initSchema();
   enforceGate("check-request");
 
   const db = getDb();
-  const spec = db
-    .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
-    .get() as any;
+  const spec = resolveSpec(specId, ["planning"]);
 
   const tasks = db
     .query("SELECT * FROM tasks WHERE spec_id = ? ORDER BY number")
@@ -68,16 +67,14 @@ export function checkRequest(): void {
   console.log(`Para ajustar: plan task-add (adiciona mais tasks)\n`);
 }
 
-export function checkApprove(): void {
+export function checkApprove(specId?: string): void {
   initSchema();
   enforceGate("check-approve");
 
   const db = getDb();
   const now = new Date().toISOString();
 
-  const spec = db
-    .query("SELECT * FROM specs WHERE phase = 'checking' ORDER BY created_at DESC LIMIT 1")
-    .get() as any;
+  const spec = resolveSpec(specId, ["checking"]);
 
   // Atualizar para aprovado
   db.run(
@@ -100,20 +97,13 @@ export function checkApprove(): void {
   console.log(`3. Complete uma task com: task done <id> --checkpoint "..."\n`);
 }
 
-export function checkReject(reason: string): void {
+export function checkReject(reason: string, specId?: string): void {
   initSchema();
 
   const db = getDb();
   const now = new Date().toISOString();
 
-  const spec = db
-    .query("SELECT * FROM specs WHERE phase = 'checking' ORDER BY created_at DESC LIMIT 1")
-    .get() as any;
-
-  if (!spec) {
-    console.error("\nNenhum plano aguardando aprovacao.\n");
-    process.exit(1);
-  }
+  const spec = resolveSpec(specId, ["checking"]);
 
   // Voltar para planning
   db.run("UPDATE specs SET phase = 'planning', updated_at = ? WHERE id = ?", [now, spec.id]);

package/commands/clear.ts

@@ -5,6 +5,7 @@ import { join, dirname } from "path";
 
 interface ClearOptions {
   force?: boolean;
+  specId?: string;
 }
 
 /**
@@ -64,6 +65,45 @@ export function clearTasks(options: ClearOptions = {}): void {
     return;
   }
 
+  // Per-spec clear or clear all
+  if (options.specId) {
+    console.log("\n" + "═".repeat(60));
+    console.log(`LIMPANDO SPEC: ${options.specId}`);
+    console.log("═".repeat(60) + "\n");
+
+    const tablesWithSpecId = [
+      "reasoning_log",
+      "knowledge_graph",
+      "knowledge",
+      "gate_bypasses",
+      "snapshots",
+      "review",
+      "artifacts",
+      "decisions",
+      "tasks",
+      "context",
+      "specs",
+    ];
+
+    for (const table of tablesWithSpecId) {
+      try {
+        const result = db.run(`DELETE FROM ${table} WHERE spec_id = ?`, [options.specId]);
+        if (result.changes > 0) {
+          console.log(`  Limpo: ${table} (${result.changes} registros)`);
+        }
+      } catch (err: any) {
+        if (!err.message.includes("no such table") && !err.message.includes("no such column")) {
+          console.error(`  Erro ao limpar ${table}: ${err.message}`);
+        }
+      }
+    }
+
+    console.log("\n" + "═".repeat(60));
+    console.log(`SPEC ${options.specId} LIMPO`);
+    console.log("═".repeat(60) + "\n");
+    return;
+  }
+
   console.log("\n" + "═".repeat(60));
   console.log("LIMPANDO TASKS...");
   console.log("═".repeat(60) + "\n");
@@ -71,7 +111,6 @@ export function clearTasks(options: ClearOptions = {}): void {
   // Ordem de deleção respeita foreign keys
   // v8.0: Incluindo novas tabelas
   const tablesToClear = [
-    "session_summaries",
     "reasoning_log",
     "knowledge_graph",
     "knowledge",

package/commands/decide.ts

@@ -1,17 +1,7 @@
 import { getDb } from "../db/connection";
-import { initSchema } from "../db/schema";
-
-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")}`;
-}
+import { initSchema, getNextDecisionId } from "../db/schema";
+import { resolveSpec } from "./spec-resolver";
+import { CodexaError } from "../errors";
 
 interface ConflictAnalysis {
   hasConflict: boolean;
@@ -136,20 +126,13 @@ function detectConflicts(
   };
 }
 
-export function decide(title: string, decision: string, options: { rationale?: string; force?: boolean }): void {
+export function decide(title: string, decision: string, options: { rationale?: string; force?: boolean; specId?: string }): void {
   initSchema();
 
   const db = getDb();
   const now = new Date().toISOString();
 
-  const spec = db
-    .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
-    .get() as any;
-
-  if (!spec) {
-    console.error("\nNenhuma feature ativa.\n");
-    process.exit(1);
-  }
+  const spec = resolveSpec(options.specId);
 
   // Verificar conflitos com decisoes existentes
   const existingDecisions = db
@@ -171,9 +154,9 @@ export function decide(title: string, decision: string, options: { rationale?: s
       }
 
       console.warn(`${"─".repeat(50)}`);
-      console.warn(`Para registrar mesmo assim, use: decide "${title}" "${decision}" --force`);
-      console.warn(`Ou revise as decisoes existentes com: decisions\n`);
-      process.exit(1);
+      throw new CodexaError(
+        `Potencial conflito detectado.\nPara registrar mesmo assim, use: decide "${title}" "${decision}" --force\nOu revise as decisoes existentes com: decisions`
+      );
     }
   }
 
@@ -182,21 +165,33 @@ export function decide(title: string, decision: string, options: { rationale?: s
     .query("SELECT * FROM tasks WHERE spec_id = ? AND status = 'running' LIMIT 1")
     .get(spec.id) as any;
 
-  const decisionId = getNextDecisionId(spec.id);
-
-  db.run(
-    `INSERT INTO decisions (id, spec_id, task_ref, title, decision, rationale, status, created_at)
-     VALUES (?, ?, ?, ?, ?, ?, 'active', ?)`,
-    [
-      decisionId,
-      spec.id,
-      currentTask?.number || null,
-      title,
-      decision,
-      options.rationale || null,
-      now,
-    ]
-  );
+  let decisionId = "";
+  let retries = 3;
+  while (retries > 0) {
+    decisionId = getNextDecisionId(spec.id);
+    try {
+      db.run(
+        `INSERT INTO decisions (id, spec_id, task_ref, title, decision, rationale, status, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, 'active', ?)`,
+        [
+          decisionId,
+          spec.id,
+          currentTask?.number || null,
+          title,
+          decision,
+          options.rationale || null,
+          now,
+        ]
+      );
+      break;
+    } catch (e: any) {
+      if (e.message?.includes("UNIQUE constraint") && retries > 1) {
+        retries--;
+        continue;
+      }
+      throw e;
+    }
+  }
 
   console.log(`\nDecisao registrada: ${decisionId}`);
   console.log(`Titulo: ${title}`);
@@ -207,19 +202,12 @@ export function decide(title: string, decision: string, options: { rationale?: s
   console.log();
 }
 
-export function listDecisions(json: boolean = false): void {
+export function listDecisions(json: boolean = false, specId?: string): void {
   initSchema();
 
   const db = getDb();
 
-  const spec = db
-    .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
-    .get() as any;
-
-  if (!spec) {
-    console.error("\nNenhuma feature ativa.\n");
-    process.exit(1);
-  }
+  const spec = resolveSpec(specId);
 
   const decisions = db
     .query("SELECT * FROM decisions WHERE spec_id = ? ORDER BY created_at")