openprompt-lang 1.3.0 → 1.4.0

package/src/boost/hydrator.js

@@ -0,0 +1,398 @@
+// @use(kind, contract, limit, error)
+// @kind(util)
+// @contract(in: kind, parts, options -> out: hydrate -> { code: string, warnings: string[] } @error: UnknownSkeletonError, MissingRequiredPart)
+// @limit(lines: 200)
+
+/**
+ * Template Hydration System — Módulo OPL Boost
+ *
+ * Toma los resultados parciales de los agentes Boost y los inyecta
+ * en skeletons predefinidos para producir código OPL-compliant.
+ *
+ * Uso:
+ *   import { hydrate, hydrateFromAgentResults } from './boost/hydrator.js'
+ *
+ *   const result = hydrate('hook', {
+ *     imports: "import { useState } from 'react'",
+ *     name: "useAuth",
+ *     params: "userId: string",
+ *     state: "const [user, setUser] = useState<User | null>(null)",
+ *     logic: "useEffect(() => { fetchUser(userId).then(setUser) }, [userId])",
+ *     contractIn: "userId: string",
+ *     contractOut: "{ user, loading, error }",
+ *     description: "Custom hook para autenticación con Supabase",
+ *   })
+ *   // → { code: "...código completo...", warnings: [] }
+ */
+
+import { getSkeleton, listSkeletons, hasSkeleton } from "./skeletons/index.js"
+
+// ──────────────────────────────────────────────
+// Placeholders por tipo de skeleton
+// ──────────────────────────────────────────────
+
+const PLACEHOLDER_MAP = {
+  hook: {
+    required: ["name"],
+    placeholders: {
+      PLACEHOLDER_IMPORTS: "imports",
+      PLACEHOLDER_TYPES: "types",
+      PLACEHOLDER_STATE: "state",
+      PLACEHOLDER_LOGIC: "logic",
+      PLACEHOLDER_EXPORTS: "exports",
+      PLACEHOLDER_NAME: "name",
+      PLACEHOLDER_PARAMS: "params",
+      PLACEHOLDER_RETURN: "return",
+      PLACEHOLDER_RETURN_TYPE: "returnType",
+      PLACEHOLDER_DESCRIPTION: "description",
+      PLACEHOLDER_CONTRACT_IN: "contractIn",
+      PLACEHOLDER_CONTRACT_OUT: "contractOut",
+      PLACEHOLDER_CONTRACT_ERROR: "contractError",
+    },
+  },
+  component: {
+    required: ["name", "jsx"],
+    placeholders: {
+      PLACEHOLDER_IMPORTS: "imports",
+      PLACEHOLDER_VARIANTS: "variants",
+      PLACEHOLDER_PROPS: "props",
+      PLACEHOLDER_PROPS_LIST: "propsList",
+      PLACEHOLDER_PROPS_DESTRUCTURE: "propsDestructure",
+      PLACEHOLDER_NAME: "name",
+      PLACEHOLDER_JSX: "jsx",
+    },
+  },
+  page: {
+    required: ["name", "layout"],
+    placeholders: {
+      PLACEHOLDER_IMPORTS: "imports",
+      PLACEHOLDER_TYPES: "types",
+      PLACEHOLDER_LAYOUT: "layout",
+      PLACEHOLDER_DATA: "data",
+      PLACEHOLDER_JSX: "jsx",
+      PLACEHOLDER_COMPONENTS: "components",
+      PLACEHOLDER_NAME: "name",
+      PLACEHOLDER_HELPERS: "helpers",
+    },
+  },
+  service: {
+    required: ["name"],
+    placeholders: {
+      PLACEHOLDER_IMPORTS: "imports",
+      PLACEHOLDER_TYPES: "types",
+      PLACEHOLDER_METHODS: "methods",
+      PLACEHOLDER_EXPORTS: "exports",
+      PLACEHOLDER_CONTRACT_IN: "contractIn",
+      PLACEHOLDER_CONTRACT_OUT: "contractOut",
+      PLACEHOLDER_CONTRACT_ERROR: "contractError",
+      PLACEHOLDER_BASE_URL: "baseUrl",
+    },
+  },
+  store: {
+    required: ["name"],
+    placeholders: {
+      PLACEHOLDER_IMPORTS: "imports",
+      PLACEHOLDER_TYPES: "types",
+      PLACEHOLDER_STORE: "store",
+      PLACEHOLDER_EXPORTS: "exports",
+      PLACEHOLDER_DEPS: "deps",
+    },
+  },
+  type: {
+    required: [],
+    placeholders: {
+      PLACEHOLDER_IMPORTS: "imports",
+      PLACEHOLDER_TYPES: "types",
+      PLACEHOLDER_EXPORTS: "exports",
+    },
+  },
+}
+
+// ──────────────────────────────────────────────
+// Default values for common placeholders
+// ──────────────────────────────────────────────
+
+const DEFAULT_PLACEHOLDERS = {
+  imports: "",
+  types: "",
+  state: "",
+  logic: "",
+  exports: "default",
+  returnType: "void",
+  description: "Generated by OPL Boost",
+  propsList: "",
+  propsDestructure: "",
+  contractIn: "unknown",
+  contractOut: "unknown",
+  contractError: "Error",
+  baseUrl: 'const BASE_URL = process.env.NEXT_PUBLIC_API_URL || "http://localhost:3000/api"',
+  components: "",
+  helpers: "",
+  deps: "none",
+  variants: "",
+  data: "",
+}
+
+// ──────────────────────────────────────────────
+// Sistema de validación post-hydration
+// ──────────────────────────────────────────────
+
+/**
+ * Validaciones post-generación específicas por tipo.
+ */
+const POST_VALIDATIONS = {
+  hook: [
+    {
+      name: "has-export-function",
+      check: (code) => /export\s+function\s+\w+/.test(code),
+      message: "El hook debe exportar una función con nombre",
+    },
+    {
+      name: "has-kind-hook",
+      check: (code) => /@kind\(hook\)/.test(code),
+      message: "Debe tener anotación @kind(hook)",
+    },
+    {
+      name: "max-lines-80",
+      check: (code) => code.split("\n").length <= 80,
+      message: "El hook no debe exceder 80 líneas (límite OPL)",
+    },
+  ],
+  component: [
+    {
+      name: "has-export-function",
+      check: (code) => /export\s+function\s+\w+/.test(code),
+      message: "El componente debe exportar una función con nombre",
+    },
+    {
+      name: "has-kind-component",
+      check: (code) => /@kind\(component\)/.test(code),
+      message: "Debe tener anotación @kind(component)",
+    },
+    {
+      name: "has-props-interface",
+      check: (code) => /interface\s+\w+Props/.test(code),
+      message: "Debe tener una interfaz de props (NameProps)",
+    },
+    {
+      name: "max-lines-120",
+      check: (code) => code.split("\n").length <= 120,
+      message: "El componente no debe exceder 120 líneas",
+    },
+  ],
+  page: [
+    {
+      name: "has-default-export",
+      check: (code) => /export\s+default\s+function/.test(code),
+      message: "La página debe tener export default function",
+    },
+    {
+      name: "has-kind-page",
+      check: (code) => /@kind\(page\)/.test(code),
+      message: "Debe tener anotación @kind(page)",
+    },
+    {
+      name: "max-lines-200",
+      check: (code) => code.split("\n").length <= 200,
+      message: "La página no debe exceder 200 líneas",
+    },
+  ],
+  service: [
+    {
+      name: "has-kind-service",
+      check: (code) => /@kind\(service\)/.test(code),
+      message: "Debe tener anotación @kind(service)",
+    },
+    {
+      name: "max-lines-150",
+      check: (code) => code.split("\n").length <= 150,
+      message: "El servicio no debe exceder 150 líneas",
+    },
+  ],
+  store: [
+    {
+      name: "has-kind-store",
+      check: (code) => /@kind\(store\)/.test(code),
+      message: "Debe tener anotación @kind(store)",
+    },
+    {
+      name: "max-lines-100",
+      check: (code) => code.split("\n").length <= 100,
+      message: "El store no debe exceder 100 líneas",
+    },
+  ],
+  type: [
+    {
+      name: "has-kind-type",
+      check: (code) => /@kind\(type\)/.test(code),
+      message: "Debe tener anotación @kind(type)",
+    },
+    {
+      name: "has-export",
+      check: (code) => /export\s/.test(code),
+      message: "El archivo de tipos debe tener exports",
+    },
+  ],
+}
+
+// ──────────────────────────────────────────────
+// API: hydrate
+// ──────────────────────────────────────────────
+
+/**
+ * Hidrata un skeleton con partes de código.
+ *
+ * @param {string} kind - Tipo de skeleton (hook, component, page, service, store)
+ * @param {object} parts - Objeto con las partes a reemplazar
+ *   Ejemplo: { name: "useAuth", imports: "...", state: "...", logic: "..." }
+ * @param {object} [options] - Opciones adicionales
+ * @param {boolean} [options.validate=true] - Ejecutar validaciones post-hydration
+ * @param {boolean} [options.skipAnnotations=false] - Omitir anotaciones OPL
+ * @returns {{ code: string, warnings: string[], validations: object }}
+ */
+export function hydrate(kind, parts, options = {}) {
+  const validate = options.validate !== false
+
+  // 1. Validar que el skeleton exista
+  if (!hasSkeleton(kind)) {
+    throw new Error(
+      `Skeleton desconocido: "${kind}". Tipos: ${listSkeletons().map((s) => s.kind).join(", ")}`
+    )
+  }
+
+  // 2. Validar partes requeridas
+  const config = PLACEHOLDER_MAP[kind]
+  if (!config) {
+    throw new Error(`Tipo de skeleton no configurado: "${kind}"`)
+  }
+
+  const missingRequired = config.required.filter((key) => !parts[key])
+  if (missingRequired.length > 0) {
+    throw new Error(
+      `Partes requeridas faltantes para "${kind}": ${missingRequired.join(", ")}`
+    )
+  }
+
+  // 3. Cargar skeleton
+  let code = getSkeleton(kind)
+
+  // 4. Reemplazar placeholders
+  const warnings = []
+  for (const [placeholder, key] of Object.entries(config.placeholders)) {
+    const value = parts[key] || DEFAULT_PLACEHOLDERS[key] || ""
+    const regex = new RegExp(`\\{\\{${placeholder}\\}\\}`, "g")
+
+    if (!parts[key] && !DEFAULT_PLACEHOLDERS[key]) {
+      warnings.push(`Placeholder {{${placeholder}}} no fue reemplazado (sin valor ni default)`)
+    }
+
+    code = code.replace(regex, value)
+  }
+
+  // 5. Limpiar placeholders no reemplazados
+  const remainingPlaceholders = code.match(/\{\{PLACEHOLDER_\w+\}\}/g)
+  if (remainingPlaceholders) {
+    for (const ph of remainingPlaceholders) {
+      code = code.replace(ph, "")
+      warnings.push(`Placeholder ${ph} no reemplazado — contenido vacío`)
+    }
+  }
+
+  // 6. Formatear: eliminar líneas vacías múltiples
+  code = code.replace(/\n{3,}/g, "\n\n")
+
+  // 7. Validaciones post-hydration
+  let validations = []
+  if (validate) {
+    const checks = POST_VALIDATIONS[kind] || []
+    validations = checks.map((check) => {
+      const passed = check.check(code)
+      if (!passed) {
+        warnings.push(`Validación fallida: ${check.message}`)
+      }
+      return { name: check.name, passed, message: check.message }
+    })
+  }
+
+  return {
+    code,
+    warnings,
+    validations,
+  }
+}
+
+// ──────────────────────────────────────────────
+// API: hydrateFromAgentResults
+// ──────────────────────────────────────────────
+
+/**
+ * Hidrata un skeleton a partir de los resultados de los agentes Boost.
+ * Toma los outputs de los agentes types, state, logic y los mapea
+ * automáticamente a las partes del skeleton.
+ *
+ * @param {string} kind - Tipo de skeleton
+ * @param {object} agentResults - Resultados de agentes { types: "...", state: "...", logic: "..." }
+ * @param {object} [options] - Opciones adicionales
+ * @returns {{ code: string, warnings: string[], validations: object }}
+ */
+export function hydrateFromAgentResults(kind, agentResults, options = {}) {
+  const { types, state, logic, cleaner, description } = agentResults
+
+  // Mapear resultados de agentes a partes del skeleton
+  const parts = {
+    types,
+    state: state || "",
+    logic: logic || "",
+    description: cleaner || description || "Generated by OPL Boost",
+  }
+
+  // Añadir defaults según el tipo
+  switch (kind) {
+    case "hook":
+      parts.imports = parts.imports || types || ""
+      parts.exports = parts.exports || "default"
+      break
+    case "component":
+      parts.imports = parts.imports || types || ""
+      parts.jsx = parts.jsx || logic || ""
+      break
+    case "page":
+      parts.imports = parts.imports || types || ""
+      parts.layout = parts.layout || logic || ""
+      break
+    case "service":
+      parts.imports = parts.imports || types || ""
+      parts.methods = logic || ""
+      break
+    case "store":
+      parts.imports = parts.imports || types || ""
+      parts.store = logic || ""
+      break
+  }
+
+  return hydrate(kind, parts, options)
+}
+
+// ──────────────────────────────────────────────
+// API: generatePlaceholderMap
+// ──────────────────────────────────────────────
+
+/**
+ * Genera un mapa de placeholders para un tipo, útil para UI o debugging.
+ *
+ * @param {string} kind - Tipo de skeleton
+ * @returns {{ placeholders: string[], required: string[], optional: string[] }}
+ */
+export function getHydrationSchema(kind) {
+  const config = PLACEHOLDER_MAP[kind]
+  if (!config) return null
+
+  const allKeys = Object.values(config.placeholders)
+  const optional = allKeys.filter((k) => !config.required.includes(k))
+
+  return {
+    placeholders: Object.keys(config.placeholders),
+    required: config.required,
+    optional,
+  }
+}

