@hyperfixi/mcp-server 2.11.0 → 3.0.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,16 @@ 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`"
+  );
+}
 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() {
@@ -3455,7 +3459,10 @@ async function getHoverInfo(code, line, character, language) {
     try {
       const ast = parseFunction(code);
       if (ast) {
-        const interchange = astToolkit.fromCoreAST(ast);
+        const interchange = astToolkit.fromCoreAST(
+          ast,
+          roleInferrer ? { inferRoles: roleInferrer } : void 0
+        );
         const nodes = Array.isArray(interchange) ? interchange : [interchange];
         const hoverOptions = {};
         if (frameworkIR) {
@@ -5621,12 +5628,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 +10577,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 +10644,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 +10685,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.0",
+  "version": "3.0.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.0",
-    "@lokascript/compilation-service": "^2.11.0",
+    "@hyperfixi/patterns-reference": "^3.0.0",
+    "@lokascript/compilation-service": "^3.0.0",
     "@lokascript/domains": "^2.11.1",
-    "@lokascript/framework": "^2.11.0",
-    "@lokascript/planner": "^2.11.0",
-    "@lokascript/semantic": "^2.11.0",
+    "@lokascript/framework": "^3.0.0",
+    "@lokascript/planner": "^3.0.0",
+    "@lokascript/semantic": "^3.0.0",
     "@modelcontextprotocol/server": "^2.0.0",
     "yaml": "^2.8.3"
   },
   "peerDependencies": {
-    "@hyperfixi/core": "^2.11.0",
-    "@hyperfixi/patterns-reference": "^2.11.0",
-    "@hyperfixi/server-bridge": "^2.11.0",
-    "@lokascript/compilation-service": "^2.11.0",
-    "@lokascript/framework": "^2.11.0",
-    "@lokascript/semantic": "^2.11.0"
+    "@hyperfixi/core": "^3.0.0",
+    "@hyperfixi/patterns-reference": "^3.0.0",
+    "@hyperfixi/server-bridge": "^3.0.0",
+    "@lokascript/compilation-service": "^3.0.0",
+    "@lokascript/framework": "^3.0.0",
+    "@lokascript/semantic": "^3.0.0"
   },
   "peerDependenciesMeta": {
     "@lokascript/compilation-service": {
@@ -75,12 +75,12 @@
     }
   },
   "devDependencies": {
-    "@hyperfixi/core": "^2.11.0",
-    "@hyperfixi/patterns-reference": "^2.11.0",
-    "@hyperfixi/server-bridge": "^2.11.0",
-    "@lokascript/compilation-service": "^2.11.0",
-    "@lokascript/framework": "^2.11.0",
-    "@lokascript/semantic": "^2.11.0",
+    "@hyperfixi/core": "^3.0.0",
+    "@hyperfixi/patterns-reference": "^3.0.0",
+    "@hyperfixi/server-bridge": "^3.0.0",
+    "@lokascript/compilation-service": "^3.0.0",
+    "@lokascript/framework": "^3.0.0",
+    "@lokascript/semantic": "^3.0.0",
     "@types/node": "^26.1.2",
     "tsup": "^8.0.0",
     "tsx": "^4.23.1",