@yemi33/minions 0.1.86 → 0.1.88

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.1.88 (2026-04-01)
+
+### Dashboard
+- dashboard.js
+- dashboard/js/render-plans.js
+- dashboard/js/render-prd.js
+
+## 0.1.87 (2026-04-01)
+
+### Engine
+- engine.js
+- engine/consolidation.js
+- engine/dispatch.js
+- engine/lifecycle.js
+- engine/meeting.js
+- engine/playbook.js
+- engine/shared.js
+
+### Other
+- test/unit.test.js
+- tools/generate-pixel-art.js
+- tools/pixel-robot.bmp
+
 ## 0.1.86 (2026-03-31)
 
 ### Dashboard

package/dashboard/js/render-plans.js

@@ -461,9 +461,16 @@ async function planView(file) {
       'onclick="planDelete(\'' + escHtml(normalizedFile) + '\')">Delete</button>' +
     '</div>';
     document.getElementById('modal-title').innerHTML = escHtml(title) + (versionLabel ? ' <span style="font-size:11px;font-weight:700;padding:1px 6px;border-radius:3px;background:rgba(56,139,253,0.15);color:var(--blue)">' + escHtml(versionLabel) + '</span>' : '') + lastModLabel + actionBtns;
-    document.getElementById('modal-body').textContent = text;
-    document.getElementById('modal-body').style.fontFamily = 'Consolas, monospace';
-    document.getElementById('modal-body').style.whiteSpace = 'pre-wrap';
+    const modalBody = document.getElementById('modal-body');
+    if (normalizedFile.endsWith('.json')) {
+      modalBody.textContent = text;
+      modalBody.style.fontFamily = 'Consolas, monospace';
+      modalBody.style.whiteSpace = 'pre-wrap';
+    } else {
+      modalBody.innerHTML = '<div style="font-size:12px;line-height:1.6">' + renderMd(text) + '</div>';
+      modalBody.style.fontFamily = "'Segoe UI', system-ui, sans-serif";
+      modalBody.style.whiteSpace = 'normal';
+    }
     _modalDocContext = { title, content: text, selection: '' };
     _modalFilePath = resolvedPath || ((normalizedFile.endsWith('.json') ? 'prd/' : 'plans/') + normalizedFile); showModalQa();
     // Clear notification badge when opening this document
@@ -509,6 +516,25 @@ async function planDelete(file) {
   } catch (e) { alert('Error: ' + e.message); }
 }
 
