@yemi33/minions 0.1.763 → 0.1.764

package/CHANGELOG.md

@@ -1,11 +1,12 @@
 # Changelog
 
-## 0.1.763 (2026-04-10)
+## 0.1.764 (2026-04-10)
 
 ### Features
 -  pulsing blue dot on CC tabs with active requests
 
 ### Fixes
+-  prevent stale dispatched work items from showing agent as working indefinitely
 -  only trigger verify when all PRD items succeed, not on partial failure
 -  clean handoff between restore and original stream intervals
 -  prevent competing thinking intervals on tab switch

package/engine/queries.js

@@ -11,7 +11,7 @@ const shared = require('./shared');
 
 const { safeRead, safeReadDir, safeJson, safeWrite, getProjects,
   projectWorkItemsPath, projectPrPath, parseSkillFrontmatter, KB_CATEGORIES,
-  WI_STATUS } = shared;
+  WI_STATUS, ENGINE_DEFAULTS } = shared;
 
 /**
  * Read the first `bytes` and last `bytes` of a file efficiently using byte offsets.
@@ -265,14 +265,21 @@ function getAgentStatus(agentId) {
 
   // Fallback: derive active state from work-item markers.
   // This protects UI status when dispatch.json briefly desyncs from work-item files.
+  // Guard: only trust dispatched state within 2x heartbeatTimeout to prevent stale
+  // dispatched items from permanently showing an agent as working after a dead process.
   try {
     const config = getConfig();
+    const heartbeatTimeout = config.engine?.heartbeatTimeout || ENGINE_DEFAULTS.heartbeatTimeout;
+    const staleThresholdMs = heartbeatTimeout * 2;
+    const now = Date.now();
     const allItems = getWorkItems(config);
     const latestInFlight = allItems
-      .filter(w =>
-        (w.dispatched_to || '').toLowerCase() === String(agentId).toLowerCase() &&
-        w.status === WI_STATUS.DISPATCHED
-      )
+      .filter(w => {
+        if ((w.dispatched_to || '').toLowerCase() !== String(agentId).toLowerCase()) return false;
+        if (w.status !== WI_STATUS.DISPATCHED) return false;
+        const ageMs = w.dispatched_at ? now - new Date(w.dispatched_at).getTime() : Infinity;
+        return ageMs < staleThresholdMs;
+      })
       .sort((a, b) => (b.dispatched_at || '').localeCompare(a.dispatched_at || ''))[0];
     if (latestInFlight) {
       return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.763",
+  "version": "0.1.764",
   "description": "Multi-agent AI dev team that runs from ~/.minions/ — five autonomous agents share a single engine, dashboard, and knowledge base",
   "bin": {
     "minions": "bin/minions.js"