openprompt-lang 1.2.7 → 1.4.0

package/src/mcp-refactor/handlers/boost.js

@@ -0,0 +1,295 @@
+// @use(kind, contract, limit)
+// @kind(util)
+// @contract(in: toolName, args -> out: toolResult)
+// @limit(lines: 250)
+
+/**
+ * Handlers MCP para OPL Boost.
+ *
+ * Tools expuestas:
+ *   boost_generate  → Genera código usando el pipeline completo
+ *   boost_compress  → Comprime contexto según perfil
+ *   boost_profile   → Muestra perfil Boost activo y estado del sistema
+ *   boost_plan      → Planifica DAG de micro-tareas
+ *   boost_validate  → Ejecuta validation loop sobre código
+ */
+
+import { toolResult } from "../utils.js"
+import { boost, generateCode } from "../../boost/orchestrator.js"
+import { getProfile, listProfiles, isBoostEnabled } from "../../boost/profile-registry.js"
+import { compressContext, compressAgentsMd } from "../../boost/context-compressor.js"
+import { plan, detectKind, listKinds } from "../../boost/task-dispatcher.js"
+import { quickValidate, validateCode, buildFeedback, generateReport } from "../../boost/validation-loop.js"
+import {
+  checkOllama,
+  listOllamaModels,
+} from "../../boost/agent-pool.js"
+import {
+  detectHardware,
+  getRuntimeStatus,
+  getSafeParallelism,
+  getRAMWarning,
+} from "../../boost/hardware-detector.js"
+
+// ──────────────────────────────────────────────
+// boost_generate
+// ──────────────────────────────────────────────
+
+export async function handleBoostGenerate(args) {
+  const { description, kind, contextMode, multiAgent, validate } = args
+
+  if (!description) {
+    return toolResult("Error: se requiere 'description' (descripción de la tarea)", true)
+  }
+
+  try {
+    const result = await boost(description, {
+      kind: kind || undefined,
+      contextMode: contextMode || "safe",
+      multiAgent: multiAgent || false,
+      validate: validate !== false,
+    })
+
+    const output = []
+
+    if (result.code) {
+      output.push("## Código Generado\n")
+      output.push("```typescript")
+      output.push(result.code)
+      output.push("```\n")
+    }
+
+    if (result.report) {
+      output.push("## Reporte\n")
+      output.push(result.report.summary)
+    }
+
+    if (result.metadata?.stages) {
+      output.push("\n## Etapas\n")
+      for (const stage of result.metadata.stages) {
+        const icon = stage.error ? "✖" : "✓"
+        output.push(`- ${icon} ${stage.name}: ${stage.duration || 0}ms`)
+      }
+    }
+
+    return toolResult(output.join("\n"))
+  } catch (error) {
+    return toolResult(`Error en boost_generate: ${error.message}\n${error.stack}`, true)
+  }
+}
+
+// ──────────────────────────────────────────────
+// boost_compress
+// ──────────────────────────────────────────────
+
+export async function handleBoostCompress(args) {
+  const { task, context, kind, mode } = args
+
+  if (!task && !context) {
+    return toolResult("Error: se requiere 'task' (descripción de la tarea) o 'context' (contexto markdown)", true)
+  }
+
+  try {
+    const profile = getProfile()
+    const fullContext = context || ""
+    const compressed = compressContext(task || "general", fullContext, profile, {
+      mode: mode || "safe",
+      kind: kind || "",
+    })
+
+    const output = []
+    output.push("## Contexto Comprimido\n")
+    output.push(compressed.context)
+    output.push("\n## Métricas\n")
+    output.push(`- Original: ${compressed.metrics.originalChars} caracteres`)
+    output.push(`- Comprimido: ${compressed.metrics.compressedChars} caracteres`)
+    output.push(`- Reducción: ${compressed.metrics.reductionPercent}%`)
+    output.push(`- Secciones preservadas: ${compressed.metrics.sectionsKept}`)
+    output.push(`- Secciones removidas: ${compressed.metrics.sectionsRemoved}`)
+    output.push(`- Modo: ${compressed.metrics.mode}`)
+
+    return toolResult(output.join("\n"))
+  } catch (error) {
+    return toolResult(`Error en boost_compress: ${error.message}`, true)
+  }
+}
+
+// ──────────────────────────────────────────────
+// boost_profile
+// ──────────────────────────────────────────────
+
+export async function handleBoostProfile(args) {
+  const { action } = args // "status", "list", "set"
+
+  try {
+    const enabled = isBoostEnabled()
+    const profile = getProfile()
+
+    if (action === "list") {
+      const profiles = listProfiles()
+      const lines = ["## Perfiles Boost Disponibles\n"]
+      for (const p of profiles) {
+        const active = p.name === profile?.name ? " ← activo" : ""
+        lines.push(`- **${p.name}**: ${p.description}${active}`)
+        lines.push(`  - Contexto: ${p.contextWindow.toLocaleString()} tokens, Compresión: ${p.compressionLevel}%`)
+      }
+      return toolResult(lines.join("\n"))
+    }
+
+    // Default: status
+    const runtime = getRuntimeStatus()
+    const safety = getSafeParallelism(profile)
+
+    const lines = [
+      "## Estado Boost\n",
+      `- **Habilitado**: ${enabled ? "Sí" : "No"}`,
+      `- **Perfil activo**: ${profile?.name || "No detectado"}`,
+      `- **Descripción**: ${profile?.description || profile?.label || "—"}`,
+      `- **Ventana de contexto**: ${profile?.contextWindow?.toLocaleString() || "—"} tokens`,
+      `- **Compresión**: ${profile?.compressionLevel || 0}%`,
+      `- **Validación loops**: ${profile?.validationLoops || "—"}`,
+      `- **Micro-tasking**: ${profile?.microTasks ? "Sí" : "No"}`,
+      `- **Template hydration**: ${profile?.templateHydration ? "Sí" : "No"}`,
+      `- **Few-shot**: ${profile?.fewShot ? "Sí" : "No"}`,
+      "",
+      "## Estado del Sistema\n",
+      `- **RAM libre**: ${runtime.ram.freeGB} GB / ${runtime.ram.totalGB} GB`,
+      `- **CPU load**: ${runtime.cpu.loadAvg1m} / ${runtime.cpu.cores} núcleos`,
+      `- **Modo**: ${safety.mode}`,
+      `- **Agentes**: ${safety.maxAgents} simultáneo(s)`,
+    ]
+
+    const warning = getRAMWarning()
+    if (warning) {
+      lines.push(`\n⚠️ ${warning}`)
+    }
+
+    // Ollama status
+    try {
+      const ollamaUp = await checkOllama()
+      lines.push(`\n- **Ollama**: ${ollamaUp ? "🟢 Conectado" : "🔴 No detectado"}`)
+      if (ollamaUp) {
+        const models = await listOllamaModels()
+        if (models.length > 0) {
+          lines.push("  - Modelos disponibles:")
+          for (const m of models.slice(0, 5)) {
+            lines.push(`    - ${m.name} (${(m.size / 1024 / 1024 / 1024).toFixed(1)} GB)`)
+          }
+        }
+      }
+    } catch {
+      lines.push("\n- **Ollama**: No disponible")
+    }
+
+    return toolResult(lines.join("\n"))
+  } catch (error) {
+    return toolResult(`Error en boost_profile: ${error.message}`, true)
+  }
+}
+
+// ──────────────────────────────────────────────
+// boost_plan
+// ──────────────────────────────────────────────
+
+export async function handleBoostPlan(args) {
+  const { task, kind } = args
+
+  if (!task) {
+    return toolResult("Error: se requiere 'task' (descripción de la tarea)", true)
+  }
+
+  try {
+    const detectedKind = kind || detectKind(task)
+    const dag = plan(task, detectedKind)
+
+    const lines = [
+      "## Plan de Micro-Tareas (DAG)\n",
+      `- **Tarea**: ${task}`,
+      `- **Kind detectado**: ${detectedKind}`,
+      `- **Nodos**: ${dag.nodeCount}`,
+      `- **Paralelos**: ${dag.stages.parallel.join(", ") || "ninguno"}`,
+      `- **Secuenciales**: ${dag.stages.sequential.join(", ") || "ninguno"}`,
+      "",
+      "### Nodos\n",
+    ]
+
+    for (const node of dag.nodes) {
+      const deps = node.deps.length > 0 ? ` (espera: ${node.deps.join(", ")})` : " (inmediato)"
+      lines.push(`- **${node.id}** → ${node.description}${deps}`)
+      lines.push(`  - Agente: \`${node.agent}\``)
+    }
+
+    lines.push("\n### Aristas\n")
+    for (const edge of dag.edges) {
+      lines.push(`- \`${edge.from}\` → \`${edge.to}\``)
+    }
+
+    lines.push("\n### Mermaid\n")
+    lines.push("```mermaid")
+    lines.push("graph TD")
+    for (const node of dag.nodes) {
+      lines.push(`  ${node.id}["${node.description}"]`)
+    }
+    for (const edge of dag.edges) {
+      lines.push(`  ${edge.from} --> ${edge.to}`)
+    }
+    lines.push("```")
+
+    return toolResult(lines.join("\n"))
+  } catch (error) {
+    return toolResult(`Error en boost_plan: ${error.message}`, true)
+  }
+}
+
+// ──────────────────────────────────────────────
+// boost_validate
+// ──────────────────────────────────────────────
+
+export async function handleBoostValidate(args) {
+  const { code, kind } = args
+
+  if (!code) {
+    return toolResult("Error: se requiere 'code' (código a validar)", true)
+  }
+
+  try {
+    // QuickValidate: no necesita Ollama
+    const quick = quickValidate(code, kind || "component")
+
+    // Si se quiere validación completa, ejecutar validateCode
+    const full = validateCode(code, kind || "component")
+
+    const lines = [
+      "## Validación Boost\n",
+      `- **QuickValidate**: ${quick.valid ? "✅ Pasa" : "❌ Falla"}`,
+    ]
+
+    if (quick.warnings.length > 0) {
+      lines.push("\n### Advertencias QuickValidate\n")
+      for (const w of quick.warnings) {
+        lines.push(`- ⚠️ ${w}`)
+      }
+    }
+
+    lines.push(`\n- **Validación OPL**: ${full.valid ? "✅ Pasa" : "❌ Falla"}`)
+    if (full.errors.length > 0) {
+      lines.push("\n### Errores OPL\n")
+      for (const err of full.errors) {
+        lines.push(`- ❌ [${err.type}] ${err.message}${err.line > 0 ? ` (línea ${err.line})` : ""}`)
+      }
+    }
+
+    if (full.valid && quick.valid) {
+      lines.push("\n✅ Código listo para commit.")
+    } else {
+      lines.push("\n⚠️ Corrige los errores antes de commit.")
+      const feedback = buildFeedback(full.errors)
+      lines.push("\n### Feedback sugerido\n")
+      lines.push(feedback)
+    }
+
+    return toolResult(lines.join("\n"))
+  } catch (error) {
+    return toolResult(`Error en boost_validate: ${error.message}`, true)
+  }
+}

