tumwater 0.2.0 → 0.4.0

package/dist/src/ui/gui/gui-client.js

@@ -1,30 +1,32 @@
-// vocabulary: plain
 /** The browser-side dashboard app inlined as the GUI page's only <script>. It polls /api/status
  * every second and renders, in the order an operator needs them: the masthead's team status
  * (running, build, main check) and team controls (budget, pause); alerts for whatever needs a
- * human (a failing loop, a red main, a spent budget, an old build, open questions, a pause);
- * the composer that steers the director or one loop; and the team view — today's progress,
- * the loops grouped by what they are doing, the backlog, and the notable activity. The
+ * human (a failing role, a red main, a spent budget, an old build, open questions, a pause);
+ * the composer that steers the director or one role; and the team view — today's progress,
+ * the roles grouped by what they are doing, the backlog, and the notable activity. The
  * view-model, the drawer, the History/Usage/Failures/Pending views, the operator controls, the
  * composer, the Markdown renderer, and the routing/poll boot live in their own modules and
  * are spliced in below; everything shares one scope. The page
  * cannot import the harness modules, so it keeps its own copies of the few display rules it
- * needs (formatters, loop order), each pinned against its TypeScript twin by test. Written as
+ * needs (formatters, role order), each pinned against its TypeScript twin by test. Written as
  * String.raw templates so the served script is exactly the text below — no double escaping. */
+import { GUI_CLIENT_BACKLOG_JS } from "./gui-client-backlog.js";
 import { GUI_CLIENT_BOOT_JS } from "./gui-client-boot.js";
 import { GUI_CLIENT_COMPOSER_JS } from "./gui-client-composer.js";
 import { GUI_CLIENT_DRAWER_JS } from "./gui-client-drawer.js";
+import { GUI_CLIENT_DRAWER_CONFIG_JS } from "./gui-client-drawer-config.js";
+import { GUI_CLIENT_FEED_JS } from "./gui-client-feed.js";
 import { GUI_CLIENT_TEAM_JS } from "./gui-client-team.js";
 import { GUI_CLIENT_HISTORY_JS } from "./gui-client-history.js";
 import { GUI_CLIENT_LABELS_JS } from "./gui-client-labels.js";
-import { GUI_CLIENT_LOOPS_JS } from "./gui-client-loops.js";
+import { GUI_CLIENT_ROLES_JS } from "./gui-client-roles.js";
 import { GUI_CLIENT_MARKDOWN_JS } from "./gui-client-markdown.js";
 import { GUI_CLIENT_MODEL_JS } from "./gui-client-model.js";
 import { GUI_CLIENT_OPERATOR_JS } from "./gui-client-operator.js";
 import { GUI_CLIENT_PENDING_JS } from "./gui-client-pending.js";
+import { GUI_CLIENT_REPORT_CHART_JS } from "./gui-client-report-chart.js";
 import { GUI_CLIENT_REPORT_JS } from "./gui-client-report.js";
 import { GUI_CLIENT_SETTINGS_JS } from "./gui-client-settings.js";
