@yemi33/minions 0.1.64 → 0.1.66

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.1.66 (2026-03-31)
+
+### Dashboard
+- dashboard.js
+- dashboard/js/refresh.js
+
+## 0.1.65 (2026-03-31)
+
+### Engine
+- engine.js
+- engine/lifecycle.js
+- engine/meeting.js
+- engine/playbook.js
+
+### Dashboard
+- dashboard-build.js
+- dashboard.js
+- dashboard/js/refresh.js
+- dashboard/js/render-meetings.js
+- dashboard/layout.html
+- dashboard/pages/meetings.html
+
+### Playbooks
+- meeting-conclude.md
+- meeting-debate.md
+- meeting-investigate.md
+
+### Other
+- routing.md
+
 ## 0.1.64 (2026-03-31)
 
 ### Playbooks

package/dashboard/js/refresh.js

@@ -36,6 +36,7 @@ function _processStatusUpdate(data) {
   renderSkills(data.skills || []);
   renderMcpServers(data.mcpServers || []);
   renderSchedules(data.schedules || []);
+  renderMeetings(data.meetings || []);
   renderPinned(data.pinned || []);
   // Update sidebar counts
   const swi = document.getElementById('sidebar-wi');
@@ -56,15 +57,16 @@ async function refresh() {
 
 refresh();
 
-// SSE status stream — real-time push, falls back to 4s polling
+// SSE status stream — real-time push + hot-reload on one connection
+// (avoids exhausting HTTP/1.1's 6-connection-per-origin limit)
 let _statusStream = null;
 try {
   _statusStream = new EventSource('/api/status-stream');
   _statusStream.onmessage = (e) => {
     try { _processStatusUpdate(JSON.parse(e.data)); } catch (e2) { console.error('status-stream:', e2.message); }
   };
+  _statusStream.addEventListener('reload', () => { location.reload(); });
   _statusStream.onerror = () => {
-    // Fall back to polling
     if (_statusStream) { _statusStream.close(); _statusStream = null; }
     setInterval(refresh, 4000);
   };
@@ -78,10 +80,4 @@ document.querySelectorAll('.sidebar-link').forEach(link => {
 });
 switchPage(currentPage);
 
-// Hot-reload: auto-refresh browser when dashboard files change
-try {
-  const _hotReload = new EventSource('/api/hot-reload');
-  _hotReload.onmessage = (e) => { if (e.data === 'reload') location.reload(); };
-} catch { /* expected */ }
-
 window.MinionsRefresh = { refresh };

package/dashboard/js/render-meetings.js

@@ -0,0 +1,203 @@
+// render-meetings.js — Team meeting rendering
+
+function renderMeetings(meetings) {
+  const el = document.getElementById('meetings-content');
+  const countEl = document.getElementById('meetings-count');
+  if (!meetings || meetings.length === 0) {
+    countEl.textContent = '0';
+    el.innerHTML = '<p class="empty">No meetings yet. Start one to have agents investigate, debate, and conclude on a topic.</p>';
+    return;
+  }
+  countEl.textContent = meetings.length;
+
+  const statusColors = { investigating: 'var(--blue)', debating: 'var(--purple,#a855f7)', concluding: 'var(--yellow)', completed: 'var(--green)' };
+  const statusLabels = { investigating: 'Round 1 — Investigating', debating: 'Round 2 — Debating', concluding: 'Round 3 — Concluding', completed: 'Completed' };
+
+  el.innerHTML = meetings.map(m => {
+    const statusColor = statusColors[m.status] || 'var(--muted)';
+    const statusLabel = statusLabels[m.status] || m.status;
+    const participantBadges = (m.participants || []).map(p => {
+      const hasFindings = m.findings?.[p];
+      const hasDebate = m.debate?.[p];
+      const icon = m.status === 'completed' ? '✓' : m.status === 'debating' ? (hasDebate ? '✓' : (hasFindings ? '⏳' : '○')) : (hasFindings ? '✓' : '⏳');
+      return '<span style="background:var(--surface2);border:1px solid var(--border);border-radius:4px;padding:2px 6px;font-size:10px">' + icon + ' ' + escHtml(p) + '</span>';
+    }).join(' ');
+
+    return '<div style="background:var(--surface);border:1px solid var(--border);border-radius:8px;padding:12px 16px;margin-bottom:8px;cursor:pointer" onclick="openMeetingDetail(\'' + escHtml(m.id) + '\')">' +
+      '<div style="display:flex;justify-content:space-between;align-items:center">' +
+        '<strong style="font-size:13px">' + escHtml(m.title) + '</strong>' +
+        '<span style="color:' + statusColor + ';font-size:11px;font-weight:600">' + statusLabel + '</span>' +
+      '</div>' +
+      '<div style="margin-top:6px;display:flex;gap:6px;flex-wrap:wrap">' + participantBadges + '</div>' +
+      '<div style="margin-top:6px;font-size:11px;color:var(--muted)">' + escHtml((m.agenda || '').slice(0, 100)) + (m.agenda?.length > 100 ? '...' : '') + '</div>' +
+    '</div>';
+  }).join('');
+}
+
+function openMeetingDetail(id) {
+  fetch('/api/meetings/' + encodeURIComponent(id))
+    .then(r => r.json())
+    .then(data => {
+      if (!data.meeting) { alert('Meeting not found'); return; }
+      const m = data.meeting;
+      const statusColors = { investigating: 'var(--blue)', debating: 'var(--purple,#a855f7)', concluding: 'var(--yellow)', completed: 'var(--green)' };
+      const statusLabels = { investigating: 'Round 1 — Investigating', debating: 'Round 2 — Debating', concluding: 'Round 3 — Concluding', completed: 'Completed' };
+
+      let html = '<div style="display:flex;flex-direction:column;gap:12px">';
+
+      // Status bar
+      html += '<div style="display:flex;justify-content:space-between;align-items:center">' +
+        '<span style="color:' + (statusColors[m.status] || 'var(--muted)') + ';font-weight:600">' + (statusLabels[m.status] || m.status) + '</span>' +
+        '<span style="font-size:10px;color:var(--muted)">' + escHtml(m.createdAt?.slice(0, 16).replace('T', ' ') || '') + '</span>' +
+      '</div>';
+
+      // Agenda
+      html += '<div style="background:var(--surface2);padding:8px 12px;border-radius:6px;font-size:12px">' +
+        '<strong>Agenda:</strong> ' + escHtml(m.agenda) + '</div>';
+
+      // Per-agent panels
+      for (const agent of (m.participants || [])) {
+        html += '<div style="border:1px solid var(--border);border-radius:6px;overflow:hidden">';
+        html += '<div style="background:var(--surface2);padding:6px 12px;font-weight:600;font-size:12px">' + escHtml(agent) + '</div>';
+
+        // Findings
+        if (m.findings?.[agent]) {
+          html += '<div style="padding:8px 12px;font-size:11px;border-bottom:1px solid var(--border)">' +
+            '<div style="color:var(--muted);font-size:10px;margin-bottom:4px">Round 1 — Findings</div>' +
+            '<div style="white-space:pre-wrap;word-break:break-word">' + escHtml(m.findings[agent].content?.slice(0, 500) || '') + (m.findings[agent].content?.length > 500 ? '...' : '') + '</div></div>';
+        }
+
+        // Debate
+        if (m.debate?.[agent]) {
+          html += '<div style="padding:8px 12px;font-size:11px;border-bottom:1px solid var(--border)">' +
+            '<div style="color:var(--muted);font-size:10px;margin-bottom:4px">Round 2 — Debate</div>' +
+            '<div style="white-space:pre-wrap;word-break:break-word">' + escHtml(m.debate[agent].content?.slice(0, 500) || '') + (m.debate[agent].content?.length > 500 ? '...' : '') + '</div></div>';
+        }
+
+        // Status
+        if (!m.findings?.[agent] && m.status !== 'completed') {
+          html += '<div style="padding:6px 12px;font-size:10px;color:var(--muted)">⏳ Waiting...</div>';
+        }
+
+        html += '</div>';
+      }
+
+      // Conclusion
+      if (m.conclusion) {
+        html += '<div style="background:rgba(63,185,80,0.08);border:1px solid var(--green);border-radius:6px;padding:10px 14px">' +
+          '<div style="color:var(--green);font-weight:600;font-size:12px;margin-bottom:6px">Conclusion (by ' + escHtml(m.conclusion.agent || '?') + ')</div>' +
+          '<div style="font-size:12px;white-space:pre-wrap;word-break:break-word">' + escHtml(m.conclusion.content?.slice(0, 1000) || '') + '</div></div>';
+      }
+
+      // Human notes
+      if (m.humanNotes?.length > 0) {
+        html += '<div style="border-top:1px solid var(--border);padding-top:8px">' +
+          '<div style="color:var(--muted);font-size:10px;margin-bottom:4px">Human Notes</div>' +
+          m.humanNotes.map(n => '<div style="font-size:11px;margin-bottom:2px">• ' + escHtml(n) + '</div>').join('') +
+        '</div>';
+      }
+
+      // Actions
+      if (m.status !== 'completed') {
+        html += '<div style="display:flex;gap:8px;border-top:1px solid var(--border);padding-top:8px">' +
+          '<input id="meeting-note-input" type="text" placeholder="Add context for all agents..." style="flex:1;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-size:12px" onkeydown="if(event.key===\'Enter\')_submitMeetingNote(\'' + escHtml(m.id) + '\')">' +
+          '<button onclick="_submitMeetingNote(\'' + escHtml(m.id) + '\')" style="padding:6px 12px;background:var(--blue);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer;font-size:11px">Add Note</button>' +
+        '</div>' +
+        '<div style="display:flex;gap:8px;margin-top:4px">' +
+          '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;color:var(--yellow);border-color:var(--yellow)" onclick="_advanceMeeting(\'' + escHtml(m.id) + '\')">Skip to Next Round</button>' +
+          '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;color:var(--red);border-color:var(--red)" onclick="_endMeeting(\'' + escHtml(m.id) + '\')">End Meeting</button>' +
+        '</div>';
+      }
+
+      html += '</div>';
+
+      document.getElementById('modal-title').textContent = 'Meeting: ' + m.title;
+      document.getElementById('modal-body').innerHTML = html;
+      document.getElementById('modal-body').style.fontFamily = "'Segoe UI', system-ui, sans-serif";
+      document.getElementById('modal-body').style.whiteSpace = 'normal';
+      document.getElementById('modal').classList.add('open');
+    })
+    .catch(e => alert('Error: ' + e.message));
+}
+
+function openCreateMeetingModal() {
+  const agentOpts = (typeof cmdAgents !== 'undefined' ? cmdAgents : []).map(a =>
+    '<label style="display:flex;align-items:center;gap:6px;cursor:pointer"><input type="checkbox" value="' + escHtml(a.id) + '" checked style="accent-color:var(--blue)"> ' + escHtml(a.name) + ' (' + escHtml(a.role || '') + ')</label>'
+  ).join('');
+  const inputStyle = 'display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-size:var(--text-md);font-family:inherit';
+
+  document.getElementById('modal-title').textContent = 'New Team Meeting';
+  document.getElementById('modal-body').innerHTML =
+    '<div style="display:flex;flex-direction:column;gap:10px">' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Title<input id="mtg-title" style="' + inputStyle + '" placeholder="e.g. Should we add SQLite?"></label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Agenda<textarea id="mtg-agenda" rows="4" style="' + inputStyle + ';resize:vertical" placeholder="What should agents investigate and debate? Be specific about the question to resolve."></textarea></label>' +
+      '<div style="color:var(--text);font-size:var(--text-md)">Participants<div style="display:flex;flex-direction:column;gap:4px;margin-top:4px" id="mtg-participants">' + agentOpts + '</div></div>' +
+      '<div style="display:flex;justify-content:flex-end;gap:8px;margin-top:4px">' +
+        '<button onclick="closeModal()" class="pr-pager-btn">Cancel</button>' +
+        '<button onclick="_submitCreateMeeting()" style="padding:6px 16px;background:var(--blue);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer">Start Meeting</button>' +
+      '</div>' +
+    '</div>';
+  document.getElementById('modal').classList.add('open');
+}
+
+async function _submitCreateMeeting() {
+  const title = document.getElementById('mtg-title')?.value?.trim();
+  const agenda = document.getElementById('mtg-agenda')?.value?.trim();
+  if (!title || !agenda) { alert('Title and agenda required'); return; }
+  const checks = document.querySelectorAll('#mtg-participants input[type="checkbox"]:checked');
+  const participants = [...checks].map(c => c.value);
+  if (participants.length < 2) { alert('Select at least 2 participants'); return; }
+
+  try {
+    const res = await fetch('/api/meetings', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ title, agenda, participants })
+    });
+    const data = await res.json();
+    if (res.ok) {
+      try { closeModal(); } catch { /* expected */ }
+      wakeEngine();
+      refresh();
+      try { showToast('cmd-toast', 'Meeting started with ' + participants.length + ' agents', true); } catch { /* expected */ }
+    } else { alert('Failed: ' + (data.error || 'unknown')); }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+async function _submitMeetingNote(id) {
+  const input = document.getElementById('meeting-note-input');
+  if (!input?.value?.trim()) return;
+  try {
+    await fetch('/api/meetings/note', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ id, note: input.value.trim() })
+    });
+    input.value = '';
+    openMeetingDetail(id); // refresh the modal
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+async function _advanceMeeting(id) {
+  if (!confirm('Skip to next round? Agents that haven\'t finished will be skipped.')) return;
+  try {
+    await fetch('/api/meetings/advance', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ id })
+    });
+    wakeEngine();
+    openMeetingDetail(id);
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+async function _endMeeting(id) {
+  if (!confirm('End this meeting? Current round will be stopped.')) return;
+  try {
+    await fetch('/api/meetings/end', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ id })
+    });
+    try { closeModal(); } catch { /* expected */ }
+    refresh();
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+window.MinionsMeetings = { renderMeetings, openMeetingDetail, openCreateMeetingModal };

