@yemi33/minions 0.1.729 → 0.1.730

package/CHANGELOG.md

@@ -1,8 +1,9 @@
 # Changelog
 
-## 0.1.729 (2026-04-09)
+## 0.1.730 (2026-04-09)
 
 ### Features
+- Per-type heartbeat timeouts for read-heavy work types
 - playbook improvements — soften CAPS, add context-awareness, restructure decompose output
 - pipeline auto-detect — skip wait/plan stages when artifacts exist
 - replace raw status strings with WI_STATUS constants in dashboard.js
@@ -15,6 +16,7 @@
 - make post-verify plan archiving opt-in via autoArchive config
 
 ### Fixes
+-  show 'queued' instead of 'already dispatched' for pending work items
 -  resolve 3 failing unit tests on PR-661
 -  repair 3 pre-existing test failures in source-pattern tests
 -  merge master, sync dashboard-build jsFiles, bump HTML size limit

package/dashboard/js/render-work-items.js

@@ -48,7 +48,8 @@ function wiRow(item) {
     '<td>' + typeBadge(item.type) + '</td>' +
     '<td>' + priBadge(item.priority) + '</td>' +
     '<td>' + statusBadge(item.status || 'pending') +
-      (item._pendingReason && item.status === 'pending' ? ' <span style="font-size:9px;color:var(--muted);margin-left:4px" title="Pending reason: ' + escHtml(item._pendingReason) + '">' + escHtml(item._pendingReason.replace(/_/g, ' ')) + '</span>' : '') +
+      (item._pendingReason && item.status === 'pending' && item._pendingReason !== 'already_dispatched' ? ' <span style="font-size:9px;color:var(--muted);margin-left:4px" title="Pending reason: ' + escHtml(item._pendingReason) + '">' + escHtml(item._pendingReason.replace(/_/g, ' ')) + '</span>' : '') +
+      (item._pendingReason === 'already_dispatched' && item.status === 'pending' ? ' <span style="font-size:9px;color:var(--blue);margin-left:4px" title="In dispatch queue, waiting to be assigned">queued</span>' : '') +
       (item._skipReason && item.status === 'pending' ? ' <span style="font-size:9px;color:var(--yellow);margin-left:4px" title="Dispatch blocked: ' + escHtml(item._skipReason) + (item._blockedBy ? ' (by ' + escHtml(item._blockedBy) + ')' : '') + '">' + escHtml(item._skipReason.replace(/_/g, ' ')) + (item._blockedBy ? ' <span style="color:var(--muted)">(' + escHtml(item._blockedBy) + ')</span>' : '') + '</span>' : '') +
       (item.status === 'failed' ? ' ' + wiRetryBtn(item) : '') +
     '</td>' +
@@ -440,7 +441,7 @@ function openWorkItemDetail(id) {
   if (item.dispatched_at) html += field('Dispatched', escHtml(new Date(item.dispatched_at).toLocaleString()) + ' to ' + escHtml(item.dispatched_to || '?'));
   if (item.completedAt) html += field('Completed', escHtml(new Date(item.completedAt).toLocaleString()));
   if (item.failReason) html += field('Failure Reason', '<span style="color:var(--red)">' + escHtml(item.failReason) + '</span>');
-  if (item._pendingReason && item.status === 'pending') html += field('Pending Reason', escHtml(item._pendingReason.replace(/_/g, ' ')));
+  if (item._pendingReason && item.status === 'pending') html += field('Pending Reason', item._pendingReason === 'already_dispatched' ? 'Queued — waiting for available agent slot' : escHtml(item._pendingReason.replace(/_/g, ' ')));
   if (item._skipReason && item.status === 'pending') html += field('Dispatch Blocked', '<span style="color:var(--yellow)">' + escHtml(item._skipReason.replace(/_/g, ' ')) + '</span>' + (item._blockedBy ? ' — blocked by <strong>' + escHtml(item._blockedBy) + '</strong>' : ''));
   if (item.depends_on?.length) html += field('Depends On', item.depends_on.map(d => '<code>' + escHtml(d) + '</code>').join(', '));
   if (item.acceptanceCriteria?.length) html += field('Acceptance Criteria', '<ul style="margin:0;padding-left:20px">' + item.acceptanceCriteria.map(c => '<li>' + escHtml(c) + '</li>').join('') + '</ul>');

package/engine/shared.js

@@ -518,7 +518,8 @@ const ENGINE_DEFAULTS = {
   maxConcurrent: 5,
   inboxConsolidateThreshold: 5,
   agentTimeout: 18000000,  // 5h
-  heartbeatTimeout: 300000, // 5min
+  heartbeatTimeout: 300000, // 5min — base heartbeat for most work types
+  heartbeatTimeouts: {}, // per-type overrides; merged with defaults at runtime (see timeout.js)
   maxTurns: 100,
   worktreeCreateTimeout: 300000, // 5min for git worktree add on large Windows repos
   worktreeCreateRetries: 1, // retry once on transient timeout/lock races

package/engine/timeout.js

@@ -132,6 +132,9 @@ function checkTimeouts(config) {
   const timeout = config.engine?.agentTimeout || DEFAULTS.agentTimeout;
   const heartbeatTimeout = config.engine?.heartbeatTimeout || DEFAULTS.heartbeatTimeout;
 
+  // Per-type heartbeat timeouts: merge defaults ← ENGINE_DEFAULTS ← config overrides
+  const perTypeTimeouts = { ...DEFAULT_HEARTBEAT_TIMEOUTS, ...DEFAULTS.heartbeatTimeouts, ...(config.engine?.heartbeatTimeouts || {}) };
+
   // 1. Check tracked processes for hard timeout (supports per-item deadline from fan-out)
   for (const [id, info] of activeProcesses.entries()) {
     const itemTimeout = info.meta?.deadline ? Math.max(0, info.meta.deadline - new Date(info.startedAt).getTime()) : timeout;
@@ -195,13 +198,16 @@ function checkTimeouts(config) {
       }
     } catch (e) { log('warn', 'output completion detection: ' + e.message); }
 
+    // Resolve per-type heartbeat timeout: per-type map → base heartbeatTimeout fallback
+    const itemHeartbeat = perTypeTimeouts[item.type] || heartbeatTimeout;
+
     // Check if agent is in a blocking tool call (TaskOutput block:true, Bash with long timeout, etc.)
     // These tools produce no stdout for extended periods — don't kill them prematurely
     // Check for BOTH tracked and untracked processes (orphan case after engine restart)
     let isBlocking = false;
-    let blockingTimeout = heartbeatTimeout;
+    let blockingTimeout = itemHeartbeat;
     let blockingTool = '';
-    if (silentMs > heartbeatTimeout) {
+    if (silentMs > itemHeartbeat) {
       try {
         const liveLog = safeRead(liveLogPath);
         if (liveLog) {
@@ -219,7 +225,7 @@ function checkTimeouts(config) {
               // TaskOutput with block:true — waiting for a background task
               if (name === 'TaskOutput' && input.block === true) {
                 const taskTimeout = input.timeout || 600000; // default 10min
-                blockingTimeout = Math.max(heartbeatTimeout, taskTimeout + 60000); // task timeout + 1min grace
+                blockingTimeout = Math.max(itemHeartbeat, taskTimeout + 60000); // task timeout + 1min grace
                 isBlocking = true;
                 blockingTool = 'TaskOutput';
               }
@@ -227,13 +233,13 @@ function checkTimeouts(config) {
               if (name === 'Bash') {
                 // Use explicit timeout if set, otherwise match Claude Code's actual Bash default (120s)
                 const bashTimeout = input.timeout || 120000;
-                blockingTimeout = Math.max(heartbeatTimeout, bashTimeout + 60000);
+                blockingTimeout = Math.max(itemHeartbeat, bashTimeout + 60000);
                 isBlocking = true;
                 blockingTool = 'Bash';
               }
               // Agent (subagent) tool call — parent waits silently for child to complete
               if (name === 'Agent') {
-                blockingTimeout = Math.max(heartbeatTimeout, 1800000); // 30min for subagents
+                blockingTimeout = Math.max(itemHeartbeat, 1800000); // 30min for subagents
                 isBlocking = true;
                 blockingTool = 'Agent';
               }
@@ -259,7 +265,7 @@ function checkTimeouts(config) {
       blockingAnnotations.set(item.id, null);
     }
 
-    const effectiveTimeout = isBlocking ? blockingTimeout : heartbeatTimeout;
+    const effectiveTimeout = isBlocking ? blockingTimeout : itemHeartbeat;
 
     // Skip recently-steered agents — they're being killed and re-spawned
     const procInfo = activeProcesses.get(item.id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.729",
+  "version": "0.1.730",
   "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"