-import { GUI_CLIENT_SOUND_JS } from "./gui-client-sound.js";
 import { ICON_PATHS } from "./gui-icons.js";
 import { ACTIVE_PHASE_PREFIXES } from "../status-model.js";
 /** The client's opening: escaping and the guarded API helpers every call goes through. Kept
@@ -86,7 +88,7 @@ const CORE_JS = String.raw `  const esc = (s) => String(s).replace(/[&<>"']/g, (
   // accepts the connection but never answers
   // would otherwise hold the poll open forever, leaving the page frozen on stale data with no
   // offline alert — the catch in refresh() only runs when fetch rejects. The timeout aborts the
-  // request, so the poll fails, the red "Lost contact" alert shows, and the loop keeps polling.
+  // request, so the poll fails, the red "Lost contact" alert shows, and polling continues.
   // AbortSignal.timeout is standard since 2022; where a browser lacks it the fetch stays
   // unbounded, exactly the old behavior.
   const POLL_TIMEOUT_MS = 15000;
@@ -141,11 +143,11 @@ const FORMAT_JS = String.raw `  // format:start
   const agree = (n, one, many) => (n === 1 ? one : many);
   const plural = (n, one, many) => n + " " + agree(n, one, many || one + "s");
   // The merged-commit work/maintenance split the sidebar's "Merged today" tile and the report's
-  // "Commits merged" tile both print. report-data.ts leaves the counts optional, so a missing
+  // "Commits merged" tile both print. report-types.ts leaves the counts optional, so a missing
   // count reads 0 here rather than "undefined".
   const workSplit = (t) => (t.workCommits ?? 0) + " work / " + (t.maintenanceCommits ?? 0) + " maintenance";
   // The unmerged-commit list both change views paint — each commit's sha and subject on its
-  // own clamped line. The Pending roster's Ahead cell and the loop drawer's Pending change
+  // own clamped line. The Pending roster's Ahead cell and the role drawer's Pending change
   // section had the byte-identical map; a missing or non-array list paints nothing.
   const commitRowsHtml = (commits) =>
     (Array.isArray(commits) ? commits : []).map((c) => "<div class='mono clamp1'>" + esc(c.sha) + " " + esc(c.subject || "—") + "</div>").join("");
@@ -168,7 +170,7 @@ const FORMAT_JS = String.raw `  // format:start
   };
   // human-seconds-fmt:end
   // active-phase-fmt:start
-  // A PERMIT-HOLDING loop in flight — status-model.ts's isActivePhase. The three prefixes are
+  // A PERMIT-HOLDING role in flight — status-model.ts's isActivePhase. The three prefixes are
   // interpolated from status-model.ts's ACTIVE_PHASE_PREFIXES (String.raw still substitutes),
   // so this copy cannot drift from the server's; the running director's own director-working
   // label is checked beside it rather than folded in, because it holds no permit (BUGS.md
@@ -176,14 +178,14 @@ const FORMAT_JS = String.raw `  // format:start
   const ACTIVE_PHASE_PREFIXES = ${JSON.stringify(ACTIVE_PHASE_PREFIXES)};
   const isActivePhase = (phase) => ACTIVE_PHASE_PREFIXES.some((p) => phase.startsWith(p));
   // active-phase-fmt:end
-  // last-tick-fmt:start
-  // The absolute local time of a tick end with its age ("14:32:05 · 3m ago"), prefixed MM-DD
-  // once older than a day; "-" when never ticked — status-render.ts's lastTickCell.
+  // last-run-fmt:start
+  // The absolute local time of a run end with its age ("14:32:05 · 3m ago"), prefixed MM-DD
+  // once older than a day; "-" when never ran — status-render.ts's lastRunCell.
   // Whole elapsed seconds since an instant, clamped at zero and rounded to the nearest
-  // second — datetime.ts's elapsedSeconds (the browser runtime cannot import it), shared by
-  // fmtLastTick and fmtAgo below so the clamp cannot drift between the page's ages.
+  // second — datetime.ts's secondsSince (the browser runtime cannot import it), shared by
+  // fmtLastRun and fmtAgo below so the clamp cannot drift between the page's ages.
   const ageSec = (ts) => Math.max(0, Math.round((Date.now() - ts) / 1000));
-  const fmtLastTick = (ts) => {
+  const fmtLastRun = (ts) => {
     if (!ts) return "-";
     const d = new Date(ts);
     const p = (n) => String(n).padStart(2, "0");
@@ -193,16 +195,16 @@ const FORMAT_JS = String.raw `  // format:start
     const age = humanSeconds(sec) + " ago";
     return s + " · " + age;
   };
-  // last-tick-fmt:end
+  // last-run-fmt:end
   // next-run-fmt:start
-  // When an idle loop may tick again — status-render.ts's nextRunCell: "-" for a loop in flight
+  // When an idle role may run again — status-render.ts's nextRunCell: "-" for a role in flight
   // or parked awaiting a slot (it has no next run to speak of) and for a stopped team; "now"
   // when due; otherwise the remaining time, prefixed "backoff " while backing off. A yield-scaled
   // clock rides as a " ×N" suffix: a quiet role's effective gap is longer than the countdown.
   const fmtNextRun = (l, teamRunning) => {
-    // A torn loop object — a payload missing its phase field — reads as the empty (inactive)
+    // A torn role object — a payload missing its phase field — reads as the empty (inactive)
     // phase rather than throwing: the browser copy is untyped, and its sibling phaseInfo/
-    // loopRank already coerce the same way, so one bad row must not blank the whole table.
+    // roleRank already coerce the same way, so one bad row must not blank the whole table.
     const phase = String(l.phase || "");
     const active = isActivePhase(phase) || phase.startsWith("waiting to start") || phase.startsWith("waiting for ") || phase.startsWith("director working");
     if (!teamRunning || active) return "-";
@@ -220,7 +222,7 @@ const FORMAT_JS = String.raw `  // format:start
     return sec < 60 ? "just now" : humanSeconds(sec) + " ago";
   };
   const fmtClock = (ts) => new Date(ts).toLocaleString([], { month: "short", day: "numeric", hour: "2-digit", minute: "2-digit", second: "2-digit" });
-  // A tick's duration: seconds under two minutes, then minutes, then hours. Each bucket is
+  // A run's duration: seconds under two minutes, then minutes, then hours. Each bucket is
   // chosen from the rounded count so a span just under a cutoff never prints "120s" or "120m".
   const fmtSpan = (ms) => {
     const sec = Math.round(ms / 1000);
@@ -230,7 +232,7 @@ const FORMAT_JS = String.raw `  // format:start
     return (ms / 3600000).toFixed(1) + "h";
   };
   // A run's wall-clock span cell: fmtSpan when a row carries a duration, a dash when it does not
-  // (a tick whose start sits outside the window). Shared by the History table and summary rows
+  // (a run whose start sits outside the window). Shared by the History table and summary rows
   // (and any future duration cell) so the null rule and its em-dash cannot drift between them.
   const durCell = (ms) => (ms === null || ms === undefined ? "—" : esc(fmtSpan(Number(ms))));
   // Server text sometimes carries ISO instants (a restart cooldown's deadline); show them in
@@ -290,13 +292,23 @@ const DOM_JS = String.raw `  const ICONS = ${JSON.stringify(ICON_PATHS)};
     return true;
   }
   // panel-build:end
+  // err-message:start
+  // The one error-message read every fetch/parse catch shares: a thrown Error's message when
+  // it has one (the server's JSON body, or the client's own throws, put it there), else the
+  // caller's fallback. Single-homed here in the core before every splice so the catch blocks
+  // cannot drift the ternary's shape; settings' clientErrorMessage feeds it String(err) as the
+  // fallback.
+  function errMessage(err, fallback) {
+    return err && err.message ? err.message : fallback;
+  }
+  // err-message:end
   // The standard "this view could not load" panel: a title plus the server's error message,
   // if any. cls is "empty" for the bare panels (history, drawer) and "card empty" where the
   // view frames panels in cards (the report views). Drawer paints it through paintPanel so a
   // retry loop does not repaint; callers that own the element assign it directly.
   function errorPanel(title, err, cls) {
     return "<div class='" + (cls || "empty") + "'><strong>" + esc(title) + "</strong>" +
-      esc(err && err.message ? err.message : "") + "</div>";
+      esc(errMessage(err, "")) + "</div>";
   }
   // Mark the one button of a segmented filter whose dataset[attr] matches current as
   // "active" and clear the rest: one home for the toggle loop each of the page's segmented
@@ -349,5 +361,5 @@ const DOM_JS = String.raw `  const ICONS = ${JSON.stringify(ICON_PATHS)};
   let offline = false;
   let activeView = "team";
 `;
-export const GUI_CLIENT_JS = [CORE_JS, FORMAT_JS, GUI_CLIENT_LABELS_JS, GUI_CLIENT_MODEL_JS, DOM_JS, GUI_CLIENT_MARKDOWN_JS, GUI_CLIENT_SOUND_JS, GUI_CLIENT_OPERATOR_JS, GUI_CLIENT_LOOPS_JS, GUI_CLIENT_TEAM_JS, GUI_CLIENT_COMPOSER_JS,
-    GUI_CLIENT_DRAWER_JS, GUI_CLIENT_HISTORY_JS, GUI_CLIENT_PENDING_JS, GUI_CLIENT_REPORT_JS, GUI_CLIENT_SETTINGS_JS, GUI_CLIENT_BOOT_JS].join("\n");
+export const GUI_CLIENT_JS = [CORE_JS, FORMAT_JS, GUI_CLIENT_LABELS_JS, GUI_CLIENT_MODEL_JS, DOM_JS, GUI_CLIENT_MARKDOWN_JS, GUI_CLIENT_OPERATOR_JS, GUI_CLIENT_ROLES_JS, GUI_CLIENT_TEAM_JS, GUI_CLIENT_BACKLOG_JS, GUI_CLIENT_FEED_JS, GUI_CLIENT_COMPOSER_JS,
+    GUI_CLIENT_DRAWER_JS, GUI_CLIENT_DRAWER_CONFIG_JS, GUI_CLIENT_HISTORY_JS, GUI_CLIENT_PENDING_JS, GUI_CLIENT_REPORT_CHART_JS, GUI_CLIENT_REPORT_JS, GUI_CLIENT_SETTINGS_JS, GUI_CLIENT_BOOT_JS].join("\n");

package/dist/src/ui/gui/gui-icons.js

@@ -32,8 +32,6 @@ export const ICON_PATHS = {
     dot: `<circle cx="12" cy="12" r="3" ${FILLED}/>`,
     fail: '<circle cx="12" cy="12" r="9"/><path d="M9 9l6 6M15 9l-6 6"/>',
     offline: '<path d="M3 3l18 18M8.5 16.5a5 5 0 0 1 7 0M5 12.6a10 10 0 0 1 4.2-2.3M14.8 10.3A10 10 0 0 1 19 12.6M12 20h.01"/>',
-    sound: '<path d="M4 9.5v5h3l4.5 4v-13L7 9.5z"/><path d="M15.5 8.7a5 5 0 0 1 0 6.6M18 6.2a9 9 0 0 1 0 11.6"/>',
-    mute: '<path d="M4 9.5v5h3l4.5 4v-13L7 9.5z"/><path d="M15.5 9.5l5 5M20.5 9.5l-5 5"/>',
     settings: '<circle cx="12" cy="12" r="3.2"/><path d="M12 3v2.6M12 18.4V21M3 12h2.6M18.4 12H21M5.6 5.6l1.9 1.9M16.5 16.5l1.9 1.9M5.6 18.4l1.9-1.9M16.5 7.5l1.9-1.9"/>',
 };
 /** One icon's markup — the same shape the browser script's icon() builds. */

