ac-framework 1.7.0 → 1.8.0

package/src/index.js

@@ -18,3 +18,49 @@ export {
   readProjectConfig,
   isInitialized,
 } from './services/spec-engine.js';
+
+// Memory System Exports
+export {
+  // Database
+  initDatabase,
+  getDatabase,
+  closeDatabase,
+  isDatabaseInitialized,
+  
+  // Core Engine
+  saveMemory,
+  searchMemories,
+  getContext,
+  getTimeline,
+  getMemory,
+  updateMemory,
+  deleteMemory,
+  startSession,
+  endSession,
+  getStats,
+  findPatterns,
+  getConnections,
+  anticipateNeeds,
+  exportMemories,
+  importMemories,
+  pruneMemories,
+  
+  // Auto-save
+  AutoSaveManager,
+  createAutoSaveHook,
+  WorkflowHooks,
+  
+  // Utils
+  redactPrivateContent,
+  extractKeywords,
+  textSimilarity,
+  truncate,
+  isCodeContent,
+  detectLanguage,
+  generateSummary,
+  sanitizeFTSQuery,
+  
+  // Constants
+  MEMORY_TYPES,
+  IMPORTANCE_LEVELS
+} from './memory/index.js';

package/src/memory/autosave.js

@@ -0,0 +1,382 @@
+/**
+ * autosave.js — Sistema de auto-guardado autónomo
+ * 
+ * Detecta automáticamente qué información es valiosa
+ * y la guarda sin intervención humana.
+ */
+
+import { saveMemory, searchMemories } from './engine.js';
+import { extractKeywords, isCodeContent, textSimilarity } from './utils.js';
+
+/**
+ * Manager de auto-save que se integra con el workflow
+ */
+export class AutoSaveManager {
+  constructor(options = {}) {
+    this.sessionId = options.sessionId;
+    this.projectPath = options.projectPath;
+    this.changeName = options.changeName;
+    this.author = options.author || 'ac-agent';
+    this.minConfidence = options.minConfidence || 0.5;
+    this.enabled = options.enabled !== false;
+    
+    // Buffer de contexto para análisis
+    this.contextBuffer = [];
+    this.maxBufferSize = 10;
+  }
+
+  /**
+   * Evalúa si un contenido debe ser guardado
+   */
+  shouldSave(content, context = {}) {
+    if (!this.enabled) return { shouldSave: false, reason: 'disabled' };
+    if (!content || content.length < 20) return { shouldSave: false, reason: 'too_short' };
+    
+    const score = this.calculateSaveScore(content, context);
+    
+    return {
+      shouldSave: score >= this.minConfidence,
+      confidence: score,
+      reason: score >= this.minConfidence ? 'valuable_content' : 'low_score'
+    };
+  }
+
+  /**
+   * Calcula qué tan valioso es guardar este contenido
+   */
+  calculateSaveScore(content, context = {}) {
+    let score = 0.5;
+    const lowerContent = content.toLowerCase();
+    
+    // Decisiones explícitas
+    if (/decidimos|elegimos|optamos|vamos a usar|mejor usar|recomendamos/i.test(lowerContent)) {
+      score += 0.25;
+    }
+    
+    // Soluciones a problemas
+    if (/solución|fix|resuelve|solucionado|corregido|arreglado/i.test(lowerContent)) {
+      score += 0.2;
+    }
+    
+    // Problemas/evitación
+    if (/error|bug|issue|problema|cuidado con|evitar|no usar/i.test(lowerContent)) {
+      score += 0.15;
+    }
+    
+    // Optimizaciones
+    if (/optimización|mejora|más rápido|performance|lento/i.test(lowerContent)) {
+      score += 0.15;
+    }
+    
+    // Arquitectura
+    if (/arquitectura|diseño|estructura|pattern|patrón/i.test(lowerContent)) {
+      score += 0.2;
+    }
+    
+    // Seguridad
+    if (/seguridad|security|vulnerabilidad|auth|autenticación/i.test(lowerContent)) {
+      score += 0.25;
+    }
+    
+    // Contiene código valioso
+    if (isCodeContent(content) && /ejemplo|example|snippet/i.test(lowerContent)) {
+      score += 0.1;
+    }
+    
+    // Contiene workaround
+    if (/workaround|temporal|mientras tanto|hack/i.test(lowerContent)) {
+      score += 0.15;
+    }
+    
+    // Contexto temporal (más tiempo = más valioso)
+    if (context.timeSpent) {
+      if (context.timeSpent > 30) score += 0.15;
+      else if (context.timeSpent > 10) score += 0.1;
+    }
+    
+    // Viene después de error
+    if (context.afterError) score += 0.1;
+    
+    // Es repetición de intentos
+    if (context.attemptCount && context.attemptCount > 2) score += 0.1;
+    
+    // Penalizaciones
+    
+    // Muy corto
+    if (content.length < 50) score -= 0.2;
+    
+    // Muy específico (IDs, nombres únicos)
+    if (/\b[0-9a-f]{8,}\b/i.test(content)) score -= 0.15; // UUIDs, hashes
+    if (/\buser_\d+|id_\d+\b/i.test(content)) score -= 0.1; // IDs específicos
+    
+    // Solo código sin explicación
+    if (isCodeContent(content) && !/[.!?]/.test(content)) score -= 0.1;
+    
+    // Contiene TODO/FIXME (temporal)
+    if (/TODO|FIXME|HACK|XXX/i.test(content)) score -= 0.2;
+    
+    return Math.max(0, Math.min(0.95, score));
+  }
+
+  /**
+   * Determina el tipo de memoria basado en contenido
+   */
+  detectType(content, context = {}) {
+    const lower = content.toLowerCase();
+    
+    if (context.typeHint) return context.typeHint;
+    
+    if (/bug|error|fix|corregido|arreglado|solucionado/i.test(lower)) {
+      if (/seguridad|security|vulnerabilidad/i.test(lower)) return 'security_fix';
+      return 'bugfix_pattern';
+    }
+    
+    if (/decidimos|elegimos|optamos|arquitectura|diseño/i.test(lower)) {
+      return 'architectural_decision';
+    }
+    
+    if (/refactor|reestructurar|limpiar|simplificar/i.test(lower)) {
+      return 'refactor_technique';
+    }
+    
+    if (/performance|lento|rápido|optimización|mejora/i.test(lower)) {
+      return 'performance_insight';
+    }
+    
+    if (/api|endpoint|route|controller/i.test(lower)) {
+      return 'api_pattern';
+    }
+    
+    if (/dependencia|package|librería|npm|install/i.test(lower)) {
+      return 'dependency_note';
+    }
+    
+    if (/workaround|temporal|mientras tanto/i.test(lower)) {
+      return 'workaround';
+    }
+    
+    if (/convención|estilo|nomenclatura|naming/i.test(lower)) {
+      return 'convention';
+    }
+    
+    if (/no debe|nunca|siempre|evitar|cuidado/i.test(lower)) {
+      return 'context_boundary';
+    }
+    
+    return 'general_insight';
+  }
+
+  /**
+   * Guarda una memoria si pasa el filtro de confianza
+   */
+  async autoSave(content, context = {}) {
+    const decision = this.shouldSave(content, context);
+    
+    if (!decision.shouldSave) {
+      return { saved: false, reason: decision.reason, confidence: decision.confidence };
+    }
+    
+    const type = this.detectType(content, context);
+    const tags = context.tags || extractKeywords(content);
+    
+    const result = saveMemory({
+      content,
+      type,
+      projectPath: this.projectPath,
+      changeName: this.changeName,
+      sessionId: this.sessionId,
+      author: this.author,
+      confidence: decision.confidence,
+      tags,
+      codeSnippet: context.codeSnippet,
+      errorMessage: context.errorMessage,
+      solution: context.solution,
+      shareable: context.shareable !== false
+    });
+    
+    return {
+      saved: true,
+      id: result.id,
+      operation: result.operation,
+      type,
+      confidence: decision.confidence
+    };
+  }
+
+  /**
+   * Guarda en buffer para análisis posterior
+   */
+  bufferContext(context) {
+    this.contextBuffer.push({
+      ...context,
+      timestamp: Date.now()
+    });
+    
+    if (this.contextBuffer.length > this.maxBufferSize) {
+      this.contextBuffer.shift();
+    }
+  }
+
+  /**
+   * Analiza buffer para detectar patrones
+   */
+  analyzeBuffer() {
+    if (this.contextBuffer.length < 3) return null;
+    
+    const recent = this.contextBuffer.slice(-3);
+    
+    // Detectar patrón de error -> fix
+    const hasError = recent.some(c => c.type === 'error' || c.hasError);
+    const hasFix = recent.some(c => c.type === 'fix' || c.isFix);
+    
+    if (hasError && hasFix) {
+      return {
+        pattern: 'error_to_fix',
+        confidence: 0.8,
+        context: recent
+      };
+    }
+    
+    return null;
+  }
+
+  /**
+   * Recupera contexto relevante antes de empezar tarea
+   */
+  async recallForTask(task, options = {}) {
+    const keywords = extractKeywords(task, 8);
+    const query = keywords.join(' OR ');
+    
+    const results = searchMemories(query, {
+      projectPath: this.projectPath,
+      limit: options.limit || 5,
+      minConfidence: 0.6,
+      sessionId: this.sessionId
+    });
+    
+    return results;
+  }
+
+  /**
+   * Sugiere memorias relacionadas a una existente
+   */
+  suggestRelated(memoryId, content) {
+    const keywords = extractKeywords(content, 5);
+    return searchMemories(keywords.join(' OR '), {
+      limit: 3,
+      sessionId: this.sessionId
+    }).filter(m => m.id !== memoryId);
+  }
+}
+
+/**
+ * Crea un hook de auto-save para un evento específico
+ */
+export function createAutoSaveHook(event, handler) {
+  return {
+    event,
+    handler: async (data, context) => {
+      const manager = context.autoSaveManager;
+      if (!manager) return handler(data, context);
+      
+      const result = await handler(data, context);
+      
+      // Si el handler retorna contenido para guardar
+      if (result && result.memoryContent) {
+        const saveResult = await manager.autoSave(result.memoryContent, {
+          typeHint: result.memoryType,
+          ...result.memoryContext
+        });
+        
+        return { ...result, autoSave: saveResult };
+      }
+      
+      return result;
+    }
+  };
+}
+
+// Hooks predefinidos para workflow spec-driven
+export const WorkflowHooks = {
+  /**
+   * Hook post-proposal: guarda decisiones arquitectónicas
+   */
+  afterProposal: (manager) => async (proposalData) => {
+    const content = `Arquitectura decidida: ${proposalData.title || 'N/A'}. ${proposalData.description || ''}`;
+    
+    return {
+      memoryContent: content,
+      memoryType: 'architectural_decision',
+      memoryContext: {
+        importance: 'high',
+        tags: ['proposal', 'architecture']
+      }
+    };
+  },
+
+  /**
+   * Hook post-design: guarda patrones técnicos
+   */
+  afterDesign: (manager) => async (designData) => {
+    const content = `Patrón de diseño: ${designData.approach || 'N/A'}. ${designData.rationale || ''}`;
+    
+    return {
+      memoryContent: content,
+      memoryType: 'architectural_decision',
+      memoryContext: {
+        importance: 'high',
+        tags: ['design', 'pattern']
+      }
+    };
+  },
+
+  /**
+   * Hook post-bugfix: guarda solución
+   */
+  afterBugfix: (manager) => async (bugfixData) => {
+    const content = `Bug resuelto: ${bugfixData.description}. Solución: ${bugfixData.solution}`;
+    
+    return {
+      memoryContent: content,
+      memoryType: bugfixData.security ? 'security_fix' : 'bugfix_pattern',
+      memoryContext: {
+        errorMessage: bugfixData.error,
+        solution: bugfixData.solution,
+        codeSnippet: bugfixData.codeSnippet,
+        importance: 'high'
+      }
+    };
+  },
+
+  /**
+   * Hook post-refactor: guarda técnica
+   */
+  afterRefactor: (manager) => async (refactorData) => {
+    const content = `Refactor: ${refactorData.description}. Beneficio: ${refactorData.benefit}`;
+    
+    return {
+      memoryContent: content,
+      memoryType: 'refactor_technique',
+      memoryContext: {
+        codeSnippet: refactorData.beforeAfter,
+        importance: 'medium'
+      }
+    };
+  },
+
+  /**
+   * Hook post-optimization: guarda insight de performance
+   */
+  afterOptimization: (manager) => async (optData) => {
+    const content = `Optimización: ${optData.description}. Mejora: ${optData.improvement}`;
+    
+    return {
+      memoryContent: content,
+      memoryType: 'performance_insight',
+      memoryContext: {
+        importance: 'medium',
+        tags: ['performance', 'optimization']
+      }
+    };
+  }
+};

