@yemi33/squad 0.1.14 → 0.1.16

package/README.md

@@ -128,7 +128,6 @@ You can also run scripts directly: `node ~/.squad/engine.js start`, `node ~/.squ
                     │  engine.js        ← tick 60s  │
                     │  dashboard.js     ← :7331     │
                     │  config.json      ← projects  │
-                    │  mcp-servers.json ← auto-sync │
                     │  agents/          ← 5 agents  │
                     │  playbooks/       ← templates │
                     │  prd.json         ← squad PRD │
@@ -231,7 +230,7 @@ When dispatching agents, the engine reads each project's `CLAUDE.md` and injects
 
 ## MCP Server Integration
 
-Agents need MCP tools to interact with your repo host (create PRs, post review comments, etc.). On engine start, MCP servers are auto-synced from `~/.claude.json` to `mcp-servers.json`.
+Agents need MCP tools to interact with your repo host (create PRs, post review comments, etc.). Agents inherit MCP servers directly from `~/.claude.json` as Claude Code processes — add servers there and they're immediately available to all agents on next spawn.
 
 **Example:** If you use Azure DevOps, configure the `azure-ado` MCP server in your Claude Code settings. If you use GitHub, configure the `github` MCP server. Agents will discover and use whichever tools are available.
 
@@ -314,7 +313,7 @@ No bash or shell involved — Node spawns Node directly. Prompts with special ch
 - **System prompt** — identity, charter, history, project context, critical rules, skill index, team notes
 - **Task prompt** — rendered playbook with `{{variables}}` filled from config
 - **Working directory** — project root (agent creates worktrees as needed)
-- **MCP servers** — all servers from `~/.claude.json` via `--mcp-config`
+- **MCP servers** — inherited from `~/.claude.json` (no extra config needed)
 - **Full tool access** — all built-in tools plus all MCP tools
 - **Permission mode** — `bypassPermissions` (no interactive prompts)
 - **Output format** — `stream-json` (real-time streaming for live dashboard + heartbeat)
@@ -446,7 +445,6 @@ squad start
 
 **Machine-specific (reconfigure per machine):**
 - `config.json` — contains absolute paths to project directories. Re-link via `squad add <dir>`.
-- `mcp-servers.json` — auto-synced from `~/.claude.json` on engine start.
 
 To move to a new machine: `npm install -g @yemi33/squad && squad init --force`, then re-run `squad add` for each project.
 
@@ -471,7 +469,6 @@ To move to a new machine: `npm install -g @yemi33/squad && squad init --force`,
   prd.json               <- Squad-level PRD (multi-project items)
   config.template.json   <- Template for new installs
   package.json           <- npm package definition
-  mcp-servers.json       <- MCP servers (auto-synced, gitignored)
   routing.md             <- Dispatch rules table (editable)
   team.md                <- Team roster
   notes.md               <- Team rules + consolidated learnings (runtime)

package/dashboard.html

@@ -58,6 +58,11 @@
   .modal-qa-loading .dot-pulse span:nth-child(2) { animation-delay: 0.2s; }
   .modal-qa-loading .dot-pulse span:nth-child(3) { animation-delay: 0.4s; }
   @keyframes dotPulse { 0%, 80%, 100% { opacity: 0.3; transform: scale(0.8); } 40% { opacity: 1; transform: scale(1); } }
+  .modal-qa-selection-pill { display: flex; align-items: center; gap: 6px; padding: 4px 8px; margin-bottom: 6px; background: rgba(88,166,255,0.08); border: 1px solid rgba(88,166,255,0.25); border-radius: 4px; font-size: 11px; }
+  .modal-qa-selection-pill .pill-label { color: var(--blue); font-weight: 600; white-space: nowrap; }
+  .modal-qa-selection-pill .pill-text { color: var(--muted); flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-style: italic; }
+  .modal-qa-selection-pill .pill-clear { background: none; border: none; color: var(--muted); cursor: pointer; font-size: 14px; padding: 0 2px; line-height: 1; }
+  .modal-qa-selection-pill .pill-clear:hover { color: var(--red); }
   .modal-qa-input-wrap { display: flex; gap: 6px; }
   .modal-qa-input { flex: 1; background: var(--bg); border: 1px solid var(--border); border-radius: 4px; padding: 6px 10px; font-size: 12px; color: var(--text); font-family: inherit; }
   .modal-qa-input:focus { border-color: var(--blue); outline: none; }
@@ -239,7 +244,19 @@
     transition: border-color 0.2s, box-shadow 0.2s; padding: 0;
   }
   .cmd-input-wrap:focus-within { border-color: var(--blue); box-shadow: 0 0 0 3px rgba(88,166,255,0.12); }
+  .cmd-highlight-layer {
+    position: absolute; top: 0; left: 0; right: 0; bottom: 0;
+    padding: 14px 16px; font-size: 14px; font-family: inherit; line-height: 1.5;
+    white-space: pre-wrap; word-wrap: break-word; overflow: hidden;
+    pointer-events: none; color: transparent; border-radius: 10px;
+  }
+  .cmd-highlight-layer .hl-cmd { color: transparent; background: rgba(88,166,255,0.18); border-radius: 3px; }
+  .cmd-highlight-layer .hl-mention { color: transparent; background: rgba(63,185,80,0.18); border-radius: 3px; }
+  .cmd-highlight-layer .hl-priority { color: transparent; background: rgba(210,153,34,0.18); border-radius: 3px; }
+  .cmd-highlight-layer .hl-project { color: transparent; background: rgba(188,140,255,0.18); border-radius: 3px; }
+  .cmd-highlight-layer .hl-flag { color: transparent; background: rgba(248,81,73,0.18); border-radius: 3px; }
   .cmd-input-wrap textarea {
+    position: relative; z-index: 1;
     flex: 1; background: transparent; border: none; color: var(--text);
     padding: 14px 16px; font-size: 14px; font-family: inherit; resize: none;
     outline: none; line-height: 1.5; min-height: 48px; max-height: 200px;
@@ -358,11 +375,15 @@
   .dispatch-item { display: flex; align-items: center; gap: 8px; padding: 8px 10px; background: var(--surface2); border: 1px solid var(--border); border-radius: 6px; font-size: 12px; }
   .dispatch-type { font-size: 10px; font-weight: 600; padding: 2px 8px; border-radius: 8px; text-transform: uppercase; white-space: nowrap; }
   .dispatch-type.implement { background: rgba(88,166,255,0.15); color: var(--blue); }
+  .dispatch-type.implement\:large { background: rgba(88,166,255,0.25); color: var(--blue); }
   .dispatch-type.review { background: rgba(188,140,255,0.15); color: var(--purple); }
   .dispatch-type.fix { background: rgba(210,153,34,0.15); color: var(--yellow); }
   .dispatch-type.analyze { background: rgba(63,185,80,0.15); color: var(--green); }
   .dispatch-type.explore { background: rgba(139,148,158,0.15); color: var(--muted); }
   .dispatch-type.test { background: rgba(227,179,65,0.15); color: var(--orange); }
+  .dispatch-type.plan { background: rgba(168,85,247,0.15); color: #a855f7; }
+  .dispatch-type.plan-to-prd { background: rgba(168,85,247,0.1); color: #a855f7; }
+  .dispatch-type.ask { background: rgba(63,185,80,0.15); color: var(--green); }
   .dispatch-type.manual { background: rgba(139,148,158,0.15); color: var(--muted); }
   .dispatch-agent { font-weight: 600; color: var(--text); }
   .dispatch-task { flex: 1; color: var(--muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
@@ -478,8 +499,9 @@
   <section class="cmd-center">
     <h2>Command Center</h2>
     <div class="cmd-input-wrap" id="cmd-input-wrap">
+      <div class="cmd-highlight-layer" id="cmd-highlight" aria-hidden="true"></div>
       <textarea id="cmd-input" rows="1" placeholder='What do you need? e.g. "Fix the auth bug @dallas", "explain the dispatch flow", or "/note always use feature flags"'
-        oninput="cmdInputChanged()" onkeydown="cmdKeyDown(event)"></textarea>
+        oninput="cmdInputChanged()" onkeydown="cmdKeyDown(event)" onscroll="syncHighlightScroll()"></textarea>
       <button class="cmd-send-btn" id="cmd-send-btn" onclick="cmdSubmit()">Send <kbd>Ctrl+Enter</kbd></button>
     </div>
     <div class="cmd-mention-popup" id="cmd-mention-popup"></div>
@@ -526,7 +548,7 @@
   </section>
 
   <section>
-    <h2>Notes Inbox <span class="count" id="inbox-count">0</span></h2>
+    <h2>Notes Inbox <span class="count" id="inbox-count">0</span> <span style="font-size:10px;color:var(--muted);font-weight:400;text-transform:none;letter-spacing:0">auto-consolidates at 3 notes</span></h2>
     <div class="inbox-list" id="inbox-list">Loading...</div>
   </section>
 
@@ -546,6 +568,11 @@
     <div id="skills-list"><p class="empty">No skills yet. Agents create these when they discover repeatable workflows.</p></div>
   </section>
 
+  <section>
+    <h2>MCP Servers <span class="count" id="mcp-count">0</span></h2>
+    <div id="mcp-list"><p class="empty">No MCP servers synced.</p></div>
+  </section>
+
   <section>
     <h2>Dispatch Queue</h2>
     <div class="dispatch-stats" id="dispatch-stats"></div>
@@ -601,6 +628,11 @@
     <div class="modal-body" id="modal-body"></div>
     <div class="modal-qa" id="modal-qa">
       <div class="modal-qa-thread" id="modal-qa-thread"></div>
+      <div class="modal-qa-selection-pill" id="modal-qa-pill" style="display:none">
+        <span class="pill-label">Selection:</span>
+        <span class="pill-text" id="modal-qa-pill-text"></span>
+        <button class="pill-clear" onclick="clearQaSelection()" title="Clear selection">&times;</button>
+      </div>
       <div class="modal-qa-input-wrap">
         <input type="text" class="modal-qa-input" id="modal-qa-input" placeholder="Ask about this document (or select text first)..." onkeydown="if(event.key==='Enter')modalAskSubmit()">
         <button class="modal-qa-btn" id="modal-qa-btn" onclick="modalAskSubmit()">Ask</button>
@@ -850,23 +882,45 @@ function renderInbox(inbox) {
         <span>${escHtml(item.name)}</span><span>${item.age}</span>
       </div>
       <div class="inbox-preview" onclick="openModal(${i})" style="cursor:pointer">${escHtml(item.content.slice(0,200))}</div>
-      <div style="display:flex;gap:6px;margin-top:6px">
-        <button class="pr-pager-btn" style="font-size:9px;padding:2px 8px" onclick="event.stopPropagation();persistInboxItem('${escHtml(item.name)}')">Persist as Note</button>
+      <div style="display:flex;gap:6px;margin-top:6px;align-items:center">
+        <button class="pr-pager-btn" style="font-size:9px;padding:2px 8px" onclick="event.stopPropagation();promoteToKB('${escHtml(item.name)}')">Add to Knowledge Base</button>
         <button class="pr-pager-btn" style="font-size:9px;padding:2px 8px" onclick="event.stopPropagation();openInboxInExplorer('${escHtml(item.name)}')">Open in Explorer</button>
       </div>
     </div>
   `).join('');
 }
 