package/dist/src/ui/gui/gui-page.js

@@ -5,9 +5,9 @@
  * views — Team's carrying a badge while something needs a human — and the team-wide
  * controls: today's spend against the cap, and pause. The main column shows one view at a
  * time: Team (alerts for whatever needs a human, the composer that steers the director or
- * one loop, today's progress, every loop grouped by what it is doing, the backlog, and the
+ * one role, today's progress, every role grouped by what it is doing, the backlog, and the
  * notable activity), History, Usage, Failures, Pending, or Settings. A drawer opens any
- * loop's detail and live transcript, or any backlog entry in full. Kept apart from
+ * role's detail and live transcript, or any backlog entry in full. Kept apart from
  * gui/gui-server.ts so the server module stays about serving. */
 import { GUI_CLIENT_JS } from "./gui-client.js";
 import { GUI_STYLES } from "./gui-styles.js";
@@ -30,7 +30,6 @@ export const GUI_PAGE = `<!doctype html>
   <div class="side-top">
     <a class="brand" href="#team" aria-label="tumwater team">${LOGO_SVG}<span>tumwater</span></a>
     <div class="side-top-actions">
-      <span id="soundwrap"></span>
       <button type="button" class="icon-btn" id="themetoggle" title="Switch between light and dark" aria-label="Switch between light and dark">${iconSvg("sun", "theme-sun")}${iconSvg("moon", "theme-moon")}</button>
     </div>
   </div>
@@ -73,17 +72,17 @@ export const GUI_PAGE = `<!doctype html>
       </div>
     </form>
     <div id="stats" class="stats"></div>
-    <section class="card" aria-labelledby="loops-title">
+    <section class="card" aria-labelledby="roles-title">
       <header class="card-head">
-        <h2 id="loops-title">Roles</h2>
+        <h2 id="roles-title">Roles</h2>
         <div class="spacer"></div>
         <button type="button" class="btn btn-sm" id="resetall" title="Zero every role's runs, commits, tokens, and cost — scheduling is untouched">${iconSvg("refresh")}<span>Reset counters</span></button>
         <div class="menu-anchor" id="wakelaterwrap"><button type="button" class="btn btn-sm" id="wakelater" aria-haspopup="menu" title="Wake every role later">${iconSvg("clock")}<span>Wake later</span></button></div>
         <button type="button" class="btn btn-sm" id="wakeall" title="Wake every role now, skipping any sleep">${iconSvg("bolt")}<span>Wake all</span></button>
       </header>
       <div class="table-wrap">
-        <table class="table loops" id="loopstable">
-          <thead><tr><th class="c-loop">Role</th><th class="c-status">Status</th><th class="c-activity">Now, or the last result</th><th class="c-today num">Spent today</th><th class="c-actions"><span class="sr-only">Actions</span></th></tr></thead>
+        <table class="table roles" id="rolestable">
+          <thead><tr><th class="c-role">Role</th><th class="c-status">Status</th><th class="c-activity">Now, or the last result</th><th class="c-today num">Spent today</th><th class="c-actions"><span class="sr-only">Actions</span></th></tr></thead>
           <tbody id="rolerows"></tbody>
         </table>
       </div>
@@ -94,6 +93,8 @@ export const GUI_PAGE = `<!doctype html>
           <h2 id="backlog-title">Backlog</h2>
           <div class="spacer"></div>
           <div class="seg" id="backlogtabs" role="tablist" aria-label="Backlog sections"></div>
+          <label id="backlogreadywrap"><input class="field" id="backlogready" type="checkbox"><span>Ready only</span></label>
+          <label><span class="sr-only">Search</span><input class="field" id="backloggrep" type="search" placeholder="Search backlog…" autocomplete="off"></label>
         </header>
         <div id="backlog" class="list"></div>
       </section>
@@ -105,6 +106,8 @@ export const GUI_PAGE = `<!doctype html>
             <button type="button" data-filter="notable" class="active">Notable</button><button type="button" data-filter="all">All events</button>
           </div>
           <label><span class="sr-only">Role</span><select class="field" id="feedrole"><option value="">All roles</option></select></label>
+          <label><span class="sr-only">Window</span><select class="field" id="feedwindow"></select></label>
+          <span id="feedstep" style="display:none"><button type="button" class="btn btn-sm" id="feedearlier">◀ Earlier</button><button type="button" class="btn btn-sm" id="feedlater">Later ▶</button></span>
           <label><span class="sr-only">Search</span><input class="field" id="feedgrep" type="search" placeholder="Search activity…" autocomplete="off"></label>
         </header>
         <ol id="feed" class="feed"></ol>

package/dist/src/ui/gui/gui-styles.js

@@ -250,7 +250,7 @@ export const GUI_STYLES = String.raw `
   .settings-row .field { flex: 1; min-width: 0; }
   .settings-row .btn { flex: none; }
 
-  /* ---- composer: the director prompt (or one loop's), always in reach ---- */
+  /* ---- composer: the director prompt (or one role's), always in reach ---- */
   .composer { padding: 8px; border: 1px solid var(--line); border-radius: 12px;
               background: var(--surface); box-shadow: var(--shadow-sm); }
   .composer:focus-within { border-color: var(--primary); box-shadow: 0 0 0 3px var(--accent-bg); }
@@ -296,6 +296,10 @@ export const GUI_STYLES = String.raw `
   .card-head { display: flex; align-items: center; flex-wrap: wrap; gap: 8px 12px; padding: 10px 16px; min-height: 50px;
                border-bottom: 1px solid var(--line); }
   .card-head h2 { margin: 0; font-size: 14.5px; font-weight: 650; }
+  /* The Post-merge reviews card's header line and one queue entry each, beside the Merge
+     queue card's mono lines — the dashboard twin of 'tumwater reviews'. */
+  .queue-head { padding: 10px 16px 2px; font-size: 12.5px; font-weight: 600; color: var(--text-3); }
+  .queue-entry { padding: 3px 16px; }
   .grid-2 { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1.25fr); gap: 20px; align-items: start; }
   .grid-2.even { grid-template-columns: repeat(2, minmax(0, 1fr)); align-items: stretch; }
   .seg { display: inline-flex; padding: 2px; gap: 2px; border-radius: 9px; background: var(--surface-3); }
