formlab-mcp 0.6.26 → 0.6.28

package/package.json

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

package/tools/analytics.js

@@ -983,24 +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, elapsedMonths: lastX };
+  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) {
+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;
-    return { verdict, level: verdict === 'short' ? 'high' : verdict === 'marginal' ? 'medium' : 'info', pointTotal, ciTotal };
+    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: sl.remainingMonths < 3 ? 'high' : sl.remainingMonths < 12 ? 'medium' : 'info', pointTotal, ciTotal };
+  return { verdict: null, level: (overdue || sl.remainingMonths < 3) ? 'high' : sl.remainingMonths < 12 ? 'medium' : 'info', pointTotal, ciTotal, overdue, crossDate };
 }
 
 const get_stability = {
@@ -1075,10 +1081,14 @@ const get_stability = {
       const n = ys.length;
       const out = { points: n, from: pts[0].date.toISOString().slice(0, 10), to: pts[n - 1].date.toISOString().slice(0, 10), values: ys.map(v => _round(v, 6)), latest: _round(ys[n - 1], 6) };
       if (n < 2) { out.note = 'Fewer than 2 points — no trend/shelf-life.'; return out; }
-      const fit = _ols(pts.map((_, i) => i), ys);
+      // Drift on real elapsed months (not point order), like the shelf-life
+      // projection and the app's Stability view: uneven ICH schedules
+      // (0/1/3/6/12 mo) read true.
+      const t0 = pts[0].date.getTime();
+      const days = (pts[n - 1].date - pts[0].date) / 86400000;
+      const fit = days > 0 ? _ols(pts.map(p => (p.date.getTime() - t0) / 86400000 / 30.4375), ys) : null;
       if (fit) {
-        const days = (pts[n - 1].date - pts[0].date) / 86400000;
-        const perMonth = days > 0 ? (fit.slope * (n - 1) / days) * 30 : 0;
+        const perMonth = fit.slope;
         out.drift = { perMonth: _round(perMonth, 4), r2: _round(fit.r2, 3), direction: perMonth > 0 ? 'increasing' : perMonth < 0 ? 'decreasing' : 'flat' };
       }
       const ic = _iChart(ys);
@@ -1095,6 +1105,8 @@ const get_stability = {
         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;
@@ -1114,7 +1126,7 @@ const get_stability = {
       entity: { type: entityType, uid: entity.uid, name: entity.name || entity.uid },
       parameter: args.parameter, unit, spec, pointCount: points.length, byCondition: split, series,
       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). 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.',
+      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.',
     };
   },
 };