@codexa/cli 8.5.0 → 8.6.0

package/commands/review.ts

@@ -1,463 +1,463 @@
-import { getDb } from "../db/connection";
-import { initSchema, getArchitecturalAnalysisForSpec } from "../db/schema";
-import { enforceGate } from "../gates/validator";
-
-export function reviewStart(json: boolean = false): void {
-  initSchema();
-  enforceGate("review-start");
-
-  const db = getDb();
-  const now = new Date().toISOString();
-
-  const spec = db
-    .query("SELECT * FROM specs WHERE phase = 'implementing' ORDER BY created_at DESC LIMIT 1")
-    .get() as any;
-
-  const tasks = db
-    .query("SELECT * FROM tasks WHERE spec_id = ? ORDER BY number")
-    .all(spec.id) as any[];
-
-  const artifacts = db
-    .query("SELECT * FROM artifacts WHERE spec_id = ?")
-    .all(spec.id) as any[];
-
-  const decisions = db
-    .query("SELECT * FROM decisions WHERE spec_id = ? AND status = 'active'")
-    .all(spec.id) as any[];
-
-  // v8.4: Buscar analise arquitetural (link explicito via analysis_id ou nome)
-  const archAnalysis = getArchitecturalAnalysisForSpec(spec.name, spec.id);
-  const gateBypasses = db.query(
-    "SELECT * FROM gate_bypasses WHERE spec_id = ? ORDER BY created_at"
-  ).all(spec.id) as any[];
-
-  // Analisar plano vs implementado
-  const plannedFiles = tasks.flatMap((t) => (t.files ? JSON.parse(t.files) : []));
-  const createdFiles = artifacts.map((a) => a.path);
-
-  const missingFiles = plannedFiles.filter((f: string) => !createdFiles.includes(f));
-  const extraFiles = createdFiles.filter((f) => !plannedFiles.includes(f));
-
-  const deviations: string[] = [];
-  if (missingFiles.length > 0) {
-    deviations.push(`Arquivos planejados nao criados: ${missingFiles.join(", ")}`);
-  }
-  if (extraFiles.length > 0) {
-    deviations.push(`Arquivos extras criados: ${extraFiles.join(", ")}`);
-  }
-
-  // Criar registro de review
-  const reviewData = {
-    tasks_completed: tasks.length,
-    artifacts_created: artifacts.length,
-    decisions_made: decisions.length,
-    planned_files: plannedFiles,
-    created_files: createdFiles,
-    // v8.3: Contexto arquitetural e auditoria
-    architectural_analysis: archAnalysis ? {
-      id: archAnalysis.id,
-      name: archAnalysis.name,
-      approach: archAnalysis.approach,
-      risks: archAnalysis.risks ? JSON.parse(archAnalysis.risks) : [],
-      diagrams: archAnalysis.diagrams ? JSON.parse(archAnalysis.diagrams) : [],
-      decisions: archAnalysis.decisions ? JSON.parse(archAnalysis.decisions) : [],
-    } : null,
-    gate_bypasses: gateBypasses,
-    // v8.5: Utilities criadas nesta feature (DRY audit)
-    utilities_created: (() => {
-      try {
-        return db.query(
-          "SELECT * FROM project_utilities WHERE spec_id = ? ORDER BY file_path"
-        ).all(spec.id) as any[];
-      } catch { return []; }
-    })(),
-  };
-
-  db.run(
-    `INSERT INTO review (spec_id, planned_vs_done, deviations, status, created_at)
-     VALUES (?, ?, ?, 'pending', ?)`,
-    [
-      spec.id,
-      JSON.stringify(reviewData),
-      deviations.length > 0 ? JSON.stringify(deviations) : null,
-      now,
-    ]
-  );
-
-  // Atualizar fase
-  db.run("UPDATE specs SET phase = 'reviewing', updated_at = ? WHERE id = ?", [now, spec.id]);
-
-  if (json) {
-    console.log(JSON.stringify({ spec, reviewData, deviations }));
-    return;
-  }
-
-  console.log(`\n${"=".repeat(60)}`);
-  console.log(`REVIEW: ${spec.name}`);
-  console.log(`${"=".repeat(60)}`);
-
-  console.log(`\nResumo da implementacao:`);
-  console.log(`  Tasks concluidas: ${tasks.length}`);
-  console.log(`  Artefatos criados: ${artifacts.length}`);
-  console.log(`  Decisoes tomadas: ${decisions.length}`);
-
-  console.log(`\nArquivos criados:`);
-  for (const artifact of artifacts) {
-    console.log(`  - ${artifact.path}`);
-  }
-
-  if (decisions.length > 0) {
-    console.log(`\nDecisoes:`);
-    for (const dec of decisions) {
-      console.log(`  ${dec.id}: ${dec.title}`);
-    }
-  }
-
-  if (deviations.length > 0) {
-    console.log(`\nDesvios encontrados:`);
-    for (const dev of deviations) {
-      console.log(`  - ${dev}`);
-    }
-    console.log(`\nResolva os desvios antes de aprovar.`);
-  } else {
-    console.log(`\nNenhum desvio encontrado.`);
-  }
-
-  console.log(`\nPara aprovar: review approve`);
-  console.log(`Para ver status: status\n`);
-}
-
-export function reviewApprove(): void {
-  initSchema();
-  enforceGate("review-approve");
-
-  const db = getDb();
-  const now = new Date().toISOString();
-
-  const spec = db
-    .query("SELECT * FROM specs WHERE phase = 'reviewing' ORDER BY created_at DESC LIMIT 1")
-    .get() as any;
-
-  if (!spec) {
-    console.error("\nNenhum review em andamento.\n");
-    process.exit(1);
-  }
-
-  // Atualizar review
-  db.run("UPDATE review SET status = 'passed' WHERE spec_id = ?", [spec.id]);
-
-  // Atualizar spec para completed
-  db.run("UPDATE specs SET phase = 'completed', updated_at = ? WHERE id = ?", [now, spec.id]);
-
-  // Buscar todos os dados para snapshot e relatorio
-  const tasks = db.query("SELECT * FROM tasks WHERE spec_id = ? ORDER BY number").all(spec.id) as any[];
-  const decisions = db.query("SELECT * FROM decisions WHERE spec_id = ?").all(spec.id) as any[];
-  const artifacts = db.query("SELECT * FROM artifacts WHERE spec_id = ?").all(spec.id) as any[];
-  const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(spec.id) as any;
-  const review = db.query("SELECT * FROM review WHERE spec_id = ?").get(spec.id) as any;
-  const knowledge = db.query("SELECT * FROM knowledge WHERE spec_id = ?").all(spec.id) as any[];
-
-  // Criar snapshot final
-  const allData = {
-    spec,
-    context,
-    tasks,
-    decisions,
-    artifacts,
-    review,
-    knowledge,
-  };
-
-  db.run("INSERT INTO snapshots (spec_id, data, trigger, created_at) VALUES (?, ?, 'final', ?)", [
-    spec.id,
-    JSON.stringify(allData),
-    now,
-  ]);
-
-  // Mostrar relatorio final completo
-  showReviewReport(spec, tasks, artifacts, decisions, knowledge, review);
-}
-
-/**
- * Pula o review e finaliza a feature diretamente
- */
-export function reviewSkip(): void {
-  initSchema();
-
-  const db = getDb();
-  const now = new Date().toISOString();
-
-  // Buscar spec em implementacao com todas tasks concluidas
-  const spec = db
-    .query("SELECT * FROM specs WHERE phase = 'implementing' ORDER BY created_at DESC LIMIT 1")
-    .get() as any;
-
-  if (!spec) {
-    console.error("\nNenhuma feature em fase de implementacao.\n");
-    process.exit(1);
-  }
-
-  // Verificar se todas tasks estao done
-  const pending = db
-    .query("SELECT COUNT(*) as c FROM tasks WHERE spec_id = ? AND status != 'done'")
-    .get(spec.id) as any;
-
-  if (pending.c > 0) {
-    console.error(`\nAinda existem ${pending.c} tasks pendentes.`);
-    console.error("Complete todas as tasks antes de pular o review.\n");
-    process.exit(1);
-  }
-
-  // Buscar dados
-  const tasks = db.query("SELECT * FROM tasks WHERE spec_id = ? ORDER BY number").all(spec.id) as any[];
-  const decisions = db.query("SELECT * FROM decisions WHERE spec_id = ?").all(spec.id) as any[];
-  const artifacts = db.query("SELECT * FROM artifacts WHERE spec_id = ?").all(spec.id) as any[];
-  const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(spec.id) as any;
-  const knowledge = db.query("SELECT * FROM knowledge WHERE spec_id = ?").all(spec.id) as any[];
-
-  // Criar registro de review como skipped
-  db.run(
-    `INSERT INTO review (spec_id, planned_vs_done, deviations, status, created_at)
-     VALUES (?, ?, NULL, 'skipped', ?)`,
-    [spec.id, JSON.stringify({ skipped: true, reason: "User chose to skip review" }), now]
-  );
-
-  // Atualizar spec para completed
-  db.run("UPDATE specs SET phase = 'completed', updated_at = ? WHERE id = ?", [now, spec.id]);
-
-  // Criar snapshot final
-  const review = db.query("SELECT * FROM review WHERE spec_id = ?").get(spec.id) as any;
-  const allData = {
-    spec,
-    context,
-    tasks,
-    decisions,
-    artifacts,
-    review,
-    knowledge,
-  };
-
-  db.run("INSERT INTO snapshots (spec_id, data, trigger, created_at) VALUES (?, ?, 'final', ?)", [
-    spec.id,
-    JSON.stringify(allData),
-    now,
-  ]);
-
-  console.log(`\n${"=".repeat(60)}`);
-  console.log(`FEATURE FINALIZADA (Review Pulado)`);
-  console.log(`${"=".repeat(60)}`);
-  console.log(`\n${spec.name}`);
-  console.log(`\nResumo:`);
-  console.log(`  Tasks: ${tasks.length}`);
-  console.log(`  Artefatos: ${artifacts.length}`);
-  console.log(`  Decisoes: ${decisions.length}`);
-  console.log(`\n⚠️  Review foi pulado pelo usuario.`);
-  console.log(`\nSpec ID: ${spec.id}`);
-  console.log(`Snapshot final criado.\n`);
-}
-
-/**
- * Mostra relatorio completo do review
- */
-function showReviewReport(
-  spec: any,
-  tasks: any[],
-  artifacts: any[],
-  decisions: any[],
-  knowledge: any[],
-  review: any
-): void {
-  const reviewData = review.planned_vs_done ? JSON.parse(review.planned_vs_done) : {};
-  const deviations = review.deviations ? JSON.parse(review.deviations) : [];
-
-  console.log(`\n${"═".repeat(60)}`);
-  console.log(`           RELATORIO FINAL DE REVIEW`);
-  console.log(`${"═".repeat(60)}`);
-
-  console.log(`\n📦 FEATURE: ${spec.name}`);
-  console.log(`   Status: ✅ COMPLETA E APROVADA`);
-  console.log(`   ID: ${spec.id}`);
-
-  // Resumo de execucao
-  console.log(`\n${"─".repeat(60)}`);
-  console.log(`📊 RESUMO DA EXECUCAO`);
-  console.log(`${"─".repeat(60)}`);
-
-  // Agrupar por agente
-  const tasksByAgent: Record<string, any[]> = {};
-  for (const task of tasks) {
-    const agent = task.agent || "geral";
-    if (!tasksByAgent[agent]) {
-      tasksByAgent[agent] = [];
-    }
-    tasksByAgent[agent].push(task);
-  }
-
-  console.log(`\n  Subagentes utilizados: ${Object.keys(tasksByAgent).length}`);
-  for (const [agent, agentTasks] of Object.entries(tasksByAgent)) {
-    console.log(`    • ${agent}: ${agentTasks.length} task(s)`);
-  }
-
-  console.log(`\n  Totais:`);
-  console.log(`    • Tasks executadas: ${tasks.length}`);
-  console.log(`    • Arquivos criados: ${artifacts.length}`);
-  console.log(`    • Decisoes tomadas: ${decisions.length}`);
-  console.log(`    • Knowledge items: ${knowledge.length}`);
-
-  // Tasks por agente com checkpoints
-  console.log(`\n${"─".repeat(60)}`);
-  console.log(`📋 TRABALHO REALIZADO POR SUBAGENTE`);
-  console.log(`${"─".repeat(60)}`);
-
-  for (const [agent, agentTasks] of Object.entries(tasksByAgent)) {
-    console.log(`\n  [${agent.toUpperCase()}]`);
-    for (const task of agentTasks) {
-      const status = task.status === "done" ? "✅" : "❌";
-      console.log(`    ${status} #${task.number}: ${task.name}`);
-      if (task.checkpoint) {
-        // Truncar checkpoint se muito longo
-        const checkpoint = task.checkpoint.length > 80
-          ? task.checkpoint.substring(0, 77) + "..."
-          : task.checkpoint;
-        console.log(`       └─ ${checkpoint}`);
-      }
-    }
-  }
-
-  // Artefatos criados
-  console.log(`\n${"─".repeat(60)}`);
-  console.log(`📁 ARTEFATOS CRIADOS`);
-  console.log(`${"─".repeat(60)}`);
-
-  for (const artifact of artifacts) {
-    const task = tasks.find((t) => t.number === artifact.task_ref);
-    const agentInfo = task?.agent ? ` (${task.agent})` : "";
-    console.log(`  • ${artifact.path}${agentInfo}`);
-  }
-
-  // Decisoes tomadas
-  if (decisions.length > 0) {
-    console.log(`\n${"─".repeat(60)}`);
-    console.log(`🎯 DECISOES ARQUITETADAS`);
-    console.log(`${"─".repeat(60)}`);
-
-    for (const dec of decisions) {
-      const task = tasks.find((t) => t.number === dec.task_ref);
-      const agentInfo = task?.agent ? ` [${task.agent}]` : "";
-      console.log(`\n  • ${dec.title}${agentInfo}`);
-      console.log(`    Decisao: ${dec.decision}`);
-      if (dec.rationale) {
-        console.log(`    Motivo: ${dec.rationale}`);
-      }
-    }
-  }
-
-  // Desvios encontrados
-  if (deviations.length > 0) {
-    console.log(`\n${"─".repeat(60)}`);
-    console.log(`⚠️  DESVIOS DO PLANO ORIGINAL`);
-    console.log(`${"─".repeat(60)}`);
-
-    for (const dev of deviations) {
-      console.log(`  • ${dev}`);
-    }
-  } else {
-    console.log(`\n${"─".repeat(60)}`);
-    console.log(`✅ CONFORMIDADE COM O PLANO`);
-    console.log(`${"─".repeat(60)}`);
-    console.log(`  Nenhum desvio encontrado. Implementacao seguiu o plano.`);
-  }
-
-  // v8.3: Design arquitetural original
-  const reviewArch = reviewData.architectural_analysis;
-  if (reviewArch) {
-    console.log(`\n${"─".repeat(60)}`);
-    console.log(`DESIGN ARQUITETURAL ORIGINAL`);
-    console.log(`${"─".repeat(60)}`);
-
-    console.log(`\n  Analise: ${reviewArch.name} (${reviewArch.id})`);
-
-    if (reviewArch.approach) {
-      const approachPreview = reviewArch.approach.length > 200
-        ? reviewArch.approach.substring(0, 200) + "..."
-        : reviewArch.approach;
-      console.log(`  Abordagem: ${approachPreview}`);
-    }
-
-    if (reviewArch.risks && reviewArch.risks.length > 0) {
-      console.log(`\n  Riscos identificados (${reviewArch.risks.length}):`);
-      for (const risk of reviewArch.risks) {
-        console.log(`    - [${risk.probability}/${risk.impact}] ${risk.description}`);
-        console.log(`      Mitigacao: ${risk.mitigation}`);
-      }
-    }
-
-    if (reviewArch.decisions && reviewArch.decisions.length > 0) {
-      console.log(`\n  Decisoes arquiteturais (${reviewArch.decisions.length}):`);
-      for (const d of reviewArch.decisions) {
-        console.log(`    - ${d.decision}: ${d.rationale || ''}`);
-      }
-    }
-
-    if (reviewArch.diagrams && reviewArch.diagrams.length > 0) {
-      console.log(`\n  Diagramas (${reviewArch.diagrams.length}):`);
-      for (const d of reviewArch.diagrams) {
-        console.log(`    - ${d.name || d.type || 'Diagrama'} (${d.type || 'mermaid'})`);
-      }
-    }
-  }
-
-  // v8.3: Gate bypasses (auditoria)
-  const bypasses = reviewData.gate_bypasses || [];
-  if (bypasses.length > 0) {
-    console.log(`\n${"─".repeat(60)}`);
-    console.log(`[!] GATE BYPASSES (${bypasses.length})`);
-    console.log(`${"─".repeat(60)}`);
-
-    for (const bypass of bypasses) {
-      console.log(`  - Gate "${bypass.gate_name}" (Task #${bypass.task_id})`);
-      console.log(`    Motivo: ${bypass.reason}`);
-      console.log(`    Data: ${bypass.created_at}`);
-    }
-  }
-
-  // v8.5: Utilities criadas (DRY audit)
-  const utilitiesCreated = reviewData.utilities_created || [];
-  if (utilitiesCreated.length > 0) {
-    console.log(`\n${"─".repeat(60)}`);
-    console.log(`UTILITIES CRIADAS (${utilitiesCreated.length})`);
-    console.log(`${"─".repeat(60)}`);
-    for (const u of utilitiesCreated) {
-      console.log(`  - ${u.utility_name} [${u.utility_type}] <- ${u.file_path}`);
-    }
-
-    // Alertar sobre DRY bypasses
-    const dryBypasses = (reviewData.gate_bypasses || []).filter((b: any) => b.gate_name === "dry-check");
-    if (dryBypasses.length > 0) {
-      console.log(`\n  [!] ${dryBypasses.length} bypass(es) de DRY gate:`);
-      for (const b of dryBypasses) {
-        console.log(`    Task #${b.task_id}: ${b.reason}`);
-      }
-    }
-  }
-
-  // Knowledge descoberto
-  const discoveries = knowledge.filter((k) => k.category === "discovery" || k.category === "pattern");
-  if (discoveries.length > 0) {
-    console.log(`\n${"─".repeat(60)}`);
-    console.log(`💡 DESCOBERTAS E PADROES`);
-    console.log(`${"─".repeat(60)}`);
-
-    for (const item of discoveries) {
-      const icon = item.severity === "critical" ? "🚨" : item.severity === "warning" ? "⚠️" : "ℹ️";
-      console.log(`  ${icon} ${item.content}`);
-    }
-  }
-
-  // Finalização
-  console.log(`\n${"═".repeat(60)}`);
-  console.log(`           FEATURE CONCLUIDA COM SUCESSO!`);
-  console.log(`${"═".repeat(60)}`);
-  console.log(`\n  Snapshot final criado para recuperacao futura.`);
-  console.log(`  Use 'recover --list' para ver snapshots disponiveis.\n`);
-}
+import { getDb } from "../db/connection";
+import { initSchema, getArchitecturalAnalysisForSpec } from "../db/schema";
+import { enforceGate } from "../gates/validator";
+
+export function reviewStart(json: boolean = false): void {
+  initSchema();
+  enforceGate("review-start");
+
+  const db = getDb();
+  const now = new Date().toISOString();
+
+  const spec = db
+    .query("SELECT * FROM specs WHERE phase = 'implementing' ORDER BY created_at DESC LIMIT 1")
+    .get() as any;
+
+  const tasks = db
+    .query("SELECT * FROM tasks WHERE spec_id = ? ORDER BY number")
+    .all(spec.id) as any[];
+
+  const artifacts = db
+    .query("SELECT * FROM artifacts WHERE spec_id = ?")
+    .all(spec.id) as any[];
+
+  const decisions = db
+    .query("SELECT * FROM decisions WHERE spec_id = ? AND status = 'active'")
+    .all(spec.id) as any[];
+
+  // v8.4: Buscar analise arquitetural (link explicito via analysis_id ou nome)
+  const archAnalysis = getArchitecturalAnalysisForSpec(spec.name, spec.id);
+  const gateBypasses = db.query(
+    "SELECT * FROM gate_bypasses WHERE spec_id = ? ORDER BY created_at"
+  ).all(spec.id) as any[];
+
+  // Analisar plano vs implementado
+  const plannedFiles = tasks.flatMap((t) => (t.files ? JSON.parse(t.files) : []));
+  const createdFiles = artifacts.map((a) => a.path);
+
+  const missingFiles = plannedFiles.filter((f: string) => !createdFiles.includes(f));
+  const extraFiles = createdFiles.filter((f) => !plannedFiles.includes(f));
+
+  const deviations: string[] = [];
+  if (missingFiles.length > 0) {
+    deviations.push(`Arquivos planejados nao criados: ${missingFiles.join(", ")}`);
+  }
+  if (extraFiles.length > 0) {
+    deviations.push(`Arquivos extras criados: ${extraFiles.join(", ")}`);
+  }
+
+  // Criar registro de review
+  const reviewData = {
+    tasks_completed: tasks.length,
+    artifacts_created: artifacts.length,
+    decisions_made: decisions.length,
+    planned_files: plannedFiles,
+    created_files: createdFiles,
+    // v8.3: Contexto arquitetural e auditoria
+    architectural_analysis: archAnalysis ? {
+      id: archAnalysis.id,
+      name: archAnalysis.name,
+      approach: archAnalysis.approach,
+      risks: archAnalysis.risks ? JSON.parse(archAnalysis.risks) : [],
+      diagrams: archAnalysis.diagrams ? JSON.parse(archAnalysis.diagrams) : [],
+      decisions: archAnalysis.decisions ? JSON.parse(archAnalysis.decisions) : [],
+    } : null,
+    gate_bypasses: gateBypasses,
+    // v8.5: Utilities criadas nesta feature (DRY audit)
+    utilities_created: (() => {
+      try {
+        return db.query(
+          "SELECT * FROM project_utilities WHERE spec_id = ? ORDER BY file_path"
+        ).all(spec.id) as any[];
+      } catch { return []; }
+    })(),
+  };
+
+  db.run(
+    `INSERT INTO review (spec_id, planned_vs_done, deviations, status, created_at)
+     VALUES (?, ?, ?, 'pending', ?)`,
+    [
+      spec.id,
+      JSON.stringify(reviewData),
+      deviations.length > 0 ? JSON.stringify(deviations) : null,
+      now,
+    ]
+  );
+
+  // Atualizar fase
+  db.run("UPDATE specs SET phase = 'reviewing', updated_at = ? WHERE id = ?", [now, spec.id]);
+
+  if (json) {
+    console.log(JSON.stringify({ spec, reviewData, deviations }));
+    return;
+  }
+
+  console.log(`\n${"=".repeat(60)}`);
+  console.log(`REVIEW: ${spec.name}`);
+  console.log(`${"=".repeat(60)}`);
+
+  console.log(`\nResumo da implementacao:`);
+  console.log(`  Tasks concluidas: ${tasks.length}`);
+  console.log(`  Artefatos criados: ${artifacts.length}`);
+  console.log(`  Decisoes tomadas: ${decisions.length}`);
+
+  console.log(`\nArquivos criados:`);
+  for (const artifact of artifacts) {
+    console.log(`  - ${artifact.path}`);
+  }
+
+  if (decisions.length > 0) {
+    console.log(`\nDecisoes:`);
+    for (const dec of decisions) {
+      console.log(`  ${dec.id}: ${dec.title}`);
+    }
+  }
+
+  if (deviations.length > 0) {
+    console.log(`\nDesvios encontrados:`);
+    for (const dev of deviations) {
+      console.log(`  - ${dev}`);
+    }
+    console.log(`\nResolva os desvios antes de aprovar.`);
+  } else {
+    console.log(`\nNenhum desvio encontrado.`);
+  }
+
+  console.log(`\nPara aprovar: review approve`);
+  console.log(`Para ver status: status\n`);
+}
+
+export function reviewApprove(): void {
+  initSchema();
+  enforceGate("review-approve");
+
+  const db = getDb();
+  const now = new Date().toISOString();
+
+  const spec = db
+    .query("SELECT * FROM specs WHERE phase = 'reviewing' ORDER BY created_at DESC LIMIT 1")
+    .get() as any;
+
+  if (!spec) {
+    console.error("\nNenhum review em andamento.\n");
+    process.exit(1);
+  }
+
+  // Atualizar review
+  db.run("UPDATE review SET status = 'passed' WHERE spec_id = ?", [spec.id]);
+
+  // Atualizar spec para completed
+  db.run("UPDATE specs SET phase = 'completed', updated_at = ? WHERE id = ?", [now, spec.id]);
+
+  // Buscar todos os dados para snapshot e relatorio
+  const tasks = db.query("SELECT * FROM tasks WHERE spec_id = ? ORDER BY number").all(spec.id) as any[];
+  const decisions = db.query("SELECT * FROM decisions WHERE spec_id = ?").all(spec.id) as any[];
+  const artifacts = db.query("SELECT * FROM artifacts WHERE spec_id = ?").all(spec.id) as any[];
+  const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(spec.id) as any;
+  const review = db.query("SELECT * FROM review WHERE spec_id = ?").get(spec.id) as any;
+  const knowledge = db.query("SELECT * FROM knowledge WHERE spec_id = ?").all(spec.id) as any[];
+
+  // Criar snapshot final
+  const allData = {
+    spec,
+    context,
+    tasks,
+    decisions,
+    artifacts,
+    review,
+    knowledge,
+  };
+
+  db.run("INSERT INTO snapshots (spec_id, data, trigger, created_at) VALUES (?, ?, 'final', ?)", [
+    spec.id,
+    JSON.stringify(allData),
+    now,
+  ]);
+
+  // Mostrar relatorio final completo
+  showReviewReport(spec, tasks, artifacts, decisions, knowledge, review);
+}
+
+/**
+ * Pula o review e finaliza a feature diretamente
+ */
+export function reviewSkip(): void {
+  initSchema();
+
+  const db = getDb();
+  const now = new Date().toISOString();
+
+  // Buscar spec em implementacao com todas tasks concluidas
+  const spec = db
+    .query("SELECT * FROM specs WHERE phase = 'implementing' ORDER BY created_at DESC LIMIT 1")
+    .get() as any;
+
+  if (!spec) {
+    console.error("\nNenhuma feature em fase de implementacao.\n");
+    process.exit(1);
+  }
+
+  // Verificar se todas tasks estao done
+  const pending = db
+    .query("SELECT COUNT(*) as c FROM tasks WHERE spec_id = ? AND status != 'done'")
+    .get(spec.id) as any;
+
+  if (pending.c > 0) {
+    console.error(`\nAinda existem ${pending.c} tasks pendentes.`);
+    console.error("Complete todas as tasks antes de pular o review.\n");
+    process.exit(1);
+  }
+
+  // Buscar dados
+  const tasks = db.query("SELECT * FROM tasks WHERE spec_id = ? ORDER BY number").all(spec.id) as any[];
+  const decisions = db.query("SELECT * FROM decisions WHERE spec_id = ?").all(spec.id) as any[];
+  const artifacts = db.query("SELECT * FROM artifacts WHERE spec_id = ?").all(spec.id) as any[];
+  const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(spec.id) as any;
+  const knowledge = db.query("SELECT * FROM knowledge WHERE spec_id = ?").all(spec.id) as any[];
+
+  // Criar registro de review como skipped
+  db.run(
+    `INSERT INTO review (spec_id, planned_vs_done, deviations, status, created_at)
+     VALUES (?, ?, NULL, 'skipped', ?)`,
+    [spec.id, JSON.stringify({ skipped: true, reason: "User chose to skip review" }), now]
+  );
+
+  // Atualizar spec para completed
+  db.run("UPDATE specs SET phase = 'completed', updated_at = ? WHERE id = ?", [now, spec.id]);
+
+  // Criar snapshot final
+  const review = db.query("SELECT * FROM review WHERE spec_id = ?").get(spec.id) as any;
+  const allData = {
+    spec,
+    context,
+    tasks,
+    decisions,
+    artifacts,
+    review,
+    knowledge,
+  };
+
+  db.run("INSERT INTO snapshots (spec_id, data, trigger, created_at) VALUES (?, ?, 'final', ?)", [
+    spec.id,
+    JSON.stringify(allData),
+    now,
+  ]);
+
+  console.log(`\n${"=".repeat(60)}`);
+  console.log(`FEATURE FINALIZADA (Review Pulado)`);
+  console.log(`${"=".repeat(60)}`);
+  console.log(`\n${spec.name}`);
+  console.log(`\nResumo:`);
+  console.log(`  Tasks: ${tasks.length}`);
+  console.log(`  Artefatos: ${artifacts.length}`);
+  console.log(`  Decisoes: ${decisions.length}`);
+  console.log(`\n⚠️  Review foi pulado pelo usuario.`);
+  console.log(`\nSpec ID: ${spec.id}`);
+  console.log(`Snapshot final criado.\n`);
+}
+
+/**
+ * Mostra relatorio completo do review
+ */
+function showReviewReport(
+  spec: any,
+  tasks: any[],
+  artifacts: any[],
+  decisions: any[],
+  knowledge: any[],
+  review: any
+): void {
+  const reviewData = review.planned_vs_done ? JSON.parse(review.planned_vs_done) : {};
+  const deviations = review.deviations ? JSON.parse(review.deviations) : [];
+
+  console.log(`\n${"═".repeat(60)}`);
+  console.log(`           RELATORIO FINAL DE REVIEW`);
+  console.log(`${"═".repeat(60)}`);
+
+  console.log(`\n📦 FEATURE: ${spec.name}`);
+  console.log(`   Status: ✅ COMPLETA E APROVADA`);
+  console.log(`   ID: ${spec.id}`);
+
+  // Resumo de execucao
+  console.log(`\n${"─".repeat(60)}`);
+  console.log(`📊 RESUMO DA EXECUCAO`);
+  console.log(`${"─".repeat(60)}`);
+
+  // Agrupar por agente
+  const tasksByAgent: Record<string, any[]> = {};
+  for (const task of tasks) {
+    const agent = task.agent || "geral";
+    if (!tasksByAgent[agent]) {
+      tasksByAgent[agent] = [];
+    }
+    tasksByAgent[agent].push(task);
+  }
+
+  console.log(`\n  Subagentes utilizados: ${Object.keys(tasksByAgent).length}`);
+  for (const [agent, agentTasks] of Object.entries(tasksByAgent)) {
+    console.log(`    • ${agent}: ${agentTasks.length} task(s)`);
+  }
+
+  console.log(`\n  Totais:`);
+  console.log(`    • Tasks executadas: ${tasks.length}`);
+  console.log(`    • Arquivos criados: ${artifacts.length}`);
+  console.log(`    • Decisoes tomadas: ${decisions.length}`);
+  console.log(`    • Knowledge items: ${knowledge.length}`);
+
+  // Tasks por agente com checkpoints
+  console.log(`\n${"─".repeat(60)}`);
+  console.log(`📋 TRABALHO REALIZADO POR SUBAGENTE`);
+  console.log(`${"─".repeat(60)}`);
+
+  for (const [agent, agentTasks] of Object.entries(tasksByAgent)) {
+    console.log(`\n  [${agent.toUpperCase()}]`);
+    for (const task of agentTasks) {
+      const status = task.status === "done" ? "✅" : "❌";
+      console.log(`    ${status} #${task.number}: ${task.name}`);
+      if (task.checkpoint) {
+        // Truncar checkpoint se muito longo
+        const checkpoint = task.checkpoint.length > 80
+          ? task.checkpoint.substring(0, 77) + "..."
+          : task.checkpoint;
+        console.log(`       └─ ${checkpoint}`);
+      }
+    }
+  }
+
+  // Artefatos criados
+  console.log(`\n${"─".repeat(60)}`);
+  console.log(`📁 ARTEFATOS CRIADOS`);
+  console.log(`${"─".repeat(60)}`);
+
+  for (const artifact of artifacts) {
+    const task = tasks.find((t) => t.number === artifact.task_ref);
+    const agentInfo = task?.agent ? ` (${task.agent})` : "";
+    console.log(`  • ${artifact.path}${agentInfo}`);
+  }
+
+  // Decisoes tomadas
+  if (decisions.length > 0) {
+    console.log(`\n${"─".repeat(60)}`);
+    console.log(`🎯 DECISOES ARQUITETADAS`);
+    console.log(`${"─".repeat(60)}`);
+
+    for (const dec of decisions) {
+      const task = tasks.find((t) => t.number === dec.task_ref);
+      const agentInfo = task?.agent ? ` [${task.agent}]` : "";
+      console.log(`\n  • ${dec.title}${agentInfo}`);
+      console.log(`    Decisao: ${dec.decision}`);
+      if (dec.rationale) {
+        console.log(`    Motivo: ${dec.rationale}`);
+      }
+    }
+  }
+
+  // Desvios encontrados
+  if (deviations.length > 0) {
+    console.log(`\n${"─".repeat(60)}`);
+    console.log(`⚠️  DESVIOS DO PLANO ORIGINAL`);
+    console.log(`${"─".repeat(60)}`);
+
+    for (const dev of deviations) {
+      console.log(`  • ${dev}`);
+    }
+  } else {
+    console.log(`\n${"─".repeat(60)}`);
+    console.log(`✅ CONFORMIDADE COM O PLANO`);
+    console.log(`${"─".repeat(60)}`);
+    console.log(`  Nenhum desvio encontrado. Implementacao seguiu o plano.`);
+  }
+
+  // v8.3: Design arquitetural original
+  const reviewArch = reviewData.architectural_analysis;
+  if (reviewArch) {
+    console.log(`\n${"─".repeat(60)}`);
+    console.log(`DESIGN ARQUITETURAL ORIGINAL`);
+    console.log(`${"─".repeat(60)}`);
+
+    console.log(`\n  Analise: ${reviewArch.name} (${reviewArch.id})`);
+
+    if (reviewArch.approach) {
+      const approachPreview = reviewArch.approach.length > 200
+        ? reviewArch.approach.substring(0, 200) + "..."
+        : reviewArch.approach;
+      console.log(`  Abordagem: ${approachPreview}`);
+    }
+
+    if (reviewArch.risks && reviewArch.risks.length > 0) {
+      console.log(`\n  Riscos identificados (${reviewArch.risks.length}):`);
+      for (const risk of reviewArch.risks) {
+        console.log(`    - [${risk.probability}/${risk.impact}] ${risk.description}`);
+        console.log(`      Mitigacao: ${risk.mitigation}`);
+      }
+    }
+
+    if (reviewArch.decisions && reviewArch.decisions.length > 0) {
+      console.log(`\n  Decisoes arquiteturais (${reviewArch.decisions.length}):`);
+      for (const d of reviewArch.decisions) {
+        console.log(`    - ${d.decision}: ${d.rationale || ''}`);
+      }
+    }
+
+    if (reviewArch.diagrams && reviewArch.diagrams.length > 0) {
+      console.log(`\n  Diagramas (${reviewArch.diagrams.length}):`);
+      for (const d of reviewArch.diagrams) {
+        console.log(`    - ${d.name || d.type || 'Diagrama'} (${d.type || 'mermaid'})`);
+      }
+    }
+  }
+
+  // v8.3: Gate bypasses (auditoria)
+  const bypasses = reviewData.gate_bypasses || [];
+  if (bypasses.length > 0) {
+    console.log(`\n${"─".repeat(60)}`);
+    console.log(`[!] GATE BYPASSES (${bypasses.length})`);
+    console.log(`${"─".repeat(60)}`);
+
+    for (const bypass of bypasses) {
+      console.log(`  - Gate "${bypass.gate_name}" (Task #${bypass.task_id})`);
+      console.log(`    Motivo: ${bypass.reason}`);
+      console.log(`    Data: ${bypass.created_at}`);
+    }
+  }
+
+  // v8.5: Utilities criadas (DRY audit)
+  const utilitiesCreated = reviewData.utilities_created || [];
+  if (utilitiesCreated.length > 0) {
+    console.log(`\n${"─".repeat(60)}`);
+    console.log(`UTILITIES CRIADAS (${utilitiesCreated.length})`);
+    console.log(`${"─".repeat(60)}`);
+    for (const u of utilitiesCreated) {
+      console.log(`  - ${u.utility_name} [${u.utility_type}] <- ${u.file_path}`);
+    }
+
+    // Alertar sobre DRY bypasses
+    const dryBypasses = (reviewData.gate_bypasses || []).filter((b: any) => b.gate_name === "dry-check");
+    if (dryBypasses.length > 0) {
+      console.log(`\n  [!] ${dryBypasses.length} bypass(es) de DRY gate:`);
+      for (const b of dryBypasses) {
+        console.log(`    Task #${b.task_id}: ${b.reason}`);
+      }
+    }
+  }
+
+  // Knowledge descoberto
+  const discoveries = knowledge.filter((k) => k.category === "discovery" || k.category === "pattern");
+  if (discoveries.length > 0) {
+    console.log(`\n${"─".repeat(60)}`);
+    console.log(`💡 DESCOBERTAS E PADROES`);
+    console.log(`${"─".repeat(60)}`);
+
+    for (const item of discoveries) {
+      const icon = item.severity === "critical" ? "🚨" : item.severity === "warning" ? "⚠️" : "ℹ️";
+      console.log(`  ${icon} ${item.content}`);
+    }
+  }
+
+  // Finalização
+  console.log(`\n${"═".repeat(60)}`);
+  console.log(`           FEATURE CONCLUIDA COM SUCESSO!`);
+  console.log(`${"═".repeat(60)}`);
+  console.log(`\n  Snapshot final criado para recuperacao futura.`);
+  console.log(`  Use 'recover --list' para ver snapshots disponiveis.\n`);
+}