@qe-mcp/server-ena 0.1.1 → 0.1.2

package/.gitlab-ci.yml

@@ -60,7 +60,8 @@ verify-tag-version:
   script:
     - |
       TAG_VERSION="${CI_COMMIT_TAG#v}"
-      PKG_VERSION=$(node -e "console.log(require('./package.json').version)")
+      # Parse with sed — the template's alpine image has no node
+      PKG_VERSION=$(sed -n 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' package.json | head -1)
       if [ "${TAG_VERSION}" != "${PKG_VERSION}" ]; then
         echo "-----------------------------------------------------------"
         echo "  Tag/package.json mismatch — release blocked"

package/README.md

@@ -30,6 +30,8 @@ Gives Claude a set of ENA tools that run **locally on your machine**. The WASM m
 
 ## Installation
 
+The package is published to the public npm registry — no registry configuration needed.
+
 ### Option A — npx (no install needed)
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac):
@@ -39,24 +41,17 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac):
   "mcpServers": {
     "ena": {
       "command": "npx",
-      "args": ["@qe-mcp/server-ena"]
+      "args": ["--yes", "@qe-mcp/server-ena"]
     }
   }
 }
 ```
 
-Then add the registry to your `~/.npmrc` once:
-
-```bash
-echo "@qe-mcp:registry=https://gitlab.com/api/v4/projects/22522458/packages/npm/" >> ~/.npmrc
-```
-
 Restart Claude Desktop.
 
 ### Option B — global install
 
 ```bash
-echo "@qe-mcp:registry=https://gitlab.com/api/v4/projects/22522458/packages/npm/" >> ~/.npmrc
 npm install -g @qe-mcp/server-ena
 ```
 
@@ -91,6 +86,17 @@ npm install
 }
 ```
 
+### Dev builds
+
+Pre-release builds are published only to the QE GitLab registry with a `dev` tag.
+To use one, add the scope mapping once and pin `@dev`:
+
+```bash
+echo "@qe-mcp:registry=https://gitlab.com/api/v4/projects/22522458/packages/npm/" >> ~/.npmrc
+echo "@qe-libs:registry=https://gitlab.com/api/v4/projects/22522458/packages/npm/" >> ~/.npmrc
+npx --yes @qe-mcp/server-ena@dev
+```
+
 ### Verify
 
 In Claude Desktop, open a new conversation and ask:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qe-mcp/server-ena",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MCP server for Epistemic Network Analysis — WASM backend, zero Python dependency",
   "type": "module",
   "main": "server.js",

package/server.js

@@ -1145,9 +1145,69 @@ const server = new Server(
     { capabilities: { tools: {} } }
 );
 
+// ── rena-wasm API adapter ─────────────────────────────────────────────────────
+// rena-wasm ≥ the R-mirroring rewrite returns an R-style ENA set object
+// (lineWeights / points / rotation.nodes / model.unitLabels) instead of the
+// original flat object (networks / centroids / positions / unitLabels).
+// These shims expose the flat field names this server is written against, and
+// are idempotent no-ops on the older flat API.
+
+function adaptModel(m) {
+    if (!m || m.networks !== undefined || m.lineWeights === undefined) return m;
+    return {
+        networks:        m.lineWeights,          // sphere-normed adjacency (nUnits × nConn)
+        centroids:       m.points,               // projected unit positions (nUnits × dims)
+        positions:       m.rotation?.nodes,      // code node positions (nCodes × dims)
+        connectionNames: m.connectionNames,
+        unitLabels:      m.model?.unitLabels ?? m.unitLabels,
+        columnNames:     m.rotation?.columnNames,
+        eigenvalues:     m.rotation?.eigenvalues,
+        nUnits:          m.nUnits,
+        nConnections:    m.nConnections,
+        dims:            m.dims,
+    };
+}
+
+function adaptAccum(a) {
+    if (!a || a.networks !== undefined || a.connectionCounts === undefined) return a;
+    return { ...a, networks: a.connectionCounts };
+}
+
+// A WASM abort (raised by libqe on a degenerate SVD / means rotation) leaves the
+// module instance unusable — every later call would also abort. Detect it,
+// discard the cached instance so the next call reloads a fresh one, and surface
+// an actionable message instead of the raw "Aborted(undefined)".
+function isWasmAbort(e) {
+    return /abort|RuntimeError|out of bounds|memory access|table index/i.test(e?.message ?? '');
+}
+
+const DEGENERATE_FIT_MSG =
+    'ENA rotation could not be computed — the data is too sparse or degenerate. ' +
+    'Common causes: fewer than 2 units have any code co-occurrences within the ' +
+    'stanza window; only one code column; or all units have identical networks. ' +
+    'Use ena_accumulate to inspect the raw co-occurrence networks, and check that ' +
+    'you have 2+ code columns that actually co-occur and 2+ units with non-empty networks.';
+
 let enaPromise = null;
 function getENA() {
-    if (!enaPromise) enaPromise = loadENA();
+    if (!enaPromise) enaPromise = loadENA().then(ena => {
+        const guard = (fn, adapt) => (rows, opts) => {
+            try {
+                return adapt(fn.call(ena, rows, opts));
+            } catch (e) {
+                if (isWasmAbort(e)) {
+                    enaPromise = null;              // force a fresh WASM instance next call
+                    throw new Error(DEGENERATE_FIT_MSG);
+                }
+                throw e;
+            }
+        };
+        return {
+            ...ena,
+            fit:        guard(ena.fit,        adaptModel),
+            accumulate: guard(ena.accumulate, adaptAccum),
+        };
+    });
     return enaPromise;
 }