-async function persistInboxItem(name) {
+function promoteToKB(name) {
+  const categories = [
+    { id: 'architecture', label: 'Architecture' },
+    { id: 'conventions', label: 'Conventions' },
+    { id: 'project-notes', label: 'Project Notes' },
+    { id: 'build-reports', label: 'Build Reports' },
+    { id: 'reviews', label: 'Reviews' },
+  ];
+  const picker = '<div style="padding:16px 20px">' +
+    '<p style="font-size:13px;color:var(--text);margin-bottom:12px">Choose a category for <strong>' + escHtml(name) + '</strong>:</p>' +
+    '<div style="display:flex;flex-direction:column;gap:8px">' +
+    categories.map(c =>
+      '<button class="pr-pager-btn" style="font-size:12px;padding:8px 16px;text-align:left" onclick="doPromoteToKB(\'' + escHtml(name) + '\',\'' + c.id + '\')">' + c.label + '</button>'
+    ).join('') +
+    '</div></div>';
+  document.getElementById('modal-title').textContent = 'Add to Knowledge Base';
+  document.getElementById('modal-body').innerHTML = picker;
+  document.getElementById('modal').classList.add('open');
+}
+
+async function doPromoteToKB(name, category) {
   try {
-    const res = await fetch('/api/inbox/persist', {
+    const res = await fetch('/api/inbox/promote-kb', {
       method: 'POST', headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ name })
+      body: JSON.stringify({ name, category })
     });
     const data = await res.json();
     if (res.ok) {
+      closeModal();
       refresh();
+      refreshKnowledgeBase();
     } else {
       alert('Failed: ' + (data.error || 'unknown'));
     }
@@ -1002,7 +1056,9 @@ function openModal(i) {
   const item = inboxData[i];
   if (!item) return;
   document.getElementById('modal-title').textContent = item.name;
-  document.getElementById('modal-body').textContent = item.content;
+  document.getElementById('modal-body').innerHTML =
+    '<div style="margin-bottom:12px"><button class="pr-pager-btn" style="font-size:10px;padding:3px 10px" onclick="promoteToKB(\'' + escHtml(item.name) + '\')">Add to Knowledge Base</button></div>' +
+    '<pre style="white-space:pre-wrap;word-wrap:break-word;margin:0;font-family:Consolas,monospace;font-size:12px;line-height:1.7;color:var(--muted)">' + escHtml(item.content) + '</pre>';
   document.getElementById('modal').classList.add('open');
 }
 function closeModal() {
@@ -1012,6 +1068,7 @@ function closeModal() {
   document.getElementById('modal-qa-thread').innerHTML = '';
   document.getElementById('modal-qa-input').value = '';
   document.getElementById('modal-qa-input').placeholder = 'Ask about this document (or select text first)...';
+  document.getElementById('modal-qa-pill').style.display = 'none';
   document.getElementById('ask-selection-btn').style.display = 'none';
 }
 
@@ -1254,6 +1311,7 @@ async function refresh() {
     renderMetrics(data.metrics || {});
     renderWorkItems(data.workItems || []);
     renderSkills(data.skills || []);
+    renderMcpServers(data.mcpServers || []);
     // Refresh KB and plans less frequently (every 3rd cycle = ~12s)
     if (!window._kbRefreshCount) window._kbRefreshCount = 0;
     if (window._kbRefreshCount++ % 3 === 0) { refreshKnowledgeBase(); refreshPlans(); }
@@ -1282,6 +1340,25 @@ function renderProjects(projects) {
 
 }
 
+// -- MCP Servers --
+function renderMcpServers(servers) {
+  const el = document.getElementById('mcp-list');
+  const countEl = document.getElementById('mcp-count');
+  countEl.textContent = servers.length;
+  if (!servers.length) {
+    el.innerHTML = '<p class="empty">No MCP servers found. Add them to <code>~/.claude.json</code> and they\'ll appear here automatically.</p>';
+    return;
+  }
+  el.innerHTML = '<div style="display:flex;flex-wrap:wrap;gap:6px;margin-bottom:8px">' +
+    servers.map(s =>
+      '<div style="font-size:11px;padding:5px 10px;background:var(--surface2);border:1px solid var(--border);border-radius:6px;color:var(--text)" title="' + escHtml(s.args || s.command) + '">' +
+        escHtml(s.name) +
+      '</div>'
+    ).join('') +
+  '</div>' +
+  '<p style="font-size:10px;color:var(--muted);margin:0">Synced from <code style="color:var(--blue)">~/.claude.json</code> — add MCP servers there to make them available to all agents.</p>';
+}
+
 // -- Squad Skills --
 function renderSkills(skills) {
   const el = document.getElementById('skills-list');
@@ -1645,11 +1722,11 @@ function cmdParseInput(raw) {
     if (/--parallel\b/i.test(text)) {
       result.branchStrategy = 'parallel';
       text = text.replace(/--parallel\b/i, '').trim();
-    } else if (/--shared\b/i.test(text)) {
+    } else if (/--stack\b/i.test(text)) {
       result.branchStrategy = 'shared-branch';
-      text = text.replace(/--shared\b/i, '').trim();
+      text = text.replace(/--stack\b/i, '').trim();
     } else {
-      result.branchStrategy = 'shared-branch'; // default
+      result.branchStrategy = 'parallel'; // default — items without depends_on get independent branches
     }
   } else if (/^\/prd\b/i.test(text)) {
     result.intent = 'prd';
@@ -1712,19 +1789,19 @@ function cmdRenderMeta() {
   let chips = [];
 
   // Intent chip
-  const intentLabels = { 'work-item': 'Work Item', 'note': 'Note', 'prd': 'PRD Item', 'plan': 'Plan → PRD → Dispatch' };
-  chips.push('<span class="cmd-chip intent">' + intentLabels[parsed.intent] + '</span>');
+  if (parsed.intent === 'plan') {
+    const strategy = parsed.branchStrategy || 'parallel';
+    const stratLabel = strategy === 'parallel' ? 'parallel branches' : 'stacked';
+    chips.push('<span class="cmd-chip" style="background:var(--purple,#a855f7);color:#fff">Plan → PRD → Dispatch (' + stratLabel + ')</span>');
+  } else {
+    const intentLabels = { 'work-item': 'Work Item', 'note': 'Note', 'prd': 'PRD Item' };
+    chips.push('<span class="cmd-chip intent">' + intentLabels[parsed.intent] + '</span>');
+  }
 
   // Type chip (only for work items)
   if (parsed.intent === 'work-item') {
     chips.push('<span class="cmd-chip">' + parsed.type + '</span>');
   }
-  // Pipeline chip for /plan
-  if (parsed.intent === 'plan') {
-    const strategy = parsed.branchStrategy || 'shared-branch';
-    const stratLabel = strategy === 'parallel' ? 'parallel branches' : 'shared branch';
-    chips.push('<span class="cmd-chip" style="background:var(--purple,#a855f7);color:#fff">plan → prd → agents (' + stratLabel + ')</span>');
-  }
 
   // Priority chip
   chips.push('<span class="cmd-chip priority-' + parsed.priority + '">' + parsed.priority + ' priority</span>');
@@ -1832,8 +1909,30 @@ function cmdAutoResize() {
   ta.style.height = Math.min(ta.scrollHeight, 200) + 'px';
 }
 
+function cmdUpdateHighlight() {
+  const text = document.getElementById('cmd-input').value;
+  const hl = document.getElementById('cmd-highlight');
+  if (!text) { hl.innerHTML = ''; return; }
+  // Escape HTML then wrap tokens with highlight spans
+  let html = text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+  html = html.replace(/(\/(?:plan|prd|note|decide)\b)/gi, '<span class="hl-cmd">$1</span>');
+  html = html.replace(/(@\w+)/g, '<span class="hl-mention">$1</span>');
+  html = html.replace(/(![a-z]+\b)/gi, '<span class="hl-priority">$1</span>');
+  html = html.replace(/(#\S+)/g, '<span class="hl-project">$1</span>');
+  html = html.replace(/(--(?:stack|parallel)\b)/gi, '<span class="hl-flag">$1</span>');
+  hl.innerHTML = html + '\n'; // trailing newline prevents layout shift
+}
+
+function syncHighlightScroll() {
+  const ta = document.getElementById('cmd-input');
+  const hl = document.getElementById('cmd-highlight');
+  hl.scrollTop = ta.scrollTop;
+  hl.scrollLeft = ta.scrollLeft;
+}
+
 function cmdInputChanged() {
   cmdAutoResize();
+  cmdUpdateHighlight();
   cmdRenderMeta();
 
   // Check for @ mention or # project trigger
@@ -2014,7 +2113,7 @@ async function cmdSubmitPlan(parsed) {
     title: parsed.title,
     description: parsed.description || '',
     priority: parsed.priority,
-    branch_strategy: parsed.branchStrategy || 'shared-branch',
+    branch_strategy: parsed.branchStrategy || 'parallel',
   };
   if (parsed.project) body.project = parsed.project;
   if (parsed.agents.length === 1) body.agent = parsed.agents[0];
@@ -2053,36 +2152,98 @@ async function cmdSubmitPrd(parsed) {
 
 let _modalDocContext = { title: '', content: '', selection: '' };
 
-// Track text selection in modal body for the floating "Ask about this" button
+// Track text selection anywhere in content areas for the floating "Ask about this" button
 document.addEventListener('mouseup', function(e) {
-  const btn = document.getElementById('ask-selection-btn');
-  const modalBody = document.getElementById('modal-body');
-  const sel = window.getSelection();
-  const text = sel?.toString()?.trim();
-
-  if (text && text.length > 5 && modalBody?.contains(sel?.anchorNode)) {
-    _modalDocContext.selection = text;
-    btn.style.display = 'block';
-    btn.style.left = e.pageX + 'px';
-    btn.style.top = (e.pageY - 35) + 'px';
-  } else {
-    btn.style.display = 'none';
-  }
+  // Small delay to let the selection finalize
+  setTimeout(() => {
+    const btn = document.getElementById('ask-selection-btn');
+    if (!btn) return;
+    const sel = window.getSelection();
+    const text = sel?.toString()?.trim();
+
+    if (!text || text.length < 3) {
+      btn.style.display = 'none';
+      return;
+    }
+
+    // Check if selection is in any content area: modal body, detail panel, notes, kb
+    const anchor = sel?.anchorNode;
+    if (!anchor) { btn.style.display = 'none'; return; }
+
+    const modalBody = document.getElementById('modal-body');
+    const detailContent = document.getElementById('detail-content');
+    const isInModal = modalBody?.contains(anchor);
+    const isInDetail = detailContent?.contains(anchor);
+
+    if (isInModal || isInDetail) {
+      _modalDocContext.selection = text;
+      // If we don't have document context yet (e.g. detail panel), capture it
+      if (!_modalDocContext.content && isInDetail) {
+        _modalDocContext.content = detailContent.textContent || '';
+        _modalDocContext.title = document.getElementById('detail-agent-name')?.textContent || 'Agent Detail';
+      }
+      btn.style.display = 'block';
+      // Position near the cursor but within viewport
+      const x = Math.min(e.clientX, window.innerWidth - 140);
+      const y = Math.max(e.clientY - 35, 10);
+      btn.style.left = x + 'px';
+      btn.style.top = y + 'px';
+      btn.style.position = 'fixed';
+    } else {
+      btn.style.display = 'none';
+    }
+  }, 10);
 });
 
 function modalAskAboutSelection() {
   document.getElementById('ask-selection-btn').style.display = 'none';
+
+  // If the modal isn't open but we have a selection (from detail panel), open modal for Q&A
+  const modal = document.getElementById('modal');
+  if (!modal.classList.contains('open')) {
+    document.getElementById('modal-title').textContent = 'Q&A: ' + (_modalDocContext.title || 'Document');
+    document.getElementById('modal-body').textContent = _modalDocContext.content.slice(0, 3000) + (_modalDocContext.content.length > 3000 ? '\n\n...(truncated for display)' : '');
+    modal.classList.add('open');
+  }
+
+  // Show the selection pill
+  const pill = document.getElementById('modal-qa-pill');
+  const pillText = document.getElementById('modal-qa-pill-text');
+  const sel = _modalDocContext.selection || '';
+  if (sel) {
+    pillText.textContent = sel.slice(0, 80) + (sel.length > 80 ? '...' : '');
+    pill.style.display = 'flex';
+  }
+
   const input = document.getElementById('modal-qa-input');
   input.value = '';
-  input.placeholder = 'Ask about: "' + _modalDocContext.selection.slice(0, 60) + '..."';
+  input.placeholder = 'What do you want to know about this?';
   input.focus();
 }
 
+function clearQaSelection() {
+  _modalDocContext.selection = '';
+  document.getElementById('modal-qa-pill').style.display = 'none';
+  document.getElementById('modal-qa-input').placeholder = 'Ask about this document (or select text first)...';
+}
+
 async function modalAskSubmit() {
   const input = document.getElementById('modal-qa-input');
   const question = input.value.trim();
   if (!question) return;
-  if (!_modalDocContext.content) return;
+
+  // Capture content from modal body if not already set
+  if (!_modalDocContext.content) {
+    const body = document.getElementById('modal-body');
+    if (body) {
+      _modalDocContext.content = body.textContent || body.innerText || '';
+      _modalDocContext.title = document.getElementById('modal-title')?.textContent || '';
+    }
+  }
+  if (!_modalDocContext.content) {
+    showToast('cmd-toast', 'No document content to ask about', false);
+    return;
+  }
 
   const thread = document.getElementById('modal-qa-thread');
   const btn = document.getElementById('modal-qa-btn');
@@ -2131,6 +2292,8 @@ async function modalAskSubmit() {
   }
 
   _modalDocContext.selection = ''; // Clear selection after asking
+  document.getElementById('modal-qa-pill').style.display = 'none';
+  document.getElementById('modal-qa-input').placeholder = 'Ask another question...';
   btn.disabled = false;
   thread.scrollTop = thread.scrollHeight;
   input.focus();

package/dashboard.js

@@ -442,6 +442,20 @@ function getWorkItems() {
   return allItems;
 }
 
+function getMcpServers() {
+  try {
+    const home = process.env.USERPROFILE || process.env.HOME || '';
+    const claudeJsonPath = path.join(home, '.claude.json');
+    const data = JSON.parse(safeRead(claudeJsonPath) || '{}');
+    const servers = data.mcpServers || {};
+    return Object.entries(servers).map(([name, cfg]) => ({
+      name,
+      command: cfg.command || '',
+      args: (cfg.args || []).slice(-1)[0] || '',
+    }));
+  } catch { return []; }
+}
+
 function getStatus() {
   const prdInfo = getPrdInfo();
   return {
@@ -458,6 +472,7 @@ function getStatus() {
     metrics: getMetrics(),
     workItems: getWorkItems(),
     skills: getSkills(),
+    mcpServers: getMcpServers(),
     projects: PROJECTS.map(p => ({ name: p.name, path: p.localPath, description: p.description || '' })),
     timestamp: new Date().toISOString(),
   };
@@ -758,7 +773,7 @@ const server = http.createServer(async (req, res) => {
         priority: body.priority || 'high', description: body.description || '',
         status: 'pending', created: new Date().toISOString(), createdBy: 'dashboard',
         chain: 'plan-to-prd',
-        branchStrategy: body.branch_strategy || 'shared-branch',
+        branchStrategy: body.branch_strategy || 'parallel',
       };
       if (body.project) item.project = body.project;
       if (body.agent) item.agent = body.agent;
@@ -1095,7 +1110,12 @@ ${body.question}
 
 ## Instructions
 
-Answer concisely and directly. Reference specific parts of the document. If the answer isn't in the document, say so. Use markdown formatting.`;
+Answer concisely and directly. Follow these rules:
+1. **Cite sources**: When the document includes file paths, line numbers, PR URLs, or code references — include them in your answer. Format: \`(source: path/to/file.ts:42)\`
+2. **Quote the document**: Reference the exact text that supports your answer.
+3. **Flag missing sources**: If the document makes a claim without a source reference (no file path, no PR link, no line number), say: "Note: this claim has no source reference in the document — verify independently."
+4. **Be honest**: If the document doesn't contain the answer, say so clearly. Don't speculate beyond what's written.
+5. Use markdown formatting.`;
 
       const sysPrompt = 'You are a concise technical assistant. Answer based on the document provided. No preamble.';
 
@@ -1189,6 +1209,45 @@ Answer concisely and directly. Reference specific parts of the document. If the
     } catch (e) { return jsonReply(res, 400, { error: e.message }); }
   }
 
+  // POST /api/inbox/promote-kb — promote an inbox item to the knowledge base
+  if (req.method === 'POST' && req.url === '/api/inbox/promote-kb') {
+    try {
+      const body = await readBody(req);
+      const { name, category } = body;
+      if (!name) return jsonReply(res, 400, { error: 'name required' });
+      const validCategories = ['architecture', 'conventions', 'project-notes', 'build-reports', 'reviews'];
+      if (!category || !validCategories.includes(category)) {
+        return jsonReply(res, 400, { error: 'category required: ' + validCategories.join(', ') });
+      }
+
+      const inboxPath = path.join(SQUAD_DIR, 'notes', 'inbox', name);
+      const content = safeRead(inboxPath);
+      if (!content) return jsonReply(res, 404, { error: 'inbox item not found' });
+
+      // Add frontmatter if not present
+      const today = new Date().toISOString().slice(0, 10);
+      let kbContent = content;
+      if (!content.startsWith('---')) {
+        const titleMatch = content.match(/^#+ (.+)$/m);
+        const title = titleMatch ? titleMatch[1].trim() : name.replace('.md', '');
+        kbContent = `---\ntitle: ${title}\ncategory: ${category}\ndate: ${today}\nsource: inbox/${name}\n---\n\n${content}`;
+      }
+
+      // Write to knowledge base
+      const kbDir = path.join(SQUAD_DIR, 'knowledge', category);
+      if (!fs.existsSync(kbDir)) fs.mkdirSync(kbDir, { recursive: true });
+      const kbFile = path.join(kbDir, name);
+      safeWrite(kbFile, kbContent);
+
+      // Move inbox item to archive
+      const archiveDir = path.join(SQUAD_DIR, 'notes', 'archive');
+      if (!fs.existsSync(archiveDir)) fs.mkdirSync(archiveDir, { recursive: true });
+      try { fs.renameSync(inboxPath, path.join(archiveDir, `kb-${category}-${name}`)); } catch {}
+
+      return jsonReply(res, 200, { ok: true, category, file: name });
+    } catch (e) { return jsonReply(res, 400, { error: e.message }); }
+  }
+
   // POST /api/inbox/open — open inbox file in Windows explorer
   if (req.method === 'POST' && req.url === '/api/inbox/open') {
     try {
@@ -1335,6 +1394,54 @@ server.listen(PORT, '127.0.0.1', () => {
     console.log(`  Could not auto-open browser: ${e.message}`);
     console.log(`  Please open http://localhost:${PORT} manually.`);
   }
+
+  // ─── Engine Watchdog ─────────────────────────────────────────────────────
+  // Every 30s, check if engine PID is alive. If dead but control.json says
+  // running, auto-restart it. Prevents silent engine death.
+  const { execSync, spawn: cpSpawn } = require('child_process');
+  setInterval(() => {
+    try {
+      const control = getEngineState();
+      if (control.state !== 'running' || !control.pid) return;
+
+      // Check if PID is alive
+      let alive = false;
+      try {
+        if (process.platform === 'win32') {
+          const out = execSync(`tasklist /FI "PID eq ${control.pid}" /NH`, { encoding: 'utf8', timeout: 3000 });
+          alive = out.includes(String(control.pid));
+        } else {
+          process.kill(control.pid, 0); // signal 0 = check existence
+          alive = true;
+        }
+      } catch { alive = false; }
+
+      if (!alive) {
+        console.log(`[watchdog] Engine PID ${control.pid} is dead — auto-restarting...`);
+
+        // Set state to stopped first
+        const controlPath = path.join(SQUAD_DIR, 'engine', 'control.json');
+        safeWrite(controlPath, { state: 'stopped', pid: null, crashed_at: new Date().toISOString() });
+
+        // Restart engine
+        const childEnv = { ...process.env };
+        for (const key of Object.keys(childEnv)) {
+          if (key === 'CLAUDECODE' || key.startsWith('CLAUDE_CODE') || key.startsWith('CLAUDECODE_')) delete childEnv[key];
+        }
+        const engineProc = cpSpawn(process.execPath, [path.join(SQUAD_DIR, 'engine.js'), 'start'], {
+          cwd: SQUAD_DIR,
+          stdio: 'ignore',
+          detached: true,
+          env: childEnv,
+        });
+        engineProc.unref();
+        console.log(`[watchdog] Engine restarted (new PID: ${engineProc.pid})`);
+      }
+    } catch (e) {
+      console.error(`[watchdog] Error: ${e.message}`);
+    }
+  }, 30000);
+  console.log(`  Engine watchdog: active (checks every 30s)`);
 });
 
 server.on('error', e => {

package/docs/blog-first-successful-dispatch.md

@@ -87,7 +87,7 @@ When the engine restarts, the in-memory `activeProcesses` Map is lost. Active di
 
 **Dispatch 1773292681199** — Dallas, central work item, auto-route:
 
-1. Engine spawns `node spawn-agent.js prompt.md sysprompt.md --output-format stream-json --verbose --permission-mode bypassPermissions --mcp-config mcp-servers.json`
+1. Engine spawns `node spawn-agent.js prompt.md sysprompt.md --output-format stream-json --verbose --permission-mode bypassPermissions`
 2. spawn-agent.js resolves `cli.js`, spawns `node cli.js -p --system-prompt <content> ...`
 3. Prompt piped via stdin — no shell interpretation
 4. MCP servers connect (azure-ado, azure-kusto, mobile, DevBox)

package/engine.js

@@ -212,39 +212,6 @@ function getInboxFiles() {
   try { return fs.readdirSync(INBOX_DIR).filter(f => f.endsWith('.md')); } catch { return []; }
 }
 
-// ─── MCP Server Sync ─────────────────────────────────────────────────────────
-
-const MCP_SERVERS_PATH = path.join(SQUAD_DIR, 'mcp-servers.json');
-
-function syncMcpServers() {
-  // Sync MCP servers from ~/.claude.json into squad's mcp-servers.json
-  const home = process.env.USERPROFILE || process.env.HOME || '';
-  const claudeJsonPath = path.join(home, '.claude.json');
-
-  if (!fs.existsSync(claudeJsonPath)) {
-    console.log('  ~/.claude.json not found — skipping MCP sync');
-    return false;
-  }
-
-  try {
-    const claudeJson = JSON.parse(fs.readFileSync(claudeJsonPath, 'utf8'));
-    const servers = claudeJson.mcpServers;
-    if (!servers || Object.keys(servers).length === 0) {
-      console.log('  No MCP servers found in ~/.claude.json');
-      return false;
-    }
-
-    safeWrite(MCP_SERVERS_PATH, { mcpServers: servers });
-    const names = Object.keys(servers);
-    console.log(`  MCP servers synced (${names.length}): ${names.join(', ')}`);
-    log('info', `Synced ${names.length} MCP servers from ~/.claude.json: ${names.join(', ')}`);
-    return true;
-  } catch (e) {
-    console.log(`  MCP sync failed: ${e.message}`);
-    return false;
-  }
-}
-
 // ─── Skills ──────────────────────────────────────────────────────────────────
 
 const SKILLS_DIR = path.join(SQUAD_DIR, 'skills');
@@ -313,6 +280,32 @@ function getSkillIndex() {
   } catch { return ''; }
 }
 
+function getKnowledgeBaseIndex() {
+  try {
+    const kbDir = path.join(SQUAD_DIR, 'knowledge');
+    if (!fs.existsSync(kbDir)) return '';
+    const categories = ['architecture', 'conventions', 'project-notes', 'build-reports', 'reviews'];
+    let entries = [];
+    for (const cat of categories) {
+      const catDir = path.join(kbDir, cat);
+      const files = safeReadDir(catDir).filter(f => f.endsWith('.md'));
+      for (const f of files) {
+        const content = safeRead(path.join(catDir, f)) || '';
+        const titleMatch = content.match(/^#\s+(.+)/m);
+        const title = titleMatch ? titleMatch[1].trim() : f.replace(/\.md$/, '');
+        entries.push({ cat, file: f, title });
+      }
+    }
+    if (entries.length === 0) return '';
+    let index = '## Knowledge Base Reference\n\n';
+    index += 'Deep-reference docs from past work. Read the file if you need detail.\n\n';
+    for (const e of entries) {
+      index += `- \`knowledge/${e.cat}/${e.file}\` — ${e.title}\n`;
+    }
+    return index + '\n';
+  } catch { return ''; }
+}
+
 function getPrs(project) {
   if (project) {
     const prPath = project.workSources?.pullRequests?.path;
@@ -412,7 +405,8 @@ function renderPlaybook(type, vars) {
   content += `- What you learned about the codebase\n`;
   content += `- Patterns you discovered or established\n`;
   content += `- Gotchas or warnings for future agents\n`;
-  content += `- Conventions to follow\n\n`;
+  content += `- Conventions to follow\n`;
+  content += `- **SOURCE REFERENCES for every finding** — file paths with line numbers, PR URLs, API endpoints, config keys. Format: \`(source: path/to/file.ts:42)\` or \`(source: PR-12345)\`. Without references, findings cannot be verified.\n\n`;
   content += `### Skill Extraction (IMPORTANT)\n\n`;
   content += `If during this task you discovered a **repeatable workflow** — a multi-step procedure, workaround, build process, or pattern that other agents should follow in similar situations — output it as a fenced skill block. The engine will automatically extract it.\n\n`;
   content += `Format your skill as a fenced code block with the \`skill\` language tag:\n\n`;
@@ -574,6 +568,12 @@ function buildAgentContext(agentId, config, project) {
     context += skillIndex + '\n';
   }
 
+  // Knowledge base index (paths + titles only — agents can Read if needed)
+  const kbIndex = getKnowledgeBaseIndex();
+  if (kbIndex) {
+    context += kbIndex + '\n';
+  }
+
   // Team notes (the big one — can be 50KB)
   if (notes) {
     context += `## Team Notes (MUST READ)\n\n${notes}\n\n`;
@@ -669,11 +669,8 @@ function spawnAgent(dispatchItem, config) {
     args.push('--allowedTools', claudeConfig.allowedTools);
   }
 
-  // MCP servers — pass config file if it exists
-  const mcpConfigPath = claudeConfig.mcpConfig || path.join(SQUAD_DIR, 'mcp-servers.json');
-  if (fs.existsSync(mcpConfigPath)) {
-    args.push('--mcp-config', mcpConfigPath);
-  }
+  // MCP servers: agents inherit from ~/.claude.json directly as Claude Code processes.
+  // No --mcp-config needed — avoids redundant config and ensures agents always have latest servers.
 
   log('info', `Spawning agent: ${agentId} (${id}) in ${cwd}`);
   log('info', `Task type: ${type} | Branch: ${branchName || 'none'}`);
@@ -3980,7 +3977,7 @@ async function tickInner() {
   // 2. Consolidate inbox
   consolidateInbox(config);
 
-  // 2.5. Periodic cleanup (every 10 ticks = ~5 minutes)
+  // 2.5. Periodic cleanup + MCP sync (every 10 ticks = ~5 minutes)
   if (tickCount % 10 === 0) {
     runCleanup(config);
   }
@@ -4065,9 +4062,6 @@ const commands = {
     const config = getConfig();
     const interval = config.engine?.tickInterval || 60000;
 
-    // Sync MCP servers from Claude Code
-    syncMcpServers();
-
     // Validate project paths
     const projects = getProjects(config);
     for (const p of projects) {
@@ -4542,7 +4536,7 @@ const commands = {
   },
 
   'mcp-sync'() {
-    syncMcpServers();
+    console.log('MCP servers are read directly from ~/.claude.json — no sync needed.');
   },
 
   discover() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/squad",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Multi-agent AI dev team that runs from ~/.squad/ — five autonomous agents share a single engine, dashboard, and knowledge base",
   "bin": {
     "squad": "bin/squad.js"

package/playbooks/explore.md

@@ -38,6 +38,7 @@ Write your findings to `{{team_root}}/notes/inbox/{{agent_id}}-explore-{{task_id
 - **Dependencies**: what depends on what
 - **Gaps**: anything missing, broken, or unclear
 - **Recommendations**: suggestions for the team
+- **Source References**: for EVERY finding, include the source — file paths, line numbers, PR URLs, API endpoints, config keys. Format: `(source: path/to/file.ts:42)` or `(source: PR-12345)`. This is critical — other agents and humans need to verify your findings.
 
 ### 5. Create Deliverable (if the task asks for one)
 If the task asks you to write a design doc, architecture doc, or any durable artifact: