openprompt-lang 1.2.7 → 1.4.0

package/src/boost/preamble.js

@@ -0,0 +1,217 @@
+// @use(kind, contract, limit, learn-error)
+// @kind(util)
+// @contract(in: options -> out: preamble text)
+// @limit(lines: 150)
+
+/**
+ * Universal Workflow Preamble — Módulo OPL Boost
+ *
+ * Genera un mensaje de sistema que se inyecta al inicio de cada
+ * interacción con la IA, forzando que siga el workflow OPL.
+ *
+ * Funciona de 3 formas:
+ *   1. Archivo: genera .opencode/preamble.md que el AI client lee
+ *   2. System prompt: genera texto para inyectar como systemPrompt
+ *   3. CLI: `opl boost preamble` muestra el preamble actual
+ *
+ * El preamble es dinámico: se regenera según el estado del proyecto
+ * (tickets abiertos, perfil activo, learn-errors recientes).
+ *
+ * Uso:
+ *   import { generatePreamble, writePreamble } from './boost/preamble.js'
+ *   const text = generatePreamble()
+ *   writePreamble()
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from "fs"
+import { join } from "path"
+
+// ──────────────────────────────────────────────
+// Configuración
+// ──────────────────────────────────────────────
+
+const PREAMBLE_PATH = join(process.cwd(), ".opencode", "boost-preamble.md")
+const DEFAULT_MAX_WORDS = 300
+
+// ──────────────────────────────────────────────
+// Preamble generation
+// ──────────────────────────────────────────────
+
+/**
+ * Genera el preamble de workflow obligatorio.
+ *
+ * @param {object} [options] - Opciones
+ * @param {number} [options.maxWords=300] - Máximo de palabras
+ * @param {boolean} [options.includeProfile=true] - Incluir info del perfil activo
+ * @param {boolean} [options.includeTickets=true] - Incluir tickets abiertos
+ * @param {boolean} [options.includeErrors=true] - Incluir learn-errors recientes
+ * @returns {string} Texto del preamble en markdown
+ */
+export async function generatePreamble(options = {}) {
+  const maxWords = options.maxWords || DEFAULT_MAX_WORDS
+  const includeProfile = options.includeProfile !== false
+  const includeTickets = options.includeTickets !== false
+  const includeErrors = options.includeErrors !== false
+
+  const sections = []
+
+  // ── Header ──
+  sections.push("## ⚠️ OPL Workflow Obligatorio")
+  sections.push("")
+  sections.push("Antes de implementar cualquier cosa, DEBES seguir este orden:")
+  sections.push("")
+  sections.push("1. `workflow select <descripción>` — Seleccionar workflow")
+  sections.push("2. `ticket create` — Crear ticket (sin ticket no hay código)")
+  sections.push("3. `check gates` — Verificar prerrequisitos")
+  sections.push("4. `work_context_plan` — Planificar (features/refactors)")
+  sections.push("5. Implementar con anotaciones OPL primero")
+  sections.push("6. `npx openprompt-lang validate` — Validar")
+  sections.push("7. Actualizar documentación")
+  sections.push("8. `work_context_close` — Cerrar sesión")
+  sections.push("")
+
+  // ── Prohibiciones ──
+  sections.push("### ⛔ Prohibido")
+  sections.push("")
+  sections.push("- Implementar sin ticket abierto")
+  sections.push("- Cerrar sesión sin documentación actualizada")
+  sections.push("- Mutar código sin `analyze_blast_radius` primero")
+  sections.push("- Modificar archivos `*.template.*`")
+  sections.push("- Usar `any` en TypeScript")
+  sections.push("- Exceder `@limit` sin refactorizar")
+  sections.push("")
+
+  // ── Perfil Boost ──
+  if (includeProfile) {
+    try {
+      const { getProfile, isBoostEnabled } = await import("./profile-registry.js")
+      if (isBoostEnabled()) {
+        const profile = getProfile()
+        if (profile) {
+          sections.push("### 🚀 Boost Activo")
+          sections.push("")
+          sections.push(`- Perfil: **${profile.name}** (${profile.label})`)
+          sections.push(`- Compresión: ${profile.compressionLevel}% | Validación: ${profile.validationLoops} loops`)
+          sections.push(`- Micro-tasking: ${profile.microTasks ? "Sí" : "No"} | Few-shot: ${profile.fewShot ? "Sí" : "No"}`)
+          sections.push("")
+        }
+      }
+    } catch {
+      // Profile no disponible — omitir sección
+    }
+  }
+
+  // ── Tickets abiertos ──
+  if (includeTickets) {
+    const ticketCount = countOpenTickets()
+    if (ticketCount > 0) {
+      sections.push(`### 📋 Tickets Abiertos: ${ticketCount}`)
+      sections.push("")
+      sections.push("Antes de crear uno nuevo, verifica si ya existe un ticket relacionado.")
+      sections.push("")
+    }
+  }
+
+  // ── learn-errors recientes ──
+  if (includeErrors) {
+    const recentErrors = getRecentLearnErrors()
+    if (recentErrors.length > 0) {
+      sections.push("### 🧠 Learn-Errors Recientes")
+      sections.push("")
+      for (const err of recentErrors.slice(0, 3)) {
+        sections.push(`- **${err.id}**: ${err.fix}`)
+      }
+      sections.push("")
+    }
+  }
+
+  // ── Límites de líneas ──
+  sections.push("### 📐 Límites @limit")
+  sections.push("")
+  sections.push("| @kind | Líneas | | @kind | Líneas |")
+  sections.push("|-------|--------|--|-------|--------|")
+  sections.push("| hook | 80 | | service | 150 |")
+  sections.push("| component | 120 | | store | 100 |")
+  sections.push("| page | 200 | | util | 100 |")
+  sections.push("")
+
+  // ── Truncar a maxWords ──
+  let result = sections.join("\n")
+  const words = result.split(/\s+/).length
+  if (words > maxWords) {
+    // Truncar por líneas completas
+    const lines = result.split("\n")
+    let count = 0
+    const truncated = []
+    for (const line of lines) {
+      count += line.split(/\s+/).length
+      if (count > maxWords) break
+      truncated.push(line)
+    }
+    result = truncated.join("\n") + "\n\n> Preamble truncado a ~300 palabras."
+  }
+
+  return result
+}
+
+/**
+ * Escribe el preamble a un archivo en el proyecto.
+ *
+ * @param {object} [options] - Opciones para generatePreamble
+ * @returns {string} Ruta del archivo escrito
+ */
+export function writePreamble(options = {}) {
+  const content = generatePreamble(options)
+  const dir = join(process.cwd(), ".opencode")
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
+  writeFileSync(PREAMBLE_PATH, content, "utf-8")
+  return PREAMBLE_PATH
+}
+
+// ──────────────────────────────────────────────
+// Helpers (lector de estado del proyecto)
+// ──────────────────────────────────────────────
+
+function countOpenTickets() {
+  const ticketsDir = join(process.cwd(), "docs", "04-TICKETS")
+  if (!existsSync(ticketsDir)) return 0
+  try {
+    const files = readdirSync(ticketsDir).filter((f) => f.endsWith(".md") && f.startsWith("BOOST-"))
+    let open = 0
+    for (const f of files) {
+      const content = readFileSync(join(ticketsDir, f), "utf-8")
+      if (content.includes("🔴 Pendiente") || content.includes("🟡 Parcial")) open++
+    }
+    return open
+  } catch {
+    return 0
+  }
+}
+
+function getRecentLearnErrors() {
+  const errors = []
+  const srcDir = join(process.cwd(), "src")
+  if (!existsSync(srcDir)) return errors
+  try {
+    const files = readdirSync(srcDir, { recursive: true }).filter((f) => {
+      return typeof f === "string" && (f.endsWith(".ts") || f.endsWith(".tsx") || f.endsWith(".js") || f.endsWith(".jsx"))
+    })
+    for (const f of files.slice(0, 50)) {
+      const fullPath = typeof f === "string" ? join(srcDir, f) : f
+      if (!existsSync(fullPath)) continue
+      try {
+        const content = readFileSync(fullPath, "utf-8")
+        const lines = content.split("\n")
+        for (const line of lines) {
+          const learnErrorTag = "@learn-error"
+          const pattern = new RegExp(learnErrorTag + "\\s+id=(\\S+)\\s+.*fix='([^']+)'")
+          const match = line.match(pattern)
+          if (match) {
+            errors.push({ id: match[1], fix: match[2] })
+          }
+        }
+      } catch { /* ignore */ }
+    }
+  } catch { /* ignore */ }
+  return errors
+}

