formlab-mcp 0.6.12 → 0.6.14

package/README.md

@@ -37,7 +37,7 @@ Ask Claude (or another MCP client) things like:
 | `list_lots` | Inventory lots across ingredients (each a received batch with its own remaining balance, supplier, expiry). Filters: `ingredient_id`, `expiring_within_days`, `status` |
 | `list_inventory` | Portfolio stock rollup — one row per ingredient with on-hand qty, summed lot balance, nearest expiry, and a low-stock flag (on-hand ≤ `reorderThreshold`, or zero). Filters: `low_stock_only`, `expiring_within_days`, `family` |
 | `list_batches` | Filtered list of production / lab-prep events |
-| `get_batch` | Full record + actual composition, measured/derived **actual volume** (mass ÷ density, never a sum of per-ingredient volumes), the **process** method + any **process-factor values** (DOE inputs), samples + blend lineage |
+| `get_batch` | Full record + actual composition, measured/derived **actual volume** (mass ÷ density, never a sum of per-ingredient volumes) and **actual mass** (yield, else summed inputs, else measured volume × density), the **process** method + any **process-factor values** (DOE inputs), samples + blend lineage |
 | `list_samples` | Filtered list of physical specimens |
 | `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) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "formlab-mcp",
-  "version": "0.6.12",
+  "version": "0.6.14",
   "mcpName": "io.github.juliu1980/formlab-mcp",
   "description": "Read-only Model Context Protocol server for FormLab — 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.12",
+  "version": "0.6.14",
   "websiteUrl": "https://formvix.com/mcp",
   "repository": {
     "url": "https://github.com/juliu1980/FormLab",
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "formlab-mcp",
-      "version": "0.6.12",
+      "version": "0.6.14",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/tools/lab.js

@@ -26,6 +26,17 @@ function _batchActualMassKg(b) {
     for (const c of b.actualComposition) { const kg = _massToKg(parseFloat(c.amount), c.unit); if (kg != null) { t += kg; any = true; } }
     if (any) return t;
   }
+  // Volume-anchored batch (no weighed mass above): mass = measured volume ×
+  // measured density (V·ρ — always valid; summing per-ingredient volumes is
+  // not). Mirrors FormLab's js/views/batches.js _batchActualMassKg. The app
+  // also falls back to the formula's estimated density; MCP stays exact and
+  // reports null rather than an estimate. Recursion-safe: _batchActualVolume
+  // calls back into mass only when measuredVolume is ABSENT.
+  const mv = parseFloat(b.measuredVolume), d = parseFloat(b.measuredDensity);
+  if (isFinite(mv) && mv > 0 && isFinite(d) && d > 0) {
+    const L = _volToL(mv, b.measuredVolumeUnit || 'L');
+    if (L != null) return L * d;   // kg (d in g/mL === kg/L)
+  }
   return null;
 }
 function _batchActualVolume(b) {
@@ -66,6 +77,10 @@ function _trimBatch(b, formulationsById) {
     measuredVolume: b.measuredVolume ?? null,
     measuredVolumeUnit: b.measuredVolumeUnit || '',
     actualVolume: _actualVolumeInfo(b),
+    // Actual MASS in kg (the conserved, additive quantity). From actual yield
+    // (mass-unit batch), else summed weighed inputs, else measured volume ×
+    // measured density. null when none is determinable.
+    actualMass: (function () { const m = _batchActualMassKg(b); return (m != null && isFinite(m)) ? { kg: +m.toFixed(4), unit: 'kg' } : null; })(),
     preparedDate: b.preparedDate || '',
     preparedBy: b.preparedBy || '',
     process: b.process || '',
@@ -174,6 +189,11 @@ const get_batch = {
       ..._trimBatch(b, indexes.formulationsById),
       notes: b.notes || '',
       equipmentUsed: b.equipmentUsed || '',
+      // Multi-select equipment: full list [{name, equipmentId}]; falls back to
+      // the legacy single equipmentUsed so older batches still report one item.
+      equipmentUsedList: (Array.isArray(b.equipmentUsedList) && b.equipmentUsedList.length)
+        ? b.equipmentUsedList.filter(e => e && e.name).map(e => ({ name: e.name, equipmentId: e.equipmentId || null }))
+        : (b.equipmentUsed ? [{ name: b.equipmentUsed, equipmentId: b.equipmentUsedId || null }] : []),
       actualCompositionRowCount: Array.isArray(b.actualComposition) ? b.actualComposition.length : 0,
       hasActualComposition: Array.isArray(b.actualComposition) && b.actualComposition.length > 0,
       sourceBlendParents: parents,