openprompt-lang 1.2.7 → 1.4.0

package/src/boost/self-learn.js

@@ -0,0 +1,247 @@
+// @use(kind, contract, limit, error)
+// @kind(util)
+// @contract(in: executionResult -> out: metrics -> { record, recommend, autoProfile, stats } @error: SelfLearnError)
+// @limit(lines: 200)
+
+/**
+ * Self-Learning — Módulo OPL Boost
+ *
+ * Registra métricas de cada ejecución Boost y las usa para mejorar
+ * automáticamente la configuración en futuras sesiones.
+ *
+ * Si un perfil consistentemente falla, recomienda bajar a uno más conservador.
+ * Si un perfil consistentemente tiene éxito rápido, recomienda subir.
+ *
+ * Uso:
+ *   import { recordExecution, autoProfile, selfLearnStats } from './boost/self-learn.js'
+ *   recordExecution({ kind: 'hook', profile: 'small', success: true, duration: 12000, attempts: 2 })
+ *   const recommended = autoProfile()
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs"
+import { join } from "path"
+
+// ──────────────────────────────────────────────
+// Configuración
+// ──────────────────────────────────────────────
+
+const METRICS_DIR = join(process.cwd(), ".opencode", "boost")
+const METRICS_FILE = join(METRICS_DIR, "metrics.json")
+const MAX_ENTRIES = 1000
+
+// ──────────────────────────────────────────────
+// Lectura y escritura de métricas
+// ──────────────────────────────────────────────
+
+function readMetrics() {
+  try {
+    if (!existsSync(METRICS_FILE)) return { entries: [] }
+    const data = readFileSync(METRICS_FILE, "utf-8")
+    return JSON.parse(data)
+  } catch {
+    return { entries: [] }
+  }
+}
+
+function writeMetrics(metrics) {
+  if (!existsSync(METRICS_DIR)) {
+    mkdirSync(METRICS_DIR, { recursive: true })
+  }
+  // Rotación: mantener solo las últimas MAX_ENTRIES
+  if (metrics.entries.length > MAX_ENTRIES) {
+    metrics.entries = metrics.entries.slice(-MAX_ENTRIES)
+  }
+  writeFileSync(METRICS_FILE, JSON.stringify(metrics, null, 2), "utf-8")
+}
+
+// ──────────────────────────────────────────────
+// API: recordExecution
+// ──────────────────────────────────────────────
+
+/**
+ * Registra métricas de una ejecución Boost.
+ *
+ * @param {{ kind: string, profile: string, success: boolean, duration: number, attempts: number, errors?: Array }} execution
+ * @returns {{ recorded: boolean, totalEntries: number }}
+ */
+export function recordExecution(execution) {
+  const metrics = readMetrics()
+
+  const entry = {
+    timestamp: new Date().toISOString(),
+    kind: execution.kind || "unknown",
+    profile: execution.profile || "unknown",
+    success: execution.success ?? false,
+    duration: execution.duration || 0,
+    attempts: execution.attempts || 1,
+    errors: execution.errors || [],
+  }
+
+  metrics.entries.push(entry)
+  writeMetrics(metrics)
+
+  return {
+    recorded: true,
+    totalEntries: metrics.entries.length,
+  }
+}
+
+// ──────────────────────────────────────────────
+// API: autoProfile
+// ──────────────────────────────────────────────
+
+/**
+ * Analiza métricas históricas y recomienda un perfil.
+ *
+ * Reglas:
+ *   - Si perfil actual falla >3 veces seguidas → recomienda bajar
+ *   - Si perfil actual tiene éxito >5 veces seguidas con duración baja → recomienda subir
+ *   - Si validación toma >5 intentos → recomienda activar template hydration
+ *
+ * @returns {{ recommended: string, reason: string, confidence: number }}
+ */
+export function autoProfile() {
+  const metrics = readMetrics()
+  const entries = metrics.entries
+
+  if (entries.length < 3) {
+    return {
+      recommended: "medium",
+      reason: "Datos insuficientes (menos de 3 ejecuciones). Perfil safe: medium.",
+      confidence: 0.3,
+    }
+  }
+
+  // Analizar últimas 10 ejecuciones
+  const recent = entries.slice(-10)
+  const failures = recent.filter((e) => !e.success)
+  const successes = recent.filter((e) => e.success)
+
+  const currentProfile = recent[recent.length - 1]?.profile || "medium"
+
+  // Si hay muchas fallas consecutivas, recomendar bajar
+  const consecutiveFailures = countConsecutiveFailures(recent)
+  if (consecutiveFailures >= 3) {
+    const recommendation = downgradeProfile(currentProfile)
+    return {
+      recommended: recommendation,
+      reason: `${consecutiveFailures} fallos consecutivos con perfil ${currentProfile}. Se recomienda bajar a ${recommendation}.`,
+      confidence: 0.7,
+    }
+  }
+
+  // Si hay muchos éxitos rápidos, recomendar subir
+  const consecutiveSuccesses = countConsecutiveSuccesses(recent)
+  const avgDuration = successes.length > 0
+    ? successes.reduce((sum, e) => sum + e.duration, 0) / successes.length
+    : 0
+
+  if (consecutiveSuccesses >= 5 && avgDuration < 10000) {
+    const recommendation = upgradeProfile(currentProfile)
+    return {
+      recommended: recommendation,
+      reason: `${consecutiveSuccesses} éxitos consecutivos con ${currentProfile} y duración promedio ${(avgDuration / 1000).toFixed(1)}s. Se puede intentar ${recommendation}.`,
+      confidence: 0.6,
+    }
+  }
+
+  // Si validación toma muchos intentos, recomendar hydration
+  const avgAttempts = recent.reduce((sum, e) => sum + e.attempts, 0) / recent.length
+  if (avgAttempts > 3) {
+    return {
+      recommended: currentProfile,
+      reason: `Validación promedio de ${avgAttempts.toFixed(1)} intentos. Se recomienda activar template hydration.`,
+      confidence: 0.5,
+      suggestion: "enable_template_hydration",
+    }
+  }
+
+  return {
+    recommended: currentProfile,
+    reason: `Perfil ${currentProfile} funcionando correctamente. Sin cambios recomendados.`,
+    confidence: 0.8,
+  }
+}
+
+function countConsecutiveFailures(entries) {
+  let count = 0
+  for (let i = entries.length - 1; i >= 0; i--) {
+    if (!entries[i].success) count++
+    else break
+  }
+  return count
+}
+
+function countConsecutiveSuccesses(entries) {
+  let count = 0
+  for (let i = entries.length - 1; i >= 0; i--) {
+    if (entries[i].success) count++
+    else break
+  }
+  return count
+}
+
+function downgradeProfile(profile) {
+  const order = ["small", "medium", "large"]
+  const idx = order.indexOf(profile)
+  return order[Math.max(0, idx - 1)]
+}
+
+function upgradeProfile(profile) {
+  const order = ["small", "medium", "large"]
+  const idx = order.indexOf(profile)
+  return order[Math.min(order.length - 1, idx + 1)]
+}
+
+// ──────────────────────────────────────────────
+// API: selfLearnStats
+// ──────────────────────────────────────────────
+
+/**
+ * Estadísticas de auto-aprendizaje.
+ *
+ * @returns {{ totalExecutions: number, successRate: number, avgDuration: number, avgAttempts: number, byProfile: object, byKind: object, recommendation: object }}
+ */
+export function selfLearnStats() {
+  const metrics = readMetrics()
+  const entries = metrics.entries
+
+  if (entries.length === 0) {
+    return {
+      totalExecutions: 0,
+      successRate: 0,
+      avgDuration: 0,
+      avgAttempts: 0,
+      byProfile: {},
+      byKind: {},
+      recommendation: autoProfile(),
+    }
+  }
+
+  const successRate = entries.filter((e) => e.success).length / entries.length
+  const avgDuration = entries.reduce((sum, e) => sum + e.duration, 0) / entries.length
+  const avgAttempts = entries.reduce((sum, e) => sum + e.attempts, 0) / entries.length
+
+  const byProfile = {}
+  const byKind = {}
+
+  for (const e of entries) {
+    byProfile[e.profile] = byProfile[e.profile] || { count: 0, successes: 0 }
+    byProfile[e.profile].count++
+    if (e.success) byProfile[e.profile].successes++
+
+    byKind[e.kind] = byKind[e.kind] || { count: 0, successes: 0 }
+    byKind[e.kind].count++
+    if (e.success) byKind[e.kind].successes++
+  }
+
+  return {
+    totalExecutions: entries.length,
+    successRate: Math.round(successRate * 100),
+    avgDuration: Math.round(avgDuration),
+    avgAttempts: Math.round(avgAttempts * 10) / 10,
+    byProfile,
+    byKind,
+    recommendation: autoProfile(),
+  }
+}

