@hyperfixi/mcp-server 2.11.1 → 3.1.0

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to `@hyperfixi/mcp-server` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+> **Superseded by the root changelog.** Every package in this monorepo publishes
+> in lockstep at the root version, and the entries below use an older
+> per-package numbering that no published version ever matched. They are kept
+> for the migration notes they carry; they are not a record of recent releases.
+> **For anything since, see
+> [the monorepo CHANGELOG](https://github.com/codetalcott/hyperfixi/blob/main/CHANGELOG.md)**
+> and [GitHub Releases](https://github.com/codetalcott/hyperfixi/releases).
+
 ## [Unreleased]
 
 ### Changed

package/README.md

@@ -1,6 +1,6 @@
 # @hyperfixi/mcp-server
 
-MCP (Model Context Protocol) server for hyperscript and multilingual DSL development. Provides **108 tools**, **9 resources**, and **9 prompts** spanning: GRAIL workflow orchestration, validation, compilation, analysis, patterns, LSP bridge, language profiles, code generation, route extraction, 9 domain DSLs, IR conversion, cross-domain dispatch, MCP sampling (opt-in), AI-assisted debugging, template inventory, and the LSE round-trip pipeline.
+MCP (Model Context Protocol) server for hyperscript and multilingual DSL development. Provides **103 tools** by default (**108** defined — the 5 MCP-sampling tools are opt-in and hidden unless `LOKASCRIPT_MCP_LLM_TOOLS=1`), **9 resources**, and **9 prompts** spanning: GRAIL workflow orchestration, validation, compilation, analysis, patterns, LSP bridge, language profiles, code generation, route extraction, 9 domain DSLs, IR conversion, cross-domain dispatch, MCP sampling (opt-in), AI-assisted debugging, template inventory, and the LSE round-trip pipeline.
 
 ## The agent loop
 
@@ -80,7 +80,7 @@ See **[GRAIL.md](GRAIL.md)** for full documentation, schema reference, and examp
 
 ## Available Tools
 
-The **103** tools below, plus the **5** GRAIL tools above, total **108**.
+The **103** tools below, plus the **5** GRAIL tools above, total **108** defined. The 5 MCP-sampling tools among them are hidden from `tools/list` unless `LOKASCRIPT_MCP_LLM_TOOLS=1`, so a default connection sees **103**.
 
 ### Validation & Semantic Tools (8)
 

package/dist/index.js

@@ -2145,12 +2145,8 @@ function getAdapterBundle(languages) {
 }
 function getBundleConfig(commands, blocks, languages, positional, runtime = "auto") {
   const needsMultilingual = languages.length > 1 || languages.some((l) => l !== "en");
-  let bundle = "hyperfixi-lite.js";
-  let bundleSize = "1.9 KB";
-  if (blocks.length > 0 || positional) {
-    bundle = "hyperfixi-hybrid-complete.js";
-    bundleSize = "6.7 KB";
-  }
+  let bundle = "hyperfixi-hx.js";
+  let bundleSize = "21.5 KB";
   if (needsMultilingual) {
     bundle = "hyperfixi-multilingual.js";
     bundleSize = "250 KB";
@@ -2811,8 +2807,40 @@ try {
     "[mcp:lsp-bridge] @lokascript/framework not available \u2014 LSE bracket notation in hover disabled"
   );
 }
+var roleInferrer = null;
+try {
+  ({ schemaRoleInferrer: roleInferrer } = await import("@hyperfixi/core/multilingual"));
+} catch {
+  console.error(
+    "[mcp:lsp-bridge] @hyperfixi/core/multilingual not available \u2014 hover role inference limited to `set` and `go`"
+  );
+}
+function parseToInterchange(code) {
+  if (!astToolkit?.fromCoreAST || !parseFunction) return null;
+  const result = parseFunction(code);
+  const errors = Array.isArray(result?.errors) ? result.errors : [];
+  const ast = result?.node ?? null;
+  if (!ast || ast.type === "identifier" && ast.name === "__ERROR__") return { nodes: [], errors };
+  try {
+    const opts = roleInferrer ? { inferRoles: roleInferrer } : void 0;
+    const statements = ast.type === "Program" && Array.isArray(ast.statements) ? ast.statements : [ast];
+    const interchange = statements.flatMap((stmt) => {
+      const converted = astToolkit.fromCoreAST(stmt, opts);
+      return Array.isArray(converted) ? converted : [converted];
+    });
+    const nodes = interchange.filter(
+      // `fromCoreAST` emits an `error` node for a kind it cannot represent
+      // (`def`, `behavior`, …) rather than throwing. That is a converter limit,
+      // not a user error: it must not become a diagnostic or a hover.
+      (n) => n?.type !== "error"
+    );
+    return { nodes, errors };
+  } catch {
+    return { nodes: [], errors };
+  }
+}
 console.error(
-  `[mcp:lsp-bridge] capabilities: ast=${!!astToolkit}, parse=${!!parseFunction}, semantic=${!!semanticPackage2}, framework=${!!frameworkIR}`
+  `[mcp:lsp-bridge] capabilities: ast=${!!astToolkit}, parse=${!!parseFunction}, semantic=${!!semanticPackage2}, framework=${!!frameworkIR}, roles=${!!roleInferrer}`
 );
 var cachedAnalyzer2 = null;
 function getSemanticAnalyzer2() {
@@ -3036,12 +3064,25 @@ async function getDiagnostics(code, language, _uri) {
     } catch {
     }
   }
-  if (diagnostics.length === 0 && astToolkit && parseFunction) {
+  if (diagnostics.length === 0 && astToolkit?.interchangeToLSPDiagnostics && parseFunction) {
     try {
-      const ast = parseFunction(code);
-      if (ast && astToolkit.astToLSPDiagnostics) {
-        const astDiagnostics = astToolkit.astToLSPDiagnostics(ast);
-        diagnostics.push(...astDiagnostics);
+      const parsed = parseToInterchange(code);
+      for (const err of parsed?.errors ?? []) {
+        const line = Math.max(0, (err.line ?? 1) - 1);
+        const character = Math.max(0, err.column ?? 0);
+        diagnostics.push({
+          range: { start: { line, character }, end: { line, character: character + 10 } },
+          severity: 1,
+          // Error
+          code: "parse-error",
+          source: "hyperfixi-mcp",
+          message: err.message
+        });
+      }
+      if (parsed?.nodes.length) {
+        diagnostics.push(
+          ...astToolkit.interchangeToLSPDiagnostics(parsed.nodes, { source: "hyperfixi-mcp" })
+        );
       }
     } catch (parseError) {
       diagnostics.push({
@@ -3291,12 +3332,13 @@ function runSimpleDiagnostics(code, language = "en") {
 }
 async function getCompletions(code, line, character, language, context) {
   const completions = [];
-  if (astToolkit && parseFunction) {
+  if (astToolkit?.interchangeToLSPCompletions && parseFunction) {
     try {
-      const ast = parseFunction(code);
-      if (ast && astToolkit.astToLSPCompletions) {
-        const astCompletions = astToolkit.astToLSPCompletions(ast, { line, character });
-        completions.push(...astCompletions);
+      const parsed = parseToInterchange(code);
+      if (parsed?.nodes.length) {
+        completions.push(
+          ...astToolkit.interchangeToLSPCompletions(parsed.nodes, { line, character })
+        );
       }
     } catch {
     }
@@ -3453,10 +3495,9 @@ function inferContext(beforeCursor) {
 async function getHoverInfo(code, line, character, language) {
   if (astToolkit && parseFunction && astToolkit.fromCoreAST && astToolkit.interchangeToLSPHover) {
     try {
-      const ast = parseFunction(code);
-      if (ast) {
-        const interchange = astToolkit.fromCoreAST(ast);
-        const nodes = Array.isArray(interchange) ? interchange : [interchange];
+      const parsed = parseToInterchange(code);
+      if (parsed?.nodes.length) {
+        const nodes = parsed.nodes;
         const hoverOptions = {};
         if (frameworkIR) {
           hoverOptions.renderLSE = (node) => frameworkIR.renderExplicit(frameworkIR.fromInterchangeNode(node));
@@ -3579,12 +3620,11 @@ function getHoverDocumentation(word, language = "en") {
 }
 async function getDocumentSymbols(code, language) {
   const symbols = [];
-  if (astToolkit && parseFunction) {
+  if (astToolkit?.interchangeToLSPSymbols && parseFunction) {
     try {
-      const ast = parseFunction(code);
-      if (ast && astToolkit.astToLSPSymbols) {
-        const astSymbols = astToolkit.astToLSPSymbols(ast);
-        symbols.push(...astSymbols);
+      const parsed = parseToInterchange(code);
+      if (parsed?.nodes.length) {
+        symbols.push(...astToolkit.interchangeToLSPSymbols(parsed.nodes));
       }
     } catch {
     }
@@ -5621,12 +5661,15 @@ var compilationTools = [
   }
 ];
 var REPAIR_HINT = "Next step: apply the diagnostics above and re-run validate_and_compile. If an error names a code (e.g. MISSING.ARGUMENT), get_code_fixes returns concrete fixes for it; get_command_docs lists the roles each command accepts.";
+var REVIEW_HINT = "This parsed, but the diagnostics above are non-empty. A warning such as UNCONSUMED_INPUT means tokens were parsed but bound to no role, so a role may have fallen back to a default (often `me`) \u2014 the result can look valid while doing something other than you intended. Compare the returned action/roles/trigger against your intent before compiling; score_fidelity can prove a rewrite kept the original meaning.";
 function compileResult(result) {
   const content = [
     { type: "text", text: JSON.stringify(result, null, 2) }
   ];
   if (!result.ok) {
     content.push({ type: "text", text: REPAIR_HINT });
+  } else if (result.diagnostics?.some((d) => d.severity === "warning")) {
+    content.push({ type: "text", text: REVIEW_HINT });
   }
   return { content, isError: !result.ok };
 }
@@ -10567,6 +10610,7 @@ function readResource(uri) {
 var registry = createDomainRegistry();
 var { version: pkgVersion } = createRequire2(import.meta.url)("../package.json");
 var LLM_SAMPLING_ENABLED = process.env.LOKASCRIPT_MCP_LLM_TOOLS === "1";
+var SAMPLING_TOOL_NAMES = new Set(samplingTools.map((t) => t.name));
 var SERVER_INSTRUCTIONS = `Deterministic tooling for hyperscript (a compact DOM-behavior DSL) in 24 human languages. No tool here calls an LLM \u2014 every check is a real parser/compiler you can trust.
 
 The core loop for GENERATING hyperscript:
@@ -10633,7 +10677,7 @@ function buildServer() {
     if (stale.length > 0) {
       return staleToolError(stale);
     }
-    if (name.startsWith("analyze_") || name === "explain_code" || name === "recognize_intent") {
+    if (name.startsWith("analyze_") && !SAMPLING_TOOL_NAMES.has(name) || name === "explain_code" || name === "recognize_intent") {
       return handleAnalysisTool(name, args);
     }
     if (name === "search_patterns" || name === "translate_hyperscript" || name === "get_pattern_stats") {
@@ -10674,7 +10718,7 @@ function buildServer() {
     if (name === "extract_routes" || name === "generate_server_routes") {
       return handleRouteTool(name, args);
     }
-    if (name === "ask_claude" || name === "summarize_content" || name === "analyze_content" || name === "translate_content" || name === "execute_llm") {
+    if (SAMPLING_TOOL_NAMES.has(name)) {
       if (!LLM_SAMPLING_ENABLED) {
         return {
           content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixi/mcp-server",
-  "version": "2.11.1",
+  "version": "3.1.0",
   "description": "Model Context Protocol server for HyperFixi hyperscript development",
   "type": "module",
   "main": "dist/index.js",
@@ -37,22 +37,22 @@
   "author": "LokaScript Contributors",
   "license": "MIT",
   "dependencies": {
-    "@hyperfixi/patterns-reference": "^2.11.1",
-    "@lokascript/compilation-service": "^2.11.1",
+    "@hyperfixi/patterns-reference": "^3.1.0",
+    "@lokascript/compilation-service": "^3.1.0",
     "@lokascript/domains": "^2.11.1",
-    "@lokascript/framework": "^2.11.1",
-    "@lokascript/planner": "^2.11.1",
-    "@lokascript/semantic": "^2.11.1",
+    "@lokascript/framework": "^3.1.0",
+    "@lokascript/planner": "^3.1.0",
+    "@lokascript/semantic": "^3.1.0",
     "@modelcontextprotocol/server": "^2.0.0",
     "yaml": "^2.8.3"
   },
   "peerDependencies": {
-    "@hyperfixi/core": "^2.11.1",
-    "@hyperfixi/patterns-reference": "^2.11.1",
-    "@hyperfixi/server-bridge": "^2.11.1",
-    "@lokascript/compilation-service": "^2.11.1",
-    "@lokascript/framework": "^2.11.1",
-    "@lokascript/semantic": "^2.11.1"
+    "@hyperfixi/core": "^3.1.0",
+    "@hyperfixi/patterns-reference": "^3.1.0",
+    "@hyperfixi/server-bridge": "^3.1.0",
+    "@lokascript/compilation-service": "^3.1.0",
+    "@lokascript/framework": "^3.1.0",
+    "@lokascript/semantic": "^3.1.0"
   },
   "peerDependenciesMeta": {
     "@lokascript/compilation-service": {
@@ -75,12 +75,12 @@
     }
   },
   "devDependencies": {
-    "@hyperfixi/core": "^2.11.1",
-    "@hyperfixi/patterns-reference": "^2.11.1",
-    "@hyperfixi/server-bridge": "^2.11.1",
-    "@lokascript/compilation-service": "^2.11.1",
-    "@lokascript/framework": "^2.11.1",
-    "@lokascript/semantic": "^2.11.1",
+    "@hyperfixi/core": "^3.1.0",
+    "@hyperfixi/patterns-reference": "^3.1.0",
+    "@hyperfixi/server-bridge": "^3.1.0",
+    "@lokascript/compilation-service": "^3.1.0",
+    "@lokascript/framework": "^3.1.0",
+    "@lokascript/semantic": "^3.1.0",
     "@types/node": "^26.1.2",
     "tsup": "^8.0.0",
     "tsx": "^4.23.1",