openprompt-lang 1.2.7 → 1.4.0

package/src/boost/cache.js

@@ -0,0 +1,241 @@
+// @use(kind, contract, limit, error)
+// @kind(util)
+// @contract(in: key, value, ttl -> out: get, set, has, delete, clear @error: CacheError)
+// @limit(lines: 180)
+
+/**
+ * Cache System — Módulo OPL Boost
+ *
+ * Caché simple basada en archivos JSON para resultados parciales
+ * de agentes Boost. Evita re-ejecutar agentes cuando el mismo input
+ * ya fue procesado.
+ *
+ * Claves de caché predefinidas:
+ *   compress:{kind}         → 1 hora  (contexto comprimido)
+ *   fewshot:{kind}:{domain} → 1 día   (ejemplos encontrados)
+ *   agent:{role}:{hash}     → 5 min   (output de agente)
+ *   dag:{hash}              → 5 min   (plan de tareas)
+ *
+ * Uso:
+ *   import { cache } from './boost/cache.js'
+ *   await cache.set('agent:types:abc123', result, 300_000)
+ *   const cached = await cache.get('agent:types:abc123')
+ */
+
+import { readFileSync, writeFileSync, existsSync, unlinkSync, mkdirSync, readdirSync, statSync } from "fs"
+import { join } from "path"
+import crypto from "crypto"
+
+// ──────────────────────────────────────────────
+// Configuración
+// ──────────────────────────────────────────────
+
+const CACHE_DIR = join(process.cwd(), ".opencode", "boost", "cache")
+
+// ──────────────────────────────────────────────
+// Utilidades
+// ──────────────────────────────────────────────
+
+function ensureCacheDir() {
+  if (!existsSync(CACHE_DIR)) {
+    mkdirSync(CACHE_DIR, { recursive: true })
+  }
+}
+
+function sanitizeKey(key) {
+  // Reemplazar caracteres no seguros para nombre de archivo
+  return key.replace(/[^a-zA-Z0-9_:-]/g, "_").substring(0, 200)
+}
+
+function getCachePath(key) {
+  return join(CACHE_DIR, `${sanitizeKey(key)}.json`)
+}
+
+function isExpired(entry) {
+  return Date.now() > entry.expiresAt
+}
+
+// ──────────────────────────────────────────────
+// API pública
+// ──────────────────────────────────────────────
+
+export const cache = {
+  /**
+   * Obtiene un valor de la caché.
+   * @param {string} key - Clave de caché
+   * @returns {*|null} Valor cacheado o null si no existe/ha expirado
+   */
+  get(key) {
+    try {
+      const path = getCachePath(key)
+      if (!existsSync(path)) return null
+
+      const content = readFileSync(path, "utf-8")
+      const entry = JSON.parse(content)
+
+      if (isExpired(entry)) {
+        // Limpiar entrada expirada
+        try { unlinkSync(path) } catch { /* ignore */ }
+        return null
+      }
+
+      return entry.value
+    } catch {
+      return null
+    }
+  },
+
+  /**
+   * Guarda un valor en la caché.
+   * @param {string} key - Clave de caché
+   * @param {*} value - Valor a cachear
+   * @param {number} ttl - Tiempo de vida en milisegundos (default: 5 min)
+   */
+  set(key, value, ttl = 300_000) {
+    try {
+      ensureCacheDir()
+      const path = getCachePath(key)
+
+      const entry = {
+        key,
+        value,
+        createdAt: new Date().toISOString(),
+        expiresAt: Date.now() + ttl,
+        ttl,
+      }
+
+      writeFileSync(path, JSON.stringify(entry), "utf-8")
+      return true
+    } catch {
+      return false
+    }
+  },
+
+  /**
+   * Verifica si una clave existe y no ha expirado.
+   * @param {string} key
+   * @returns {boolean}
+   */
+  has(key) {
+    return this.get(key) !== null
+  },
+
+  /**
+   * Elimina una entrada de la caché.
+   * @param {string} key
+   */
+  delete(key) {
+    try {
+      const path = getCachePath(key)
+      if (existsSync(path)) {
+        unlinkSync(path)
+        return true
+      }
+    } catch { /* ignore */ }
+    return false
+  },
+
+  /**
+   * Limpia TODA la caché de Boost.
+   */
+  clear() {
+    try {
+      if (!existsSync(CACHE_DIR)) return 0
+      const files = readdirSync(CACHE_DIR)
+      let count = 0
+      for (const file of files) {
+        if (file.endsWith(".json")) {
+          try {
+            unlinkSync(join(CACHE_DIR, file))
+            count++
+          } catch { /* ignore */ }
+        }
+      }
+      return count
+    } catch {
+      return 0
+    }
+  },
+
+  /**
+   * Limpia solo entradas expiradas.
+   * @returns {number} Cantidad de entradas limpiadas
+   */
+  cleanExpired() {
+    try {
+      if (!existsSync(CACHE_DIR)) return 0
+      const files = readdirSync(CACHE_DIR)
+      let count = 0
+      for (const file of files) {
+        if (!file.endsWith(".json")) continue
+        try {
+          const content = readFileSync(join(CACHE_DIR, file), "utf-8")
+          const entry = JSON.parse(content)
+          if (isExpired(entry)) {
+            unlinkSync(join(CACHE_DIR, file))
+            count++
+          }
+        } catch { /* ignore */ }
+      }
+      return count
+    } catch {
+      return 0
+    }
+  },
+
+  /**
+   * Estadísticas de la caché.
+   * @returns {{ totalEntries: number, totalSize: number, keys: string[] }}
+   */
+  stats() {
+    try {
+      if (!existsSync(CACHE_DIR)) return { totalEntries: 0, totalSize: 0, keys: [] }
+
+      const files = readdirSync(CACHE_DIR).filter((f) => f.endsWith(".json"))
+      let totalSize = 0
+      const keys = []
+
+      for (const file of files) {
+        try {
+          const stat = statSync(join(CACHE_DIR, file))
+          totalSize += stat.size
+          // Extraer key del nombre de archivo
+          keys.push(file.replace(/\.json$/, "").replace(/_/g, ":"))
+        } catch { /* ignore */ }
+      }
+
+      return {
+        totalEntries: files.length,
+        totalSize,
+        keys,
+        cacheDir: CACHE_DIR,
+      }
+    } catch {
+      return { totalEntries: 0, totalSize: 0, keys: [] }
+    }
+  },
+}
+
+// ──────────────────────────────────────────────
+// Utilidad: hashear input para usar como clave
+// ──────────────────────────────────────────────
+
+/**
+ * Genera un hash MD5 de un string para usar como clave de caché.
+ *
+ * @param {string} input
+ * @returns {string} Hash MD5 hexadecimal
+ */
+export function hashInput(input) {
+  return crypto.createHash("md5").update(input).digest("hex").substring(0, 12)
+}
+
+/**
+ * Genera claves de caché predefinidas.
+ */
+export const cacheKeys = {
+  compress: (kind) => `compress:${kind}`,
+  fewshot: (kind, domain) => `fewshot:${kind}:${domain || "default"}`,
+  agent: (role, input) => `agent:${role}:${hashInput(input)}`,
+  dag: (task) => `dag:${hashInput(task)}`,
+}