package/src/boost/skeletons/component.skeleton.js

@@ -0,0 +1,24 @@
+// Skeleton template for @kind(component)
+// Markers: {{PLACEHOLDER_IMPORTS}}, {{PLACEHOLDER_VARIANTS}}, {{PLACEHOLDER_PROPS}}, {{PLACEHOLDER_JSX}}
+// Max lines: 120
+
+// @use(kind, props, limit)
+// @kind(component)
+// @props({ children: ReactNode, className: string })
+// @limit(lines: 120)
+
+{{PLACEHOLDER_IMPORTS}}
+
+{{PLACEHOLDER_VARIANTS}}
+
+export interface {{PLACEHOLDER_NAME}}Props {
+  {{PLACEHOLDER_PROPS}}
+}
+
+export function {{PLACEHOLDER_NAME}}({ {{PLACEHOLDER_PROPS_DESTRUCTURE}} }: {{PLACEHOLDER_NAME}}Props) {
+  return (
+    {{PLACEHOLDER_JSX}}
+  )
+}
+
+export default {{PLACEHOLDER_NAME}}

package/src/boost/skeletons/hook.skeleton.js

@@ -0,0 +1,27 @@
+// Skeleton template for @kind(hook)
+// Markers: {{PLACEHOLDER_IMPORTS}}, {{PLACEHOLDER_TYPES}}, {{PLACEHOLDER_STATE}}, {{PLACEHOLDER_LOGIC}}, {{PLACEHOLDER_EXPORTS}}
+// Max lines: 80
+
+// @use(kind, contract, limit)
+// @kind(hook)
+// @contract(in: {{PLACEHOLDER_CONTRACT_IN}} -> out: {{PLACEHOLDER_CONTRACT_OUT}} @error: {{PLACEHOLDER_CONTRACT_ERROR}})
+// @limit(lines: 80)
+
+{{PLACEHOLDER_IMPORTS}}
+
+/**
+ * {{PLACEHOLDER_DESCRIPTION}}
+ *
+ * @returns {{PLACEHOLDER_RETURN_TYPE}}
+ */
+{{PLACEHOLDER_TYPES}}
+
+export function {{PLACEHOLDER_NAME}}({{PLACEHOLDER_PARAMS}}) {
+  {{PLACEHOLDER_STATE}}
+
+  {{PLACEHOLDER_LOGIC}}
+
+  return {{PLACEHOLDER_RETURN}}
+}
+
+export default {{PLACEHOLDER_NAME}}

