@codexa/cli 8.5.0 → 8.6.0

package/commands/utils.ts

@@ -1,1021 +1,1021 @@
-import { getDb } from "../db/connection";
-import { initSchema, getPatternsForFiles, getLastSessionSummary, getSessionSummaries, getRelatedDecisions, findContradictions, getArchitecturalAnalysisForSpec, getUtilitiesForContext } from "../db/schema";
-import { getKnowledgeForTask } from "./knowledge";
-import { getLibContextsForAgent } from "./research";
-
-// v8.3: Limite maximo de contexto para subagents (16KB)
-const MAX_CONTEXT_SIZE = 16384;
-
-export function contextUpdate(options: {
-    approach?: string;
-    pattern?: string;
-    constraint?: string;
-}): void {
-    initSchema();
-    const db = getDb();
-
-    const spec = db
-        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
-        .get() as any;
-
-    if (!spec) {
-        console.error("\nNenhuma feature ativa.\n");
-        process.exit(1);
-    }
-
-    // Verificar se está na fase de implementação
-    if (spec.phase !== "implementing") {
-        console.error(`\nContexto só pode ser atualizado na fase 'implementing'.`);
-        console.error(`Fase atual: ${spec.phase}\n`);
-        process.exit(1);
-    }
-
-    const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(spec.id) as any;
-    const now = new Date().toISOString();
-
-    let updated = false;
-
-    if (options.approach) {
-        // Append ao approach existente, não substitui
-        const currentApproach = context?.approach || "";
-        const newApproach = currentApproach
-            ? `${currentApproach}\n- ${options.approach}`
-            : options.approach;
-
-        db.run("UPDATE context SET approach = ?, updated_at = ? WHERE spec_id = ?", [
-            newApproach,
-            now,
-            spec.id,
-        ]);
-        console.log(`\n✓ Approach atualizado`);
-        updated = true;
-    }
-
-    if (options.pattern) {
-        // Adiciona ao array de patterns
-        const currentPatterns = context?.patterns ? JSON.parse(context.patterns) : [];
-        currentPatterns.push({
-            pattern: options.pattern,
-            detected_at: now,
-        });
-
-        db.run("UPDATE context SET patterns = ?, updated_at = ? WHERE spec_id = ?", [
-            JSON.stringify(currentPatterns),
-            now,
-            spec.id,
-        ]);
-        console.log(`✓ Pattern adicionado (total: ${currentPatterns.length})`);
-        updated = true;
-    }
-
-    if (options.constraint) {
-        // Adiciona ao array de constraints
-        const currentConstraints = context?.constraints ? JSON.parse(context.constraints) : [];
-        currentConstraints.push({
-            constraint: options.constraint,
-            added_at: now,
-        });
-
-        db.run("UPDATE context SET constraints = ?, updated_at = ? WHERE spec_id = ?", [
-            JSON.stringify(currentConstraints),
-            now,
-            spec.id,
-        ]);
-        console.log(`✓ Constraint adicionado (total: ${currentConstraints.length})`);
-        updated = true;
-    }
-
-    if (!updated) {
-        console.log("\nNenhuma opcao fornecida.");
-        console.log("Use:");
-        console.log("  --approach 'Nova abordagem descoberta'");
-        console.log("  --pattern 'Padrao identificado no codigo'");
-        console.log("  --constraint 'Nova limitacao encontrada'\n");
-        return;
-    }
-
-    console.log(`\nContexto atualizado para: ${spec.name}\n`);
-}
-
-export function status(json: boolean = false): void {
-    initSchema();
-
-    const db = getDb();
-
-    const spec = db
-        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
-        .get() as any;
-
-    if (!spec) {
-        if (json) {
-            console.log(JSON.stringify({ active: false, message: "Nenhuma feature ativa" }));
-        } else {
-            console.log("\nNenhuma feature ativa.");
-            console.log("Inicie com: /codexa:feature\n");
-        }
-        return;
-    }
-
-    const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(spec.id) as any;
-    const tasks = db.query("SELECT * FROM tasks WHERE spec_id = ?").all(spec.id) as any[];
-    const decisions = db.query("SELECT * FROM decisions WHERE spec_id = ? AND status = 'active'").all(spec.id) as any[];
-
-    const tasksDone = tasks.filter((t) => t.status === "done").length;
-    const tasksRunning = tasks.filter((t) => t.status === "running").length;
-    const tasksPending = tasks.filter((t) => t.status === "pending").length;
-
-    const progress = tasks.length > 0 ? Math.round((tasksDone / tasks.length) * 100) : 0;
-
-    if (json) {
-        console.log(
-            JSON.stringify({
-                active: true,
-                spec,
-                context,
-                progress: {
-                    done: tasksDone,
-                    running: tasksRunning,
-                    pending: tasksPending,
-                    total: tasks.length,
-                    percent: progress,
-                },
-                decisions: decisions.length,
-            })
-        );
-        return;
-    }
-
-    console.log(`\n${"=".repeat(60)}`);
-    console.log(`STATUS: ${spec.name}`);
-    console.log(`${"=".repeat(60)}`);
-    console.log(`\nSpec ID: ${spec.id}`);
-    console.log(`Fase: ${spec.phase}`);
-    console.log(`Aprovado: ${spec.approved_at ? "Sim" : "Nao"}`);
-
-    console.log(`\nProgresso:`);
-    const bar = "█".repeat(Math.floor(progress / 5)) + "░".repeat(20 - Math.floor(progress / 5));
-    console.log(`  [${bar}] ${progress}%`);
-    console.log(`  Concluidas: ${tasksDone}/${tasks.length}`);
-    console.log(`  Em execucao: ${tasksRunning}`);
-    console.log(`  Pendentes: ${tasksPending}`);
-
-    if (context?.last_checkpoint) {
-        console.log(`\nUltimo checkpoint:`);
-        console.log(`  ${context.last_checkpoint}`);
-    }
-
-    if (decisions.length > 0) {
-        console.log(`\nDecisoes ativas: ${decisions.length}`);
-    }
-
-    // v8.1: Mostrar ultimo session summary para continuidade
-    const lastSession = getLastSessionSummary(spec.id);
-    if (lastSession) {
-        console.log(`\nUltima sessao:`);
-        console.log(`  ${lastSession.summary}`);
-        if (lastSession.next_steps) {
-            try {
-                const nextSteps = JSON.parse(lastSession.next_steps);
-                if (nextSteps.length > 0) {
-                    console.log(`  Proximos passos sugeridos:`);
-                    for (const step of nextSteps.slice(0, 3)) {
-                        console.log(`    - ${step}`);
-                    }
-                }
-            } catch { /* ignore */ }
-        }
-        if (lastSession.blockers) {
-            try {
-                const blockers = JSON.parse(lastSession.blockers);
-                if (blockers.length > 0) {
-                    console.log(`  Blockers pendentes:`);
-                    for (const b of blockers) {
-                        console.log(`    [!] ${b}`);
-                    }
-                }
-            } catch { /* ignore */ }
-        }
-    }
-
-    console.log(`\n${"─".repeat(60)}`);
-
-    // Sugerir proximo passo
-    switch (spec.phase) {
-        case "planning":
-            console.log(`Proximo: plan task-add ou check request`);
-            break;
-        case "checking":
-            console.log(`Proximo: check approve ou check reject`);
-            break;
-        case "implementing":
-            console.log(`Proximo: task next`);
-            break;
-        case "reviewing":
-            console.log(`Proximo: review approve`);
-            break;
-    }
-    console.log();
-}
-
-export function contextExport(options: { task?: string; json?: boolean; }): void {
-    initSchema();
-
-    const db = getDb();
-
-    const spec = db
-        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
-        .get() as any;
-
-    if (!spec) {
-        console.error("\nNenhuma feature ativa.\n");
-        process.exit(1);
-    }
-
-    const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(spec.id) as any;
-    const decisions = db
-        .query("SELECT * FROM decisions WHERE spec_id = ? AND status = 'active'")
-        .all(spec.id) as any[];
-    const artifacts = db.query("SELECT * FROM artifacts WHERE spec_id = ?").all(spec.id) as any[];
-    const project = db.query("SELECT * FROM project WHERE id = 'default'").get() as any;
-
-    let taskContext = null;
-    let standards: any[] = [];
-    let knowledge: any[] = [];
-    let libContexts: string[] = [];
-
-    if (options.task) {
-        const taskId = parseInt(options.task);
-        const task = db.query("SELECT * FROM tasks WHERE id = ?").get(taskId) as any;
-        if (task) {
-            taskContext = {
-                id: task.id,
-                number: task.number,
-                name: task.name,
-                agent: task.agent,
-                files: task.files ? JSON.parse(task.files) : [],
-            };
-
-            // Obter standards para o agente da task
-            const domain = task.agent?.split("-")[0] || "all";
-            standards = db
-                .query(
-                    `SELECT * FROM standards
-           WHERE scope = 'all' OR scope = ?
-           ORDER BY enforcement DESC, category`
-                )
-                .all(domain) as any[];
-
-            standards = standards.map((std) => ({
-                category: std.category,
-                rule: std.rule,
-                examples: std.examples ? JSON.parse(std.examples) : [],
-                anti_examples: std.anti_examples ? JSON.parse(std.anti_examples) : [],
-                enforcement: std.enforcement,
-            }));
-
-            // Obter knowledge broadcast (automatico)
-            knowledge = getKnowledgeForTask(spec.id, taskId).map((k) => ({
-                id: k.id,
-                category: k.category,
-                content: k.content,
-                severity: k.severity,
-                origin_task: k.task_origin,
-                created_at: k.created_at,
-            }));
-
-            // Obter lib-contexts para o agente da task
-            if (task.agent) {
-                libContexts = getLibContextsForAgent(task.agent);
-            }
-        }
-    }
-
-    // Obter contexto de produto
-    const productContext = db.query("SELECT * FROM product_context WHERE id = 'default'").get() as any;
-    const productGoals = db.query("SELECT * FROM product_goals WHERE product_id = 'default'").all() as any[];
-    const productFeatures = db.query("SELECT * FROM product_features WHERE product_id = 'default'").all() as any[];
-
-    const exportData = {
-        spec: {
-            id: spec.id,
-            name: spec.name,
-            phase: spec.phase,
-        },
-        project: project ? {
-            stack: JSON.parse(project.stack),
-        } : null,
-        productContext: productContext ? {
-            name: productContext.name,
-            problem: productContext.problem,
-            solution: productContext.solution,
-            targetUsers: productContext.target_users,
-            valueProposition: productContext.value_proposition,
-            outOfScope: productContext.out_of_scope ? JSON.parse(productContext.out_of_scope) : [],
-            constraints: productContext.constraints ? JSON.parse(productContext.constraints) : [],
-        } : null,
-        productGoals: productGoals.map((g) => ({
-            category: g.category,
-            goal: g.goal,
-            priority: g.priority,
-        })),
-        productFeatures: productFeatures.map((f) => ({
-            name: f.name,
-            description: f.description,
-            priority: f.priority,
-        })),
-        objective: context?.objective,
-        approach: context?.approach,
-        patterns: context?.patterns ? JSON.parse(context.patterns) : [],
-        constraints: context?.constraints ? JSON.parse(context.constraints) : [],
-        decisions: decisions.map((d) => ({
-            id: d.id,
-            title: d.title,
-            decision: d.decision,
-        })),
-        artifacts: artifacts.map((a) => a.path),
-        task: taskContext,
-        standards: standards,
-        knowledge: knowledge,
-        libContexts: libContexts,
-    };
-
-    console.log(JSON.stringify(exportData, null, 2));
-}
-
-// Funcao helper para formatar contexto para subagent (uso interno)
-// v8.1: Contexto COMPLETO mas ESTRUTURADO - todas as fontes relevantes incluidas
-export function getContextForSubagent(taskId: number): string {
-    initSchema();
-
-    const db = getDb();
-
-    const task = db.query("SELECT * FROM tasks WHERE id = ?").get(taskId) as any;
-    if (!task) {
-        return "ERRO: Task nao encontrada";
-    }
-
-    const spec = db.query("SELECT * FROM specs WHERE id = ?").get(task.spec_id) as any;
-    const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(task.spec_id) as any;
-    const project = db.query("SELECT * FROM project WHERE id = 'default'").get() as any;
-
-    // v8.4: Analise arquitetural (link explicito via analysis_id ou nome)
-    const archAnalysis = getArchitecturalAnalysisForSpec(spec.name, task.spec_id);
-
-    // Arquivos da task para filtrar contexto relevante
-    const taskFiles = task.files ? JSON.parse(task.files) : [];
-    const domain = task.agent?.split("-")[0] || "all";
-
-    // Decisoes relevantes (max 8, priorizando as que mencionam arquivos da task)
-    const allDecisions = db
-        .query("SELECT * FROM decisions WHERE spec_id = ? AND status = 'active' ORDER BY created_at DESC")
-        .all(task.spec_id) as any[];
-    const decisions = filterRelevantDecisions(allDecisions, taskFiles, 8);
-
-    // Standards required + recommended que se aplicam aos arquivos
-    const standards = db
-        .query(
-            `SELECT * FROM standards
-       WHERE (scope = 'all' OR scope = ?)
-       ORDER BY enforcement DESC, category`
-        )
-        .all(domain) as any[];
-    const relevantStandards = filterRelevantStandards(standards, taskFiles);
-
-    // v8.3: Knowledge com TTL, caps e indicadores de truncamento
-    const allKnowledge = getKnowledgeForTask(task.spec_id, taskId);
-    const now48h = new Date(Date.now() - 48 * 60 * 60 * 1000).toISOString();
-    const recentKnowledge = allKnowledge.filter((k: any) => k.created_at > now48h);
-    const staleKnowledge = allKnowledge.filter((k: any) => k.created_at <= now48h);
-    // Conhecimento recente primeiro; stale so se critical
-    const effectiveKnowledge = [
-        ...recentKnowledge,
-        ...staleKnowledge.filter((k: any) => k.severity === 'critical'),
-    ];
-    const allCriticalKnowledge = effectiveKnowledge.filter((k: any) => k.severity === 'critical' || k.severity === 'warning');
-    const criticalKnowledge = allCriticalKnowledge.slice(0, 20);
-    const truncatedCritical = allCriticalKnowledge.length - criticalKnowledge.length;
-    const allInfoKnowledge = effectiveKnowledge.filter((k: any) => k.severity === 'info');
-    const infoKnowledge = allInfoKnowledge.slice(0, 10);
-    const truncatedInfo = allInfoKnowledge.length - infoKnowledge.length;
-
-    // v8.1: Contexto de produto (resumido - problema, usuarios, restricoes)
-    const productContext = db.query("SELECT * FROM product_context WHERE id = 'default'").get() as any;
-
-    // v8.1: Patterns de implementacao matchados aos arquivos da task
-    const patterns = getPatternsForFiles(taskFiles);
-
-    // v8.2: Reasoning de tasks dependentes + todas tasks completas recentes
-    const dependsOn = task.depends_on ? JSON.parse(task.depends_on) : [];
-    const depReasoning: any[] = [];
-    const seenTaskIds = new Set<number>();
-
-    // 1. Reasoning de dependencias diretas (prioridade maxima)
-    if (dependsOn.length > 0) {
-        const placeholders = dependsOn.map(() => '?').join(',');
-        const depTasks = db.query(
-            `SELECT id, number FROM tasks WHERE spec_id = ? AND number IN (${placeholders})`
-        ).all(task.spec_id, ...dependsOn) as any[];
-
-        for (const depTask of depTasks) {
-            seenTaskIds.add(depTask.id);
-            const reasoning = db.query(
-                `SELECT category, thought FROM reasoning_log
-                 WHERE spec_id = ? AND task_id = ?
-                 AND category IN ('recommendation', 'decision', 'challenge')
-                 ORDER BY
-                   CASE importance WHEN 'critical' THEN 1 WHEN 'high' THEN 2 ELSE 3 END,
-                   created_at DESC
-                 LIMIT 3`
-            ).all(task.spec_id, depTask.id) as any[];
-            for (const r of reasoning) {
-                depReasoning.push({ ...r, fromTask: depTask.number });
-            }
-        }
-    }
-
-    // 2. Reasoning de TODAS tasks completas (recommendations e challenges de alta importancia)
-    const completedTasks = db.query(
-        `SELECT t.id, t.number FROM tasks t
-         WHERE t.spec_id = ? AND t.status = 'done' AND t.id != ?
-         ORDER BY t.completed_at DESC LIMIT 10`
-    ).all(task.spec_id, taskId) as any[];
-
-    for (const ct of completedTasks) {
-        if (seenTaskIds.has(ct.id)) continue;
-        const reasoning = db.query(
-            `SELECT category, thought FROM reasoning_log
-             WHERE spec_id = ? AND task_id = ?
-             AND category IN ('recommendation', 'challenge')
-             AND importance IN ('critical', 'high')
-             ORDER BY
-               CASE importance WHEN 'critical' THEN 1 ELSE 2 END,
-               created_at DESC
-             LIMIT 2`
-        ).all(task.spec_id, ct.id) as any[];
-        for (const r of reasoning) {
-            depReasoning.push({ ...r, fromTask: ct.number });
-        }
-    }
-
-    // v8.1: Lib contexts do projeto (resumido - nomes e versoes)
-    const libContexts = db.query(
-        "SELECT lib_name, version FROM lib_contexts ORDER BY lib_name LIMIT 10"
-    ).all() as any[];
-
-    // v8.3: Sessoes compostas para continuidade cross-session (todas, nao so ultima)
-    const sessions = getSessionSummaries(task.spec_id, 5);
-
-    // v8.2: Knowledge graph - decisoes que afetam arquivos da task
-    const graphDecisions: any[] = [];
-    for (const file of taskFiles) {
-        try {
-            const related = getRelatedDecisions(file, "file");
-            for (const d of related) {
-                if (!graphDecisions.find((gd: any) => gd.id === d.id)) {
-                    graphDecisions.push(d);
-                }
-            }
-        } catch { /* ignore if graph empty */ }
-    }
-
-    // v8.2: Deteccao de contradicoes
-    let contradictions: any[] = [];
-    try {
-        contradictions = findContradictions(task.spec_id);
-    } catch { /* ignore if no contradictions */ }
-
-    // v8.2: Patterns descobertos por subagents anteriores
-    const discoveredPatterns = context?.patterns ? JSON.parse(context.patterns) : [];
-
-    // ===== MONTAR OUTPUT ESTRUTURADO =====
-
-    let output = `## CONTEXTO (Task #${task.number})
-
-**Feature:** ${spec.name}
-**Objetivo:** ${context?.objective || "N/A"}
-**Arquivos:** ${taskFiles.join(", ") || "Nenhum especificado"}
-`;
-
-    // Contexto de produto
-    if (productContext) {
-        output += `
-### PRODUTO
-- **Problema:** ${productContext.problem || "N/A"}
-- **Usuarios:** ${productContext.target_users || "N/A"}`;
-        if (productContext.constraints) {
-            try {
-                const constraints = JSON.parse(productContext.constraints);
-                if (constraints.length > 0) {
-                    output += `\n- **Restricoes:** ${constraints.slice(0, 3).join("; ")}${constraints.length > 3 ? ` [+${constraints.length - 3} mais]` : ''}`;
-                }
-            } catch { /* ignore parse errors */ }
-        }
-        output += "\n";
-    }
-
-    // v8.3: Secao ARQUITETURA (Fase 3 - Architect Pipeline)
-    if (archAnalysis) {
-        output += `
-### ARQUITETURA (${archAnalysis.id})`;
-        if (archAnalysis.approach) {
-            const approachPreview = archAnalysis.approach.length > 500
-                ? archAnalysis.approach.substring(0, 500) + "..."
-                : archAnalysis.approach;
-            output += `\n**Abordagem:** ${approachPreview}`;
-        }
-        if (archAnalysis.risks) {
-            try {
-                const risks = JSON.parse(archAnalysis.risks);
-                if (risks.length > 0) {
-                    const highRisks = risks.filter((r: any) => r.impact === 'high' || r.probability === 'high');
-                    const risksToShow = highRisks.length > 0 ? highRisks.slice(0, 3) : risks.slice(0, 3);
-                    output += `\n**Riscos:**`;
-                    for (const r of risksToShow) {
-                        output += `\n  - ${r.description} (${r.probability}/${r.impact}) -> ${r.mitigation}`;
-                    }
-                    if (risks.length > risksToShow.length) {
-                        output += `\n  [+${risks.length - risksToShow.length} mais riscos]`;
-                    }
-                }
-            } catch { /* ignore */ }
-        }
-        if (archAnalysis.decisions) {
-            try {
-                const archDecisions = JSON.parse(archAnalysis.decisions);
-                if (archDecisions.length > 0) {
-                    output += `\n**Decisoes arquiteturais:**`;
-                    for (const d of archDecisions.slice(0, 5)) {
-                        output += `\n  - ${d.decision}: ${d.rationale || ''}`;
-                    }
-                    if (archDecisions.length > 5) {
-                        output += `\n  [+${archDecisions.length - 5} mais]`;
-                    }
-                }
-            } catch { /* ignore */ }
-        }
-        output += "\n";
-    }
-
-    // Standards
-    const requiredStds = relevantStandards.filter((s: any) => s.enforcement === 'required');
-    const recommendedStds = relevantStandards.filter((s: any) => s.enforcement === 'recommended');
-
-    output += `
-### STANDARDS (${relevantStandards.length})`;
-    if (requiredStds.length > 0) {
-        output += `\n**Obrigatorios:**\n${requiredStds.map((s: any) => `- ${s.rule}`).join("\n")}`;
-    }
-    if (recommendedStds.length > 0) {
-        output += `\n**Recomendados:**\n${recommendedStds.map((s: any) => `- ${s.rule}`).join("\n")}`;
-    }
-    if (relevantStandards.length === 0) {
-        output += "\nNenhum standard aplicavel";
-    }
-    output += "\n";
-
-    // v8.3: Decisoes com indicador de truncamento
-    const truncatedDecisions = allDecisions.length - decisions.length;
-    output += `
-### DECISOES (${decisions.length}${truncatedDecisions > 0 ? ` [+${truncatedDecisions} mais - use: decisions list]` : ''})
-${decisions.length > 0 ? decisions.map((d) => `- **${d.title}**: ${d.decision}`).join("\n") : "Nenhuma"}
-`;
-
-    // Reasoning de tasks anteriores
-    if (depReasoning.length > 0) {
-        output += `
-### CONTEXTO DE TASKS ANTERIORES
-${depReasoning.map((r: any) => `- [Task #${r.fromTask}/${r.category}] ${r.thought}`).join("\n")}
-`;
-    }
-
-    // v8.3: Alertas com cap de 20 e indicador de truncamento
-    if (criticalKnowledge.length > 0) {
-        const severityIcon: Record<string, string> = { warning: "!!", critical: "XX" };
-        output += `
-### ALERTAS (${criticalKnowledge.length}${truncatedCritical > 0 ? ` [+${truncatedCritical} mais - use: knowledge list --severity warning]` : ''})
-${criticalKnowledge.map((k: any) => `[${severityIcon[k.severity] || "!"}] ${k.content}`).join("\n")}
-`;
-    }
-
-    // v8.3: Discoveries com indicador de truncamento
-    if (infoKnowledge.length > 0) {
-        output += `
-### DISCOVERIES DE TASKS ANTERIORES (${infoKnowledge.length}${truncatedInfo > 0 ? ` [+${truncatedInfo} mais - use: knowledge list]` : ''})
-${infoKnowledge.map((k: any) => `- ${k.content}`).join("\n")}
-`;
-    }
-
-    // Patterns de implementacao matchados
-    if (patterns.length > 0) {
-        output += `
-### PATTERNS DO PROJETO (${patterns.length})
-${patterns.map((p: any) => {
-    const tmpl = p.template || "";
-    const preview = tmpl.length > 200 ? tmpl.substring(0, 200) + `... [truncado de ${tmpl.length} chars]` : tmpl;
-    return `- **${p.name}** (${p.category}): ${preview || p.description || "Sem template"}`;
-}).join("\n")}
-`;
-    }
-
-    // v8.5: Utility Map (DRY prevention - Camada 1)
-    try {
-        const taskDirs = [...new Set(taskFiles.map((f: string) => {
-            const parts = f.replace(/\\/g, "/").split("/");
-            return parts.slice(0, -1).join("/");
-        }).filter(Boolean))];
-
-        const agentScope = task.agent?.split("-")[0] || undefined;
-        let relevantUtilities = getUtilitiesForContext(taskDirs, undefined, 15);
-
-        // Se poucos resultados por diretorio, ampliar para scope do agent
-        if (relevantUtilities.length < 5 && agentScope) {
-            const scopeUtils = getUtilitiesForContext([], agentScope, 15);
-            const existingKeys = new Set(relevantUtilities.map((u: any) => `${u.file_path}:${u.utility_name}`));
-            for (const u of scopeUtils) {
-                if (!existingKeys.has(`${u.file_path}:${u.utility_name}`)) {
-                    relevantUtilities.push(u);
-                }
-                if (relevantUtilities.length >= 15) break;
-            }
-        }
-
-        if (relevantUtilities.length > 0) {
-            const totalCount = (db.query("SELECT COUNT(*) as c FROM project_utilities").get() as any)?.c || 0;
-            const truncated = totalCount - relevantUtilities.length;
-            output += `
-### UTILITIES EXISTENTES (${relevantUtilities.length}${truncated > 0 ? ` [+${truncated} mais]` : ''})
-**REGRA DRY**: Reutilize ao inves de recriar. Importe do arquivo existente.
-${relevantUtilities.map((u: any) => {
-    const sig = u.signature ? ` ${u.signature}` : '';
-    return `- **${u.utility_name}** [${u.utility_type}]${sig} <- \`${u.file_path}\``;
-}).join("\n")}
-`;
-        }
-    } catch { /* tabela pode nao existir ainda */ }
-
-    // v8.3: Sessoes compostas (todas, nao so ultima)
-    if (sessions.length > 0) {
-        output += `
-### HISTORICO DE SESSOES (${sessions.length})`;
-        // Sessao mais recente: detalhes completos
-        const latest = sessions[0];
-        output += `\n**Ultima:** ${latest.summary}`;
-        if (latest.next_steps) {
-            try {
-                const steps = JSON.parse(latest.next_steps);
-                if (steps.length > 0) {
-                    output += `\n**Proximos passos:** ${steps.slice(0, 3).join("; ")}${steps.length > 3 ? ` [+${steps.length - 3} mais]` : ''}`;
-                }
-            } catch { /* ignore */ }
-        }
-        if (latest.blockers) {
-            try {
-                const blockers = JSON.parse(latest.blockers);
-                if (blockers.length > 0) {
-                    output += `\n**Blockers:** ${blockers.join("; ")}`;
-                }
-            } catch { /* ignore */ }
-        }
-        // Sessoes anteriores: resumo de 1 linha
-        if (sessions.length > 1) {
-            output += `\n**Sessoes anteriores:**`;
-            for (const s of sessions.slice(1)) {
-                output += `\n  - ${s.summary.substring(0, 100)}${s.summary.length > 100 ? '...' : ''} (${s.tasks_completed || 0} tasks)`;
-            }
-        }
-        output += "\n";
-    }
-
-    // Decisoes do knowledge graph que afetam arquivos desta task
-    if (graphDecisions.length > 0) {
-        output += `
-### DECISOES QUE AFETAM SEUS ARQUIVOS (${graphDecisions.length})
-${graphDecisions.map((d: any) => `- **${d.title}**: ${d.decision}`).join("\n")}
-`;
-    }
-
-    // Contradicoes detectadas
-    if (contradictions.length > 0) {
-        output += `
-### [!!] CONTRADICOES DETECTADAS (${contradictions.length})
-${contradictions.map((c: any) => `- "${c.decision1}" <-> "${c.decision2}"`).join("\n")}
-Verifique estas contradicoes antes de prosseguir.
-`;
-    }
-
-    // v8.3: Patterns descobertos com indicador de truncamento
-    if (discoveredPatterns.length > 0) {
-        const patternsToShow = discoveredPatterns.slice(-10);
-        output += `
-### PATTERNS DESCOBERTOS (${discoveredPatterns.length})
-${discoveredPatterns.length > 10 ? `[mostrando ultimos 10 de ${discoveredPatterns.length}]\n` : ''}${patternsToShow.map((p: any) => `- ${p.pattern}${p.source_task ? ` (Task #${p.source_task})` : ""}`).join("\n")}
-`;
-    }
-
-    // Stack
-    if (project) {
-        const stack = JSON.parse(project.stack);
-        const allStackEntries = Object.entries(stack);
-        const mainStack = allStackEntries.slice(0, 6);
-        output += `
-### STACK
-${mainStack.map(([k, v]) => `${k}: ${v}`).join(" | ")}${allStackEntries.length > 6 ? ` [+${allStackEntries.length - 6} mais]` : ''}
-`;
-    }
-
-    // Bibliotecas do projeto
-    if (libContexts.length > 0) {
-        output += `
-### BIBLIOTECAS
-${libContexts.map((l: any) => `- ${l.lib_name}${l.version ? ` v${l.version}` : ""}`).join("\n")}
-`;
-    }
-
-    // Protocolo de retorno
-    output += `
-### RETORNO OBRIGATORIO
-\`\`\`json
-{"status": "completed|blocked", "summary": "...", "files_created": [], "files_modified": [], "reasoning": {"approach": "como abordou", "challenges": [], "recommendations": "para proximas tasks"}}
-\`\`\`
-`;
-
-    // v8.3: Overall size cap com truncamento inteligente por secao
-    if (output.length > MAX_CONTEXT_SIZE) {
-        const sections = output.split('\n### ');
-        let trimmed = sections[0]; // Sempre manter header
-
-        for (let i = 1; i < sections.length; i++) {
-            const candidate = trimmed + '\n### ' + sections[i];
-            if (candidate.length > MAX_CONTEXT_SIZE - 200) {
-                break;
-            }
-            trimmed = candidate;
-        }
-
-        const omittedSections = sections.length - trimmed.split('\n### ').length;
-        if (omittedSections > 0) {
-            trimmed += `\n\n[CONTEXTO TRUNCADO: ${omittedSections} secao(oes) omitida(s) por limite de ${MAX_CONTEXT_SIZE} chars. Use: context-export para contexto completo]`;
-        }
-
-        output = trimmed;
-    }
-
-    return output;
-}
-
-// v8.3: Filtrar decisoes relevantes com scoring melhorado
-function filterRelevantDecisions(decisions: any[], taskFiles: string[], maxCount: number): any[] {
-    if (decisions.length === 0) return [];
-    if (taskFiles.length === 0) return decisions.slice(0, maxCount);
-
-    // Extrair keywords semanticas dos arquivos da task
-    const fileExtensions = new Set(taskFiles.map(f => f.split('.').pop()?.toLowerCase()).filter(Boolean));
-    const fileDirs = new Set(taskFiles.flatMap(f => f.split('/').slice(0, -1)).filter(Boolean));
-
-    // Keywords de dominio para scoring contextual
-    const domainKeywords: Record<string, string[]> = {
-        frontend: ['component', 'page', 'layout', 'css', 'style', 'ui', 'react', 'next', 'hook'],
-        backend: ['api', 'route', 'handler', 'middleware', 'server', 'endpoint', 'controller'],
-        database: ['schema', 'migration', 'query', 'table', 'index', 'sql', 'model'],
-        testing: ['test', 'spec', 'mock', 'fixture', 'assert', 'jest', 'vitest'],
-    };
-
-    const scored = decisions.map((d) => {
-        let score = 0;
-        const combined = `${d.decision || ''} ${d.title || ''} ${d.rationale || ''}`.toLowerCase();
-
-        // Arquivo exato e diretorio (+10/+5)
-        for (const file of taskFiles) {
-            const fileName = file.split("/").pop() || file;
-            const dirName = file.split("/").slice(-2, -1)[0] || "";
-
-            if (combined.includes(fileName.toLowerCase())) score += 10;
-            if (dirName && combined.includes(dirName.toLowerCase())) score += 5;
-        }
-
-        // v8.3: Extensao dos arquivos (+3)
-        for (const ext of fileExtensions) {
-            if (combined.includes(`.${ext}`)) { score += 3; break; }
-        }
-
-        // v8.3: Diretorio mencionado (+4)
-        for (const dir of fileDirs) {
-            if (combined.includes(dir.toLowerCase())) { score += 4; break; }
-        }
-
-        // v8.3: Keywords de dominio (+2)
-        const taskCombined = taskFiles.join(' ').toLowerCase();
-        for (const [, keywords] of Object.entries(domainKeywords)) {
-            for (const kw of keywords) {
-                if (combined.includes(kw) && taskCombined.includes(kw)) {
-                    score += 2;
-                    break;
-                }
-            }
-        }
-
-        // Recencia (+3/+1)
-        const age = Date.now() - new Date(d.created_at).getTime();
-        const hoursOld = age / (1000 * 60 * 60);
-        if (hoursOld < 1) score += 3;
-        else if (hoursOld < 24) score += 1;
-
-        return { ...d, _relevanceScore: score };
-    });
-
-    return scored
-        .sort((a, b) => b._relevanceScore - a._relevanceScore)
-        .slice(0, maxCount)
-        .map(({ _relevanceScore, ...d }) => d);
-}
-
-// v8.0: Filtrar standards relevantes para os arquivos da task
-function filterRelevantStandards(standards: any[], taskFiles: string[]): any[] {
-    if (standards.length === 0) return [];
-    if (taskFiles.length === 0) return standards;
-
-    // Extrair extensoes e diretorios dos arquivos da task
-    const extensions = new Set(taskFiles.map((f) => {
-        const ext = f.split(".").pop();
-        return ext ? `.${ext}` : "";
-    }).filter(Boolean));
-
-    const directories = new Set(taskFiles.map((f) => {
-        const parts = f.split("/");
-        return parts.length > 1 ? parts.slice(0, -1).join("/") : "";
-    }).filter(Boolean));
-
-    // Filtrar standards que se aplicam
-    return standards.filter((s) => {
-        // Standards de naming sempre aplicam
-        if (s.category === "naming") return true;
-
-        // Standards de code aplicam se mencionam extensao dos arquivos
-        if (s.category === "code") {
-            for (const ext of extensions) {
-                if (s.rule?.includes(ext) || s.scope === "all") return true;
-            }
-        }
-
-        // Standards de structure aplicam se mencionam diretorio
-        if (s.category === "structure") {
-            for (const dir of directories) {
-                if (s.rule?.includes(dir)) return true;
-            }
-            return s.scope === "all";
-        }
-
-        // Outros standards: incluir se scope combina
-        return true;
-    });
-}
-
-export function recover(options: {
-    list?: boolean;
-    snapshot?: string;
-    restore?: boolean;
-    auto?: boolean;
-}): void {
-    initSchema();
-
-    const db = getDb();
-
-    // Listar snapshots
-    if (options.list) {
-        const snapshots = db
-            .query("SELECT id, spec_id, trigger, created_at FROM snapshots ORDER BY created_at DESC LIMIT 20")
-            .all() as any[];
-
-        if (snapshots.length === 0) {
-            console.log("\nNenhum snapshot disponivel.\n");
-            return;
-        }
-
-        console.log(`\nSnapshots disponiveis:`);
-        console.log(`${"─".repeat(60)}`);
-        for (const snap of snapshots) {
-            console.log(`  #${snap.id}: ${snap.spec_id} (${snap.trigger}) - ${snap.created_at}`);
-        }
-        console.log(`\nPara restaurar: recover --restore --snapshot <id>`);
-        console.log(`Ou automatico: recover --auto\n`);
-        return;
-    }
-
-    // Restaurar snapshot (--restore ou --auto)
-    if (options.restore || options.auto) {
-        let snapshot: any;
-
-        if (options.auto) {
-            snapshot = db.query("SELECT * FROM snapshots ORDER BY created_at DESC LIMIT 1").get();
-        } else if (options.snapshot) {
-            const snapshotId = parseInt(options.snapshot);
-            snapshot = db.query("SELECT * FROM snapshots WHERE id = ?").get(snapshotId);
-        }
-
-        if (!snapshot) {
-            console.error("\nNenhum snapshot para restaurar.\n");
-            process.exit(1);
-        }
-
-        const data = JSON.parse(snapshot.data);
-        const now = new Date().toISOString();
-
-        console.log(`\nRestaurando snapshot #${snapshot.id}...`);
-
-        // 1. Restaurar spec
-        if (data.spec) {
-            db.run(
-                `UPDATE specs SET phase = ?, approved_at = ?, updated_at = ? WHERE id = ?`,
-                [data.spec.phase, data.spec.approved_at, now, data.spec.id]
-            );
-            console.log(`  ✓ Spec restaurado (fase: ${data.spec.phase})`);
-        }
-
-        // 2. Restaurar context
-        if (data.context) {
-            db.run(
-                `UPDATE context SET
-          objective = ?, approach = ?, constraints = ?, patterns = ?,
-          current_task = ?, last_checkpoint = ?, updated_at = ?
-        WHERE spec_id = ?`,
-                [
-                    data.context.objective,
-                    data.context.approach,
-                    data.context.constraints,
-                    data.context.patterns,
-                    data.context.current_task,
-                    data.checkpoint || data.context.last_checkpoint,
-                    now,
-                    snapshot.spec_id,
-                ]
-            );
-            console.log(`  ✓ Context restaurado`);
-        }
-
-        // 3. Restaurar status das tasks
-        if (data.tasks && Array.isArray(data.tasks)) {
-            for (const task of data.tasks) {
-                db.run(
-                    `UPDATE tasks SET status = ?, checkpoint = ?, completed_at = ? WHERE id = ?`,
-                    [task.status, task.checkpoint, task.completed_at, task.id]
-                );
-            }
-            console.log(`  ✓ ${data.tasks.length} tasks restauradas`);
-        }
-
-        // 4. Log do que foi restaurado
-        console.log(`\n${"─".repeat(50)}`);
-        console.log(`Snapshot #${snapshot.id} restaurado com sucesso!`);
-        console.log(`  Spec: ${snapshot.spec_id}`);
-        console.log(`  Trigger: ${snapshot.trigger}`);
-        console.log(`  Data original: ${snapshot.created_at}`);
-        if (data.taskCompleted) {
-            console.log(`  Task completada: #${data.taskCompleted}`);
-        }
-        if (data.checkpoint) {
-            console.log(`  Checkpoint: ${data.checkpoint}`);
-        }
-        console.log(`\nUse 'status' para ver o estado atual.\n`);
-        return;
-    }
-
-    // Mostrar detalhes de snapshot específico
-    if (options.snapshot) {
-        const snapshotId = parseInt(options.snapshot);
-        const snapshot = db.query("SELECT * FROM snapshots WHERE id = ?").get(snapshotId) as any;
-
-        if (!snapshot) {
-            console.error(`\nSnapshot #${snapshotId} nao encontrado.\n`);
-            process.exit(1);
-        }
-
-        const data = JSON.parse(snapshot.data);
-
-        console.log(`\nSnapshot #${snapshotId}:`);
-        console.log(`  Spec: ${snapshot.spec_id}`);
-        console.log(`  Trigger: ${snapshot.trigger}`);
-        console.log(`  Data: ${snapshot.created_at}`);
-        console.log(`\nDados:`);
-        console.log(JSON.stringify(data, null, 2));
-        console.log(`\nPara restaurar: recover --restore --snapshot ${snapshotId}\n`);
-        return;
-    }
-
-    // Mostrar ultimo snapshot
-    const last = db
-        .query("SELECT * FROM snapshots ORDER BY created_at DESC LIMIT 1")
-        .get() as any;
-
-    if (!last) {
-        console.log("\nNenhum snapshot disponivel.\n");
-        return;
-    }
-
-    console.log(`\nUltimo snapshot:`);
-    console.log(`  #${last.id}: ${last.spec_id} (${last.trigger}) - ${last.created_at}`);
-    console.log(`\nComandos:`);
-    console.log(`  --list              Lista todos os snapshots`);
-    console.log(`  --snapshot <id>     Mostra detalhes de um snapshot`);
-    console.log(`  --restore --snapshot <id>  Restaura um snapshot especifico`);
-    console.log(`  --auto              Restaura o ultimo snapshot automaticamente\n`);
-}
+import { getDb } from "../db/connection";
+import { initSchema, getPatternsForFiles, getLastSessionSummary, getSessionSummaries, getRelatedDecisions, findContradictions, getArchitecturalAnalysisForSpec, getUtilitiesForContext } from "../db/schema";
+import { getKnowledgeForTask } from "./knowledge";
+import { getLibContextsForAgent } from "./research";
+
+// v8.3: Limite maximo de contexto para subagents (16KB)
+const MAX_CONTEXT_SIZE = 16384;
+
+export function contextUpdate(options: {
+    approach?: string;
+    pattern?: string;
+    constraint?: string;
+}): void {
+    initSchema();
+    const db = getDb();
+
+    const spec = db
+        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
+        .get() as any;
+
+    if (!spec) {
+        console.error("\nNenhuma feature ativa.\n");
+        process.exit(1);
+    }
+
+    // Verificar se está na fase de implementação
+    if (spec.phase !== "implementing") {
+        console.error(`\nContexto só pode ser atualizado na fase 'implementing'.`);
+        console.error(`Fase atual: ${spec.phase}\n`);
+        process.exit(1);
+    }
+
+    const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(spec.id) as any;
+    const now = new Date().toISOString();
+
+    let updated = false;
+
+    if (options.approach) {
+        // Append ao approach existente, não substitui
+        const currentApproach = context?.approach || "";
+        const newApproach = currentApproach
+            ? `${currentApproach}\n- ${options.approach}`
+            : options.approach;
+
+        db.run("UPDATE context SET approach = ?, updated_at = ? WHERE spec_id = ?", [
+            newApproach,
+            now,
+            spec.id,
+        ]);
+        console.log(`\n✓ Approach atualizado`);
+        updated = true;
+    }
+
+    if (options.pattern) {
+        // Adiciona ao array de patterns
+        const currentPatterns = context?.patterns ? JSON.parse(context.patterns) : [];
+        currentPatterns.push({
+            pattern: options.pattern,
+            detected_at: now,
+        });
+
+        db.run("UPDATE context SET patterns = ?, updated_at = ? WHERE spec_id = ?", [
+            JSON.stringify(currentPatterns),
+            now,
+            spec.id,
+        ]);
+        console.log(`✓ Pattern adicionado (total: ${currentPatterns.length})`);
+        updated = true;
+    }
+
+    if (options.constraint) {
+        // Adiciona ao array de constraints
+        const currentConstraints = context?.constraints ? JSON.parse(context.constraints) : [];
+        currentConstraints.push({
+            constraint: options.constraint,
+            added_at: now,
+        });
+
+        db.run("UPDATE context SET constraints = ?, updated_at = ? WHERE spec_id = ?", [
+            JSON.stringify(currentConstraints),
+            now,
+            spec.id,
+        ]);
+        console.log(`✓ Constraint adicionado (total: ${currentConstraints.length})`);
+        updated = true;
+    }
+
+    if (!updated) {
+        console.log("\nNenhuma opcao fornecida.");
+        console.log("Use:");
+        console.log("  --approach 'Nova abordagem descoberta'");
+        console.log("  --pattern 'Padrao identificado no codigo'");
+        console.log("  --constraint 'Nova limitacao encontrada'\n");
+        return;
+    }
+
+    console.log(`\nContexto atualizado para: ${spec.name}\n`);
+}
+
+export function status(json: boolean = false): void {
+    initSchema();
+
+    const db = getDb();
+
+    const spec = db
+        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
+        .get() as any;
+
+    if (!spec) {
+        if (json) {
+            console.log(JSON.stringify({ active: false, message: "Nenhuma feature ativa" }));
+        } else {
+            console.log("\nNenhuma feature ativa.");
+            console.log("Inicie com: /codexa:feature\n");
+        }
+        return;
+    }
+
+    const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(spec.id) as any;
+    const tasks = db.query("SELECT * FROM tasks WHERE spec_id = ?").all(spec.id) as any[];
+    const decisions = db.query("SELECT * FROM decisions WHERE spec_id = ? AND status = 'active'").all(spec.id) as any[];
+
+    const tasksDone = tasks.filter((t) => t.status === "done").length;
+    const tasksRunning = tasks.filter((t) => t.status === "running").length;
+    const tasksPending = tasks.filter((t) => t.status === "pending").length;
+
+    const progress = tasks.length > 0 ? Math.round((tasksDone / tasks.length) * 100) : 0;
+
+    if (json) {
+        console.log(
+            JSON.stringify({
+                active: true,
+                spec,
+                context,
+                progress: {
+                    done: tasksDone,
+                    running: tasksRunning,
+                    pending: tasksPending,
+                    total: tasks.length,
+                    percent: progress,
+                },
+                decisions: decisions.length,
+            })
+        );
+        return;
+    }
+
+    console.log(`\n${"=".repeat(60)}`);
+    console.log(`STATUS: ${spec.name}`);
+    console.log(`${"=".repeat(60)}`);
+    console.log(`\nSpec ID: ${spec.id}`);
+    console.log(`Fase: ${spec.phase}`);
+    console.log(`Aprovado: ${spec.approved_at ? "Sim" : "Nao"}`);
+
+    console.log(`\nProgresso:`);
+    const bar = "█".repeat(Math.floor(progress / 5)) + "░".repeat(20 - Math.floor(progress / 5));
+    console.log(`  [${bar}] ${progress}%`);
+    console.log(`  Concluidas: ${tasksDone}/${tasks.length}`);
+    console.log(`  Em execucao: ${tasksRunning}`);
+    console.log(`  Pendentes: ${tasksPending}`);
+
+    if (context?.last_checkpoint) {
+        console.log(`\nUltimo checkpoint:`);
+        console.log(`  ${context.last_checkpoint}`);
+    }
+
+    if (decisions.length > 0) {
+        console.log(`\nDecisoes ativas: ${decisions.length}`);
+    }
+
+    // v8.1: Mostrar ultimo session summary para continuidade
+    const lastSession = getLastSessionSummary(spec.id);
+    if (lastSession) {
+        console.log(`\nUltima sessao:`);
+        console.log(`  ${lastSession.summary}`);
+        if (lastSession.next_steps) {
+            try {
+                const nextSteps = JSON.parse(lastSession.next_steps);
+                if (nextSteps.length > 0) {
+                    console.log(`  Proximos passos sugeridos:`);
+                    for (const step of nextSteps.slice(0, 3)) {
+                        console.log(`    - ${step}`);
+                    }
+                }
+            } catch { /* ignore */ }
+        }
+        if (lastSession.blockers) {
+            try {
+                const blockers = JSON.parse(lastSession.blockers);
+                if (blockers.length > 0) {
+                    console.log(`  Blockers pendentes:`);
+                    for (const b of blockers) {
+                        console.log(`    [!] ${b}`);
+                    }
+                }
+            } catch { /* ignore */ }
+        }
+    }
+
+    console.log(`\n${"─".repeat(60)}`);
+
+    // Sugerir proximo passo
+    switch (spec.phase) {
+        case "planning":
+            console.log(`Proximo: plan task-add ou check request`);
+            break;
+        case "checking":
+            console.log(`Proximo: check approve ou check reject`);
+            break;
+        case "implementing":
+            console.log(`Proximo: task next`);
+            break;
+        case "reviewing":
+            console.log(`Proximo: review approve`);
+            break;
+    }
+    console.log();
+}
+
+export function contextExport(options: { task?: string; json?: boolean; }): void {
+    initSchema();
+
+    const db = getDb();
+
+    const spec = db
+        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
+        .get() as any;
+
+    if (!spec) {
+        console.error("\nNenhuma feature ativa.\n");
+        process.exit(1);
+    }
+
+    const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(spec.id) as any;
+    const decisions = db
+        .query("SELECT * FROM decisions WHERE spec_id = ? AND status = 'active'")
+        .all(spec.id) as any[];
+    const artifacts = db.query("SELECT * FROM artifacts WHERE spec_id = ?").all(spec.id) as any[];
+    const project = db.query("SELECT * FROM project WHERE id = 'default'").get() as any;
+
+    let taskContext = null;
+    let standards: any[] = [];
+    let knowledge: any[] = [];
+    let libContexts: string[] = [];
+
+    if (options.task) {
+        const taskId = parseInt(options.task);
+        const task = db.query("SELECT * FROM tasks WHERE id = ?").get(taskId) as any;
+        if (task) {
+            taskContext = {
+                id: task.id,
+                number: task.number,
+                name: task.name,
+                agent: task.agent,
+                files: task.files ? JSON.parse(task.files) : [],
+            };
+
+            // Obter standards para o agente da task
+            const domain = task.agent?.split("-")[0] || "all";
+            standards = db
+                .query(
+                    `SELECT * FROM standards
+           WHERE scope = 'all' OR scope = ?
+           ORDER BY enforcement DESC, category`
+                )
+                .all(domain) as any[];
+
+            standards = standards.map((std) => ({
+                category: std.category,
+                rule: std.rule,
+                examples: std.examples ? JSON.parse(std.examples) : [],
+                anti_examples: std.anti_examples ? JSON.parse(std.anti_examples) : [],
+                enforcement: std.enforcement,
+            }));
+
+            // Obter knowledge broadcast (automatico)
+            knowledge = getKnowledgeForTask(spec.id, taskId).map((k) => ({
+                id: k.id,
+                category: k.category,
+                content: k.content,
+                severity: k.severity,
+                origin_task: k.task_origin,
+                created_at: k.created_at,
+            }));
+
+            // Obter lib-contexts para o agente da task
+            if (task.agent) {
+                libContexts = getLibContextsForAgent(task.agent);
+            }
+        }
+    }
+
+    // Obter contexto de produto
+    const productContext = db.query("SELECT * FROM product_context WHERE id = 'default'").get() as any;
+    const productGoals = db.query("SELECT * FROM product_goals WHERE product_id = 'default'").all() as any[];
+    const productFeatures = db.query("SELECT * FROM product_features WHERE product_id = 'default'").all() as any[];
+
+    const exportData = {
+        spec: {
+            id: spec.id,
+            name: spec.name,
+            phase: spec.phase,
+        },
+        project: project ? {
+            stack: JSON.parse(project.stack),
+        } : null,
+        productContext: productContext ? {
+            name: productContext.name,
+            problem: productContext.problem,
+            solution: productContext.solution,
+            targetUsers: productContext.target_users,
+            valueProposition: productContext.value_proposition,
+            outOfScope: productContext.out_of_scope ? JSON.parse(productContext.out_of_scope) : [],
+            constraints: productContext.constraints ? JSON.parse(productContext.constraints) : [],
+        } : null,
+        productGoals: productGoals.map((g) => ({
+            category: g.category,
+            goal: g.goal,
+            priority: g.priority,
+        })),
+        productFeatures: productFeatures.map((f) => ({
+            name: f.name,
+            description: f.description,
+            priority: f.priority,
+        })),
+        objective: context?.objective,
+        approach: context?.approach,
+        patterns: context?.patterns ? JSON.parse(context.patterns) : [],
+        constraints: context?.constraints ? JSON.parse(context.constraints) : [],
+        decisions: decisions.map((d) => ({
+            id: d.id,
+            title: d.title,
+            decision: d.decision,
+        })),
+        artifacts: artifacts.map((a) => a.path),
+        task: taskContext,
+        standards: standards,
+        knowledge: knowledge,
+        libContexts: libContexts,
+    };
+
+    console.log(JSON.stringify(exportData, null, 2));
+}
+
+// Funcao helper para formatar contexto para subagent (uso interno)
+// v8.1: Contexto COMPLETO mas ESTRUTURADO - todas as fontes relevantes incluidas
+export function getContextForSubagent(taskId: number): string {
+    initSchema();
+
+    const db = getDb();
+
+    const task = db.query("SELECT * FROM tasks WHERE id = ?").get(taskId) as any;
+    if (!task) {
+        return "ERRO: Task nao encontrada";
+    }
+
+    const spec = db.query("SELECT * FROM specs WHERE id = ?").get(task.spec_id) as any;
+    const context = db.query("SELECT * FROM context WHERE spec_id = ?").get(task.spec_id) as any;
+    const project = db.query("SELECT * FROM project WHERE id = 'default'").get() as any;
+
+    // v8.4: Analise arquitetural (link explicito via analysis_id ou nome)
+    const archAnalysis = getArchitecturalAnalysisForSpec(spec.name, task.spec_id);
+
+    // Arquivos da task para filtrar contexto relevante
+    const taskFiles = task.files ? JSON.parse(task.files) : [];
+    const domain = task.agent?.split("-")[0] || "all";
+
+    // Decisoes relevantes (max 8, priorizando as que mencionam arquivos da task)
+    const allDecisions = db
+        .query("SELECT * FROM decisions WHERE spec_id = ? AND status = 'active' ORDER BY created_at DESC")
+        .all(task.spec_id) as any[];
+    const decisions = filterRelevantDecisions(allDecisions, taskFiles, 8);
+
+    // Standards required + recommended que se aplicam aos arquivos
+    const standards = db
+        .query(
+            `SELECT * FROM standards
+       WHERE (scope = 'all' OR scope = ?)
+       ORDER BY enforcement DESC, category`
+        )
+        .all(domain) as any[];
+    const relevantStandards = filterRelevantStandards(standards, taskFiles);
+
+    // v8.3: Knowledge com TTL, caps e indicadores de truncamento
+    const allKnowledge = getKnowledgeForTask(task.spec_id, taskId);
+    const now48h = new Date(Date.now() - 48 * 60 * 60 * 1000).toISOString();
+    const recentKnowledge = allKnowledge.filter((k: any) => k.created_at > now48h);
+    const staleKnowledge = allKnowledge.filter((k: any) => k.created_at <= now48h);
+    // Conhecimento recente primeiro; stale so se critical
+    const effectiveKnowledge = [
+        ...recentKnowledge,
+        ...staleKnowledge.filter((k: any) => k.severity === 'critical'),
+    ];
+    const allCriticalKnowledge = effectiveKnowledge.filter((k: any) => k.severity === 'critical' || k.severity === 'warning');
+    const criticalKnowledge = allCriticalKnowledge.slice(0, 20);
+    const truncatedCritical = allCriticalKnowledge.length - criticalKnowledge.length;
+    const allInfoKnowledge = effectiveKnowledge.filter((k: any) => k.severity === 'info');
+    const infoKnowledge = allInfoKnowledge.slice(0, 10);
+    const truncatedInfo = allInfoKnowledge.length - infoKnowledge.length;
+
+    // v8.1: Contexto de produto (resumido - problema, usuarios, restricoes)
+    const productContext = db.query("SELECT * FROM product_context WHERE id = 'default'").get() as any;
+
+    // v8.1: Patterns de implementacao matchados aos arquivos da task
+    const patterns = getPatternsForFiles(taskFiles);
+
+    // v8.2: Reasoning de tasks dependentes + todas tasks completas recentes
+    const dependsOn = task.depends_on ? JSON.parse(task.depends_on) : [];
+    const depReasoning: any[] = [];
+    const seenTaskIds = new Set<number>();
+
+    // 1. Reasoning de dependencias diretas (prioridade maxima)
+    if (dependsOn.length > 0) {
+        const placeholders = dependsOn.map(() => '?').join(',');
+        const depTasks = db.query(
+            `SELECT id, number FROM tasks WHERE spec_id = ? AND number IN (${placeholders})`
+        ).all(task.spec_id, ...dependsOn) as any[];
+
+        for (const depTask of depTasks) {
+            seenTaskIds.add(depTask.id);
+            const reasoning = db.query(
+                `SELECT category, thought FROM reasoning_log
+                 WHERE spec_id = ? AND task_id = ?
+                 AND category IN ('recommendation', 'decision', 'challenge')
+                 ORDER BY
+                   CASE importance WHEN 'critical' THEN 1 WHEN 'high' THEN 2 ELSE 3 END,
+                   created_at DESC
+                 LIMIT 3`
+            ).all(task.spec_id, depTask.id) as any[];
+            for (const r of reasoning) {
+                depReasoning.push({ ...r, fromTask: depTask.number });
+            }
+        }
+    }
+
+    // 2. Reasoning de TODAS tasks completas (recommendations e challenges de alta importancia)
+    const completedTasks = db.query(
+        `SELECT t.id, t.number FROM tasks t
+         WHERE t.spec_id = ? AND t.status = 'done' AND t.id != ?
+         ORDER BY t.completed_at DESC LIMIT 10`
+    ).all(task.spec_id, taskId) as any[];
+
+    for (const ct of completedTasks) {
+        if (seenTaskIds.has(ct.id)) continue;
+        const reasoning = db.query(
+            `SELECT category, thought FROM reasoning_log
+             WHERE spec_id = ? AND task_id = ?
+             AND category IN ('recommendation', 'challenge')
+             AND importance IN ('critical', 'high')
+             ORDER BY
+               CASE importance WHEN 'critical' THEN 1 ELSE 2 END,
+               created_at DESC
+             LIMIT 2`
+        ).all(task.spec_id, ct.id) as any[];
+        for (const r of reasoning) {
+            depReasoning.push({ ...r, fromTask: ct.number });
+        }
+    }
+
+    // v8.1: Lib contexts do projeto (resumido - nomes e versoes)
+    const libContexts = db.query(
+        "SELECT lib_name, version FROM lib_contexts ORDER BY lib_name LIMIT 10"
+    ).all() as any[];
+
+    // v8.3: Sessoes compostas para continuidade cross-session (todas, nao so ultima)
+    const sessions = getSessionSummaries(task.spec_id, 5);
+
+    // v8.2: Knowledge graph - decisoes que afetam arquivos da task
+    const graphDecisions: any[] = [];
+    for (const file of taskFiles) {
+        try {
+            const related = getRelatedDecisions(file, "file");
+            for (const d of related) {
+                if (!graphDecisions.find((gd: any) => gd.id === d.id)) {
+                    graphDecisions.push(d);
+                }
+            }
+        } catch { /* ignore if graph empty */ }
+    }
+
+    // v8.2: Deteccao de contradicoes
+    let contradictions: any[] = [];
+    try {
+        contradictions = findContradictions(task.spec_id);
+    } catch { /* ignore if no contradictions */ }
+
+    // v8.2: Patterns descobertos por subagents anteriores
+    const discoveredPatterns = context?.patterns ? JSON.parse(context.patterns) : [];
+
+    // ===== MONTAR OUTPUT ESTRUTURADO =====
+
+    let output = `## CONTEXTO (Task #${task.number})
+
+**Feature:** ${spec.name}
+**Objetivo:** ${context?.objective || "N/A"}
+**Arquivos:** ${taskFiles.join(", ") || "Nenhum especificado"}
+`;
+
+    // Contexto de produto
+    if (productContext) {
+        output += `
+### PRODUTO
+- **Problema:** ${productContext.problem || "N/A"}
+- **Usuarios:** ${productContext.target_users || "N/A"}`;
+        if (productContext.constraints) {
+            try {
+                const constraints = JSON.parse(productContext.constraints);
+                if (constraints.length > 0) {
+                    output += `\n- **Restricoes:** ${constraints.slice(0, 3).join("; ")}${constraints.length > 3 ? ` [+${constraints.length - 3} mais]` : ''}`;
+                }
+            } catch { /* ignore parse errors */ }
+        }
+        output += "\n";
+    }
+
+    // v8.3: Secao ARQUITETURA (Fase 3 - Architect Pipeline)
+    if (archAnalysis) {
+        output += `
+### ARQUITETURA (${archAnalysis.id})`;
+        if (archAnalysis.approach) {
+            const approachPreview = archAnalysis.approach.length > 500
+                ? archAnalysis.approach.substring(0, 500) + "..."
+                : archAnalysis.approach;
+            output += `\n**Abordagem:** ${approachPreview}`;
+        }
+        if (archAnalysis.risks) {
+            try {
+                const risks = JSON.parse(archAnalysis.risks);
+                if (risks.length > 0) {
+                    const highRisks = risks.filter((r: any) => r.impact === 'high' || r.probability === 'high');
+                    const risksToShow = highRisks.length > 0 ? highRisks.slice(0, 3) : risks.slice(0, 3);
+                    output += `\n**Riscos:**`;
+                    for (const r of risksToShow) {
+                        output += `\n  - ${r.description} (${r.probability}/${r.impact}) -> ${r.mitigation}`;
+                    }
+                    if (risks.length > risksToShow.length) {
+                        output += `\n  [+${risks.length - risksToShow.length} mais riscos]`;
+                    }
+                }
+            } catch { /* ignore */ }
+        }
+        if (archAnalysis.decisions) {
+            try {
+                const archDecisions = JSON.parse(archAnalysis.decisions);
+                if (archDecisions.length > 0) {
+                    output += `\n**Decisoes arquiteturais:**`;
+                    for (const d of archDecisions.slice(0, 5)) {
+                        output += `\n  - ${d.decision}: ${d.rationale || ''}`;
+                    }
+                    if (archDecisions.length > 5) {
+                        output += `\n  [+${archDecisions.length - 5} mais]`;
+                    }
+                }
+            } catch { /* ignore */ }
+        }
+        output += "\n";
+    }
+
+    // Standards
+    const requiredStds = relevantStandards.filter((s: any) => s.enforcement === 'required');
+    const recommendedStds = relevantStandards.filter((s: any) => s.enforcement === 'recommended');
+
+    output += `
+### STANDARDS (${relevantStandards.length})`;
+    if (requiredStds.length > 0) {
+        output += `\n**Obrigatorios:**\n${requiredStds.map((s: any) => `- ${s.rule}`).join("\n")}`;
+    }
+    if (recommendedStds.length > 0) {
+        output += `\n**Recomendados:**\n${recommendedStds.map((s: any) => `- ${s.rule}`).join("\n")}`;
+    }
+    if (relevantStandards.length === 0) {
+        output += "\nNenhum standard aplicavel";
+    }
+    output += "\n";
+
+    // v8.3: Decisoes com indicador de truncamento
+    const truncatedDecisions = allDecisions.length - decisions.length;
+    output += `
+### DECISOES (${decisions.length}${truncatedDecisions > 0 ? ` [+${truncatedDecisions} mais - use: decisions list]` : ''})
+${decisions.length > 0 ? decisions.map((d) => `- **${d.title}**: ${d.decision}`).join("\n") : "Nenhuma"}
+`;
+
+    // Reasoning de tasks anteriores
+    if (depReasoning.length > 0) {
+        output += `
+### CONTEXTO DE TASKS ANTERIORES
+${depReasoning.map((r: any) => `- [Task #${r.fromTask}/${r.category}] ${r.thought}`).join("\n")}
+`;
+    }
+
+    // v8.3: Alertas com cap de 20 e indicador de truncamento
+    if (criticalKnowledge.length > 0) {
+        const severityIcon: Record<string, string> = { warning: "!!", critical: "XX" };
+        output += `
+### ALERTAS (${criticalKnowledge.length}${truncatedCritical > 0 ? ` [+${truncatedCritical} mais - use: knowledge list --severity warning]` : ''})
+${criticalKnowledge.map((k: any) => `[${severityIcon[k.severity] || "!"}] ${k.content}`).join("\n")}
+`;
+    }
+
+    // v8.3: Discoveries com indicador de truncamento
+    if (infoKnowledge.length > 0) {
+        output += `
+### DISCOVERIES DE TASKS ANTERIORES (${infoKnowledge.length}${truncatedInfo > 0 ? ` [+${truncatedInfo} mais - use: knowledge list]` : ''})
+${infoKnowledge.map((k: any) => `- ${k.content}`).join("\n")}
+`;
+    }
+
+    // Patterns de implementacao matchados
+    if (patterns.length > 0) {
+        output += `
+### PATTERNS DO PROJETO (${patterns.length})
+${patterns.map((p: any) => {
+    const tmpl = p.template || "";
+    const preview = tmpl.length > 200 ? tmpl.substring(0, 200) + `... [truncado de ${tmpl.length} chars]` : tmpl;
+    return `- **${p.name}** (${p.category}): ${preview || p.description || "Sem template"}`;
+}).join("\n")}
+`;
+    }
+
+    // v8.5: Utility Map (DRY prevention - Camada 1)
+    try {
+        const taskDirs = [...new Set(taskFiles.map((f: string) => {
+            const parts = f.replace(/\\/g, "/").split("/");
+            return parts.slice(0, -1).join("/");
+        }).filter(Boolean))];
+
+        const agentScope = task.agent?.split("-")[0] || undefined;
+        let relevantUtilities = getUtilitiesForContext(taskDirs, undefined, 15);
+
+        // Se poucos resultados por diretorio, ampliar para scope do agent
+        if (relevantUtilities.length < 5 && agentScope) {
+            const scopeUtils = getUtilitiesForContext([], agentScope, 15);
+            const existingKeys = new Set(relevantUtilities.map((u: any) => `${u.file_path}:${u.utility_name}`));
+            for (const u of scopeUtils) {
+                if (!existingKeys.has(`${u.file_path}:${u.utility_name}`)) {
+                    relevantUtilities.push(u);
+                }
+                if (relevantUtilities.length >= 15) break;
+            }
+        }
+
+        if (relevantUtilities.length > 0) {
+            const totalCount = (db.query("SELECT COUNT(*) as c FROM project_utilities").get() as any)?.c || 0;
+            const truncated = totalCount - relevantUtilities.length;
+            output += `
+### UTILITIES EXISTENTES (${relevantUtilities.length}${truncated > 0 ? ` [+${truncated} mais]` : ''})
+**REGRA DRY**: Reutilize ao inves de recriar. Importe do arquivo existente.
+${relevantUtilities.map((u: any) => {
+    const sig = u.signature ? ` ${u.signature}` : '';
+    return `- **${u.utility_name}** [${u.utility_type}]${sig} <- \`${u.file_path}\``;
+}).join("\n")}
+`;
+        }
+    } catch { /* tabela pode nao existir ainda */ }
+
+    // v8.3: Sessoes compostas (todas, nao so ultima)
+    if (sessions.length > 0) {
+        output += `
+### HISTORICO DE SESSOES (${sessions.length})`;
+        // Sessao mais recente: detalhes completos
+        const latest = sessions[0];
+        output += `\n**Ultima:** ${latest.summary}`;
+        if (latest.next_steps) {
+            try {
+                const steps = JSON.parse(latest.next_steps);
+                if (steps.length > 0) {
+                    output += `\n**Proximos passos:** ${steps.slice(0, 3).join("; ")}${steps.length > 3 ? ` [+${steps.length - 3} mais]` : ''}`;
+                }
+            } catch { /* ignore */ }
+        }
+        if (latest.blockers) {
+            try {
+                const blockers = JSON.parse(latest.blockers);
+                if (blockers.length > 0) {
+                    output += `\n**Blockers:** ${blockers.join("; ")}`;
+                }
+            } catch { /* ignore */ }
+        }
+        // Sessoes anteriores: resumo de 1 linha
+        if (sessions.length > 1) {
+            output += `\n**Sessoes anteriores:**`;
+            for (const s of sessions.slice(1)) {
+                output += `\n  - ${s.summary.substring(0, 100)}${s.summary.length > 100 ? '...' : ''} (${s.tasks_completed || 0} tasks)`;
+            }
+        }
+        output += "\n";
+    }
+
+    // Decisoes do knowledge graph que afetam arquivos desta task
+    if (graphDecisions.length > 0) {
+        output += `
+### DECISOES QUE AFETAM SEUS ARQUIVOS (${graphDecisions.length})
+${graphDecisions.map((d: any) => `- **${d.title}**: ${d.decision}`).join("\n")}
+`;
+    }
+
+    // Contradicoes detectadas
+    if (contradictions.length > 0) {
+        output += `
+### [!!] CONTRADICOES DETECTADAS (${contradictions.length})
+${contradictions.map((c: any) => `- "${c.decision1}" <-> "${c.decision2}"`).join("\n")}
+Verifique estas contradicoes antes de prosseguir.
+`;
+    }
+
+    // v8.3: Patterns descobertos com indicador de truncamento
+    if (discoveredPatterns.length > 0) {
+        const patternsToShow = discoveredPatterns.slice(-10);
+        output += `
+### PATTERNS DESCOBERTOS (${discoveredPatterns.length})
+${discoveredPatterns.length > 10 ? `[mostrando ultimos 10 de ${discoveredPatterns.length}]\n` : ''}${patternsToShow.map((p: any) => `- ${p.pattern}${p.source_task ? ` (Task #${p.source_task})` : ""}`).join("\n")}
+`;
+    }
+
+    // Stack
+    if (project) {
+        const stack = JSON.parse(project.stack);
+        const allStackEntries = Object.entries(stack);
+        const mainStack = allStackEntries.slice(0, 6);
+        output += `
+### STACK
+${mainStack.map(([k, v]) => `${k}: ${v}`).join(" | ")}${allStackEntries.length > 6 ? ` [+${allStackEntries.length - 6} mais]` : ''}
+`;
+    }
+
+    // Bibliotecas do projeto
+    if (libContexts.length > 0) {
+        output += `
+### BIBLIOTECAS
+${libContexts.map((l: any) => `- ${l.lib_name}${l.version ? ` v${l.version}` : ""}`).join("\n")}
+`;
+    }
+
+    // Protocolo de retorno
+    output += `
+### RETORNO OBRIGATORIO
+\`\`\`json
+{"status": "completed|blocked", "summary": "...", "files_created": [], "files_modified": [], "reasoning": {"approach": "como abordou", "challenges": [], "recommendations": "para proximas tasks"}}
+\`\`\`
+`;
+
+    // v8.3: Overall size cap com truncamento inteligente por secao
+    if (output.length > MAX_CONTEXT_SIZE) {
+        const sections = output.split('\n### ');
+        let trimmed = sections[0]; // Sempre manter header
+
+        for (let i = 1; i < sections.length; i++) {
+            const candidate = trimmed + '\n### ' + sections[i];
+            if (candidate.length > MAX_CONTEXT_SIZE - 200) {
+                break;
+            }
+            trimmed = candidate;
+        }
+
+        const omittedSections = sections.length - trimmed.split('\n### ').length;
+        if (omittedSections > 0) {
+            trimmed += `\n\n[CONTEXTO TRUNCADO: ${omittedSections} secao(oes) omitida(s) por limite de ${MAX_CONTEXT_SIZE} chars. Use: context-export para contexto completo]`;
+        }
+
+        output = trimmed;
+    }
+
+    return output;
+}
+
+// v8.3: Filtrar decisoes relevantes com scoring melhorado
+function filterRelevantDecisions(decisions: any[], taskFiles: string[], maxCount: number): any[] {
+    if (decisions.length === 0) return [];
+    if (taskFiles.length === 0) return decisions.slice(0, maxCount);
+
+    // Extrair keywords semanticas dos arquivos da task
+    const fileExtensions = new Set(taskFiles.map(f => f.split('.').pop()?.toLowerCase()).filter(Boolean));
+    const fileDirs = new Set(taskFiles.flatMap(f => f.split('/').slice(0, -1)).filter(Boolean));
+
+    // Keywords de dominio para scoring contextual
+    const domainKeywords: Record<string, string[]> = {
+        frontend: ['component', 'page', 'layout', 'css', 'style', 'ui', 'react', 'next', 'hook'],
+        backend: ['api', 'route', 'handler', 'middleware', 'server', 'endpoint', 'controller'],
+        database: ['schema', 'migration', 'query', 'table', 'index', 'sql', 'model'],
+        testing: ['test', 'spec', 'mock', 'fixture', 'assert', 'jest', 'vitest'],
+    };
+
+    const scored = decisions.map((d) => {
+        let score = 0;
+        const combined = `${d.decision || ''} ${d.title || ''} ${d.rationale || ''}`.toLowerCase();
+
+        // Arquivo exato e diretorio (+10/+5)
+        for (const file of taskFiles) {
+            const fileName = file.split("/").pop() || file;
+            const dirName = file.split("/").slice(-2, -1)[0] || "";
+
+            if (combined.includes(fileName.toLowerCase())) score += 10;
+            if (dirName && combined.includes(dirName.toLowerCase())) score += 5;
+        }
+
+        // v8.3: Extensao dos arquivos (+3)
+        for (const ext of fileExtensions) {
+            if (combined.includes(`.${ext}`)) { score += 3; break; }
+        }
+
+        // v8.3: Diretorio mencionado (+4)
+        for (const dir of fileDirs) {
+            if (combined.includes(dir.toLowerCase())) { score += 4; break; }
+        }
+
+        // v8.3: Keywords de dominio (+2)
+        const taskCombined = taskFiles.join(' ').toLowerCase();
+        for (const [, keywords] of Object.entries(domainKeywords)) {
+            for (const kw of keywords) {
+                if (combined.includes(kw) && taskCombined.includes(kw)) {
+                    score += 2;
+                    break;
+                }
+            }
+        }
+
+        // Recencia (+3/+1)
+        const age = Date.now() - new Date(d.created_at).getTime();
+        const hoursOld = age / (1000 * 60 * 60);
+        if (hoursOld < 1) score += 3;
+        else if (hoursOld < 24) score += 1;
+
+        return { ...d, _relevanceScore: score };
+    });
+
+    return scored
+        .sort((a, b) => b._relevanceScore - a._relevanceScore)
+        .slice(0, maxCount)
+        .map(({ _relevanceScore, ...d }) => d);
+}
+
+// v8.0: Filtrar standards relevantes para os arquivos da task
+function filterRelevantStandards(standards: any[], taskFiles: string[]): any[] {
+    if (standards.length === 0) return [];
+    if (taskFiles.length === 0) return standards;
+
+    // Extrair extensoes e diretorios dos arquivos da task
+    const extensions = new Set(taskFiles.map((f) => {
+        const ext = f.split(".").pop();
+        return ext ? `.${ext}` : "";
+    }).filter(Boolean));
+
+    const directories = new Set(taskFiles.map((f) => {
+        const parts = f.split("/");
+        return parts.length > 1 ? parts.slice(0, -1).join("/") : "";
+    }).filter(Boolean));
+
+    // Filtrar standards que se aplicam
+    return standards.filter((s) => {
+        // Standards de naming sempre aplicam
+        if (s.category === "naming") return true;
+
+        // Standards de code aplicam se mencionam extensao dos arquivos
+        if (s.category === "code") {
+            for (const ext of extensions) {
+                if (s.rule?.includes(ext) || s.scope === "all") return true;
+            }
+        }
+
+        // Standards de structure aplicam se mencionam diretorio
+        if (s.category === "structure") {
+            for (const dir of directories) {
+                if (s.rule?.includes(dir)) return true;
+            }
+            return s.scope === "all";
+        }
+
+        // Outros standards: incluir se scope combina
+        return true;
+    });
+}
+
+export function recover(options: {
+    list?: boolean;
+    snapshot?: string;
+    restore?: boolean;
+    auto?: boolean;
+}): void {
+    initSchema();
+
+    const db = getDb();
+
+    // Listar snapshots
+    if (options.list) {
+        const snapshots = db
+            .query("SELECT id, spec_id, trigger, created_at FROM snapshots ORDER BY created_at DESC LIMIT 20")
+            .all() as any[];
+
+        if (snapshots.length === 0) {
+            console.log("\nNenhum snapshot disponivel.\n");
+            return;
+        }
+
+        console.log(`\nSnapshots disponiveis:`);
+        console.log(`${"─".repeat(60)}`);
+        for (const snap of snapshots) {
+            console.log(`  #${snap.id}: ${snap.spec_id} (${snap.trigger}) - ${snap.created_at}`);
+        }
+        console.log(`\nPara restaurar: recover --restore --snapshot <id>`);
+        console.log(`Ou automatico: recover --auto\n`);
+        return;
+    }
+
+    // Restaurar snapshot (--restore ou --auto)
+    if (options.restore || options.auto) {
+        let snapshot: any;
+
+        if (options.auto) {
+            snapshot = db.query("SELECT * FROM snapshots ORDER BY created_at DESC LIMIT 1").get();
+        } else if (options.snapshot) {
+            const snapshotId = parseInt(options.snapshot);
+            snapshot = db.query("SELECT * FROM snapshots WHERE id = ?").get(snapshotId);
+        }
+
+        if (!snapshot) {
+            console.error("\nNenhum snapshot para restaurar.\n");
+            process.exit(1);
+        }
+
+        const data = JSON.parse(snapshot.data);
+        const now = new Date().toISOString();
+
+        console.log(`\nRestaurando snapshot #${snapshot.id}...`);
+
+        // 1. Restaurar spec
+        if (data.spec) {
+            db.run(
+                `UPDATE specs SET phase = ?, approved_at = ?, updated_at = ? WHERE id = ?`,
+                [data.spec.phase, data.spec.approved_at, now, data.spec.id]
+            );
+            console.log(`  ✓ Spec restaurado (fase: ${data.spec.phase})`);
+        }
+
+        // 2. Restaurar context
+        if (data.context) {
+            db.run(
+                `UPDATE context SET
+          objective = ?, approach = ?, constraints = ?, patterns = ?,
+          current_task = ?, last_checkpoint = ?, updated_at = ?
+        WHERE spec_id = ?`,
+                [
+                    data.context.objective,
+                    data.context.approach,
+                    data.context.constraints,
+                    data.context.patterns,
+                    data.context.current_task,
+                    data.checkpoint || data.context.last_checkpoint,
+                    now,
+                    snapshot.spec_id,
+                ]
+            );
+            console.log(`  ✓ Context restaurado`);
+        }
+
+        // 3. Restaurar status das tasks
+        if (data.tasks && Array.isArray(data.tasks)) {
+            for (const task of data.tasks) {
+                db.run(
+                    `UPDATE tasks SET status = ?, checkpoint = ?, completed_at = ? WHERE id = ?`,
+                    [task.status, task.checkpoint, task.completed_at, task.id]
+                );
+            }
+            console.log(`  ✓ ${data.tasks.length} tasks restauradas`);
+        }
+
+        // 4. Log do que foi restaurado
+        console.log(`\n${"─".repeat(50)}`);
+        console.log(`Snapshot #${snapshot.id} restaurado com sucesso!`);
+        console.log(`  Spec: ${snapshot.spec_id}`);
+        console.log(`  Trigger: ${snapshot.trigger}`);
+        console.log(`  Data original: ${snapshot.created_at}`);
+        if (data.taskCompleted) {
+            console.log(`  Task completada: #${data.taskCompleted}`);
+        }
+        if (data.checkpoint) {
+            console.log(`  Checkpoint: ${data.checkpoint}`);
+        }
+        console.log(`\nUse 'status' para ver o estado atual.\n`);
+        return;
+    }
+
+    // Mostrar detalhes de snapshot específico
+    if (options.snapshot) {
+        const snapshotId = parseInt(options.snapshot);
+        const snapshot = db.query("SELECT * FROM snapshots WHERE id = ?").get(snapshotId) as any;
+
+        if (!snapshot) {
+            console.error(`\nSnapshot #${snapshotId} nao encontrado.\n`);
+            process.exit(1);
+        }
+
+        const data = JSON.parse(snapshot.data);
+
+        console.log(`\nSnapshot #${snapshotId}:`);
+        console.log(`  Spec: ${snapshot.spec_id}`);
+        console.log(`  Trigger: ${snapshot.trigger}`);
+        console.log(`  Data: ${snapshot.created_at}`);
+        console.log(`\nDados:`);
+        console.log(JSON.stringify(data, null, 2));
+        console.log(`\nPara restaurar: recover --restore --snapshot ${snapshotId}\n`);
+        return;
+    }
+
+    // Mostrar ultimo snapshot
+    const last = db
+        .query("SELECT * FROM snapshots ORDER BY created_at DESC LIMIT 1")
+        .get() as any;
+
+    if (!last) {
+        console.log("\nNenhum snapshot disponivel.\n");
+        return;
+    }
+
+    console.log(`\nUltimo snapshot:`);
+    console.log(`  #${last.id}: ${last.spec_id} (${last.trigger}) - ${last.created_at}`);
+    console.log(`\nComandos:`);
+    console.log(`  --list              Lista todos os snapshots`);
+    console.log(`  --snapshot <id>     Mostra detalhes de um snapshot`);
+    console.log(`  --restore --snapshot <id>  Restaura um snapshot especifico`);
+    console.log(`  --auto              Restaura o ultimo snapshot automaticamente\n`);
+}