@hyperfixi/mcp-server 2.8.0 → 2.9.1

package/CHANGELOG.md

@@ -0,0 +1,156 @@
+# Changelog
+
+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).
+
+## [Unreleased]
+
+### Fixed
+
+- **Dispatch:** `execute_lse`, `validate_lse`, and `translate_lse` were advertised
+  in `ListTools` and implemented in `handleLsePipelineTool`, but the `CallTool`
+  router only forwarded two of the five LSE-pipeline tools — the three LSE 2.0
+  tools returned `Unknown tool` when called. All five now route.
+- **Server version:** the MCP `serverInfo.version` was hardcoded to `1.0.0` for
+  the entire 2.x line; it now reads from `package.json`, so it can't drift on
+  release bumps.
+
+### Changed
+
+- README refreshed to match the implementation: tool count 80 → **107**,
+  resources 5 → **9**, prompts 3 → **9**, domains 8 → **9** (adds `learn`),
+  corrected per-domain language tiers, and documented previously-omitted tool
+  families (debug, inventory, training-data, feedback, LSE pipeline/correction,
+  and the three additional IR/envelope tools).
+
+## [2.7.2] - 2026-07-08
+
+Consolidated summary of the 2.x line (2.0.0 shipped 2026-02-11). Patch releases
+tracked the monorepo-wide version; the highlights relevant to this package:
+
+### Added
+
+- **GRAIL workflow tools (5)** — `grail_check` / `grail_plan` / `grail_run` /
+  `grail_info` / `grail_list` for Claude-native workflow orchestration.
+- **LSE round-trip pipeline** — `lse_from_hyperscript`, `lse_to_hyperscript`,
+  plus the LSE 2.0 LLM-native tools `execute_lse` / `validate_lse` /
+  `translate_lse` (#624).
+- **`learn` domain** — 9th domain DSL (language-learning sentence patterns),
+  bringing generated domain tools to 36.
+- **Cross-domain dispatch** — `detect_domain`, `compile_auto`, `parse_composite`,
+  `compile_composite`.
+- **AI-assisted debugging** (`debug_*`), **template inventory**
+  (`scan_inventory` / `query_inventory`), and **training-data** / **feedback-loop**
+  tools.
+- IR/envelope tools `validate_protocol`, `to_envelope`, `from_envelope`.
+
+### Changed
+
+- Domain language coverage widened to the 11-language "bridge" set for
+  sql/jsx/todo/llm/flow/voice (bdd/behaviorspec remain 8, learn is 10) via the
+  bridge arc (#615).
+- Domain registration extracted to the shared `@lokascript/domain-config`
+  package; `domain-registry-setup.ts` is now a re-export shim.
+- Package scope settled as `@hyperfixi/mcp-server` (engine packages publish under
+  `@hyperfixi/*`, multilingual packages under `@lokascript/*`).
+
+Tool count grew from 22 (1.0.0) to **107** across this line.
+
+## [1.0.0] - 2025-01-19
+
+### Added
+
+- Model Context Protocol server for LLM integration
+- 22 tools for hyperscript development assistance
+- 5 resources for documentation and examples
+- Full multilingual support (23 languages)
+- LSP-compatible features (diagnostics, completions, hover info)
+- Code analysis and complexity metrics
+- Pattern database search and lookup
+- Semantic parsing and translation
+- Schema validation for command designs
+- Language profile management
+- Expression documentation
+- Command documentation with usage examples
+- Keyword translation lookup across languages
+- Auto-fix suggestions for common errors
+- Best practices recommendations
+- Natural language intent recognition
+
+### Tools Provided
+
+1. `analyze_complexity` - Calculate cyclomatic, cognitive, Halstead metrics
+2. `analyze_metrics` - Comprehensive code quality analysis
+3. `explain_code` - Natural language explanations (beginner/intermediate/expert)
+4. `recognize_intent` - Understand code purpose and classify patterns
+5. `get_examples` - Few-shot learning examples for tasks
+6. `search_patterns` - Pattern database queries
+7. `translate_hyperscript` - Between-language translation
+8. `get_pattern_stats` - Database statistics
+9. `validate_hyperscript` - Syntax validation
+10. `validate_schema` - Command schema validation
+11. `suggest_command` - Best command recommendations
+12. `get_bundle_config` - vite-plugin configuration
+13. `parse_multilingual` - Parse any supported language
+14. `translate_to_english` - Essential for LLM understanding
+15. `explain_in_language` - Detailed explanations in target language
+16. `get_code_fixes` - Auto-fix suggestions
+17. `get_diagnostics` - LSP-compatible diagnostics
+18. `get_completions` - Context-aware code completions
+19. `get_hover_info` - Hover documentation
+20. `get_document_symbols` - Extract symbols for outline view
+21. `get_command_docs` - Command documentation
+22. `get_expression_docs` - Expression documentation
+
+### Resources Provided
+
+1. Command registry - All available commands
+2. Expression types - All expression types
+3. Language elements - Searchable language features
+4. Language profiles - Complete grammar rules
+5. Supported languages - Metadata for 23 languages
+
+### Usage
+
+```bash
+# Start server
+npx @lokascript/mcp-server
+
+# Configure in Claude Desktop
+{
+  "mcpServers": {
+    "lokascript": {
+      "command": "npx",
+      "args": ["@lokascript/mcp-server"]
+    }
+  }
+}
+```
+
+### Features
+
+- Fully typed with TypeScript
+- Comprehensive error handling
+- Detailed logging for debugging
+- LaunchAgent support for macOS
+- Works with Claude Desktop, VSCode, and other MCP clients
+
+### Performance
+
+- Fast response times (< 100ms for most operations)
+- In-memory pattern database for quick lookup
+- Efficient semantic parsing with caching
+
+### Compatibility
+
+- MCP SDK 1.25+
+- Node.js 18+
+- Works with all MCP-compatible clients
+
+### Notes
+
+- This is the first stable 1.0 release
+- API is stable and production-ready
+- Used extensively in LokaScript development workflow

package/dist/{esm-65HZKQ6R.js → esm-7SV6EOOG.js}

@@ -68,6 +68,7 @@ var closePattern = /\\}/g;
 var commaPattern = /\\,/g;
 var periodPattern = /\\\./g;
 var EXPANSION_MAX = 1e5;
+var EXPANSION_MAX_LENGTH = 4e6;
 function numeric(str) {
   return !isNaN(str) ? parseInt(str, 10) : str.charCodeAt(0);
 }
@@ -102,11 +103,11 @@ function expand(str, options = {}) {
   if (!str) {
     return [];
   }
-  const { max = EXPANSION_MAX } = options;
+  const { max = EXPANSION_MAX, maxLength = EXPANSION_MAX_LENGTH } = options;
   if (str.slice(0, 2) === "{}") {
     str = "\\{\\}" + str.slice(2);
   }
-  return expand_(escapeBraces(str), max, true).map(unescapeBraces);
+  return expand_(escapeBraces(str), max, maxLength, true).map(unescapeBraces);
 }
 function embrace(str) {
   return "{" + str + "}";
@@ -120,20 +121,83 @@ function lte(i, y) {
 function gte(i, y) {
   return i >= y;
 }
-function expand_(str, max, isTop) {
-  const expansions = [];
+function combine(acc, pre, values, max, maxLength, dropEmpties) {
+  const out = [];
+  let length = 0;
+  for (let a = 0; a < acc.length; a++) {
+    for (let v = 0; v < values.length; v++) {
+      if (out.length >= max)
+        return out;
+      const expansion = acc[a] + pre + values[v];
+      if (dropEmpties && !expansion)
+        continue;
+      if (length + expansion.length > maxLength)
+        return out;
+      out.push(expansion);
+      length += expansion.length;
+    }
+  }
+  return out;
+}
+function expandSequence(body, isAlphaSequence, max) {
+  const n = body.split(/\.\./);
+  const N = [];
+  if (n[0] === void 0 || n[1] === void 0) {
+    return N;
+  }
+  const x = numeric(n[0]);
+  const y = numeric(n[1]);
+  const width = Math.max(n[0].length, n[1].length);
+  let incr = n.length === 3 && n[2] !== void 0 ? Math.max(Math.abs(numeric(n[2])), 1) : 1;
+  let test = lte;
+  const reverse = y < x;
+  if (reverse) {
+    incr *= -1;
+    test = gte;
+  }
+  const pad = n.some(isPadded);
+  for (let i = x; test(i, y) && N.length < max; i += incr) {
+    let c;
+    if (isAlphaSequence) {
+      c = String.fromCharCode(i);
+      if (c === "\\") {
+        c = "";
+      }
+    } else {
+      c = String(i);
+      if (pad) {
+        const need = width - c.length;
+        if (need > 0) {
+          const z = new Array(need + 1).join("0");
+          if (i < 0) {
+            c = "-" + z + c.slice(1);
+          } else {
+            c = z + c;
+          }
+        }
+      }
+    }
+    N.push(c);
+  }
+  return N;
+}
+function expand_(str, max, maxLength, isTop) {
+  let acc = [""];
+  let dropEmpties = false;
+  let firstGroup = true;
   for (; ; ) {
     const m = balanced("{", "}", str);
-    if (!m)
-      return [str];
+    if (!m) {
+      return combine(acc, str, [""], max, maxLength, dropEmpties);
+    }
     const pre = m.pre;
-    if (/\$$/.test(m.pre)) {
-      const post2 = m.post.length ? expand_(m.post, max, false) : [""];
-      for (let k = 0; k < post2.length && k < max; k++) {
-        const expansion = pre + "{" + m.body + "}" + post2[k];
-        expansions.push(expansion);
-      }
-      return expansions;
+    if (/\$$/.test(pre)) {
+      acc = combine(acc, pre + "{" + m.body + "}", [""], max, maxLength, dropEmpties && !m.post.length);
+      firstGroup = false;
+      if (!m.post.length)
+        break;
+      str = m.post;
+      continue;
     }
     const isNumericSequence = /^-?\d+\.\.-?\d+(?:\.\.-?\d+)?$/.test(m.body);
     const isAlphaSequence = /^[a-zA-Z]\.\.[a-zA-Z](?:\.\.-?\d+)?$/.test(m.body);
@@ -145,74 +209,38 @@ function expand_(str, max, isTop) {
         isTop = true;
         continue;
       }
-      return [str];
+      return combine(acc, pre + "{" + m.body + "}" + m.post, [""], max, maxLength, dropEmpties);
     }
-    const post = m.post.length ? expand_(m.post, max, false) : [""];
-    let n;
+    if (firstGroup) {
+      dropEmpties = isTop && !isSequence;
+      firstGroup = false;
+    }
+    let values;
     if (isSequence) {
-      n = m.body.split(/\.\./);
+      values = expandSequence(m.body, isAlphaSequence, max);
     } else {
-      n = parseCommaParts(m.body);
+      let n = parseCommaParts(m.body);
       if (n.length === 1 && n[0] !== void 0) {
-        n = expand_(n[0], max, false).map(embrace);
+        n = expand_(n[0], max, maxLength, false).map(embrace);
         if (n.length === 1) {
-          return post.map((p) => m.pre + n[0] + p);
-        }
-      }
-    }
-    let N;
-    if (isSequence && n[0] !== void 0 && n[1] !== void 0) {
-      const x = numeric(n[0]);
-      const y = numeric(n[1]);
-      const width = Math.max(n[0].length, n[1].length);
-      let incr = n.length === 3 && n[2] !== void 0 ? Math.max(Math.abs(numeric(n[2])), 1) : 1;
-      let test = lte;
-      const reverse = y < x;
-      if (reverse) {
-        incr *= -1;
-        test = gte;
-      }
-      const pad = n.some(isPadded);
-      N = [];
-      for (let i = x; test(i, y) && N.length < max; i += incr) {
-        let c;
-        if (isAlphaSequence) {
-          c = String.fromCharCode(i);
-          if (c === "\\") {
-            c = "";
-          }
-        } else {
-          c = String(i);
-          if (pad) {
-            const need = width - c.length;
-            if (need > 0) {
-              const z = new Array(need + 1).join("0");
-              if (i < 0) {
-                c = "-" + z + c.slice(1);
-              } else {
-                c = z + c;
-              }
-            }
-          }
+          acc = combine(acc, pre + n[0], [""], max, maxLength, dropEmpties && !m.post.length);
+          if (!m.post.length)
+            break;
+          str = m.post;
+          continue;
         }
-        N.push(c);
       }
-    } else {
-      N = [];
+      values = [];
       for (let j2 = 0; j2 < n.length; j2++) {
-        N.push.apply(N, expand_(n[j2], max, false));
+        values.push.apply(values, expand_(n[j2], max, maxLength, false));
       }
     }
-    for (let j2 = 0; j2 < N.length; j2++) {
-      for (let k = 0; k < post.length && expansions.length < max; k++) {
-        const expansion = pre + N[j2] + post[k];
-        if (!isTop || isSequence || expansion) {
-          expansions.push(expansion);
-        }
-      }
-    }
-    return expansions;
+    acc = combine(acc, pre, values, max, maxLength, dropEmpties && !m.post.length);
+    if (!m.post.length)
+      break;
+    str = m.post;
   }
+  return acc;
 }
 
 // ../../node_modules/minimatch/dist/esm/assert-valid-pattern.js

package/dist/index.js

@@ -5978,7 +5978,7 @@ async function handleBDDMultiStep(name, args) {
       let rendered = null;
       if (renderer) {
         const renderedSteps = result.steps.map((step) => renderer(step, to));
-        rendered = renderedSteps.join("\n");
+        rendered = renderedSteps.every((step) => step != null) ? renderedSteps.join("\n") : null;
       }
       return jsonResponse({
         input: { scenario, language: from },
@@ -6077,23 +6077,32 @@ async function handleBehaviorSpecMultiLine(name, args) {
       if (!from || !to) return errorResponse("Missing required parameter: from, to");
       const result = parseSpec(scenario, from);
       const renderedTests = [];
+      let complete = true;
+      const renderLine = (node, indent) => {
+        const line = render(node, to);
+        if (line == null) {
+          complete = false;
+          return;
+        }
+        lines.push(`${indent}${line}`);
+      };
+      let lines = [];
       for (const test of result.tests) {
-        const lines = [];
-        lines.push(`test "${test.name}"`);
+        lines = [`test "${test.name}"`];
         for (const given of test.givens) {
-          lines.push(`  ${render(given, to)}`);
+          renderLine(given, "  ");
         }
         for (const interaction of test.interactions) {
-          lines.push(`  ${render(interaction.when, to)}`);
+          renderLine(interaction.when, "  ");
           for (const exp of interaction.expectations) {
-            lines.push(`    ${render(exp.node, to)}`);
+            renderLine(exp.node, "    ");
           }
         }
         renderedTests.push(lines.join("\n"));
       }
       return jsonResponse({
         input: { scenario, language: from },
-        translated: renderedTests.join("\n\n"),
+        translated: complete ? renderedTests.join("\n\n") : null,
         playwright: compile(scenario, from),
         errors: result.errors
       });
@@ -8078,7 +8087,7 @@ function createInlineExtractor() {
     const fs = await import("fs");
     const path = await import("path");
     const crypto = await import("crypto");
-    const { glob } = await import("./esm-65HZKQ6R.js");
+    const { glob } = await import("./esm-7SV6EOOG.js");
     const globs = [
       "**/*.html",
       "**/*.htm",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixi/mcp-server",
-  "version": "2.8.0",
+  "version": "2.9.1",
   "description": "Model Context Protocol server for HyperFixi hyperscript development",
   "type": "module",
   "main": "dist/index.js",
@@ -37,31 +37,31 @@
   "author": "LokaScript Contributors",
   "license": "MIT",
   "dependencies": {
-    "@hyperfixi/patterns-reference": "^2.8.0",
-    "@lokascript/compilation-service": "^2.8.0",
-    "@lokascript/domain-config": "^2.8.0",
-    "@lokascript/framework": "^2.8.0",
-    "@lokascript/planner": "^2.8.0",
-    "@lokascript/semantic": "^2.8.0",
+    "@hyperfixi/patterns-reference": "^2.9.1",
+    "@lokascript/compilation-service": "^2.9.1",
+    "@lokascript/domain-config": "^2.9.1",
+    "@lokascript/framework": "^2.9.1",
+    "@lokascript/planner": "^2.9.1",
+    "@lokascript/semantic": "^2.9.1",
     "@modelcontextprotocol/sdk": "^1.25.0",
     "yaml": "^2.8.3"
   },
   "peerDependencies": {
-    "@hyperfixi/core": "^2.8.0",
-    "@hyperfixi/patterns-reference": "^2.8.0",
-    "@hyperfixi/server-bridge": "^2.8.0",
-    "@lokascript/compilation-service": "^2.8.0",
-    "@lokascript/domain-bdd": "^2.8.0",
-    "@lokascript/domain-behaviorspec": "^2.8.0",
-    "@lokascript/domain-flow": "^2.8.0",
-    "@lokascript/domain-jsx": "^2.8.0",
-    "@lokascript/domain-learn": "^2.8.0",
-    "@lokascript/domain-llm": "^2.8.0",
-    "@lokascript/domain-sql": "^2.8.0",
-    "@lokascript/domain-todo": "^2.8.0",
-    "@lokascript/domain-voice": "^2.8.0",
-    "@lokascript/framework": "^2.8.0",
-    "@lokascript/semantic": "^2.8.0"
+    "@hyperfixi/core": "^2.9.1",
+    "@hyperfixi/patterns-reference": "^2.9.1",
+    "@hyperfixi/server-bridge": "^2.9.1",
+    "@lokascript/compilation-service": "^2.9.1",
+    "@lokascript/domain-bdd": "^2.9.1",
+    "@lokascript/domain-behaviorspec": "^2.9.1",
+    "@lokascript/domain-flow": "^2.9.1",
+    "@lokascript/domain-jsx": "^2.9.1",
+    "@lokascript/domain-learn": "^2.9.1",
+    "@lokascript/domain-llm": "^2.9.1",
+    "@lokascript/domain-sql": "^2.9.1",
+    "@lokascript/domain-todo": "^2.9.1",
+    "@lokascript/domain-voice": "^2.9.1",
+    "@lokascript/framework": "^2.9.1",
+    "@lokascript/semantic": "^2.9.1"
   },
   "peerDependenciesMeta": {
     "@lokascript/compilation-service": {
@@ -111,21 +111,21 @@
     }
   },
   "devDependencies": {
-    "@hyperfixi/core": "^2.8.0",
-    "@hyperfixi/patterns-reference": "^2.8.0",
-    "@hyperfixi/server-bridge": "^2.8.0",
-    "@lokascript/compilation-service": "^2.8.0",
-    "@lokascript/domain-bdd": "^2.8.0",
-    "@lokascript/domain-behaviorspec": "^2.8.0",
-    "@lokascript/domain-flow": "^2.8.0",
-    "@lokascript/domain-jsx": "^2.8.0",
-    "@lokascript/domain-learn": "^2.8.0",
-    "@lokascript/domain-llm": "^2.8.0",
-    "@lokascript/domain-sql": "^2.8.0",
-    "@lokascript/domain-todo": "^2.8.0",
-    "@lokascript/domain-voice": "^2.8.0",
-    "@lokascript/framework": "^2.8.0",
-    "@lokascript/semantic": "^2.8.0",
+    "@hyperfixi/core": "^2.9.1",
+    "@hyperfixi/patterns-reference": "^2.9.1",
+    "@hyperfixi/server-bridge": "^2.9.1",
+    "@lokascript/compilation-service": "^2.9.1",
+    "@lokascript/domain-bdd": "^2.9.1",
+    "@lokascript/domain-behaviorspec": "^2.9.1",
+    "@lokascript/domain-flow": "^2.9.1",
+    "@lokascript/domain-jsx": "^2.9.1",
+    "@lokascript/domain-learn": "^2.9.1",
+    "@lokascript/domain-llm": "^2.9.1",
+    "@lokascript/domain-sql": "^2.9.1",
+    "@lokascript/domain-todo": "^2.9.1",
+    "@lokascript/domain-voice": "^2.9.1",
+    "@lokascript/framework": "^2.9.1",
+    "@lokascript/semantic": "^2.9.1",
     "@types/node": "^20.0.0",
     "tsup": "^8.0.0",
     "tsx": "^4.23.1",
@@ -133,7 +133,8 @@
     "vitest": "^4.1.5"
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "publishConfig": {
     "access": "public"