formlab-mcp 0.6.41 → 0.6.42

package/README.md

@@ -46,7 +46,7 @@ Ask Claude (or another MCP client) things like:
 | `get_sample` | Full record + canonical variant + test reports + blend lineage |
 | `list_test_results` | Filtered list of test reports (by sample, parameter, **measured-value range** (`value_min`/`value_max`), date, or lab) |
 | `get_test_result` | Full report: every measurement's value, spec, any per-measurement run **conditions**, and the **resolved instrument** (`instrumentSource`: row / method / run). Complex types carry a `representative` (time-series → final, distribution → D50); a time series adds `aggregated` (per-timestamp mean ± sd) and `pointReplicates` (repeat readings at one `t`). Report-level `seriesReplicates` lists parameters measured 2+ times as separate rows — point vs series replicates are distinct. Each measurement also gives its **effective spec** (`effectiveSpec`, `specSource`: override / template / parameter / none) and `passFail` — panel and Test Method specs apply exactly as in the app, and every pass/fail count across the tools uses the same rule |
-| `get_doe_matrix` | Pivot matrix (CSV by default) — rows × ingredients × parameters. A parameter measured under two or more **run conditions** (storage 25 °C vs 40 °C) is one column per condition (`pH`, `pH · 40 °C`; the bare name is the base arm), never averaged together — same columns as the app's DOE Matrix |
+| `get_doe_matrix` | Pivot matrix (CSV by default) — rows × ingredients × parameters. A parameter measured under two or more **run conditions** (storage 25 °C vs 40 °C) is one column per condition (`pH`, `pH · 40 °C`; the bare name is the base arm), never averaged together — same columns, in the same order (grouped by measurement type, the test panel's order within a group), as the app's DOE Matrix |
 | `find_failures` | Parameters ranked by failure **rate** (failing ÷ all readings; replicates in one report count once), `lowN` flag under 5 readings, plus formulations ranked by share of failing reports — same numbers as the app's Test Analytics → Failures |
 | `get_coverage_matrix` | TEST coverage by formulation, batch or sample (`grain`) × parameter. Each cell is the **latest** reading by test date (same-day reports averaged, any fail → fail) with its date and how many reports measured it; one column per **run condition** when a parameter was measured under two or more — same rollup as the app's Test Analytics → Coverage |
 | `compare_test_results` | **Test results** side by side across 2+ formulas, batches, samples or reports — the app's Compare Results table. Parameters grouped by measurement type (Numbers, Curves, Distributions, Ranked scales, Text results) and, within a group, in the test panel's order (`order: method`, default) or `az`. One cell per item × parameter: `aggregation` `latest` (default; one value per test date, replicates averaged ± sd), `mean` (± sd between dates), `median` (min–max) or `trend` (change from the first date). Curves compare at their final point, distributions at D50; ranked scales and text show the latest reading (with its rank); a parameter measured under 2+ run conditions is split into `arms`, never averaged. `differs` flags a >5% spread across items, as the app highlights |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "formlab-mcp",
-  "version": "0.6.41",
+  "version": "0.6.42",
   "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.41",
+  "version": "0.6.42",
   "websiteUrl": "https://formvix.com/mcp",
   "repository": {
     "url": "https://github.com/juliu1980/FormLab",
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "formlab-mcp",
-      "version": "0.6.41",
+      "version": "0.6.42",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/tools/analytics.js

@@ -226,7 +226,7 @@ const get_test_result = {
 const get_doe_matrix = {
   definition: {
     name: 'get_doe_matrix',
-    description: 'Build a Design-of-Experiments style pivot matrix: rows = formulations (or samples / batches / tests), columns = composition wt-% per ingredient + aggregated test-parameter values. Same shape as the FormLab DOE Matrix view. A parameter measured under two or more RUN CONDITIONS (e.g. storage 25 °C vs 40 °C) is one column per condition — "pH · 40 °C" — and the bare parameter column is the base arm (readings with no condition, else the condition with the most readings, on a tie the one declared as the default on the Test Method / Test Panel); they are different responses, never averaged together. Returns CSV when format=csv (default) for compact LLM consumption, or structured JSON when format=json.',
+    description: 'Build a Design-of-Experiments style pivot matrix: rows = formulations (or samples / batches / tests), columns = composition wt-% per ingredient + aggregated test-parameter values. Same shape as the FormLab DOE Matrix view. A parameter measured under two or more RUN CONDITIONS (e.g. storage 25 °C vs 40 °C) is one column per condition — "pH · 40 °C" — and the bare parameter column is the base arm (readings with no condition, else the condition with the most readings, on a tie the one declared as the default on the Test Method / Test Panel); they are different responses, never averaged together. Parameter columns come in the same order as the app: grouped by measurement type (numbers, curves, distributions, ranked scales, text) and in the test panel order within a group. Returns CSV when format=csv (default) for compact LLM consumption, or structured JSON when format=json.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -340,8 +340,18 @@ const get_doe_matrix = {
     const armNames = _mcpArmNames(rows.flatMap(r => r.measurements
       .filter(m => m && m.parameter && parameters.has(m.parameter))
       .map(m => ({ parameter: m.parameter, m }))));
+    // Parameter columns in the app's order (13h): grouped by measurement type
+    // (numbers, curves, distributions, ranked scales, text), the test panel's
+    // order within a group — the same order as compare_test_results.
+    const testOf = new Map();
+    (db.testResults || []).forEach(t => (t.measurements || []).forEach(x => testOf.set(x, t)));
+    const ordered = _mcpParamGroupsOf(rows.flatMap(r => r.measurements.filter(m => m && m.parameter && parameters.has(m.parameter)).map(m => ({ m, t: testOf.get(m) || null }))), 'method', db)
+      .flatMap(g => g.parameters);
+    const byTrim = new Map([...parameters].map(k => [String(k).trim(), k]));
+    const paramOrder = ordered.map(p => byTrim.get(p)).filter(k => k != null);
+    [...parameters].forEach(k => { if (!paramOrder.includes(k)) paramOrder.push(k); });
     const paramCols = [];
-    [...parameters].forEach(p => {
+    paramOrder.forEach(p => {
       const arms = armNames.get(p);
       if (!arms) { paramCols.push({ id: p, cond: null, label: p }); return; }
       arms.forEach((label, sig) => paramCols.push({ id: p, cond: sig, label }));
@@ -1394,15 +1404,21 @@ const _MCP_PARAM_GROUPS = [
 ];
 const _mcpCmp = (a, b) => String(a).localeCompare(String(b), undefined, { numeric: true, sensitivity: 'base' }) || (a < b ? -1 : a > b ? 1 : 0);
 function _mcpParamGroups(items, sort, db) {
+  const pairs = [];
+  (items || []).forEach(it => (it.tests || []).forEach(t => (t.measurements || []).forEach(m => pairs.push({ m, t }))));
+  return _mcpParamGroupsOf(pairs, sort, db);
+}
+// From [{ m, t }] pairs (t may be null) — get_doe_matrix holds flattened measurements (13h).
+function _mcpParamGroupsOf(pairs, sort, db) {
   const sortAz = sort === 'az';
   const rank = new Map(_MCP_PARAM_GROUPS.map(([t], i) => [t, i]));
   const best = new Map(), panels = new Map(), onPanel = new Map();
-  (items || []).forEach(it => (it.tests || []).forEach(t => (t.measurements || []).forEach(m => {
+  (pairs || []).forEach(({ m, t }) => {
     const p = String((m && m.parameter) || '').trim();
     if (!p) return;
     const k = rank.get(_mcpMeasType(m)) ?? 0;
     if (!best.has(p) || k < best.get(p)) best.set(p, k);
-    if (sortAz || !t.templateId) return;
+    if (sortAz || !t || !t.templateId) return;
     if (!panels.has(t.templateId)) panels.set(t.templateId, (db.templates || []).find(x => x && x.id === t.templateId) || null);
     const panel = panels.get(t.templateId);
     const params = (panel && panel.parameters) || [];
@@ -1411,7 +1427,7 @@ function _mcpParamGroups(items, sort, db) {
     const at = [String(panel.name || ''), i];
     const cur = onPanel.get(p);
     if (!cur || _mcpCmp(at[0], cur[0]) < 0 || (at[0] === cur[0] && i < cur[1])) onPanel.set(p, at);
-  })));
+  });
   const byMethod = (a, b) => {
     const x = onPanel.get(a), y = onPanel.get(b);
     if (x && y) return _mcpCmp(x[0], y[0]) || (x[1] - y[1]) || _mcpCmp(a, b);