@yemi33/minions 0.1.2088 → 0.1.2090

package/dashboard/js/live-stream.js

@@ -127,6 +127,8 @@ async function refreshLiveOutput() {
     const el = document.getElementById('live-messages');
     if (el) {
       const wasAtBottom = el.scrollHeight - el.scrollTop - el.clientHeight < 150;
+      const savedScrollTop = el.scrollTop;
+      const savedScrollLeft = el.scrollLeft;
       const incrementalSafe = _currentAgentRuntime() !== 'copilot';
       // Incremental render: only parse new content if text is an extension of previous
       if (incrementalSafe && _lastRenderedText && text.length > _lastRenderedText.length && text.startsWith(_lastRenderedText.slice(0, 200))) {
@@ -137,6 +139,10 @@ async function refreshLiveOutput() {
       }
       _lastRenderedText = text;
       if (wasAtBottom) el.scrollTop = el.scrollHeight;
+      else {
+        el.scrollTop = savedScrollTop;
+        el.scrollLeft = savedScrollLeft;
+      }
     }
   } catch (e) { console.error('live-stream reload:', e.message); }
 }

package/dashboard/js/refresh.js

@@ -182,7 +182,6 @@ let _lastChangedFlags = null;
 function _safeRender(name, fn) {
   try { fn(); }
   catch (e) {
-    // eslint-disable-next-line no-console
     console.error('[render] ' + name + ' threw:', e);
   }
 }
@@ -396,7 +395,8 @@ function _refreshSidebarCounterSummaries() {
   // entry read it — drop the dead endpoint + fetch. (Review finding #9.)
 }
 
