bullswarm 0.18.3 → 0.18.5

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # bullswarm changelog
 
+## 0.18.4 — reliable auto-follow tail
+
+- Timestamp-aligned mobile auto-follow now preserves the newest workflow
+  milestone instead of replacing it with a spurious newer-rows marker.
+
 ## 0.18.3 — mobile timeline polish
 
 - Auto-follow now begins at a timestamped milestone instead of exposing an

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bullswarm",
-  "version": "0.18.3",
+  "version": "0.18.5",
   "description": "Route work across coding-agent CLI subscriptions — paced by live quota meters, verified by content, never trusting exit codes.",
   "type": "module",
   "bin": {

package/src/workflow/dashboard.js

@@ -559,18 +559,20 @@ function renderWorkflowOverviewPanel(model, width, height, spinnerFrame, timelin
   const timelineRows = Math.max(1, contentRows - liveRows - nextRows);
   const maxTimelineScroll = Math.max(0, timeline.lines.length - timelineRows);
   const scroll = clamp(timelineScroll, 0, maxTimelineScroll);
-  let start = Math.max(0, timeline.lines.length - timelineRows - scroll);
+  const end = Math.max(0, timeline.lines.length - scroll);
+  let start = Math.max(0, end - timelineRows);
   if (start > 0) {
-    while (start < timeline.lines.length && !/^\d{2}:\d{2}\s/.test(timeline.lines[start])) start += 1;
+    start = Math.max(0, end - Math.max(0, timelineRows - 1));
+    while (start < end && !/^\d{2}:\d{2}\s/.test(timeline.lines[start])) start += 1;
   }
-  const historyRows = start > 0 ? Math.max(0, timelineRows - 1) : timelineRows;
-  let visibleTimeline = timeline.lines.slice(start, start + historyRows);
+  let visibleTimeline = timeline.lines.slice(start, end);
   if (start > 0) {
     visibleTimeline.unshift(dimText(`↑ ${start} earlier timeline rows`, inner));
   }
-  const end = start + historyRows;
   if (end < timeline.lines.length && visibleTimeline.length) {
-    visibleTimeline[visibleTimeline.length - 1] = dimText(`↓ ${timeline.lines.length - end} newer timeline rows`, inner);
+    const marker = dimText(`↓ ${timeline.lines.length - end} newer timeline rows`, inner);
+    if (visibleTimeline.length >= timelineRows) visibleTimeline[visibleTimeline.length - 1] = marker;
+    else visibleTimeline.push(marker);
   }
   const visibleLive = live.lines.slice(0, liveRows);
   const visibleNext = next.slice(0, nextRows);
@@ -1266,7 +1268,8 @@ function detailRow(bullswarmDir, token) {
 }
 
 export async function runDashboard(bullswarmDir, {
-  input = process.stdin, output = process.stdout, refreshMs = 1000, token = null,
+  input = process.stdin, output = process.stdout, refreshMs = 1000,
+  spinnerMs = 400, token = null,
 } = {}) {
   if ((!input.isTTY || !output.isTTY) && !token) throw new Error('workflow dashboard requires a TTY, or pass a run ID for a static text tree');
   if ((!input.isTTY || !output.isTTY) && token) {
@@ -1280,6 +1283,7 @@ export async function runDashboard(bullswarmDir, {
   let lastGoodRow = null;
   let rows = dashboardRows(bullswarmDir);
   let selectedRunId = token ? detailRow(bullswarmDir, token).runId : (rows[selected]?.runId ?? null);
+  let lastPaintedFrame = null;
   const ui = {
     focus: 0,
     phaseIndex: null,
@@ -1295,6 +1299,24 @@ export async function runDashboard(bullswarmDir, {
     mobileTimeline: true,
     spinnerFrame: 0,
   };
+  // Clearing the entire alternate screen for every spinner frame produces a
+  // visible blank flash on slower terminals, especially mobile SSH sessions.
+  // Enter/clear the alternate screen once, then repaint each row in place.
+  // Padding to the terminal height also removes remnants when switching from
+  // a taller detail view to a shorter picker view.
+  const writeFrame = (text) => {
+    const clearPrefix = `${ESC}2J${ESC}H`;
+    const source = String(text ?? '').startsWith(clearPrefix)
+      ? String(text ?? '').slice(clearPrefix.length)
+      : String(text ?? '');
+    const height = Math.max(1, Number(output.rows) || source.split('\n').length);
+    const lines = source.split('\n').slice(0, height);
+    while (lines.length < height) lines.push('');
+    const frame = `${ESC}H${lines.map((line) => `${line}${ESC}K`).join('\n')}`;
+    if (frame === lastPaintedFrame) return;
+    lastPaintedFrame = frame;
+    output.write(frame);
+  };
   const paintUnsafe = () => {
     if (selected >= rows.length) selected = Math.max(0, rows.length - 1);
     if (detail && selectedRunId) {
@@ -1309,7 +1331,7 @@ export async function runDashboard(bullswarmDir, {
       });
       ui.phaseIndex = model.phaseIndex;
       ui.agentIndex = model.agentIndex;
-      output.write(renderWorkflowTui(row, {
+      writeFrame(renderWorkflowTui(row, {
         width: output.columns,
         height: output.rows,
         ...ui,
@@ -1317,7 +1339,7 @@ export async function runDashboard(bullswarmDir, {
       }));
       return;
     }
-    output.write(renderDashboard({ rows, selected, message }));
+    writeFrame(renderDashboard({ rows, selected, message }));
   };
   // A render error must never kill the TUI or strand the terminal in
   // alt-screen raw mode (crash observed 2026-08-29 at detailRow via the
@@ -1325,7 +1347,7 @@ export async function runDashboard(bullswarmDir, {
   const paint = () => {
     try { paintUnsafe(); } catch (err) {
       message = `display error: ${err.message}`;
-      try { output.write(renderDashboard({ rows, selected, message })); } catch { /* keep the loop alive */ }
+      try { writeFrame(renderDashboard({ rows, selected, message })); } catch { /* keep the loop alive */ }
     }
   };
   const refresh = () => {
@@ -1337,13 +1359,13 @@ export async function runDashboard(bullswarmDir, {
   };
   input.setRawMode?.(true);
   input.resume();
-  output.write(`${ESC}?1049h${ESC}?25l`);
+  output.write(`${ESC}?1049h${ESC}?25l${ESC}2J${ESC}H`);
   paint();
   const timer = setInterval(refresh, refreshMs);
   const spinnerTimer = setInterval(() => {
     ui.spinnerFrame = (ui.spinnerFrame + 1) % SPINNER_FRAMES.length;
     if (detail) paint();
-  }, 160);
+  }, Math.max(50, Number(spinnerMs) || 400));
   return new Promise((resolve) => {
     const finish = () => {
       clearInterval(timer);