formlab-mcp 0.6.46 → 0.6.47

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "formlab-mcp",
-  "version": "0.6.46",
+  "version": "0.6.47",
   "mcpName": "io.github.juliu1980/formlab-mcp",
   "description": "Read-only Model Context Protocol server for FormLab \u2014 lets Claude (and other MCP clients) read and analyze your FormLab data, from a local export file OR your live cloud workspace.",
   "type": "module",

package/server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.juliu1980/formlab-mcp",
   "description": "Read-only MCP for FormLab — let Claude query your formulation lab. Free reads a local export; Pro connects to your live cloud workspace with a dedicated read-only token.",
-  "version": "0.6.46",
+  "version": "0.6.47",
   "websiteUrl": "https://formvix.com/mcp",
   "repository": {
     "url": "https://github.com/juliu1980/FormLab",
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "formlab-mcp",
-      "version": "0.6.46",
+      "version": "0.6.47",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/tools/analytics.js

@@ -359,13 +359,23 @@ const get_doe_matrix = {
 
     // 4) Aggregate measurements per column per row (mean of numeric scalar
     //    values), reading only the column's own run condition when split.
+    const testOfM = new Map();
+    (db.testResults || []).forEach(t => (t.measurements || []).forEach(x => testOfM.set(x, t)));
     const cellParamValue = (r, col) => {
       const ms = r.measurements.filter(m => m.parameter === col.id && (col.cond == null || _mcpCondSig(m) === col.cond));
       if (!ms.length) return null;
       // The app's DOE Matrix numbers (12v): a curve's final value, a
-      // distribution's D50, an ordinal's 1-based rank; text → its first reading.
+      // distribution's D50, a grade's place on its scale. 13r: a ranked scale
+      // is its LOWER-median grade (never an averaged rank); text its most
+      // frequent value, a tie to a failing one (it took the first reading); a
+      // distribution with no D50 its bins (it read "8 bins").
       const nums = ms.map(m => _mcpRepNumber(m, { ordinal: 'rank' })).filter(v => v != null);
-      if (!nums.length) return ms[0].value ?? null;
+      if (!nums.length) {
+        const rows = ms.map(m => { const t = testOfM.get(m); return { m, type: _mcpMeasType(m), value: m.value, numeric: null, rank: null, pf: _evalPassFail(m, t && t.templateId) }; });
+        if (rows.every(x => x.type === 'categorical')) return _mcpGradedPick(rows).value ?? null;
+        return _mcpCellValue(rows[0]);
+      }
+      if (ms.every(m => _mcpMeasType(m) === 'ordinal')) { const so = nums.slice().sort((a, b) => a - b); return so[Math.floor((so.length - 1) / 2)]; }
       const mean = nums.reduce((s, v) => s + v, 0) / nums.length;
       return +mean.toFixed(4);
     };
@@ -462,7 +472,7 @@ function _mcpRepNumber(m, opts) {
 // app's Stability view draws it (FormLab 12w): one point per test date × run
 // condition — an ordinal date is the MEDIAN rank of its readings (rank =
 // 1-based position on the reading's own scale), a text date its value (or
-// "mixed: a / b") — failing when any reading fails; one series per condition.
+// the most frequent value, a tie to a failing one) — failing when any reading fails; one series per condition.
 function _mcpGradedStability(entity, entityType, args, graded) {
   const nOrd = graded.filter(r => r.type === 'ordinal').length;
   const kind = nOrd >= graded.length - nOrd ? 'ordinal' : 'categorical';
@@ -478,8 +488,11 @@ function _mcpGradedStability(entity, entityType, args, graded) {
       rank = rs.length ? rs[Math.floor((rs.length - 1) / 2)] : null;
       label = rank != null && scale ? scale[rank - 1] : g[0].label;
     } else {
-      const vals = [...new Set(g.map(r => r.label))];
-      label = vals.length === 1 ? vals[0] : 'mixed: ' + vals.join(' / ');
+      // The most frequent value, a tie to a failing one (13r) — "mixed: a / b" said
+      // nothing about which reading counts. The chip's tooltip lists them all.
+      const k = r => String(r.label).toLowerCase(); const cnt = new Map(); g.forEach(r => cnt.set(k(r), (cnt.get(k(r)) || 0) + 1));
+      const top = Math.max(...cnt.values()); const tied = g.filter(r => cnt.get(k(r)) === top);
+      label = (tied.find(r => r.pf === 'fail') || tied[0]).label;
     }
     return { date: g[0].day, condition: split ? (g[0].cond || null) : null, label, ...(kind === 'ordinal' ? { rank } : {}),
       readings: g.length, values: g.map(r => r.label), reports: [...new Set(g.map(r => r.report))],
@@ -504,7 +517,7 @@ function _mcpGradedStability(entity, entityType, args, graded) {
     parameter: args.parameter, kind, ...(scale ? { scale } : {}), spec, byCondition: split, pointCount: pts.length, series,
     note: kind === 'ordinal'
       ? 'A ranked scale (ordinal) has no number, so there is no regression, control chart or shelf-life projection: each point is one test date per condition, its value the MEDIAN rank of that date\'s readings (rank = position on `scale`, 1-based; higher = later on the scale). pf "fail" when any reading that date failed. scaleShift.steps is the rank change first → latest (negative = moved down the scale). Narrate firstFail / latest; do not average ranks into a number.'
-      : 'A text (categorical) result has no number: each point is one test date per condition with its value (or "mixed: a / b" when readings differ) and pass/fail against `spec.required`; pf "fail" when any reading failed. Narrate firstFail / latest.',
+      : 'A text (categorical) result has no number: each point is one test date per condition with its value (several readings that differ → the most frequent, a tie to a failing one; `values` lists them) and pass/fail against `spec.required`; pf "fail" when any reading failed. Narrate firstFail / latest.',
   };
 }
 function _mcpCondSig(m) {
@@ -812,7 +825,8 @@ function _evalPassFail(m, templateId, db) {
   if (type === 'ordinal') {
     if (!raw) return 'untested';
     const scale = Array.isArray(m.scale) ? m.scale : [];
-    const idx = scale.indexOf(raw);
+    // Case-insensitive, as flMeasNum places a grade (13r): "hb" was judged untested but plotted at HB.
+    const idx = scale.map(g => String(g).trim().toUpperCase()).indexOf(raw.toUpperCase());
     if (idx < 0) return 'untested';
     const minRank = _ordinalMinRank(crit, scale);
     if (minRank == null) return 'no-criteria';
@@ -1511,8 +1525,39 @@ function _mcpCompareCell(item, parameter, agg, db) {
     if (!arms.has(sig)) arms.set(sig, { sig, m, t, rows: [] });
     arms.get(sig).rows.push({ m, t, date: _tcDate(t), value: v, pf: _evalPassFail(m, t.templateId, db) });
   });
-  // Nothing numeric (a ranked scale, a text result, a distribution with no D50):
-  // the latest reading, as typed.
+  // A ranked scale or a text result (13r, as the app's Compare): per run
+  // condition, no condition first, the latest test date — several readings on
+  // it → the lower-median grade / the most frequent text (a tie to a failing
+  // one), failing if any reading fails; two or more conditions → arms.
+  if (!arms.size && (type === 'ordinal' || type === 'categorical')) {
+    const g = new Map();
+    hits.forEach(({ m, t }) => {
+      const label = String(m.value == null ? '' : m.value).trim(); if (!label) return;
+      const sig = _mcpCondSig(m), day = String(t.testDate || '').slice(0, 10);
+      if (!g.has(sig)) g.set(sig, { sig, m, days: new Map() });
+      const a = g.get(sig); if (!a.days.has(day)) a.days.set(day, []);
+      a.days.get(day).push({ type: _mcpMeasType(m), value: label, rank: _mcpRepNumber(m, { ordinal: 'rank' }), pf: _evalPassFail(m, t.templateId, db), m });
+    });
+    const gl = [...g.values()].sort((x, y) => ((x.sig ? 1 : 0) - (y.sig ? 1 : 0)) || (y.days.size - x.days.size) || x.sig.localeCompare(y.sig));
+    if (gl.length) {
+      const cellOf = (a) => {
+        const day = [...a.days.keys()].sort().pop(); const rs = a.days.get(day); const p = _mcpGradedPick(rs);
+        const pf = rs.some(r => r.pf === 'fail') ? 'fail' : rs.some(r => r.pf === 'pass') ? 'pass' : rs[0].pf;
+        const c = { type, value: p.value, pf, date: day, n: a.days.size, readings: [...a.days.values()].reduce((x, r) => x + r.length, 0),
+          ...(rs.length > 1 ? { readingsOnDate: rs.map(r => r.value), basis: type === 'ordinal' ? 'middle grade of the date\'s readings' : 'most frequent of the date\'s readings' } : {}) };
+        if (type === 'ordinal' && p.rank != null && Array.isArray(p.m.scale)) { c.rank = p.rank; c.scaleLength = p.m.scale.length; }
+        return c;
+      };
+      const cells = gl.map(cellOf);
+      if (agg !== 'latest' && hits.length > 1) cells.forEach(c => { c.note = 'not a number — the latest test date is shown'; });
+      if (gl.length === 1) return { ...cells[0], ...(gl[0].sig ? { condition: _mcpCondLabel(gl[0].m) } : {}) };
+      const tags = _mcpCondTags(gl.map(a => a.sig ? _mcpCondLabel(a.m) : ''));
+      return { ...cells[0], splitByCondition: true,
+        arms: gl.map((a, i) => ({ condition: a.sig ? _mcpCondLabel(a.m) : null, tag: tags[i], ...cells[i] })),
+        note: 'measured under more than one run condition: one arm per condition, never mixed; the top-level value is the first arm (no run condition when there is one)' };
+    }
+  }
+  // Nothing numeric (a distribution with no D50): the latest reading.
   if (!arms.size) {
     const { m, t } = hits[hits.length - 1];
     const out = { type, value: m.value ?? null, unit: m.unit || '', pf: _evalPassFail(m, t.templateId, db), date: t.testDate || '', readings: hits.length };