formlab-mcp 0.6.50 → 0.6.51

package/README.md

@@ -30,7 +30,7 @@ Ask Claude (or another MCP client) things like:
 | Tool | Purpose |
 |---|---|
 | `list_formulations` | Filtered list of recipes |
-| `get_formulation` | Full record + flattened wt-% composition (sub-formulas expanded), the ordered **step procedure**, user **custom fields**, any **process-factor values** (DOE inputs — cure temp, mix time, RPM, pH…), the declared **finishedDensity** (g/mL of the mixed product; volume-targeted batches scale by it), and its **theoretical parameters computed** the way the app's Params tab does (Energy kcal/100g, NV %, Cost/kg…: value, unit, formula, spec pass/fail, and a `warning` when ingredients lack a value or carry mixed units) — the app's own engine, vendored in `mcp/vendor/` and run in an isolated `node:vm` context |
+| `get_formulation` | Full record (incl. `versionLabel`, the label the user types, e.g. 1.0) + **version history** (`versionHistory`: one snapshot per save, v1, v2…, newest first, with the label each save had and its note) + flattened wt-% composition (sub-formulas expanded), the ordered **step procedure**, user **custom fields**, any **process-factor values** (DOE inputs — cure temp, mix time, RPM, pH…), the declared **finishedDensity** (g/mL of the mixed product; volume-targeted batches scale by it), and its **theoretical parameters computed** the way the app's Params tab does (Energy kcal/100g, NV %, Cost/kg…: value, unit, formula, spec pass/fail, and a `warning` when ingredients lack a value or carry mixed units) — the app's own engine, vendored in `mcp/vendor/` and run in an isolated `node:vm` context |
 | `find_similar_formulations` | Find formulas using a given ingredient ≥ threshold % |
 | `compare_formulations` | Pairwise side-by-side composition diff |
 | `list_ingredients` | Filtered list of raw materials. Filters: `family`, `supplier`, `name_contains`, `in_stock_only`, `ingredient_class` (small-molecule / surfactant / polymer / extract / fragrance / pigment / sequence / mixture), `sequence_contains` (e.g. `KTTKS` → Matrixyl), `taxon_contains` (e.g. `Centella`) |

package/package.json

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

package/tools/formulations.js

@@ -19,6 +19,9 @@ function _trimFormulation(f) {
     name: f.name,
     description: f.description || '',
     status: f.status || 'Draft',
+    // The Version LABEL the user types (1.0, 2.1-alpha) — not the save count;
+    // the automatic history is get_formulation's versionHistory.
+    versionLabel: f.version != null ? String(f.version) : '',
     family: f.family || '',
     application: f.application || '',
     owner: f.owner || '',
@@ -83,7 +86,7 @@ const list_formulations = {
 const get_formulation = {
   definition: {
     name: 'get_formulation',
-    description: 'Get full details for a single formulation including its composition (raw rows AND flattened wt-% leaves with sub-formulas expanded), step procedure, any recorded process-factor values (cure temp, mix time, RPM, pH — DOE inputs), and recent batches. Accepts either internal id or UID (e.g. FORM-001). Also returns `theoreticalParameters`: values computed from the composition the way the app Params tab does (e.g. Energy kcal/100g, NV %, Cost/kg) — each with name, value, unit, formula, spec + pass, and `warning` when ingredients lack a value the formula reads or carry mixed units (those rows are not counted). Quote these; do not recompute nutrition or NV yourself.',
+    description: 'Get full details for a single formulation including its composition (raw rows AND flattened wt-% leaves with sub-formulas expanded), step procedure, any recorded process-factor values (cure temp, mix time, RPM, pH — DOE inputs), and recent batches. Accepts either internal id or UID (e.g. FORM-001). Also returns `theoreticalParameters`: values computed from the composition the way the app Params tab does (e.g. Energy kcal/100g, NV %, Cost/kg) — each with name, value, unit, formula, spec + pass, and `warning` when ingredients lack a value the formula reads or carry mixed units (those rows are not counted). Quote these; do not recompute nutrition or NV yourself. `versionLabel` is the label the user types (e.g. 1.0); `versionHistory` is the automatic save history (v1, v2… one per save, newest first, up to 20, with the label each save had and its note) — two different things.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -134,6 +137,20 @@ const get_formulation = {
       processFactors: (f.factorValues || []).filter(x => x && x.name).map(x => ({ name: x.name, value: x.value != null ? x.value : '', unit: x.unit || '' })),
       // Computed by the app's own engine (mcp/theoretical.js → mcp/vendor/).
       theoreticalParameters: theoreticalParams(db, 'formulation', f.id),
+      // Automatic history: one snapshot per save (v1, v2…), newest first,
+      // with the Version label each save had. Independent of versionLabel.
+      versionHistory: (() => {
+        const vs = (db.formulaVersions || []).filter(v => v && v.formulationId === f.id)
+          .sort((a, b) => (b.versionNumber || 0) - (a.versionNumber || 0));
+        return {
+          count: vs.length,
+          versions: vs.slice(0, 20).map(v => ({
+            version: v.versionNumber, label: (v.snapshot && v.snapshot.version != null) ? String(v.snapshot.version) : '',
+            savedAt: v.snapshotAt || null, savedBy: v.snapshotBy || '', note: v.changeNote || '',
+            ingredientRows: ((v.snapshot && v.snapshot.composition) || []).length, stepCount: ((v.snapshot && v.snapshot.steps) || []).length,
+          })),
+        };
+      })(),
       batchCount: batches.length,
       sampleCount: samples.length,
     };