package/src/boost/skeletons/index.js

@@ -0,0 +1,67 @@
+// @use(kind, contract, limit)
+// @kind(util)
+// @contract(in: kind -> out: skeletonContent, @error: UnknownSkeletonError)
+// @limit(lines: 60)
+
+/**
+ * Registro unificado de skeletons para el Template Hydration System.
+ *
+ * Cada skeleton es un string con marcadores {{PLACEHOLDER_*}} que el
+ * hydrator reemplaza con la lógica de negocio generada por los agentes.
+ */
+
+import { readFileSync, existsSync } from "fs"
+import { join } from "path"
+
+const SKELETONS_DIR = join(import.meta.dirname || __dirname)
+
+const SKELETON_FILES = {
+  hook: "hook.skeleton.js",
+  component: "component.skeleton.js",
+  page: "page.skeleton.js",
+  service: "service.skeleton.js",
+  store: "store.skeleton.js",
+  type: "type.skeleton.js",
+}
+
+/**
+ * Obtiene el contenido de un skeleton por tipo.
+ * @param {string} kind - Tipo de skeleton (hook, component, page, service, store)
+ * @returns {string} Contenido del skeleton
+ */
+export function getSkeleton(kind) {
+  const filename = SKELETON_FILES[kind]
+  if (!filename) {
+    throw new Error(
+      `Skeleton desconocido: "${kind}". Tipos: ${Object.keys(SKELETON_FILES).join(", ")}`
+    )
+  }
+
+  const path = join(SKELETONS_DIR, filename)
+
+  if (!existsSync(path)) {
+    throw new Error(`Archivo skeleton no encontrado: ${path}`)
+  }
+
+  return readFileSync(path, "utf-8")
+}
+
+/**
+ * Lista los tipos de skeletons disponibles.
+ * @returns {Array<{kind: string, file: string}>}
+ */
+export function listSkeletons() {
+  return Object.entries(SKELETON_FILES).map(([kind, file]) => ({
+    kind,
+    file,
+  }))
+}
+
+/**
+ * Verifica si un tipo de skeleton existe.
+ * @param {string} kind
+ * @returns {boolean}
+ */
+export function hasSkeleton(kind) {
+  return kind in SKELETON_FILES
+}

