@yemi33/minions 0.1.850 → 0.1.851

package/CHANGELOG.md

@@ -1,8 +1,9 @@
 # Changelog
 
-## 0.1.850 (2026-04-11)
+## 0.1.851 (2026-04-11)
 
 ### Features
+- per-type heartbeat timeouts for read-heavy work types (#652)
 - Replace raw status strings with WI_STATUS constants in dashboard.js (#657)
 - fix dispatch.json race condition in CLI kill-all (#653)
 -  optimistic UI updates for all remaining dashboard pages

package/engine/shared.js

@@ -552,6 +552,7 @@ const ENGINE_DEFAULTS = {
   ignoredCommentAuthors: [], // comments from these authors are auto-closed and never trigger fixes
   ccModel: 'sonnet', // model for Command Center and doc-chat (sonnet, haiku, opus)
   ccEffort: null, // effort level for CC/doc-chat (null, 'low', 'medium', 'high')
+  heartbeatTimeouts: {}, // populated after WORK_TYPE is defined (below)
   ccMaxTurns: 50, // max tool-use turns for CC/doc-chat before CLI stops
   // Teams integration — config.teams shape: { enabled, appId, appPassword, notifyEvents, ccMirror, inboxPollInterval }
   teams: {
@@ -582,6 +583,15 @@ const WORK_TYPE = {
   VERIFY: 'verify', PLAN: 'plan', PLAN_TO_PRD: 'plan-to-prd', DECOMPOSE: 'decompose',
   MEETING: 'meeting', EXPLORE: 'explore', ASK: 'ask', TEST: 'test', DOCS: 'docs',
 };
+
+// Per-work-type heartbeat timeouts (ms) — read-heavy tasks need longer silence windows.
+// Keyed by WORK_TYPE constants; types not listed fall back to ENGINE_DEFAULTS.heartbeatTimeout.
+Object.assign(ENGINE_DEFAULTS.heartbeatTimeouts, {
+  [WORK_TYPE.EXPLORE]: 600000,   // 10 min — spends most time reading/analyzing, minimal stdout
+  [WORK_TYPE.ASK]:     600000,   // 10 min — research-heavy, long silent analysis periods
+  [WORK_TYPE.REVIEW]:  480000,   // 8 min — code review reads extensively before producing output
+});
+
 const PLAN_STATUS = {
   ACTIVE: 'active', AWAITING_APPROVAL: 'awaiting-approval', APPROVED: 'approved',
   PAUSED: 'paused', REJECTED: 'rejected', COMPLETED: 'completed',

package/engine/timeout.js

@@ -9,7 +9,7 @@ const shared = require('./shared');
 const queries = require('./queries');
 
 const { safeRead, safeWrite, safeJson, mutateJsonFileLocked, getProjects, projectWorkItemsPath, log, ts,
-  ENGINE_DEFAULTS: DEFAULTS, WI_STATUS, DISPATCH_RESULT, AGENT_STATUS } = shared;
+  ENGINE_DEFAULTS: DEFAULTS, WI_STATUS, WORK_TYPE, DISPATCH_RESULT, AGENT_STATUS } = shared;
 const { getDispatch, getAgentStatus } = queries;
 const AGENTS_DIR = queries.AGENTS_DIR;
 const MINIONS_DIR = shared.MINIONS_DIR;
@@ -130,7 +130,7 @@ function checkTimeouts(config) {
   const { runPostCompletionHooks } = require('./lifecycle');
 
   const timeout = config.engine?.agentTimeout || DEFAULTS.agentTimeout;
-  const heartbeatTimeout = config.engine?.heartbeatTimeout || DEFAULTS.heartbeatTimeout;
+  const defaultHeartbeatTimeout = config.engine?.heartbeatTimeout || DEFAULTS.heartbeatTimeout;
 
   // Per-type heartbeat timeouts: merge ENGINE_DEFAULTS ← config overrides
   const perTypeTimeouts = { ...DEFAULTS.heartbeatTimeouts, ...(config.engine?.heartbeatTimeouts || {}) };
@@ -155,6 +155,10 @@ function checkTimeouts(config) {
   for (const item of (dispatchData.active || [])) {
     if (!item.agent) continue;
 
+    // Per-type heartbeat: look up work type from dispatch item, fall back to default
+    const workType = item.workType || item.meta?.item?.type;
+    const heartbeatTimeout = (workType && perTypeTimeouts[workType]) || defaultHeartbeatTimeout;
+
     const hasProcess = activeProcesses.has(item.id);
     const liveLogPath = path.join(AGENTS_DIR, item.agent, 'live-output.log');
     let lastActivity = item.started_at ? new Date(item.started_at).getTime() : 0;

package/package.json

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