package/src/boost/profile-registry.js

@@ -0,0 +1,264 @@
+// @use(kind, contract, limit)
+// @kind(util)
+// @contract(in: none -> out: PROFILES, getProfile, setProfile, detectProfile, listProfiles)
+// @limit(lines: 150)
+
+/**
+ * Profile Registry — Módulo OPL Boost
+ *
+ * Sistema de perfiles para modelos de IA.
+ * Detecta automáticamente la capacidad del modelo y configura
+ * las estrategias de boost según el perfil (small/medium/large).
+ *
+ * Uso:
+ *   import { getProfile } from './boost/profile-registry.js'
+ *   const profile = getProfile() // { name, compressionLevel, validationLoops, ... }
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync } from "fs"
+import { join, dirname } from "path"
+
+function getStatePath() {
+  return join(process.cwd(), ".opencode", "boost-profile.json")
+}
+
+function readState() {
+  const path = getStatePath()
+  if (!existsSync(path)) return null
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"))
+  } catch {
+    return null
+  }
+}
+
+function writeState(state) {
+  const path = getStatePath()
+  mkdirSync(dirname(path), { recursive: true })
+  writeFileSync(path, JSON.stringify(state, null, 2), "utf-8")
+}
+
+function clearState() {
+  const path = getStatePath()
+  if (existsSync(path)) rmSync(path)
+}
+
+// ──────────────────────────────────────────────
+// Perfiles predefinidos
+// ──────────────────────────────────────────────
+
+export const PROFILES = {
+  small: {
+    label: "Small Model",
+    description: "Modelos con <16K contexto (DeepSeek Coder, CodeGemma, Phi-3)",
+    contextWindow: 8000,
+    compressionLevel: 80, // % de reducción de contexto
+    validationLoops: 3,  // reintentos de validación
+    microTasks: true,    // usar micro-tasking
+    templateHydration: true, // usar skeletons
+    fewShot: true,       // inyectar ejemplos
+    contextWindowMin: 0,
+    contextWindowMax: 16000,
+  },
+  medium: {
+    label: "Medium Model",
+    description: "Modelos con 16K-64K contexto (Qwen 2.5 Coder, Llama 3, Mistral)",
+    contextWindow: 32000,
+    compressionLevel: 50,
+    validationLoops: 2,
+    microTasks: true,
+    templateHydration: true,
+    fewShot: true,
+    contextWindowMin: 16000,
+    contextWindowMax: 64000,
+  },
+  large: {
+    label: "Large Model",
+    description: "Modelos con >64K contexto (GPT-4, Claude 3, Gemini Pro)",
+    contextWindow: 128000,
+    compressionLevel: 0,
+    validationLoops: 1,
+    microTasks: false,
+    templateHydration: false,
+    fewShot: false,
+    contextWindowMin: 64000,
+    contextWindowMax: Infinity,
+  },
+}
+
+// ──────────────────────────────────────────────
+// Estado interno (cache)
+// ──────────────────────────────────────────────
+
+let _cachedProfile = null
+let _forcedProfile = null
+
+// ──────────────────────────────────────────────
+// Detección de perfil
+// ──────────────────────────────────────────────
+
+/**
+ * Mapeo de nombres de modelo conocidos a perfiles.
+ */
+const KNOWN_MODELS = {
+  // Small
+  "deepseek-coder": "small",
+  "deepseek-coder-v2": "small",
+  "codegemma": "small",
+  "codegemma-2b": "small",
+  "phi-3": "small",
+  "phi-3-mini": "small",
+  "stable-code": "small",
+  "codestral": "small",
+  // Medium
+  "qwen2.5-coder": "medium",
+  "qwen2.5-coder-7b": "medium",
+  "llama-3": "medium",
+  "llama-3-8b": "medium",
+  "mistral": "medium",
+  "mixtral": "medium",
+  "codellama": "medium",
+  "codellama-13b": "medium",
+  "gemma-2": "medium",
+  "openchat": "medium",
+  // Large
+  "gpt-4": "large",
+  "gpt-4-turbo": "large",
+  "gpt-4o": "large",
+  "claude-3": "large",
+  "claude-3-opus": "large",
+  "claude-3-sonnet": "large",
+  "gemini-pro": "large",
+  "gemini-ultra": "large",
+  "llama-3-70b": "large",
+  "qwen2.5-72b": "large",
+}
+
+export function detectProfile() {
+  // 1. Forzado manual en memoria (prioridad máxima en el mismo proceso)
+  if (_forcedProfile) {
+    return _forcedProfile
+  }
+
+  // 2. Estado persistido (entre procesos CLI)
+  const state = readState()
+  if (state && state.forcedProfile && PROFILES[state.forcedProfile]) {
+    return state.forcedProfile
+  }
+
+  // 3. Variable de entorno explícita
+  const envProfile = process.env.OPL_BOOST_PROFILE
+  if (envProfile && PROFILES[envProfile]) {
+    return envProfile
+  }
+
+  // 4. Detección por nombre de modelo
+  const modelName = process.env.OPL_MODEL || process.env.OPENAI_MODEL || ""
+  const normalized = modelName.toLowerCase().trim()
+
+  for (const [key, profile] of Object.entries(KNOWN_MODELS)) {
+    if (normalized.includes(key)) {
+      return profile
+    }
+  }
+
+  // 5. Config en prompt-lang.json
+  try {
+    const configPath = join(process.cwd(), "prompt-lang.json")
+    if (existsSync(configPath)) {
+      const config = JSON.parse(readFileSync(configPath, "utf-8"))
+      const boostConfig = config.boost
+      if (boostConfig) {
+        if (boostConfig.enabled === false) return null
+        if (boostConfig.defaultProfile && boostConfig.defaultProfile !== "auto") {
+          return boostConfig.defaultProfile
+        }
+        // Overrides de perfil específicos
+        if (boostConfig.profiles && boostConfig.profiles[modelName]) {
+          return boostConfig.profiles[modelName]
+        }
+      }
+    }
+  } catch {
+    // fallback a default
+  }
+
+  // 6. Default seguro — medium
+  return "medium"
+}
+
+// ──────────────────────────────────────────────
+// API pública
+// ──────────────────────────────────────────────
+
+export function getProfile() {
+  if (_cachedProfile && !_forcedProfile) {
+    return _cachedProfile
+  }
+
+  const profileName = detectProfile()
+  if (!profileName) return null
+
+  const profileConfig = PROFILES[profileName]
+  if (!profileConfig) return null
+
+  _cachedProfile = {
+    name: profileName,
+    ...profileConfig,
+  }
+
+  return _cachedProfile
+}
+
+export function setProfile(name) {
+  if (name === "auto" || name === null || name === undefined) {
+    _forcedProfile = null
+    _cachedProfile = null
+    clearState()
+    return getProfile()
+  }
+
+  if (!PROFILES[name]) {
+    throw new Error(
+      `Perfil "${name}" no válido. Opciones: ${Object.keys(PROFILES).join(", ")}, "auto"`
+    )
+  }
+
+  _forcedProfile = name
+  _cachedProfile = null
+  writeState({ forcedProfile: name, updatedAt: new Date().toISOString() })
+  return getProfile()
+}
+
+export function listProfiles() {
+  return Object.entries(PROFILES).map(([name, config]) => ({
+    name,
+    label: config.label,
+    description: config.description,
+    contextWindow: config.contextWindow,
+    compressionLevel: config.compressionLevel,
+    validationLoops: config.validationLoops,
+    microTasks: config.microTasks,
+    templateHydration: config.templateHydration,
+    fewShot: config.fewShot,
+  }))
+}
+
+export function clearCache() {
+  _cachedProfile = null
+  _forcedProfile = null
+  clearState()
+}
+
+export function isBoostEnabled() {
+  try {
+    const configPath = join(process.cwd(), "prompt-lang.json")
+    if (existsSync(configPath)) {
+      const config = JSON.parse(readFileSync(configPath, "utf-8"))
+      if (config.boost && config.boost.enabled === false) return false
+    }
+  } catch {
+    // fallback
+  }
+  return true
+}