package/dashboard/layout.html

@@ -64,6 +64,7 @@
     <a class="sidebar-link" data-page="inbox" href="/inbox">Notes & KB</a>
     <a class="sidebar-link" data-page="tools" href="/tools">Skills & MCP</a>
     <a class="sidebar-link" data-page="schedule" href="/schedule">Schedules</a>
+    <a class="sidebar-link" data-page="meetings" href="/meetings">Meetings</a>
     <a class="sidebar-link" data-page="engine" href="/engine">Engine</a>
   </nav>
   <div class="page-content" id="page-content"><!-- __PAGES__ --></div>

package/dashboard/pages/meetings.html

@@ -0,0 +1,6 @@
+<section>
+  <h2>Team Meetings <span class="count" id="meetings-count">0</span>
+    <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--green);border-color:var(--green);margin-left:8px" onclick="openCreateMeetingModal()">+ New Meeting</button>
+  </h2>
+  <div id="meetings-content"><p class="empty">No meetings yet. Start one to have agents investigate, debate, and conclude on a topic.</p></div>
+</section>

package/dashboard-build.js

@@ -20,7 +20,7 @@ function buildDashboardHtml() {
   const layout = safeRead(layoutPath);
   const css = safeRead(path.join(dashDir, 'styles.css'));
 
-  const pages = ['home', 'work', 'prs', 'plans', 'inbox', 'tools', 'schedule', 'engine'];
+  const pages = ['home', 'work', 'prs', 'plans', 'inbox', 'tools', 'schedule', 'meetings', 'engine'];
   let pageHtml = '';
   for (const p of pages) {
     const content = safeRead(path.join(dashDir, 'pages', p + '.html'));
@@ -32,7 +32,7 @@ function buildDashboardHtml() {
     'utils', 'state', 'detail-panel', 'live-stream',
     'render-agents', 'render-dispatch', 'render-work-items', 'render-prd',
     'render-prs', 'render-plans', 'render-inbox', 'render-kb', 'render-skills',
-    'render-other', 'render-schedules', 'render-pinned',
+    'render-other', 'render-schedules', 'render-meetings', 'render-pinned',
     'command-parser', 'command-input', 'command-center', 'command-history',
     'modal', 'modal-qa', 'settings', 'refresh'
   ];

package/dashboard.js

@@ -63,7 +63,7 @@ function buildDashboardHtml() {
   const css = safeRead(path.join(dashDir, 'styles.css'));
 
   // Assemble page fragments
-  const pages = ['home', 'work', 'prs', 'plans', 'inbox', 'tools', 'schedule', 'engine'];
+  const pages = ['home', 'work', 'prs', 'plans', 'inbox', 'tools', 'schedule', 'meetings', 'engine'];
   let pageHtml = '';
   for (const p of pages) {
     const content = safeRead(path.join(dashDir, 'pages', p + '.html'));
@@ -76,7 +76,7 @@ function buildDashboardHtml() {
     'utils', 'state', 'detail-panel', 'live-stream',
     'render-agents', 'render-dispatch', 'render-work-items', 'render-prd',
     'render-prs', 'render-plans', 'render-inbox', 'render-kb', 'render-skills',
-    'render-other', 'render-schedules', 'render-pinned',
+    'render-other', 'render-schedules', 'render-meetings', 'render-pinned',
     'command-parser', 'command-input', 'command-center', 'command-history',
     'modal', 'modal-qa', 'settings', 'refresh'
   ];
@@ -109,7 +109,11 @@ function rebuildDashboardHtml() {
     HTML_GZ = zlib.gzipSync(HTML);
     HTML_ETAG = '"' + require('crypto').createHash('md5').update(HTML).digest('hex') + '"';
     console.log('  Dashboard hot-reloaded');
-    // Push reload to all connected browsers
+    // Push reload to all connected browsers via status-stream (saves a connection)
+    for (const res of _statusStreamClients) {
+      try { res.write('event: reload\ndata: reload\n\n'); } catch { _statusStreamClients.delete(res); }
+    }
+    // Legacy hot-reload clients
     for (const res of _hotReloadClients) {
       try { res.write('data: reload\n\n'); } catch { _hotReloadClients.delete(res); }
     }
@@ -227,6 +231,7 @@ function getStatus() {
       const runs = shared.safeJson(path.join(MINIONS_DIR, 'engine', 'schedule-runs.json')) || {};
       return scheds.map(s => ({ ...s, _lastRun: runs[s.id] || null }));
     })(),
+    meetings: (() => { try { return require('./engine/meeting').getMeetings(); } catch { return []; } })(),
     pinned: (() => { try { return parsePinnedEntries(safeRead(path.join(MINIONS_DIR, 'pinned.md'))); } catch { return []; } })(),
     projects: PROJECTS.map(p => ({ name: p.name, path: p.localPath, description: p.description || '' })),
     initialized: !!(CONFIG.agents && Object.keys(CONFIG.agents).length > 0),
@@ -3098,6 +3103,59 @@ What would you like to discuss or change? When you're happy, say "approve" and I
     { method: 'POST', path: '/api/schedules/update', desc: 'Update an existing schedule', params: 'id, cron?, title?, type?, project?, agent?, description?, priority?, enabled?', handler: handleSchedulesUpdate },
     { method: 'POST', path: '/api/schedules/delete', desc: 'Delete a schedule', params: 'id', handler: handleSchedulesDelete },
 
+    // Meetings
+    { method: 'POST', path: '/api/meetings', desc: 'Create a team meeting', params: 'title, agenda, participants[]', handler: async (req, res) => {
+      const body = await readBody(req);
+      const { title, agenda, participants } = body;
+      if (!title || !agenda) return jsonReply(res, 400, { error: 'title and agenda required' });
+      const { createMeeting } = require('./engine/meeting');
+      const meeting = createMeeting({ title, agenda, participants: participants || [] });
+      invalidateStatusCache();
+      return jsonReply(res, 200, { ok: true, meeting });
+    }},
+
+    { method: 'GET', path: '/api/meetings', desc: 'List all meetings', handler: async (req, res) => {
+      const { getMeetings } = require('./engine/meeting');
+      return jsonReply(res, 200, { meetings: getMeetings() });
+    }},
+
+    { method: 'GET', path: /^\/api\/meetings\/(MTG-[\w]+)$/, desc: 'Get meeting detail', handler: async (req, res, match) => {
+      const { getMeeting } = require('./engine/meeting');
+      const meeting = getMeeting(match[1]);
+      if (!meeting) return jsonReply(res, 404, { error: 'Meeting not found' });
+      return jsonReply(res, 200, { meeting });
+    }},
+
+    { method: 'POST', path: '/api/meetings/note', desc: 'Add human note to active meeting', params: 'id, note', handler: async (req, res) => {
+      const body = await readBody(req);
+      if (!body.id || !body.note) return jsonReply(res, 400, { error: 'id and note required' });
+      const { addMeetingNote } = require('./engine/meeting');
+      const meeting = addMeetingNote(body.id, body.note);
+      if (!meeting) return jsonReply(res, 404, { error: 'Meeting not found' });
+      invalidateStatusCache();
+      return jsonReply(res, 200, { ok: true, meeting });
+    }},
+
+    { method: 'POST', path: '/api/meetings/advance', desc: 'Force advance meeting to next round', params: 'id', handler: async (req, res) => {
+      const body = await readBody(req);
+      if (!body.id) return jsonReply(res, 400, { error: 'id required' });
+      const { advanceMeetingRound } = require('./engine/meeting');
+      const meeting = advanceMeetingRound(body.id);
+      if (!meeting) return jsonReply(res, 404, { error: 'Meeting not found or already completed' });
+      invalidateStatusCache();
+      return jsonReply(res, 200, { ok: true, meeting });
+    }},
+
+    { method: 'POST', path: '/api/meetings/end', desc: 'End a meeting early', params: 'id', handler: async (req, res) => {
+      const body = await readBody(req);
+      if (!body.id) return jsonReply(res, 400, { error: 'id required' });
+      const { endMeeting } = require('./engine/meeting');
+      const meeting = endMeeting(body.id);
+      if (!meeting) return jsonReply(res, 404, { error: 'Meeting not found' });
+      invalidateStatusCache();
+      return jsonReply(res, 200, { ok: true });
+    }},
+
     // Engine
     { method: 'POST', path: '/api/engine/wakeup', desc: 'Trigger immediate engine tick via control.json signal', handler: async (req, res) => {
       const controlPath = path.join(MINIONS_DIR, 'engine', 'control.json');

package/engine/lifecycle.js

@@ -1074,6 +1074,14 @@ function runPostCompletionHooks(dispatchItem, agentId, code, stdout, config) {
       } catch (err) { e.log('warn', `Decompose cleanup: ${err.message}`); }
     }
   }
+  // Meeting post-completion: collect findings/debate/conclusion
+  if (type === 'meeting' && meta?.meetingId) {
+    try {
+      const { collectMeetingFindings } = require('./meeting');
+      collectMeetingFindings(meta.meetingId, agentId, meta.roundName, stdout);
+    } catch (err) { engine().log('warn', `Meeting collect: ${err.message}`); }
+  }
+
   // Plan chaining removed — user must explicitly execute plan-to-prd after reviewing the plan
   if (isSuccess && meta?.item?.sourcePlan) checkPlanCompletion(meta, config);
 

package/engine/meeting.js

@@ -0,0 +1,266 @@
+/**
+ * engine/meeting.js — Team meeting orchestration.
+ * Manages multi-round meetings: investigate → debate → conclude.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const shared = require('./shared');
+const { safeJson, safeWrite, safeRead, uid } = shared;
+const queries = require('./queries');
+const { getDispatch } = queries;
+const { renderPlaybook } = require('./playbook');
+
+let _engine = null;
+function engine() { if (!_engine) _engine = require('../engine'); return _engine; }
+
+const MEETINGS_DIR = path.join(__dirname, '..', 'meetings');
+
+function getMeetings() {
+  if (!fs.existsSync(MEETINGS_DIR)) return [];
+  return fs.readdirSync(MEETINGS_DIR)
+    .filter(f => f.endsWith('.json'))
+    .map(f => safeJson(path.join(MEETINGS_DIR, f)))
+    .filter(Boolean);
+}
+
+function getMeeting(id) {
+  const filePath = path.join(MEETINGS_DIR, id + '.json');
+  return safeJson(filePath);
+}
+
+function saveMeeting(meeting) {
+  if (!fs.existsSync(MEETINGS_DIR)) fs.mkdirSync(MEETINGS_DIR, { recursive: true });
+  safeWrite(path.join(MEETINGS_DIR, meeting.id + '.json'), meeting);
+}
+
+function createMeeting({ title, agenda, participants }) {
+  const id = 'MTG-' + uid().slice(0, 8);
+  const meeting = {
+    id, title, agenda,
+    status: 'investigating',
+    round: 1,
+    participants: participants || [],
+    createdBy: 'human',
+    createdAt: new Date().toISOString(),
+    findings: {},
+    debate: {},
+    conclusion: null,
+    humanNotes: [],
+    transcript: [],
+  };
+  saveMeeting(meeting);
+  return meeting;
+}
+
+/**
+ * Discover meeting work items for the current round.
+ * Called from discoverWork() in engine.js tick cycle.
+ */
+function discoverMeetingWork(config) {
+  const meetings = getMeetings();
+  const work = [];
+  const dispatch = getDispatch();
+  const activeKeys = new Set(
+    [...(dispatch.pending || []), ...(dispatch.active || [])]
+      .map(d => d.meta?.dispatchKey)
+      .filter(Boolean)
+  );
+
+  for (const meeting of meetings) {
+    if (meeting.status === 'completed') continue;
+
+    const round = meeting.round || 1;
+    const roundName = meeting.status; // investigating, debating, concluding
+    const agents = config.agents || {};
+
+    if (roundName === 'concluding') {
+      // Only one agent concludes (first participant)
+      const concluder = meeting.participants[0];
+      if (!concluder) continue;
+      const key = `meeting-${meeting.id}-r${round}-${concluder}`;
+      if (activeKeys.has(key)) continue;
+
+      const humanNotes = (meeting.humanNotes || []).map(n => '- ' + n).join('\n');
+      const allFindings = Object.entries(meeting.findings || {}).map(([agent, f]) =>
+        `### ${agents[agent]?.name || agent}\n\n${f.content || '(no findings)'}`
+      ).join('\n\n---\n\n');
+      const allDebate = Object.entries(meeting.debate || {}).map(([agent, d]) =>
+        `### ${agents[agent]?.name || agent}\n\n${d.content || '(no response)'}`
+      ).join('\n\n---\n\n');
+
+      const vars = {
+        agent_name: agents[concluder]?.name || concluder,
+        agent_role: agents[concluder]?.role || 'Agent',
+        agent_id: concluder,
+        meeting_title: meeting.title,
+        agenda: meeting.agenda,
+        all_findings: allFindings,
+        all_debate: allDebate,
+        human_notes: humanNotes,
+      };
+
+      const prompt = renderPlaybook('meeting-conclude', vars);
+      if (!prompt) continue;
+
+      work.push({
+        type: 'meeting',
+        agent: concluder,
+        agentName: agents[concluder]?.name || concluder,
+        agentRole: agents[concluder]?.role || 'Agent',
+        task: `Meeting: ${meeting.title} (Conclude)`,
+        prompt,
+        meta: {
+          dispatchKey: key,
+          source: 'meeting',
+          meetingId: meeting.id,
+          round,
+          roundName: 'conclude',
+        }
+      });
+      continue;
+    }
+
+    // For investigate and debate rounds, dispatch all participants
+    for (const agentId of meeting.participants) {
+      // Skip if already submitted for this round
+      if (roundName === 'investigating' && meeting.findings?.[agentId]) continue;
+      if (roundName === 'debating' && meeting.debate?.[agentId]) continue;
+
+      const key = `meeting-${meeting.id}-r${round}-${agentId}`;
+      if (activeKeys.has(key)) continue;
+
+      const humanNotes = (meeting.humanNotes || []).map(n => '- ' + n).join('\n');
+      const vars = {
+        agent_name: agents[agentId]?.name || agentId,
+        agent_role: agents[agentId]?.role || 'Agent',
+        agent_id: agentId,
+        meeting_title: meeting.title,
+        agenda: meeting.agenda,
+        human_notes: humanNotes,
+      };
+
+      if (roundName === 'debating') {
+        vars.all_findings = Object.entries(meeting.findings || {}).map(([agent, f]) =>
+          `### ${agents[agent]?.name || agent}\n\n${f.content || '(no findings)'}`
+        ).join('\n\n---\n\n');
+      }
+
+      const playbookName = roundName === 'investigating' ? 'meeting-investigate' : 'meeting-debate';
+      const prompt = renderPlaybook(playbookName, vars);
+      if (!prompt) continue;
+
+      work.push({
+        type: 'meeting',
+        agent: agentId,
+        agentName: agents[agentId]?.name || agentId,
+        agentRole: agents[agentId]?.role || 'Agent',
+        task: `Meeting: ${meeting.title} (Round ${round} — ${roundName})`,
+        prompt,
+        meta: {
+          dispatchKey: key,
+          source: 'meeting',
+          meetingId: meeting.id,
+          round,
+          roundName: roundName === 'investigating' ? 'investigate' : 'debate',
+        }
+      });
+    }
+  }
+  return work;
+}
+
+/**
+ * Collect findings from a completed meeting agent.
+ * Called from runPostCompletionHooks when type === 'meeting'.
+ */
+function collectMeetingFindings(meetingId, agentId, roundName, output) {
+  const e = engine();
+  const meeting = getMeeting(meetingId);
+  if (!meeting) return;
+
+  const { text } = shared.parseStreamJsonOutput(output, { maxTextLength: 50000 });
+  const content = text || '(no output)';
+
+  if (roundName === 'investigate') {
+    meeting.findings[agentId] = { content, submittedAt: new Date().toISOString() };
+    meeting.transcript.push({ round: meeting.round, agent: agentId, type: 'finding', content, at: new Date().toISOString() });
+  } else if (roundName === 'debate') {
+    meeting.debate[agentId] = { content, submittedAt: new Date().toISOString() };
+    meeting.transcript.push({ round: meeting.round, agent: agentId, type: 'debate', content, at: new Date().toISOString() });
+  } else if (roundName === 'conclude') {
+    meeting.conclusion = { content, agent: agentId, submittedAt: new Date().toISOString() };
+    meeting.transcript.push({ round: meeting.round, agent: agentId, type: 'conclusion', content, at: new Date().toISOString() });
+    meeting.status = 'completed';
+    meeting.completedAt = new Date().toISOString();
+
+    // Write transcript to inbox so agents learn from it
+    const config = queries.getConfig();
+    const agents = config.agents || {};
+    const transcript = meeting.transcript.map(t =>
+      `### ${agents[t.agent]?.name || t.agent} (${t.type}, Round ${t.round})\n\n${t.content}`
+    ).join('\n\n---\n\n');
+    const inboxPath = path.join(__dirname, '..', 'notes', 'inbox',
+      `meeting-${meetingId}-${new Date().toISOString().slice(0, 10)}.md`);
+    safeWrite(inboxPath, `# Meeting Transcript: ${meeting.title}\n\n${transcript}`);
+
+    e.log('info', `Meeting ${meetingId} completed — transcript written to inbox`);
+    saveMeeting(meeting);
+    return;
+  }
+
+  // Check if all participants have submitted for this round
+  const allSubmitted = meeting.participants.every(p => {
+    if (meeting.status === 'investigating') return !!meeting.findings[p];
+    if (meeting.status === 'debating') return !!meeting.debate[p];
+    return true;
+  });
+
+  if (allSubmitted) {
+    // Advance to next round
+    if (meeting.status === 'investigating') {
+      meeting.status = 'debating';
+      meeting.round = 2;
+      e.log('info', `Meeting ${meetingId}: all findings in — advancing to debate`);
+    } else if (meeting.status === 'debating') {
+      meeting.status = 'concluding';
+      meeting.round = 3;
+      e.log('info', `Meeting ${meetingId}: all debate responses in — advancing to conclusion`);
+    }
+  }
+
+  saveMeeting(meeting);
+}
+
+function addMeetingNote(meetingId, note) {
+  const meeting = getMeeting(meetingId);
+  if (!meeting) return null;
+  meeting.humanNotes.push(note);
+  meeting.transcript.push({ round: meeting.round, agent: 'human', type: 'note', content: note, at: new Date().toISOString() });
+  saveMeeting(meeting);
+  return meeting;
+}
+
+function advanceMeetingRound(meetingId) {
+  const meeting = getMeeting(meetingId);
+  if (!meeting || meeting.status === 'completed') return null;
+  if (meeting.status === 'investigating') { meeting.status = 'debating'; meeting.round = 2; }
+  else if (meeting.status === 'debating') { meeting.status = 'concluding'; meeting.round = 3; }
+  saveMeeting(meeting);
+  return meeting;
+}
+
+function endMeeting(meetingId) {
+  const meeting = getMeeting(meetingId);
+  if (!meeting) return null;
+  meeting.status = 'completed';
+  meeting.completedAt = new Date().toISOString();
+  saveMeeting(meeting);
+  return meeting;
+}
+
+module.exports = {
+  MEETINGS_DIR, getMeetings, getMeeting, saveMeeting, createMeeting,
+  discoverMeetingWork, collectMeetingFindings,
+  addMeetingNote, advanceMeetingRound, endMeeting,
+};

package/engine/playbook.js

@@ -440,7 +440,7 @@ function selectPlaybook(workType, item) {
   if (workType === 'review' && !item?._pr && !item?.pr_id) {
     return 'work-item';
   }
-  const typeSpecificPlaybooks = ['explore', 'review', 'test', 'plan-to-prd', 'plan', 'ask', 'verify', 'decompose'];
+  const typeSpecificPlaybooks = ['explore', 'review', 'test', 'plan-to-prd', 'plan', 'ask', 'verify', 'decompose', 'meeting-investigate', 'meeting-debate', 'meeting-conclude'];
   return typeSpecificPlaybooks.includes(workType) ? workType : 'work-item';
 }
 

package/engine.js

@@ -1960,6 +1960,13 @@ function discoverWork(config) {
     }
   } catch (e) { log('warn', 'discover scheduled work: ' + e.message); }
 
+  // Meeting work (multi-round team discussions)
+  try {
+    const { discoverMeetingWork } = require('./engine/meeting');
+    const meetingWork = discoverMeetingWork(config);
+    allWorkItems.push(...meetingWork);
+  } catch (e) { log('warn', 'discover meeting work: ' + e.message); }
+
   // Gate reviews and fixes: do not dispatch until all implement items are complete
   const hasIncompleteImplements = projects.some(project => {
     const items = safeJson(projectWorkItemsPath(project)) || [];

package/package.json

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

package/playbooks/meeting-conclude.md

@@ -0,0 +1,35 @@
+# Meeting: Conclusion
+
+You are {{agent_name}} ({{agent_role}}), synthesizing the team meeting results.
+
+## Meeting: {{meeting_title}}
+
+## Agenda
+
+{{agenda}}
+
+## Investigation Findings
+
+{{all_findings}}
+
+## Debate Responses
+
+{{all_debate}}
+
+{{#human_notes}}
+## Human Notes
+
+{{human_notes}}
+{{/human_notes}}
+
+## Your Task
+
+Write a clear meeting conclusion:
+
+1. **Areas of consensus** — what does the team agree on?
+2. **Unresolved disagreements** — where do positions still differ?
+3. **Recommended decision** — what should we do?
+4. **Action items** — specific next steps with owners
+5. **Open questions** — what still needs human input?
+
+Be decisive. If there's a clear best option, say so.

package/playbooks/meeting-debate.md

@@ -0,0 +1,35 @@
+# Meeting: Debate Round
+
+You are {{agent_name}} ({{agent_role}}) in Round 2 of a team meeting.
+
+## Meeting: {{meeting_title}}
+
+## Agenda
+
+{{agenda}}
+
+## Round 1 Findings from All Participants
+
+{{all_findings}}
+
+{{#human_notes}}
+## Human Notes (READ CAREFULLY)
+
+{{human_notes}}
+{{/human_notes}}
+
+## Your Task
+
+You've read everyone's investigation findings above. Now:
+
+1. **What do you agree with?** Which points are strongest?
+2. **What do you disagree with?** Challenge weak arguments directly.
+3. **Play devil's advocate** — what's the strongest counterargument to your OWN position?
+4. **What's missing?** What did everyone overlook?
+5. **What should the team decide?**
+
+Be direct. Constructive disagreement is encouraged — don't just agree with everyone.
+
+## Output Format
+
+Write your debate response as markdown. Reference other agents' findings by name.

package/playbooks/meeting-investigate.md

@@ -0,0 +1,30 @@
+# Meeting: Investigation Round
+
+You are {{agent_name}} ({{agent_role}}) participating in a team meeting.
+
+## Meeting: {{meeting_title}}
+
+## Agenda
+
+{{agenda}}
+
+{{#human_notes}}
+## Human Notes (READ CAREFULLY)
+
+{{human_notes}}
+{{/human_notes}}
+
+## Your Task
+
+Investigate this topic from your unique perspective as {{agent_role}}.
+
+1. **Analyze** the question/issue thoroughly
+2. **Research** the codebase if relevant (use your tools)
+3. **Form your position** with evidence
+4. **Write your findings** clearly — other agents will read and respond
+
+Focus on what YOU uniquely bring to this discussion. Be thorough but concise.
+
+## Output Format
+
+Write your findings as a clear markdown document. Start with your key conclusion, then supporting evidence.

package/routing.md

@@ -18,6 +18,7 @@ How the engine decides who handles what. Parsed by engine.js — keep the table
 | ask | ripley | rebecca |
 | verify | dallas | ralph |
 | decompose | ripley | rebecca |
+| meeting | ripley | rebecca |
 
 Notes:
 - `_author_` means route to the PR author