formlab-mcp 0.6.25 → 0.6.27

package/package.json

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

package/tools/analytics.js

@@ -983,7 +983,30 @@ function _shelfLife(points, spec) {
   for (let tt = lastX; tt <= lastX + 120; tt += 0.25) {
     if (fit.slope < 0 ? bound(tt) <= limit : bound(tt) >= limit) { ciRemaining = tt - lastX; break; }
   }
-  return { edge, limit, remainingMonths: remaining, ciRemainingMonths: ciRemaining, r2: fit.r2 };
+  return { edge, limit, remainingMonths: remaining, ciRemainingMonths: ciRemaining, r2: fit.r2, elapsedMonths: lastX, lastDate: points[points.length - 1].date };
+}
+
+// Same verdict rule as the app (js/views/stability.js stabShelfLifeAssess):
+// months from T0 vs the target shelf life — short (trend crosses first),
+// marginal (only the 95% bound does), meets; no target → by time left
+// (<3 mo high, <12 mo medium). Nothing past the 5-year horizon is reported.
+function _shelfLifeAssess(sl, targetMonths, now) {
+  if (!sl || !(sl.r2 >= 0.3) || !(sl.remainingMonths > 0.05)) return null;
+  const pointTotal = sl.elapsedMonths + sl.remainingMonths;
+  const ciTotal = sl.ciRemainingMonths != null ? sl.elapsedMonths + sl.ciRemainingMonths : null;
+  // Overdue: the projected crossing (last test + remaining) is already past.
+  const crossMs = sl.lastDate ? sl.lastDate.getTime() + sl.remainingMonths * _MS_PER_MONTH : null;
+  const nowMs = now != null ? +now : Date.now();
+  const overdue = crossMs != null && crossMs < nowMs;
+  const crossDate = crossMs != null ? new Date(crossMs).toISOString().slice(0, 10) : null;
+  if (targetMonths) {
+    const verdict = pointTotal < targetMonths ? 'short' : (ciTotal != null && ciTotal < targetMonths) ? 'marginal' : 'meets';
+    if (verdict === 'meets' && sl.remainingMonths > 60) return null;
+    const level = (overdue && verdict !== 'meets') ? 'high' : verdict === 'short' ? 'high' : verdict === 'marginal' ? 'medium' : 'info';
+    return { verdict, level, pointTotal, ciTotal, overdue, crossDate };
+  }
+  if (sl.remainingMonths > 60) return null;
+  return { verdict: null, level: (overdue || sl.remainingMonths < 3) ? 'high' : sl.remainingMonths < 12 ? 'medium' : 'info', pointTotal, ciTotal, overdue, crossDate };
 }
 
 const get_stability = {
@@ -1045,6 +1068,14 @@ const get_stability = {
     if (!points.length) return { error: `No dated "${args.parameter}" measurements on ${entity.uid || entity.id}.` };
 
     const spec = { min: specMin, max: specMax };
+    // Target shelf life: the formula's own Shelf life, else the workspace
+    // default when this store carries it (the app's Settings → Stability).
+    const formula = entityType === 'formulation' ? entity
+      : (db.formulations || []).find(f => f.id === entity.formulationId) || null;
+    const ownT = formula ? parseFloat(formula.shelfLifeMonths) : NaN;
+    const defT = parseFloat(db.defaultShelfLifeMonths);
+    const target = (Number.isFinite(ownT) && ownT > 0) ? { months: ownT, source: 'formula' }
+      : (Number.isFinite(defT) && defT > 0) ? { months: defT, source: 'workspace default' } : null;
     const analyze = (pts) => {
       const ys = pts.map(p => p.value);
       const n = ys.length;
@@ -1060,11 +1091,19 @@ const get_stability = {
       if (ic) out.controlChart = { mean: _round(ic.mean), ucl: _round(ic.ucl), lcl: _round(ic.lcl), sigma: _round(ic.sigma), outOfControlPoints: ic.ooc };
       if (spec.min != null || spec.max != null) out.spec = { ...spec, latestInSpec: (spec.min == null || ys[n - 1] >= spec.min) && (spec.max == null || ys[n - 1] <= spec.max) };
       const sl = _shelfLife(pts, spec);
+      const as = _shelfLifeAssess(sl, target && target.months);
       if (sl) out.shelfLife = {
         headingToward: `${sl.edge} spec (${_round(sl.limit)})`,
         remainingMonths: _round(sl.remainingMonths, 1),
         ci95Months: sl.ciRemainingMonths != null ? _round(sl.ciRemainingMonths, 1) : null,
+        fromT0Months: _round(sl.elapsedMonths + sl.remainingMonths, 1),
+        ci95FromT0Months: sl.ciRemainingMonths != null ? _round(sl.elapsedMonths + sl.ciRemainingMonths, 1) : null,
         r2: _round(sl.r2, 2), basis: 'linear extrapolation to spec crossing',
+        verdict: as ? as.verdict : null,
+        concern: as ? as.level : null,
+        projectedCrossDate: as ? as.crossDate : null,
+        overdue: as ? as.overdue : false,
+        reportable: !!as,
       };
       return out;
     };
@@ -1082,12 +1121,13 @@ const get_stability = {
     return {
       entity: { type: entityType, uid: entity.uid, name: entity.name || entity.uid },
       parameter: args.parameter, unit, spec, pointCount: points.length, byCondition: split, series,
-      note: 'shelfLife.remainingMonths is the point-estimate months from the last test to the spec crossing; ci95Months is the conservative (ICH-style) estimate where the 95% confidence bound crosses spec. Numbers are computed here — narrate them, do not recompute.',
+      targetShelfLife: target ? { months: target.months, source: target.source } : null,
+      note: 'shelfLife.fromT0Months / ci95FromT0Months are the projected shelf life counted from the first test (T0): point estimate and the conservative (ICH Q1E) 95%-bound crossing. remainingMonths / ci95Months are the same, counted from the last test. verdict compares against targetShelfLife: "short" = the trend crosses spec before the target, "marginal" = the trend clears it but the 95% bound does not, "meets" = both clear it; null = no target set (then concern is by time left: high <3 mo, medium <12 mo). overdue=true means projectedCrossDate is already past today (time left runs from the last test), so the sample is probably out of spec now — recommend a re-test. reportable=false means the app shows no projection (R² < 0.3, crossing already past, or beyond 5 years). Numbers are computed here — narrate them, do not recompute.',
     };
   },
 };
 
-export { _evalPassFail, _resolveSpec };
+export { _evalPassFail, _resolveSpec, _shelfLife, _shelfLifeAssess };
 export const tools = {
   list_test_results,
   get_test_result,

package/tools/formulations.js

@@ -22,6 +22,8 @@ function _trimFormulation(f) {
     application: f.application || '',
     owner: f.owner || '',
     regulatoryCategory: f.regulatoryCategory || '',
+    // Target shelf life (months): sets finished-goods expiry AND is what
+    // get_stability judges the projected shelf life against.
     shelfLifeMonths: f.shelfLifeMonths ?? null,
     // Density of the MIXED product (g/mL), when declared — volume-targeted
     // batches scale by it instead of the ideal-mix estimate. null = not set.