@codexa/cli 8.5.0 → 8.6.0

package/db/schema.ts

@@ -1,788 +1,719 @@
-import { getDb } from "./connection";
-
-export function initSchema(): void {
-  const db = getDb();
-
-  db.exec(`
-    -- 1. Feature sendo desenvolvida
-    CREATE TABLE IF NOT EXISTS specs (
-      id TEXT PRIMARY KEY,
-      name TEXT NOT NULL,
-      phase TEXT NOT NULL DEFAULT 'planning',
-      approved_at TEXT,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      updated_at TEXT
-    );
-
-    -- 2. Contexto compartilhado (o coracao do sistema)
-    CREATE TABLE IF NOT EXISTS context (
-      spec_id TEXT PRIMARY KEY REFERENCES specs(id),
-      objective TEXT NOT NULL,
-      approach TEXT,
-      constraints TEXT,
-      patterns TEXT,
-      current_task INTEGER,
-      total_tasks INTEGER,
-      last_checkpoint TEXT,
-      updated_at TEXT
-    );
-
-    -- 3. Tarefas com dependencias (para paralelizacao)
-    CREATE TABLE IF NOT EXISTS tasks (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      spec_id TEXT NOT NULL REFERENCES specs(id),
-      number INTEGER NOT NULL,
-      name TEXT NOT NULL,
-      depends_on TEXT,
-      can_parallel INTEGER DEFAULT 1,
-      agent TEXT,
-      files TEXT,
-      status TEXT DEFAULT 'pending',
-      checkpoint TEXT,
-      completed_at TEXT,
-      UNIQUE(spec_id, number)
-    );
-
-    -- 4. Decisoes (registro critico)
-    CREATE TABLE IF NOT EXISTS decisions (
-      id TEXT PRIMARY KEY,
-      spec_id TEXT NOT NULL REFERENCES specs(id),
-      task_ref INTEGER,
-      title TEXT NOT NULL,
-      decision TEXT NOT NULL,
-      rationale TEXT,
-      status TEXT DEFAULT 'active',
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    -- 5. Artefatos
-    CREATE TABLE IF NOT EXISTS artifacts (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      spec_id TEXT NOT NULL REFERENCES specs(id),
-      task_ref INTEGER NOT NULL,
-      path TEXT NOT NULL,
-      action TEXT NOT NULL,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      UNIQUE(spec_id, path)
-    );
-
-    -- 6. Review (fase REV)
-    CREATE TABLE IF NOT EXISTS review (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      spec_id TEXT NOT NULL REFERENCES specs(id),
-      planned_vs_done TEXT,
-      deviations TEXT,
-      pattern_violations TEXT,
-      status TEXT DEFAULT 'pending',
-      resolution TEXT,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    -- 7. Snapshots (recovery)
-    CREATE TABLE IF NOT EXISTS snapshots (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      spec_id TEXT NOT NULL REFERENCES specs(id),
-      data TEXT NOT NULL,
-      trigger TEXT NOT NULL,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    -- 8. Projeto (informacoes detectadas no discover)
-    CREATE TABLE IF NOT EXISTS project (
-      id TEXT PRIMARY KEY DEFAULT 'default',
-      name TEXT,
-      stack TEXT NOT NULL,
-      discovered_at TEXT,
-      updated_at TEXT
-    );
-
-    -- 9. Standards do projeto
-    CREATE TABLE IF NOT EXISTS standards (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      category TEXT NOT NULL,
-      scope TEXT NOT NULL,
-      rule TEXT NOT NULL,
-      examples TEXT,
-      anti_examples TEXT,
-      enforcement TEXT DEFAULT 'required',
-      source TEXT,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    -- 10. Knowledge broadcast (compartilhamento em tempo real)
-    CREATE TABLE IF NOT EXISTS knowledge (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      spec_id TEXT NOT NULL REFERENCES specs(id),
-      task_origin INTEGER NOT NULL,
-      category TEXT NOT NULL,
-      content TEXT NOT NULL,
-      severity TEXT DEFAULT 'info',
-      broadcast_to TEXT DEFAULT 'all',
-      acknowledged_by TEXT,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    -- 11. Gate bypass log (auditoria de bypasses)
-    CREATE TABLE IF NOT EXISTS gate_bypasses (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      spec_id TEXT NOT NULL REFERENCES specs(id),
-      task_id INTEGER NOT NULL,
-      gate_name TEXT NOT NULL,
-      reason TEXT,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    -- 12. Product context (PRD/contexto de produto)
-    CREATE TABLE IF NOT EXISTS product_context (
-      id TEXT PRIMARY KEY DEFAULT 'default',
-      name TEXT NOT NULL,
-      problem TEXT NOT NULL,
-      solution TEXT,
-      target_users TEXT,
-      value_proposition TEXT,
-      success_metrics TEXT,
-      out_of_scope TEXT,
-      constraints TEXT,
-      source TEXT DEFAULT 'guide',
-      discovered_at TEXT,
-      updated_at TEXT
-    );
-
-    -- 13. Product goals (objetivos do produto)
-    CREATE TABLE IF NOT EXISTS product_goals (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      product_id TEXT NOT NULL DEFAULT 'default' REFERENCES product_context(id),
-      category TEXT NOT NULL,
-      goal TEXT NOT NULL,
-      priority TEXT DEFAULT 'medium',
-      status TEXT DEFAULT 'active',
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    -- 14. Product features (features core do produto)
-    CREATE TABLE IF NOT EXISTS product_features (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      product_id TEXT NOT NULL DEFAULT 'default' REFERENCES product_context(id),
-      name TEXT NOT NULL,
-      description TEXT,
-      priority TEXT DEFAULT 'medium',
-      status TEXT DEFAULT 'planned',
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    -- 15. Library contexts (contexto atualizado por biblioteca)
-    CREATE TABLE IF NOT EXISTS lib_contexts (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      lib_name TEXT NOT NULL UNIQUE,
-      version TEXT NOT NULL,
-      context_file TEXT NOT NULL,
-      source_url TEXT,
-      researched_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      updated_at TEXT
-    );
-
-    -- 16. Agent lib mappings (quais libs cada agente carrega)
-    CREATE TABLE IF NOT EXISTS agent_lib_mappings (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      agent_type TEXT NOT NULL,
-      lib_name TEXT NOT NULL,
-      priority INTEGER DEFAULT 0,
-      UNIQUE(agent_type, lib_name)
-    );
-
-    -- 17. Implementation patterns (padroes extraidos do codigo - v7.4)
-    CREATE TABLE IF NOT EXISTS implementation_patterns (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-
-      -- Identificacao
-      category TEXT NOT NULL,        -- component, hook, service, route, schema, test, action
-      name TEXT NOT NULL UNIQUE,     -- ex: "page-component", "data-hook", "api-route"
-
-      -- Contexto
-      scope TEXT NOT NULL,           -- frontend, backend, database, testing
-      applies_to TEXT NOT NULL,      -- glob pattern: "app/**/page.tsx", "src/hooks/*.ts"
-
-      -- O Padrao Extraido
-      structure TEXT NOT NULL,       -- JSON com estrutura comum (imports, exports, patterns, conventions)
-      template TEXT NOT NULL,        -- Template de codigo com placeholders
-      examples TEXT NOT NULL,        -- JSON array de arquivos que seguem este padrao
-
-      -- Anti-patterns identificados
-      anti_patterns TEXT,            -- JSON array de anti-patterns encontrados
-
-      -- Metadados
-      confidence REAL DEFAULT 0.8,   -- 0-1, baseado em quantos arquivos seguem
-      extracted_from INTEGER,        -- Quantos arquivos foram analisados
-
-      -- Auditoria
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      updated_at TEXT
-    );
-
-    -- 18. Knowledge Graph (v8.0 - Relacoes entre entidades)
-    CREATE TABLE IF NOT EXISTS knowledge_graph (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      spec_id TEXT REFERENCES specs(id),
-
-      -- No de origem
-      source_type TEXT NOT NULL,  -- file, decision, pattern, task, artifact
-      source_id TEXT NOT NULL,
-
-      -- No de destino
-      target_type TEXT NOT NULL,
-      target_id TEXT NOT NULL,
-
-      -- Relacao
-      relation TEXT NOT NULL,     -- uses, implements, depends_on, modifies, contradicts, extracted_from
-
-      -- Metadados
-      strength REAL DEFAULT 1.0,  -- 0-1, peso da relacao
-      metadata TEXT,              -- JSON com informacoes adicionais
-
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    -- 19. Reasoning Log (v8.0 - Historico de raciocinio)
-    CREATE TABLE IF NOT EXISTS reasoning_log (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      spec_id TEXT REFERENCES specs(id),
-      task_id INTEGER REFERENCES tasks(id),
-
-      -- O raciocinio
-      category TEXT NOT NULL,     -- decision, discovery, error, success, challenge, recommendation
-      thought TEXT NOT NULL,      -- "Escolhi X porque Y"
-
-      -- Contexto
-      related_files TEXT,         -- JSON array de arquivos
-      related_decisions TEXT,     -- JSON array de decision IDs
-      related_patterns TEXT,      -- JSON array de pattern names
-
-      -- Importancia
-      importance TEXT DEFAULT 'normal',  -- critical, high, normal, low
-
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    -- 20. Session Summaries (v8.0 - Resumos de sessao para continuidade)
-    CREATE TABLE IF NOT EXISTS session_summaries (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      spec_id TEXT NOT NULL REFERENCES specs(id),
-
-      -- Periodo
-      start_time TEXT NOT NULL,
-      end_time TEXT NOT NULL,
-
-      -- Conteudo
-      summary TEXT NOT NULL,      -- O que foi feito
-      decisions TEXT,             -- JSON array de decisoes tomadas
-      blockers TEXT,              -- JSON array de problemas encontrados
-      next_steps TEXT,            -- JSON array de recomendacoes
-
-      -- Estatisticas
-      tasks_completed INTEGER DEFAULT 0,
-      files_created INTEGER DEFAULT 0,
-      files_modified INTEGER DEFAULT 0,
-
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    -- 21. Architectural Analyses (v8.1 - migrado de architect.ts para schema central)
-    CREATE TABLE IF NOT EXISTS architectural_analyses (
-      id TEXT PRIMARY KEY,
-      name TEXT NOT NULL,
-      description TEXT NOT NULL,
-      status TEXT NOT NULL DEFAULT 'pending',
-
-      -- Conteudo JSON
-      context TEXT,
-      current_architecture TEXT,
-      approach TEXT,
-      chosen_alternative TEXT,
-      diagrams TEXT,           -- JSON array
-      baby_steps TEXT,         -- JSON array
-      risks TEXT,              -- JSON array
-      alternatives TEXT,       -- JSON array
-      decisions TEXT,          -- JSON array
-
-      -- Arquivo gerado
-      file_path TEXT,
-
-      -- Timestamps
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      updated_at TEXT,
-      approved_at TEXT
-    );
-
-    -- 22. Project Utilities (v8.5 - DRY enforcement utility map)
-    CREATE TABLE IF NOT EXISTS project_utilities (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      file_path TEXT NOT NULL,
-      utility_name TEXT NOT NULL,
-      utility_type TEXT NOT NULL,
-      scope TEXT NOT NULL,
-      signature TEXT,
-      description TEXT,
-      spec_id TEXT,
-      task_ref INTEGER,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      updated_at TEXT,
-      UNIQUE(file_path, utility_name)
-    );
-
-    -- Indices para performance
-    CREATE INDEX IF NOT EXISTS idx_tasks_spec ON tasks(spec_id);
-    CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
-    CREATE INDEX IF NOT EXISTS idx_decisions_spec ON decisions(spec_id);
-    CREATE INDEX IF NOT EXISTS idx_artifacts_spec ON artifacts(spec_id);
-    CREATE INDEX IF NOT EXISTS idx_snapshots_spec ON snapshots(spec_id);
-    CREATE INDEX IF NOT EXISTS idx_standards_category ON standards(category);
-    CREATE INDEX IF NOT EXISTS idx_standards_scope ON standards(scope);
-    CREATE INDEX IF NOT EXISTS idx_knowledge_spec ON knowledge(spec_id);
-    CREATE INDEX IF NOT EXISTS idx_knowledge_category ON knowledge(category);
-    CREATE INDEX IF NOT EXISTS idx_knowledge_severity ON knowledge(severity);
-    CREATE INDEX IF NOT EXISTS idx_gate_bypasses_spec ON gate_bypasses(spec_id);
-    CREATE INDEX IF NOT EXISTS idx_product_goals_product ON product_goals(product_id);
-    CREATE INDEX IF NOT EXISTS idx_product_goals_category ON product_goals(category);
-    CREATE INDEX IF NOT EXISTS idx_product_features_product ON product_features(product_id);
-    CREATE INDEX IF NOT EXISTS idx_product_features_priority ON product_features(priority);
-    CREATE INDEX IF NOT EXISTS idx_lib_contexts_lib ON lib_contexts(lib_name);
-    CREATE INDEX IF NOT EXISTS idx_agent_lib_mappings_agent ON agent_lib_mappings(agent_type);
-    CREATE INDEX IF NOT EXISTS idx_impl_patterns_category ON implementation_patterns(category);
-    CREATE INDEX IF NOT EXISTS idx_impl_patterns_scope ON implementation_patterns(scope);
-    CREATE INDEX IF NOT EXISTS idx_impl_patterns_name ON implementation_patterns(name);
-
-    -- v8.0: Indices para Knowledge Graph
-    CREATE INDEX IF NOT EXISTS idx_kg_source ON knowledge_graph(source_type, source_id);
-    CREATE INDEX IF NOT EXISTS idx_kg_target ON knowledge_graph(target_type, target_id);
-    CREATE INDEX IF NOT EXISTS idx_kg_relation ON knowledge_graph(relation);
-    CREATE INDEX IF NOT EXISTS idx_kg_spec ON knowledge_graph(spec_id);
-
-    -- v8.0: Indices para Reasoning Log
-    CREATE INDEX IF NOT EXISTS idx_reasoning_spec ON reasoning_log(spec_id);
-    CREATE INDEX IF NOT EXISTS idx_reasoning_task ON reasoning_log(task_id);
-    CREATE INDEX IF NOT EXISTS idx_reasoning_category ON reasoning_log(category);
-    CREATE INDEX IF NOT EXISTS idx_reasoning_importance ON reasoning_log(importance);
-
-    -- v8.0: Indices para Session Summaries
-    CREATE INDEX IF NOT EXISTS idx_session_spec ON session_summaries(spec_id);
-    CREATE INDEX IF NOT EXISTS idx_session_time ON session_summaries(end_time);
-
-    -- v8.1: Indices para Architectural Analyses
-    CREATE INDEX IF NOT EXISTS idx_arch_status ON architectural_analyses(status);
-    CREATE INDEX IF NOT EXISTS idx_arch_created ON architectural_analyses(created_at);
-
-    -- v8.5: Indices para Project Utilities
-    CREATE INDEX IF NOT EXISTS idx_utils_scope ON project_utilities(scope);
-    CREATE INDEX IF NOT EXISTS idx_utils_name ON project_utilities(utility_name);
-    CREATE INDEX IF NOT EXISTS idx_utils_file ON project_utilities(file_path);
-  `);
-
-  // v8.4: Migracao - adicionar analysis_id na tabela specs
-  try {
-    db.exec(`ALTER TABLE specs ADD COLUMN analysis_id TEXT`);
-  } catch {
-    // Coluna ja existe - ignorar
-  }
-}
-
-export function resetDb(): void {
-  const db = getDb();
-  db.exec(`
-    DROP TABLE IF EXISTS session_summaries;
-    DROP TABLE IF EXISTS reasoning_log;
-    DROP TABLE IF EXISTS knowledge_graph;
-    DROP TABLE IF EXISTS implementation_patterns;
-    DROP TABLE IF EXISTS agent_lib_mappings;
-    DROP TABLE IF EXISTS lib_contexts;
-    DROP TABLE IF EXISTS product_features;
-    DROP TABLE IF EXISTS product_goals;
-    DROP TABLE IF EXISTS product_context;
-    DROP TABLE IF EXISTS gate_bypasses;
-    DROP TABLE IF EXISTS knowledge;
-    DROP TABLE IF EXISTS standards;
-    DROP TABLE IF EXISTS project;
-    DROP TABLE IF EXISTS snapshots;
-    DROP TABLE IF EXISTS review;
-    DROP TABLE IF EXISTS artifacts;
-    DROP TABLE IF EXISTS decisions;
-    DROP TABLE IF EXISTS tasks;
-    DROP TABLE IF EXISTS context;
-    DROP TABLE IF EXISTS specs;
-  `);
-  initSchema();
-}
-
-export function hasDiscoveredProject(): boolean {
-  const db = getDb();
-  const project = db.query("SELECT * FROM project WHERE id = 'default'").get() as any;
-  const standardsCount = db.query("SELECT COUNT(*) as c FROM standards").get() as any;
-  return project !== null && standardsCount.c > 0;
-}
-
-export function hasProductContext(): boolean {
-  const db = getDb();
-  const product = db.query("SELECT * FROM product_context WHERE id = 'default'").get() as any;
-  return product !== null;
-}
-
-export function hasImplementationPatterns(): boolean {
-  const db = getDb();
-  const count = db.query("SELECT COUNT(*) as c FROM implementation_patterns").get() as any;
-  return count.c > 0;
-}
-
-export function getPatternsByScope(scope: string): any[] {
-  const db = getDb();
-  return db.query(
-    "SELECT * FROM implementation_patterns WHERE scope = ? OR scope = 'all' ORDER BY category, name"
-  ).all(scope) as any[];
-}
-
-export function getPatternByName(name: string): any {
-  const db = getDb();
-  return db.query("SELECT * FROM implementation_patterns WHERE name = ?").get(name) as any;
-}
-
-export function getPatternsForFiles(files: string[]): any[] {
-  const db = getDb();
-  const patterns = db.query("SELECT * FROM implementation_patterns").all() as any[];
-
-  // Filtrar patterns que correspondem aos arquivos da task
-  return patterns.filter(pattern => {
-    const glob = pattern.applies_to;
-    return files.some(file => {
-      // Simplificado: verificar se o arquivo corresponde ao glob pattern
-      // Ex: "app/**/page.tsx" deve corresponder a "app/dashboard/page.tsx"
-      const regexPattern = glob
-        .replace(/\*\*/g, '.*')
-        .replace(/\*/g, '[^/]*')
-        .replace(/\//g, '\\/');
-      const regex = new RegExp(`^${regexPattern}$`);
-      return regex.test(file);
-    });
-  });
-}
-
-// ═══════════════════════════════════════════════════════════════
-// v8.0: Knowledge Graph Helpers
-// ═══════════════════════════════════════════════════════════════
-
-export interface GraphRelation {
-  sourceType: string;
-  sourceId: string;
-  targetType: string;
-  targetId: string;
-  relation: string;
-  strength?: number;
-  metadata?: Record<string, any>;
-}
-
-export function addGraphRelation(specId: string | null, relation: GraphRelation): void {
-  const db = getDb();
-  const now = new Date().toISOString();
-
-  db.run(
-    `INSERT INTO knowledge_graph (spec_id, source_type, source_id, target_type, target_id, relation, strength, metadata, created_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-    [
-      specId,
-      relation.sourceType,
-      relation.sourceId,
-      relation.targetType,
-      relation.targetId,
-      relation.relation,
-      relation.strength || 1.0,
-      relation.metadata ? JSON.stringify(relation.metadata) : null,
-      now,
-    ]
-  );
-}
-
-export function getRelatedDecisions(fileOrPattern: string, type: "file" | "pattern"): any[] {
-  const db = getDb();
-
-  return db.query(`
-    SELECT d.* FROM decisions d
-    JOIN knowledge_graph kg ON kg.source_id = d.id AND kg.source_type = 'decision'
-    WHERE kg.target_type = ? AND kg.target_id = ?
-    AND kg.relation IN ('implements', 'depends_on', 'uses')
-  `).all(type, fileOrPattern) as any[];
-}
-
-export function getRelatedFiles(decisionOrPattern: string, type: "decision" | "pattern"): string[] {
-  const db = getDb();
-
-  const results = db.query(`
-    SELECT kg.target_id as file FROM knowledge_graph kg
-    WHERE kg.source_type = ? AND kg.source_id = ?
-    AND kg.target_type = 'file'
-    AND kg.relation IN ('implements', 'modifies', 'creates')
-  `).all(type, decisionOrPattern) as any[];
-
-  return results.map(r => r.file);
-}
-
-export function findContradictions(specId: string): Array<{ decision1: string; decision2: string; createdAt: string }> {
-  const db = getDb();
-
-  return db.query(`
-    SELECT
-      d1.title as decision1,
-      d2.title as decision2,
-      kg.created_at as createdAt
-    FROM knowledge_graph kg
-    JOIN decisions d1 ON kg.source_id = d1.id
-    JOIN decisions d2 ON kg.target_id = d2.id
-    WHERE kg.relation = 'contradicts'
-    AND kg.spec_id = ?
-  `).all(specId) as any[];
-}
-
-// ═══════════════════════════════════════════════════════════════
-// v8.0: Reasoning Log Helpers
-// ═══════════════════════════════════════════════════════════════
-
-export interface ReasoningEntry {
-  category: "decision" | "discovery" | "error" | "success" | "challenge" | "recommendation";
-  thought: string;
-  relatedFiles?: string[];
-  relatedDecisions?: string[];
-  relatedPatterns?: string[];
-  importance?: "critical" | "high" | "normal" | "low";
-}
-
-export function addReasoning(specId: string, taskId: number | null, entry: ReasoningEntry): void {
-  const db = getDb();
-  const now = new Date().toISOString();
-
-  db.run(
-    `INSERT INTO reasoning_log (spec_id, task_id, category, thought, related_files, related_decisions, related_patterns, importance, created_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-    [
-      specId,
-      taskId,
-      entry.category,
-      entry.thought,
-      entry.relatedFiles ? JSON.stringify(entry.relatedFiles) : null,
-      entry.relatedDecisions ? JSON.stringify(entry.relatedDecisions) : null,
-      entry.relatedPatterns ? JSON.stringify(entry.relatedPatterns) : null,
-      entry.importance || "normal",
-      now,
-    ]
-  );
-}
-
-export function getReasoningForTask(specId: string, taskId: number, limit: number = 10): any[] {
-  const db = getDb();
-
-  return db.query(`
-    SELECT * FROM reasoning_log
-    WHERE spec_id = ? AND (task_id = ? OR task_id IS NULL)
-    ORDER BY
-      CASE importance
-        WHEN 'critical' THEN 1
-        WHEN 'high' THEN 2
-        WHEN 'normal' THEN 3
-        WHEN 'low' THEN 4
-      END,
-      created_at DESC
-    LIMIT ?
-  `).all(specId, taskId, limit) as any[];
-}
-
-export function getRecentReasoning(specId: string, limit: number = 20): any[] {
-  const db = getDb();
-
-  return db.query(`
-    SELECT * FROM reasoning_log
-    WHERE spec_id = ?
-    ORDER BY created_at DESC
-    LIMIT ?
-  `).all(specId, limit) as any[];
-}
-
-// ═══════════════════════════════════════════════════════════════
-// v8.0: Session Summary Helpers
-// ═══════════════════════════════════════════════════════════════
-
-export interface SessionSummaryData {
-  startTime: string;
-  endTime: string;
-  summary: string;
-  decisions?: string[];
-  blockers?: string[];
-  nextSteps?: string[];
-  tasksCompleted?: number;
-  filesCreated?: number;
-  filesModified?: number;
-}
-
-export function addSessionSummary(specId: string, data: SessionSummaryData): void {
-  const db = getDb();
-  const now = new Date().toISOString();
-
-  db.run(
-    `INSERT INTO session_summaries (spec_id, start_time, end_time, summary, decisions, blockers, next_steps, tasks_completed, files_created, files_modified, created_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-    [
-      specId,
-      data.startTime,
-      data.endTime,
-      data.summary,
-      data.decisions ? JSON.stringify(data.decisions) : null,
-      data.blockers ? JSON.stringify(data.blockers) : null,
-      data.nextSteps ? JSON.stringify(data.nextSteps) : null,
-      data.tasksCompleted || 0,
-      data.filesCreated || 0,
-      data.filesModified || 0,
-      now,
-    ]
-  );
-}
-
-export function getLastSessionSummary(specId: string): any {
-  const db = getDb();
-
-  return db.query(`
-    SELECT * FROM session_summaries
-    WHERE spec_id = ?
-    ORDER BY created_at DESC
-    LIMIT 1
-  `).get(specId);
-}
-
-// v8.3: Retorna ultimas N sessoes para contexto composto
-export function getSessionSummaries(specId: string, limit: number = 5): any[] {
-  const db = getDb();
-
-  return db.query(`
-    SELECT * FROM session_summaries
-    WHERE spec_id = ?
-    ORDER BY created_at DESC
-    LIMIT ?
-  `).all(specId, limit) as any[];
-}
-
-// v8.4: Busca analise arquitetural associada a um spec
-// Prioridade: analysis_id (link explicito) > nome exato > LIKE parcial
-export function getArchitecturalAnalysisForSpec(specName: string, specId?: string): any {
-  const db = getDb();
-
-  try {
-    // 0. Link explicito via analysis_id na tabela specs
-    if (specId) {
-      const spec = db.query("SELECT analysis_id FROM specs WHERE id = ?").get(specId) as any;
-      if (spec?.analysis_id) {
-        const analysis = db.query(
-          "SELECT * FROM architectural_analyses WHERE id = ? AND status IN ('approved', 'implemented')"
-        ).get(spec.analysis_id) as any;
-        if (analysis) return analysis;
-      }
-    }
-
-    // 1. Match exato por nome
-    let analysis = db.query(
-      "SELECT * FROM architectural_analyses WHERE name = ? AND status IN ('approved', 'implemented') ORDER BY approved_at DESC LIMIT 1"
-    ).get(specName) as any;
-
-    if (analysis) return analysis;
-
-    // 2. Match parcial (nome da spec contido no nome da analise ou vice-versa)
-    analysis = db.query(
-      "SELECT * FROM architectural_analyses WHERE (name LIKE ? OR ? LIKE '%' || name || '%') AND status IN ('approved', 'implemented') ORDER BY approved_at DESC LIMIT 1"
-    ).get(`%${specName}%`, specName) as any;
-
-    return analysis || null;
-  } catch {
-    // Tabela pode nao existir se architect nunca foi usado
-    return null;
-  }
-}
-
-// ═══════════════════════════════════════════════════════════════
-// v8.5: Project Utilities Helpers (DRY enforcement)
-// ═══════════════════════════════════════════════════════════════
-
-export interface ProjectUtility {
-  filePath: string;
-  utilityName: string;
-  utilityType: string;
-  scope: string;
-  signature?: string;
-  description?: string;
-}
-
-export function upsertUtility(
-  utility: ProjectUtility,
-  specId?: string,
-  taskRef?: number
-): void {
-  const db = getDb();
-  const now = new Date().toISOString();
-  db.run(
-    `INSERT INTO project_utilities (file_path, utility_name, utility_type, scope, signature, description, spec_id, task_ref, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-     ON CONFLICT(file_path, utility_name) DO UPDATE SET
-       utility_type = excluded.utility_type,
-       scope = excluded.scope,
-       signature = COALESCE(excluded.signature, project_utilities.signature),
-       description = COALESCE(excluded.description, project_utilities.description),
-       updated_at = excluded.updated_at`,
-    [
-      utility.filePath, utility.utilityName, utility.utilityType, utility.scope,
-      utility.signature || null, utility.description || null,
-      specId || null, taskRef || null, now, now,
-    ]
-  );
-}
-
-export function getUtilitiesForContext(
-  dirs: string[],
-  scope?: string,
-  limit: number = 15
-): any[] {
-  const db = getDb();
-
-  // Se nenhum filtro, retornar mais recentes
-  if (dirs.length === 0 && !scope) {
-    return db.query(
-      "SELECT * FROM project_utilities ORDER BY updated_at DESC LIMIT ?"
-    ).all(limit) as any[];
-  }
-
-  // Buscar por diretorio (prioridade) e scope (fallback)
-  const conditions: string[] = [];
-  const params: any[] = [];
-
-  for (const dir of dirs) {
-    const normalized = dir.replace(/\\/g, "/");
-    conditions.push("REPLACE(file_path, '\\', '/') LIKE ?");
-    params.push(`${normalized}%`);
-  }
-
-  if (scope) {
-    conditions.push("scope = ?");
-    params.push(scope);
-  }
-
-  params.push(limit);
-  const where = conditions.length > 0 ? `WHERE (${conditions.join(" OR ")})` : "";
-  return db.query(
-    `SELECT * FROM project_utilities ${where} ORDER BY updated_at DESC LIMIT ?`
-  ).all(...params) as any[];
-}
-
-export function findDuplicateUtilities(
-  utilityName: string,
-  excludeFile?: string
-): any[] {
-  const db = getDb();
-  if (excludeFile) {
-    return db.query(
-      "SELECT * FROM project_utilities WHERE utility_name = ? AND file_path != ?"
-    ).all(utilityName, excludeFile) as any[];
-  }
-  return db.query(
-    "SELECT * FROM project_utilities WHERE utility_name = ?"
-  ).all(utilityName) as any[];
-}
+import { getDb } from "./connection";
+
+export function initSchema(): void {
+  const db = getDb();
+
+  db.exec(`
+    -- 1. Feature sendo desenvolvida
+    CREATE TABLE IF NOT EXISTS specs (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      phase TEXT NOT NULL DEFAULT 'planning',
+      approved_at TEXT,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      updated_at TEXT
+    );
+
+    -- 2. Contexto compartilhado (o coracao do sistema)
+    CREATE TABLE IF NOT EXISTS context (
+      spec_id TEXT PRIMARY KEY REFERENCES specs(id),
+      objective TEXT NOT NULL,
+      approach TEXT,
+      constraints TEXT,
+      patterns TEXT,
+      current_task INTEGER,
+      total_tasks INTEGER,
+      last_checkpoint TEXT,
+      updated_at TEXT
+    );
+
+    -- 3. Tarefas com dependencias (para paralelizacao)
+    CREATE TABLE IF NOT EXISTS tasks (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      spec_id TEXT NOT NULL REFERENCES specs(id),
+      number INTEGER NOT NULL,
+      name TEXT NOT NULL,
+      depends_on TEXT,
+      can_parallel INTEGER DEFAULT 1,
+      agent TEXT,
+      files TEXT,
+      status TEXT DEFAULT 'pending',
+      checkpoint TEXT,
+      completed_at TEXT,
+      UNIQUE(spec_id, number)
+    );
+
+    -- 4. Decisoes (registro critico)
+    CREATE TABLE IF NOT EXISTS decisions (
+      id TEXT PRIMARY KEY,
+      spec_id TEXT NOT NULL REFERENCES specs(id),
+      task_ref INTEGER,
+      title TEXT NOT NULL,
+      decision TEXT NOT NULL,
+      rationale TEXT,
+      status TEXT DEFAULT 'active',
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- 5. Artefatos
+    CREATE TABLE IF NOT EXISTS artifacts (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      spec_id TEXT NOT NULL REFERENCES specs(id),
+      task_ref INTEGER NOT NULL,
+      path TEXT NOT NULL,
+      action TEXT NOT NULL,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      UNIQUE(spec_id, path)
+    );
+
+    -- 6. Review (fase REV)
+    CREATE TABLE IF NOT EXISTS review (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      spec_id TEXT NOT NULL REFERENCES specs(id),
+      planned_vs_done TEXT,
+      deviations TEXT,
+      pattern_violations TEXT,
+      status TEXT DEFAULT 'pending',
+      resolution TEXT,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- 7. Snapshots (recovery)
+    CREATE TABLE IF NOT EXISTS snapshots (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      spec_id TEXT NOT NULL REFERENCES specs(id),
+      data TEXT NOT NULL,
+      trigger TEXT NOT NULL,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- 8. Projeto (informacoes detectadas no discover)
+    CREATE TABLE IF NOT EXISTS project (
+      id TEXT PRIMARY KEY DEFAULT 'default',
+      name TEXT,
+      stack TEXT NOT NULL,
+      discovered_at TEXT,
+      updated_at TEXT
+    );
+
+    -- 9. Standards do projeto
+    CREATE TABLE IF NOT EXISTS standards (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      category TEXT NOT NULL,
+      scope TEXT NOT NULL,
+      rule TEXT NOT NULL,
+      examples TEXT,
+      anti_examples TEXT,
+      enforcement TEXT DEFAULT 'required',
+      source TEXT,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- 10. Knowledge broadcast (compartilhamento em tempo real)
+    CREATE TABLE IF NOT EXISTS knowledge (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      spec_id TEXT NOT NULL REFERENCES specs(id),
+      task_origin INTEGER NOT NULL,
+      category TEXT NOT NULL,
+      content TEXT NOT NULL,
+      severity TEXT DEFAULT 'info',
+      broadcast_to TEXT DEFAULT 'all',
+      acknowledged_by TEXT,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- 11. Gate bypass log (auditoria de bypasses)
+    CREATE TABLE IF NOT EXISTS gate_bypasses (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      spec_id TEXT NOT NULL REFERENCES specs(id),
+      task_id INTEGER NOT NULL,
+      gate_name TEXT NOT NULL,
+      reason TEXT,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- 12. Product context (PRD/contexto de produto)
+    CREATE TABLE IF NOT EXISTS product_context (
+      id TEXT PRIMARY KEY DEFAULT 'default',
+      name TEXT NOT NULL,
+      problem TEXT NOT NULL,
+      solution TEXT,
+      target_users TEXT,
+      value_proposition TEXT,
+      success_metrics TEXT,
+      out_of_scope TEXT,
+      constraints TEXT,
+      source TEXT DEFAULT 'guide',
+      discovered_at TEXT,
+      updated_at TEXT
+    );
+
+    -- 13. Product goals (objetivos do produto)
+    CREATE TABLE IF NOT EXISTS product_goals (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      product_id TEXT NOT NULL DEFAULT 'default' REFERENCES product_context(id),
+      category TEXT NOT NULL,
+      goal TEXT NOT NULL,
+      priority TEXT DEFAULT 'medium',
+      status TEXT DEFAULT 'active',
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- 14. Product features (features core do produto)
+    CREATE TABLE IF NOT EXISTS product_features (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      product_id TEXT NOT NULL DEFAULT 'default' REFERENCES product_context(id),
+      name TEXT NOT NULL,
+      description TEXT,
+      priority TEXT DEFAULT 'medium',
+      status TEXT DEFAULT 'planned',
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- 15. Library contexts (contexto atualizado por biblioteca)
+    CREATE TABLE IF NOT EXISTS lib_contexts (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      lib_name TEXT NOT NULL UNIQUE,
+      version TEXT NOT NULL,
+      context_file TEXT NOT NULL,
+      source_url TEXT,
+      researched_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      updated_at TEXT
+    );
+
+    -- 16. Agent lib mappings (quais libs cada agente carrega)
+    CREATE TABLE IF NOT EXISTS agent_lib_mappings (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      agent_type TEXT NOT NULL,
+      lib_name TEXT NOT NULL,
+      priority INTEGER DEFAULT 0,
+      UNIQUE(agent_type, lib_name)
+    );
+
+    -- 17. Implementation patterns (padroes extraidos do codigo - v7.4)
+    CREATE TABLE IF NOT EXISTS implementation_patterns (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+
+      -- Identificacao
+      category TEXT NOT NULL,        -- component, hook, service, route, schema, test, action
+      name TEXT NOT NULL UNIQUE,     -- ex: "page-component", "data-hook", "api-route"
+
+      -- Contexto
+      scope TEXT NOT NULL,           -- frontend, backend, database, testing
+      applies_to TEXT NOT NULL,      -- glob pattern: "app/**/page.tsx", "src/hooks/*.ts"
+
+      -- O Padrao Extraido
+      structure TEXT NOT NULL,       -- JSON com estrutura comum (imports, exports, patterns, conventions)
+      template TEXT NOT NULL,        -- Template de codigo com placeholders
+      examples TEXT NOT NULL,        -- JSON array de arquivos que seguem este padrao
+
+      -- Anti-patterns identificados
+      anti_patterns TEXT,            -- JSON array de anti-patterns encontrados
+
+      -- Metadados
+      confidence REAL DEFAULT 0.8,   -- 0-1, baseado em quantos arquivos seguem
+      extracted_from INTEGER,        -- Quantos arquivos foram analisados
+
+      -- Auditoria
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      updated_at TEXT
+    );
+
+    -- 18. Knowledge Graph (v8.0 - Relacoes entre entidades)
+    CREATE TABLE IF NOT EXISTS knowledge_graph (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      spec_id TEXT REFERENCES specs(id),
+
+      -- No de origem
+      source_type TEXT NOT NULL,  -- file, decision, pattern, task, artifact
+      source_id TEXT NOT NULL,
+
+      -- No de destino
+      target_type TEXT NOT NULL,
+      target_id TEXT NOT NULL,
+
+      -- Relacao
+      relation TEXT NOT NULL,     -- uses, implements, depends_on, modifies, contradicts, extracted_from
+
+      -- Metadados
+      strength REAL DEFAULT 1.0,  -- 0-1, peso da relacao
+      metadata TEXT,              -- JSON com informacoes adicionais
+
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- 19. Reasoning Log (v8.0 - Historico de raciocinio)
+    CREATE TABLE IF NOT EXISTS reasoning_log (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      spec_id TEXT REFERENCES specs(id),
+      task_id INTEGER REFERENCES tasks(id),
+
+      -- O raciocinio
+      category TEXT NOT NULL,     -- decision, discovery, error, success, challenge, recommendation
+      thought TEXT NOT NULL,      -- "Escolhi X porque Y"
+
+      -- Contexto
+      related_files TEXT,         -- JSON array de arquivos
+      related_decisions TEXT,     -- JSON array de decision IDs
+      related_patterns TEXT,      -- JSON array de pattern names
+
+      -- Importancia
+      importance TEXT DEFAULT 'normal',  -- critical, high, normal, low
+
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- 20. Session Summaries (v8.0 - Resumos de sessao para continuidade)
+    CREATE TABLE IF NOT EXISTS session_summaries (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      spec_id TEXT NOT NULL REFERENCES specs(id),
+
+      -- Periodo
+      start_time TEXT NOT NULL,
+      end_time TEXT NOT NULL,
+
+      -- Conteudo
+      summary TEXT NOT NULL,      -- O que foi feito
+      decisions TEXT,             -- JSON array de decisoes tomadas
+      blockers TEXT,              -- JSON array de problemas encontrados
+      next_steps TEXT,            -- JSON array de recomendacoes
+
+      -- Estatisticas
+      tasks_completed INTEGER DEFAULT 0,
+      files_created INTEGER DEFAULT 0,
+      files_modified INTEGER DEFAULT 0,
+
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- 21. Architectural Analyses (v8.1 - migrado de architect.ts para schema central)
+    CREATE TABLE IF NOT EXISTS architectural_analyses (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      description TEXT NOT NULL,
+      status TEXT NOT NULL DEFAULT 'pending',
+
+      -- Conteudo JSON
+      context TEXT,
+      current_architecture TEXT,
+      approach TEXT,
+      chosen_alternative TEXT,
+      diagrams TEXT,           -- JSON array
+      baby_steps TEXT,         -- JSON array
+      risks TEXT,              -- JSON array
+      alternatives TEXT,       -- JSON array
+      decisions TEXT,          -- JSON array
+
+      -- Arquivo gerado
+      file_path TEXT,
+
+      -- Timestamps
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      updated_at TEXT,
+      approved_at TEXT
+    );
+
+    -- 22. Project Utilities (v8.5 - DRY enforcement utility map)
+    CREATE TABLE IF NOT EXISTS project_utilities (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      file_path TEXT NOT NULL,
+      utility_name TEXT NOT NULL,
+      utility_type TEXT NOT NULL,
+      scope TEXT NOT NULL,
+      signature TEXT,
+      description TEXT,
+      spec_id TEXT,
+      task_ref INTEGER,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      updated_at TEXT,
+      UNIQUE(file_path, utility_name)
+    );
+
+    -- Indices para performance
+    CREATE INDEX IF NOT EXISTS idx_tasks_spec ON tasks(spec_id);
+    CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
+    CREATE INDEX IF NOT EXISTS idx_decisions_spec ON decisions(spec_id);
+    CREATE INDEX IF NOT EXISTS idx_artifacts_spec ON artifacts(spec_id);
+    CREATE INDEX IF NOT EXISTS idx_snapshots_spec ON snapshots(spec_id);
+    CREATE INDEX IF NOT EXISTS idx_standards_category ON standards(category);
+    CREATE INDEX IF NOT EXISTS idx_standards_scope ON standards(scope);
+    CREATE INDEX IF NOT EXISTS idx_knowledge_spec ON knowledge(spec_id);
+    CREATE INDEX IF NOT EXISTS idx_knowledge_category ON knowledge(category);
+    CREATE INDEX IF NOT EXISTS idx_knowledge_severity ON knowledge(severity);
+    CREATE INDEX IF NOT EXISTS idx_gate_bypasses_spec ON gate_bypasses(spec_id);
+    CREATE INDEX IF NOT EXISTS idx_product_goals_product ON product_goals(product_id);
+    CREATE INDEX IF NOT EXISTS idx_product_goals_category ON product_goals(category);
+    CREATE INDEX IF NOT EXISTS idx_product_features_product ON product_features(product_id);
+    CREATE INDEX IF NOT EXISTS idx_product_features_priority ON product_features(priority);
+    CREATE INDEX IF NOT EXISTS idx_lib_contexts_lib ON lib_contexts(lib_name);
+    CREATE INDEX IF NOT EXISTS idx_agent_lib_mappings_agent ON agent_lib_mappings(agent_type);
+    CREATE INDEX IF NOT EXISTS idx_impl_patterns_category ON implementation_patterns(category);
+    CREATE INDEX IF NOT EXISTS idx_impl_patterns_scope ON implementation_patterns(scope);
+    CREATE INDEX IF NOT EXISTS idx_impl_patterns_name ON implementation_patterns(name);
+
+    -- v8.0: Indices para Knowledge Graph
+    CREATE INDEX IF NOT EXISTS idx_kg_source ON knowledge_graph(source_type, source_id);
+    CREATE INDEX IF NOT EXISTS idx_kg_target ON knowledge_graph(target_type, target_id);
+    CREATE INDEX IF NOT EXISTS idx_kg_relation ON knowledge_graph(relation);
+    CREATE INDEX IF NOT EXISTS idx_kg_spec ON knowledge_graph(spec_id);
+
+    -- v8.0: Indices para Reasoning Log
+    CREATE INDEX IF NOT EXISTS idx_reasoning_spec ON reasoning_log(spec_id);
+    CREATE INDEX IF NOT EXISTS idx_reasoning_task ON reasoning_log(task_id);
+    CREATE INDEX IF NOT EXISTS idx_reasoning_category ON reasoning_log(category);
+    CREATE INDEX IF NOT EXISTS idx_reasoning_importance ON reasoning_log(importance);
+
+    -- v8.0: Indices para Session Summaries
+    CREATE INDEX IF NOT EXISTS idx_session_spec ON session_summaries(spec_id);
+    CREATE INDEX IF NOT EXISTS idx_session_time ON session_summaries(end_time);
+
+    -- v8.1: Indices para Architectural Analyses
+    CREATE INDEX IF NOT EXISTS idx_arch_status ON architectural_analyses(status);
+    CREATE INDEX IF NOT EXISTS idx_arch_created ON architectural_analyses(created_at);
+
+    -- v8.5: Indices para Project Utilities
+    CREATE INDEX IF NOT EXISTS idx_utils_scope ON project_utilities(scope);
+    CREATE INDEX IF NOT EXISTS idx_utils_name ON project_utilities(utility_name);
+    CREATE INDEX IF NOT EXISTS idx_utils_file ON project_utilities(file_path);
+  `);
+
+  // v8.4: Migracao - adicionar analysis_id na tabela specs
+  try {
+    db.exec(`ALTER TABLE specs ADD COLUMN analysis_id TEXT`);
+  } catch {
+    // Coluna ja existe - ignorar
+  }
+}
+
+export function getPatternsByScope(scope: string): any[] {
+  const db = getDb();
+  return db.query(
+    "SELECT * FROM implementation_patterns WHERE scope = ? OR scope = 'all' ORDER BY category, name"
+  ).all(scope) as any[];
+}
+
+export function getPatternsForFiles(files: string[]): any[] {
+  const db = getDb();
+  const patterns = db.query("SELECT * FROM implementation_patterns").all() as any[];
+
+  // Filtrar patterns que correspondem aos arquivos da task
+  return patterns.filter(pattern => {
+    const glob = pattern.applies_to;
+    return files.some(file => {
+      // Simplificado: verificar se o arquivo corresponde ao glob pattern
+      // Ex: "app/**/page.tsx" deve corresponder a "app/dashboard/page.tsx"
+      const regexPattern = glob
+        .replace(/\*\*/g, '.*')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\//g, '\\/');
+      const regex = new RegExp(`^${regexPattern}$`);
+      return regex.test(file);
+    });
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════
+// v8.0: Knowledge Graph Helpers
+// ═══════════════════════════════════════════════════════════════
+
+export interface GraphRelation {
+  sourceType: string;
+  sourceId: string;
+  targetType: string;
+  targetId: string;
+  relation: string;
+  strength?: number;
+  metadata?: Record<string, any>;
+}
+
+export function addGraphRelation(specId: string | null, relation: GraphRelation): void {
+  const db = getDb();
+  const now = new Date().toISOString();
+
+  db.run(
+    `INSERT INTO knowledge_graph (spec_id, source_type, source_id, target_type, target_id, relation, strength, metadata, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+    [
+      specId,
+      relation.sourceType,
+      relation.sourceId,
+      relation.targetType,
+      relation.targetId,
+      relation.relation,
+      relation.strength || 1.0,
+      relation.metadata ? JSON.stringify(relation.metadata) : null,
+      now,
+    ]
+  );
+}
+
+export function getRelatedDecisions(fileOrPattern: string, type: "file" | "pattern"): any[] {
+  const db = getDb();
+
+  return db.query(`
+    SELECT d.* FROM decisions d
+    JOIN knowledge_graph kg ON kg.source_id = d.id AND kg.source_type = 'decision'
+    WHERE kg.target_type = ? AND kg.target_id = ?
+    AND kg.relation IN ('implements', 'depends_on', 'uses')
+  `).all(type, fileOrPattern) as any[];
+}
+
+export function getRelatedFiles(decisionOrPattern: string, type: "decision" | "pattern"): string[] {
+  const db = getDb();
+
+  const results = db.query(`
+    SELECT kg.target_id as file FROM knowledge_graph kg
+    WHERE kg.source_type = ? AND kg.source_id = ?
+    AND kg.target_type = 'file'
+    AND kg.relation IN ('implements', 'modifies', 'creates')
+  `).all(type, decisionOrPattern) as any[];
+
+  return results.map(r => r.file);
+}
+
+export function findContradictions(specId: string): Array<{ decision1: string; decision2: string; createdAt: string }> {
+  const db = getDb();
+
+  return db.query(`
+    SELECT
+      d1.title as decision1,
+      d2.title as decision2,
+      kg.created_at as createdAt
+    FROM knowledge_graph kg
+    JOIN decisions d1 ON kg.source_id = d1.id
+    JOIN decisions d2 ON kg.target_id = d2.id
+    WHERE kg.relation = 'contradicts'
+    AND kg.spec_id = ?
+  `).all(specId) as any[];
+}
+
+// ═══════════════════════════════════════════════════════════════
+// v8.0: Reasoning Log Helpers
+// ═══════════════════════════════════════════════════════════════
+
+export interface ReasoningEntry {
+  category: "decision" | "discovery" | "error" | "success" | "challenge" | "recommendation";
+  thought: string;
+  relatedFiles?: string[];
+  relatedDecisions?: string[];
+  relatedPatterns?: string[];
+  importance?: "critical" | "high" | "normal" | "low";
+}
+
+export function addReasoning(specId: string, taskId: number | null, entry: ReasoningEntry): void {
+  const db = getDb();
+  const now = new Date().toISOString();
+
+  db.run(
+    `INSERT INTO reasoning_log (spec_id, task_id, category, thought, related_files, related_decisions, related_patterns, importance, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+    [
+      specId,
+      taskId,
+      entry.category,
+      entry.thought,
+      entry.relatedFiles ? JSON.stringify(entry.relatedFiles) : null,
+      entry.relatedDecisions ? JSON.stringify(entry.relatedDecisions) : null,
+      entry.relatedPatterns ? JSON.stringify(entry.relatedPatterns) : null,
+      entry.importance || "normal",
+      now,
+    ]
+  );
+}
+
+export function getRecentReasoning(specId: string, limit: number = 20): any[] {
+  const db = getDb();
+
+  return db.query(`
+    SELECT * FROM reasoning_log
+    WHERE spec_id = ?
+    ORDER BY created_at DESC
+    LIMIT ?
+  `).all(specId, limit) as any[];
+}
+
+// ═══════════════════════════════════════════════════════════════
+// v8.0: Session Summary Helpers
+// ═══════════════════════════════════════════════════════════════
+
+export interface SessionSummaryData {
+  startTime: string;
+  endTime: string;
+  summary: string;
+  decisions?: string[];
+  blockers?: string[];
+  nextSteps?: string[];
+  tasksCompleted?: number;
+  filesCreated?: number;
+  filesModified?: number;
+}
+
+export function addSessionSummary(specId: string, data: SessionSummaryData): void {
+  const db = getDb();
+  const now = new Date().toISOString();
+
+  db.run(
+    `INSERT INTO session_summaries (spec_id, start_time, end_time, summary, decisions, blockers, next_steps, tasks_completed, files_created, files_modified, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+    [
+      specId,
+      data.startTime,
+      data.endTime,
+      data.summary,
+      data.decisions ? JSON.stringify(data.decisions) : null,
+      data.blockers ? JSON.stringify(data.blockers) : null,
+      data.nextSteps ? JSON.stringify(data.nextSteps) : null,
+      data.tasksCompleted || 0,
+      data.filesCreated || 0,
+      data.filesModified || 0,
+      now,
+    ]
+  );
+}
+
+export function getLastSessionSummary(specId: string): any {
+  const db = getDb();
+
+  return db.query(`
+    SELECT * FROM session_summaries
+    WHERE spec_id = ?
+    ORDER BY created_at DESC
+    LIMIT 1
+  `).get(specId);
+}
+
+// v8.3: Retorna ultimas N sessoes para contexto composto
+export function getSessionSummaries(specId: string, limit: number = 5): any[] {
+  const db = getDb();
+
+  return db.query(`
+    SELECT * FROM session_summaries
+    WHERE spec_id = ?
+    ORDER BY created_at DESC
+    LIMIT ?
+  `).all(specId, limit) as any[];
+}
+
+// v8.4: Busca analise arquitetural associada a um spec
+// Prioridade: analysis_id (link explicito) > nome exato > LIKE parcial
+export function getArchitecturalAnalysisForSpec(specName: string, specId?: string): any {
+  const db = getDb();
+
+  try {
+    // 0. Link explicito via analysis_id na tabela specs
+    if (specId) {
+      const spec = db.query("SELECT analysis_id FROM specs WHERE id = ?").get(specId) as any;
+      if (spec?.analysis_id) {
+        const analysis = db.query(
+          "SELECT * FROM architectural_analyses WHERE id = ? AND status IN ('approved', 'implemented')"
+        ).get(spec.analysis_id) as any;
+        if (analysis) return analysis;
+      }
+    }
+
+    // 1. Match exato por nome
+    let analysis = db.query(
+      "SELECT * FROM architectural_analyses WHERE name = ? AND status IN ('approved', 'implemented') ORDER BY approved_at DESC LIMIT 1"
+    ).get(specName) as any;
+
+    if (analysis) return analysis;
+
+    // 2. Match parcial (nome da spec contido no nome da analise ou vice-versa)
+    analysis = db.query(
+      "SELECT * FROM architectural_analyses WHERE (name LIKE ? OR ? LIKE '%' || name || '%') AND status IN ('approved', 'implemented') ORDER BY approved_at DESC LIMIT 1"
+    ).get(`%${specName}%`, specName) as any;
+
+    return analysis || null;
+  } catch {
+    // Tabela pode nao existir se architect nunca foi usado
+    return null;
+  }
+}
+
+// ═══════════════════════════════════════════════════════════════
+// v8.5: Project Utilities Helpers (DRY enforcement)
+// ═══════════════════════════════════════════════════════════════
+
+export interface ProjectUtility {
+  filePath: string;
+  utilityName: string;
+  utilityType: string;
+  scope: string;
+  signature?: string;
+  description?: string;
+}
+
+export function upsertUtility(
+  utility: ProjectUtility,
+  specId?: string,
+  taskRef?: number
+): void {
+  const db = getDb();
+  const now = new Date().toISOString();
+  db.run(
+    `INSERT INTO project_utilities (file_path, utility_name, utility_type, scope, signature, description, spec_id, task_ref, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+     ON CONFLICT(file_path, utility_name) DO UPDATE SET
+       utility_type = excluded.utility_type,
+       scope = excluded.scope,
+       signature = COALESCE(excluded.signature, project_utilities.signature),
+       description = COALESCE(excluded.description, project_utilities.description),
+       updated_at = excluded.updated_at`,
+    [
+      utility.filePath, utility.utilityName, utility.utilityType, utility.scope,
+      utility.signature || null, utility.description || null,
+      specId || null, taskRef || null, now, now,
+    ]
+  );
+}
+
+export function getUtilitiesForContext(
+  dirs: string[],
+  scope?: string,
+  limit: number = 15
+): any[] {
+  const db = getDb();
+
+  // Se nenhum filtro, retornar mais recentes
+  if (dirs.length === 0 && !scope) {
+    return db.query(
+      "SELECT * FROM project_utilities ORDER BY updated_at DESC LIMIT ?"
+    ).all(limit) as any[];
+  }
+
+  // Buscar por diretorio (prioridade) e scope (fallback)
+  const conditions: string[] = [];
+  const params: any[] = [];
+
+  for (const dir of dirs) {
+    const normalized = dir.replace(/\\/g, "/");
+    conditions.push("REPLACE(file_path, '\\', '/') LIKE ?");
+    params.push(`${normalized}%`);
+  }
+
+  if (scope) {
+    conditions.push("scope = ?");
+    params.push(scope);
+  }
+
+  params.push(limit);
+  const where = conditions.length > 0 ? `WHERE (${conditions.join(" OR ")})` : "";
+  return db.query(
+    `SELECT * FROM project_utilities ${where} ORDER BY updated_at DESC LIMIT ?`
+  ).all(...params) as any[];
+}
+
+export function findDuplicateUtilities(
+  utilityName: string,
+  excludeFile?: string
+): any[] {
+  const db = getDb();
+  if (excludeFile) {
+    return db.query(
+      "SELECT * FROM project_utilities WHERE utility_name = ? AND file_path != ?"
+    ).all(utilityName, excludeFile) as any[];
+  }
+  return db.query(
+    "SELECT * FROM project_utilities WHERE utility_name = ?"
+  ).all(utilityName) as any[];
+}