@mutmutco/cli 2.26.0 → 2.27.0

package/dist/main.cjs

@@ -4235,6 +4235,7 @@ function parseHookInput(stdin) {
 }
 
 // src/saga-health.ts
+var MEMORY_STALE_DAYS = 14;
 function buildHealth(i) {
   const problems = [];
   if (!i.sagaApiUrl) problems.push("Hub API URL not configured");
@@ -4245,6 +4246,10 @@ function buildHealth(i) {
   }
   if (i.reachable && i.authorized === false) problems.push("saga backend rejected authenticated state access");
   if (!i.key.sessionId || i.key.sessionId === "-") problems.push("unsafe session id");
+  const warnings = [];
+  if (i.memoryAgeDays !== void 0 && i.memoryAgeDays > MEMORY_STALE_DAYS) {
+    warnings.push(`PROJECT MEMORY is ${Math.round(i.memoryAgeDays)}d stale \u2014 the saga-keeper may have stalled`);
+  }
   const safeToWrite = problems.length === 0;
   return {
     ok: safeToWrite,
@@ -4258,14 +4263,19 @@ function buildHealth(i) {
     pendingNotes: i.pendingNotes ?? 0,
     key: i.key,
     source: i.source,
-    problems
+    problems,
+    warnings,
+    memoryAgeDays: i.memoryAgeDays
   };
 }
 function healthBanner(report) {
-  if (report.ok) return null;
-  const summary = report.problems.slice(0, 2).join("; ") || "unknown saga health gap";
-  const suffix = report.problems.length > 2 ? ` (+${report.problems.length - 2} more)` : "";
-  return `saga health: CHECK - ${summary}${suffix}`;
+  if (report.problems.length) {
+    const summary = report.problems.slice(0, 2).join("; ") || "unknown saga health gap";
+    const suffix = report.problems.length > 2 ? ` (+${report.problems.length - 2} more)` : "";
+    return `saga health: CHECK - ${summary}${suffix}`;
+  }
+  if (report.warnings.length) return `saga health: NOTE - ${report.warnings.join("; ")}`;
+  return null;
 }
 function resumeCue() {
   return '> STATUS/RESUME CUE \u2014 For any status, resume, or "where do I stand" report: read THIS saga HEAD first (`mmi-cli saga show`), then reconcile its NEXT / LAST 5 / DECISIONS against the live board + git/gh before reporting. Do not rebuild the picture from board/issues/memory while skipping the HEAD. PRECEDENCE: the HEAD is prior-session belief and MAY BE SUPERSEDED \u2014 the current live user/master instruction WINS over any conflicting HEAD anchor, NEXT, or checklist; follow the live instruction and treat the stale HEAD item as superseded.';
@@ -4384,6 +4394,19 @@ async function probeSagaAccess(url, key) {
     return false;
   }
 }
+async function fetchMemoryAge(url, project2) {
+  try {
+    const qs = new URLSearchParams({ project: project2 }).toString();
+    const res = await fetch(`${url}/saga/memory-age?${qs}`, { headers: await hubHeaders(), signal: AbortSignal.timeout(8e3) });
+    if (!res.ok) return void 0;
+    const body = await res.json();
+    if (!body.updatedAt) return void 0;
+    const ms = Date.now() - Date.parse(body.updatedAt);
+    return Number.isFinite(ms) && ms >= 0 ? ms / 864e5 : void 0;
+  } catch {
+    return void 0;
+  }
+}
 async function runSagaHealth(o, io = consoleIo) {
   const cfg = await loadConfig();
   const session = resolveSessionId();
@@ -4394,6 +4417,7 @@ async function runSagaHealth(o, io = consoleIo) {
     cfg.sagaApiUrl ? probeBackend(cfg.sagaApiUrl) : Promise.resolve({ reachable: false })
   ]);
   const authorized = cfg.sagaApiUrl && liveness.reachable ? await probeSagaAccess(cfg.sagaApiUrl, key) : void 0;
+  const memoryAgeDays = cfg.sagaApiUrl && liveness.reachable ? await fetchMemoryAge(cfg.sagaApiUrl, key.project) : void 0;
   const report = buildHealth({
     key,
     source,
@@ -4403,7 +4427,8 @@ async function runSagaHealth(o, io = consoleIo) {
     livenessMessage: liveness.message,
     authorized,
     sagaApiUrl: cfg.sagaApiUrl,
-    pendingNotes: readPending().length
+    pendingNotes: readPending().length,
+    memoryAgeDays
   });
   if (o.json) return io.log(JSON.stringify(report));
   if (o.banner) {
@@ -4414,6 +4439,7 @@ async function runSagaHealth(o, io = consoleIo) {
   if (o.quiet) return;
   io.log(`saga health: ${report.ok ? "OK" : "NOT OK"}`);
   if (report.problems.length) io.log(report.problems.map((p) => ` - ${p}`).join("\n"));
+  if (report.warnings.length) io.log(report.warnings.map((w) => ` - ${w}`).join("\n"));
   if (report.pendingNotes > 0) io.log(` - ${report.pendingNotes} note(s) queued locally \u2014 \`mmi-cli saga flush\` to roll forward`);
 }
 function registerSagaCommands(program3) {

package/dist/saga.cjs

@@ -3565,6 +3565,7 @@ async function runHeadEngine(prompt, timeoutMs = HEAD_ENGINE_TIMEOUT_MS) {
 }
 
 // src/saga-health.ts
+var MEMORY_STALE_DAYS = 14;
 function buildHealth(i) {
   const problems = [];
   if (!i.sagaApiUrl) problems.push("Hub API URL not configured");
@@ -3575,6 +3576,10 @@ function buildHealth(i) {
   }
   if (i.reachable && i.authorized === false) problems.push("saga backend rejected authenticated state access");
   if (!i.key.sessionId || i.key.sessionId === "-") problems.push("unsafe session id");
+  const warnings = [];
+  if (i.memoryAgeDays !== void 0 && i.memoryAgeDays > MEMORY_STALE_DAYS) {
+    warnings.push(`PROJECT MEMORY is ${Math.round(i.memoryAgeDays)}d stale \u2014 the saga-keeper may have stalled`);
+  }
   const safeToWrite = problems.length === 0;
   return {
     ok: safeToWrite,
@@ -3588,14 +3593,19 @@ function buildHealth(i) {
     pendingNotes: i.pendingNotes ?? 0,
     key: i.key,
     source: i.source,
-    problems
+    problems,
+    warnings,
+    memoryAgeDays: i.memoryAgeDays
   };
 }
 function healthBanner(report) {
-  if (report.ok) return null;
-  const summary = report.problems.slice(0, 2).join("; ") || "unknown saga health gap";
-  const suffix = report.problems.length > 2 ? ` (+${report.problems.length - 2} more)` : "";
-  return `saga health: CHECK - ${summary}${suffix}`;
+  if (report.problems.length) {
+    const summary = report.problems.slice(0, 2).join("; ") || "unknown saga health gap";
+    const suffix = report.problems.length > 2 ? ` (+${report.problems.length - 2} more)` : "";
+    return `saga health: CHECK - ${summary}${suffix}`;
+  }
+  if (report.warnings.length) return `saga health: NOTE - ${report.warnings.join("; ")}`;
+  return null;
 }
 function resumeCue() {
   return '> STATUS/RESUME CUE \u2014 For any status, resume, or "where do I stand" report: read THIS saga HEAD first (`mmi-cli saga show`), then reconcile its NEXT / LAST 5 / DECISIONS against the live board + git/gh before reporting. Do not rebuild the picture from board/issues/memory while skipping the HEAD. PRECEDENCE: the HEAD is prior-session belief and MAY BE SUPERSEDED \u2014 the current live user/master instruction WINS over any conflicting HEAD anchor, NEXT, or checklist; follow the live instruction and treat the stale HEAD item as superseded.';
@@ -4205,6 +4215,19 @@ async function probeSagaAccess(url, key) {
     return false;
   }
 }
+async function fetchMemoryAge(url, project) {
+  try {
+    const qs = new URLSearchParams({ project }).toString();
+    const res = await fetch(`${url}/saga/memory-age?${qs}`, { headers: await hubHeaders(), signal: AbortSignal.timeout(8e3) });
+    if (!res.ok) return void 0;
+    const body = await res.json();
+    if (!body.updatedAt) return void 0;
+    const ms = Date.now() - Date.parse(body.updatedAt);
+    return Number.isFinite(ms) && ms >= 0 ? ms / 864e5 : void 0;
+  } catch {
+    return void 0;
+  }
+}
 async function runSagaHealth(o, io = consoleIo) {
   const cfg = await loadConfig();
   const session = resolveSessionId();
@@ -4215,6 +4238,7 @@ async function runSagaHealth(o, io = consoleIo) {
     cfg.sagaApiUrl ? probeBackend(cfg.sagaApiUrl) : Promise.resolve({ reachable: false })
   ]);
   const authorized = cfg.sagaApiUrl && liveness.reachable ? await probeSagaAccess(cfg.sagaApiUrl, key) : void 0;
+  const memoryAgeDays = cfg.sagaApiUrl && liveness.reachable ? await fetchMemoryAge(cfg.sagaApiUrl, key.project) : void 0;
   const report = buildHealth({
     key,
     source,
@@ -4224,7 +4248,8 @@ async function runSagaHealth(o, io = consoleIo) {
     livenessMessage: liveness.message,
     authorized,
     sagaApiUrl: cfg.sagaApiUrl,
-    pendingNotes: readPending().length
+    pendingNotes: readPending().length,
+    memoryAgeDays
   });
   if (o.json) return io.log(JSON.stringify(report));
   if (o.banner) {
@@ -4235,6 +4260,7 @@ async function runSagaHealth(o, io = consoleIo) {
   if (o.quiet) return;
   io.log(`saga health: ${report.ok ? "OK" : "NOT OK"}`);
   if (report.problems.length) io.log(report.problems.map((p) => ` - ${p}`).join("\n"));
+  if (report.warnings.length) io.log(report.warnings.map((w) => ` - ${w}`).join("\n"));
   if (report.pendingNotes > 0) io.log(` - ${report.pendingNotes} note(s) queued locally \u2014 \`mmi-cli saga flush\` to roll forward`);
 }
 function registerSagaCommands(program2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "2.26.0",
+  "version": "2.27.0",
   "description": "MMI Future CLI — delivers the org rules (whole-file), plus saga and KB access. The cross-IDE engine the plugin's SessionStart hook drives.",
   "type": "module",
   "license": "UNLICENSED",