@yemi33/minions 0.1.55 → 0.1.57

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.1.57 (2026-03-30)
+
+### Engine
+- engine.js
+
+## 0.1.56 (2026-03-30)
+
+### Other
+- bin/minions.js
+
 ## 0.1.55 (2026-03-30)
 
 ### Engine

package/bin/minions.js

@@ -472,6 +472,7 @@ if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
     minions spawn <agent> <prompt>   Manually spawn an agent
     minions plan <file|text> [proj]  Run a plan
     minions cleanup                  Clean temp files, worktrees, zombies
+    minions reset --confirm          Factory reset (delete all state, keep config)
 
   Dashboard:
     minions dash                     Start web dashboard (default :7331)
@@ -500,6 +501,68 @@ if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
   dashProc.unref();
   console.log(`  Dashboard started (PID: ${dashProc.pid})`);
   console.log('  Dashboard: http://localhost:7331\n');
+} else if (cmd === 'reset') {
+  ensureInstalled();
+  if (!rest.includes('--confirm')) {
+    console.log(`
+  This will DELETE all runtime state:
+    - Work items, dispatch queue, PRDs, plans
+    - Agent history, sessions, output logs
+    - Notes, knowledge base, pinned notes
+    - Metrics, cooldowns, schedules
+
+  Config.json and agent charters are PRESERVED.
+
+  Run: minions reset --confirm
+`);
+    process.exit(0);
+  }
+  // Stop engine + dashboard
+  try { execSync(`node "${path.join(MINIONS_HOME, 'engine.js')}" stop`, { stdio: 'ignore', cwd: MINIONS_HOME }); } catch {}
+  const glob = (dir, pattern) => { try { return fs.readdirSync(dir).filter(f => pattern.test(f)).map(f => path.join(dir, f)); } catch { return []; } };
+  const rm = (f) => { try { fs.unlinkSync(f); } catch {} };
+  const rmDir = (d) => { try { fs.rmSync(d, { recursive: true, force: true }); } catch {} };
+  const engineDir = path.join(MINIONS_HOME, 'engine');
+  // Engine state
+  for (const f of ['dispatch.json', 'control.json', 'log.json', 'metrics.json', 'cooldowns.json', 'schedule-runs.json', 'kb-checkpoint.json', 'cc-session.json', 'doc-sessions.json']) rm(path.join(engineDir, f));
+  glob(engineDir, /^pid-.*\.pid$/).forEach(rm);
+  rmDir(path.join(engineDir, 'tmp'));
+  // Work items + PRs
+  rm(path.join(MINIONS_HOME, 'work-items.json'));
+  rm(path.join(MINIONS_HOME, 'work-items-archive.json'));
+  rm(path.join(MINIONS_HOME, 'pull-requests.json'));
+  // Plans + PRDs
+  glob(path.join(MINIONS_HOME, 'plans'), /\.md$/).forEach(rm);
+  glob(path.join(MINIONS_HOME, 'prd'), /\.json$/).forEach(rm);
+  rmDir(path.join(MINIONS_HOME, 'prd', 'archive'));
+  rmDir(path.join(MINIONS_HOME, 'prd', 'guides'));
+  // Notes + KB
+  rm(path.join(MINIONS_HOME, 'notes.md'));
+  rm(path.join(MINIONS_HOME, 'pinned.md'));
+  rmDir(path.join(MINIONS_HOME, 'notes', 'inbox'));
+  rmDir(path.join(MINIONS_HOME, 'notes', 'archive'));
+  fs.mkdirSync(path.join(MINIONS_HOME, 'notes', 'inbox'), { recursive: true });
+  fs.mkdirSync(path.join(MINIONS_HOME, 'notes', 'archive'), { recursive: true });
+  for (const cat of ['architecture', 'conventions', 'project-notes', 'build-reports', 'reviews']) {
+    const catDir = path.join(MINIONS_HOME, 'knowledge', cat);
+    glob(catDir, /\.md$/).forEach(rm);
+  }
+  // Agent state (preserve charters)
+  const agentsDir = path.join(MINIONS_HOME, 'agents');
+  try {
+    for (const agent of fs.readdirSync(agentsDir)) {
+      const agentDir = path.join(agentsDir, agent);
+      if (!fs.statSync(agentDir).isDirectory()) continue;
+      for (const f of ['live-output.log', 'session.json', 'history.md', 'steer.md', 'status.json']) rm(path.join(agentDir, f));
+      glob(agentDir, /^output.*\.log$/).forEach(rm);
+    }
+  } catch {}
+  // Projects state
+  rmDir(path.join(MINIONS_HOME, 'projects'));
+  fs.mkdirSync(path.join(MINIONS_HOME, 'projects'), { recursive: true });
+
+  console.log('\n  Reset complete. Config and charters preserved.');
+  console.log('  Run: minions up\n');
 } else if (cmd === 'doctor') {
   ensureInstalled();
   const { doctor } = require(path.join(MINIONS_HOME, 'engine', 'preflight'));

package/engine.js

@@ -356,16 +356,23 @@ function renderPlaybook(type, vars) {
     return null;
   }
 
-  // Inject pinned context (always visible to agents)
+  // Inject pinned context (always visible to agents) — capped at 4KB
   let pinnedContent = '';
   try { pinnedContent = fs.readFileSync(path.join(MINIONS_DIR, 'pinned.md'), 'utf8'); } catch {}
   if (pinnedContent) {
+    if (pinnedContent.length > 4096) pinnedContent = pinnedContent.slice(0, 4096) + '\n\n_...pinned.md truncated (read full file if needed)_';
     content += '\n\n---\n\n## Pinned Context (CRITICAL — READ FIRST)\n\n' + pinnedContent;
   }
 
-  // Inject team notes context
-  const notes = getNotes();
+  // Inject team notes (single injection point — not in buildAgentContext) — capped at 8KB
+  let notes = getNotes();
   if (notes) {
+    if (notes.length > 8192) {
+      const sections = notes.split(/(?=^### )/m);
+      const recent = sections.slice(-10).join('');
+      notes = recent.length > 8192 ? recent.slice(0, 8192) + '\n\n_...notes truncated_' : recent;
+      notes += '\n\n_' + Math.max(0, sections.length - 10) + ' older entries in `notes.md` — Read if needed._';
+    }
     content += '\n\n---\n\n## Team Notes (MUST READ)\n\n' + notes;
   }
 
@@ -621,18 +628,8 @@ function buildAgentContext(agentId, config, project) {
     context += `## Pending Work Queue (${(dispatch.pending || []).length} items)\n\n${pendingItems.join('\n')}${(dispatch.pending || []).length > 10 ? '\n- ... and ' + ((dispatch.pending || []).length - 10) + ' more' : ''}\n\n`;
   }
 
-  // Team notes — last 5 sections only (recent learnings, not the full history)
-  const notes = getNotes();
-  if (notes) {
-    const sections = notes.split(/(?=^### )/m);
-    const header = sections[0] && !sections[0].startsWith('### ') ? sections.shift() : '';
-    if (sections.length > 5) {
-      const recent = sections.slice(-5).join('');
-      context += `## Team Notes (last 5 of ${sections.length})\n\n${recent}\n\n_${sections.length - 5} older entries in \`notes.md\` — Read if needed._\n\n`;
-    } else {
-      context += `## Team Notes\n\n${notes}\n\n`;
-    }
-  }
+  // Team notes injected via renderPlaybook (single injection point, with truncation)
+  // Not duplicated here to avoid double-injection and token waste
 
   return context;
 }
@@ -2815,7 +2812,7 @@ function discoverFromWorkItems(config, project) {
     try { vars.notes_content = fs.readFileSync(path.join(MINIONS_DIR, 'notes.md'), 'utf8'); } catch {}
 
     // Inject references and acceptance criteria
-    const refs = (item.references || []).map(r =>
+    const refs = (item.references || []).filter(r => r && r.url).map(r =>
       '- [' + (r.title || r.url) + '](' + r.url + ')' + (r.type ? ' (' + r.type + ')' : '')
     ).join('\n');
     vars.references = refs ? '## References\n\n' + refs : '';
@@ -3110,7 +3107,7 @@ function discoverCentralWorkItems(config) {
         };
 
         // Inject references and acceptance criteria
-        const fanRefs = (item.references || []).map(r =>
+        const fanRefs = (item.references || []).filter(r => r && r.url).map(r =>
           '- [' + (r.title || r.url) + '](' + r.url + ')' + (r.type ? ' (' + r.type + ')' : '')
         ).join('\n');
         vars.references = fanRefs ? '## References\n\n' + fanRefs : '';
@@ -3185,7 +3182,7 @@ function discoverCentralWorkItems(config) {
       try { vars.notes_content = fs.readFileSync(path.join(MINIONS_DIR, 'notes.md'), 'utf8'); } catch {}
 
       // Inject references and acceptance criteria
-      const normRefs = (item.references || []).map(r =>
+      const normRefs = (item.references || []).filter(r => r && r.url).map(r =>
         '- [' + (r.title || r.url) + '](' + r.url + ')' + (r.type ? ' (' + r.type + ')' : '')
       ).join('\n');
       vars.references = normRefs ? '## References\n\n' + normRefs : '';

package/package.json

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