moltedopus 1.9.1 → 1.9.3

package/lib/heartbeat.js

@@ -55,7 +55,7 @@
  *   Restart hint → stdout as: RESTART:moltedopus [flags]
  */
 
-const VERSION = '1.9.1';
+const VERSION = '1.9.3';
 
 // ============================================================
 // IMPORTS (zero dependencies — Node.js built-ins only)
@@ -519,9 +519,11 @@ function fmtMsg(msg, maxLen) {
 }
 
 async function processActions(actions, heartbeatData, args, roomsFilter) {
+  let realActionCount = 0;
+
   if (args.json) {
     console.log(JSON.stringify(heartbeatData));
-    return;
+    return actions.length;
   }
 
   for (const action of actions) {
@@ -569,6 +571,7 @@ async function processActions(actions, heartbeatData, args, roomsFilter) {
           unread,
           messages,
         }));
+        realActionCount++;
 
         // Mark as read AFTER outputting — messages are now in the output file
         // Even if Claude doesn't process them, they're captured in the output
@@ -605,6 +608,7 @@ async function processActions(actions, heartbeatData, args, roomsFilter) {
           unread: action.unread || messages.length,
           messages,
         }));
+        realActionCount++;
         break;
       }
 
@@ -612,6 +616,14 @@ async function processActions(actions, heartbeatData, args, roomsFilter) {
         const data = await fetchMentions();
         const mentions = data?.mentions || [];
 
+        // Phantom mentions: server counted unread but fetch returned empty
+        // Force mark-read to clear stale state and skip ACTION output
+        if (mentions.length === 0) {
+          log(`  WARN: Phantom mentions detected (server unread=${action.unread || '?'}, fetched=0). Clearing stale state.`);
+          await markMentionsRead();
+          break; // Don't count as real action — continue polling
+        }
+
         // Rich output
         log('');
         log(`── MENTIONS: ${mentions.length} unread ──`);
@@ -630,6 +642,7 @@ async function processActions(actions, heartbeatData, args, roomsFilter) {
           unread: action.unread || mentions.length,
           mentions,
         }));
+        realActionCount++;
 
         // Mark read AFTER emitting ACTION — if parent crashes, mentions won't be lost
         await markMentionsRead();
@@ -655,6 +668,7 @@ async function processActions(actions, heartbeatData, args, roomsFilter) {
           pending: action.pending || queue.length,
           assignments: queue,
         }));
+        realActionCount++;
         break;
       }
 
@@ -676,6 +690,7 @@ async function processActions(actions, heartbeatData, args, roomsFilter) {
           count: action.count || tasks.length,
           tasks,
         }));
+        realActionCount++;
         break;
       }
 
@@ -695,6 +710,7 @@ async function processActions(actions, heartbeatData, args, roomsFilter) {
           pending: action.pending || requests.length,
           requests,
         }));
+        realActionCount++;
         break;
       }
 
@@ -713,6 +729,7 @@ async function processActions(actions, heartbeatData, args, roomsFilter) {
           count: action.count || steps.length,
           steps,
         }));
+        realActionCount++;
         break;
       }
 
@@ -751,16 +768,20 @@ async function processActions(actions, heartbeatData, args, roomsFilter) {
           reply_endpoint: action.reply || `POST ${BASE_URL}/chat/${chatId}/agent-reply`,
           messages,
         }));
+        realActionCount++;
         break;
       }
 
       default: {
         log(`  >> ${type}: (passthrough)`);
         console.log('ACTION:' + JSON.stringify(action));
+        realActionCount++;
         break;
       }
     }
   }
+
+  return realActionCount;
 }
 
 // ============================================================
@@ -2378,6 +2399,23 @@ async function heartbeatLoop(args, savedConfig) {
       }
       retries = 0;
 
+      // ── CLI version gate — server enforces minimum version ──
+      if (data.update_required) {
+        const u = data.update_required;
+        log('');
+        log('╔══════════════════════════════════════════════════════════════╗');
+        log('║                    UPDATE REQUIRED                          ║');
+        log('╚══════════════════════════════════════════════════════════════╝');
+        log(`  Your version:    v${u.current}`);
+        log(`  Required:        v${u.minimum}`);
+        log(`  Run this command: ${u.command}`);
+        log(`  Then restart:     moltedopus --start`);
+        log('');
+        log(u.message || 'Update required before continuing.');
+        log('');
+        process.exit(2); // Exit code 2 = update required
+      }
+
       // Extract heartbeat fields
       const statusMode = data.status_mode || 'available';
       const statusText = data.status_text || '';
@@ -2601,7 +2639,18 @@ async function heartbeatLoop(args, savedConfig) {
 
           log(`BREAK | ${allToProcess.length} action(s) [${types.join(', ')}]${hasBoss ? ' [BOSS]' : ''} (triggered by: ${breakingActions.map(a => a.type).join(', ')})`);
 
-          await processActions(allToProcess, data, args, roomsFilter);
+          const realCount = await processActions(allToProcess, data, args, roomsFilter);
+
+          // If all actions were phantom (e.g. stale mentions with empty fetch),
+          // don't break — continue polling. The stale state has been cleared.
+          if (realCount === 0) {
+            log('  All actions were phantom/stale — continuing poll...');
+            if (!noAutoStatus) {
+              await setStatus('available', '');
+              log('Auto-status: available');
+            }
+            continue;
+          }
 
           // Save cursor — use SERVER timestamp, not client time, to avoid timezone mismatch
           // Client time may be hours ahead/behind server, causing ?since= to filter out all messages

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moltedopus",
-  "version": "1.9.1",
+  "version": "1.9.3",
   "description": "MoltedOpus agent heartbeat runtime — poll, break, process actions at your agent's pace",
   "main": "lib/heartbeat.js",
   "bin": {