@hyperfixi/mcp-server 2.7.2 → 2.9.0

package/dist/index.js

@@ -5,8 +5,109 @@ import {
 } from "./chunk-P76KH42G.js";
 
 // src/index.ts
+import { createRequire as createRequire2 } from "module";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/freshness.ts
+import { createRequire } from "module";
+import { statSync, existsSync, readdirSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var require_ = createRequire(import.meta.url);
+var WORKSPACE_SCOPES = ["@lokascript/", "@hyperfixi/"];
+var PROBE_TTL_MS = 1e3;
+var watched = [];
+var lastProbeAt = 0;
+var lastResult = [];
+function watchedPackages() {
+  const pkg = require_("../package.json");
+  const names = /* @__PURE__ */ new Set([
+    ...Object.keys(pkg.dependencies ?? {}),
+    ...Object.keys(pkg.peerDependencies ?? {})
+  ]);
+  return [...names].filter((n) => WORKSPACE_SCOPES.some((s) => n.startsWith(s))).sort();
+}
+function resolveMarker(name) {
+  try {
+    const url = import.meta.resolve(name);
+    const path = fileURLToPath(url);
+    return existsSync(path) ? path : null;
+  } catch {
+    return null;
+  }
+}
+function captureFreshnessBaseline() {
+  watched = watchedPackages().flatMap((pkg) => {
+    const marker = resolveMarker(pkg);
+    if (!marker) return [];
+    return [{ pkg, marker, loadedMtimeMs: statSync(marker).mtimeMs }];
+  });
+  lastProbeAt = 0;
+  lastResult = [];
+}
+function staleSinceStartup(now = Date.now()) {
+  if (now - lastProbeAt < PROBE_TTL_MS) return lastResult;
+  lastProbeAt = now;
+  lastResult = watched.filter((w) => {
+    try {
+      return statSync(w.marker).mtimeMs !== w.loadedMtimeMs;
+    } catch {
+      return true;
+    }
+  }).map((w) => w.pkg);
+  return lastResult;
+}
+function hasNewerTs(dir, builtAt) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const p = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (hasNewerTs(p, builtAt)) return true;
+    } else if (entry.name.endsWith(".ts") && statSync(p).mtimeMs > builtAt) {
+      return true;
+    }
+  }
+  return false;
+}
+function staleAtStartup() {
+  return watched.filter((w) => {
+    const srcDir = join(dirname(dirname(w.marker)), "src");
+    if (!existsSync(srcDir)) return false;
+    try {
+      return hasNewerTs(srcDir, statSync(w.marker).mtimeMs);
+    } catch {
+      return false;
+    }
+  }).map((w) => ({ pkg: w.pkg, dir: dirname(dirname(w.marker)) }));
+}
+function staleToolError(stale) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: `\u2717 This MCP server is serving STALE code and refused the call.
+
+  Rebuilt since the server started: ${stale.join(", ")}
+
+  The server resolves these packages' dist/ at startup and Node caches the module
+  graph, so it cannot pick up a rebuild without restarting. Any answer it gave now
+  would reflect the code as it was BEFORE the rebuild \u2014 silently.
+
+  Fix: restart the MCP server (in Claude Code: /mcp, then reconnect "lokascript").
+
+  If you are mid-arc and only need to probe the parser, prefer a direct tsx probe
+  (which imports fresh each run) over this server \u2014 see the probe recipe in
+  docs-internal/HANDOFF_foreign-validity-burndown.md.`
+      }
+    ],
+    isError: true
+  };
+}
+function freshnessSummary() {
+  return `watching ${watched.length} workspace dist entries`;
+}
+
+// src/index.ts
 import {
   CallToolRequestSchema,
   GetPromptRequestSchema,
@@ -5877,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 },
@@ -5976,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
       });
