@codexa/cli 8.6.0 → 8.6.9

package/workflow.ts

@@ -1,783 +1,784 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import { planStart, planShow, planTaskAdd, planCancel } from "./commands/plan";
-import { checkRequest, checkApprove, checkReject } from "./commands/check";
-import { taskNext, taskStart, taskDone } from "./commands/task";
-import { decide, listDecisions } from "./commands/decide";
-import { reviewStart, reviewApprove, reviewSkip } from "./commands/review";
-import { addKnowledge, listKnowledge, acknowledgeKnowledge, queryGraph } from "./commands/knowledge";
-import { status, contextExport, recover, contextUpdate } from "./commands/utils";
-import {
-  discoverStart,
-  discoverConfirm,
-  discoverShow,
-  discoverSetStack,
-  discoverReset,
-  discoverRefresh,
-  discoverPatterns,
-  discoverPatternsShow,
-  discoverPatternAdd,
-  discoverPatternEdit,
-  discoverPatternRemove,
-  discoverRefreshPatterns,
-  discoverExportPatterns,
-} from "./commands/discover";
-import { clearTasks, clearShow } from "./commands/clear";
-import { standardsList, standardsAdd, standardsEdit, standardsRemove, standardsExport } from "./commands/standards";
-import { productGuide, productImport, productSet, productGoalAdd, productFeatureAdd, productConfirm, productShow, productReset } from "./commands/product";
-import { researchStart, researchShow, researchFill, researchMapAgent, researchReset } from "./commands/research";
-import { patternsExtract, patternsAnalyze } from "./commands/patterns";
-import {
-  architectStart,
-  architectShow,
-  architectList,
-  architectSave,
-  architectApprove,
-  architectExport,
-  architectCancel,
-} from "./commands/architect";
-import { initSchema } from "./db/schema";
-
-const program = new Command();
-
-program
-  .name("codexa")
-  .description("Codexa Workflow v8.0 - Sistema de workflow para Claude Code")
-  .version("8.0.0");
-
-// ═══════════════════════════════════════════════════════════════
-// FASE: PLAN
-// ═══════════════════════════════════════════════════════════════
-
-const planCmd = program.command("plan").description("Comandos da fase PLAN");
-
-planCmd
-  .command("start <description>")
-  .description("Inicia uma nova feature")
-  .option("--from-analysis <id>", "Importar baby steps de analise arquitetural aprovada")
-  .option("--json", "Saida em JSON")
-  .action((description: string, options: { fromAnalysis?: string; json?: boolean }) => {
-    planStart(description, options);
-  });
-
-planCmd
-  .command("show")
-  .description("Mostra o plano atual")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    planShow(options.json);
-  });
-
-planCmd
-  .command("task-add")
-  .description("Adiciona uma task ao plano")
-  .requiredOption("--name <name>", "Nome da task")
-  .option("--agent <agent>", "Agente responsavel (database, backend, frontend, testing)")
-  .option("--depends <ids>", "IDs das tasks que esta depende (ex: 1,2)")
-  .option("--files <files>", "Arquivos esperados (ex: src/a.ts,src/b.ts)")
-  .option("--sequential", "Marca como sequencial (nao paralelizavel)")
-  .action((options) => {
-    planTaskAdd(options);
-  });
-
-planCmd
-  .command("cancel")
-  .description("Cancela a feature atual (soft-cancel, preserva historico)")
-  .action(() => {
-    planCancel();
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// FASE: CHECK
-// ═══════════════════════════════════════════════════════════════
-
-const checkCmd = program.command("check").description("Comandos da fase CHECK");
-
-checkCmd
-  .command("request")
-  .description("Solicita aprovacao do plano")
-  .action(() => {
-    checkRequest();
-  });
-
-checkCmd
-  .command("approve")
-  .description("Aprova o plano")
-  .action(() => {
-    checkApprove();
-  });
-
-checkCmd
-  .command("reject <reason>")
-  .description("Rejeita o plano com motivo")
-  .action((reason: string) => {
-    checkReject(reason);
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// FASE: IMP (Implementacao)
-// ═══════════════════════════════════════════════════════════════
-
-const taskCmd = program.command("task").description("Comandos da fase IMP");
-
-taskCmd
-  .command("next")
-  .description("Mostra proximas tasks disponiveis")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    taskNext(options.json);
-  });
-
-taskCmd
-  .command("start <ids>")
-  .description("Inicia task(s) - pode ser multiplas separadas por virgula")
-  .option("--json", "Saida em JSON")
-  .action((ids: string, options) => {
-    taskStart(ids, options.json);
-  });
-
-taskCmd
-  .command("done <id>")
-  .description("Completa uma task")
-  .option("--checkpoint <text>", "Resumo do que foi feito (extraido automaticamente de --output)")
-  .option("--output <json>", "Retorno JSON do subagent (processa automaticamente)")
-  .option("--files <files>", "Arquivos criados/modificados (extraido automaticamente de --output)")
-  .option("--force", "Ignorar validacao de standards (sera registrado)")
-  .option("--force-reason <reason>", "Motivo do bypass de validacao")
-  .action((id: string, options) => {
-    // Checkpoint obrigatorio se nao houver --output
-    if (!options.output && !options.checkpoint) {
-      console.error("\n[ERRO] Checkpoint obrigatorio.");
-      console.error("Use: --checkpoint 'resumo' ou --output '{json do subagent}'\n");
-      process.exit(1);
-    }
-
-    taskDone(id, {
-      checkpoint: options.checkpoint || "",
-      files: options.files,
-      force: options.force,
-      forceReason: options.forceReason,
-      output: options.output,
-    });
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// DECISOES
-// ═══════════════════════════════════════════════════════════════
-
-program
-  .command("decide <title> <decision>")
-  .description("Registra uma decisao")
-  .option("--rationale <text>", "Justificativa da decisao")
-  .option("--force", "Ignorar deteccao de conflitos")
-  .action((title: string, decision: string, options) => {
-    decide(title, decision, options);
-  });
-
-program
-  .command("decisions")
-  .description("Lista decisoes")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    listDecisions(options.json);
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// KNOWLEDGE BROADCAST
-// ═══════════════════════════════════════════════════════════════
-
-const knowledgeCmd = program.command("knowledge").description("Comandos de knowledge broadcast entre tasks");
-
-knowledgeCmd
-  .command("add")
-  .description("Adiciona knowledge para broadcast")
-  .requiredOption("--content <text>", "Conteudo do knowledge")
-  .requiredOption("--category <cat>", "Categoria (discovery, decision, blocker, pattern, constraint)")
-  .option("--severity <level>", "Severidade (info, warning, critical)", "info")
-  .option("--broadcast <target>", "Destino (all ou IDs separados por virgula)", "all")
-  .action((options) => {
-    addKnowledge({
-      content: options.content,
-      category: options.category,
-      severity: options.severity,
-      broadcastTo: options.broadcast,
-    });
-  });
-
-knowledgeCmd
-  .command("list")
-  .description("Lista knowledge da feature atual")
-  .option("--unread", "Apenas nao lidos pela task atual")
-  .option("--category <cat>", "Filtrar por categoria")
-  .option("--severity <level>", "Filtrar por severidade (critical, warning, info)")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    listKnowledge(options);
-  });
-
-knowledgeCmd
-  .command("ack <id>")
-  .description("Marca knowledge como lido pela task atual")
-  .action((id: string) => {
-    acknowledgeKnowledge(id);
-  });
-
-knowledgeCmd
-  .command("graph")
-  .description("Consulta o knowledge graph (relacoes entre arquivos, decisoes, patterns)")
-  .option("--file <path>", "Buscar relacoes de um arquivo")
-  .option("--decision <id>", "Buscar arquivos afetados por uma decisao")
-  .option("--contradictions", "Detectar contradicoes entre decisoes")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    queryGraph(options);
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// FASE: REV (Review)
-// ═══════════════════════════════════════════════════════════════
-
-const reviewCmd = program.command("review").description("Comandos da fase REV");
-
-reviewCmd
-  .command("start")
-  .description("Inicia o review")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    reviewStart(options.json);
-  });
-
-reviewCmd
-  .command("approve")
-  .description("Aprova o review e finaliza a feature")
-  .action(() => {
-    reviewApprove();
-  });
-
-reviewCmd
-  .command("skip")
-  .description("Pula o review e finaliza a feature diretamente")
-  .action(() => {
-    reviewSkip();
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// UTILITARIOS
-// ═══════════════════════════════════════════════════════════════
-
-program
-  .command("status")
-  .description("Mostra status atual")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    status(options.json);
-  });
-
-const contextCmd = program.command("context").description("Comandos de contexto");
-
-contextCmd
-  .command("export")
-  .description("Exporta contexto para subagent")
-  .option("--task <id>", "ID da task especifica")
-  .action((options) => {
-    contextExport({ ...options, json: true }); // Sempre JSON
-  });
-
-contextCmd
-  .command("update")
-  .description("Atualiza contexto durante implementacao")
-  .option("--approach <text>", "Adiciona nova abordagem descoberta")
-  .option("--pattern <text>", "Registra padrao identificado no codigo")
-  .option("--constraint <text>", "Adiciona nova limitacao encontrada")
-  .action((options) => {
-    contextUpdate(options);
-  });
-
-// Manter compatibilidade: context sem subcomando = export
-program
-  .command("ctx")
-  .description("Alias para context export (compatibilidade)")
-  .option("--task <id>", "ID da task especifica")
-  .action((options) => {
-    contextExport({ ...options, json: true });
-  });
-
-program
-  .command("recover")
-  .description("Gerencia snapshots para recovery")
-  .option("--list", "Lista snapshots disponiveis")
-  .option("--snapshot <id>", "Mostra detalhes de um snapshot")
-  .option("--restore", "Restaura o snapshot especificado")
-  .option("--auto", "Restaura o ultimo snapshot automaticamente")
-  .action((options) => {
-    recover(options);
-  });
-
-program
-  .command("init")
-  .description("Inicializa o banco de dados")
-  .action(() => {
-    initSchema();
-    console.log("\nBanco de dados inicializado em .codexa/db/workflow.db\n");
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// DISCOVER
-// ═══════════════════════════════════════════════════════════════
-
-const discoverCmd = program.command("discover").description("Comandos de descoberta do projeto");
-
-discoverCmd
-  .command("start")
-  .description("Inicia descoberta automatica do projeto")
-  .option("--json", "Saida em JSON")
-  .action(async (options) => {
-    await discoverStart(options.json);
-  });
-
-discoverCmd
-  .command("confirm")
-  .description("Confirma e salva a descoberta")
-  .action(() => {
-    discoverConfirm();
-  });
-
-discoverCmd
-  .command("show")
-  .description("Mostra projeto descoberto")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    discoverShow(options.json);
-  });
-
-discoverCmd
-  .command("set-stack")
-  .description("Define ou ajusta stack manualmente")
-  .option("--frontend <value>", "Frontend (next, react, vue, flutter)")
-  .option("--backend <value>", "Backend (node, bun, csharp, python, go)")
-  .option("--database <value>", "Database (postgres, mongodb, prisma)")
-  .option("--orm <value>", "ORM (drizzle, prisma, typeorm, sequelize)")
-  .option("--styling <value>", "Styling (tailwind, styled-components)")
-  .option("--auth <value>", "Auth (supabase, next-auth, clerk)")
-  .option("--testing <value>", "Testing (vitest, jest, playwright)")
-  .action((options) => {
-    discoverSetStack(options);
-  });
-
-discoverCmd
-  .command("reset")
-  .description("Reseta descoberta para refazer")
-  .action(() => {
-    discoverReset();
-  });
-
-discoverCmd
-  .command("refresh")
-  .description("Re-detecta stack e mostra mudancas")
-  .option("--force", "Aplica as mudancas detectadas")
-  .action(async (options) => {
-    await discoverRefresh(options);
-  });
-
-// ─────────────────────────────────────────────────────────────────
-// PATTERNS (v7.4)
-// ─────────────────────────────────────────────────────────────────
-
-discoverCmd
-  .command("patterns")
-  .description("Lista implementation patterns extraidos")
-  .option("--category <cat>", "Filtrar por categoria")
-  .option("--show <name>", "Mostra detalhes de um pattern")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    if (options.show) {
-      discoverPatternsShow(options.show, options.json);
-    } else {
-      discoverPatterns({ category: options.category, json: options.json });
-    }
-  });
-
-discoverCmd
-  .command("pattern-add")
-  .description("Adiciona um implementation pattern")
-  .requiredOption("--category <cat>", "Categoria (component, hook, service, route, schema, test, action)")
-  .requiredOption("--name <name>", "Nome unico do pattern")
-  .requiredOption("--scope <scope>", "Escopo (frontend, backend, database, testing)")
-  .requiredOption("--applies-to <glob>", "Glob pattern dos arquivos (ex: src/components/**/*.tsx)")
-  .requiredOption("--structure <json>", "JSON com estrutura (imports, exports, patterns, conventions)")
-  .requiredOption("--template <code>", "Template com placeholders")
-  .requiredOption("--examples <json>", "JSON array de exemplos [{path, relevance}]")
-  .option("--anti-patterns <json>", "JSON array de anti-patterns")
-  .option("--confidence <num>", "Confianca 0-1", "0.8")
-  .option("--extracted-from <num>", "Numero de arquivos analisados", "1")
-  .action((options) => {
-    discoverPatternAdd({
-      category: options.category,
-      name: options.name,
-      scope: options.scope,
-      appliesTo: options.appliesTo,
-      structure: options.structure,
-      template: options.template,
-      examples: options.examples,
-      antiPatterns: options.antiPatterns,
-      confidence: parseFloat(options.confidence),
-      extractedFrom: parseInt(options.extractedFrom),
-    });
-  });
-
-discoverCmd
-  .command("pattern-edit <name>")
-  .description("Edita um implementation pattern")
-  .option("--category <cat>", "Nova categoria")
-  .option("--scope <scope>", "Novo escopo")
-  .option("--applies-to <glob>", "Novo glob pattern")
-  .option("--structure <json>", "Nova estrutura JSON")
-  .option("--template <code>", "Novo template")
-  .option("--examples <json>", "Novos exemplos JSON")
-  .option("--anti-patterns <json>", "Novos anti-patterns JSON")
-  .option("--confidence <num>", "Nova confianca 0-1")
-  .action((name, options) => {
-    discoverPatternEdit(name, {
-      category: options.category,
-      scope: options.scope,
-      appliesTo: options.appliesTo,
-      structure: options.structure,
-      template: options.template,
-      examples: options.examples,
-      antiPatterns: options.antiPatterns,
-      confidence: options.confidence ? parseFloat(options.confidence) : undefined,
-    });
-  });
-
-discoverCmd
-  .command("pattern-remove <name>")
-  .description("Remove um implementation pattern")
-  .action((name) => {
-    discoverPatternRemove(name);
-  });
-
-discoverCmd
-  .command("refresh-patterns")
-  .description("Re-extrai patterns do codigo (requer analise manual)")
-  .action(() => {
-    discoverRefreshPatterns();
-  });
-
-// v8.0: Extração automática de patterns via grepai
-discoverCmd
-  .command("extract-patterns")
-  .description("Extrai patterns automaticamente via grepai (busca semântica)")
-  .option("--scope <scope>", "Escopo (frontend, backend, database, testing)")
-  .option("--all", "Extrair de todos os escopos")
-  .option("--dry-run", "Apenas mostrar o que seria extraido")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    patternsExtract(options);
-  });
-
-discoverCmd
-  .command("analyze-file <path>")
-  .description("Analisa estrutura de um arquivo (imports, exports, convencoes)")
-  .option("--json", "Saida em JSON")
-  .action((path, options) => {
-    patternsAnalyze(path, options.json);
-  });
-
-discoverCmd
-  .command("export-patterns")
-  .description("Regenera arquivo patterns.md")
-  .action(() => {
-    discoverExportPatterns();
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// STANDARDS
-// ═══════════════════════════════════════════════════════════════
-
-const standardsCmd = program.command("standards").description("Comandos de gerenciamento de standards");
-
-standardsCmd
-  .command("list")
-  .description("Lista todos os standards")
-  .option("--category <cat>", "Filtrar por categoria")
-  .option("--scope <scope>", "Filtrar por escopo")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    standardsList(options);
-  });
-
-standardsCmd
-  .command("add")
-  .description("Adiciona um novo standard")
-  .requiredOption("--category <cat>", "Categoria (stack, structure, naming, code, library, practice)")
-  .requiredOption("--scope <scope>", "Escopo (all, database, backend, frontend, testing)")
-  .requiredOption("--rule <rule>", "Regra a ser seguida")
-  .option("--examples <list>", "Exemplos separados por virgula")
-  .option("--anti-examples <list>", "Anti-exemplos separados por virgula")
-  .option("--enforcement <level>", "Nivel de enforcement (required, recommended)")
-  .option("--required", "Alias para --enforcement required")
-  .option("--recommended", "Alias para --enforcement recommended")
-  .action((options) => {
-    // Resolver aliases de enforcement
-    let enforcement = options.enforcement;
-    if (options.required) enforcement = "required";
-    if (options.recommended) enforcement = "recommended";
-
-    standardsAdd({
-      category: options.category,
-      scope: options.scope,
-      rule: options.rule,
-      examples: options.examples,
-      antiExamples: options.antiExamples,
-      enforcement: enforcement,
-    });
-  });
-
-standardsCmd
-  .command("edit <id>")
-  .description("Edita um standard existente")
-  .option("--rule <rule>", "Nova regra")
-  .option("--examples <list>", "Novos exemplos")
-  .option("--anti-examples <list>", "Novos anti-exemplos")
-  .option("--enforcement <level>", "Novo nivel de enforcement")
-  .action((id, options) => {
-    standardsEdit(id, {
-      rule: options.rule,
-      examples: options.examples,
-      antiExamples: options.antiExamples,
-      enforcement: options.enforcement,
-    });
-  });
-
-standardsCmd
-  .command("remove <id>")
-  .description("Remove um standard")
-  .action((id) => {
-    standardsRemove(id);
-  });
-
-standardsCmd
-  .command("export")
-  .description("Regenera arquivo standards.md")
-  .action(() => {
-    standardsExport();
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// PRODUCT (Contexto de Produto / PRD)
-// ═══════════════════════════════════════════════════════════════
-
-const productCmd = program.command("product").description("Comandos de contexto de produto (PRD)");
-
-productCmd
-  .command("guide")
-  .description("Inicia modo guiado para definir contexto de produto")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    productGuide(options.json);
-  });
-
-productCmd
-  .command("import")
-  .description("Importa PRD existente")
-  .option("--file <path>", "Caminho para arquivo PRD")
-  .option("--content <text>", "Conteudo do PRD")
-  .action((options) => {
-    productImport(options);
-  });
-
-productCmd
-  .command("set")
-  .description("Define campos do contexto de produto")
-  .option("--name <name>", "Nome do produto")
-  .option("--problem <text>", "Problema que o produto resolve")
-  .option("--solution <text>", "Solucao proposta")
-  .option("--targetUsers <text>", "Usuarios alvo")
-  .option("--valueProposition <text>", "Proposta de valor")
-  .option("--successMetrics <list>", "Metricas de sucesso (separadas por virgula)")
-  .option("--outOfScope <list>", "Itens fora do escopo (separados por virgula)")
-  .option("--constraints <list>", "Restricoes (separadas por virgula)")
-  .action((options) => {
-    productSet(options);
-  });
-
-productCmd
-  .command("goal-add")
-  .description("Adiciona um objetivo do produto")
-  .requiredOption("--category <cat>", "Categoria (negocio, tecnico, usuario, operacional)")
-  .requiredOption("--goal <text>", "Descricao do objetivo")
-  .option("--priority <level>", "Prioridade (high, medium, low)", "medium")
-  .action((options) => {
-    productGoalAdd(options);
-  });
-
-productCmd
-  .command("feature-add")
-  .description("Adiciona uma feature core do produto")
-  .requiredOption("--name <name>", "Nome da feature")
-  .option("--description <text>", "Descricao da feature")
-  .option("--priority <level>", "Prioridade (high, medium, low)", "medium")
-  .action((options) => {
-    productFeatureAdd(options);
-  });
-
-productCmd
-  .command("show")
-  .description("Mostra contexto de produto")
-  .option("--json", "Saida em JSON")
-  .option("--pending", "Mostra contexto pendente (nao confirmado)")
-  .action((options) => {
-    productShow(options);
-  });
-
-productCmd
-  .command("confirm")
-  .description("Confirma e salva o contexto de produto")
-  .action(() => {
-    productConfirm();
-  });
-
-productCmd
-  .command("reset")
-  .description("Reseta contexto de produto para refazer")
-  .action(() => {
-    productReset();
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// RESEARCH (Contexto de Bibliotecas)
-// ═══════════════════════════════════════════════════════════════
-
-const researchCmd = program.command("research").description("Comandos de pesquisa de contexto de bibliotecas");
-
-researchCmd
-  .command("start")
-  .description("Detecta bibliotecas do projeto e cria arquivos de contexto")
-  .option("--json", "Saida em JSON")
-  .action(async (options) => {
-    await researchStart(options);
-  });
-
-researchCmd
-  .command("show")
-  .description("Mostra status das bibliotecas detectadas")
-  .option("--json", "Saida em JSON")
-  .option("--lib <name>", "Filtrar por biblioteca especifica")
-  .action((options) => {
-    researchShow(options);
-  });
-
-researchCmd
-  .command("fill <lib>")
-  .description("Gera instrucoes para preencher contexto de uma biblioteca")
-  .option("--json", "Saida em JSON")
-  .action((lib: string, options) => {
-    researchFill(lib, options);
-  });
-
-researchCmd
-  .command("map-agent")
-  .description("Gerencia mapeamento de bibliotecas para agentes")
-  .requiredOption("--agent <type>", "Tipo do agente (frontend, backend, database, testing)")
-  .option("--add <libs>", "Adicionar bibliotecas (separadas por virgula)")
-  .option("--remove <libs>", "Remover bibliotecas (separadas por virgula)")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    researchMapAgent(options);
-  });
-
-researchCmd
-  .command("reset")
-  .description("Remove todos os contextos de biblioteca")
-  .action(() => {
-    researchReset();
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// CLEAR (Limpeza de Tasks - v8.0: limpeza completa removida)
-// ═══════════════════════════════════════════════════════════════
-
-program
-  .command("clear")
-  .description("Limpa tasks/features mantendo configuracoes do projeto (standards, patterns, PRD)")
-  .option("--force", "Confirma a limpeza (sem isso apenas mostra o que sera removido)")
-  .option("--show", "Mostra estado atual dos arquivos do workflow")
-  .action((options) => {
-    if (options.show) {
-      clearShow();
-    } else {
-      clearTasks({ force: options.force });
-    }
-  });
-
-// ═══════════════════════════════════════════════════════════════
-// ARCHITECT (Analise Arquitetural)
-// ═══════════════════════════════════════════════════════════════
-
-const architectCmd = program.command("architect").description("Comandos de analise arquitetural");
-
-architectCmd
-  .command("start <description>")
-  .description("Inicia nova analise arquitetural")
-  .option("--json", "Saida em JSON")
-  .action((description: string, options) => {
-    architectStart(description, options);
-  });
-
-architectCmd
-  .command("show")
-  .description("Mostra analise atual ou especifica")
-  .option("--id <id>", "ID da analise")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectShow(options);
-  });
-
-architectCmd
-  .command("list")
-  .description("Lista todas as analises")
-  .option("--status <status>", "Filtrar por status (pending, approved, implemented, rejected)")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectList(options);
-  });
-
-architectCmd
-  .command("save")
-  .description("Salva analise em arquivo markdown")
-  .option("--file <path>", "Caminho do arquivo (default: .codexa/analysis/ARCH-xxx.md)")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectSave(options);
-  });
-
-architectCmd
-  .command("approve")
-  .description("Aprova analise para implementacao")
-  .option("--id <id>", "ID da analise")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectApprove(options);
-  });
-
-architectCmd
-  .command("export")
-  .description("Exporta baby steps como comandos para criar tasks")
-  .option("--id <id>", "ID da analise")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectExport(options);
-  });
-
-architectCmd
-  .command("cancel")
-  .description("Cancela analise pendente")
-  .option("--id <id>", "ID da analise")
-  .option("--json", "Saida em JSON")
-  .action((options) => {
-    architectCancel(options);
-  });
-
-// Parse e executa
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import { planStart, planShow, planTaskAdd, planCancel } from "./commands/plan";
+import { checkRequest, checkApprove, checkReject } from "./commands/check";
+import { taskNext, taskStart, taskDone } from "./commands/task";
+import { decide, listDecisions } from "./commands/decide";
+import { reviewStart, reviewApprove, reviewSkip } from "./commands/review";
+import { addKnowledge, listKnowledge, acknowledgeKnowledge, queryGraph } from "./commands/knowledge";
+import { status, contextExport, recover, contextUpdate } from "./commands/utils";
+import {
+  discoverStart,
+  discoverConfirm,
+  discoverShow,
+  discoverSetStack,
+  discoverReset,
+  discoverRefresh,
+  discoverPatterns,
+  discoverPatternsShow,
+  discoverPatternAdd,
+  discoverPatternEdit,
+  discoverPatternRemove,
+  discoverRefreshPatterns,
+  discoverExportPatterns,
+} from "./commands/discover";
+import { clearTasks, clearShow } from "./commands/clear";
+import { standardsList, standardsAdd, standardsEdit, standardsRemove, standardsExport } from "./commands/standards";
+import { productGuide, productImport, productSet, productGoalAdd, productFeatureAdd, productConfirm, productShow, productReset } from "./commands/product";
+import { researchStart, researchShow, researchFill, researchMapAgent, researchReset } from "./commands/research";
+import { patternsExtract, patternsAnalyze } from "./commands/patterns";
+import {
+  architectStart,
+  architectShow,
+  architectList,
+  architectSave,
+  architectApprove,
+  architectExport,
+  architectCancel,
+} from "./commands/architect";
+import { initSchema } from "./db/schema";
+import pkg from "./package.json";
+
+const program = new Command();
+
+program
+  .name("codexa")
+  .description(`Codexa Workflow v${pkg.version} - Sistema de workflow para Claude Code`)
+  .version(pkg.version);
+
+// ═══════════════════════════════════════════════════════════════
+// FASE: PLAN
+// ═══════════════════════════════════════════════════════════════
+
+const planCmd = program.command("plan").description("Comandos da fase PLAN");
+
+planCmd
+  .command("start <description>")
+  .description("Inicia uma nova feature")
+  .option("--from-analysis <id>", "Importar baby steps de analise arquitetural aprovada")
+  .option("--json", "Saida em JSON")
+  .action((description: string, options: { fromAnalysis?: string; json?: boolean }) => {
+    planStart(description, options);
+  });
+
+planCmd
+  .command("show")
+  .description("Mostra o plano atual")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    planShow(options.json);
+  });
+
+planCmd
+  .command("task-add")
+  .description("Adiciona uma task ao plano")
+  .requiredOption("--name <name>", "Nome da task")
+  .option("--agent <agent>", "Agente responsavel (database, backend, frontend, testing)")
+  .option("--depends <ids>", "IDs das tasks que esta depende (ex: 1,2)")
+  .option("--files <files>", "Arquivos esperados (ex: src/a.ts,src/b.ts)")
+  .option("--sequential", "Marca como sequencial (nao paralelizavel)")
+  .action((options) => {
+    planTaskAdd(options);
+  });
+
+planCmd
+  .command("cancel")
+  .description("Cancela a feature atual (soft-cancel, preserva historico)")
+  .action(() => {
+    planCancel();
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// FASE: CHECK
+// ═══════════════════════════════════════════════════════════════
+
+const checkCmd = program.command("check").description("Comandos da fase CHECK");
+
+checkCmd
+  .command("request")
+  .description("Solicita aprovacao do plano")
+  .action(() => {
+    checkRequest();
+  });
+
+checkCmd
+  .command("approve")
+  .description("Aprova o plano")
+  .action(() => {
+    checkApprove();
+  });
+
+checkCmd
+  .command("reject <reason>")
+  .description("Rejeita o plano com motivo")
+  .action((reason: string) => {
+    checkReject(reason);
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// FASE: IMP (Implementacao)
+// ═══════════════════════════════════════════════════════════════
+
+const taskCmd = program.command("task").description("Comandos da fase IMP");
+
+taskCmd
+  .command("next")
+  .description("Mostra proximas tasks disponiveis")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    taskNext(options.json);
+  });
+
+taskCmd
+  .command("start <ids>")
+  .description("Inicia task(s) - pode ser multiplas separadas por virgula")
+  .option("--json", "Saida em JSON")
+  .action((ids: string, options) => {
+    taskStart(ids, options.json);
+  });
+
+taskCmd
+  .command("done <id>")
+  .description("Completa uma task")
+  .option("--checkpoint <text>", "Resumo do que foi feito (extraido automaticamente de --output)")
+  .option("--output <json>", "Retorno JSON do subagent (processa automaticamente)")
+  .option("--files <files>", "Arquivos criados/modificados (extraido automaticamente de --output)")
+  .option("--force", "Ignorar validacao de standards (sera registrado)")
+  .option("--force-reason <reason>", "Motivo do bypass de validacao")
+  .action((id: string, options) => {
+    // Checkpoint obrigatorio se nao houver --output
+    if (!options.output && !options.checkpoint) {
+      console.error("\n[ERRO] Checkpoint obrigatorio.");
+      console.error("Use: --checkpoint 'resumo' ou --output '{json do subagent}'\n");
+      process.exit(1);
+    }
+
+    taskDone(id, {
+      checkpoint: options.checkpoint || "",
+      files: options.files,
+      force: options.force,
+      forceReason: options.forceReason,
+      output: options.output,
+    });
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// DECISOES
+// ═══════════════════════════════════════════════════════════════
+
+program
+  .command("decide <title> <decision>")
+  .description("Registra uma decisao")
+  .option("--rationale <text>", "Justificativa da decisao")
+  .option("--force", "Ignorar deteccao de conflitos")
+  .action((title: string, decision: string, options) => {
+    decide(title, decision, options);
+  });
+
+program
+  .command("decisions")
+  .description("Lista decisoes")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    listDecisions(options.json);
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// KNOWLEDGE BROADCAST
+// ═══════════════════════════════════════════════════════════════
+
+const knowledgeCmd = program.command("knowledge").description("Comandos de knowledge broadcast entre tasks");
+
+knowledgeCmd
+  .command("add")
+  .description("Adiciona knowledge para broadcast")
+  .requiredOption("--content <text>", "Conteudo do knowledge")
+  .requiredOption("--category <cat>", "Categoria (discovery, decision, blocker, pattern, constraint)")
+  .option("--severity <level>", "Severidade (info, warning, critical)", "info")
+  .option("--broadcast <target>", "Destino (all ou IDs separados por virgula)", "all")
+  .action((options) => {
+    addKnowledge({
+      content: options.content,
+      category: options.category,
+      severity: options.severity,
+      broadcastTo: options.broadcast,
+    });
+  });
+
+knowledgeCmd
+  .command("list")
+  .description("Lista knowledge da feature atual")
+  .option("--unread", "Apenas nao lidos pela task atual")
+  .option("--category <cat>", "Filtrar por categoria")
+  .option("--severity <level>", "Filtrar por severidade (critical, warning, info)")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    listKnowledge(options);
+  });
+
+knowledgeCmd
+  .command("ack <id>")
+  .description("Marca knowledge como lido pela task atual")
+  .action((id: string) => {
+    acknowledgeKnowledge(id);
+  });
+
+knowledgeCmd
+  .command("graph")
+  .description("Consulta o knowledge graph (relacoes entre arquivos, decisoes, patterns)")
+  .option("--file <path>", "Buscar relacoes de um arquivo")
+  .option("--decision <id>", "Buscar arquivos afetados por uma decisao")
+  .option("--contradictions", "Detectar contradicoes entre decisoes")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    queryGraph(options);
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// FASE: REV (Review)
+// ═══════════════════════════════════════════════════════════════
+
+const reviewCmd = program.command("review").description("Comandos da fase REV");
+
+reviewCmd
+  .command("start")
+  .description("Inicia o review")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    reviewStart(options.json);
+  });
+
+reviewCmd
+  .command("approve")
+  .description("Aprova o review e finaliza a feature")
+  .action(() => {
+    reviewApprove();
+  });
+
+reviewCmd
+  .command("skip")
+  .description("Pula o review e finaliza a feature diretamente")
+  .action(() => {
+    reviewSkip();
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// UTILITARIOS
+// ═══════════════════════════════════════════════════════════════
+
+program
+  .command("status")
+  .description("Mostra status atual")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    status(options.json);
+  });
+
+const contextCmd = program.command("context").description("Comandos de contexto");
+
+contextCmd
+  .command("export")
+  .description("Exporta contexto para subagent")
+  .option("--task <id>", "ID da task especifica")
+  .action((options) => {
+    contextExport({ ...options, json: true }); // Sempre JSON
+  });
+
+contextCmd
+  .command("update")
+  .description("Atualiza contexto durante implementacao")
+  .option("--approach <text>", "Adiciona nova abordagem descoberta")
+  .option("--pattern <text>", "Registra padrao identificado no codigo")
+  .option("--constraint <text>", "Adiciona nova limitacao encontrada")
+  .action((options) => {
+    contextUpdate(options);
+  });
+
+// Manter compatibilidade: context sem subcomando = export
+program
+  .command("ctx")
+  .description("Alias para context export (compatibilidade)")
+  .option("--task <id>", "ID da task especifica")
+  .action((options) => {
+    contextExport({ ...options, json: true });
+  });
+
+program
+  .command("recover")
+  .description("Gerencia snapshots para recovery")
+  .option("--list", "Lista snapshots disponiveis")
+  .option("--snapshot <id>", "Mostra detalhes de um snapshot")
+  .option("--restore", "Restaura o snapshot especificado")
+  .option("--auto", "Restaura o ultimo snapshot automaticamente")
+  .action((options) => {
+    recover(options);
+  });
+
+program
+  .command("init")
+  .description("Inicializa o banco de dados")
+  .action(() => {
+    initSchema();
+    console.log("\nBanco de dados inicializado em .codexa/db/workflow.db\n");
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// DISCOVER
+// ═══════════════════════════════════════════════════════════════
+
+const discoverCmd = program.command("discover").description("Comandos de descoberta do projeto");
+
+discoverCmd
+  .command("start")
+  .description("Inicia descoberta automatica do projeto")
+  .option("--json", "Saida em JSON")
+  .action(async (options) => {
+    await discoverStart(options.json);
+  });
+
+discoverCmd
+  .command("confirm")
+  .description("Confirma e salva a descoberta")
+  .action(() => {
+    discoverConfirm();
+  });
+
+discoverCmd
+  .command("show")
+  .description("Mostra projeto descoberto")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    discoverShow(options.json);
+  });
+
+discoverCmd
+  .command("set-stack")
+  .description("Define ou ajusta stack manualmente")
+  .option("--frontend <value>", "Frontend (next, react, vue, flutter)")
+  .option("--backend <value>", "Backend (node, bun, csharp, python, go)")
+  .option("--database <value>", "Database (postgres, mongodb, prisma)")
+  .option("--orm <value>", "ORM (drizzle, prisma, typeorm, sequelize)")
+  .option("--styling <value>", "Styling (tailwind, styled-components)")
+  .option("--auth <value>", "Auth (supabase, next-auth, clerk)")
+  .option("--testing <value>", "Testing (vitest, jest, playwright)")
+  .action((options) => {
+    discoverSetStack(options);
+  });
+
+discoverCmd
+  .command("reset")
+  .description("Reseta descoberta para refazer")
+  .action(() => {
+    discoverReset();
+  });
+
+discoverCmd
+  .command("refresh")
+  .description("Re-detecta stack e mostra mudancas")
+  .option("--force", "Aplica as mudancas detectadas")
+  .action(async (options) => {
+    await discoverRefresh(options);
+  });
+
+// ─────────────────────────────────────────────────────────────────
+// PATTERNS (v7.4)
+// ─────────────────────────────────────────────────────────────────
+
+discoverCmd
+  .command("patterns")
+  .description("Lista implementation patterns extraidos")
+  .option("--category <cat>", "Filtrar por categoria")
+  .option("--show <name>", "Mostra detalhes de um pattern")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    if (options.show) {
+      discoverPatternsShow(options.show, options.json);
+    } else {
+      discoverPatterns({ category: options.category, json: options.json });
+    }
+  });
+
+discoverCmd
+  .command("pattern-add")
+  .description("Adiciona um implementation pattern")
+  .requiredOption("--category <cat>", "Categoria (component, hook, service, route, schema, test, action)")
+  .requiredOption("--name <name>", "Nome unico do pattern")
+  .requiredOption("--scope <scope>", "Escopo (frontend, backend, database, testing)")
+  .requiredOption("--applies-to <glob>", "Glob pattern dos arquivos (ex: src/components/**/*.tsx)")
+  .requiredOption("--structure <json>", "JSON com estrutura (imports, exports, patterns, conventions)")
+  .requiredOption("--template <code>", "Template com placeholders")
+  .requiredOption("--examples <json>", "JSON array de exemplos [{path, relevance}]")
+  .option("--anti-patterns <json>", "JSON array de anti-patterns")
+  .option("--confidence <num>", "Confianca 0-1", "0.8")
+  .option("--extracted-from <num>", "Numero de arquivos analisados", "1")
+  .action((options) => {
+    discoverPatternAdd({
+      category: options.category,
+      name: options.name,
+      scope: options.scope,
+      appliesTo: options.appliesTo,
+      structure: options.structure,
+      template: options.template,
+      examples: options.examples,
+      antiPatterns: options.antiPatterns,
+      confidence: parseFloat(options.confidence),
+      extractedFrom: parseInt(options.extractedFrom),
+    });
+  });
+
+discoverCmd
+  .command("pattern-edit <name>")
+  .description("Edita um implementation pattern")
+  .option("--category <cat>", "Nova categoria")
+  .option("--scope <scope>", "Novo escopo")
+  .option("--applies-to <glob>", "Novo glob pattern")
+  .option("--structure <json>", "Nova estrutura JSON")
+  .option("--template <code>", "Novo template")
+  .option("--examples <json>", "Novos exemplos JSON")
+  .option("--anti-patterns <json>", "Novos anti-patterns JSON")
+  .option("--confidence <num>", "Nova confianca 0-1")
+  .action((name, options) => {
+    discoverPatternEdit(name, {
+      category: options.category,
+      scope: options.scope,
+      appliesTo: options.appliesTo,
+      structure: options.structure,
+      template: options.template,
+      examples: options.examples,
+      antiPatterns: options.antiPatterns,
+      confidence: options.confidence ? parseFloat(options.confidence) : undefined,
+    });
+  });
+
+discoverCmd
+  .command("pattern-remove <name>")
+  .description("Remove um implementation pattern")
+  .action((name) => {
+    discoverPatternRemove(name);
+  });
+
+discoverCmd
+  .command("refresh-patterns")
+  .description("Re-extrai patterns do codigo (requer analise manual)")
+  .action(() => {
+    discoverRefreshPatterns();
+  });
+
+// v8.0: Extração automática de patterns via grepai
+discoverCmd
+  .command("extract-patterns")
+  .description("Extrai patterns automaticamente via grepai (busca semântica)")
+  .option("--scope <scope>", "Escopo (frontend, backend, database, testing)")
+  .option("--all", "Extrair de todos os escopos")
+  .option("--dry-run", "Apenas mostrar o que seria extraido")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    patternsExtract(options);
+  });
+
+discoverCmd
+  .command("analyze-file <path>")
+  .description("Analisa estrutura de um arquivo (imports, exports, convencoes)")
+  .option("--json", "Saida em JSON")
+  .action((path, options) => {
+    patternsAnalyze(path, options.json);
+  });
+
+discoverCmd
+  .command("export-patterns")
+  .description("Regenera arquivo patterns.md")
+  .action(() => {
+    discoverExportPatterns();
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// STANDARDS
+// ═══════════════════════════════════════════════════════════════
+
+const standardsCmd = program.command("standards").description("Comandos de gerenciamento de standards");
+
+standardsCmd
+  .command("list")
+  .description("Lista todos os standards")
+  .option("--category <cat>", "Filtrar por categoria")
+  .option("--scope <scope>", "Filtrar por escopo")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    standardsList(options);
+  });
+
+standardsCmd
+  .command("add")
+  .description("Adiciona um novo standard")
+  .requiredOption("--category <cat>", "Categoria (stack, structure, naming, code, library, practice)")
+  .requiredOption("--scope <scope>", "Escopo (all, database, backend, frontend, testing)")
+  .requiredOption("--rule <rule>", "Regra a ser seguida")
+  .option("--examples <list>", "Exemplos separados por virgula")
+  .option("--anti-examples <list>", "Anti-exemplos separados por virgula")
+  .option("--enforcement <level>", "Nivel de enforcement (required, recommended)")
+  .option("--required", "Alias para --enforcement required")
+  .option("--recommended", "Alias para --enforcement recommended")
+  .action((options) => {
+    // Resolver aliases de enforcement
+    let enforcement = options.enforcement;
+    if (options.required) enforcement = "required";
+    if (options.recommended) enforcement = "recommended";
+
+    standardsAdd({
+      category: options.category,
+      scope: options.scope,
+      rule: options.rule,
+      examples: options.examples,
+      antiExamples: options.antiExamples,
+      enforcement: enforcement,
+    });
+  });
+
+standardsCmd
+  .command("edit <id>")
+  .description("Edita um standard existente")
+  .option("--rule <rule>", "Nova regra")
+  .option("--examples <list>", "Novos exemplos")
+  .option("--anti-examples <list>", "Novos anti-exemplos")
+  .option("--enforcement <level>", "Novo nivel de enforcement")
+  .action((id, options) => {
+    standardsEdit(id, {
+      rule: options.rule,
+      examples: options.examples,
+      antiExamples: options.antiExamples,
+      enforcement: options.enforcement,
+    });
+  });
+
+standardsCmd
+  .command("remove <id>")
+  .description("Remove um standard")
+  .action((id) => {
+    standardsRemove(id);
+  });
+
+standardsCmd
+  .command("export")
+  .description("Regenera arquivo standards.md")
+  .action(() => {
+    standardsExport();
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// PRODUCT (Contexto de Produto / PRD)
+// ═══════════════════════════════════════════════════════════════
+
+const productCmd = program.command("product").description("Comandos de contexto de produto (PRD)");
+
+productCmd
+  .command("guide")
+  .description("Inicia modo guiado para definir contexto de produto")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    productGuide(options.json);
+  });
+
+productCmd
+  .command("import")
+  .description("Importa PRD existente")
+  .option("--file <path>", "Caminho para arquivo PRD")
+  .option("--content <text>", "Conteudo do PRD")
+  .action((options) => {
+    productImport(options);
+  });
+
+productCmd
+  .command("set")
+  .description("Define campos do contexto de produto")
+  .option("--name <name>", "Nome do produto")
+  .option("--problem <text>", "Problema que o produto resolve")
+  .option("--solution <text>", "Solucao proposta")
+  .option("--targetUsers <text>", "Usuarios alvo")
+  .option("--valueProposition <text>", "Proposta de valor")
+  .option("--successMetrics <list>", "Metricas de sucesso (separadas por virgula)")
+  .option("--outOfScope <list>", "Itens fora do escopo (separados por virgula)")
+  .option("--constraints <list>", "Restricoes (separadas por virgula)")
+  .action((options) => {
+    productSet(options);
+  });
+
+productCmd
+  .command("goal-add")
+  .description("Adiciona um objetivo do produto")
+  .requiredOption("--category <cat>", "Categoria (negocio, tecnico, usuario, operacional)")
+  .requiredOption("--goal <text>", "Descricao do objetivo")
+  .option("--priority <level>", "Prioridade (high, medium, low)", "medium")
+  .action((options) => {
+    productGoalAdd(options);
+  });
+
+productCmd
+  .command("feature-add")
+  .description("Adiciona uma feature core do produto")
+  .requiredOption("--name <name>", "Nome da feature")
+  .option("--description <text>", "Descricao da feature")
+  .option("--priority <level>", "Prioridade (high, medium, low)", "medium")
+  .action((options) => {
+    productFeatureAdd(options);
+  });
+
+productCmd
+  .command("show")
+  .description("Mostra contexto de produto")
+  .option("--json", "Saida em JSON")
+  .option("--pending", "Mostra contexto pendente (nao confirmado)")
+  .action((options) => {
+    productShow(options);
+  });
+
+productCmd
+  .command("confirm")
+  .description("Confirma e salva o contexto de produto")
+  .action(() => {
+    productConfirm();
+  });
+
+productCmd
+  .command("reset")
+  .description("Reseta contexto de produto para refazer")
+  .action(() => {
+    productReset();
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// RESEARCH (Contexto de Bibliotecas)
+// ═══════════════════════════════════════════════════════════════
+
+const researchCmd = program.command("research").description("Comandos de pesquisa de contexto de bibliotecas");
+
+researchCmd
+  .command("start")
+  .description("Detecta bibliotecas do projeto e cria arquivos de contexto")
+  .option("--json", "Saida em JSON")
+  .action(async (options) => {
+    await researchStart(options);
+  });
+
+researchCmd
+  .command("show")
+  .description("Mostra status das bibliotecas detectadas")
+  .option("--json", "Saida em JSON")
+  .option("--lib <name>", "Filtrar por biblioteca especifica")
+  .action((options) => {
+    researchShow(options);
+  });
+
+researchCmd
+  .command("fill <lib>")
+  .description("Gera instrucoes para preencher contexto de uma biblioteca")
+  .option("--json", "Saida em JSON")
+  .action((lib: string, options) => {
+    researchFill(lib, options);
+  });
+
+researchCmd
+  .command("map-agent")
+  .description("Gerencia mapeamento de bibliotecas para agentes")
+  .requiredOption("--agent <type>", "Tipo do agente (frontend, backend, database, testing)")
+  .option("--add <libs>", "Adicionar bibliotecas (separadas por virgula)")
+  .option("--remove <libs>", "Remover bibliotecas (separadas por virgula)")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    researchMapAgent(options);
+  });
+
+researchCmd
+  .command("reset")
+  .description("Remove todos os contextos de biblioteca")
+  .action(() => {
+    researchReset();
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// CLEAR (Limpeza de Tasks - v8.0: limpeza completa removida)
+// ═══════════════════════════════════════════════════════════════
+
+program
+  .command("clear")
+  .description("Limpa tasks/features mantendo configuracoes do projeto (standards, patterns, PRD)")
+  .option("--force", "Confirma a limpeza (sem isso apenas mostra o que sera removido)")
+  .option("--show", "Mostra estado atual dos arquivos do workflow")
+  .action((options) => {
+    if (options.show) {
+      clearShow();
+    } else {
+      clearTasks({ force: options.force });
+    }
+  });
+
+// ═══════════════════════════════════════════════════════════════
+// ARCHITECT (Analise Arquitetural)
+// ═══════════════════════════════════════════════════════════════
+
+const architectCmd = program.command("architect").description("Comandos de analise arquitetural");
+
+architectCmd
+  .command("start <description>")
+  .description("Inicia nova analise arquitetural")
+  .option("--json", "Saida em JSON")
+  .action((description: string, options) => {
+    architectStart(description, options);
+  });
+
+architectCmd
+  .command("show")
+  .description("Mostra analise atual ou especifica")
+  .option("--id <id>", "ID da analise")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    architectShow(options);
+  });
+
+architectCmd
+  .command("list")
+  .description("Lista todas as analises")
+  .option("--status <status>", "Filtrar por status (pending, approved, implemented, rejected)")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    architectList(options);
+  });
+
+architectCmd
+  .command("save")
+  .description("Salva analise em arquivo markdown")
+  .option("--file <path>", "Caminho do arquivo (default: .codexa/analysis/ARCH-xxx.md)")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    architectSave(options);
+  });
+
+architectCmd
+  .command("approve")
+  .description("Aprova analise para implementacao")
+  .option("--id <id>", "ID da analise")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    architectApprove(options);
+  });
+
+architectCmd
+  .command("export")
+  .description("Exporta baby steps como comandos para criar tasks")
+  .option("--id <id>", "ID da analise")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    architectExport(options);
+  });
+
+architectCmd
+  .command("cancel")
+  .description("Cancela analise pendente")
+  .option("--id <id>", "ID da analise")
+  .option("--json", "Saida em JSON")
+  .action((options) => {
+    architectCancel(options);
+  });
+
+// Parse e executa
 program.parse();