+async function planArchive(file) {
+  if (!confirm('Archive PRD "' + file + '"? Work items will be preserved.')) return;
+  try {
+    const res = await fetch('/api/plans/archive', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ file })
+    });
+    if (res.ok) {
+      closeModal();
+      showToast('cmd-toast', 'PRD archived', true);
+      refreshPlans();
+      refresh();
+    } else {
+      const d = await res.json();
+      alert('Archive failed: ' + (d.error || 'unknown'));
+    }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
 async function planPause(file, btn) {
   if (btn) { btn.dataset.origText = btn.textContent; btn.textContent = 'Pausing...'; btn.style.pointerEvents = 'none'; btn.style.opacity = '0.6'; }
   try {
@@ -578,9 +604,15 @@ async function planOpenInDocChat(file) {
       try { title = JSON.parse(raw).plan_summary || file; } catch {}
     }
     document.getElementById('modal-title').textContent = 'Edit: ' + title;
-    document.getElementById('modal-body').textContent = text;
-    document.getElementById('modal-body').style.fontFamily = 'Consolas, monospace';
-    document.getElementById('modal-body').style.whiteSpace = 'pre-wrap';
+    if (normalizedFile.endsWith('.json')) {
+      document.getElementById('modal-body').textContent = text;
+      document.getElementById('modal-body').style.fontFamily = 'Consolas, monospace';
+      document.getElementById('modal-body').style.whiteSpace = 'pre-wrap';
+    } else {
+      document.getElementById('modal-body').innerHTML = '<div style="font-size:12px;line-height:1.6">' + renderMd(text) + '</div>';
+      document.getElementById('modal-body').style.fontFamily = "'Segoe UI', system-ui, sans-serif";
+      document.getElementById('modal-body').style.whiteSpace = 'normal';
+    }
     _modalDocContext = { title: title, content: text, selection: '' };
     _modalFilePath = resolvedPath || ((normalizedFile.endsWith('.json') ? 'prd/' : 'plans/') + normalizedFile); showModalQa();
     const card = findCardForFile(_modalFilePath);
@@ -612,9 +644,9 @@ async function openVerifyGuide(file) {
     const content = await fetch('/api/plans/' + encodeURIComponent(normalizedFile)).then(r => r.text());
     document.getElementById('modal-title').innerHTML = 'Manual Testing Guide' +
       ' <button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;margin-left:8px;vertical-align:middle" onclick="openArchivedPrdModal()">Back</button>';
-    document.getElementById('modal-body').textContent = content;
-    document.getElementById('modal-body').style.fontFamily = 'Consolas, monospace';
-    document.getElementById('modal-body').style.whiteSpace = 'pre-wrap';
+    document.getElementById('modal-body').innerHTML = '<div style="font-size:12px;line-height:1.6">' + renderMd(content) + '</div>';
+    document.getElementById('modal-body').style.fontFamily = "'Segoe UI', system-ui, sans-serif";
+    document.getElementById('modal-body').style.whiteSpace = 'normal';
     _modalDocContext = { title: 'Manual Testing Guide', content, selection: '' };
     _modalFilePath = 'prd/' + normalizedFile; showModalQa();
     const card = findCardForFile(_modalFilePath);
@@ -642,4 +674,4 @@ async function triggerVerify(file, btn) {
   } catch (e) { if (btn) { btn.textContent = btn.dataset.origText || 'Verify'; btn.style.pointerEvents = ''; btn.style.opacity = ''; } alert('Error: ' + e.message); }
 }
 
-window.MinionsPlans = { openCreatePlanModal, refreshPlans, derivePlanStatus, renderPlans, openArchivedPlansModal, qaDisablePrdButtons, showPlanVersionActions, qaJustSave, planExecute, planSubmitRevise, planShowRevise, planHideRevise, planView, planApprove, planDelete, planPause, planReject, planDiscuss, planOpenInDocChat, planRegeneratePRD, openVerifyGuide, triggerVerify };
+window.MinionsPlans = { openCreatePlanModal, refreshPlans, derivePlanStatus, renderPlans, openArchivedPlansModal, qaDisablePrdButtons, showPlanVersionActions, qaJustSave, planExecute, planSubmitRevise, planShowRevise, planHideRevise, planView, planApprove, planArchive, planDelete, planPause, planReject, planDiscuss, planOpenInDocChat, planRegeneratePRD, openVerifyGuide, triggerVerify };

package/dashboard/js/render-prd.js

@@ -36,7 +36,7 @@ function renderPrd(prd, prog) {
         actions = ' <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--green);border-color:var(--green);margin-left:4px" onclick="planApprove(\'' + escHtml(prdFile) + '\',this)">Approve</button>';
       } else if (effectiveStatus === 'completed') {
         actions = ' <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--green);border-color:var(--green);margin-left:4px" onclick="triggerVerify(\'' + escHtml(prdFile) + '\',this)">Verify</button>' +
-          ' <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--muted);border-color:var(--border);margin-left:4px" onclick="planDelete(\'' + escHtml(prdFile) + '\')">Archive</button>';
+          ' <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--muted);border-color:var(--border);margin-left:4px" onclick="planArchive(\'' + escHtml(prdFile) + '\')">Archive</button>';
       } else if (effectiveStatus === 'in-progress') {
         actions = ' <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--yellow);border-color:var(--yellow);margin-left:4px" onclick="planPause(\'' + escHtml(prdFile) + '\',this)">Pause</button>';
       } else if (effectiveStatus === 'paused') {
@@ -238,7 +238,7 @@ function renderPrdProgress(prog) {
           ? '<span onclick="event.stopPropagation();triggerVerify(\'' + escHtml(g.file) + '\',this)" style="color:var(--green);cursor:pointer;font-size:9px;padding:1px 6px;background:rgba(63,185,80,0.1);border:1px solid rgba(63,185,80,0.3);border-radius:3px">Verify</span>'
           : '<span onclick="event.stopPropagation();planPause(\'' + escHtml(g.file) + '\',this)" style="color:var(--yellow);cursor:pointer;font-size:9px;padding:1px 6px;background:rgba(210,153,34,0.1);border:1px solid rgba(210,153,34,0.3);border-radius:3px">Pause</span>';
     const archiveBtn = isCompleted
-      ? '<span onclick="event.stopPropagation();planDelete(\'' + escHtml(g.file) + '\')" style="color:var(--muted);cursor:pointer;font-size:9px;padding:1px 6px;background:var(--surface);border:1px solid var(--border);border-radius:3px">Archive</span>'
+      ? '<span onclick="event.stopPropagation();planArchive(\'' + escHtml(g.file) + '\')" style="color:var(--muted);cursor:pointer;font-size:9px;padding:1px 6px;background:var(--surface);border:1px solid var(--border);border-radius:3px">Archive</span>'
       : '';
     const deleteBtn = '<span onclick="event.stopPropagation();planDelete(\'' + escHtml(g.file) + '\')" style="color:var(--red);cursor:pointer;font-size:9px;padding:1px 6px;background:rgba(248,81,73,0.1);border:1px solid rgba(248,81,73,0.3);border-radius:3px">Delete</span>';
     const sourcePlanLink = g.sourcePlan
@@ -250,6 +250,7 @@ function renderPrdProgress(prog) {
       '<span style="color:var(--text)">' + escHtml(summary || g.file) + '</span>' +
       pausedLabel +
       staleLabel +
+      '<span style="font-weight:700;font-size:11px;color:' + (done === g.items.length && g.items.length > 0 ? 'var(--green)' : 'var(--text)') + '">' + (g.items.length > 0 ? Math.round((done / g.items.length) * 100) : 0) + '%</span>' +
       '<span style="color:var(--muted);font-weight:400;font-size:10px">' + g.items.length + ' items' +
         (done ? ' · ' + done + ' done' : '') + (wip ? ' · ' + wip + ' active' : '') +
       '</span>' +

package/dashboard.js

@@ -2065,6 +2065,37 @@ If nothing to do, return: { "duplicates": [], "reclassify": [], "remove": [] }`;
     } catch (e) { return jsonReply(res, 400, { error: e.message }); }
   }
 
+  async function handlePlansArchive(req, res) {
+    try {
+      const body = await readBody(req);
+      if (!body.file) return jsonReply(res, 400, { error: 'file required' });
+      if (body.file.includes('..') || body.file.includes('\0') || body.file.includes('/') || body.file.includes('\\')) {
+        return jsonReply(res, 400, { error: 'invalid filename' });
+      }
+      const planPath = resolvePlanPath(body.file);
+      if (!fs.existsSync(planPath)) return jsonReply(res, 404, { error: 'plan not found' });
+
+      // Move to archive directory
+      const archiveDir = body.file.endsWith('.json') ? path.join(PRD_DIR, 'archive') : path.join(PLANS_DIR, 'archive');
+      if (!fs.existsSync(archiveDir)) fs.mkdirSync(archiveDir, { recursive: true });
+      const archivePath = path.join(archiveDir, body.file);
+      fs.renameSync(planPath, archivePath);
+
+      // Mark archived in JSON if PRD
+      if (body.file.endsWith('.json')) {
+        try {
+          const prd = JSON.parse(safeRead(archivePath) || '{}');
+          prd.status = 'archived';
+          prd.archivedAt = new Date().toISOString();
+          safeWrite(archivePath, prd);
+        } catch { /* optional */ }
+      }
+
+      invalidateStatusCache();
+      return jsonReply(res, 200, { ok: true, archived: body.file });
+    } catch (e) { return jsonReply(res, 400, { error: e.message }); }
+  }
+
   async function handlePlansRevise(req, res) {
     try {
       const body = await readBody(req);
@@ -3083,6 +3114,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
     { method: 'POST', path: '/api/plans/reject', desc: 'Reject a plan', params: 'file, rejectedBy?, reason?', handler: handlePlansReject },
     { method: 'POST', path: '/api/plans/regenerate', desc: 'Reset pending/failed work items for a plan so they re-materialize', params: 'source', handler: handlePlansRegenerate },
     { method: 'POST', path: '/api/plans/delete', desc: 'Delete a plan file and clean up work items', params: 'file', handler: handlePlansDelete },
+    { method: 'POST', path: '/api/plans/archive', desc: 'Move a plan/PRD to archive (preserves work items)', params: 'file', handler: handlePlansArchive },
     { method: 'POST', path: '/api/plans/revise', desc: 'Request revision with feedback, dispatches agent to revise', params: 'file, feedback, requestedBy?', handler: handlePlansRevise },
     { method: 'POST', path: '/api/plans/discuss', desc: 'Generate a plan discussion session script for Claude CLI', params: 'file', handler: handlePlansDiscuss },
     { method: 'GET', path: /^\/api\/plans\/archive\/([^?]+)$/, desc: 'Read an archived plan file', handler: handlePlansArchiveRead },

package/engine/consolidation.js

@@ -8,39 +8,32 @@ const fs = require('fs');
 const path = require('path');
 const shared = require('./shared');
 const { safeRead, safeWrite, safeUnlink, runFile, cleanChildEnv,
-  parseStreamJsonOutput, classifyInboxItem, KB_CATEGORIES } = shared;
+  parseStreamJsonOutput, classifyInboxItem, KB_CATEGORIES, log, dateStamp } = shared;
 const { trackEngineUsage } = require('./llm');
 const queries = require('./queries');
 const { getInboxFiles, getNotes, INBOX_DIR, ENGINE_DIR, MINIONS_DIR,
   NOTES_PATH, KNOWLEDGE_DIR, ARCHIVE_DIR } = queries;
 
-// Lazy require — only for log() and dateStamp() which live on engine.js
-let _engine = null;
-function engine() {
-  if (!_engine) _engine = require('../engine');
-  return _engine;
-}
-
 // Track in-flight LLM consolidation to prevent concurrent runs
 let _consolidationInFlight = false;
 let _consolidationStartedAt = 0;
 const _processingFiles = new Set(); // files currently being consolidated (race guard)
 
 function consolidateInbox(config) {
-  const e = engine();
+
   const { ENGINE_DEFAULTS } = shared;
   const threshold = config.engine?.inboxConsolidateThreshold || ENGINE_DEFAULTS.inboxConsolidateThreshold;
   const files = getInboxFiles().filter(f => !_processingFiles.has(f));
   if (files.length < threshold) return;
   // Auto-reset stale flag if consolidation has been running for >5 minutes (process died without cleanup)
   if (_consolidationInFlight && (Date.now() - _consolidationStartedAt) > 300000) {
-    e.log('warn', 'Consolidation flag was stale (>5m) — resetting');
+    log('warn', 'Consolidation flag was stale (>5m) — resetting');
     _consolidationInFlight = false;
     _processingFiles.clear();
   }
   if (_consolidationInFlight) return;
 
-  e.log('info', `Consolidating ${files.length} inbox items into notes.md`);
+  log('info', `Consolidating ${files.length} inbox items into notes.md`);
 
   const items = files.map(f => ({
     name: f,
@@ -54,7 +47,7 @@ function consolidateInbox(config) {
 // ─── LLM-Powered Consolidation ──────────────────────────────────────────────
 
 function buildConsolidationPrompt(items, existingNotes, kbPaths) {
-  const e = engine();
+
   const kbRefBlock = kbPaths.map(p => `- \`${p.file}\` \u2192 \`${p.kbPath}\``).join('\n');
   const notesBlock = items.map(item =>
     `<note file="${item.name}">\n${(item.content || '').slice(0, 8000)}\n</note>`
@@ -114,11 +107,11 @@ Respond with ONLY the markdown below — no preamble, no explanation, no code fe
 
 _Processed N notes, M insights extracted, K duplicates removed._
 
-Use today's date: ${e.dateStamp()}`;
+Use today's date: ${dateStamp()}`;
 }
 
 function consolidateWithLLM(items, existingNotes, files, config) {
-  const e = engine();
+
   _consolidationInFlight = true;
   _consolidationStartedAt = Date.now();
   for (const f of files) _processingFiles.add(f);
@@ -129,7 +122,7 @@ function consolidateWithLLM(items, existingNotes, files, config) {
     const agent = agentMatch ? agentMatch[1] : 'unknown';
     const titleMatch = (item.content || '').match(/^#\s+(.+)/m);
     const titleSlug = titleMatch ? titleMatch[1].toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 50) : item.name.replace(/\.md$/, '');
-    return { file: item.name, category: cat, kbPath: path.join('knowledge', cat, `${e.dateStamp()}-${agent}-${titleSlug}.md`) };
+    return { file: item.name, category: cat, kbPath: path.join('knowledge', cat, `${dateStamp()}-${agent}-${titleSlug}.md`) };
   });
 
   const prompt = buildConsolidationPrompt(items, existingNotes, kbPaths);
@@ -152,7 +145,7 @@ function consolidateWithLLM(items, existingNotes, files, config) {
     '--verbose',
   ];
 
-  e.log('info', 'Spawning Haiku for LLM consolidation...');
+  log('info', 'Spawning Haiku for LLM consolidation...');
 
   const proc = runFile(process.execPath, [spawnScript, promptPath, sysPromptPath, ...args], {
     cwd: MINIONS_DIR,
@@ -166,7 +159,7 @@ function consolidateWithLLM(items, existingNotes, files, config) {
   proc.stderr.on('data', d => { stderr += d.toString(); if (stderr.length > 50000) stderr = stderr.slice(-25000); });
 
   const timeout = setTimeout(() => {
-    e.log('warn', 'LLM consolidation timed out after 3m — killing and falling back to regex');
+    log('warn', 'LLM consolidation timed out after 3m — killing and falling back to regex');
     try { proc.kill('SIGTERM'); } catch { /* process may be dead */ }
     // Escalate to SIGKILL after 10s if process doesn't exit
     setTimeout(() => {
@@ -174,7 +167,7 @@ function consolidateWithLLM(items, existingNotes, files, config) {
       if (_consolidationInFlight) {
         _consolidationInFlight = false;
         _processingFiles.clear();
-        e.log('warn', 'Consolidation flag force-reset after SIGKILL');
+        log('warn', 'Consolidation flag force-reset after SIGKILL');
       }
     }, 10000);
   }, 180000);
@@ -202,7 +195,7 @@ function consolidateWithLLM(items, existingNotes, files, config) {
         if (sectionIdx >= 0) {
           digest = digest.slice(sectionIdx);
         } else {
-          e.log('warn', 'LLM consolidation output missing expected format — falling back to regex');
+          log('warn', 'LLM consolidation output missing expected format — falling back to regex');
           consolidateWithRegex(items, files);
           _clearProcessingState();
           return;
@@ -219,17 +212,17 @@ function consolidateWithLLM(items, existingNotes, files, config) {
           const header = sections[0];
           const recent = sections.slice(-8);
           newContent = header + '\n---\n\n### ' + recent.join('\n---\n\n### ');
-          e.log('info', `Pruned notes.md: removed ${sections.length - 9} old sections`);
+          log('info', `Pruned notes.md: removed ${sections.length - 9} old sections`);
         }
       }
 
       safeWrite(NOTES_PATH, newContent);
       classifyToKnowledgeBase(items);
       archiveInboxFiles(files);
-      e.log('info', `LLM consolidation complete: ${files.length} notes processed by Haiku`);
+      log('info', `LLM consolidation complete: ${files.length} notes processed by Haiku`);
     } else {
-      e.log('warn', `LLM consolidation failed (code=${code}) — falling back to regex`);
-      if (stderr) e.log('debug', `LLM stderr: ${stderr.slice(0, 500)}`);
+      log('warn', `LLM consolidation failed (code=${code}) — falling back to regex`);
+      if (stderr) log('debug', `LLM stderr: ${stderr.slice(0, 500)}`);
       consolidateWithRegex(items, files);
     }
     _clearProcessingState();
@@ -237,7 +230,7 @@ function consolidateWithLLM(items, existingNotes, files, config) {
 
   proc.on('error', (err) => {
     clearTimeout(timeout);
-    e.log('warn', `LLM consolidation spawn error: ${err.message} — falling back to regex`);
+    log('warn', `LLM consolidation spawn error: ${err.message} — falling back to regex`);
     safeUnlink(promptPath);
     safeUnlink(sysPromptPath);
     consolidateWithRegex(items, files);
@@ -248,7 +241,7 @@ function consolidateWithLLM(items, existingNotes, files, config) {
 // ─── Regex Fallback Consolidation ────────────────────────────────────────────
 
 function consolidateWithRegex(items, files) {
-  const e = engine();
+
   const allInsights = [];
   for (const item of items) {
     const content = item.content || '';
@@ -327,7 +320,7 @@ function consolidateWithRegex(items, files) {
   const grouped = {};
   for (const item of deduped) { if (!grouped[item.category]) grouped[item.category] = []; grouped[item.category].push(item); }
 
-  let entry = `\n\n---\n\n### ${e.dateStamp()}: ${title}\n`;
+  let entry = `\n\n---\n\n### ${dateStamp()}: ${title}\n`;
   entry += '**By:** Engine (regex fallback)\n\n';
   for (const [cat, catItems] of Object.entries(grouped)) {
     entry += `#### ${catLabels[cat] || cat} (${catItems.length})\n`;
@@ -349,13 +342,13 @@ function consolidateWithRegex(items, files) {
   safeWrite(NOTES_PATH, newContent);
   classifyToKnowledgeBase(items);
   archiveInboxFiles(files);
-  e.log('info', `Regex fallback: consolidated ${files.length} notes \u2192 ${deduped.length} insights into notes.md`);
+  log('info', `Regex fallback: consolidated ${files.length} notes \u2192 ${deduped.length} insights into notes.md`);
 }
 
 // ─── Knowledge Base Classification ───────────────────────────────────────────
 
 function classifyToKnowledgeBase(items) {
-  const e = engine();
+
   if (!fs.existsSync(KNOWLEDGE_DIR)) fs.mkdirSync(KNOWLEDGE_DIR, { recursive: true });
 
   const categoryDirs = {};
@@ -375,20 +368,20 @@ function classifyToKnowledgeBase(items) {
     const titleSlug = titleMatch
       ? titleMatch[1].toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 50)
       : item.name.replace(/\.md$/, '');
-    const kbFilename = `${e.dateStamp()}-${agent}-${titleSlug}.md`;
+    const kbFilename = `${dateStamp()}-${agent}-${titleSlug}.md`;
     const kbPath = shared.uniquePath(path.join(categoryDirs[category], kbFilename));
 
-    const frontmatter = `---\nsource: ${item.name}\nagent: ${agent}\ncategory: ${category}\ndate: ${e.dateStamp()}\n---\n\n`;
+    const frontmatter = `---\nsource: ${item.name}\nagent: ${agent}\ncategory: ${category}\ndate: ${dateStamp()}\n---\n\n`;
     try {
       safeWrite(kbPath, frontmatter + content);
       classified++;
     } catch (err) {
-      e.log('warn', `Failed to classify ${item.name} to knowledge base: ${err.message}`);
+      log('warn', `Failed to classify ${item.name} to knowledge base: ${err.message}`);
     }
   }
 
   if (classified > 0) {
-    e.log('info', `Knowledge base: classified ${classified} note(s) into knowledge/`);
+    log('info', `Knowledge base: classified ${classified} note(s) into knowledge/`);
   }
 
   // Save KB file count checkpoint so the watchdog can detect unexpected deletions
@@ -399,14 +392,14 @@ function classifyToKnowledgeBase(items) {
       if (fs.existsSync(dir)) count += fs.readdirSync(dir).length;
     }
     safeWrite(path.join(ENGINE_DIR, 'kb-checkpoint.json'), JSON.stringify({ count, updatedAt: new Date().toISOString() }));
-  } catch (err) { engine().log('warn', `KB checkpoint: ${err.message}`); }
+  } catch (err) { log('warn', `KB checkpoint: ${err.message}`); }
 }
 
 function archiveInboxFiles(files) {
-  const e = engine();
+
   if (!fs.existsSync(ARCHIVE_DIR)) fs.mkdirSync(ARCHIVE_DIR, { recursive: true });
   for (const f of files) {
-    try { fs.renameSync(path.join(INBOX_DIR, f), shared.uniquePath(path.join(ARCHIVE_DIR, `${e.dateStamp()}-${f}`))); } catch (err) { e.log('warn', `Inbox archive: ${err.message}`); }
+    try { fs.renameSync(path.join(INBOX_DIR, f), shared.uniquePath(path.join(ARCHIVE_DIR, `${dateStamp()}-${f}`))); } catch (err) { log('warn', `Inbox archive: ${err.message}`); }
   }
 }
 

package/engine/dispatch.js

@@ -10,7 +10,7 @@ const queries = require('./queries');
 const { setCooldownFailure } = require('./cooldown');
 
 const { safeJson, safeWrite, safeReadDir, mutateJsonFileLocked,
-  getProjects, projectWorkItemsPath } = shared;
+  getProjects, projectWorkItemsPath, log, ts, dateStamp } = shared;
 const { getConfig, getDispatch, DISPATCH_PATH, INBOX_DIR } = queries;
 
 const MINIONS_DIR = shared.MINIONS_DIR;
@@ -19,13 +19,6 @@ const MINIONS_DIR = shared.MINIONS_DIR;
 let _lifecycle = null;
 function lifecycle() { if (!_lifecycle) _lifecycle = require('./lifecycle'); return _lifecycle; }
 
-// ─── Engine utilities (lazy require to avoid circular deps) ──────────────────
-let _engine = null;
-function engine() { if (!_engine) _engine = require('../engine'); return _engine; }
-function log(level, msg, meta) { return engine().log(level, msg, meta); }
-function ts() { return engine().ts(); }
-function dateStamp() { return new Date().toISOString().slice(0, 10); }
-
 // ─── Dispatch Mutation ───────────────────────────────────────────────────────
 
 function mutateDispatch(mutator) {