@yemi33/minions 0.1.164 → 0.1.166

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.1.166 (2026-04-02)
+
+### Engine
+- engine.js
+
+## 0.1.165 (2026-04-02)
+
+### Engine
+- engine.js
+
 ## 0.1.164 (2026-04-02)
 
 ### Engine

package/engine.js

@@ -1521,6 +1521,7 @@ function discoverFromWorkItems(config, project) {
         ].filter(Boolean).join('\n');
         vars.checkpoint_context = cpSummary;
         log('info', `Injecting checkpoint context for ${item.id} (resume #${cpCount})`);
+        try { fs.unlinkSync(cpPath); } catch (ue) { log('warn', `checkpoint cleanup for ${item.id}: ${ue.message}`); }
       }
     } catch (e) { log('warn', `checkpoint read for ${item.id}: ${e.message}`); }
 
@@ -1802,6 +1803,42 @@ function discoverCentralWorkItems(config) {
         assignedProject: projects.length > 0 ? projects[i % projects.length] : null
       }));
 
+      // Inject checkpoint context if agent left a checkpoint.json from a prior run
+      let fanOutCheckpointContext = '';
+      try {
+        const fanFirstProject = projects[0];
+        const fanBranch = item.branch || `work/${item.id}`;
+        const fanWtPath = fanFirstProject?.localPath
+          ? path.resolve(fanFirstProject.localPath, config.engine?.worktreeRoot || '../worktrees', fanBranch)
+          : '';
+        const fanCpPath = fanWtPath ? path.join(fanWtPath, 'checkpoint.json') : '';
+        if (fanCpPath && fs.existsSync(fanCpPath)) {
+          const fanCpData = JSON.parse(fs.readFileSync(fanCpPath, 'utf8'));
+          const fanCpCount = (item._checkpointCount || 0) + 1;
+          if (fanCpCount > 3) {
+            log('warn', `Work item ${item.id} exceeded 3 checkpoint-resumes — marking as needs-human-review`);
+            item.status = 'needs-human-review';
+            item._checkpointCount = fanCpCount;
+            needsWrite = true;
+            continue;
+          }
+          item._checkpointCount = fanCpCount;
+          const fanCpSummary = [
+            `## Checkpoint (Resume #${fanCpCount}/3)`,
+            '',
+            'A previous agent run timed out but left a checkpoint. Continue from where it left off.',
+            '',
+            Array.isArray(fanCpData.completed) && fanCpData.completed.length > 0 ? `### Completed\n${fanCpData.completed.map(s => '- ' + s).join('\n')}` : '',
+            Array.isArray(fanCpData.remaining) && fanCpData.remaining.length > 0 ? `### Remaining\n${fanCpData.remaining.map(s => '- ' + s).join('\n')}` : '',
+            Array.isArray(fanCpData.blockers) && fanCpData.blockers.length > 0 ? `### Blockers\n${fanCpData.blockers.map(s => '- ' + s).join('\n')}` : '',
+            fanCpData.branch_state ? `### Branch State\n${fanCpData.branch_state}` : '',
+          ].filter(Boolean).join('\n');
+          fanOutCheckpointContext = fanCpSummary;
+          log('info', `Injecting checkpoint context for ${item.id} (resume #${fanCpCount})`);
+          try { fs.unlinkSync(fanCpPath); } catch (ue) { log('warn', `checkpoint cleanup for ${item.id}: ${ue.message}`); }
+        }
+      } catch (e) { log('warn', `checkpoint read for ${item.id}: ${e.message}`); }
+
       for (const { agent, assignedProject } of assignments) {
         const fanKey = `${key}-${agent.id}`;
         if (isAlreadyDispatched(fanKey)) continue;
@@ -1833,6 +1870,10 @@ function discoverCentralWorkItems(config) {
           ? '## Push Branch\n\n**PR creation is skipped for this work item.** Push your branch and report the branch name.\n\n```bash\ngit push -u origin ' + fanBranch + '\n```\n\nInclude the branch name in your completion summary.'
           : '## Create PR (MANDATORY)\n\n**Your task is NOT complete until a pull request exists.** If PR creation fails, retry up to 3 times before reporting the error.\n\n{{pr_create_instructions}}\n- sourceRefName: `refs/heads/' + fanBranch + '`\n- targetRefName: `refs/heads/{{main_branch}}`\n- title: `{{commit_message}}`\n- labels: `["minions:{{agent_id}}"]`\n\nInclude in the PR description:\n- What was built and why\n- Files changed\n- How to build and test, browser URL if applicable\n- Test plan\n\n## Post self-review on PR\n\n{{pr_comment_instructions}}\n- pullRequestId: `<from PR creation>`\n- Re-read your own diff critically before posting\n- Sign: `Built by Minions ({{agent_name}} — {{agent_role}})`';
 
+        // Inject checkpoint context (computed once above the loop)
+        vars.checkpoint_context = fanOutCheckpointContext;
+
+
         if (workType === 'ask') {
           vars.question = item.title + (item.description ? '\n\n' + item.description : '');
           vars.task_id = item.id;
@@ -1878,6 +1919,7 @@ function discoverCentralWorkItems(config) {
       item.dispatched_to = idleAgents.map(a => a.id).join(', ');
       item.scope = 'fan-out';
       item.fanOutAgents = idleAgents.map(a => a.id);
+      delete item._pendingReason;
       needsWrite = true;
       setCooldown(key);
       log('info', `Fan-out: ${item.id} dispatched to ${idleAgents.length} agents: ${idleAgents.map(a => a.name).join(', ')}`);
@@ -1946,6 +1988,7 @@ function discoverCentralWorkItems(config) {
           ].filter(Boolean).join('\n');
           vars.checkpoint_context = cpSummary;
           log('info', `Injecting checkpoint context for ${item.id} (resume #${cpCount})`);
+          try { fs.unlinkSync(cpPath); } catch (ue) { log('warn', `checkpoint cleanup for ${item.id}: ${ue.message}`); }
         }
       } catch (e) { log('warn', `checkpoint read for ${item.id}: ${e.message}`); }
 
@@ -2028,6 +2071,7 @@ function discoverCentralWorkItems(config) {
       item.status = 'dispatched';
       item.dispatched_at = ts();
       item.dispatched_to = agentId;
+      delete item._pendingReason;
       needsWrite = true;
       setCooldown(key);
     }

package/package.json

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