-function _processStatusUpdate(data) {
+function _processStatusUpdate(data, opts) {
+  opts = opts || {};
   // Kick off the dedicated-endpoint summary refreshes (issue #2949). They
   // run in the background and update window._last* globals that the sidebar
   // _pageCounters read. No await — the current tick continues immediately.
@@ -687,7 +687,11 @@ function _processStatusUpdate(data) {
   // endpoint that re-runs getDispatchQueue() server-side on every
   // request (issue #2949). Completion-report sidecars are now loaded
   // server-side too, so the client no longer needs the cached overlay.
+  // Scroll-preservation opts (preserveCompletedScroll) are threaded
+  // through to renderDispatch so the completed-dispatch pane keeps its
+  // scroll position across refreshes (W-mpp75wkg000b3018).
   _safeRender('dispatch', function() {
+    const dispatchOpts = { preserveCompletedScroll: opts.preserveCompletedScroll };
     const seq = (window._refreshSeq = (window._refreshSeq || 0) + 1);
     window._lastRequestedSeq = window._lastRequestedSeq || {};
     window._lastRequestedSeq.dispatch = seq;
@@ -697,7 +701,7 @@ function _processStatusUpdate(data) {
         if (seq < (window._lastRequestedSeq.dispatch || 0)) return;
         const d = fresh || window._lastDispatch;
         if (d) window._lastDispatch = d;
-        _safeRender('dispatch', function() { renderDispatch(d); });
+        _safeRender('dispatch', function() { renderDispatch(d, dispatchOpts); });
         // Dispatch is the third cross-slice edge: derivePlanStatus reads
         // window._lastDispatch.active/.pending for executing/converting
         // plan-status badges. Without this trigger, plan-status pills lag
@@ -706,7 +710,7 @@ function _processStatusUpdate(data) {
         _fireCrossSliceRender('dispatch', d);
       })
       .catch(function () {
-        if (window._lastDispatch) _safeRender('dispatch', function() { renderDispatch(window._lastDispatch); });
+        if (window._lastDispatch) _safeRender('dispatch', function() { renderDispatch(window._lastDispatch, dispatchOpts); });
       });
   });
   // prunePrdRequeueState moved into the /api/work-items .then handler so it
@@ -714,15 +718,19 @@ function _processStatusUpdate(data) {
   // window._lastWorkItems. (Review finding #5.)
   // Engine log (last 50 entries) comes from /state/engine/log.json with a
   // client-side .slice(-50) to mirror queries.js getEngineLog (issue #2949).
+  // Scroll-preservation opts (preserveEngineLogScroll) are threaded through
+  // to renderEngineLog so the log pane keeps its scroll position across
+  // refreshes (W-mpp75wkg000b3018).
   _safeRender('engineLog', function() {
+    const logOpts = { preserveEngineLogScroll: opts.preserveEngineLogScroll };
     Promise.resolve(fetchEngineLogFromDisk())
       .then(function (fresh) {
         const list = fresh && fresh.length ? fresh : (window._lastEngineLog || []);
         window._lastEngineLog = list;
-        _safeRender('engineLog', function() { renderEngineLog(list); });
+        _safeRender('engineLog', function() { renderEngineLog(list, logOpts); });
       })
       .catch(function () {
-        if (Array.isArray(window._lastEngineLog)) _safeRender('engineLog', function() { renderEngineLog(window._lastEngineLog); });
+        if (Array.isArray(window._lastEngineLog)) _safeRender('engineLog', function() { renderEngineLog(window._lastEngineLog, logOpts); });
       });
   });
   // Metrics now come from /api/metrics (issue #2949) — the enrichment
@@ -1144,7 +1152,8 @@ document.addEventListener('visibilitychange', function() {
   _lastVisibilityChangeAt = now;
 });
 
-async function refresh() {
+async function refresh(opts) {
+  opts = opts || {};
   if (_refreshInFlight) return;
   // Backoff gate — only active while the unreachable banner is up. Skips
   // setInterval ticks until _nextPollAllowedAt is reached so a downed
@@ -1241,7 +1250,7 @@ async function refresh() {
       _lastChangedFlags = _diagChanges;
     }
     try {
-      _processStatusUpdate(data);
+      _processStatusUpdate(data, opts);
     } finally {
       if (_diagOn) {
         _lastChangedFlags = null;

package/dashboard/js/render-agents.js

@@ -47,6 +47,7 @@ function _modelChipHtml(model) {
 function renderAgents(agents) {
   agentData = agents;
   const grid = document.getElementById('agents-grid');
+  const scrollState = captureDashboardScrollState(grid, ['.agent-result']);
   // eslint-disable-next-line no-unsanitized/property -- reason: structural HTML is a string literal; all user data wrapped in escapeHtml()/renderMd() (fields: agent id, emoji, name, status, role, lastAction, warning, resultSummary, blocking tool)
   grid.innerHTML = agents.map(a => `
     <div class="agent-card ${statusColor(a.status)}" data-agent-id="${escapeHtml(a.id)}" onclick="if(shouldIgnoreSelectionClick(event))return;openAgentDetail(this.dataset.agentId)">
@@ -67,6 +68,7 @@ function renderAgents(agents) {
       ${a.resultSummary ? `<div class="agent-result" title="${escapeHtml(a.resultSummary)}">${renderMd(a.resultSummary.slice(0, 200))}${a.resultSummary.length > 200 ? '...' : ''}</div>` : ''}
     </div>
   `).join('');
+  restoreDashboardScrollState(grid, scrollState);
 }
 
 async function openAgentDetail(id) {

package/dashboard/js/render-dispatch.js

@@ -64,10 +64,10 @@ async function fetchDispatchFromDisk(cachedDispatch) {
   }
 }
 
-function _completedPrev() { if (_completedPage > 0) { _completedPage--; refresh(); } }
-function _completedNext() { _completedPage++; refresh(); } // clamped in renderDispatch
-function _logPrev() { if (_logPage > 0) { _logPage--; refresh(); } }
-function _logNext() { _logPage++; refresh(); } // clamped in renderEngineLog
+function _completedPrev() { if (_completedPage > 0) { _completedPage--; refresh({ preserveCompletedScroll: false }); } }
+function _completedNext() { _completedPage++; refresh({ preserveCompletedScroll: false }); } // clamped in renderDispatch
+function _logPrev() { if (_logPage > 0) { _logPage--; refresh({ preserveEngineLogScroll: false }); } }
+function _logNext() { _logPage++; refresh({ preserveEngineLogScroll: false }); } // clamped in renderEngineLog
 
 // Engine restart grace state (W-mpfw3hgm001gc594). After the operator clicks
 // "Restart engine" we suppress the STALE indicators for ENGINE_RESTART_GRACE_MS
@@ -245,7 +245,8 @@ function renderGhThrottleAlert(ghThrottle) {
   el.style.display = 'flex';
 }
 
-function renderDispatch(dispatch) {
+function renderDispatch(dispatch, opts) {
+  opts = opts || {};
   if (!dispatch) return;
 
   // Stats
@@ -294,6 +295,9 @@ function renderDispatch(dispatch) {
   // Completed
   const completedEl = document.getElementById('completed-content');
   const completedCount = document.getElementById('completed-count');
+  const completedScroll = opts.preserveCompletedScroll === false
+    ? null
+    : captureDashboardScrollState(completedEl, [':self', '.pr-table-wrap']);
   const completed = (dispatch.completed || []).slice().reverse();
   completedCount.textContent = completed.length;
 
@@ -331,6 +335,7 @@ function renderDispatch(dispatch) {
   } else {
     completedEl.innerHTML = '<p class="empty">No completed dispatches yet.</p>';
   }
+  restoreDashboardScrollState(completedEl, completedScroll);
 }
 
 // Pull the engine log straight off disk through /state/engine/log.json.
@@ -351,11 +356,16 @@ async function fetchEngineLogFromDisk() {
   }
 }
 
-function renderEngineLog(log) {
+function renderEngineLog(log, opts) {
+  opts = opts || {};
   const el = document.getElementById('engine-log');
   if (!el) return;
+  const scrollState = opts.preserveEngineLogScroll === false
+    ? null
+    : captureDashboardScrollState(el, [':self']);
   if (!log || log.length === 0) {
     el.innerHTML = '<div class="empty">No log entries yet.</div>';
+    restoreDashboardScrollState(el, scrollState);
     return;
   }
   const reversed = log.slice().reverse();
@@ -380,6 +390,7 @@ function renderEngineLog(log) {
   });
   // eslint-disable-next-line no-unsanitized/method -- reason: composed from internal numeric page bounds and fixed renderPager() callback names (no user data flows in)
   if (logPager) el.insertAdjacentHTML('beforeend', logPager);
+  restoreDashboardScrollState(el, scrollState);
 }
 
 function shortTime(t) {

package/dashboard/js/render-inbox.js

@@ -75,10 +75,11 @@ async function fetchNotesFromDisk() {
   }
 }
 
-function _inboxPrev() { if (_inboxPage > 0) { _inboxPage--; renderInbox(inboxData); } }
-function _inboxNext() { _inboxPage++; renderInbox(inboxData); }
+function _inboxPrev() { if (_inboxPage > 0) { _inboxPage--; renderInbox(inboxData, { preserveScroll: false }); } }
+function _inboxNext() { _inboxPage++; renderInbox(inboxData, { preserveScroll: false }); }
 
-function renderInbox(inbox) {
+function renderInbox(inbox, opts) {
+  opts = opts || {};
   invalidatePinsCache();
   inbox = inbox.filter(function(item) { return !isDeleted('inbox:' + item.name); });
   // Stable sort — pinned items float to top
@@ -89,7 +90,8 @@ function renderInbox(inbox) {
   const list = document.getElementById('inbox-list');
   const count = document.getElementById('inbox-count');
   count.textContent = inbox.length;
-  if (!inbox.length) { list.innerHTML = '<p class="empty">No messages yet.</p>'; return; }
+  const scrollState = opts.preserveScroll === false ? null : captureDashboardScrollState(list, [':self']);
+  if (!inbox.length) { list.innerHTML = '<p class="empty">No messages yet.</p>'; restoreDashboardScrollState(list, scrollState); return; }
 
   const totalInboxPages = Math.ceil(inbox.length / INBOX_PER_PAGE);
   if (_inboxPage >= totalInboxPages) _inboxPage = totalInboxPages - 1;
@@ -122,6 +124,7 @@ function renderInbox(inbox) {
   });
   // eslint-disable-next-line no-unsanitized/method -- reason: composed from internal numeric page bounds and fixed renderPager() callback names (no user data flows in)
   if (inboxPager) list.insertAdjacentHTML('beforeend', inboxPager);
+  restoreDashboardScrollState(list, scrollState);
   restoreNotifBadges();
 }
 
@@ -150,6 +153,7 @@ function renderNotes(notes) {
   const el = document.getElementById('notes-list');
   const content = typeof notes === 'object' ? notes.content : notes;
   const updatedAt = typeof notes === 'object' ? notes.updatedAt : null;
+  const scrollState = captureDashboardScrollState(el, ['.notes-preview']);
 
   // Show last updated timestamp
   const updatedEl = document.getElementById('notes-updated');
@@ -157,9 +161,10 @@ function renderNotes(notes) {
     updatedEl.textContent = 'updated ' + formatLocalDateTime(updatedAt);
   }
 
-  if (!content || !content.trim()) { el.innerHTML = '<p class="empty">No team notes yet.</p>'; return; }
+  if (!content || !content.trim()) { el.innerHTML = '<p class="empty">No team notes yet.</p>'; restoreDashboardScrollState(el, scrollState); return; }
   // eslint-disable-next-line no-unsanitized/property -- reason: renderMd() escapes all user-controlled fields before assembling HTML (see dashboard/js/utils.js)
   el.innerHTML = '<div class="notes-preview" data-file="notes.md" onclick="openNotesModal()" title="Click to expand">' + renderMd(content) + '</div>';
+  restoreDashboardScrollState(el, scrollState);
   el.querySelector('.notes-preview')._rawContent = content;
   restoreNotifBadges();
 }

package/dashboard/js/render-kb.js

@@ -17,8 +17,8 @@ let _kbActiveTab = 'all';
 const KB_PER_PAGE = 30;
 let _kbPage = 0;
 
-function _kbPrev() { if (_kbPage > 0) { _kbPage--; renderKnowledgeBase(); } }
-function _kbNext() { _kbPage++; renderKnowledgeBase(); }
+function _kbPrev() { if (_kbPage > 0) { _kbPage--; renderKnowledgeBase({ preserveScroll: false }); } }
+function _kbNext() { _kbPage++; renderKnowledgeBase({ preserveScroll: false }); }
 
 function _formatSweepElapsed(startedAt) {
   if (!startedAt) return '';
@@ -58,11 +58,13 @@ function kbPinnedNewestFirst(a, b) {
   return kbNewestFirst(a, b);
 }
 
-function renderKnowledgeBase() {
+function renderKnowledgeBase(opts) {
+  opts = opts || {};
   _syncPinsFromServer();
   const tabsEl = document.getElementById('kb-tabs');
   const listEl = document.getElementById('kb-list');
   const countEl = document.getElementById('kb-count');
+  const scrollState = opts.preserveScroll === false ? null : captureDashboardScrollState(listEl, [':self']);
 
   // Single pass: flatten all KB items and count pinned
   const allItems = [];
@@ -92,6 +94,7 @@ function renderKnowledgeBase() {
   if (allItems.length === 0) {
     tabsEl.innerHTML = '';
     listEl.innerHTML = '<p class="empty">No knowledge entries yet. Notes are classified here after consolidation.</p>';
+    restoreDashboardScrollState(listEl, scrollState);
     return;
   }
 
@@ -126,6 +129,7 @@ function renderKnowledgeBase() {
 
   if (items.length === 0) {
     listEl.innerHTML = '<p class="empty">No entries in this category.</p>';
+    restoreDashboardScrollState(listEl, scrollState);
     return;
   }
 
@@ -163,13 +167,14 @@ function renderKnowledgeBase() {
   });
   // eslint-disable-next-line no-unsanitized/method -- reason: composed from internal numeric page bounds and fixed renderPager() callback names (no user data flows in)
   if (kbPager) listEl.insertAdjacentHTML('beforeend', kbPager);
+  restoreDashboardScrollState(listEl, scrollState);
   restoreNotifBadges();
 }
 
 function kbSetTab(tab) {
   _kbActiveTab = tab;
   _kbPage = 0;
-  renderKnowledgeBase();
+  renderKnowledgeBase({ preserveScroll: false });
 }
 
 async function kbSweep() {

package/dashboard/js/render-meetings.js

@@ -62,16 +62,19 @@ async function fetchMeetingsFromDisk() {
   }
 }
 
-function renderMeetings(meetings) {
+function renderMeetings(meetings, opts) {
+  opts = opts || {};
   meetings = (meetings || []).filter(function(m) { return !isDeleted('mtg:' + m.id); });
   meetings.sort((a, b) => (b.createdAt || b.completedAt || '').localeCompare(a.createdAt || a.completedAt || ''));
   _lastMeetingsForPaging = meetings;
   const el = document.getElementById('meetings-content');
   const countEl = document.getElementById('meetings-count');
+  const scrollState = opts.preserveScroll === false ? null : captureDashboardScrollState(el, [':self']);
   if (!meetings || meetings.length === 0) {
     countEl.textContent = '0';
     el.innerHTML = '<p class="empty">No meetings yet. Start one to have agents investigate, debate, and conclude on a topic.</p>';
     _mtgTotalPages = 1;
+    restoreDashboardScrollState(el, scrollState);
     return;
   }
 
@@ -88,6 +91,7 @@ function renderMeetings(meetings) {
     // eslint-disable-next-line no-unsanitized/method -- reason: composed from internal archived count and fixed toggle markup (no user data flows in)
     if (archived.length) el.insertAdjacentHTML('beforeend', '<div style="text-align:center;margin-top:8px"><button class="pr-pager-btn" style="font-size:10px" onclick="_toggleArchivedMeetings()">Show ' + archived.length + ' archived</button></div>');
     _mtgTotalPages = 1;
+    restoreDashboardScrollState(el, scrollState);
     return;
   }
 
@@ -143,29 +147,30 @@ function renderMeetings(meetings) {
     el.insertAdjacentHTML('beforeend', '<div style="text-align:center;margin-top:8px"><button class="pr-pager-btn" style="font-size:10px" onclick="_toggleArchivedMeetings()">' +
       (_showArchived ? 'Hide' : 'Show') + ' ' + archived.length + ' archived</button></div>');
   }
+  restoreDashboardScrollState(el, scrollState);
   restoreNotifBadges();
 }
 
-function _rerenderMeetingPageFromCache() {
-  renderMeetings(_lastMeetingsForPaging || []);
+function _rerenderMeetingPageFromCache(opts) {
+  renderMeetings(_lastMeetingsForPaging || [], opts);
 }
 function _mtgPrev() {
   if (_mtgPage > 0) {
     _mtgPage--;
-    _rerenderMeetingPageFromCache();
+    _rerenderMeetingPageFromCache({ preserveScroll: false });
   }
 }
 function _mtgNext() {
   if (_mtgPage < _mtgTotalPages - 1) {
     _mtgPage++;
-    _rerenderMeetingPageFromCache();
+    _rerenderMeetingPageFromCache({ preserveScroll: false });
   }
 }
 
 function _toggleArchivedMeetings() {
   _showArchived = !_showArchived;
   _mtgPage = 0;
-  _rerenderMeetingPageFromCache();
+  _rerenderMeetingPageFromCache({ preserveScroll: false });
 }
 
 let _meetingPollInterval = null;
@@ -204,14 +209,14 @@ function _renderMeetingDetail(m) {
         if (m.findings?.[agent]) {
           html += '<div style="padding:8px 12px;font-size:11px;border-bottom:1px solid var(--border)">' +
             '<div style="color:var(--muted);font-size:10px;margin-bottom:4px">Round 1 — Findings</div>' +
-            '<div style="word-break:break-word;max-height:300px;overflow-y:auto">' + renderMd(m.findings[agent].content || '') + '</div></div>';
+            '<div class="meeting-scroll-panel" style="word-break:break-word;max-height:300px;overflow-y:auto">' + renderMd(m.findings[agent].content || '') + '</div></div>';
         }
 
         // Debate
         if (m.debate?.[agent]) {
           html += '<div style="padding:8px 12px;font-size:11px;border-bottom:1px solid var(--border)">' +
             '<div style="color:var(--muted);font-size:10px;margin-bottom:4px">Round 2 — Debate</div>' +
-            '<div style="word-break:break-word;max-height:300px;overflow-y:auto">' + renderMd(m.debate[agent].content || '') + '</div></div>';
+            '<div class="meeting-scroll-panel" style="word-break:break-word;max-height:300px;overflow-y:auto">' + renderMd(m.debate[agent].content || '') + '</div></div>';
         }
 
         // Status
@@ -226,7 +231,7 @@ function _renderMeetingDetail(m) {
       if (m.conclusion) {
         html += '<div style="background:rgba(63,185,80,0.08);border:1px solid var(--green);border-radius:6px;padding:10px 14px">' +
           '<div style="color:var(--green);font-weight:600;font-size:12px;margin-bottom:6px">Conclusion (by ' + escHtml(m.conclusion.agent || '?') + ')</div>' +
-          '<div style="font-size:12px;word-break:break-word;max-height:400px;overflow-y:auto">' + renderMd(m.conclusion.content || '') + '</div></div>';
+          '<div class="meeting-scroll-panel" style="font-size:12px;word-break:break-word;max-height:400px;overflow-y:auto">' + renderMd(m.conclusion.content || '') + '</div></div>';
       }
 
       // Human notes
@@ -271,12 +276,12 @@ function _renderMeetingDetail(m) {
 
       document.getElementById('modal-title').textContent = 'Meeting: ' + m.title;
       var body = document.getElementById('modal-body');
-      var scrollTop = body.scrollTop;
+      var scrollState = captureDashboardScrollState(body, [':self', '.meeting-scroll-panel']);
       // eslint-disable-next-line no-unsanitized/property -- reason: renderMd() escapes all user-controlled markdown fields before assembling HTML (see dashboard/js/utils.js); ids and labels use escHtml()
       body.innerHTML = html;
       body.style.fontFamily = "'Segoe UI', system-ui, sans-serif";
       body.style.whiteSpace = 'normal';
-      body.scrollTop = scrollTop;
+      restoreDashboardScrollState(body, scrollState);
 
       // Wire up doc-chat Q&A panel for the meeting transcript
       const transcript = (m.transcript || []).map(t =>

package/dashboard/js/render-pipelines.js

@@ -290,16 +290,19 @@ function _renderPipelineTriggerLabel(cron) {
   return escHtml(human) + ' <span style="opacity:0.6">(' + escHtml(tz) + ')</span>';
 }
 
-function renderPipelines(pipelines) {
+function renderPipelines(pipelines, opts) {
+  opts = opts || {};
   pipelines = (pipelines || []).filter(function(p) { return !isDeleted('pipeline:' + p.id); });
   _pipelinesData = pipelines;
   const el = document.getElementById('pipelines-content');
   const countEl = document.getElementById('pipelines-count');
   if (!el) return;
+  const scrollState = opts.preserveScroll === false ? null : captureDashboardScrollState(el, ['.pl-node-chain']);
   if (!pipelines || pipelines.length === 0) {
     countEl.textContent = '0';
     el.innerHTML = '<p class="empty">No pipelines yet. Create one to chain stages like audit \u2192 meeting \u2192 plan \u2192 merge.</p>';
     _pipelineTotalPages = 1;
+    restoreDashboardScrollState(el, scrollState);
     return;
   }
   countEl.textContent = pipelines.length;
@@ -360,23 +363,29 @@ function renderPipelines(pipelines) {
         '<button class="pr-pager-btn ' + (_pipelinePage >= totalPages - 1 ? 'disabled' : '') + '" onclick="_pipelineNext()">Next</button>' +
       '</div></div>');
   }
+  restoreDashboardScrollState(el, scrollState);
 }
 
 function _pipelinePrev() {
   if (_pipelinePage > 0) {
     _pipelinePage--;
-    renderPipelines(_pipelinesData);
+    renderPipelines(_pipelinesData, { preserveScroll: false });
   }
 }
 
 function _pipelineNext() {
   if (_pipelinePage < _pipelineTotalPages - 1) {
     _pipelinePage++;
-    renderPipelines(_pipelinesData);
+    renderPipelines(_pipelinesData, { preserveScroll: false });
   }
 }
 
 function openPipelineDetail(id) {
+  var modalBody = document.getElementById('modal-body');
+  var preserveModalScroll = document.getElementById('modal')?.classList?.contains('open') && _pipelinePollId === id;
+  var modalScrollState = preserveModalScroll
+    ? captureDashboardScrollState(modalBody, [':self', '.pl-node-chain', '.pipeline-stage-output'])
+    : null;
   _stopPipelinePoll();
   var p = _pipelinesData.find(function(x) { return x.id === id; });
   if (!p) { alert('Pipeline not found'); return; }
@@ -444,7 +453,7 @@ function openPipelineDetail(id) {
       '</div>' +
       _renderMonitoredResources(s.monitoredResources || []) +
       _renderArtifactLinks(stageRun.artifacts, id) +
-      (stageRun.output ? '<div style="margin-top:6px;font-size:11px;max-height:150px;overflow-y:auto">' + renderMd(stageRun.output.slice(0, 500)) + '</div>' : '') +
+      (stageRun.output ? '<div class="pipeline-stage-output" style="margin-top:6px;font-size:11px;max-height:150px;overflow-y:auto">' + renderMd(stageRun.output.slice(0, 500)) + '</div>' : '') +
       (stageStatus === 'waiting-human' ? '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;color:var(--green);border-color:var(--green);margin-top:6px" onclick="_continuePipeline(\'' + escHtml(id) + '\',\'' + escHtml(s.id) + '\',this)">Continue</button>' : '') +
     '</div>';
   });
@@ -477,7 +486,8 @@ function openPipelineDetail(id) {
 
   document.getElementById('modal-title').textContent = 'Pipeline: ' + displayTitle;
   // eslint-disable-next-line no-unsanitized/property -- reason: renderMd() escapes user-controlled stage output before assembling HTML; all other user data wrapped in escHtml() (see dashboard/js/utils.js)
-  document.getElementById('modal-body').innerHTML = html;
+  modalBody.innerHTML = html;
+  restoreDashboardScrollState(modalBody, modalScrollState);
   document.getElementById('modal').classList.add('open');
 
   // Live-poll while modal is open — always poll (not just active runs)

package/dashboard/js/render-prd.js

@@ -160,6 +160,7 @@ function _renderPrdWorkItemIdBadge(workItemId, prdItemId, size, padding) {
 function renderPrdProgress(prog) {
   const el = document.getElementById('prd-progress-content');
   const countEl = document.getElementById('prd-progress-count');
+  const scrollState = captureDashboardScrollState(el, ['.prd-items-list', '.pl-node-chain']);
   if (!prog) { el.innerHTML = ''; countEl.textContent = '—'; return; }
   const visibleItems = (prog.items || []).filter(i => !isDeleted('plan:' + (i.source || '')) && !isDeleted(_prdItemDeleteKey(i.source, i.id)));
 
@@ -654,6 +655,7 @@ function renderPrdProgress(prog) {
 
   // eslint-disable-next-line no-unsanitized/property -- reason: structural HTML is a string literal; all user data wrapped in escHtml() or renderMd() by PRD renderers (fields: item ids/names/descriptions, source, projects, PR links, branches, agent labels)
   el.innerHTML = html;
+  restoreDashboardScrollState(el, scrollState);
   restoreNotifBadges();
 }
 

package/dashboard/js/render-prs.js

@@ -207,7 +207,21 @@ function prTableHtml(rows) {
     '</tr></thead><tbody>' + rows + '</tbody></table></div>';
 }
 
-function renderPrs(prs) {
+function _capturePrScrollState(el) {
+  const tableWrap = el ? el.querySelector('.pr-table-wrap') : null;
+  return tableWrap ? { left: tableWrap.scrollLeft || 0, top: tableWrap.scrollTop || 0 } : null;
+}
+
+function _restorePrScrollState(el, state) {
+  if (!state) return;
+  const tableWrap = el ? el.querySelector('.pr-table-wrap') : null;
+  if (!tableWrap) return;
+  tableWrap.scrollLeft = state.left || 0;
+  tableWrap.scrollTop = state.top || 0;
+}
+
+function renderPrs(prs, opts) {
+  opts = opts || {};
   prs = prs.filter(p => !isDeleted('pr:' + p.id));
   allPrs = prs;
   const el = document.getElementById('pr-content');
@@ -218,6 +232,7 @@ function renderPrs(prs) {
     return;
   }
   const totalPages = Math.ceil(prs.length / PR_PER_PAGE);
+  const previousPage = prPage;
   if (prPage >= totalPages) prPage = totalPages - 1;
   const start = prPage * PR_PER_PAGE;
   const pagePrs = prs.slice(start, start + PR_PER_PAGE);
@@ -235,18 +250,16 @@ function renderPrs(prs) {
     '</div>';
   }
 
-  const tableWrap = el.querySelector('.pr-table-wrap');
-  const savedScroll = tableWrap ? tableWrap.scrollLeft : 0;
+  const savedScroll = opts.preserveScroll === false || previousPage !== prPage
+    ? null
+    : _capturePrScrollState(el);
   // eslint-disable-next-line no-unsanitized/property -- reason: structural HTML is a string literal; all PR user data wrapped in escapeHtml() by prRow() (fields: PR id, title, description, agent, branch, review/build/status labels)
   el.innerHTML = prTableHtml(rows) + pager;
-  if (savedScroll) {
-    const newWrap = el.querySelector('.pr-table-wrap');
-    if (newWrap) newWrap.scrollLeft = savedScroll;
-  }
+  _restorePrScrollState(el, savedScroll);
 }
 
-function prPrev() { if (prPage > 0) { prPage--; renderPrs(allPrs); } }
-function prNext() { const totalPages = Math.ceil(allPrs.length / PR_PER_PAGE); if (prPage < totalPages-1) { prPage++; renderPrs(allPrs); } }
+function prPrev() { if (prPage > 0) { prPage--; renderPrs(allPrs, { preserveScroll: false }); } }
+function prNext() { const totalPages = Math.ceil(allPrs.length / PR_PER_PAGE); if (prPage < totalPages-1) { prPage++; renderPrs(allPrs, { preserveScroll: false }); } }
 
 function openAllPrs() {
   const modalEl = document.querySelector('#modal .modal');

package/dashboard/js/render-schedules.js

@@ -247,7 +247,7 @@ function _renderViewToggle() {
 
 function _schedSetView(mode) {
   _schedViewMode = mode;
-  renderSchedules(window._lastSchedules || []);
+  renderSchedules(window._lastSchedules || [], { preserveScroll: false });
 }
 
 function _renderScheduleCalendar(schedules) {
@@ -310,14 +310,17 @@ function _renderScheduleCalendar(schedules) {
   return html;
 }
 
-function renderSchedules(schedules) {
+function renderSchedules(schedules, opts) {
+  opts = opts || {};
   schedules = schedules.filter(function(s) { return !isDeleted('sched:' + s.id); });
   const el = document.getElementById('scheduled-content');
   const countEl = document.getElementById('scheduled-count');
   countEl.textContent = schedules.length;
   window._lastSchedules = schedules;
+  const scrollState = opts.preserveScroll === false ? null : captureDashboardScrollState(el, ['.pr-table-wrap']);
   if (!schedules.length) {
     el.innerHTML = '<p class="empty">No scheduled tasks. Add one to automate recurring work.</p>';
+    restoreDashboardScrollState(el, scrollState);
     return;
   }
 
@@ -371,10 +374,11 @@ function renderSchedules(schedules) {
 
   // eslint-disable-next-line no-unsanitized/property -- reason: structural HTML is a string literal; all user data wrapped in escHtml() by schedule renderers (fields: schedule id/title/cron/type/project/agent/description)
   el.innerHTML = html;
+  restoreDashboardScrollState(el, scrollState);
 }
 
-function _schedPrev() { if (_schedPage > 0) { _schedPage--; renderSchedules(window._lastSchedules || []); } }
-function _schedNext() { var tp = Math.ceil((window._lastSchedules || []).length / SCHED_PER_PAGE); if (_schedPage < tp-1) { _schedPage++; renderSchedules(window._lastSchedules || []); } }
+function _schedPrev() { if (_schedPage > 0) { _schedPage--; renderSchedules(window._lastSchedules || [], { preserveScroll: false }); } }
+function _schedNext() { var tp = Math.ceil((window._lastSchedules || []).length / SCHED_PER_PAGE); if (_schedPage < tp-1) { _schedPage++; renderSchedules(window._lastSchedules || [], { preserveScroll: false }); } }
 
 function openScheduleDetail(id) {
   const s = (window._lastSchedules || []).find(x => x.id === id);

package/dashboard/js/render-utils.js

@@ -405,4 +405,36 @@ function pinButton(pinKey, pinned, source, opts) {
     (pinned ? 'Unpin' : 'Pin') + '</button>';
 }
 
-window.MinionsRenderUtils = { formatToolSummary, renderAgentOutput, renderTerminalBanner, renderPager, pinButton };
+function _scrollNodesForSelector(root, selector) {
+  if (!root || !selector) return [];
+  if (selector === ':self') return [root];
+  var out = [];
+  if (root.matches && root.matches(selector)) out.push(root);
+  if (root.querySelectorAll) {
+    root.querySelectorAll(selector).forEach(function(el) { out.push(el); });
+  }
+  return out;
+}
+
+function captureDashboardScrollState(root, selectors) {
+  var state = [];
+  (selectors || []).forEach(function(selector) {
+    var nodes = _scrollNodesForSelector(root, selector);
+    nodes.forEach(function(el, index) {
+      state.push({ selector: selector, index: index, top: el.scrollTop || 0, left: el.scrollLeft || 0 });
+    });
+  });
+  return state;
+}
+
+function restoreDashboardScrollState(root, state) {
+  (state || []).forEach(function(item) {
+    var nodes = _scrollNodesForSelector(root, item.selector);
+    var el = nodes[item.index];
+    if (!el) return;
+    el.scrollTop = item.top || 0;
+    el.scrollLeft = item.left || 0;
+  });
+}
+
+window.MinionsRenderUtils = { formatToolSummary, renderAgentOutput, renderTerminalBanner, renderPager, pinButton, captureDashboardScrollState, restoreDashboardScrollState };

package/dashboard/js/render-watches.js

@@ -133,16 +133,19 @@ function _parseIntervalStr(s) {
 let _watchPage = 0;
 const WATCH_PER_PAGE = 15;
 
-function renderWatches(watchesData) {
+function renderWatches(watchesData, opts) {
+  opts = opts || {};
   var watches = (watchesData || []).filter(function(w) { return !isDeleted('watch:' + w.id); });
   var el = document.getElementById('watches-content');
   var countEl = document.getElementById('watches-count');
   if (!el) return;
   if (countEl) countEl.textContent = watches.length;
   window._lastWatches = watches;
+  var scrollState = opts.preserveScroll === false ? null : captureDashboardScrollState(el, ['.pr-table-wrap']);
 
   if (!watches.length) {
     el.innerHTML = '<p class="empty">No active watches. Create one to monitor PRs or work items.</p>';
+    restoreDashboardScrollState(el, scrollState);
     return;
   }
 
@@ -205,10 +208,11 @@ function renderWatches(watchesData) {
 
   // eslint-disable-next-line no-unsanitized/property -- reason: structural HTML is a string literal; all user data wrapped in escHtml() (fields: watch id/target/description/action type/owner/timestamps)
   el.innerHTML = html;
+  restoreDashboardScrollState(el, scrollState);
 }
 
-function _watchPrev() { if (_watchPage > 0) { _watchPage--; renderWatches(window._lastWatches || []); } }
-function _watchNext() { var tp = Math.ceil((window._lastWatches || []).length / WATCH_PER_PAGE); if (_watchPage < tp - 1) { _watchPage++; renderWatches(window._lastWatches || []); } }
+function _watchPrev() { if (_watchPage > 0) { _watchPage--; renderWatches(window._lastWatches || [], { preserveScroll: false }); } }
+function _watchNext() { var tp = Math.ceil((window._lastWatches || []).length / WATCH_PER_PAGE); if (_watchPage < tp - 1) { _watchPage++; renderWatches(window._lastWatches || [], { preserveScroll: false }); } }
 
 // ─── Detail Modal ───────────────────────────────────────────────────────────
 

package/dashboard/js/render-work-items.js

@@ -177,7 +177,8 @@ function wiRow(item) {
   '</tr>';
 }
 
-function renderWorkItems(items) {
+function renderWorkItems(items, opts) {
+  opts = opts || {};
   items = items.filter(function(w) { return !isDeleted('wi:' + w.id); });
   // Sort: active/dispatched first, then by most recent activity
   const statusOrder = { dispatched: 0, pending: 1, queued: 1, failed: 2, done: 3 };
@@ -198,6 +199,7 @@ function renderWorkItems(items) {
   }
 
   const totalPages = Math.ceil(items.length / WI_PER_PAGE);
+  const previousPage = wiPage;
   if (wiPage >= totalPages) wiPage = totalPages - 1;
   const start = wiPage * WI_PER_PAGE;
   const pageItems = items.slice(start, start + WI_PER_PAGE);
@@ -217,14 +219,12 @@ function renderWorkItems(items) {
     '</div>';
   }
 
-  const tableWrap = el.querySelector('.pr-table-wrap');
-  const savedScroll = tableWrap ? tableWrap.scrollLeft : 0;
+  const scrollState = opts.preserveScroll === false || previousPage !== wiPage
+    ? null
+    : captureDashboardScrollState(el, ['.pr-table-wrap']);
   // eslint-disable-next-line no-unsanitized/property -- reason: structural HTML is a string literal; all user data wrapped in escapeHtml() by wiRow() (fields: work item id/title/source/status/agent/PR links/dates/follow-up metadata)
   el.innerHTML = html;
-  if (savedScroll) {
-    const newWrap = el.querySelector('.pr-table-wrap');
-    if (newWrap) newWrap.scrollLeft = savedScroll;
-  }
+  restoreDashboardScrollState(el, scrollState);
 }
 
 async function editWorkItem(id, source) {
@@ -437,8 +437,8 @@ async function retryWorkItem(id, source) {
   }
 }
 
-function wiPrev() { if (wiPage > 0) { wiPage--; renderWorkItems(allWorkItems); } }
-function wiNext() { const tp = Math.ceil(allWorkItems.length / WI_PER_PAGE); if (wiPage < tp-1) { wiPage++; renderWorkItems(allWorkItems); } }
+function wiPrev() { if (wiPage > 0) { wiPage--; renderWorkItems(allWorkItems, { preserveScroll: false }); } }
+function wiNext() { const tp = Math.ceil(allWorkItems.length / WI_PER_PAGE); if (wiPage < tp-1) { wiPage++; renderWorkItems(allWorkItems, { preserveScroll: false }); } }
 
 let _feedbackRating = null;
 function feedbackWorkItem(id, source) {

package/dashboard/js/utils.js

@@ -53,8 +53,8 @@ function kbPinKey(cat, file) { return 'knowledge/' + cat + '/' + file; }
 function _togglePinAndRefresh(key, source) {
   var pinned = togglePin(key);
   showToast('cmd-toast', pinned ? 'Pinned to top' : 'Unpinned', true);
-  if (source === 'inbox') renderInbox(inboxData);
-  else if (source === 'kb') renderKnowledgeBase();
+  if (source === 'inbox') renderInbox(inboxData, { preserveScroll: false });
+  else if (source === 'kb') renderKnowledgeBase({ preserveScroll: false });
 }
 
 // Modal navigation stack — enables back button when opening a modal from another modal
@@ -93,8 +93,8 @@ function toggleModalPin() {
   var pinned = togglePin(_modalFilePath);
   showToast('cmd-toast', pinned ? 'Pinned to top' : 'Unpinned', true);
   updateModalPinBtn();
-  if (_modalFilePath.startsWith('notes/inbox/')) renderInbox(inboxData);
-  else if (_modalFilePath.startsWith('knowledge/')) renderKnowledgeBase();
+  if (_modalFilePath.startsWith('notes/inbox/')) renderInbox(inboxData, { preserveScroll: false });
+  else if (_modalFilePath.startsWith('knowledge/')) renderKnowledgeBase({ preserveScroll: false });
 }
 
 // Canonical HTML-escape helper (SEC-03). Use this in all new code and for any user-controlled

package/dashboard-build.js

@@ -29,7 +29,7 @@ function buildDashboardHtml() {
   }
 
   const jsFiles = [
-    'utils', 'state', 'features-client', 'detail-panel', 'live-stream',
+    'utils', 'state', 'features-client', 'render-utils', 'detail-panel', 'live-stream',
     'render-agents', 'render-dispatch', 'render-work-items', 'render-prd',
     'render-prs', 'render-plans', 'render-inbox', 'render-kb', 'render-skills',
     'render-other', 'render-managed', 'render-schedules', 'render-watches', 'render-pipelines', 'render-meetings', 'render-pinned',

package/docs/deprecated.json

@@ -1,17 +1,4 @@
 [
-  {
-    "id": "status-retention-stale-default-migration",
-    "description": "applyStatusWorkItemsRetentionMigration + applyStatusMeetingsRetentionMigration: one-time migrations that drop engine.statusWorkItemsRetentionDays=7 and engine.statusMeetingsRetentionDays=7 from loaded config so the new defaults (0, no trim) reach installs whose config.json was persisted while 7 was the baked-in default. The 7-day cutoffs were added alongside the slim projections (W-mphejzmj000718bf for workItems, W-mphlrxx6000a8760 for meetings) but surfaced as data loss to users (completed rows disappearing from /api/status after a week). The slim projections (which deliver the bulk of the payload savings) still run unconditionally; only the date filters were demoted to opt-in. shared.js mutates the in-memory config; engine/cli.js follows up with guarded shared.mutateJsonFileLocked calls on config.json so the fields are also removed on disk — affected installs are permanently corrected the first time the engine boots after this ships.",
-    "code": [
-      { "file": "engine/shared.js", "note": "applyStatusWorkItemsRetentionMigration / applyStatusMeetingsRetentionMigration definitions + _resetStaleRetentionMigrationFlag / _resetStaleMeetingsRetentionMigrationFlag test helpers — pure, in-memory" },
-      { "file": "engine/cli.js", "note": "Two boot blocks inside start() — each applies the in-memory pass THEN mutateJsonFileLocked on config.json to delete the field with skipWriteIfUnchanged so non-7 installs don't churn the file" },
-      { "file": "dashboard.js", "note": "Initial CONFIG load + reloadConfig() both apply the in-memory migrations so the dashboard picks up the new defaults even if it boots before the engine writes config.json" }
-    ],
-    "deprecated": "2026-05-29",
-    "targetRemovalDate": "2026-06-01",
-    "cleanup": "On or after 2026-06-01 (3 days), delete both migration functions + their reset helpers from engine/shared.js (including the shared.js export lines), the boot calls + mutateJsonFileLocked blocks in engine/cli.js, the call sites in dashboard.js, the tests in test/unit/status-workitems-retention.test.js and test/unit/status-meetings-retention.test.js gated on the function names, and this entry. Three days is enough because the on-disk rewrite happens on first engine boot — any install whose engine has rebooted at least once since this shipped has already had its config.json corrected and is no longer dependent on the in-memory shim.",
-    "notes": "Persistent custom values (any non-7 integer) are preserved untouched. The only at-risk users are those who explicitly want a 7-day window — they can re-set via the Settings page after removal. If a user never restarts the engine in the 3-day window, the shim still strips the persisted 7 on dashboard-only boot via the in-memory pass; the on-disk write is a hardening pass for the common case, not a strict requirement."
-  },
   {
     "id": "config-poll-key-migration",
     "location": "engine/queries.js:126-163",

package/package.json

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