package/src/boost/skeletons/page.skeleton.js

@@ -0,0 +1,22 @@
+// Skeleton template for @kind(page)
+// Markers: {{PLACEHOLDER_IMPORTS}}, {{PLACEHOLDER_TYPES}}, {{PLACEHOLDER_LAYOUT}}, {{PLACEHOLDER_DATA}}, {{PLACEHOLDER_JSX}}
+// Max lines: 200
+
+// @use(kind, compose, limit)
+// @kind(page)
+// @compose(components: [{{PLACEHOLDER_COMPONENTS}}])
+// @limit(lines: 200)
+
+{{PLACEHOLDER_IMPORTS}}
+
+{{PLACEHOLDER_TYPES}}
+
+export default function {{PLACEHOLDER_NAME}}Page() {
+  {{PLACEHOLDER_DATA}}
+
+  return (
+    {{PLACEHOLDER_LAYOUT}}
+  )
+}
+
+{{PLACEHOLDER_HELPERS}}

package/src/boost/skeletons/service.skeleton.js

@@ -0,0 +1,20 @@
+// Skeleton template for @kind(service)
+// Markers: {{PLACEHOLDER_IMPORTS}}, {{PLACEHOLDER_TYPES}}, {{PLACEHOLDER_METHODS}}
+// Max lines: 150
+
+// @use(kind, contract, limit)
+// @kind(service)
+// @contract(in: {{PLACEHOLDER_CONTRACT_IN}} -> out: {{PLACEHOLDER_CONTRACT_OUT}} @error: {{PLACEHOLDER_CONTRACT_ERROR}})
+// @limit(lines: 150)
+
+{{PLACEHOLDER_IMPORTS}}
+
+{{PLACEHOLDER_BASE_URL}}
+
+{{PLACEHOLDER_TYPES}}
+
+{{PLACEHOLDER_METHODS}}
+
+export {
+  {{PLACEHOLDER_EXPORTS}}
+}

package/src/boost/skeletons/store.skeleton.js

@@ -0,0 +1,18 @@
+// Skeleton template for @kind(store)
+// Markers: {{PLACEHOLDER_IMPORTS}}, {{PLACEHOLDER_TYPES}}, {{PLACEHOLDER_STORE}}
+// Max lines: 100
+
+// @use(kind, deps, limit)
+// @kind(store)
+// @deps({{PLACEHOLDER_DEPS}})
+// @limit(lines: 100)
+
+{{PLACEHOLDER_IMPORTS}}
+
+{{PLACEHOLDER_TYPES}}
+
+{{PLACEHOLDER_STORE}}
+
+export {
+  {{PLACEHOLDER_EXPORTS}}
+}

package/src/boost/skeletons/type.skeleton.js

@@ -0,0 +1,11 @@
+// Skeleton template for @kind(type)
+// Markers: {{PLACEHOLDER_IMPORTS}}, {{PLACEHOLDER_TYPES}}, {{PLACEHOLDER_EXPORTS}}
+
+// @use(kind)
+// @kind(type)
+
+{{PLACEHOLDER_IMPORTS}}
+
+{{PLACEHOLDER_TYPES}}
+
+{{PLACEHOLDER_EXPORTS}}

package/src/boost/task-dispatcher.js

