@qe-mcp/server-ena 0.1.6 → 0.1.7

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qe-mcp/server-ena",
-  "version": "0.1.6",
-  "description": "MCP server for Epistemic Network Analysis — WASM backend, zero Python dependency",
+  "version": "0.1.7",
+  "description": "MCP server for Epistemic Network Analysis \u2014 WASM backend, zero Python dependency",
   "type": "module",
   "main": "server.js",
   "bin": {

package/server.js

@@ -506,10 +506,35 @@ function toolInspect({ data_path, data_csv }) {
         recommended = true;
         confidence  = 'low';
         reason = `Found ${nCodes} binary code columns but no clear unit/conversation columns by name.`;
+    } else if (nCodes === 1) {
+        recommended = false;
+        confidence  = 'low';
+        reason = `Only 1 binary code column was detected. ENA models co-occurrence ` +
+            `*between* codes, so it needs at least 2 (ideally 4+) binary presence/absence columns.`;
     } else {
         recommended = false;
         confidence  = 'low';
-        reason = `Found only ${nCodes} binary column(s). ENA typically requires 4+ binary code columns.`;
+        reason = `No binary (0/1) code columns were detected in this dataset. ENA models the ` +
+            `co-occurrence of *codes* — columns that mark, for each row, whether a concept, ` +
+            `behavior, or feature is present (1) or absent (0). This dataset has none, so ENA ` +
+            `cannot be run on it as-is.`;
+    }
+
+    // Actionable guidance for the not-applicable cases, so Claude can explain
+    // to the user *why* ENA doesn't fit and what would be needed.
+    let guidance = null;
+    if (!recommended) {
+        const needs =
+            'For a dataset to be analyzable with ENA it needs:\n' +
+            '  • 2+ binary (0/1) CODE columns — each marking presence/absence of a concept or behavior per row\n' +
+            '  • a UNIT column identifying who or what each row belongs to\n' +
+            '  • a CONVERSATION column grouping rows into episodes';
+        guidance = nCodes === 0
+            ? `${needs}\n\nThis dataset appears to contain no coded columns. If it is uncoded text or ` +
+              `raw events, each concept of interest must first be turned into a 0/1 column (a ` +
+              `qualitative-coding step) before ENA can be applied. If you expected coded columns, ` +
+              `check that they use 0/1 values rather than text labels.`
+            : `${needs}\n\nAdd more binary code columns, or use a standard statistical analysis instead.`;
     }
 
     let nextStep = {};
@@ -554,6 +579,8 @@ function toolInspect({ data_path, data_csv }) {
             suggestedConvos.slice(0,3).map(c => `${c.column} (n=${c.n_unique}, score=${c.score})`).join(', '));
     for (const [col, vals] of Object.entries(suggestedGroups))
         summaryLines.push(`Likely group column: '${col}' → ${JSON.stringify(vals)}`);
+    if (guidance)
+        summaryLines.push('', guidance);
 
     const privacyNote = isPrivacySafe
         ? 'PRIVACY SAFE — data was read from a local file path. No raw row data was sent to Claude; only this analysis result was transmitted.'
@@ -564,6 +591,7 @@ function toolInspect({ data_path, data_csv }) {
         ena_recommended:         recommended,
         confidence,
         reason,
+        guidance,
         n_rows:                  nRows,
         n_cols:                  headers.length,
         suggested_codes:         codeCols,
@@ -1078,6 +1106,9 @@ const TOOLS = [
             'Inspect a dataset and recommend whether ENA is an appropriate analysis. ' +
             'Call this FIRST whenever a user provides tabular data and asks for analysis. ' +
             'Returns ena_recommended, confidence, suggested codes/units/conversations, and a ready-to-use next_step call. ' +
+            'When ena_recommended is false, the result includes a "guidance" field explaining why the data is not ENA-shaped ' +
+            '(e.g. no binary code columns) and what would be needed — relay this to the user rather than silently failing or ' +
+            'claiming the connector is unavailable. ' +
             'PRIVACY: prefer data_path over data_csv so raw data stays local. ' +
             'If the user has not yet indicated whether their data is sensitive, ask before using data_csv. ' +
             'If they indicate sensitivity, use ena_profile instead (no raw data transmitted).',