package/src/boost/context-compressor.js

@@ -0,0 +1,354 @@
+// @use(kind, contract, limit, error)
+// @kind(util)
+// @contract(in: task, fullContext, profile -> out: compressedContext + metrics @error: InvalidProfileError)
+// @limit(lines: 360)
+
+import { readFileSync, existsSync } from "fs"
+import { join } from "path"
+
+/**
+ * Context Compression Engine — Módulo OPL Boost
+ *
+ * Capa 1 (determinística): comprime contexto eliminando secciones irrelevantes
+ * para la tarea actual, preservando reglas de enforcement y límites críticos.
+ *
+ * Capa 2 (AI Cleaner): usa el agente cleaner (agents/index.js) para compresión
+ * más precisa pero más costosa. Solo se activa con perfil small.
+ *
+ * Modos:
+ *   safe (default) → preserva enforcement, elimina secciones irrelevantes
+ *   aggressive → solo incluye lo estrictamente relevante
+ *   disabled → pasa el contexto completo sin modificar
+ *
+ * Uso:
+ *   import { compressContext, compressTaskContext } from './boost/context-compressor.js'
+ *   const result = compressContext('hook useAuth', fullContext, profileConfig)
+ *   // → { context, metrics: { originalChars, compressedChars, reductionPercent, ... } }
+ */
+
+// ──────────────────────────────────────────────
+// Secciones protegidas (siempre preservadas en modo safe)
+// ──────────────────────────────────────────────
+
+const PROTECTED_SECTIONS = [
+  /^##.*enforcement.*$/im,
+  /^##.*nunca.*$/im,
+  /^##.*prohibicion.*$/im,
+  /^##.*regla.*absoluta.*$/im,
+  /^##.*regla.*fundamental.*$/im,
+  /^##.*obligacion.*$/im,
+  /^##.*enforce.*$/im,
+  /^##.*gate.*$/im,
+  /^##.*workflow.*obligatorio.*$/im,
+  /^##.*pre.?commit.*$/im,
+  /^##.*hook pre.?commit.*$/im,
+  /^##.*lint.*$/im,
+  /^##.*@limit.*$/im,
+  /^###.*@limit.*$/im,
+  /^###.*prohibicion.*$/im,
+  /^###.*nunca.*$/im,
+  /^---*\s*$/m,    // separadores de sección
+]
+
+// ──────────────────────────────────────────────
+// Palabras clave para matching de relevancia
+// ──────────────────────────────────────────────
+
+const SECTION_KEYWORD_MAP = {
+  'hook': ['hook', 'useEffect', 'useState', 'useCallback', 'useMemo', 'custom hook', 'hook pattern'],
+  'component': ['component', 'jsx', 'tsx', 'props', 'render', 'shadcn', 'cva', 'cn('],
+  'page': ['page', 'layout', 'route', 'navigation', 'react-router', 'next.js', 'pages'],
+  'service': ['service', 'api', 'fetch', 'axios', 'supabase', 'stripe', 'prisma', 'repository'],
+  'store': ['store', 'state', 'zustand', 'redux', 'context', 'provider', 'reducer'],
+  'types': ['types', 'interfaces', 'dto', 'typescript', 'type definition', 'enum'],
+  'test': ['test', 'vitest', 'jest', 'testing', 'unit test', 'regression'],
+  'validation': ['validate', 'opl', 'annotation', '@kind', '@contract', '@limit', '@use('],
+  'ui': ['ui', 'component', 'shadcn', 'radix', 'tailwind', 'css', 'style', 'theme', 'dark mode'],
+  'backend': ['backend', 'server', 'api', 'route', 'middleware', 'controller', 'express', 'spring'],
+  'auth': ['auth', 'login', 'session', 'token', 'jwt', 'oauth', 'supabase auth'],
+  'database': ['database', 'db', 'sql', 'prisma', 'supabase', 'orm', 'query', 'model', 'entity'],
+  'deploy': ['deploy', 'ci', 'cd', 'docker', 'build', 'production', 'env', 'config'],
+  'workflow': ['workflow', 'opl', 'command', 'cli', 'mcp', 'ticket', 'boost', 'enforcement'],
+}
+
+// ──────────────────────────────────────────────
+// Parseo de secciones de markdown
+// ──────────────────────────────────────────────
+
+function parseSections(markdown) {
+  const lines = markdown.split('\n')
+  const sections = []
+  let currentSection = null
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i]
+    const headerMatch = line.match(/^(#{1,3})\s+(.+)$/)
+
+    if (headerMatch) {
+      if (currentSection) {
+        sections.push(currentSection)
+      }
+      currentSection = {
+        level: headerMatch[1].length,
+        title: headerMatch[2].trim(),
+        content: line,
+        lines: [line],
+        startLine: i,
+        endLine: i,
+        isProtected: false,
+      }
+    } else if (currentSection) {
+      currentSection.content += '\n' + line
+      currentSection.lines.push(line)
+      currentSection.endLine = i
+    }
+  }
+
+  if (currentSection) {
+    sections.push(currentSection)
+  }
+
+  return sections
+}
+
+function isSectionProtected(section) {
+  return PROTECTED_SECTIONS.some((pattern) => pattern.test(section.title) || pattern.test(section.content))
+}
+
+function sectionRelevanceScore(section, keywords) {
+  if (!keywords || keywords.length === 0) return 0.5
+  const content = (section.title + ' ' + section.content).toLowerCase()
+  let score = 0
+
+  for (const keyword of keywords) {
+    if (content.includes(keyword.toLowerCase())) {
+      score += 1
+    }
+  }
+
+  return score / keywords.length
+}
+
+function extractKeywords(task, kind) {
+  const words = new Set()
+
+  // Palabras de la descripción de la tarea
+  const taskWords = task.toLowerCase().split(/\s+/)
+  const stopWords = new Set(['el', 'la', 'los', 'las', 'un', 'una', 'de', 'del', 'en', 'con',
+    'para', 'por', 'que', 'es', 'se', 'no', 'su', 'lo', 'como', 'más', 'pero', 'sus',
+    'le', 'ya', 'este', 'entre', 'porque', 'este', 'esta', 'the', 'a', 'an', 'of', 'in',
+    'to', 'for', 'and', 'or', 'is', 'it', 'on', 'at', 'by', 'with', 'from'])
+
+  for (const word of taskWords) {
+    if (word.length > 2 && !stopWords.has(word)) {
+      words.add(word)
+    }
+  }
+
+  // Palabras clave del tipo (@kind)
+  if (kind && SECTION_KEYWORD_MAP[kind]) {
+    for (const kw of SECTION_KEYWORD_MAP[kind]) {
+      words.add(kw)
+    }
+  }
+
+  // Palabras clave de categorías relacionadas (detectadas por palabras en la tarea)
+  for (const [category, categoryWords] of Object.entries(SECTION_KEYWORD_MAP)) {
+    for (const word of taskWords) {
+      if (categoryWords.includes(word)) {
+        for (const kw of categoryWords) {
+          words.add(kw)
+        }
+      }
+    }
+  }
+
+  return Array.from(words)
+}
+
+// ──────────────────────────────────────────────
+// API: compressContext
+// ──────────────────────────────────────────────
+
+/**
+ * Comprime un contexto markdown eliminando secciones irrelevantes.
+ *
+ * @param {string} task - Descripción de la tarea (e.g., "crea hook useAuth")
+ * @param {string} fullContext - Contexto markdown completo (e.g., AGENTS.md)
+ * @param {object} profile - Perfil Boost activo (opcional, auto-detecta)
+ * @param {object} options - Opciones adicionales
+ * @param {string} options.mode - Modo de compresión: 'safe' | 'aggressive' | 'disabled'
+ * @param {string} options.kind - @kind del archivo a generar (hook, component, etc.)
+ * @returns {{ context: string, metrics: object }}
+ */
+export function compressContext(task, fullContext, profile, options = {}) {
+  // Modo disabled: devolver contexto completo
+  if (options.mode === 'disabled' || profile?.compressionLevel === 0) {
+    return {
+      context: fullContext,
+      metrics: {
+        originalChars: fullContext.length,
+        compressedChars: fullContext.length,
+        reductionPercent: 0,
+        sectionsKept: 0,
+        sectionsRemoved: 0,
+        mode: 'disabled',
+      },
+    }
+  }
+
+  const mode = options.mode || 'safe'
+  const kind = options.kind || ''
+  const compressionLevel = profile?.compressionLevel ?? 50
+
+  // Parsear secciones
+  const sections = parseSections(fullContext)
+
+  if (sections.length === 0) {
+    // No se pudieron parsear secciones → devolver completo
+    return {
+      context: fullContext,
+      metrics: {
+        originalChars: fullContext.length,
+        compressedChars: fullContext.length,
+        reductionPercent: 0,
+        sectionsKept: 1,
+        sectionsRemoved: 0,
+        mode,
+      },
+    }
+  }
+
+  // Extraer palabras clave
+  const keywords = extractKeywords(task, kind)
+
+  // Calcular relevancia y decidir qué secciones conservar
+  const threshold = mode === 'aggressive' ? 0.15 : 0.08
+  const keptSections = []
+  const removedSections = []
+
+  for (const section of sections) {
+    const isProtected = isSectionProtected(section)
+    const relevance = sectionRelevanceScore(section, keywords)
+
+    if (isProtected) {
+      keptSections.push(section)
+      section._reason = 'protected'
+      section._score = 1.0
+    } else if (relevance >= threshold) {
+      keptSections.push(section)
+      section._reason = `relevance (${(relevance * 100).toFixed(0)}%)`
+      section._score = relevance
+    } else {
+      removedSections.push(section)
+      section._reason = `low relevance (${(relevance * 100).toFixed(0)}%)`
+      section._score = relevance
+    }
+  }
+
+  // En modo aggressive, solo incluir cabeceras de secciones de baja relevancia (no el contenido)
+  let compressed
+  if (mode === 'aggressive') {
+    // Reconstruir: secciones completas + solo títulos de las que no pasaron el threshold
+    const lines = []
+    for (const section of sections) {
+      if (section._reason === 'protected' || section._score >= threshold) {
+        lines.push(section.content)
+      } else if (section._score >= threshold * 0.5) {
+        // Incluir solo el título (como hint) pero no el contenido
+        lines.push(section.lines[0])
+        lines.push('')
+      }
+    }
+    compressed = lines.join('\n')
+  } else {
+    // Modo safe: reconstruir solo secciones completas
+    compressed = keptSections.map((s) => s.content).join('\n')
+  }
+
+  // Aplicar límite de reducción según perfil
+  const maxReduction = (compressionLevel / 100) * fullContext.length
+  const minChars = fullContext.length - maxReduction
+
+  if (compressed.length < minChars) {
+    // Si nos pasamos de reducción, agregar contexto adicional
+    // Agregar secciones de mayor score entre las removidas
+    const sortedRemoved = [...removedSections].sort((a, b) => b._score - a._score)
+    for (const section of sortedRemoved) {
+      if (compressed.length >= minChars) break
+      compressed += '\n' + section.content
+    }
+  }
+
+  return {
+    context: compressed.trim(),
+    metrics: {
+      originalChars: fullContext.length,
+      compressedChars: compressed.trim().length,
+      reductionPercent: Math.round((1 - compressed.trim().length / fullContext.length) * 100),
+      sectionsKept: keptSections.length,
+      sectionsRemoved: removedSections.length,
+      mode,
+      threshold,
+      keywords: keywords.length,
+    },
+  }
+}
+
+// ──────────────────────────────────────────────
+// API: compressTaskContext — wrapper simplificado
+// ──────────────────────────────────────────────
+
+/**
+ * Wrapper simplificado para comprimir contexto desde archivos del proyecto.
+ *
+ * @param {string} task - Descripción de la tarea
+ * @param {object} [profile] - Perfil Boost (opcional)
+ * @param {object} [options] - Opciones adicionales
+ * @returns {{ context: string, metrics: object }}
+ */
+export function compressTaskContext(task, profile, options = {}) {
+  // Fuentes de contexto a comprimir
+  const contextSources = [
+    { path: join(process.cwd(), "AGENTS.md"), key: "agents" },
+    { path: join(process.cwd(), "prompt-lang.json"), key: "config" },
+  ]
+
+  let fullContext = ""
+
+  for (const source of contextSources) {
+    try {
+      if (existsSync(source.path)) {
+        const content = readFileSync(source.path, "utf-8")
+        fullContext += `\n\n<!-- source: ${source.key} -->\n\n${content}`
+      }
+    } catch {
+      // archivo no disponible
+    }
+  }
+
+  return compressContext(task, fullContext, profile, options)
+}
+
+// ──────────────────────────────────────────────
+// API: compressAgentsMd — compresión específica de AGENTS.md
+// ──────────────────────────────────────────────
+
+/**
+ * Lee y comprime AGENTS.md según la tarea y el perfil.
+ *
+ * @param {string} task - Descripción de la tarea
+ * @param {object} [profile] - Perfil Boost
+ * @param {object} [options] - Opciones adicionales
+ * @returns {{ context: string, metrics: object } | null}
+ */
+export function compressAgentsMd(task, profile, options = {}) {
+  const agentsPath = join(process.cwd(), "AGENTS.md")
+
+  if (!existsSync(agentsPath)) {
+    return null
+  }
+
+  const fullContext = readFileSync(agentsPath, "utf-8")
+  return compressContext(task, fullContext, profile, options)
+}