@@ -0,0 +1,142 @@
+// @use(kind, contract, limit)
+// @kind(util)
+// @contract(in: task, kind -> out: DAG de agnodes -> { nodes: [], edges: [] })
+// @limit(lines: 150)
+
+/**
+ * Task Dispatcher — Módulo OPL Boost
+ *
+ * Convierte una descripción de tarea en un DAG (Directed Acyclic Graph)
+ * de pasos que los agentes pueden ejecutar en paralelo o secuencia.
+ *
+ * Uso:
+ *   import { plan } from './boost/task-dispatcher.js'
+ *   const dag = plan('crea hook useAuth con Supabase', 'hook')
+ *   // → { task, kind, nodes: [...], edges: [...] }
+ */
+
+// ──────────────────────────────────────────────
+// DAG templates por @kind
+// ──────────────────────────────────────────────
+
+const DAG_TEMPLATES = {
+  hook: {
+    nodes: [
+      { id: "types", agent: "types", deps: [], description: "Define tipos e interfaces" },
+      { id: "state", agent: "state", deps: [], description: "Diseña estado y efectos" },
+      { id: "logic", agent: "logic", deps: ["types", "state"], description: "Implementa lógica de negocio" },
+      { id: "validate", agent: "validate", deps: ["logic"], description: "Valida y corrige errores" },
+    ],
+  },
+  component: {
+    nodes: [
+      { id: "types", agent: "types", deps: [], description: "Define interface de props" },
+      { id: "state", agent: "state", deps: [], description: "Diseña estado interno" },
+      { id: "logic", agent: "logic", deps: ["types", "state"], description: "Implementa JSX y variantes" },
+      { id: "validate", agent: "validate", deps: ["logic"], description: "Valida y corrige errores" },
+    ],
+  },
+  page: {
+    nodes: [
+      { id: "types", agent: "types", deps: [], description: "Define tipos de la página" },
+      { id: "state", agent: "state", deps: [], description: "Diseña fetching y estado" },
+      { id: "logic", agent: "logic", deps: ["types", "state"], description: "Implementa layout y componentes" },
+      { id: "validate", agent: "validate", deps: ["logic"], description: "Valida y corrige errores" },
+    ],
+  },
+  service: {
+    nodes: [
+      { id: "types", agent: "types", deps: [], description: "Define DTOs y tipos de respuesta" },
+      { id: "logic", agent: "logic", deps: ["types"], description: "Implementa métodos del servicio" },
+      { id: "validate", agent: "validate", deps: ["logic"], description: "Valida y corrige errores" },
+    ],
+  },
+  store: {
+    nodes: [
+      { id: "types", agent: "types", deps: [], description: "Define estado global y tipos" },
+      { id: "logic", agent: "logic", deps: ["types"], description: "Implementa store y acciones" },
+      { id: "validate", agent: "validate", deps: ["logic"], description: "Valida y corrige errores" },
+    ],
+  },
+  type: {
+    nodes: [
+      { id: "types", agent: "types", deps: [], description: "Define TypeScript types e interfaces" },
+      { id: "validate", agent: "validate", deps: ["types"], description: "Valida y corrige errores" },
+    ],
+  },
+}
+
+// ──────────────────────────────────────────────
+// API principal
+// ──────────────────────────────────────────────
+
+/**
+ * Planifica un DAG de tareas para una descripción y tipo.
+ *
+ * @param {string} task - Descripción de la tarea
+ * @param {string} kind - Tipo de archivo (hook, component, page, service, store)
+ * @returns {{ task: string, kind: string, nodes: Array, edges: Array, stages: object }}
+ */
+export function plan(task, kind) {
+  const template = DAG_TEMPLATES[kind] || DAG_TEMPLATES.component
+
+  // Generar edges del DAG
+  const edges = []
+  for (const node of template.nodes) {
+    for (const dep of node.deps) {
+      edges.push({ from: dep, to: node.id })
+    }
+  }
+
+  // Clasificar nodos por stage (paralelizable vs secuencial)
+  const parallelNodes = template.nodes.filter((n) => n.deps.length === 0)
+  const sequentialNodes = template.nodes.filter((n) => n.deps.length > 0)
+
+  return {
+    task,
+    kind,
+    nodes: template.nodes,
+    edges,
+    stages: {
+      parallel: parallelNodes.map((n) => n.id),
+      sequential: sequentialNodes.map((n) => n.id),
+    },
+    nodeCount: template.nodes.length,
+  }
+}
+
+/**
+ * Detecta automáticamente el @kind basado en la descripción de la tarea.
+ *
+ * @param {string} task - Descripción de la tarea
+ * @returns {string} kind detectado o 'component' como default
+ */
+export function detectKind(task) {
+  const lower = task.toLowerCase()
+
+  if (/\b(hook|use\w+)\b/.test(lower)) return "hook"
+  if (/\b(service|api|repository|client|servicio)\b/.test(lower)) return "service"
+  if (/\b(store|state|context|provider|estado)\b/.test(lower)) return "store"
+  if (/\b(page|screen|view|route|página|pagina)\b/.test(lower)) return "page"
+  if (/\b(type|interface|types|typings|dtype|tipos)\b/.test(lower)) return "type"
+  if (/\b(component|button|input|card|modal|form|table|dialog|componente|botón|formulario)\b/.test(lower)) return "component"
+
+  return "component"
+}
+
+/**
+ * Lista los tipos de DAG disponibles.
+ * @returns {string[]}
+ */
+export function listKinds() {
+  return Object.keys(DAG_TEMPLATES)
+}
+
+/**
+ * Obtiene el DAG template para un kind específico.
+ * @param {string} kind
+ * @returns {object|null}
+ */
+export function getDAG(kind) {
+  return DAG_TEMPLATES[kind] || null
+}