@@ -7977,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-YPGJSQ36.js");
+    const { glob } = await import("./esm-7SV6EOOG.js");
     const globs = [
       "**/*.html",
       "**/*.htm",
@@ -10134,6 +10244,7 @@ function getLSEProtocolSpec() {
 | Disabled flag | \`~name\` | \`~nullable\` |
 | String literal | \`"..."\` or \`'...'\` | \`patient:"hello world"\` |
 | Selector | \`#id\` \`.class\` \`[attr]\` \`@aria\` \`*wild\` | \`destination:#button\` |
+| Selector literal | \`<...selector.../>\` | \`patient:<ul > li/>\`, \`patient:<.a, .b/>\` |
 | Boolean | \`true\` / \`false\` | \`goal:true\` |
 | Number | digits with optional decimal | \`quantity:5\` |
 | Duration | number + suffix | \`delay:500ms\`, \`timeout:2s\` |
@@ -10141,15 +10252,22 @@ function getLSEProtocolSpec() {
 | Nested body | bracket command in value | \`body:[toggle patient:.active]\` |
 | Compound | chain operator between commands | \`[add ...] then [fetch ...]\` |
 
+A selector containing a space, a combinator (\`>\` \`+\` \`~\`), or a comma must use a
+selector literal \u2014 the tokenizer would otherwise split it. Inside a structural role
+(\`body\`, \`then\`, \`else\`, \`condition\`, \`loop-body\`, \`variable\`, \`catch\`, \`finally\`)
+a \`[...]\` value is always a nested command, so an attribute selector there must also
+use the literal form: \`condition:<[data-active]/>\`.
+
 ## Value Classification Priority (first match wins)
 
-1. **Selector** \u2014 starts with \`#\`, \`.\`, \`[\`, \`@\`, \`*\`
-2. **String** \u2014 starts with \`"\` or \`'\`
-3. **Boolean** \u2014 exact: \`true\` or \`false\`
-4. **Reference** \u2014 \`me\`, \`you\`, \`it\`, \`result\`, \`event\`, \`target\`, \`body\`
-5. **Duration** \u2014 number + \`ms\`/\`s\`/\`m\`/\`h\`
-6. **Number** \u2014 integer or decimal
-7. **Plain** \u2014 fallback (any non-whitespace)
+1. **Selector literal** \u2014 starts with \`<\` and ends with \`/>\`; delimiters stripped
+2. **Selector** \u2014 starts with \`#\`, \`.\`, \`[\`, \`@\`, \`*\`
+3. **String** \u2014 starts with \`"\` or \`'\`
+4. **Boolean** \u2014 exact: \`true\` or \`false\`
+5. **Reference** \u2014 \`me\`, \`you\`, \`it\`, \`result\`, \`event\`, \`target\`, \`body\`
+6. **Duration** \u2014 number + \`ms\`/\`s\`/\`m\`/\`h\`
+7. **Number** \u2014 integer or decimal
+8. **Plain** \u2014 fallback (any non-whitespace)
 
 ## Node Kinds
 
@@ -10388,10 +10506,11 @@ function readResource(uri) {
 
 // src/index.ts
 var registry = createDomainRegistry();
+var { version: pkgVersion } = createRequire2(import.meta.url)("../package.json");
 var server = new Server(
   {
     name: "@hyperfixi/mcp-server",
-    version: "1.0.0"
+    version: pkgVersion
   },
   {
     capabilities: {
@@ -10428,6 +10547,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 });
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
+  const stale = staleSinceStartup();
+  if (stale.length > 0) {
+    return staleToolError(stale);
+  }
   if (name.startsWith("analyze_") || name === "explain_code" || name === "recognize_intent") {
     return handleAnalysisTool(name, args);
   }
@@ -10484,7 +10607,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   if (name === "lse_validate_and_feedback" || name === "lse_pattern_stats") {
     return handleFeedbackTool(name, args);
   }
-  if (name === "lse_from_hyperscript" || name === "lse_to_hyperscript") {
+  if (name === "lse_from_hyperscript" || name === "lse_to_hyperscript" || name === "execute_lse" || name === "validate_lse" || name === "translate_lse") {
     return handleLsePipelineTool(name, args);
   }
   if (name.startsWith("grail_")) {
@@ -10529,9 +10652,19 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
   return readResource(uri);
 });
 async function main() {
+  captureFreshnessBaseline();
+  const bornStale = staleAtStartup();
+  if (bornStale.length > 0) {
+    console.error(
+      `\u26A0 MCP server started against a STALE dist/ in: ${bornStale.map((s) => s.pkg).join(", ")} \u2014
+  src/ is newer than the built output, so answers will reflect the last build, not the
+  checkout. Rebuild, then restart this server:
+` + bornStale.map((s) => `    npm run build --prefix ${s.dir}`).join("\n")
+    );
+  }
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("HyperFixi MCP server started");
+  console.error(`HyperFixi MCP server started (${freshnessSummary()})`);
 }
 main().catch((error) => {
   console.error("Failed to start MCP server:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixi/mcp-server",
-  "version": "2.7.2",
+  "version": "2.9.0",
   "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.7.2",
-    "@lokascript/compilation-service": "^2.7.2",
-    "@lokascript/domain-config": "^2.7.2",
-    "@lokascript/framework": "^2.7.2",
-    "@lokascript/planner": "^2.7.2",
-    "@lokascript/semantic": "^2.7.2",
+    "@hyperfixi/patterns-reference": "^2.9.0",
+    "@lokascript/compilation-service": "^2.9.0",
+    "@lokascript/domain-config": "^2.9.0",
+    "@lokascript/framework": "^2.9.0",
+    "@lokascript/planner": "^2.9.0",
+    "@lokascript/semantic": "^2.9.0",
     "@modelcontextprotocol/sdk": "^1.25.0",
     "yaml": "^2.8.3"
   },
   "peerDependencies": {
-    "@hyperfixi/core": "^2.7.2",
-    "@hyperfixi/patterns-reference": "^2.7.2",
-    "@hyperfixi/server-bridge": "^2.7.2",
-    "@lokascript/compilation-service": "^2.7.2",
-    "@lokascript/domain-bdd": "^2.7.2",
-    "@lokascript/domain-behaviorspec": "^2.7.2",
-    "@lokascript/domain-flow": "^2.7.2",
-    "@lokascript/domain-jsx": "^2.7.2",
-    "@lokascript/domain-learn": "^2.7.2",
-    "@lokascript/domain-llm": "^2.7.2",
-    "@lokascript/domain-sql": "^2.7.2",
-    "@lokascript/domain-todo": "^2.7.2",
-    "@lokascript/domain-voice": "^2.7.2",
-    "@lokascript/framework": "^2.7.2",
-    "@lokascript/semantic": "^2.7.2"
+    "@hyperfixi/core": "^2.9.0",
+    "@hyperfixi/patterns-reference": "^2.9.0",
+    "@hyperfixi/server-bridge": "^2.9.0",
+    "@lokascript/compilation-service": "^2.9.0",
+    "@lokascript/domain-bdd": "^2.9.0",
+    "@lokascript/domain-behaviorspec": "^2.9.0",
+    "@lokascript/domain-flow": "^2.9.0",
+    "@lokascript/domain-jsx": "^2.9.0",
+    "@lokascript/domain-learn": "^2.9.0",
+    "@lokascript/domain-llm": "^2.9.0",
+    "@lokascript/domain-sql": "^2.9.0",
+    "@lokascript/domain-todo": "^2.9.0",
+    "@lokascript/domain-voice": "^2.9.0",
+    "@lokascript/framework": "^2.9.0",
+    "@lokascript/semantic": "^2.9.0"
   },
   "peerDependenciesMeta": {
     "@lokascript/compilation-service": {
@@ -111,29 +111,30 @@
     }
   },
   "devDependencies": {
-    "@hyperfixi/core": "^2.7.2",
-    "@hyperfixi/patterns-reference": "^2.7.2",
-    "@hyperfixi/server-bridge": "^2.7.2",
-    "@lokascript/compilation-service": "^2.7.2",
-    "@lokascript/domain-bdd": "^2.7.2",
-    "@lokascript/domain-behaviorspec": "^2.7.2",
-    "@lokascript/domain-flow": "^2.7.2",
-    "@lokascript/domain-jsx": "^2.7.2",
-    "@lokascript/domain-learn": "^2.7.2",
-    "@lokascript/domain-llm": "^2.7.2",
-    "@lokascript/domain-sql": "^2.7.2",
-    "@lokascript/domain-todo": "^2.7.2",
-    "@lokascript/domain-voice": "^2.7.2",
-    "@lokascript/framework": "^2.7.2",
-    "@lokascript/semantic": "^2.7.2",
+    "@hyperfixi/core": "^2.9.0",
+    "@hyperfixi/patterns-reference": "^2.9.0",
+    "@hyperfixi/server-bridge": "^2.9.0",
+    "@lokascript/compilation-service": "^2.9.0",
+    "@lokascript/domain-bdd": "^2.9.0",
+    "@lokascript/domain-behaviorspec": "^2.9.0",
+    "@lokascript/domain-flow": "^2.9.0",
+    "@lokascript/domain-jsx": "^2.9.0",
+    "@lokascript/domain-learn": "^2.9.0",
+    "@lokascript/domain-llm": "^2.9.0",
+    "@lokascript/domain-sql": "^2.9.0",
+    "@lokascript/domain-todo": "^2.9.0",
+    "@lokascript/domain-voice": "^2.9.0",
+    "@lokascript/framework": "^2.9.0",
+    "@lokascript/semantic": "^2.9.0",
     "@types/node": "^20.0.0",
     "tsup": "^8.0.0",
-    "tsx": "^4.0.0",
+    "tsx": "^4.23.1",
     "typescript": "^5.0.0",
     "vitest": "^4.1.5"
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "publishConfig": {
     "access": "public"