package/src/mcp-refactor/router.js

@@ -33,6 +33,13 @@ import {
 import { handleExecuteSandbox } from "./handlers/sandbox.js"
 import { handleAnalyzeBlastRadius } from "./handlers/blast.js"
 import { handleAstPatchMutate } from "./handlers/mutate.js"
+import {
+  handleBoostGenerate,
+  handleBoostCompress,
+  handleBoostProfile,
+  handleBoostPlan,
+  handleBoostValidate,
+} from "./handlers/boost.js"
 import { toolResult } from "./utils.js"
 
 /**
@@ -118,6 +125,18 @@ export async function handleToolCall(name, args) {
       case "ast_patch_mutate":
         return await handleAstPatchMutate(args)
 
+      // Boost — Multi-agent generation pipeline
+      case "boost_generate":
+        return await handleBoostGenerate(args)
+      case "boost_compress":
+        return await handleBoostCompress(args)
+      case "boost_profile":
+        return await handleBoostProfile(args)
+      case "boost_plan":
+        return await handleBoostPlan(args)
+      case "boost_validate":
+        return await handleBoostValidate(args)
+
       default:
         return toolResult(`Unknown tool: ${name}`, true)
     }

package/src/mcp-refactor/tools.js

@@ -493,4 +493,117 @@ export const TOOLS = [
       required: ["target", "action", "codeContent"],
     },
   },
+  // ──────────────────────────────────────────────
+  // OPL Boost — Multi-agent generation pipeline
+  // ──────────────────────────────────────────────
+  {
+    name: "boost_generate",
+    description:
+      "[BOOST GENERATE] Generate code using the full Boost pipeline. Uses profile detection, context compression, few-shot examples, agent pool, skeleton hydration, and validation loop. Returns generated code with metadata.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        description: {
+          type: "string",
+          description: "Task description (e.g., 'create hook useAuth with Supabase')",
+        },
+        kind: {
+          type: "string",
+          description: "File type: hook, component, page, service, store (auto-detected if omitted)",
+        },
+        contextMode: {
+          type: "string",
+          description: "Context compression mode: safe, aggressive, disabled (default: safe)",
+        },
+        multiAgent: {
+          type: "boolean",
+          description: "Use multi-agent pipeline instead of single-pass (default: false)",
+        },
+        validate: {
+          type: "boolean",
+          description: "Run validation loop after generation (default: true)",
+        },
+      },
+      required: ["description"],
+    },
+  },
+  {
+    name: "boost_compress",
+    description:
+      "[BOOST COMPRESS] Compress project context (AGENTS.md) to only sections relevant to a specific task. Returns compressed context with reduction metrics.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        task: {
+          type: "string",
+          description: "Task description for relevance matching (e.g., 'create hook useAuth')",
+        },
+        context: {
+          type: "string",
+          description: "Full context markdown to compress (uses project AGENTS.md if omitted)",
+        },
+        kind: {
+          type: "string",
+          description: "File type for keyword matching: hook, component, page, service, store",
+        },
+        mode: {
+          type: "string",
+          description: "Compression mode: safe (preserves enforcement), aggressive (minimal), disabled (no compression)",
+        },
+      },
+      required: ["task"],
+    },
+  },
+  {
+    name: "boost_profile",
+    description:
+      "[BOOST PROFILE] Show current Boost profile, system status (RAM, CPU, Ollama), and safe parallelism. Use before generating code to check if system can handle agents.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        action: {
+          type: "string",
+          description: "Action: 'status' (default), 'list' (list all profiles)",
+        },
+      },
+    },
+  },
+  {
+    name: "boost_plan",
+    description:
+      "[BOOST PLAN] Decompose a code generation task into a DAG of micro-tasks. Returns the execution plan with parallel and sequential stages before actually generating code. Use with boost_generate or standalone for planning.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        task: {
+          type: "string",
+          description: "Task description (e.g., 'create hook useAuth with Supabase')",
+        },
+        kind: {
+          type: "string",
+          description: "File type: hook, component, page, service, store (auto-detected if omitted)",
+        },
+      },
+      required: ["task"],
+    },
+  },
+  {
+    name: "boost_validate",
+    description:
+      "[BOOST VALIDATE] Run OPL validation and quick-check on generated code. Returns structured errors, warnings, and suggested fixes. Use after boost_generate to verify output quality.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        code: {
+          type: "string",
+          description: "Code to validate",
+        },
+        kind: {
+          type: "string",
+          description: "File type for @kind-specific limits: hook (80), component (120), page (200), service (150), store (100)",
+        },
+      },
+      required: ["code"],
+    },
+  },
 ]