@@ -320,7 +324,7 @@ export const GUI_STYLES = String.raw `
                        font-size: 12px; font-weight: 600; color: var(--text-3); }
   .table tr.group:not(:first-child) td { border-top: 1px solid var(--line); }
   .table tr.group .badge { margin-left: 6px; }
-  /* The history view's tick drill-down: the rows' details toggle and the expanded card that
+  /* The history view's run drill-down: the rows' details toggle and the expanded card that
      rides beneath its row, full width. */
   .history .c-x { width: 40px; white-space: nowrap; }
   .hist-x { padding: 0 6px; }
@@ -336,22 +340,22 @@ export const GUI_STYLES = String.raw `
   .clamp2 { display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; overflow-wrap: anywhere; }
   .clamp1 { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 
-  table.loops .c-loop { width: 15%; }
-  table.loops .c-status { width: 24%; }
-  table.loops .c-today { width: 110px; }
-  table.loops .c-actions { width: 136px; }
-  table.loops.free .c-today { display: none; }
-  .loops tr.loop.selected td { background: var(--accent-bg); }
-  .loops tr.loop.selected td:first-child { box-shadow: inset 3px 0 0 var(--primary); }
-  .loops tr.loop.live td:first-child { box-shadow: inset 3px 0 0 var(--blue); }
-  .loops tr.loop.live.selected td:first-child { box-shadow: inset 3px 0 0 var(--primary); }
-  .loop-name { display: flex; align-items: center; flex-wrap: wrap; gap: 6px; }
-  .loop-name .role { font-family: var(--font-mono); font-weight: 600; font-size: 13.5px; }
+  table.roles .c-role { width: 15%; }
+  table.roles .c-status { width: 24%; }
+  table.roles .c-today { width: 110px; }
+  table.roles .c-actions { width: 136px; }
+  table.roles.free .c-today { display: none; }
+  .roles tr.role-row.selected td { background: var(--accent-bg); }
+  .roles tr.role-row.selected td:first-child { box-shadow: inset 3px 0 0 var(--primary); }
+  .roles tr.role-row.live td:first-child { box-shadow: inset 3px 0 0 var(--blue); }
+  .roles tr.role-row.live.selected td:first-child { box-shadow: inset 3px 0 0 var(--primary); }
+  .role-name { display: flex; align-items: center; flex-wrap: wrap; gap: 6px; }
+  .role-name .role { font-family: var(--font-mono); font-weight: 600; font-size: 13.5px; }
   .now { color: var(--text); }
   .actions { display: flex; justify-content: flex-end; gap: 2px; }
-  tr.loop .actions { opacity: 0.55; transition: opacity 0.12s; }
-  tr.loop:hover .actions, tr.loop:focus-within .actions, tr.loop.selected .actions { opacity: 1; }
-  @media (hover: none) { tr.loop .actions { opacity: 1; } }
+  tr.role-row .actions { opacity: 0.55; transition: opacity 0.12s; }
+  tr.role-row:hover .actions, tr.role-row:focus-within .actions, tr.role-row.selected .actions { opacity: 1; }
+  @media (hover: none) { tr.role-row .actions { opacity: 1; } }
 
   /* ---- backlog list ---- */
   .list { max-height: 460px; overflow-y: auto; }
@@ -380,14 +384,14 @@ export const GUI_STYLES = String.raw `
   .feed-icon svg.i { width: 15px; height: 15px; }
   .feed-msg { color: var(--text-2); overflow-wrap: anywhere; }
   .feed-item.k-routine .feed-msg { color: var(--text-3); }
-  .feed-loop { font-family: var(--font-mono); font-size: 12.5px; font-weight: 600; color: var(--text); margin-right: 4px; }
+  .feed-source { font-family: var(--font-mono); font-size: 12.5px; font-weight: 600; color: var(--text); margin-right: 4px; }
   .feed-time { font-size: 12px; color: var(--text-4); white-space: nowrap; font-variant-numeric: tabular-nums; padding-top: 1px; }
   .feed-tally { display: flex; flex-wrap: wrap; gap: 6px; padding: 10px 16px 6px; border-bottom: 1px solid var(--line-soft); }
   .feed-tally .chip { height: 22px; padding: 0 9px; font-size: 12px; font-weight: 500; }
   .feed-tally button.chip { cursor: pointer; }
   .feed-tally .chip.active { border-color: var(--accent); background: var(--accent-bg); color: var(--text); }
 
-  /* ---- drawer: a loop's detail and live transcript, or one backlog entry ---- */
+  /* ---- drawer: a role's detail and live transcript, or one backlog entry ---- */
   .drawer { position: fixed; top: 0; right: 0; bottom: 0; z-index: 50; width: min(660px, 100vw); display: flex;
             flex-direction: column; background: var(--bg); border-left: 1px solid var(--line); box-shadow: var(--shadow-lg);
             animation: slidein 0.16s ease-out; }
@@ -412,11 +416,11 @@ export const GUI_STYLES = String.raw `
   .kv dt { font-size: 12px; color: var(--text-3); }
   .kv dd { margin: 1px 0 0; font-weight: 600; font-variant-numeric: tabular-nums; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
   .note { padding: 11px 13px; border-radius: 10px; border: 1px solid var(--line); background: var(--surface); overflow-wrap: anywhere; }
-  .ticks { list-style: none; margin: 0; padding: 0; border: 1px solid var(--line); border-radius: 10px; overflow: hidden; background: var(--surface); }
-  .ticks li { display: grid; grid-template-columns: 116px minmax(0, 1fr) auto; gap: 10px; padding: 8px 12px;
+  .run-list { list-style: none; margin: 0; padding: 0; border: 1px solid var(--line); border-radius: 10px; overflow: hidden; background: var(--surface); }
+  .run-list li { display: grid; grid-template-columns: 116px minmax(0, 1fr) auto; gap: 10px; padding: 8px 12px;
               border-bottom: 1px solid var(--line-soft); font-size: 13px; }
-  .ticks li:last-child { border-bottom: 0; }
-  .ticks .when { color: var(--text-4); white-space: nowrap; font-variant-numeric: tabular-nums; }
+  .run-list li:last-child { border-bottom: 0; }
+  .run-list .when { color: var(--text-4); white-space: nowrap; font-variant-numeric: tabular-nums; }
   .transcript-sec { flex: 1; min-height: 320px; display: flex; flex-direction: column; }
   .transcript { flex: 1; min-height: 280px; margin: 0; overflow: auto; padding: 12px 14px; border-radius: 10px;
                 border: 1px solid var(--line); background: var(--surface); font: 12.5px/1.6 var(--font-mono);
@@ -500,7 +504,7 @@ export const GUI_STYLES = String.raw `
     .menu-anchor.up .popover { top: calc(100% + 8px); bottom: auto; }
     .main { padding-left: 16px; padding-right: 16px; }
     .stats { grid-template-columns: repeat(2, minmax(0, 1fr)); }
-    table.loops .c-today { display: none; }
+    table.roles .c-today { display: none; }
     .kv { grid-template-columns: repeat(2, minmax(0, 1fr)); }
     .history .c-usage, .history .c-dur, .history .c-model { display: none; }
   }
@@ -508,22 +512,22 @@ export const GUI_STYLES = String.raw `
     .stats.six { grid-template-columns: repeat(2, minmax(0, 1fr)); }
     .stat-value { font-size: 21px; }
     .composer-foot #prompthint { display: none; }
-    table.loops thead { display: none; }
-    table.loops, table.loops tbody { display: block; }
-    table.loops tr.loop { display: grid; grid-template-columns: minmax(0, 1fr) auto; column-gap: 12px;
+    table.roles thead { display: none; }
+    table.roles, table.roles tbody { display: block; }
+    table.roles tr.role-row { display: grid; grid-template-columns: minmax(0, 1fr) auto; column-gap: 12px;
                           padding: 10px 16px; border-bottom: 1px solid var(--line-soft); }
-    table.loops tr.loop td { display: block; width: auto; padding: 0; border: 0; background: none !important; box-shadow: none !important; }
-    table.loops tr.loop td.c-status, table.loops tr.loop td.c-activity { grid-column: 1 / -1; margin-top: 6px; }
-    table.loops tr.loop td.c-actions { grid-row: 1; grid-column: 2; }
-    table.loops tr.loop td.c-today { display: none; }
+    table.roles tr.role-row td { display: block; width: auto; padding: 0; border: 0; background: none !important; box-shadow: none !important; }
+    table.roles tr.role-row td.c-status, table.roles tr.role-row td.c-activity { grid-column: 1 / -1; margin-top: 6px; }
+    table.roles tr.role-row td.c-actions { grid-row: 1; grid-column: 2; }
+    table.roles tr.role-row td.c-today { display: none; }
     .composer-row { flex-wrap: wrap; }
     .composer textarea { order: -1; flex-basis: 100%; }
     .composer-target { flex: 1; }
     .composer-target select { max-width: none; width: 100%; }
-    table.loops tr.group, table.loops tr.group td { display: block; }
-    .history .c-tick, .history .c-detail { display: none; }
-    .ticks li { grid-template-columns: minmax(0, 1fr) auto; }
-    .ticks .when:first-child { grid-column: 1 / -1; }
+    table.roles tr.group, table.roles tr.group td { display: block; }
+    .history .c-run, .history .c-detail { display: none; }
+    .run-list li { grid-template-columns: minmax(0, 1fr) auto; }
+    .run-list .when:first-child { grid-column: 1 / -1; }
     .md { padding: 4px 16px 16px; }
   }
   @media (prefers-reduced-motion: reduce) {

package/dist/src/ui/progress-data.js

@@ -1,8 +1,6 @@
-// vocabulary: plain
 import path from "node:path";
 import { applyToolExecutionEvent, parsePiEventLine, toolCallCommand, } from "../pi/pi-event-line.js";
-import { bufferedCommandStallMs, commandBuffersOutput } from "../pi/command-shape.js";
-import { streamsToolOutput } from "../agent/backend-traits.js";
+import { bufferedCommandStallMs, callBuffersOutput } from "../pi/command-shape.js";
 import { describeToolCall } from "../text/phrases.js";
 import { squash } from "../text/text.js";
 import { defaultConfig, liveConfig } from "../config/config.js";
@@ -17,7 +15,7 @@ const TAIL_BYTES = 4 * 1024 * 1024;
 /** Byte offset a first observation of the log (size `size`) seeds from: the start of the
  * smallest suffix window, grown from TAIL_BYTES in doubling steps, that contains a complete
  * `session` event line — or 0 when the log carries none. A bare `size - TAIL_BYTES` seed
- * opens mid-run whenever the log (which accumulates across ticks up to logMaxBytes) is
+ * opens mid-run whenever the log (which accumulates across runs up to logMaxBytes) is
  * larger than the window, and the first observation then counts every assistant turn after
  * that offset as if it were one run — a number with no defined meaning (BUGS.md 2026-09-22).
  * Seeding at the window that contains the last session anchors the read at a real run
@@ -103,7 +101,7 @@ const PROGRESS_TYPES = new Set([
 /** Apply one parsed progress event to a progress object (mutates it). */
 function feedLine(progress, event) {
     switch (event.type) {
-        case "session": // A new run starts: everything before it was a previous tick — restore the at-time-zero state.
+        case "session": // A new run starts: everything before it was a previous run — restore the at-time-zero state.
             Object.assign(progress, freshProgress(progress.quietMs));
             break;
         case "tool_execution_start": {
@@ -143,7 +141,7 @@ function feedLine(progress, event) {
                     progress.outputTokens += nonNegativeNumber(usage.output, 0);
                     progress.peakContextTokens = Math.max(progress.peakContextTokens, nonNegativeNumber(usage.totalTokens, 0));
                 }
-                // The first text the loop speaks in this run is its work item ("I'll implement plan X");
+                // The first text the role speaks in this run is its work item ("I'll implement plan X");
                 // later messages never replace it.
                 if (!progress.currentWork)
                     progress.currentWork = workItemFromContent(event.message.content);
@@ -180,7 +178,7 @@ export function toolCallStallMs(root) {
  * line, so this runs on every read rather than in feedLine; `now` and `stallMs` are injectable
  * for tests (freshly fed lines stamp Date.now(), so nothing is stalled right after parsing).
  * A call whose stdout is piped or redirected holds its bytes away from pi until it exits
- * (BUGS.md 2026-09-28: the tick prompt itself prescribes `npm run test 2>&1 | tail`), so its
+ * (BUGS.md 2026-09-28: the run prompt itself prescribes `npm run test 2>&1 | tail`), so its
  * silence is the prescribed shape and never evidence of a hang — but the command can still
  * hang (a leaked grandchild holding the pipe open), so past a wall-clock threshold it is
  * flagged anyway (BUGS.md 2026-10-06), the same threshold runPi's warning applies so the
@@ -192,7 +190,7 @@ export function stalledToolLabel(open, now = Date.now(), stallMs = defaultConfig
         // claude never sends content-bearing tool updates, so silence is expected for every call
         // and only the wall-clock duration can show a hang (plans/agent-backends.md "Watchdogs and
         // progress"); pi keeps the per-command classification.
-        if (!streamsToolOutput(agent) || commandBuffersOutput(call.command || call.label)) {
+        if (callBuffersOutput(agent, call.command || call.label)) {
             if (now - call.lastActivityAt >= bufferedCommandStallMs(stallMs))
                 return call.label;
             continue;
@@ -233,7 +231,7 @@ function feedDemuxed(tail, line, gateCwd) {
             // accumulator as soon as the marker's stage says `reviewing` — a poll that can land
             // before the session event. Resetting here means a previous run's turns/context (the
             // last review, or another run the gate spent) can never show in the new run's cell.
-            // Safe for the in-tick reviewing cell too: a role's gate is serial, so a marker ends
+            // Safe for the in-run reviewing cell too: a role's gate is serial, so a marker ends
             // the previous run.
             tail.cur = kind;
             tail.kindFromMarker = true;
@@ -249,8 +247,8 @@ function feedDemuxed(tail, line, gateCwd) {
     }
     feedLine(tail[tail.cur], event);
 }
-/** Live progress for one of a loop's pi run kinds (`author` — the in-flight tick's run in
- * the role's own worktree, the default; `gate` — the review gate's runs in a leased pool
+/** Live progress for one of a role's agent run kinds (`author` — the in-flight authoring agent
+ * run in the role's own worktree, the default; `gate` — the review gate's runs in a leased pool
  * slot, what the reviewing cell shows), or null when there is no log yet. The raw log is
  * append-only while pi runs and every run starts with a `tumwater_run` marker
  * (src/agent/run-agent.ts), so after seeding from the tail window once we only read and parse

package/dist/src/ui/{tick-progress-model.js → run-progress-model.js}

@@ -1,15 +1,16 @@
 import { readLiveProgress } from "./progress-data.js";
 import { compactTokens } from "../text/format.js";
-/** The in-flight tick's PROGRESS display model (split from status-model.ts, which keeps the
- * loop-phase ladder, the merge cells, and the row derivations): how a running tick renders
+import { pad2 } from "../text/datetime.js";
+/** The in-flight run's PROGRESS display model (split from status-model.ts, which keeps the
+ * role-phase ladder, the merge cells, and the row derivations): how an in-flight run renders
  * its live detail — elapsed, turn, context, current tool, stall — derived from the live log
  * tail (progress-data.ts) and shared by BOTH observer surfaces: the terminal table
  * (status-render.ts's state cell) and the JSON/GUI payload (status-payload.ts), plus the
- * phase ladder's in-flight branches (status-model.ts's loopPhase), so the three cannot
+ * phase ladder's in-flight branches (status-model.ts's rolePhase), so the three cannot
  * drift apart. This is the disk-reading half: every helper here reads (or accepts a caller's
  * precomputed) live log tail, while status-model.ts derives labels from the snapshot. */
 /** Seconds/minutes/hours elapsed formatting shared by the progress helpers and the phase
- * ladder's elapsed branches (loopPhase's merge and parked branches). The hours bucket
+ * ladder's elapsed branches (rolePhase's merge and parked branches). The hours bucket
  * rounds to whole minutes off the total, so a rounded-up 59m5Xs carries into the next hour
  * ("2h0m"); rounding the remainder alone would print the impossible "1h60m". */
 export function duration(ms) {
@@ -17,41 +18,41 @@ export function duration(ms) {
     if (s < 60)
         return `${s}s`;
     if (s < 3600)
-        return `${Math.floor(s / 60)}m${String(s % 60).padStart(2, "0")}s`;
+        return `${Math.floor(s / 60)}m${pad2(s % 60)}s`;
     const totalMinutes = Math.round(s / 60);
     return `${Math.floor(totalMinutes / 60)}h${totalMinutes % 60}m`;
 }
-/** The label for a loop's in-flight tick: `<label>` plus how long it has been running
+/** The label for a role's in-flight run: `<label>` plus how long it has been running
  * ("working 3m", "reviewing 2m") — shared by workingDetail and the review-gate branch of
- * loopPhase so their elapsed formatting cannot drift. A tick with no recorded start time
- * renders as just the bare label. (A merge's elapsed is its marker's, never the tick's —
- * loopPhase's merge branch builds that head itself.) */
+ * rolePhase so their elapsed formatting cannot drift. A run with no recorded start time
+ * renders as just the bare label. (A merge's elapsed is its marker's, never the run's —
+ * rolePhase's merge branch builds that head itself.) */
 export function inFlightLabel(s, label) {
     const elapsed = s.lastRunStartedAt ? duration(Date.now() - s.lastRunStartedAt) : "";
     return `${label} ${elapsed}`.trim();
 }
-/** One rule for whether a log tail's progress describes THIS tick: the log's newest write
- * (quietMs is measured from the raw log's mtime) must have happened after the tick started.
- * Until this tick's pi run writes its first line, the log's tail is the PREVIOUS run — the
- * baseline check (worktree reset plus suite) can take 30–130 s, and a tick waking after 5+
+/** One rule for whether a log tail's progress describes THIS run: the log's newest write
+ * (quietMs is measured from the raw log's mtime) must have happened after the run started.
+ * Until the current agent run writes its first line, the log's tail is the PREVIOUS run — the
+ * baseline check (worktree reset plus suite) can take 30–130 s, and a run waking after 5+
  * minutes idle would otherwise show the earlier run's turn/context/tool and a "no pi output"
- * quiet time measured from before the tick even began, tripping the STALL alert on every
- * such tick's baseline (BUGS.md 2026-09-30). Once the run writes, its mtime is inside the
- * tick, so quietMs can never exceed the tick's own age and the honest quiet measure survives.
- * Applied by every progress reader (workingDetail, the reviewing branch of loopPhase, the
- * token metrics, loopRowCells' precomputed tail) and by status-render's state cell via
- * tickProgress, so the TUI, the GUI payload, and the alert cannot drift apart. A state with
+ * quiet time measured from before the run even began, tripping the STALL alert on every
+ * such run's baseline (BUGS.md 2026-09-30). Once the run writes, its mtime is inside the
+ * run, so quietMs can never exceed the run's own age and the honest quiet measure survives.
+ * Applied by every progress reader (workingDetail, the reviewing branch of rolePhase, the
+ * token metrics, roleRowCells' precomputed tail) and by status-render's state cell via
+ * runProgress, so the TUI, the GUI payload, and the alert cannot drift apart. A state with
  * no recorded start (a stale `running` flag after a crash) cannot be judged and keeps the
  * tail as before. `p` may be undefined (the caller's "no tail fetched" sentinel) or null
  * ("no log"); both read as no progress. */
-function progressOfTick(s, p) {
+function progressOfRun(s, p) {
     if (!p)
         return null;
     if (s.lastRunStartedAt === undefined)
         return p;
     const elapsed = Math.max(0, Date.now() - s.lastRunStartedAt);
     if (p.quietMs > elapsed)
-        return null; // Newest write predates this tick: a previous run's tail.
+        return null; // Newest write predates this run: a previous run's tail.
     return { ...p, quietMs: Math.min(p.quietMs, elapsed) };
 }
 /** The stall phrases a phase label can carry — inFlightDetail appends "tool call stalled:
@@ -65,7 +66,7 @@ export const STALL_SOURCE = String.raw `tool call stalled[^·]*|no agent output
 /** STALL_SOURCE compiled — the server-side matcher (team-alerts.ts's stuck alert). */
 export const STALL_RE = new RegExp(STALL_SOURCE);
 /** The shared parts assembly for an in-flight state cell: `head` (the phase label with its
- * own elapsed — inFlightLabel for a tick, the merge branch's own for a merge) plus turn,
+ * own elapsed — inFlightLabel for a run, the merge branch's own for a merge) plus turn,
  * live context, current tool, and the ≥5-min no-output stall flag. `p` is null when there is
  * no progress (no log yet) — falls back to the bare head. */
 export function inFlightDetail(head, p) {
@@ -87,31 +88,31 @@ export function inFlightDetail(head, p) {
         parts.push(`no agent output for ${duration(p.quietMs)}`);
     return parts.join(" · ");
 }
-/** Which pi run kind (progress-data.ts's ProgressRunKind) a loop's in-flight cells should read:
- * the review gate's reviewer run ("gate") while the tick is under review — its `session`
+/** Which pi run kind (progress-data.ts's ProgressRunKind) a role's in-flight cells should read:
+ * the review gate's reviewer run ("gate") while the run is under review — its `session`
  * event is the log's newest and its counts are what "reviewing" describes — the author's
  * own run ("author") for every other in-flight phase. One home for the rule so the TUI
  * table and the GUI payload cannot drift (the precomputed `live` tail must name the same
- * run the phase label does). status-model's loopRowCells is its only reader. */
+ * run the phase label does). status-model's roleRowCells is its only reader. */
 export function progressKind(s) {
     return s.phase === "review" ? "gate" : "author";
 }
-/** progressOfTick with the tail read folded in — the one home for the
+/** progressOfRun with the tail read folded in — the one home for the
  * `live === undefined ? readLiveProgress(...) : live` idiom. Callers holding this frame's
- * already-fetched tail pass it as `live` (renderStatus reads once per running loop and
+ * already-fetched tail pass it as `live` (renderStatus reads once per running role and
  * threads it through every helper); standalone callers pass undefined and this reads the
  * role's log itself — the author accumulator by default, the gate one via `kind`. Every
  * tail-reading caller outside this module routes through it; status-model.ts's staged branch
  * is the one exception, keeping its raw readLiveProgress call because it feeds inFlightDetail
  * a freshly read gate tail for the merge label, not a per-frame threaded one. */
-export function tickProgress(root, s, live, kind = "author") {
-    return progressOfTick(s, live === undefined ? readLiveProgress(root, s.role, kind) : live);
+export function runProgress(root, s, live, kind = "author") {
+    return progressOfRun(s, live === undefined ? readLiveProgress(root, s.role, kind) : live);
 }
-/** The state cell for a working loop: elapsed · turns · live context · current tool. Pass
- * `live` — this frame's already-fetched tail (renderStatus reads once per running loop and
+/** The state cell for a working role: elapsed · turns · live context · current tool. Pass
+ * `live` — this frame's already-fetched tail (renderStatus reads once per running role and
  * threads it through every helper) — to avoid re-reading the log; without it, this reads on
  * its own for standalone callers. */
 export function workingDetail(root, s, live) {
-    const p = tickProgress(root, s, live);
+    const p = runProgress(root, s, live);
     return inFlightDetail(inFlightLabel(s, "working"), p);
 }