@yemi33/minions 0.1.1005 → 0.1.1006

package/CHANGELOG.md

@@ -1,8 +1,9 @@
 # Changelog
 
-## 0.1.1005 (2026-04-16)
+## 0.1.1006 (2026-04-16)
 
 ### Features
+- cap pendingContexts in cooldowns.json to prevent bloat (#1126)
 - fix stopAfter=0 watch expiry — run forever for all conditions (#1117)
 - fix doc-chat Clear chat not persisting session deletion to localStorage (#1102)
 - remove DEFAULTS alias from timeout.js (#1101)
@@ -22,7 +23,6 @@
 - reassign tasks when preferred agent is busy too long
 - wire agentBusyReassignMs into settings UI and persist
 -  ADO throttle detection, poll guards, and dashboard banner (#1051)
-- gate auto-fix conflict dispatch behind autoFixConflicts flag
 
 ### Fixes
 -  harden repo-scoped PR identity handling

package/engine/cleanup.js

@@ -8,7 +8,7 @@ const path = require('path');
 const shared = require('./shared');
 const queries = require('./queries');
 
-const { exec, execSilent, log, ts } = shared;
+const { exec, execSilent, log, ts, ENGINE_DEFAULTS } = shared;
 const { safeJson, safeWrite, safeReadDir, mutateWorkItems, getProjects, projectWorkItemsPath, projectPrPath,
   sanitizeBranch, KB_CATEGORIES } = shared;
 const { getDispatch, getAgentStatus } = queries;
@@ -597,11 +597,23 @@ function runCleanup(config, verbose = false) {
   } catch (e) { log('warn', 'prune doc-sessions: ' + e.message); }
 
   // 11. Cap cooldowns.json — keep at most 500 entries (on top of 24h TTL in cooldown.js)
+  //     Also trim pendingContexts arrays to ENGINE_DEFAULTS.maxPendingContexts to prevent bloat.
   cleaned.cooldowns = 0;
+  cleaned.pendingContextsTrimmed = 0;
   try {
     const cooldownPath = path.join(ENGINE_DIR, 'cooldowns.json');
     const cooldowns = safeJson(cooldownPath);
     if (cooldowns && typeof cooldowns === 'object') {
+      let dirty = false;
+      // Trim oversized pendingContexts arrays (one-time migration + ongoing cap)
+      const pendingCtxCap = ENGINE_DEFAULTS.maxPendingContexts;
+      for (const v of Object.values(cooldowns)) {
+        if (Array.isArray(v.pendingContexts) && v.pendingContexts.length > pendingCtxCap) {
+          v.pendingContexts = v.pendingContexts.slice(-pendingCtxCap);
+          cleaned.pendingContextsTrimmed++;
+          dirty = true;
+        }
+      }
       const entries = Object.entries(cooldowns);
       const COOLDOWN_CAP = 500;
       if (entries.length > COOLDOWN_CAP) {
@@ -610,6 +622,8 @@ function runCleanup(config, verbose = false) {
         const keep = Object.fromEntries(entries.slice(0, COOLDOWN_CAP));
         cleaned.cooldowns = entries.length - COOLDOWN_CAP;
         safeWrite(cooldownPath, keep);
+      } else if (dirty) {
+        safeWrite(cooldownPath, cooldowns);
       }
     }
   } catch (e) { log('warn', 'cap cooldowns: ' + e.message); }
@@ -653,8 +667,8 @@ function runCleanup(config, verbose = false) {
     }
   } catch { /* optional — file may not exist */ }
 
-  if (cleaned.ccSessions + cleaned.docSessions + cleaned.cooldowns + cleaned.pidFiles > 0) {
-    log('info', `Cleanup (resources): ${cleaned.ccSessions} cc-sessions, ${cleaned.docSessions} doc-sessions, ${cleaned.cooldowns} cooldowns, ${cleaned.pidFiles} PID files`);
+  if (cleaned.ccSessions + cleaned.docSessions + cleaned.cooldowns + cleaned.pidFiles + cleaned.pendingContextsTrimmed > 0) {
+    log('info', `Cleanup (resources): ${cleaned.ccSessions} cc-sessions, ${cleaned.docSessions} doc-sessions, ${cleaned.cooldowns} cooldowns, ${cleaned.pendingContextsTrimmed} pendingCtx trimmed, ${cleaned.pidFiles} PID files`);
   }
 
   return cleaned;

package/engine/cooldown.js

@@ -7,7 +7,7 @@ const path = require('path');
 const shared = require('./shared');
 const queries = require('./queries');
 
-const { safeJson, safeWrite, log } = shared;
+const { safeJson, safeWrite, log, ENGINE_DEFAULTS } = shared;
 const { ENGINE_DIR } = queries;
 
 const COOLDOWN_PATH = path.join(ENGINE_DIR, 'cooldowns.json');
@@ -37,6 +37,13 @@ function saveCooldowns() {
     for (const [k, v] of dispatchCooldowns) {
       if (now - v.timestamp > 24 * 60 * 60 * 1000) dispatchCooldowns.delete(k);
     }
+    // Trim pendingContexts arrays before writing to prevent bloat
+    const cap = ENGINE_DEFAULTS.maxPendingContexts;
+    for (const [, v] of dispatchCooldowns) {
+      if (Array.isArray(v.pendingContexts) && v.pendingContexts.length > cap) {
+        v.pendingContexts = v.pendingContexts.slice(-cap);
+      }
+    }
     const obj = Object.fromEntries(dispatchCooldowns);
     try {
       safeWrite(COOLDOWN_PATH, obj);
@@ -61,8 +68,11 @@ function setCooldown(key) {
 
 function setCooldownWithContext(key, context) {
   const existing = dispatchCooldowns.get(key);
-  const pendingContexts = existing?.pendingContexts || [];
+  let pendingContexts = existing?.pendingContexts || [];
   if (context) pendingContexts.push(context);
+  // Cap to last N entries to prevent unbounded growth (cooldowns.json bloat)
+  const cap = ENGINE_DEFAULTS.maxPendingContexts;
+  if (pendingContexts.length > cap) pendingContexts = pendingContexts.slice(-cap);
   dispatchCooldowns.set(key, {
     timestamp: Date.now(),
     failures: existing?.failures || 0,

package/engine/shared.js

@@ -569,6 +569,7 @@ const ENGINE_DEFAULTS = {
   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)
+  maxPendingContexts: 20, // cap pendingContexts arrays in cooldowns.json to prevent unbounded growth
   ccMaxTurns: 50, // max tool-use turns for CC/doc-chat before CLI stops
   // Teams integration — config.teams shape: { enabled, appId, appPassword, certPath, privateKeyPath, tenantId, notifyEvents, ccMirror, inboxPollInterval }
   // Auth modes: (1) appId + appPassword (client secret), or (2) appId + certPath + privateKeyPath + tenantId (certificate)

package/package.json

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