package/src/memory/database.js

@@ -0,0 +1,178 @@
+/**
+ * database.js — SQLite + FTS5 para sistema de memoria autónoma
+ * 
+ * Base de datos embebida sin dependencias externas de runtime.
+ * Usa better-sqlite3 para sincronía y mejor performance.
+ */
+
+import Database from 'better-sqlite3';
+import { mkdirSync, existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+
+// Configuración
+const ACFM_DIR = join(homedir(), '.acfm');
+const DB_PATH = process.env.ACFM_MEMORY_DB || join(ACFM_DIR, 'memory.db');
+
+// Singleton de conexión
+let dbInstance = null;
+
+/**
+ * Schema SQL completo
+ */
+const SCHEMA_SQL = `
+-- Tabla principal de memorias
+CREATE TABLE IF NOT EXISTS memories (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    topic_key TEXT UNIQUE,
+    type TEXT NOT NULL,
+    content TEXT NOT NULL,
+    project_path TEXT,
+    change_name TEXT,
+    session_id TEXT,
+    confidence REAL DEFAULT 0.5,
+    importance TEXT DEFAULT 'medium',
+    tags TEXT,
+    related_to TEXT,
+    replaces INTEGER,
+    shareable INTEGER DEFAULT 1,
+    author TEXT,
+    code_snippet TEXT,
+    error_message TEXT,
+    solution TEXT,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    last_accessed DATETIME,
+    access_count INTEGER DEFAULT 0,
+    revision_count INTEGER DEFAULT 0,
+    is_deleted INTEGER DEFAULT 0
+);
+
+-- Full-Text Search virtual table
+CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
+    content,
+    content='memories',
+    content_rowid='id'
+);
+
+-- Tabla de sesiones
+CREATE TABLE IF NOT EXISTS sessions (
+    id TEXT PRIMARY KEY,
+    project_path TEXT,
+    change_name TEXT,
+    started_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    ended_at DATETIME,
+    summary TEXT
+);
+
+-- Log de accesos para analytics
+CREATE TABLE IF NOT EXISTS memory_access_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    memory_id INTEGER,
+    session_id TEXT,
+    access_type TEXT,
+    accessed_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Índices para performance
+CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
+CREATE INDEX IF NOT EXISTS idx_memories_project ON memories(project_path);
+CREATE INDEX IF NOT EXISTS idx_memories_change ON memories(change_name);
+CREATE INDEX IF NOT EXISTS idx_memories_session ON memories(session_id);
+CREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at);
+CREATE INDEX IF NOT EXISTS idx_memories_topic ON memories(topic_key);
+CREATE INDEX IF NOT EXISTS idx_memories_deleted ON memories(is_deleted);
+
+-- Triggers para mantener FTS sincronizado
+CREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN
+    INSERT INTO memories_fts(rowid, content) VALUES (new.id, new.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN
+    INSERT INTO memories_fts(memories_fts, rowid, content) VALUES ('delete', old.id, old.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN
+    INSERT INTO memories_fts(memories_fts, rowid, content) VALUES ('delete', old.id, old.content);
+    INSERT INTO memories_fts(rowid, content) VALUES (new.id, new.content);
+END;
+
+-- Trigger para actualizar updated_at
+CREATE TRIGGER IF NOT EXISTS memories_update_trigger 
+AFTER UPDATE ON memories BEGIN
+    UPDATE memories SET updated_at = CURRENT_TIMESTAMP WHERE id = new.id;
+END;
+`;
+
+/**
+ * Inicializa la base de datos
+ */
+export function initDatabase() {
+  if (dbInstance) return dbInstance;
+
+  // Asegurar que el directorio existe
+  if (!existsSync(ACFM_DIR)) {
+    mkdirSync(ACFM_DIR, { recursive: true });
+  }
+
+  // Crear conexión
+  dbInstance = new Database(DB_PATH);
+  
+  // Optimizaciones de performance
+  dbInstance.pragma('journal_mode = WAL');
+  dbInstance.pragma('synchronous = NORMAL');
+  dbInstance.pragma('cache_size = -64000'); // 64MB cache
+  dbInstance.pragma('temp_store = memory');
+  
+  // Crear schema
+  dbInstance.exec(SCHEMA_SQL);
+  
+  return dbInstance;
+}
+
+/**
+ * Obtiene instancia de la base de datos (inicializada)
+ */
+export function getDatabase() {
+  if (!dbInstance) {
+    return initDatabase();
+  }
+  return dbInstance;
+}
+
+/**
+ * Cierra la conexión a la base de datos
+ */
+export function closeDatabase() {
+  if (dbInstance) {
+    dbInstance.close();
+    dbInstance = null;
+  }
+}
+
+/**
+ * Verifica si la base de datos está inicializada
+ */
+export function isDatabaseInitialized() {
+  try {
+    const db = getDatabase();
+    const result = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='memories'").get();
+    return !!result;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Reset completo (para testing)
+ */
+export function resetDatabase() {
+  closeDatabase();
+  try {
+    const { unlinkSync } = require('node:fs');
+    unlinkSync(DB_PATH);
+  } catch {
+    // No existe, ignorar
+  }
+  return initDatabase();
+}