@codexa/cli 8.6.0 → 8.6.9

package/commands/architect.ts

@@ -1,760 +1,760 @@
-import { getDb } from "../db/connection";
-import { initSchema } from "../db/schema";
-import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
-import { join } from "path";
-
-// ═══════════════════════════════════════════════════════════════
-// TYPES
-// ═══════════════════════════════════════════════════════════════
-
-interface BabyStep {
-  number: number;
-  name: string;
-  what: string;
-  why: string;
-  result: string;
-  files: string[];
-  agent: string;
-  dependsOn?: number[];
-}
-
-interface Risk {
-  id: string;
-  description: string;
-  probability: "low" | "medium" | "high";
-  impact: "low" | "medium" | "high";
-  mitigation: string;
-}
-
-interface Alternative {
-  name: string;
-  description: string;
-  pros: string[];
-  cons: string[];
-  complexity: "low" | "medium" | "high";
-  whyDiscarded?: string;
-}
-
-interface ArchitecturalDecision {
-  decision: string;
-  rationale: string;
-}
-
-interface ArchitecturalAnalysis {
-  id: string;
-  name: string;
-  description: string;
-  status: "pending" | "approved" | "implemented" | "rejected";
-
-  // Contexto
-  context: string;
-  currentArchitecture: string;
-
-  // Solucao
-  approach: string;
-  chosenAlternative: string;
-
-  // Diagramas (Mermaid)
-  diagrams: {
-    name: string;
-    type: string;
-    content: string;
-  }[];
-
-  // Baby Steps
-  babySteps: BabyStep[];
-
-  // Riscos
-  risks: Risk[];
-
-  // Alternativas
-  alternatives: Alternative[];
-
-  // Decisoes
-  decisions: ArchitecturalDecision[];
-
-  // Metadados
-  filePath?: string;
-  createdAt: string;
-  updatedAt?: string;
-  approvedAt?: string;
-}
-
-// ═══════════════════════════════════════════════════════════════
-// HELPERS
-// ═══════════════════════════════════════════════════════════════
-
-function generateId(): string {
-  const timestamp = Date.now().toString(36);
-  const random = Math.random().toString(36).substring(2, 6);
-  return `ARCH-${timestamp}-${random}`.toUpperCase();
-}
-
-function ensureAnalysisDir(): string {
-  const dir = ".codexa/analysis";
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-  return dir;
-}
-
-function formatDate(date: Date): string {
-  return date.toISOString().split("T")[0];
-}
-
-// ═══════════════════════════════════════════════════════════════
-// MARKDOWN PARSER (v8.4)
-// ═══════════════════════════════════════════════════════════════
-
-function extractSection(content: string, header: string): string {
-  // Split por headers ## e encontrar a secao correta
-  const sections = content.split(/^## /m);
-  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();
-    }
-  }
-  return "";
-}
-
-function parseBabySteps(section: string): BabyStep[] {
-  if (!section) return [];
-  const steps: BabyStep[] = [];
-  // Match "### N. Name" or "### Step N: Name"
-  const stepBlocks = section.split(/^###\s+/m).filter(Boolean);
-
-  for (const block of stepBlocks) {
-    const headerMatch = block.match(/^(?:Step\s+)?(\d+)[.:]\s*(.+)/);
-    if (!headerMatch) continue;
-
-    const number = parseInt(headerMatch[1]);
-    const name = headerMatch[2].trim();
-    const what = block.match(/\*\*O que\*\*:\s*(.+)/)?.[1]?.trim() || "";
-    const why = block.match(/\*\*Por que\*\*:\s*(.+)/)?.[1]?.trim() || "";
-    const result = block.match(/\*\*Resultado\*\*:\s*(.+)/)?.[1]?.trim() || "";
-    const filesStr = block.match(/\*\*Arquivos?\*\*:\s*(.+)/)?.[1]?.trim() || "";
-    const agent = block.match(/\*\*Agente\*\*:\s*(.+)/)?.[1]?.trim() || "general";
-    const depsStr = block.match(/\*\*Depende de\*\*:\s*(.+)/)?.[1]?.trim() || "";
-
-    const files = filesStr
-      ? filesStr.split(/[,;]/).map(f => f.trim().replace(/`/g, "")).filter(Boolean)
-      : [];
-
-    const dependsOn = depsStr
-      ? (depsStr.match(/\d+/g) || []).map(Number)
-      : [];
-
-    steps.push({ number, name, what, why, result, files, agent, dependsOn: dependsOn.length > 0 ? dependsOn : undefined });
-  }
-
-  return steps;
-}
-
-function parseRisks(section: string): Risk[] {
-  if (!section) return [];
-  const risks: Risk[] = [];
-  const riskBlocks = section.split(/^###\s+/m).filter(Boolean);
-
-  for (const block of riskBlocks) {
-    const headerMatch = block.match(/^R?(\d+)[.:]\s*(.+)/);
-    if (!headerMatch) continue;
-
-    const id = `R${headerMatch[1]}`;
-    const description = headerMatch[2].trim();
-    const probability = (block.match(/\*\*Probabilidade\*\*:\s*(\w+)/)?.[1]?.trim() || "medium") as Risk["probability"];
-    const impact = (block.match(/\*\*Impacto\*\*:\s*(\w+)/)?.[1]?.trim() || "medium") as Risk["impact"];
-    const mitigation = block.match(/\*\*Mitiga[cç][aã]o\*\*:\s*(.+)/)?.[1]?.trim() || "";
-
-    risks.push({ id, description, probability, impact, mitigation });
-  }
-
-  return risks;
-}
-
-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;
-  let match;
-
-  while ((match = diagramRegex.exec(section)) !== null) {
-    const content = match[2].trim();
-    const typeMatch = content.match(/^(\w+)/);
-    diagrams.push({
-      name: match[1].trim(),
-      type: typeMatch ? typeMatch[1] : "flowchart",
-      content,
-    });
-  }
-
-  return diagrams;
-}
-
-function parseDecisionsTable(section: string): ArchitecturalDecision[] {
-  if (!section) return [];
-  const decisions: ArchitecturalDecision[] = [];
-  const lines = section.split("\n");
-
-  for (const line of lines) {
-    // Match table rows: | Decision | Rationale |
-    const rowMatch = line.match(/^\|\s*([^|]+)\s*\|\s*([^|]+)\s*\|$/);
-    if (!rowMatch) continue;
-    const decision = rowMatch[1].trim();
-    const rationale = rowMatch[2].trim();
-    // Skip header and separator rows
-    if (decision === "Decisao" || decision.startsWith("---")) continue;
-    if (decision && rationale) {
-      decisions.push({ decision, rationale });
-    }
-  }
-
-  return decisions;
-}
-
-function parseAlternatives(section: string): Alternative[] {
-  if (!section) return [];
-  const alternatives: Alternative[] = [];
-  const altBlocks = section.split(/^###\s+/m).filter(Boolean);
-
-  for (const block of altBlocks) {
-    const name = block.split("\n")[0]?.trim();
-    if (!name) continue;
-
-    const description = block.match(/\*\*Descri[cç][aã]o\*\*:\s*(.+)/)?.[1]?.trim() || "";
-    const whyDiscarded = block.match(/\*\*Por que descartada\*\*:\s*(.+)/)?.[1]?.trim() || "";
-
-    alternatives.push({
-      name,
-      description,
-      pros: [],
-      cons: [],
-      complexity: "medium",
-      whyDiscarded: whyDiscarded || undefined,
-    });
-  }
-
-  return alternatives;
-}
-
-/**
- * v8.4: Parseia um arquivo .md de analise arquitetural e extrai dados estruturados.
- * O .md deve seguir o template padrao do codexa:architect.
- */
-export function parseAnalysisMd(content: string): {
-  context: string;
-  currentArchitecture: string;
-  approach: string;
-  diagrams: { name: string; type: string; content: string }[];
-  babySteps: BabyStep[];
-  risks: Risk[];
-  alternatives: Alternative[];
-  decisions: ArchitecturalDecision[];
-} {
-  const context = extractSection(content, "Contexto e Entendimento");
-  const currentArchitecture = extractSection(content, "Stack e Arquitetura Atual");
-  const approach = extractSection(content, "Solucao Proposta");
-
-  const diagramsSection = extractSection(content, "Diagramas");
-  const diagrams = parseDiagrams(diagramsSection);
-
-  const babyStepsSection = extractSection(content, "Baby Steps");
-  const babySteps = parseBabySteps(babyStepsSection);
-
-  const risksSection = extractSection(content, "Riscos e Mitigacoes");
-  const risks = parseRisks(risksSection);
-
-  const alternativesSection = extractSection(content, "Alternativas Descartadas");
-  const alternatives = parseAlternatives(alternativesSection);
-
-  const decisionsSection = extractSection(content, "Decisoes Arquiteturais");
-  const decisions = parseDecisionsTable(decisionsSection);
-
-  return { context, currentArchitecture, approach, diagrams, babySteps, risks, alternatives, decisions };
-}
-
-// ═══════════════════════════════════════════════════════════════
-// COMMANDS
-// ═══════════════════════════════════════════════════════════════
-
-export function architectStart(description: string, options: { json?: boolean } = {}): void {
-  initSchema();
-  const db = getDb();
-  const now = new Date().toISOString();
-  const id = generateId();
-
-  // Verificar se ja existe analise pendente
-  const pending = db.query(
-    "SELECT * FROM architectural_analyses WHERE status = 'pending' ORDER BY created_at DESC LIMIT 1"
-  ).get() as any;
-
-  if (pending) {
-    if (options.json) {
-      console.log(JSON.stringify({
-        error: "ANALYSIS_ACTIVE",
-        message: "Ja existe uma analise pendente",
-        analysis: {
-          id: pending.id,
-          name: pending.name,
-          createdAt: pending.created_at,
-        },
-      }));
-    } else {
-      console.log("\n[ERRO] Ja existe uma analise pendente.\n");
-      console.log(`  ID: ${pending.id}`);
-      console.log(`  Nome: ${pending.name}`);
-      console.log(`  Criada: ${pending.created_at}`);
-      console.log("\nUse 'architect show' para ver detalhes ou 'architect cancel' para cancelar.\n");
-    }
-    process.exit(1);
-  }
-
-  // Criar nova analise
-  db.run(
-    `INSERT INTO architectural_analyses (id, name, description, status, created_at)
-     VALUES (?, ?, ?, 'pending', ?)`,
-    [id, description, description, now]
-  );
-
-  if (options.json) {
-    console.log(JSON.stringify({
-      success: true,
-      analysis: {
-        id,
-        name: description,
-        status: "pending",
-        createdAt: now,
-      },
-      nextSteps: [
-        "Explorar codebase com deep-explore",
-        "Analisar arquitetura atual",
-        "Propor solucoes com trade-offs",
-        "Escrever .md em .codexa/analysis/",
-        "Registrar com 'architect save --file <path>'",
-        "Aprovar com 'architect approve'",
-      ],
-    }));
-  } else {
-    console.log("\n╔════════════════════════════════════════════════════════════╗");
-    console.log("║  ANALISE ARQUITETURAL INICIADA                             ║");
-    console.log("╚════════════════════════════════════════════════════════════╝\n");
-    console.log(`  ID: ${id}`);
-    console.log(`  Descricao: ${description}`);
-    console.log(`  Status: pending`);
-    console.log("\n  Proximos passos:");
-    console.log("  1. Explorar codebase com deep-explore");
-    console.log("  2. Analisar arquitetura atual");
-    console.log("  3. Propor solucoes com trade-offs");
-    console.log("  4. Escrever .md em .codexa/analysis/");
-    console.log("  5. Registrar: architect save --file <path>");
-    console.log("  6. Aprovar: architect approve\n");
-  }
-}
-
-export function architectShow(options: { id?: string; json?: boolean } = {}): void {
-  initSchema();
-  const db = getDb();
-
-  let analysis: any;
-
-  if (options.id) {
-    analysis = db.query("SELECT * FROM architectural_analyses WHERE id = ?").get(options.id);
-  } else {
-    // Pegar a mais recente pendente ou a ultima
-    analysis = db.query(
-      "SELECT * FROM architectural_analyses WHERE status = 'pending' ORDER BY created_at DESC LIMIT 1"
-    ).get();
-
-    if (!analysis) {
-      analysis = db.query(
-        "SELECT * FROM architectural_analyses ORDER BY created_at DESC LIMIT 1"
-      ).get();
-    }
-  }
-
-  if (!analysis) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: "NO_ANALYSIS", message: "Nenhuma analise encontrada" }));
-    } else {
-      console.log("\n[INFO] Nenhuma analise arquitetural encontrada.");
-      console.log("Use 'architect start <descricao>' para iniciar.\n");
-    }
-    return;
-  }
-
-  // Parse JSON fields
-  const parsed: ArchitecturalAnalysis = {
-    id: analysis.id,
-    name: analysis.name,
-    description: analysis.description,
-    status: analysis.status,
-    context: analysis.context || "",
-    currentArchitecture: analysis.current_architecture || "",
-    approach: analysis.approach || "",
-    chosenAlternative: analysis.chosen_alternative || "",
-    diagrams: analysis.diagrams ? JSON.parse(analysis.diagrams) : [],
-    babySteps: analysis.baby_steps ? JSON.parse(analysis.baby_steps) : [],
-    risks: analysis.risks ? JSON.parse(analysis.risks) : [],
-    alternatives: analysis.alternatives ? JSON.parse(analysis.alternatives) : [],
-    decisions: analysis.decisions ? JSON.parse(analysis.decisions) : [],
-    filePath: analysis.file_path,
-    createdAt: analysis.created_at,
-    updatedAt: analysis.updated_at,
-    approvedAt: analysis.approved_at,
-  };
-
-  if (options.json) {
-    console.log(JSON.stringify(parsed, null, 2));
-  } else {
-    console.log("\n╔════════════════════════════════════════════════════════════╗");
-    console.log("║  ANALISE ARQUITETURAL                                      ║");
-    console.log("╚════════════════════════════════════════════════════════════╝\n");
-
-    console.log(`  ID: ${parsed.id}`);
-    console.log(`  Nome: ${parsed.name}`);
-    console.log(`  Status: ${parsed.status}`);
-    console.log(`  Criada: ${parsed.createdAt}`);
-
-    if (parsed.filePath) {
-      console.log(`  Arquivo: ${parsed.filePath}`);
-    }
-
-    if (parsed.approach) {
-      console.log(`\n  Abordagem: ${parsed.approach}`);
-    }
-
-    if (parsed.babySteps.length > 0) {
-      console.log(`\n  Baby Steps: ${parsed.babySteps.length}`);
-      parsed.babySteps.forEach((step, i) => {
-        console.log(`    ${i + 1}. ${step.name} [${step.agent}]`);
-      });
-    }
-
-    if (parsed.risks.length > 0) {
-      console.log(`\n  Riscos: ${parsed.risks.length}`);
-      parsed.risks.forEach((risk) => {
-        console.log(`    - ${risk.description} (${risk.probability}/${risk.impact})`);
-      });
-    }
-
-    if (parsed.diagrams.length > 0) {
-      console.log(`\n  Diagramas: ${parsed.diagrams.length}`);
-      parsed.diagrams.forEach((d) => {
-        console.log(`    - ${d.name} (${d.type})`);
-      });
-    }
-
-    console.log("");
-  }
-}
-
-export function architectList(options: { json?: boolean; status?: string } = {}): void {
-  initSchema();
-  const db = getDb();
-
-  let query = "SELECT id, name, status, created_at, file_path FROM architectural_analyses";
-  const params: any[] = [];
-
-  if (options.status) {
-    query += " WHERE status = ?";
-    params.push(options.status);
-  }
-
-  query += " ORDER BY created_at DESC";
-
-  const analyses = db.query(query).all(...params) as any[];
-
-  if (options.json) {
-    console.log(JSON.stringify(analyses, null, 2));
-  } else {
-    if (analyses.length === 0) {
-      console.log("\n[INFO] Nenhuma analise arquitetural encontrada.\n");
-      return;
-    }
-
-    console.log("\n╔════════════════════════════════════════════════════════════╗");
-    console.log("║  ANALISES ARQUITETURAIS                                    ║");
-    console.log("╚════════════════════════════════════════════════════════════╝\n");
-
-    analyses.forEach((a) => {
-      const statusIcon =
-        a.status === "approved" ? "✓" :
-        a.status === "implemented" ? "★" :
-        a.status === "rejected" ? "✗" : "○";
-
-      console.log(`  ${statusIcon} [${a.id}] ${a.name}`);
-      console.log(`    Status: ${a.status} | Criada: ${a.created_at}`);
-      if (a.file_path) {
-        console.log(`    Arquivo: ${a.file_path}`);
-      }
-      console.log("");
-    });
-  }
-}
-
-export function architectSave(options: { file?: string; json?: boolean }): void {
-  initSchema();
-  const db = getDb();
-  const now = new Date().toISOString();
-
-  // Pegar analise pendente
-  const analysis = db.query(
-    "SELECT * FROM architectural_analyses WHERE status = 'pending' ORDER BY created_at DESC LIMIT 1"
-  ).get() as any;
-
-  if (!analysis) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: "NO_PENDING", message: "Nenhuma analise pendente" }));
-    } else {
-      console.log("\n[ERRO] Nenhuma analise pendente encontrada.\n");
-    }
-    process.exit(1);
-  }
-
-  // v8.4: Resolver caminho do arquivo .md
-  const dir = ensureAnalysisDir();
-  let filePath: string;
-  if (options.file) {
-    // Se path fornecido, usar como-is (aceita absoluto ou relativo)
-    filePath = options.file;
-  } else {
-    filePath = join(dir, `${analysis.id}-${analysis.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").substring(0, 30)}.md`);
-  }
-
-  // v8.4: Ler .md do disco e parsear para popular o DB
-  if (!existsSync(filePath)) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: "FILE_NOT_FOUND", message: `Arquivo nao encontrado: ${filePath}` }));
-    } else {
-      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);
-  }
-
-  const content = readFileSync(filePath, "utf-8");
-  const parsed = parseAnalysisMd(content);
-
-  // Popular DB com dados extraidos do .md
-  const updates: string[] = [];
-  const values: any[] = [];
-
-  if (parsed.context) {
-    updates.push("context = ?");
-    values.push(parsed.context);
-  }
-  if (parsed.currentArchitecture) {
-    updates.push("current_architecture = ?");
-    values.push(parsed.currentArchitecture);
-  }
-  if (parsed.approach) {
-    updates.push("approach = ?");
-    values.push(parsed.approach);
-  }
-  if (parsed.diagrams.length > 0) {
-    updates.push("diagrams = ?");
-    values.push(JSON.stringify(parsed.diagrams));
-  }
-  if (parsed.babySteps.length > 0) {
-    updates.push("baby_steps = ?");
-    values.push(JSON.stringify(parsed.babySteps));
-  }
-  if (parsed.risks.length > 0) {
-    updates.push("risks = ?");
-    values.push(JSON.stringify(parsed.risks));
-  }
-  if (parsed.alternatives.length > 0) {
-    updates.push("alternatives = ?");
-    values.push(JSON.stringify(parsed.alternatives));
-  }
-  if (parsed.decisions.length > 0) {
-    updates.push("decisions = ?");
-    values.push(JSON.stringify(parsed.decisions));
-  }
-
-  updates.push("file_path = ?");
-  values.push(filePath);
-  updates.push("updated_at = ?");
-  values.push(now);
-  values.push(analysis.id);
-
-  db.run(
-    `UPDATE architectural_analyses SET ${updates.join(", ")} WHERE id = ?`,
-    values
-  );
-
-  if (options.json) {
-    console.log(JSON.stringify({
-      success: true,
-      id: analysis.id,
-      filePath,
-      parsed: {
-        babySteps: parsed.babySteps.length,
-        risks: parsed.risks.length,
-        diagrams: parsed.diagrams.length,
-        decisions: parsed.decisions.length,
-        hasApproach: !!parsed.approach,
-        hasContext: !!parsed.context,
-      },
-    }));
-  } else {
-    console.log("\n╔════════════════════════════════════════════════════════════╗");
-    console.log("║  ANALISE SALVA (parseada do .md)                           ║");
-    console.log("╚════════════════════════════════════════════════════════════╝\n");
-    console.log(`  Arquivo: ${filePath}`);
-    console.log(`  Baby Steps: ${parsed.babySteps.length}`);
-    console.log(`  Riscos: ${parsed.risks.length}`);
-    console.log(`  Diagramas: ${parsed.diagrams.length}`);
-    console.log(`  Decisoes: ${parsed.decisions.length}`);
-    if (!parsed.approach) {
-      console.log("\n  [AVISO] Secao 'Solucao Proposta' nao encontrada no .md");
-    }
-    if (parsed.babySteps.length === 0) {
-      console.log("  [AVISO] Nenhum baby step encontrado. Verifique formato '### N. Nome'");
-    }
-    console.log("\n  Proximo passo:");
-    console.log(`  - Aprovar: architect approve`);
-    console.log(`  - Iniciar feature: plan start "nome" --from-analysis ${analysis.id}\n`);
-  }
-}
-
-export function architectApprove(options: { id?: string; json?: boolean }): void {
-  initSchema();
-  const db = getDb();
-  const now = new Date().toISOString();
-
-  let analysis: any;
-
-  if (options.id) {
-    analysis = db.query("SELECT * FROM architectural_analyses WHERE id = ?").get(options.id);
-  } else {
-    analysis = db.query(
-      "SELECT * FROM architectural_analyses WHERE status = 'pending' ORDER BY created_at DESC LIMIT 1"
-    ).get();
-  }
-
-  if (!analysis) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: "NOT_FOUND", message: "Analise nao encontrada" }));
-    } else {
-      console.log("\n[ERRO] Analise nao encontrada.\n");
-    }
-    process.exit(1);
-  }
-
-  if (analysis.status !== "pending") {
-    if (options.json) {
-      console.log(JSON.stringify({ error: "INVALID_STATUS", message: `Analise ja esta ${analysis.status}` }));
-    } else {
-      console.log(`\n[ERRO] Analise ja esta com status '${analysis.status}'.\n`);
-    }
-    process.exit(1);
-  }
-
-  db.run(
-    "UPDATE architectural_analyses SET status = 'approved', approved_at = ?, updated_at = ? WHERE id = ?",
-    [now, now, analysis.id]
-  );
-
-  if (options.json) {
-    console.log(JSON.stringify({
-      success: true,
-      id: analysis.id,
-      status: "approved",
-      nextStep: `plan start "${analysis.name}" --from-analysis ${analysis.id}`,
-    }));
-  } else {
-    console.log(`\n[OK] Analise ${analysis.id} aprovada.`);
-    console.log(`\nInicie a feature com import automatico dos baby steps:`);
-    console.log(`  plan start "${analysis.name}" --from-analysis ${analysis.id}\n`);
-  }
-}
-
-// v8.4: Simplificado - agora o feature importa baby steps automaticamente via --from-analysis
-export function architectExport(options: { id?: string; json?: boolean }): void {
-  initSchema();
-  const db = getDb();
-
-  let analysis: any;
-
-  if (options.id) {
-    analysis = db.query("SELECT * FROM architectural_analyses WHERE id = ?").get(options.id);
-  } else {
-    analysis = db.query(
-      "SELECT * FROM architectural_analyses WHERE status = 'approved' ORDER BY approved_at DESC LIMIT 1"
-    ).get();
-  }
-
-  if (!analysis) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: "NOT_FOUND", message: "Nenhuma analise aprovada encontrada" }));
-    } else {
-      console.log("\n[ERRO] Nenhuma analise aprovada encontrada.");
-      console.log("Use 'architect approve' primeiro.\n");
-    }
-    process.exit(1);
-  }
-
-  const babySteps: BabyStep[] = analysis.baby_steps ? JSON.parse(analysis.baby_steps) : [];
-  const planCmd = `codexa plan start "${analysis.name}" --from-analysis ${analysis.id}`;
-
-  if (options.json) {
-    console.log(JSON.stringify({
-      analysisId: analysis.id,
-      analysisName: analysis.name,
-      babyStepsCount: babySteps.length,
-      filePath: analysis.file_path || null,
-      planStartCommand: planCmd,
-    }));
-  } else {
-    console.log("\n╔════════════════════════════════════════════════════════════╗");
-    console.log("║  EXPORTAR PARA FEATURE                                     ║");
-    console.log("╚════════════════════════════════════════════════════════════╝\n");
-
-    console.log(`  Analise: ${analysis.name} (${analysis.id})`);
-    console.log(`  Baby Steps: ${babySteps.length}`);
-    if (analysis.file_path) {
-      console.log(`  Arquivo: ${analysis.file_path}`);
-    }
-
-    console.log(`\n  Comando para iniciar feature com import automatico:`);
-    console.log(`  ${planCmd}\n`);
-  }
-}
-
-export function architectCancel(options: { id?: string; json?: boolean }): void {
-  initSchema();
-  const db = getDb();
-  const now = new Date().toISOString();
-
-  let analysis: any;
-
-  if (options.id) {
-    analysis = db.query("SELECT * FROM architectural_analyses WHERE id = ?").get(options.id);
-  } else {
-    analysis = db.query(
-      "SELECT * FROM architectural_analyses WHERE status = 'pending' ORDER BY created_at DESC LIMIT 1"
-    ).get();
-  }
-
-  if (!analysis) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: "NOT_FOUND", message: "Nenhuma analise pendente encontrada" }));
-    } else {
-      console.log("\n[INFO] Nenhuma analise pendente para cancelar.\n");
-    }
-    return;
-  }
-
-  db.run(
-    "UPDATE architectural_analyses SET status = 'rejected', updated_at = ? WHERE id = ?",
-    [now, analysis.id]
-  );
-
-  if (options.json) {
-    console.log(JSON.stringify({ success: true, id: analysis.id, status: "rejected" }));
-  } else {
-    console.log(`\n[OK] Analise ${analysis.id} cancelada.\n`);
-  }
-}
+import { getDb } from "../db/connection";
+import { initSchema } from "../db/schema";
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
+import { join } from "path";
+
+// ═══════════════════════════════════════════════════════════════
+// TYPES
+// ═══════════════════════════════════════════════════════════════
+
+interface BabyStep {
+  number: number;
+  name: string;
+  what: string;
+  why: string;
+  result: string;
+  files: string[];
+  agent: string;
+  dependsOn?: number[];
+}
+
+interface Risk {
+  id: string;
+  description: string;
+  probability: "low" | "medium" | "high";
+  impact: "low" | "medium" | "high";
+  mitigation: string;
+}
+
+interface Alternative {
+  name: string;
+  description: string;
+  pros: string[];
+  cons: string[];
+  complexity: "low" | "medium" | "high";
+  whyDiscarded?: string;
+}
+
+interface ArchitecturalDecision {
+  decision: string;
+  rationale: string;
+}
+
+interface ArchitecturalAnalysis {
+  id: string;
+  name: string;
+  description: string;
+  status: "pending" | "approved" | "implemented" | "rejected";
+
+  // Contexto
+  context: string;
+  currentArchitecture: string;
+
+  // Solucao
+  approach: string;
+  chosenAlternative: string;
+
+  // Diagramas (Mermaid)
+  diagrams: {
+    name: string;
+    type: string;
+    content: string;
+  }[];
+
+  // Baby Steps
+  babySteps: BabyStep[];
+
+  // Riscos
+  risks: Risk[];
+
+  // Alternativas
+  alternatives: Alternative[];
+
+  // Decisoes
+  decisions: ArchitecturalDecision[];
+
+  // Metadados
+  filePath?: string;
+  createdAt: string;
+  updatedAt?: string;
+  approvedAt?: string;
+}
+
+// ═══════════════════════════════════════════════════════════════
+// HELPERS
+// ═══════════════════════════════════════════════════════════════
+
+function generateId(): string {
+  const timestamp = Date.now().toString(36);
+  const random = Math.random().toString(36).substring(2, 6);
+  return `ARCH-${timestamp}-${random}`.toUpperCase();
+}
+
+function ensureAnalysisDir(): string {
+  const dir = ".codexa/analysis";
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  return dir;
+}
+
+function formatDate(date: Date): string {
+  return date.toISOString().split("T")[0];
+}
+
+// ═══════════════════════════════════════════════════════════════
+// MARKDOWN PARSER (v8.4)
+// ═══════════════════════════════════════════════════════════════
+
+function extractSection(content: string, header: string): string {
+  // Split por headers ## e encontrar a secao correta
+  const sections = content.split(/^## /m);
+  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();
+    }
+  }
+  return "";
+}
+
+function parseBabySteps(section: string): BabyStep[] {
+  if (!section) return [];
+  const steps: BabyStep[] = [];
+  // Match "### N. Name" or "### Step N: Name"
+  const stepBlocks = section.split(/^###\s+/m).filter(Boolean);
+
+  for (const block of stepBlocks) {
+    const headerMatch = block.match(/^(?:Step\s+)?(\d+)[.:]\s*(.+)/);
+    if (!headerMatch) continue;
+
+    const number = parseInt(headerMatch[1]);
+    const name = headerMatch[2].trim();
+    const what = block.match(/\*\*O que\*\*:\s*(.+)/)?.[1]?.trim() || "";
+    const why = block.match(/\*\*Por que\*\*:\s*(.+)/)?.[1]?.trim() || "";
+    const result = block.match(/\*\*Resultado\*\*:\s*(.+)/)?.[1]?.trim() || "";
+    const filesStr = block.match(/\*\*Arquivos?\*\*:\s*(.+)/)?.[1]?.trim() || "";
+    const agent = block.match(/\*\*Agente\*\*:\s*(.+)/)?.[1]?.trim() || "general";
+    const depsStr = block.match(/\*\*Depende de\*\*:\s*(.+)/)?.[1]?.trim() || "";
+
+    const files = filesStr
+      ? filesStr.split(/[,;]/).map(f => f.trim().replace(/`/g, "")).filter(Boolean)
+      : [];
+
+    const dependsOn = depsStr
+      ? (depsStr.match(/\d+/g) || []).map(Number)
+      : [];
+
+    steps.push({ number, name, what, why, result, files, agent, dependsOn: dependsOn.length > 0 ? dependsOn : undefined });
+  }
+
+  return steps;
+}
+
+function parseRisks(section: string): Risk[] {
+  if (!section) return [];
+  const risks: Risk[] = [];
+  const riskBlocks = section.split(/^###\s+/m).filter(Boolean);
+
+  for (const block of riskBlocks) {
+    const headerMatch = block.match(/^R?(\d+)[.:]\s*(.+)/);
+    if (!headerMatch) continue;
+
+    const id = `R${headerMatch[1]}`;
+    const description = headerMatch[2].trim();
+    const probability = (block.match(/\*\*Probabilidade\*\*:\s*(\w+)/)?.[1]?.trim() || "medium") as Risk["probability"];
+    const impact = (block.match(/\*\*Impacto\*\*:\s*(\w+)/)?.[1]?.trim() || "medium") as Risk["impact"];
+    const mitigation = block.match(/\*\*Mitiga[cç][aã]o\*\*:\s*(.+)/)?.[1]?.trim() || "";
+
+    risks.push({ id, description, probability, impact, mitigation });
+  }
+
+  return risks;
+}
+
+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;
+  let match;
+
+  while ((match = diagramRegex.exec(section)) !== null) {
+    const content = match[2].trim();
+    const typeMatch = content.match(/^(\w+)/);
+    diagrams.push({
+      name: match[1].trim(),
+      type: typeMatch ? typeMatch[1] : "flowchart",
+      content,
+    });
+  }
+
+  return diagrams;
+}
+
+function parseDecisionsTable(section: string): ArchitecturalDecision[] {
+  if (!section) return [];
+  const decisions: ArchitecturalDecision[] = [];
+  const lines = section.split("\n");
+
+  for (const line of lines) {
+    // Match table rows: | Decision | Rationale |
+    const rowMatch = line.match(/^\|\s*([^|]+)\s*\|\s*([^|]+)\s*\|$/);
+    if (!rowMatch) continue;
+    const decision = rowMatch[1].trim();
+    const rationale = rowMatch[2].trim();
+    // Skip header and separator rows
+    if (decision === "Decisao" || decision.startsWith("---")) continue;
+    if (decision && rationale) {
+      decisions.push({ decision, rationale });
+    }
+  }
+
+  return decisions;
+}
+
+function parseAlternatives(section: string): Alternative[] {
+  if (!section) return [];
+  const alternatives: Alternative[] = [];
+  const altBlocks = section.split(/^###\s+/m).filter(Boolean);
+
+  for (const block of altBlocks) {
+    const name = block.split("\n")[0]?.trim();
+    if (!name) continue;
+
+    const description = block.match(/\*\*Descri[cç][aã]o\*\*:\s*(.+)/)?.[1]?.trim() || "";
+    const whyDiscarded = block.match(/\*\*Por que descartada\*\*:\s*(.+)/)?.[1]?.trim() || "";
+
+    alternatives.push({
+      name,
+      description,
+      pros: [],
+      cons: [],
+      complexity: "medium",
+      whyDiscarded: whyDiscarded || undefined,
+    });
+  }
+
+  return alternatives;
+}
+
+/**
+ * v8.4: Parseia um arquivo .md de analise arquitetural e extrai dados estruturados.
+ * O .md deve seguir o template padrao do codexa:architect.
+ */
+export function parseAnalysisMd(content: string): {
+  context: string;
+  currentArchitecture: string;
+  approach: string;
+  diagrams: { name: string; type: string; content: string }[];
+  babySteps: BabyStep[];
+  risks: Risk[];
+  alternatives: Alternative[];
+  decisions: ArchitecturalDecision[];
+} {
+  const context = extractSection(content, "Contexto e Entendimento");
+  const currentArchitecture = extractSection(content, "Stack e Arquitetura Atual");
+  const approach = extractSection(content, "Solucao Proposta");
+
+  const diagramsSection = extractSection(content, "Diagramas");
+  const diagrams = parseDiagrams(diagramsSection);
+
+  const babyStepsSection = extractSection(content, "Baby Steps");
+  const babySteps = parseBabySteps(babyStepsSection);
+
+  const risksSection = extractSection(content, "Riscos e Mitigacoes");
+  const risks = parseRisks(risksSection);
+
+  const alternativesSection = extractSection(content, "Alternativas Descartadas");
+  const alternatives = parseAlternatives(alternativesSection);
+
+  const decisionsSection = extractSection(content, "Decisoes Arquiteturais");
+  const decisions = parseDecisionsTable(decisionsSection);
+
+  return { context, currentArchitecture, approach, diagrams, babySteps, risks, alternatives, decisions };
+}
+
+// ═══════════════════════════════════════════════════════════════
+// COMMANDS
+// ═══════════════════════════════════════════════════════════════
+
+export function architectStart(description: string, options: { json?: boolean } = {}): void {
+  initSchema();
+  const db = getDb();
+  const now = new Date().toISOString();
+  const id = generateId();
+
+  // Verificar se ja existe analise pendente
+  const pending = db.query(
+    "SELECT * FROM architectural_analyses WHERE status = 'pending' ORDER BY created_at DESC LIMIT 1"
+  ).get() as any;
+
+  if (pending) {
+    if (options.json) {
+      console.log(JSON.stringify({
+        error: "ANALYSIS_ACTIVE",
+        message: "Ja existe uma analise pendente",
+        analysis: {
+          id: pending.id,
+          name: pending.name,
+          createdAt: pending.created_at,
+        },
+      }));
+    } else {
+      console.log("\n[ERRO] Ja existe uma analise pendente.\n");
+      console.log(`  ID: ${pending.id}`);
+      console.log(`  Nome: ${pending.name}`);
+      console.log(`  Criada: ${pending.created_at}`);
+      console.log("\nUse 'architect show' para ver detalhes ou 'architect cancel' para cancelar.\n");
+    }
+    process.exit(1);
+  }
+
+  // Criar nova analise
+  db.run(
+    `INSERT INTO architectural_analyses (id, name, description, status, created_at)
+     VALUES (?, ?, ?, 'pending', ?)`,
+    [id, description, description, now]
+  );
+
+  if (options.json) {
+    console.log(JSON.stringify({
+      success: true,
+      analysis: {
+        id,
+        name: description,
+        status: "pending",
+        createdAt: now,
+      },
+      nextSteps: [
+        "Explorar codebase com deep-explore",
+        "Analisar arquitetura atual",
+        "Propor solucoes com trade-offs",
+        "Escrever .md em .codexa/analysis/",
+        "Registrar com 'architect save --file <path>'",
+        "Aprovar com 'architect approve'",
+      ],
+    }));
+  } else {
+    console.log("\n╔════════════════════════════════════════════════════════════╗");
+    console.log("║  ANALISE ARQUITETURAL INICIADA                             ║");
+    console.log("╚════════════════════════════════════════════════════════════╝\n");
+    console.log(`  ID: ${id}`);
+    console.log(`  Descricao: ${description}`);
+    console.log(`  Status: pending`);
+    console.log("\n  Proximos passos:");
+    console.log("  1. Explorar codebase com deep-explore");
+    console.log("  2. Analisar arquitetura atual");
+    console.log("  3. Propor solucoes com trade-offs");
+    console.log("  4. Escrever .md em .codexa/analysis/");
+    console.log("  5. Registrar: architect save --file <path>");
+    console.log("  6. Aprovar: architect approve\n");
+  }
+}
+
+export function architectShow(options: { id?: string; json?: boolean } = {}): void {
+  initSchema();
+  const db = getDb();
+
+  let analysis: any;
+
+  if (options.id) {
+    analysis = db.query("SELECT * FROM architectural_analyses WHERE id = ?").get(options.id);
+  } else {
+    // Pegar a mais recente pendente ou a ultima
+    analysis = db.query(
+      "SELECT * FROM architectural_analyses WHERE status = 'pending' ORDER BY created_at DESC LIMIT 1"
+    ).get();
+
+    if (!analysis) {
+      analysis = db.query(
+        "SELECT * FROM architectural_analyses ORDER BY created_at DESC LIMIT 1"
+      ).get();
+    }
+  }
+
+  if (!analysis) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "NO_ANALYSIS", message: "Nenhuma analise encontrada" }));
+    } else {
+      console.log("\n[INFO] Nenhuma analise arquitetural encontrada.");
+      console.log("Use 'architect start <descricao>' para iniciar.\n");
+    }
+    return;
+  }
+
+  // Parse JSON fields
+  const parsed: ArchitecturalAnalysis = {
+    id: analysis.id,
+    name: analysis.name,
+    description: analysis.description,
+    status: analysis.status,
+    context: analysis.context || "",
+    currentArchitecture: analysis.current_architecture || "",
+    approach: analysis.approach || "",
+    chosenAlternative: analysis.chosen_alternative || "",
+    diagrams: analysis.diagrams ? JSON.parse(analysis.diagrams) : [],
+    babySteps: analysis.baby_steps ? JSON.parse(analysis.baby_steps) : [],
+    risks: analysis.risks ? JSON.parse(analysis.risks) : [],
+    alternatives: analysis.alternatives ? JSON.parse(analysis.alternatives) : [],
+    decisions: analysis.decisions ? JSON.parse(analysis.decisions) : [],
+    filePath: analysis.file_path,
+    createdAt: analysis.created_at,
+    updatedAt: analysis.updated_at,
+    approvedAt: analysis.approved_at,
+  };
+
+  if (options.json) {
+    console.log(JSON.stringify(parsed, null, 2));
+  } else {
+    console.log("\n╔════════════════════════════════════════════════════════════╗");
+    console.log("║  ANALISE ARQUITETURAL                                      ║");
+    console.log("╚════════════════════════════════════════════════════════════╝\n");
+
+    console.log(`  ID: ${parsed.id}`);
+    console.log(`  Nome: ${parsed.name}`);
+    console.log(`  Status: ${parsed.status}`);
+    console.log(`  Criada: ${parsed.createdAt}`);
+
+    if (parsed.filePath) {
+      console.log(`  Arquivo: ${parsed.filePath}`);
+    }
+
+    if (parsed.approach) {
+      console.log(`\n  Abordagem: ${parsed.approach}`);
+    }
+
+    if (parsed.babySteps.length > 0) {
+      console.log(`\n  Baby Steps: ${parsed.babySteps.length}`);
+      parsed.babySteps.forEach((step, i) => {
+        console.log(`    ${i + 1}. ${step.name} [${step.agent}]`);
+      });
+    }
+
+    if (parsed.risks.length > 0) {
+      console.log(`\n  Riscos: ${parsed.risks.length}`);
+      parsed.risks.forEach((risk) => {
+        console.log(`    - ${risk.description} (${risk.probability}/${risk.impact})`);
+      });
+    }
+
+    if (parsed.diagrams.length > 0) {
+      console.log(`\n  Diagramas: ${parsed.diagrams.length}`);
+      parsed.diagrams.forEach((d) => {
+        console.log(`    - ${d.name} (${d.type})`);
+      });
+    }
+
+    console.log("");
+  }
+}
+
+export function architectList(options: { json?: boolean; status?: string } = {}): void {
+  initSchema();
+  const db = getDb();
+
+  let query = "SELECT id, name, status, created_at, file_path FROM architectural_analyses";
+  const params: any[] = [];
+
+  if (options.status) {
+    query += " WHERE status = ?";
+    params.push(options.status);
+  }
+
+  query += " ORDER BY created_at DESC";
+
+  const analyses = db.query(query).all(...params) as any[];
+
+  if (options.json) {
+    console.log(JSON.stringify(analyses, null, 2));
+  } else {
+    if (analyses.length === 0) {
+      console.log("\n[INFO] Nenhuma analise arquitetural encontrada.\n");
+      return;
+    }
+
+    console.log("\n╔════════════════════════════════════════════════════════════╗");
+    console.log("║  ANALISES ARQUITETURAIS                                    ║");
+    console.log("╚════════════════════════════════════════════════════════════╝\n");
+
+    analyses.forEach((a) => {
+      const statusIcon =
+        a.status === "approved" ? "✓" :
+        a.status === "implemented" ? "★" :
+        a.status === "rejected" ? "✗" : "○";
+
+      console.log(`  ${statusIcon} [${a.id}] ${a.name}`);
+      console.log(`    Status: ${a.status} | Criada: ${a.created_at}`);
+      if (a.file_path) {
+        console.log(`    Arquivo: ${a.file_path}`);
+      }
+      console.log("");
+    });
+  }
+}
+
+export function architectSave(options: { file?: string; json?: boolean }): void {
+  initSchema();
+  const db = getDb();
+  const now = new Date().toISOString();
+
+  // Pegar analise pendente
+  const analysis = db.query(
+    "SELECT * FROM architectural_analyses WHERE status = 'pending' ORDER BY created_at DESC LIMIT 1"
+  ).get() as any;
+
+  if (!analysis) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "NO_PENDING", message: "Nenhuma analise pendente" }));
+    } else {
+      console.log("\n[ERRO] Nenhuma analise pendente encontrada.\n");
+    }
+    process.exit(1);
+  }
+
+  // v8.4: Resolver caminho do arquivo .md
+  const dir = ensureAnalysisDir();
+  let filePath: string;
+  if (options.file) {
+    // Se path fornecido, usar como-is (aceita absoluto ou relativo)
+    filePath = options.file;
+  } else {
+    filePath = join(dir, `${analysis.id}-${analysis.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").substring(0, 30)}.md`);
+  }
+
+  // v8.4: Ler .md do disco e parsear para popular o DB
+  if (!existsSync(filePath)) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "FILE_NOT_FOUND", message: `Arquivo nao encontrado: ${filePath}` }));
+    } else {
+      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);
+  }
+
+  const content = readFileSync(filePath, "utf-8");
+  const parsed = parseAnalysisMd(content);
+
+  // Popular DB com dados extraidos do .md
+  const updates: string[] = [];
+  const values: any[] = [];
+
+  if (parsed.context) {
+    updates.push("context = ?");
+    values.push(parsed.context);
+  }
+  if (parsed.currentArchitecture) {
+    updates.push("current_architecture = ?");
+    values.push(parsed.currentArchitecture);
+  }
+  if (parsed.approach) {
+    updates.push("approach = ?");
+    values.push(parsed.approach);
+  }
+  if (parsed.diagrams.length > 0) {
+    updates.push("diagrams = ?");
+    values.push(JSON.stringify(parsed.diagrams));
+  }
+  if (parsed.babySteps.length > 0) {
+    updates.push("baby_steps = ?");
+    values.push(JSON.stringify(parsed.babySteps));
+  }
+  if (parsed.risks.length > 0) {
+    updates.push("risks = ?");
+    values.push(JSON.stringify(parsed.risks));
+  }
+  if (parsed.alternatives.length > 0) {
+    updates.push("alternatives = ?");
+    values.push(JSON.stringify(parsed.alternatives));
+  }
+  if (parsed.decisions.length > 0) {
+    updates.push("decisions = ?");
+    values.push(JSON.stringify(parsed.decisions));
+  }
+
+  updates.push("file_path = ?");
+  values.push(filePath);
+  updates.push("updated_at = ?");
+  values.push(now);
+  values.push(analysis.id);
+
+  db.run(
+    `UPDATE architectural_analyses SET ${updates.join(", ")} WHERE id = ?`,
+    values
+  );
+
+  if (options.json) {
+    console.log(JSON.stringify({
+      success: true,
+      id: analysis.id,
+      filePath,
+      parsed: {
+        babySteps: parsed.babySteps.length,
+        risks: parsed.risks.length,
+        diagrams: parsed.diagrams.length,
+        decisions: parsed.decisions.length,
+        hasApproach: !!parsed.approach,
+        hasContext: !!parsed.context,
+      },
+    }));
+  } else {
+    console.log("\n╔════════════════════════════════════════════════════════════╗");
+    console.log("║  ANALISE SALVA (parseada do .md)                           ║");
+    console.log("╚════════════════════════════════════════════════════════════╝\n");
+    console.log(`  Arquivo: ${filePath}`);
+    console.log(`  Baby Steps: ${parsed.babySteps.length}`);
+    console.log(`  Riscos: ${parsed.risks.length}`);
+    console.log(`  Diagramas: ${parsed.diagrams.length}`);
+    console.log(`  Decisoes: ${parsed.decisions.length}`);
+    if (!parsed.approach) {
+      console.log("\n  [AVISO] Secao 'Solucao Proposta' nao encontrada no .md");
+    }
+    if (parsed.babySteps.length === 0) {
+      console.log("  [AVISO] Nenhum baby step encontrado. Verifique formato '### N. Nome'");
+    }
+    console.log("\n  Proximo passo:");
+    console.log(`  - Aprovar: architect approve`);
+    console.log(`  - Iniciar feature: plan start "nome" --from-analysis ${analysis.id}\n`);
+  }
+}
+
+export function architectApprove(options: { id?: string; json?: boolean }): void {
+  initSchema();
+  const db = getDb();
+  const now = new Date().toISOString();
+
+  let analysis: any;
+
+  if (options.id) {
+    analysis = db.query("SELECT * FROM architectural_analyses WHERE id = ?").get(options.id);
+  } else {
+    analysis = db.query(
+      "SELECT * FROM architectural_analyses WHERE status = 'pending' ORDER BY created_at DESC LIMIT 1"
+    ).get();
+  }
+
+  if (!analysis) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "NOT_FOUND", message: "Analise nao encontrada" }));
+    } else {
+      console.log("\n[ERRO] Analise nao encontrada.\n");
+    }
+    process.exit(1);
+  }
+
+  if (analysis.status !== "pending") {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "INVALID_STATUS", message: `Analise ja esta ${analysis.status}` }));
+    } else {
+      console.log(`\n[ERRO] Analise ja esta com status '${analysis.status}'.\n`);
+    }
+    process.exit(1);
+  }
+
+  db.run(
+    "UPDATE architectural_analyses SET status = 'approved', approved_at = ?, updated_at = ? WHERE id = ?",
+    [now, now, analysis.id]
+  );
+
+  if (options.json) {
+    console.log(JSON.stringify({
+      success: true,
+      id: analysis.id,
+      status: "approved",
+      nextStep: `plan start "${analysis.name}" --from-analysis ${analysis.id}`,
+    }));
+  } else {
+    console.log(`\n[OK] Analise ${analysis.id} aprovada.`);
+    console.log(`\nInicie a feature com import automatico dos baby steps:`);
+    console.log(`  plan start "${analysis.name}" --from-analysis ${analysis.id}\n`);
+  }
+}
+
+// v8.4: Simplificado - agora o feature importa baby steps automaticamente via --from-analysis
+export function architectExport(options: { id?: string; json?: boolean }): void {
+  initSchema();
+  const db = getDb();
+
+  let analysis: any;
+
+  if (options.id) {
+    analysis = db.query("SELECT * FROM architectural_analyses WHERE id = ?").get(options.id);
+  } else {
+    analysis = db.query(
+      "SELECT * FROM architectural_analyses WHERE status = 'approved' ORDER BY approved_at DESC LIMIT 1"
+    ).get();
+  }
+
+  if (!analysis) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "NOT_FOUND", message: "Nenhuma analise aprovada encontrada" }));
+    } else {
+      console.log("\n[ERRO] Nenhuma analise aprovada encontrada.");
+      console.log("Use 'architect approve' primeiro.\n");
+    }
+    process.exit(1);
+  }
+
+  const babySteps: BabyStep[] = analysis.baby_steps ? JSON.parse(analysis.baby_steps) : [];
+  const planCmd = `codexa plan start "${analysis.name}" --from-analysis ${analysis.id}`;
+
+  if (options.json) {
+    console.log(JSON.stringify({
+      analysisId: analysis.id,
+      analysisName: analysis.name,
+      babyStepsCount: babySteps.length,
+      filePath: analysis.file_path || null,
+      planStartCommand: planCmd,
+    }));
+  } else {
+    console.log("\n╔════════════════════════════════════════════════════════════╗");
+    console.log("║  EXPORTAR PARA FEATURE                                     ║");
+    console.log("╚════════════════════════════════════════════════════════════╝\n");
+
+    console.log(`  Analise: ${analysis.name} (${analysis.id})`);
+    console.log(`  Baby Steps: ${babySteps.length}`);
+    if (analysis.file_path) {
+      console.log(`  Arquivo: ${analysis.file_path}`);
+    }
+
+    console.log(`\n  Comando para iniciar feature com import automatico:`);
+    console.log(`  ${planCmd}\n`);
+  }
+}
+
+export function architectCancel(options: { id?: string; json?: boolean }): void {
+  initSchema();
+  const db = getDb();
+  const now = new Date().toISOString();
+
+  let analysis: any;
+
+  if (options.id) {
+    analysis = db.query("SELECT * FROM architectural_analyses WHERE id = ?").get(options.id);
+  } else {
+    analysis = db.query(
+      "SELECT * FROM architectural_analyses WHERE status = 'pending' ORDER BY created_at DESC LIMIT 1"
+    ).get();
+  }
+
+  if (!analysis) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "NOT_FOUND", message: "Nenhuma analise pendente encontrada" }));
+    } else {
+      console.log("\n[INFO] Nenhuma analise pendente para cancelar.\n");
+    }
+    return;
+  }
+
+  db.run(
+    "UPDATE architectural_analyses SET status = 'rejected', updated_at = ? WHERE id = ?",
+    [now, analysis.id]
+  );
+
+  if (options.json) {
+    console.log(JSON.stringify({ success: true, id: analysis.id, status: "rejected" }));
+  } else {
+    console.log(`\n[OK] Analise ${analysis.id} cancelada.\n`);
+  }
+}