package/src/boost/index.js

@@ -0,0 +1,60 @@
+// @use(kind, contract, limit)
+// @kind(module)
+// @contract(in: task, options -> out: { code, metadata, report } Public API: boost, generateCode, quickValidate, cache)
+// @limit(lines: 60)
+
+/**
+ * OPL Boost — API pública del módulo.
+ *
+ * Punto de entrada unificado para todas las funcionalidades Boost.
+ *
+ * Uso principal:
+ *   import { boost } from './boost/index.js'
+ *   const result = await boost('crea hook useAuth', { kind: 'hook' })
+ *   console.log(result.code)
+ *
+ * Componentes individuales (import directo para uso avanzado):
+ *   import { getProfile } from './boost/profile-registry.js'
+ *   import { agentPool } from './boost/agent-pool.js'
+ *   import { compressContext } from './boost/context-compressor.js'
+ *   import { hydrate } from './boost/hydrator.js'
+ */
+
+// El orquestador importa todos los demás módulos internamente
+export { boost, generateCode } from "./orchestrator.js"
+
+// Perfiles
+export { getProfile, setProfile, listProfiles, detectProfile, isBoostEnabled, clearCache } from "./profile-registry.js"
+
+// Agent Pool
+export { agentPool, checkOllama, listOllamaModels, selectBestModel, buildPrompt } from "./agent-pool.js"
+
+// Hardware
+export { detectHardware, getRuntimeStatus, getSafeParallelism, getRAMWarning, generateBoostConfig, saveBoostConfig } from "./hardware-detector.js"
+
+// Compresión de contexto
+export { compressContext, compressTaskContext, compressAgentsMd } from "./context-compressor.js"
+
+// Few-shot
+export { retrieveExamples, buildFewShotPrompt, exampleStats } from "./fewshot-retriever.js"
+
+// Hydration
+export { hydrate, hydrateFromAgentResults, getHydrationSchema } from "./hydrator.js"
+
+// Validation
+export { quickValidate, validateCode, feedbackLoop, buildFeedback, generateReport } from "./validation-loop.js"
+
+// Task dispatcher
+export { plan, detectKind, listKinds } from "./task-dispatcher.js"
+
+// Agentes
+export { getAgent, listAgents } from "./agents/index.js"
+
+// Cache
+export { cache, hashInput, cacheKeys } from "./cache.js"
+
+// Self-learning
+export { recordExecution, autoProfile, selfLearnStats } from "./self-learn.js"
+
+// Preamble
+export { generatePreamble, writePreamble } from "./preamble.js"