@yemi33/minions 0.1.1777 → 0.1.1779

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.1.1779 (2026-05-07)
+
+### Features
+- fix cc doc chat resume continuity (#2184)
+- consolidate CC dispatch action type (#2183)
+- harden dashboard state mutations (#2175)
+
 ## 0.1.1777 (2026-05-07)
 
 ### Fixes

package/dashboard/js/command-center.js

@@ -103,15 +103,15 @@ function _ccActiveTab() {
 
 // Build a plain-text transcript from a tab's stored messages — sent on every
 // initial request so the server can carry it over if the session has to reset
-// (runtime switch, system-prompt change). Last 20 user/assistant turns only;
-// system/action rows are skipped because they're UI artifacts, not dialog.
+// (runtime switch, system-prompt change) or if the previous turn has local
+// action results the runtime session never saw.
 var CC_TRANSCRIPT_MAX_TURNS = 20;
 function _ccBuildTranscript(tab) {
   if (!tab || !Array.isArray(tab.messages) || tab.messages.length === 0) return [];
   var out = [];
   for (var i = 0; i < tab.messages.length; i++) {
     var m = tab.messages[i];
-    if (!m || (m.role !== 'user' && m.role !== 'assistant')) continue;
+    if (!m || (m.role !== 'user' && m.role !== 'assistant' && m.role !== 'action' && m.role !== 'system')) continue;
     var html = typeof m.html === 'string' ? m.html : '';
     var tmp = document.createElement('div');
     tmp.innerHTML = html;
@@ -141,6 +141,23 @@ function _ccMergeStreamText(prev, incoming) {
   return current + '\n\n' + next;
 }
 
+var CC_DISPATCH_ACTION_ALIASES = ['fix', 'implement', 'explore', 'review', 'test'];
+function _ccNormalizeDispatchAction(action) {
+  if (!action || typeof action !== 'object' || typeof action.type !== 'string') return action;
+  var type = action.type.trim().toLowerCase();
+  if (type === 'dispatch') {
+    if (action.type === 'dispatch') return action;
+    var dispatchAction = Object.assign({}, action);
+    dispatchAction.type = 'dispatch';
+    return dispatchAction;
+  }
+  if (CC_DISPATCH_ACTION_ALIASES.indexOf(type) < 0) return action;
+  var normalized = Object.assign({}, action);
+  normalized.type = 'dispatch';
+  if (!normalized.workType) normalized.workType = type;
+  return normalized;
+}
+
 async function _ccDashboardHealth() {
   var controller = new AbortController();
   var timer = setTimeout(function() { controller.abort(); }, 3000);
@@ -745,7 +762,7 @@ async function _ccDoSend(message, skipUserMsg, forceTabId) {
       if (!isReconnect && res.status === 429 && (!activeTab._429retries || activeTab._429retries < 3)) {
         activeTab._429retries = (activeTab._429retries || 0) + 1;
         await new Promise(function(r) { setTimeout(r, 1500); });
-        return await _ccConsumeStream({ message: message, tabId: activeTabId, sessionId: activeTab.sessionId || null }, false);
+        return await _ccConsumeStream({ message: message, tabId: activeTabId, sessionId: activeTab.sessionId || null, transcript: _ccBuildTranscript(activeTab) }, false);
       }
       activeTab._429retries = 0;
       var errText = await res.text();
@@ -994,6 +1011,7 @@ function _tagServerExecuted(actions, actionResults) {
 }
 
 async function ccExecuteAction(action, targetTabId) {
+  action = _ccNormalizeDispatchAction(action);
   var status = document.createElement('div');
   status.style.cssText = 'padding:4px 10px;border-radius:4px;font-size:10px;align-self:flex-start;border:1px dashed var(--border);color:var(--muted)';
 
@@ -1010,7 +1028,7 @@ async function ccExecuteAction(action, targetTabId) {
       status.style.color = action._serverDuplicate ? 'var(--orange)' : 'var(--green)';
     }
     ccAddMessage('action', status.outerHTML, false, targetTabId);
-    if (['dispatch','fix','implement','explore','review','test','create-meeting'].includes(action.type)) wakeEngine();
+    if (['dispatch','create-meeting'].includes(action.type)) wakeEngine();
     refresh();
     return;
   }
@@ -1023,7 +1041,7 @@ async function ccExecuteAction(action, targetTabId) {
       case 'explore':
       case 'review':
       case 'test': {
-        var workType = action.workType || (action.type !== 'dispatch' ? action.type : 'implement');
+        var workType = action.workType || 'implement';
         // Forward both singular (`agent`) and plural (`agents`) hint shapes —
         // the LLM emits either depending on phrasing ("assign to lambert" vs
         // "dispatch to dallas, ralph"). The server-side handler promotes a

package/dashboard/js/modal-qa.js

@@ -28,6 +28,7 @@ let _qaAbortController = null;
 let _qaQueue = []; // queued messages while processing
 const QA_QUEUE_CAP = 10; // max queued messages
 const QA_STREAM_STALL_MS = 6 * 60 * 1000; // allow the full doc-chat timeout before treating heartbeat-only streams as stalled
+const QA_TRANSCRIPT_MAX_TURNS = 20;
 let _qaSessionKey = ''; // key for current conversation (title or filePath)
 
 const QA_STICKY_BOTTOM_PX = 80;
@@ -97,6 +98,40 @@ function _qaCloneQueue(queue) {
   return Array.isArray(queue) ? queue.map(item => ({ ...item })) : [];
 }
 
+function _qaBuildTranscript(history, currentMessage) {
+  if (!Array.isArray(history) || history.length === 0) return [];
+  const current = typeof currentMessage === 'string' ? currentMessage.trim() : '';
+  const out = [];
+  for (let i = 0; i < history.length; i++) {
+    const m = history[i];
+    if (!m || (m.role !== 'user' && m.role !== 'assistant' && m.role !== 'action' && m.role !== 'system')) continue;
+    const text = typeof m.text === 'string' ? m.text.trim() : '';
+    if (!text) continue;
+    if (current && m.role === 'user' && text === current && i === history.length - 1) continue;
+    out.push({ role: m.role, text });
+  }
+  return out.slice(-QA_TRANSCRIPT_MAX_TURNS);
+}
+
+function _qaSummarizeActionContext(actions, actionResults) {
+  if (!Array.isArray(actions) || actions.length === 0) return '';
+  const lines = [];
+  for (let i = 0; i < actions.length; i++) {
+    const action = actions[i] || {};
+    const result = Array.isArray(actionResults) ? actionResults[i] : null;
+    const type = action.type || 'action';
+    const subject = result?.id || action.id || action.title || action.file || action.target || action.endpoint || '';
+    if (result?.error) {
+      lines.push(`${type}${subject ? ' ' + subject : ''} failed: ${result.error}`);
+    } else if (result?.ok || action._serverExecuted) {
+      lines.push(`${type}${subject ? ' ' + subject : ''} completed${result?.duplicate ? ' (duplicate)' : ''}${result?.warning ? ': ' + result.warning : ''}`);
+    } else {
+      lines.push(`${type}${subject ? ' ' + subject : ''} emitted`);
+    }
+  }
+  return lines.join('\n');
+}
+
 function _qaGetRuntime(key) {
   if (!key) return null;
   let runtime = _qaRuntime.get(key);
@@ -609,6 +644,7 @@ async function _processQaMessage(message, selection, opts) {
         filePath: capturedFilePath || null,
         model: window._lastStatus?.autoMode?.ccModel || undefined,
         contentHash: capturedDocContext.content ? (function(s) { const m = Math.floor(s.length / 2); return s.length + ':' + s.charCodeAt(0) + ':' + s.charCodeAt(m) + ':' + s.charCodeAt(s.length - 1); })(capturedDocContext.content) : undefined,
+        transcript: _qaBuildTranscript(runtime.history, message),
       }),
     });
     let sessionDocContext = { ...capturedDocContext };
@@ -692,20 +728,21 @@ async function _processQaMessage(message, selection, opts) {
           if (rawErrorHtml) _qaInsertBeforeQueued(tmp, rawErrorHtml);
         });
 
-        runtime.history.push({ role: 'user', text: message });
-        runtime.history.push({ role: 'assistant', text: finalText || '' });
-        if (_qaIsActiveSession(sessionKey)) _qaHistory = runtime.history.slice();
-
         _qaNotifySidebar(capturedFilePath);
+        runtime.history.push({ role: 'user', text: message });
+        runtime.history.push({ role: 'assistant', text: bodyText || finalText || '' });
         if (evt.actions && evt.actions.length > 0) {
           if (evt.actionResults && typeof _tagServerExecuted === 'function') _tagServerExecuted(evt.actions, evt.actionResults);
           for (const action of evt.actions) await ccExecuteAction(action);
+          const actionContext = _qaSummarizeActionContext(evt.actions, evt.actionResults);
+          if (actionContext) runtime.history.push({ role: 'action', text: actionContext });
         } else if (evt.actionParseError) {
           const warning = '<div class="modal-qa-a" style="color:var(--red)">Actions block emitted but JSON could not be parsed — no actions were executed. Resend or rephrase. (' + escHtml(String(evt.actionParseError).slice(0, 200)) + ')</div>';
           updatedThreadHtml = _qaMutateThreadHtml(sessionKey, tmp => {
             _qaInsertBeforeQueued(tmp, warning);
           });
         }
+        if (_qaIsActiveSession(sessionKey)) _qaHistory = runtime.history.slice();
 
         if (evt.edited && evt.content) {
           const display = evt.content.replace(/^---[\s\S]*?---\n*/m, '');

package/dashboard.js

@@ -34,7 +34,7 @@ const projectDiscovery = require('./engine/project-discovery');
 const features = require('./engine/features');
 const os = require('os');
 
-const { safeRead, safeReadDir, safeWrite, safeJson, safeJsonObj, safeJsonArr, safeJsonNoRestore, safeUnlink, mutateJsonFileLocked, mutateControl, mutateCooldowns, mutateWorkItems, getProjects: _getProjects, DONE_STATUSES, WI_STATUS, WORK_TYPE, reopenWorkItem } = shared;
+const { safeRead, safeReadDir, safeWrite, safeJson, safeJsonObj, safeJsonArr, safeJsonNoRestore, safeUnlink, mutateJsonFileLocked, mutateTextFileLocked, mutateControl, mutateCooldowns, mutateWorkItems, getProjects: _getProjects, DONE_STATUSES, WI_STATUS, WORK_TYPE, reopenWorkItem } = shared;
 const { getAgents, getAgentDetail, getPrdInfo, getWorkItems, getDispatchQueue,
   getSkills, getInbox, getNotesWithMeta, getPullRequests,
   getEngineLog, getMetrics, getKnowledgeBaseEntries, timeSince,
@@ -61,6 +61,10 @@ const { getAgents, getAgentDetail, getPrdInfo, getWorkItems, getDispatchQueue,
 const PORT = parseInt(process.env.PORT || process.argv[2]) || 7331;
 let CONFIG = queries.getConfig();
 let PROJECTS = _getProjects(CONFIG);
+const CONFIG_PATH = path.join(MINIONS_DIR, 'config.json');
+const PINNED_PATH = path.join(MINIONS_DIR, 'pinned.md');
+const PINNED_DEFAULT_CONTENT = '# Pinned Context\n\nCritical notes visible to all agents.';
+const KB_PINS_PATH = shared.PINNED_ITEMS_PATH;
 const DASHBOARD_BROWSER_PRESENCE_PATH = path.join(ENGINE_DIR, 'dashboard-browser.json');
 const DASHBOARD_BROWSER_PRESENCE_MAX_AGE_MS = 45000;
 
@@ -93,6 +97,89 @@ function reloadConfig() {
 }
 ensureConfiguredProjectStateFiles();
 
+function mutateDashboardConfig(mutator) {
+  return mutateJsonFileLocked(CONFIG_PATH, (config) => {
+    if (!config || typeof config !== 'object' || Array.isArray(config)) config = {};
+    const next = mutator(config);
+    return next === undefined ? config : next;
+  }, { defaultValue: { projects: [], agents: {}, engine: {} }, skipWriteIfUnchanged: true });
+}
+
+function mergeSettingsConfigUpdate(current, candidate, body, patch = {}) {
+  if (!current || typeof current !== 'object' || Array.isArray(current)) current = {};
+  if (body.engine) {
+    if (!current.engine || typeof current.engine !== 'object' || Array.isArray(current.engine)) current.engine = {};
+    const enginePatch = patch.engine || {};
+    for (const key of enginePatch.delete || []) delete current.engine[key];
+    for (const [key, value] of Object.entries(enginePatch.set || {})) current.engine[key] = value;
+  }
+  if (body.claude) {
+    if (candidate.claude) current.claude = candidate.claude;
+    else delete current.claude;
+  }
+  if (body.agents) {
+    if (!current.agents || typeof current.agents !== 'object' || Array.isArray(current.agents)) current.agents = {};
+    for (const id of Object.keys(body.agents)) {
+      if (candidate.agents && candidate.agents[id]) current.agents[id] = candidate.agents[id];
+    }
+  }
+  if (body.teams) {
+    if (candidate.teams) current.teams = candidate.teams;
+    else delete current.teams;
+  }
+  if (body.projects && Array.isArray(body.projects)) {
+    if (!Array.isArray(current.projects)) current.projects = [];
+    for (const update of body.projects) {
+      const candidateProject = (candidate.projects || []).find(p => p.name === update.name);
+      const currentProject = current.projects.find(p => p.name === update.name);
+      if (!candidateProject || !currentProject) continue;
+      currentProject.workSources = candidateProject.workSources;
+    }
+  }
+  shared.pruneDefaultClaudeConfig(current);
+  return current;
+}
+
+function addPinnedEntryLocked({ title, content, level }, now = new Date()) {
+  const levelTag = level === 'critical' ? '🔴 ' : level === 'warning' ? '🟡 ' : '';
+  const entry = '\n\n### ' + levelTag + title + '\n\n' + content + '\n\n*Pinned by human on ' + now.toISOString().slice(0, 10) + '*';
+  return mutateTextFileLocked(PINNED_PATH, existing => (existing || PINNED_DEFAULT_CONTENT) + entry, { defaultValue: PINNED_DEFAULT_CONTENT });
+}
+
+function removePinnedEntryLocked(title) {
+  let missing = false;
+  mutateTextFileLocked(PINNED_PATH, content => {
+    if (!content) {
+      missing = true;
+      return content;
+    }
+    const regex = new RegExp('\\n\\n###\\s*(?:🔴\\s*|🟡\\s*)?' + title.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '\\n[\\s\\S]*?(?=\\n\\n###|$)', 'i');
+    return content.replace(regex, '');
+  }, { defaultValue: '', skipWriteIfUnchanged: true });
+  return !missing;
+}
+
+function setKbPinsLocked(pins) {
+  return mutateJsonFileLocked(KB_PINS_PATH, () => pins, { defaultValue: [], skipWriteIfUnchanged: true });
+}
+
+function toggleKbPinLocked(key) {
+  let pinned = false;
+  mutateJsonFileLocked(KB_PINS_PATH, pins => {
+    if (!Array.isArray(pins)) pins = [];
+    const idx = pins.indexOf(key);
+    if (idx >= 0) {
+      pins.splice(idx, 1);
+      pinned = false;
+    } else {
+      pins.unshift(key);
+      pinned = true;
+    }
+    return pins;
+  }, { defaultValue: [], skipWriteIfUnchanged: true });
+  return pinned;
+}
+
 function getWorkItemIdFromPrLinkContext(context, workItemId) {
   if (typeof workItemId === 'string' && workItemId.trim()) return workItemId.trim();
   if (!context) return null;
@@ -995,7 +1082,7 @@ function getStatus() {
         });
       })(),
       pipelines: (() => { try { const pl = require('./engine/pipeline'); return pl.getPipelines().map(p => ({ ...p, runs: (pl.getPipelineRuns()[p.id] || []).slice(-5) })); } catch { return []; } })(),
-      pinned: (() => { try { return parsePinnedEntries(safeRead(path.join(MINIONS_DIR, 'pinned.md'))); } catch { return []; } })(),
+      pinned: (() => { try { return parsePinnedEntries(safeRead(PINNED_PATH)); } catch { return []; } })(),
       projects: PROJECTS.map(p => ({ name: p.name, path: p.localPath, description: p.description || '' })),
       autoMode: {
         approvePlans: !!CONFIG.engine?.autoApprovePlans,
@@ -1279,10 +1366,36 @@ function _readCcTabSessions({ prune = true } = {}) {
 
 const CC_CARRYOVER_MAX_TURNS = 20;
 const CC_CARRYOVER_PER_MSG_CHARS = 2000;
+const CC_TRANSCRIPT_DIALOG_ROLES = new Set(['user', 'assistant']);
+const CC_TRANSCRIPT_CONTEXT_ROLES = new Set(['user', 'assistant', 'action', 'system']);
 
-function _buildTranscriptCarryover(transcript, { previousRuntime, currentMessage } = {}) {
+function _normalizeTranscriptRole(role) {
+  const value = String(role || '').toLowerCase();
+  return CC_TRANSCRIPT_CONTEXT_ROLES.has(value) ? value : null;
+}
+
+function _transcriptHasCarryoverContext(transcript, { outOfBandOnly = false, currentMessage } = {}) {
+  if (!Array.isArray(transcript)) return false;
+  const current = typeof currentMessage === 'string' ? currentMessage.trim() : '';
+  return transcript.some(m => {
+    const role = _normalizeTranscriptRole(m?.role);
+    if (!role || typeof m.text !== 'string' || !m.text.trim()) return false;
+    if (outOfBandOnly && CC_TRANSCRIPT_DIALOG_ROLES.has(role)) return false;
+    return !(current && role === 'user' && m.text.trim() === current);
+  });
+}
+
+function _buildTranscriptCarryover(transcript, { previousRuntime, currentMessage, outOfBandOnly = false } = {}) {
   if (!Array.isArray(transcript) || transcript.length === 0) return '';
-  let filtered = transcript.filter(m => m && (m.role === 'user' || m.role === 'assistant') && typeof m.text === 'string' && m.text.trim());
+  let filtered = transcript
+    .map(m => {
+      const role = _normalizeTranscriptRole(m?.role);
+      return role && typeof m?.text === 'string' && m.text.trim()
+        ? { role, text: m.text }
+        : null;
+    })
+    .filter(Boolean);
+  if (outOfBandOnly) filtered = filtered.filter(m => !CC_TRANSCRIPT_DIALOG_ROLES.has(m.role));
   const current = typeof currentMessage === 'string' ? currentMessage.trim() : '';
   if (current && filtered.length > 0) {
     const last = filtered[filtered.length - 1];
@@ -1291,11 +1404,19 @@ function _buildTranscriptCarryover(transcript, { previousRuntime, currentMessage
   if (filtered.length === 0) return '';
   const recent = filtered.slice(-CC_CARRYOVER_MAX_TURNS);
   const truncated = filtered.length > recent.length;
-  const header = previousRuntime
-    ? `--- Previous conversation (carried over from ${previousRuntime} session) ---`
-    : `--- Previous conversation (carried over) ---`;
+  const header = outOfBandOnly
+    ? `--- Previous out-of-band UI/server events (carried over) ---`
+    : previousRuntime
+      ? `--- Previous conversation (carried over from ${previousRuntime} session) ---`
+      : `--- Previous conversation (carried over) ---`;
   const lines = recent.map(m => {
-    const who = m.role === 'user' ? 'User' : 'Assistant';
+    const who = m.role === 'user'
+      ? 'User'
+      : m.role === 'assistant'
+        ? 'Assistant'
+        : m.role === 'action'
+          ? 'Action result'
+          : 'System note';
     let text = m.text.trim();
     if (text.length > CC_CARRYOVER_PER_MSG_CHARS) text = text.slice(0, CC_CARRYOVER_PER_MSG_CHARS) + '… [truncated]';
     return `${who}: ${text}`;
@@ -1664,6 +1785,19 @@ function _extractActionsJson(segment) {
   return null;
 }
 
+const CC_DISPATCH_ACTION_ALIASES = new Set(['fix', 'implement', 'explore', 'review', 'test']);
+
+function normalizeCCAction(action) {
+  if (!action || typeof action !== 'object') return action;
+  if (typeof action.type !== 'string') return action;
+  const type = action.type.trim().toLowerCase();
+  if (type === 'dispatch') {
+    return action.type === 'dispatch' ? action : { ...action, type: 'dispatch' };
+  }
+  if (!CC_DISPATCH_ACTION_ALIASES.has(type)) return action;
+  return { ...action, type: 'dispatch', workType: action.workType || type };
+}
+
 function parseCCActions(text) {
   let actions = [];
   let displayText = stripCCActionsForDisplay(text);
@@ -1704,6 +1838,7 @@ function parseCCActions(text) {
       parseError = null; // legacy fallback recovered actions
     }
   }
+  actions = actions.map(normalizeCCAction);
   const result = { text: displayText, actions };
   if (parseError && actions.length === 0) {
     result._actionParseError = parseError;
@@ -2099,7 +2234,8 @@ function _ccValidateAction(action) {
 
 async function executeCCActions(actions) {
   const results = [];
-  for (const action of actions) {
+  for (const rawAction of actions) {
+    const action = normalizeCCAction(rawAction);
     const validationError = _ccValidateAction(action);
     if (validationError) {
       results.push({ type: action?.type || 'unknown', error: validationError });
@@ -2108,7 +2244,7 @@ async function executeCCActions(actions) {
     try {
       switch (action.type) {
         case 'dispatch': case 'fix': case 'implement': case 'explore': case 'review': case 'test': {
-          const workType = routing.normalizeWorkType(action.workType || (action.type !== 'dispatch' ? action.type : WORK_TYPE.IMPLEMENT), WORK_TYPE.IMPLEMENT);
+          const workType = routing.normalizeWorkType(action.workType || WORK_TYPE.IMPLEMENT, WORK_TYPE.IMPLEMENT);
           const id = 'W-' + shared.uid();
           const project = action.project || '';
           const prRef = getWorkItemPrRef(action);
@@ -2574,12 +2710,14 @@ async function ccCall(message, { store = 'cc', sessionKey, extraContext, label =
   const existing = resolveSession(store, sessionKey);
   let sessionId = existing ? existing.sessionId : null;
   const resumeNeedsCarryover = !!sessionId && _ccRuntimeNeedsResumeCarryover(shared.resolveCcCli(CONFIG.engine));
+  const resumeHasOutOfBandCarryover = !!sessionId && _transcriptHasCarryoverContext(transcript, { outOfBandOnly: true, currentMessage: message });
+  const freshNeedsCarryover = _transcriptHasCarryoverContext(transcript, { currentMessage: message });
 
-  function buildPrompt({ includePreamble = true, includeCarryover = false } = {}) {
+  function buildPrompt({ includePreamble = true, includeCarryover = false, outOfBandOnly = false } = {}) {
     const parts = (!skipStatePreamble && includePreamble) ? [`## Current Minions State (${new Date().toISOString().slice(0, 16)})\n\n${buildCCStatePreamble()}`] : [];
     if (extraContext) parts.push(extraContext);
     if (includeCarryover) {
-      const carryover = _buildTranscriptCarryover(transcript, { currentMessage: message });
+      const carryover = _buildTranscriptCarryover(transcript, { currentMessage: message, outOfBandOnly });
       if (carryover) parts.push(carryover);
     }
     parts.push(message);
@@ -2590,7 +2728,11 @@ async function ccCall(message, { store = 'cc', sessionKey, extraContext, label =
 
   // Attempt 1: resume existing session — skip preamble (session already has context)
   if (sessionId && maxTurns > 1) {
-    const p1 = llm.callLLM(buildPrompt({ includePreamble: false, includeCarryover: resumeNeedsCarryover }), '', {
+    const p1 = llm.callLLM(buildPrompt({
+      includePreamble: false,
+      includeCarryover: resumeNeedsCarryover || resumeHasOutOfBandCarryover,
+      outOfBandOnly: !resumeNeedsCarryover,
+    }), '', {
       timeout, label, model, maxTurns, allowedTools, sessionId, effort: ccEffort, direct: true,
       engineConfig: CONFIG.engine,
     });
@@ -2627,7 +2769,7 @@ async function ccCall(message, { store = 'cc', sessionKey, extraContext, label =
   }
 
   // Attempt 2: fresh session (include preamble for full context)
-  const freshPrompt = buildPrompt({ includeCarryover: resumeNeedsCarryover });
+  const freshPrompt = buildPrompt({ includeCarryover: freshNeedsCarryover });
   const p2 = llm.callLLM(freshPrompt, systemPrompt, {
     timeout, label, model, maxTurns, allowedTools, effort: ccEffort, direct: true,
     engineConfig: CONFIG.engine,
@@ -2675,12 +2817,14 @@ async function ccCallStreaming(message, { store = 'cc', sessionKey, extraContext
   const existing = resolveSession(store, sessionKey);
   let sessionId = existing ? existing.sessionId : null;
   const resumeNeedsCarryover = !!sessionId && _ccRuntimeNeedsResumeCarryover(shared.resolveCcCli(CONFIG.engine));
+  const resumeHasOutOfBandCarryover = !!sessionId && _transcriptHasCarryoverContext(transcript, { outOfBandOnly: true, currentMessage: message });
+  const freshNeedsCarryover = _transcriptHasCarryoverContext(transcript, { currentMessage: message });
 
-  function buildPrompt({ includePreamble = true, includeCarryover = false } = {}) {
+  function buildPrompt({ includePreamble = true, includeCarryover = false, outOfBandOnly = false } = {}) {
     const parts = (!skipStatePreamble && includePreamble) ? [`## Current Minions State (${new Date().toISOString().slice(0, 16)})\n\n${buildCCStatePreamble()}`] : [];
     if (extraContext) parts.push(extraContext);
     if (includeCarryover) {
-      const carryover = _buildTranscriptCarryover(transcript, { currentMessage: message });
+      const carryover = _buildTranscriptCarryover(transcript, { currentMessage: message, outOfBandOnly });
       if (carryover) parts.push(carryover);
     }
     parts.push(message);
@@ -2690,7 +2834,11 @@ async function ccCallStreaming(message, { store = 'cc', sessionKey, extraContext
   let result;
 
   if (sessionId && maxTurns > 1) {
-    const p1 = llm.callLLMStreaming(buildPrompt({ includePreamble: false, includeCarryover: resumeNeedsCarryover }), '', {
+    const p1 = llm.callLLMStreaming(buildPrompt({
+      includePreamble: false,
+      includeCarryover: resumeNeedsCarryover || resumeHasOutOfBandCarryover,
+      outOfBandOnly: !resumeNeedsCarryover,
+    }), '', {
       timeout, label, model, maxTurns, allowedTools, sessionId, effort: ccEffort, direct: true,
       engineConfig: CONFIG.engine,
       onChunk,
@@ -2727,7 +2875,7 @@ async function ccCallStreaming(message, { store = 'cc', sessionKey, extraContext
   }
 
   if (onRetry) onRetry(2);
-  const freshPrompt = buildPrompt({ includeCarryover: resumeNeedsCarryover });
+  const freshPrompt = buildPrompt({ includeCarryover: freshNeedsCarryover });
   const p2 = llm.callLLMStreaming(freshPrompt, systemPrompt, {
     timeout, label, model, maxTurns, allowedTools, effort: ccEffort, direct: true,
     engineConfig: CONFIG.engine,
@@ -3099,7 +3247,7 @@ function _makeDocChatStreamStripper(onChunk) {
 }
 
 // Doc-specific wrapper — adds document context, parses ---DOCUMENT---
-async function ccDocCall({ message, document, title, filePath, selection, canEdit, isJson, model, freshSession, onAbortReady }) {
+async function ccDocCall({ message, document, title, filePath, selection, canEdit, isJson, model, freshSession, transcript, onAbortReady }) {
   const sessionKey = filePath || title;
   const docSlice = String(document || '');
 
@@ -3126,6 +3274,7 @@ async function ccDocCall({ message, document, title, filePath, selection, canEdi
       allowedTools: 'Bash,Read,Write,Edit,Glob,Grep,WebFetch,WebSearch',
       skipStatePreamble: true,
       systemPrompt: DOC_CHAT_SYSTEM_PROMPT,
+      transcript,
       ...(model ? { model } : {}),
       onAbortReady,
     });
@@ -3163,7 +3312,7 @@ async function ccDocCall({ message, document, title, filePath, selection, canEdi
   return _parseDocChatResultText(result.text);
 }
 
-async function ccDocCallStreaming({ message, document, title, filePath, selection, canEdit, isJson, model, freshSession, onAbortReady, onChunk, onToolUse, onRetry }) {
+async function ccDocCallStreaming({ message, document, title, filePath, selection, canEdit, isJson, model, freshSession, transcript, onAbortReady, onChunk, onToolUse, onRetry }) {
   const sessionKey = filePath || title;
   const docSlice = String(document || '');
   const streamStripper = _makeDocChatStreamStripper(onChunk);
@@ -3186,6 +3335,7 @@ async function ccDocCallStreaming({ message, document, title, filePath, selectio
       allowedTools: 'Bash,Read,Write,Edit,Glob,Grep,WebFetch,WebSearch',
       skipStatePreamble: true,
       systemPrompt: DOC_CHAT_SYSTEM_PROMPT,
+      transcript,
       ...(model ? { model } : {}),
       onAbortReady,
       onChunk: streamStripper,
@@ -5346,6 +5496,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
         filePath: body.filePath, selection: body.selection, canEdit, isJson,
         model: body.model || undefined,
         freshSession: !!body.freshSession,
+        transcript: body.transcript,
         onAbortReady: (abort) => { _docAbort = abort; },
       });
       const actionResults = await executeDocChatActions(actions);
@@ -5436,6 +5587,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
           filePath: body.filePath, selection: body.selection, canEdit, isJson,
           model: body.model || undefined,
           freshSession: !!body.freshSession,
+          transcript: body.transcript,
           onAbortReady: (abort) => { _docAbort = abort; },
           onChunk: (text) => { writeDocEvent({ type: 'chunk', text }); },
           onToolUse: (name, input) => { writeDocEvent({ type: 'tool', name, input: _lightToolInput(input) }); },
@@ -5734,13 +5886,15 @@ What would you like to discuss or change? When you're happy, say "approve" and I
         });
       }
 
-      const configPath = path.join(MINIONS_DIR, 'config.json');
-      const config = safeJsonObj(configPath);
-      if (!config) return jsonReply(res, 500, { error: 'failed to read config' });
-      if (!config.projects) config.projects = [];
-
-      // Check if already linked
-      if (config.projects.find(p => path.resolve(p.localPath) === target)) {
+      // Check if already linked under the config lock so concurrent dashboard
+      // adds cannot both pass the preflight check and then clobber config.json.
+      let alreadyLinked = false;
+      mutateDashboardConfig(config => {
+        if (!Array.isArray(config.projects)) config.projects = [];
+        alreadyLinked = config.projects.some(p => path.resolve(p.localPath) === target);
+        return config;
+      });
+      if (alreadyLinked) {
         return jsonReply(res, 400, { error: 'Project already linked at ' + target });
       }
 
@@ -5779,8 +5933,17 @@ What would you like to discuss or change? When you're happy, say "approve" and I
       // .minions state without leaving repo-local state files behind.
       shared.ensureProjectStateFiles(project, { migrateLegacy: true, removeLegacy: true });
 
-      config.projects.push(project);
-      safeWrite(configPath, config);
+      let duplicate = false;
+      mutateDashboardConfig(config => {
+        if (!Array.isArray(config.projects)) config.projects = [];
+        if (config.projects.some(p => path.resolve(p.localPath) === target)) {
+          duplicate = true;
+          return config;
+        }
+        config.projects.push(project);
+        return config;
+      });
+      if (duplicate) return jsonReply(res, 400, { error: 'Project already linked at ' + target });
       reloadConfig(); // Update in-memory project list immediately
       invalidateStatusCache();
 
@@ -6181,11 +6344,14 @@ What would you like to discuss or change? When you're happy, say "approve" and I
         const wasResume = !!tabSessionId;
         const sessionId = tabSessionId || null;
         const resumeNeedsCarryover = wasResume && _ccRuntimeNeedsResumeCarryover(currentRuntime);
+        const resumeHasOutOfBandCarryover = wasResume && _transcriptHasCarryoverContext(body.transcript, { outOfBandOnly: true, currentMessage: body.message });
         const preamble = wasResume ? '' : buildCCStatePreamble();
-        const carryover = (sessionReset || resumeNeedsCarryover)
+        const includeFullCarryover = sessionReset || resumeNeedsCarryover;
+        const carryover = (includeFullCarryover || resumeHasOutOfBandCarryover)
           ? _buildTranscriptCarryover(body.transcript, {
             previousRuntime: sessionReset ? previousRuntime : null,
             currentMessage: body.message,
+            outOfBandOnly: !includeFullCarryover,
           })
           : '';
         const prompt = _joinCcPromptParts(preamble, carryover, body.message);
@@ -6358,24 +6524,25 @@ What would you like to discuss or change? When you're happy, say "approve" and I
       if (!id) id = 'schedule';
     }
 
+    let sched;
+    mutateDashboardConfig(config => {
+      if (!Array.isArray(config.schedules)) config.schedules = [];
+      // If auto-generated ID collides, append a short numeric suffix
+      let scheduleId = id;
+      if (config.schedules.some(s => s.id === scheduleId)) {
+        let suffix = 2;
+        while (config.schedules.some(s => s.id === `${scheduleId}-${suffix}`)) suffix++;
+        scheduleId = `${scheduleId}-${suffix}`;
+      }
+      sched = { id: scheduleId, cron, title, type: type || 'implement', enabled: enabled !== false };
+      if (project) sched.project = project;
+      if (agent) sched.agent = agent;
+      if (description) sched.description = description;
+      if (priority) sched.priority = priority;
+      config.schedules.push(sched);
+      return config;
+    });
     reloadConfig();
-    if (!CONFIG.schedules) CONFIG.schedules = [];
-
-    // If auto-generated ID collides, append a short numeric suffix
-    if (CONFIG.schedules.some(s => s.id === id)) {
-      let suffix = 2;
-      while (CONFIG.schedules.some(s => s.id === `${id}-${suffix}`)) suffix++;
-      id = `${id}-${suffix}`;
-    }
-
-    const sched = { id, cron, title, type: type || 'implement', enabled: enabled !== false };
-    if (project) sched.project = project;
-    if (agent) sched.agent = agent;
-    if (description) sched.description = description;
-    if (priority) sched.priority = priority;
-
-    CONFIG.schedules.push(sched);
-    safeWrite(path.join(MINIONS_DIR, 'config.json'), CONFIG);
     invalidateStatusCache();
     return jsonReply(res, 200, { ok: true, schedule: sched });
   }
@@ -6385,21 +6552,28 @@ What would you like to discuss or change? When you're happy, say "approve" and I
     const { id, cron, title, type, project, agent, description, priority, enabled } = body;
     if (!id) return jsonReply(res, 400, { error: 'id required' });
 
-    reloadConfig();
-    if (!CONFIG.schedules) return jsonReply(res, 404, { error: 'No schedules configured' });
-    const sched = CONFIG.schedules.find(s => s.id === id);
+    let missingSchedules = false;
+    let sched = null;
+    mutateDashboardConfig(config => {
+      if (!Array.isArray(config.schedules)) {
+        missingSchedules = true;
+        return config;
+      }
+      sched = config.schedules.find(s => s.id === id);
+      if (!sched) return config;
+      if (cron !== undefined) sched.cron = cron;
+      if (title !== undefined) sched.title = title;
+      if (type !== undefined) sched.type = type;
+      if (project !== undefined) sched.project = project || null;
+      if (agent !== undefined) sched.agent = agent || null;
+      if (description !== undefined) sched.description = description;
+      if (priority !== undefined) sched.priority = priority;
+      if (enabled !== undefined) sched.enabled = enabled;
+      return config;
+    });
+    if (missingSchedules) return jsonReply(res, 404, { error: 'No schedules configured' });
     if (!sched) return jsonReply(res, 404, { error: 'Schedule not found' });
-
-    if (cron !== undefined) sched.cron = cron;
-    if (title !== undefined) sched.title = title;
-    if (type !== undefined) sched.type = type;
-    if (project !== undefined) sched.project = project || null;
-    if (agent !== undefined) sched.agent = agent || null;
-    if (description !== undefined) sched.description = description;
-    if (priority !== undefined) sched.priority = priority;
-    if (enabled !== undefined) sched.enabled = enabled;
-
-    safeWrite(path.join(MINIONS_DIR, 'config.json'), CONFIG);
+    reloadConfig();
     invalidateStatusCache();
     return jsonReply(res, 200, { ok: true, schedule: sched });
   }
@@ -6409,13 +6583,22 @@ What would you like to discuss or change? When you're happy, say "approve" and I
     const { id } = body;
     if (!id) return jsonReply(res, 400, { error: 'id required' });
 
+    let missingSchedules = false;
+    let deleted = false;
+    mutateDashboardConfig(config => {
+      if (!Array.isArray(config.schedules)) {
+        missingSchedules = true;
+        return config;
+      }
+      const idx = config.schedules.findIndex(s => s.id === id);
+      if (idx < 0) return config;
+      config.schedules.splice(idx, 1);
+      deleted = true;
+      return config;
+    });
+    if (missingSchedules) return jsonReply(res, 404, { error: 'No schedules configured' });
+    if (!deleted) return jsonReply(res, 404, { error: 'Schedule not found' });
     reloadConfig();
-    if (!CONFIG.schedules) return jsonReply(res, 404, { error: 'No schedules configured' });
-    const idx = CONFIG.schedules.findIndex(s => s.id === id);
-    if (idx < 0) return jsonReply(res, 404, { error: 'Schedule not found' });
-
-    CONFIG.schedules.splice(idx, 1);
-    safeWrite(path.join(MINIONS_DIR, 'config.json'), CONFIG);
     invalidateStatusCache();
     return jsonReply(res, 200, { ok: true });
   }
@@ -6588,8 +6771,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
   async function handleSettingsUpdate(req, res) {
     try {
       const body = await readBody(req);
-      const configPath = path.join(MINIONS_DIR, 'config.json');
-      const config = safeJson(configPath) || {};
+      const config = safeJson(CONFIG_PATH) || {};
       if (!config.engine) config.engine = {};
       if (!config.agents) config.agents = {};
       shared.pruneDefaultClaudeConfig(config);
@@ -6597,6 +6779,17 @@ What would you like to discuss or change? When you're happy, say "approve" and I
       const _clamped = [];
       const _engineModelDiscovery = require('./engine/model-discovery');
       const _engineRuntimes = require('./engine/runtimes');
+      const _configPatch = { engine: { set: {}, delete: new Set() } };
+      function _setEngineConfig(key, value) {
+        config.engine[key] = value;
+        _configPatch.engine.set[key] = value;
+        _configPatch.engine.delete.delete(key);
+      }
+      function _deleteEngineConfig(key) {
+        delete config.engine[key];
+        delete _configPatch.engine.set[key];
+        _configPatch.engine.delete.add(key);
+      }
       function _resolveModelForRuntime(modelStr, runtimeName) {
         try {
           const adapter = _engineRuntimes.resolveRuntime(runtimeName);
@@ -6630,13 +6823,13 @@ What would you like to discuss or change? When you're happy, say "approve" and I
             val = Math.max(min, val);
             if (max !== undefined) val = Math.min(max, val);
             if (val !== raw) _clamped.push(`${key}: ${raw} → ${val} (range: ${min}–${max || '∞'})`);
-            config.engine[key] = val;
+            _setEngineConfig(key, val);
           }
         }
-        delete config.engine.adoPollStatusEvery;
-        delete config.engine.adoPollCommentsEvery;
+        _deleteEngineConfig('adoPollStatusEvery');
+        _deleteEngineConfig('adoPollCommentsEvery');
         // String fields
-        if (e.worktreeRoot !== undefined) config.engine.worktreeRoot = String(e.worktreeRoot || D.worktreeRoot);
+        if (e.worktreeRoot !== undefined) _setEngineConfig('worktreeRoot', String(e.worktreeRoot || D.worktreeRoot));
 
         // ── Runtime fleet (P-7a5c1f8e) ─────────────────────────────────────
         // Empty string clears the override — the dashboard's "Default (CLI
@@ -6653,13 +6846,13 @@ What would you like to discuss or change? When you're happy, say "approve" and I
           return _registeredCliNames.length === 0 || _registeredCliNames.includes(String(name));
         };
         if (e.defaultCli !== undefined) {
-          if (_isClear(e.defaultCli)) delete config.engine.defaultCli;
-          else if (_validCli(e.defaultCli)) config.engine.defaultCli = String(e.defaultCli);
+          if (_isClear(e.defaultCli)) _deleteEngineConfig('defaultCli');
+          else if (_validCli(e.defaultCli)) _setEngineConfig('defaultCli', String(e.defaultCli));
           else _clamped.push(`defaultCli: "${e.defaultCli}" not registered (kept previous value)`);
         }
         if (e.ccCli !== undefined) {
-          if (_isClear(e.ccCli)) delete config.engine.ccCli;
-          else if (_validCli(e.ccCli)) config.engine.ccCli = String(e.ccCli);
+          if (_isClear(e.ccCli)) _deleteEngineConfig('ccCli');
+          else if (_validCli(e.ccCli)) _setEngineConfig('ccCli', String(e.ccCli));
           else _clamped.push(`ccCli: "${e.ccCli}" not registered (kept previous value)`);
         }
         // Validate fleet-level model assignments against the resolved runtime.
@@ -6695,47 +6888,47 @@ What would you like to discuss or change? When you're happy, say "approve" and I
           return null;
         }
         if (e.defaultModel !== undefined) {
-          if (_isClear(e.defaultModel)) delete config.engine.defaultModel;
+          if (_isClear(e.defaultModel)) _deleteEngineConfig('defaultModel');
           else {
             const candidate = String(e.defaultModel);
             const resolvedCli = config.engine.defaultCli || 'claude';
             const rejection = await _validateFleetModel(candidate, resolvedCli);
             if (rejection) _clamped.push(`engine.defaultModel: "${candidate}" ${rejection} — kept previous value`);
-            else config.engine.defaultModel = candidate;
+            else _setEngineConfig('defaultModel', candidate);
           }
         }
         if (e.ccModel !== undefined) {
-          if (_isClear(e.ccModel)) delete config.engine.ccModel;
+          if (_isClear(e.ccModel)) _deleteEngineConfig('ccModel');
           else {
             const candidate = String(e.ccModel);
             const resolvedCli = config.engine.ccCli || config.engine.defaultCli || 'claude';
             const rejection = await _validateFleetModel(candidate, resolvedCli);
             if (rejection) _clamped.push(`engine.ccModel: "${candidate}" ${rejection} — kept previous value`);
-            else config.engine.ccModel = candidate;
+            else _setEngineConfig('ccModel', candidate);
           }
         }
         if (e.claudeFallbackModel !== undefined) {
-          if (_isClear(e.claudeFallbackModel)) delete config.engine.claudeFallbackModel;
-          else config.engine.claudeFallbackModel = String(e.claudeFallbackModel);
+          if (_isClear(e.claudeFallbackModel)) _deleteEngineConfig('claudeFallbackModel');
+          else _setEngineConfig('claudeFallbackModel', String(e.claudeFallbackModel));
         }
         if (e.copilotStreamMode !== undefined) {
           const valid = ['on', 'off'];
-          if (_isClear(e.copilotStreamMode)) delete config.engine.copilotStreamMode;
-          else if (valid.includes(e.copilotStreamMode)) config.engine.copilotStreamMode = e.copilotStreamMode;
+          if (_isClear(e.copilotStreamMode)) _deleteEngineConfig('copilotStreamMode');
+          else if (valid.includes(e.copilotStreamMode)) _setEngineConfig('copilotStreamMode', e.copilotStreamMode);
           else _clamped.push(`copilotStreamMode: "${e.copilotStreamMode}" not in [on, off] (kept previous value)`);
         }
         // maxBudgetUsd uses ?? semantics — 0 is a valid cap (read-only / dry-run agents).
         if (e.maxBudgetUsd !== undefined) {
-          if (_isClear(e.maxBudgetUsd)) delete config.engine.maxBudgetUsd;
+          if (_isClear(e.maxBudgetUsd)) _deleteEngineConfig('maxBudgetUsd');
           else {
             const n = Number(e.maxBudgetUsd);
-            if (Number.isFinite(n) && n >= 0) config.engine.maxBudgetUsd = n;
+            if (Number.isFinite(n) && n >= 0) _setEngineConfig('maxBudgetUsd', n);
             else _clamped.push(`maxBudgetUsd: "${e.maxBudgetUsd}" must be ≥ 0 (kept previous value)`);
           }
         }
         if (e.ccEffort !== undefined) {
           const valid = [null, 'low', 'medium', 'high'];
-          config.engine.ccEffort = valid.includes(e.ccEffort) ? e.ccEffort : null;
+          _setEngineConfig('ccEffort', valid.includes(e.ccEffort) ? e.ccEffort : null);
         }
         // Per-type max turns
         if (e.maxTurnsByType !== undefined && typeof e.maxTurnsByType === 'object') {
@@ -6744,18 +6937,18 @@ What would you like to discuss or change? When you're happy, say "approve" and I
             const n = Number(val);
             if (n && n >= 5 && n <= 500) mbt[type] = n;
           }
-          config.engine.maxTurnsByType = mbt;
+          _setEngineConfig('maxTurnsByType', mbt);
         }
         // Boolean fields
         const booleanFields = Object.keys(shared.ENGINE_DEFAULTS).filter(k => typeof shared.ENGINE_DEFAULTS[k] === 'boolean');
         for (const key of booleanFields) {
-          if (e[key] !== undefined) config.engine[key] = !!e[key];
+          if (e[key] !== undefined) _setEngineConfig(key, !!e[key]);
         }
         // Eval loop settings
-        if (e.evalMaxIterations !== undefined) config.engine.evalMaxIterations = Math.max(1, Math.min(10, Number(e.evalMaxIterations) || D.evalMaxIterations));
-        if (e.evalMaxCost !== undefined) config.engine.evalMaxCost = e.evalMaxCost === null || e.evalMaxCost === '' ? null : Math.max(0, Number(e.evalMaxCost) || 0);
+        if (e.evalMaxIterations !== undefined) _setEngineConfig('evalMaxIterations', Math.max(1, Math.min(10, Number(e.evalMaxIterations) || D.evalMaxIterations)));
+        if (e.evalMaxCost !== undefined) _setEngineConfig('evalMaxCost', e.evalMaxCost === null || e.evalMaxCost === '' ? null : Math.max(0, Number(e.evalMaxCost) || 0));
         if (e.ignoredCommentAuthors !== undefined) {
-          config.engine.ignoredCommentAuthors = String(e.ignoredCommentAuthors || '').split(',').map(s => s.trim().toLowerCase()).filter(Boolean);
+          _setEngineConfig('ignoredCommentAuthors', String(e.ignoredCommentAuthors || '').split(',').map(s => s.trim().toLowerCase()).filter(Boolean));
         }
       }
 
@@ -6892,7 +7085,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
       }
 
       shared.pruneDefaultClaudeConfig(config);
-      safeWrite(configPath, config);
+      mutateDashboardConfig(current => mergeSettingsConfigUpdate(current, config, body, _configPatch));
       // Refresh in-memory CONFIG so subsequent reads see the update
       reloadConfig();
       invalidateStatusCache();
@@ -6915,11 +7108,12 @@ What would you like to discuss or change? When you're happy, say "approve" and I
 
   async function handleSettingsReset(req, res) {
     try {
-      const config = queries.getConfig();
-      config.engine = { ...shared.ENGINE_DEFAULTS };
-      delete config.claude;
-      config.agents = { ...shared.DEFAULT_AGENTS };
-      safeWrite(path.join(MINIONS_DIR, 'config.json'), config);
+      mutateDashboardConfig(config => {
+        config.engine = { ...shared.ENGINE_DEFAULTS };
+        delete config.claude;
+        config.agents = { ...shared.DEFAULT_AGENTS };
+        return config;
+      });
       reloadConfig();
       invalidateStatusCache();
       return jsonReply(res, 200, { ok: true });
@@ -7189,18 +7383,14 @@ What would you like to discuss or change? When you're happy, say "approve" and I
 
     // Pinned notes
     { method: 'GET', path: '/api/pinned', desc: 'Get pinned notes', handler: async (req, res) => {
-      const content = safeRead(path.join(MINIONS_DIR, 'pinned.md'));
+      const content = safeRead(PINNED_PATH);
       return jsonReply(res, 200, { content, entries: parsePinnedEntries(content) });
     }},
     { method: 'POST', path: '/api/pinned', desc: 'Add a pinned note', params: 'title, content, level?', handler: async (req, res) => {
       const body = await readBody(req);
       const { title, content, level } = body;
       if (!title || !content) return jsonReply(res, 400, { error: 'title and content required' });
-      const pinnedPath = path.join(MINIONS_DIR, 'pinned.md');
-      const existing = safeRead(pinnedPath);
-      const levelTag = level === 'critical' ? '🔴 ' : level === 'warning' ? '🟡 ' : '';
-      const entry = '\n\n### ' + levelTag + title + '\n\n' + content + '\n\n*Pinned by human on ' + new Date().toISOString().slice(0, 10) + '*';
-      safeWrite(pinnedPath, (existing || '# Pinned Context\n\nCritical notes visible to all agents.') + entry);
+      addPinnedEntryLocked({ title, content, level });
       // pinned.md is in slow-state cache — opt-in invalidation so the new entry is visible immediately (closes #1295)
       invalidateStatusCache({ includeSlow: true });
       return jsonReply(res, 200, { ok: true });
@@ -7209,12 +7399,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
       const body = await readBody(req);
       const { title } = body;
       if (!title) return jsonReply(res, 400, { error: 'title required' });
-      const pinnedPath = path.join(MINIONS_DIR, 'pinned.md');
-      let content = safeRead(pinnedPath);
-      if (!content) return jsonReply(res, 404, { error: 'No pinned notes' });
-      const regex = new RegExp('\\n\\n###\\s*(?:🔴\\s*|🟡\\s*)?' + title.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '\\n[\\s\\S]*?(?=\\n\\n###|$)', 'i');
-      content = content.replace(regex, '');
-      safeWrite(pinnedPath, content);
+      if (!removePinnedEntryLocked(title)) return jsonReply(res, 404, { error: 'No pinned notes' });
       // pinned.md is in slow-state cache — opt-in invalidation so the unpin is visible immediately
       invalidateStatusCache({ includeSlow: true });
       return jsonReply(res, 200, { ok: true });
@@ -7222,24 +7407,20 @@ What would you like to discuss or change? When you're happy, say "approve" and I
 
     // KB pin state (server-side so CC can pin items)
     { method: 'GET', path: '/api/kb-pins', desc: 'Get pinned KB item keys', handler: async (req, res) => {
-      const pins = shared.safeJson(path.join(MINIONS_DIR, 'engine', 'kb-pins.json')) || [];
+      const pins = shared.safeJson(KB_PINS_PATH) || [];
       return jsonReply(res, 200, { pins });
     }},
     { method: 'POST', path: '/api/kb-pins', desc: 'Set pinned KB item keys', params: 'pins[]', handler: async (req, res) => {
       const body = await readBody(req);
       if (!Array.isArray(body.pins)) return jsonReply(res, 400, { error: 'pins array required' });
-      safeWrite(path.join(MINIONS_DIR, 'engine', 'kb-pins.json'), body.pins);
+      setKbPinsLocked(body.pins);
       return jsonReply(res, 200, { ok: true });
     }},
     { method: 'POST', path: '/api/kb-pins/toggle', desc: 'Toggle a single KB pin', params: 'key', handler: async (req, res) => {
       const body = await readBody(req);
       if (!body.key) return jsonReply(res, 400, { error: 'key required' });
-      const pinsPath = path.join(MINIONS_DIR, 'engine', 'kb-pins.json');
-      const pins = shared.safeJson(pinsPath) || [];
-      const idx = pins.indexOf(body.key);
-      if (idx >= 0) pins.splice(idx, 1); else pins.unshift(body.key);
-      safeWrite(pinsPath, pins);
-      return jsonReply(res, 200, { ok: true, pinned: idx < 0 });
+      const pinned = toggleKbPinLocked(body.key);
+      return jsonReply(res, 200, { ok: true, pinned });
     }},
 
     // Notes
@@ -7479,8 +7660,8 @@ What would you like to discuss or change? When you're happy, say "approve" and I
     { method: 'GET', path: /^\/api\/knowledge\/([^/]+)\/([^?]+)/, template: '/api/knowledge/:category/:file', desc: 'Read a specific knowledge base entry', handler: handleKnowledgeRead },
 
     // Doc chat
-    { method: 'POST', path: '/api/doc-chat', desc: 'Minions-aware doc Q&A + editing via CC session', params: 'message, document, title?, filePath?, selection?, contentHash?', handler: handleDocChat },
-    { method: 'POST', path: '/api/doc-chat/stream', desc: 'Streaming doc chat — SSE with text chunks and tool progress', params: 'message, document, title?, filePath?, selection?, contentHash?', handler: handleDocChatStream },
+    { method: 'POST', path: '/api/doc-chat', desc: 'Minions-aware doc Q&A + editing via CC session', params: 'message, document, title?, filePath?, selection?, contentHash?, transcript?', handler: handleDocChat },
+    { method: 'POST', path: '/api/doc-chat/stream', desc: 'Streaming doc chat — SSE with text chunks and tool progress', params: 'message, document, title?, filePath?, selection?, contentHash?, transcript?', handler: handleDocChatStream },
 
     // Inbox
     { method: 'POST', path: '/api/inbox/persist', desc: 'Promote an inbox item to team notes', params: 'name', handler: handleInboxPersist },
@@ -7504,8 +7685,8 @@ What would you like to discuss or change? When you're happy, say "approve" and I
     // Command Center
     { method: 'POST', path: '/api/command-center/new-session', desc: 'Clear active CC session', handler: handleCommandCenterNewSession },
     { method: 'POST', path: '/api/command-center/abort', desc: 'Abort an in-flight CC request for a tab', params: 'tabId?', handler: handleCommandCenterAbort },
-    { method: 'POST', path: '/api/command-center', desc: 'Conversational command center with full minions context', params: 'message, sessionId?', handler: handleCommandCenter },
-    { method: 'POST', path: '/api/command-center/stream', desc: 'Streaming CC — SSE with text chunks as they arrive', params: 'message, tabId?', handler: handleCommandCenterStream },
+    { method: 'POST', path: '/api/command-center', desc: 'Conversational command center with full minions context', params: 'message, tabId?, sessionId?, transcript?', handler: handleCommandCenter },
+    { method: 'POST', path: '/api/command-center/stream', desc: 'Streaming CC — SSE with text chunks as they arrive', params: 'message, tabId?, sessionId?, transcript?', handler: handleCommandCenterStream },
     { method: 'GET', path: '/api/cc-sessions', desc: 'List CC session metadata for all tabs', handler: handleCCSessionsList },
     { method: 'DELETE', path: /^\/api\/cc-sessions\/([\w-]+)$/, template: '/api/cc-sessions/:id', desc: 'Delete a CC session by tab ID', handler: handleCCSessionDelete },
 
@@ -7909,6 +8090,7 @@ module.exports = {
   buildCCStatePreamble,
   _routesAsMeta,
   _buildTranscriptCarryover,
+  _transcriptHasCarryoverContext,
   _ccRuntimeNeedsResumeCarryover,
   _joinCcPromptParts,
   _captureApiRoutesMeta,
@@ -7916,6 +8098,7 @@ module.exports = {
   _formatCcCliCommandsIndex,
   _resetPreambleCache,
   _installCrashHandlers,
+  _mergeSettingsConfigUpdate: mergeSettingsConfigUpdate,
 };
 
 // Start the HTTP server only when run directly (node dashboard.js).

package/engine/copilot-models.json

@@ -1,5 +1,5 @@
 {
   "runtime": "copilot",
   "models": null,
-  "cachedAt": "2026-05-07T23:17:20.330Z"
+  "cachedAt": "2026-05-07T23:23:28.356Z"
 }

package/engine/shared.js

@@ -421,6 +421,27 @@ function safeWrite(p, data) {
   }
 }
 
+function mutateTextFileLocked(filePath, mutateFn, {
+  defaultValue = '',
+  lockRetries,
+  lockRetryBackoffMs,
+  skipWriteIfUnchanged = false
+} = {}) {
+  const lockPath = `${filePath}.lock`;
+  const retries = lockRetries ?? ENGINE_DEFAULTS.lockRetries;
+  const retryBackoffMs = lockRetryBackoffMs ?? ENGINE_DEFAULTS.lockRetryBackoffMs;
+  return withFileLock(lockPath, () => {
+    const fileExists = fs.existsSync(filePath);
+    const before = fileExists ? safeRead(filePath) : String(defaultValue || '');
+    const next = mutateFn(before);
+    const finalText = next === undefined ? before : String(next);
+    if (!skipWriteIfUnchanged || finalText !== before) {
+      safeWrite(filePath, finalText);
+    }
+    return finalText;
+  }, { retries, retryBackoffMs });
+}
+
 function safeUnlink(p) {
   try { fs.unlinkSync(p); } catch { /* cleanup */ }
 }
@@ -3146,6 +3167,7 @@ module.exports = {
   safeReadDir,
   safeJson, safeJsonObj, safeJsonArr, safeJsonNoRestore,
   safeWrite,
+  mutateTextFileLocked,
   safeUnlink,
   resolveMinionsHome,
   saveMinionsRootPointer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.1777",
+  "version": "0.1.1779",
   "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/prompts/cc-system.md

@@ -85,13 +85,13 @@ I'll dispatch dallas to fix that bug.
 
 **Required fields per action type — server rejects with an error if missing:**
 
-- `dispatch` (and aliases: `fix`, `implement`, `explore`, `review`, `test`): `title` is REQUIRED. `description` recommended. `project` REQUIRED when multiple projects are configured (server returns the list of known names if you guess wrong). For agent hints emit either `agents: ["dallas"]` (array, preferred) or `agent: "dallas"` (string — auto-promoted server-side). Unknown agent names error.
+- `dispatch`: `title` is REQUIRED. `description` recommended. `project` REQUIRED when multiple projects are configured (server returns the list of known names if you guess wrong). For agent hints emit either `agents: ["dallas"]` (array, preferred) or `agent: "dallas"` (string — auto-promoted server-side). Unknown agent names error. Always emit `"type":"dispatch"` for dispatch-like work and preserve the semantic intent in `workType` (`fix`, `implement`, `explore`, `review`, or `test`) instead of using those words as action types.
 - `build-and-test`: `pr` REQUIRED (number, ID, or URL).
 - `note`: `title` and `content` (or `description`) REQUIRED.
 - `knowledge`: `title`, `content`, and `category` REQUIRED. Valid categories: architecture, conventions, project-notes, build-reports, reviews.
 
 Core action types:
-- **dispatch**: title (REQUIRED), workType, priority (low/medium/high), agents[] or agent (optional — both shapes accepted), project (REQUIRED when multi-project unless `pr` resolves to a tracked PR), description, pr (optional PR number/id/url for work that targets an existing PR), scope (`"fan-out"` only when the user explicitly asks to fan out to all agents)
+- **dispatch**: title (REQUIRED), workType, priority (low/medium/high), agents[] or agent (optional — both shapes accepted), project (REQUIRED when multi-project unless `pr` resolves to a tracked PR), description, pr (optional PR number/id/url for work that targets an existing PR), scope (`"fan-out"` only when the user explicitly asks to fan out to all agents). Do not emit `type:"fix"` or `type:"implement"`; emit `type:"dispatch"` with `workType:"fix"` or `workType:"implement"`.
   workTypes: `explore` (research/report only, NO PR), `ask` (answer/report, NO PR), `implement` (new code, PR REQUIRED), `fix` (standalone bug fix creates a PR; include `pr` when fixing review comments/build failures on an existing PR), `review` (code review, NO PR), `test` (tests, PR if new), `verify` (merge/build/maintenance, NO PR)
   If the user wants a design/architecture artifact committed through a PR, dispatch `implement` or `docs` rather than `explore`.
   When the user names a specific agent ("assign this to lambert"), put exactly that one name in `agents` (e.g. `"agents": ["lambert"]`). A single-agent assignment is hard-pinned by the server — it will queue for that agent only and skip the routing table. If the user explicitly asks for fan-out/all agents, set `scope: "fan-out"`.