@detergent-software/conductor 2.1.1 → 2.2.0-dev.2

package/mod/hooks/model.ts

@@ -7,8 +7,11 @@ import type { ConductorInboxItem, ConductorLink, ConductorNotify, ConductorSnaps
 // A daemon API answer: its status and parsed JSON body.
 export type ApiAnswer = { body: unknown; status: number };
 
-// One line of `conduct events --follow`: an event of the log (with its id), or the stream's state.
-export type StreamLine = { data: Record<string, unknown>; id: number | null; kind: string; subject: string | null };
+// What a Remote Control push came to: reached the phone (ok); not, as Remote Control is off
+// (inactive) or pushes are off in Claude Code's config (disabled); not sent to the phone on
+// purpose (skipped: Jason is at the terminal, or the answer says nothing about the phone); or the
+// call failed (failed: it threw, was denied, or answered an error).
+export type PushOutcome = { detail: string; state: 'disabled' | 'failed' | 'inactive' | 'ok' | 'skipped' };
 
 // What an event asks of the mod. Only `escalate` wakes the console's model.
 export type Reaction =
@@ -16,14 +19,11 @@ export type Reaction =
   | { kind: 'escalate'; text: string }
   | { kind: 'ignore' }
   | { kind: 'push'; message: string }
-  | { kind: 'refresh'; toast: string | null }
+  | { kind: 'refresh'; toast: null | string }
   | { kind: 'send'; text: string; to: string };
 
-// What a Remote Control push came to: reached the phone (ok); not, as Remote Control is off
-// (inactive) or pushes are off in Claude Code's config (disabled); not sent to the phone on
-// purpose (skipped: Jason is at the terminal, or the answer says nothing about the phone); or the
-// call failed (failed: it threw, was denied, or answered an error).
-export type PushOutcome = { detail: string; state: 'disabled' | 'failed' | 'inactive' | 'ok' | 'skipped' };
+// One line of `conduct events --follow`: an event of the log (with its id), or the stream's state.
+export type StreamLine = { data: Record<string, unknown>; id: null | number; kind: string; subject: null | string };
 
 // Said once in the console when pushes stop reaching the phone (ATK-255), by why.
 export function pushWarning(outcome: PushOutcome): null | string {
@@ -64,9 +64,27 @@ export const MAX_WARMS = 12;
 // The fork's one user message: its answer is thrown away, so the shorter the better.
 export const WARM_PROMPT = 'Cache keep-alive from the conductor mod: answer with the one word ok.';
 
+// A band entry and the act its press does.
+export type BandEntry = { act: 'approve' | 'copy' | 'pane'; hotkey: string; id: number; label: string; text: string };
+
+export type CacheUsage = { cacheRead: number; cacheWrite: number; input: number; output: number };
+
+// A lookup by the item key, or an inbox id written #12; a message when it doesn't resolve to one.
+export type Found<T> = { error: string; found?: undefined } | { error?: undefined; found: T };
 // What the console does at an idle point: ping to keep the cache warm, or start fresh.
 export type IdleAction = { kind: 'clear'; reason: string } | { kind: 'warm' };
 
+// What a ping came to: the cache held (warm), it had lapsed anyway so pinging doesn't work here
+// (cold: a 5-minute TTL, a model change), the call failed, or there was nothing to fork.
+export type PingOutcome = { kind: 'cold' | 'failed' | 'warm'; usage: CacheUsage | null } | { kind: 'nothing' };
+
+export type ProjectGroup = { project: string; rows: ConductorWorker[]; running: number };
+
+// The band's line after the mod cleared an idle console, in place of the no-skill warning.
+export function clearedText(reason: string): string {
+  return `fresh console (cleared while idle: ${reason}); /${CONSOLE_SKILL} loads with the next prompt`;
+}
+
 // `contextTokens` is the context the last response was answered over (absent before the first);
 // `warms` the pings since the last real turn.
 export function idleAction({ contextTokens, warms }: { contextTokens: number | undefined; warms: number }): IdleAction {
@@ -76,11 +94,6 @@ export function idleAction({ contextTokens, warms }: { contextTokens: number | u
   return { kind: 'warm' };
 }
 
-// What a ping came to: the cache held (warm), it had lapsed anyway so pinging doesn't work here
-// (cold: a 5-minute TTL, a model change), the call failed, or there was nothing to fork.
-export type PingOutcome = { kind: 'cold' | 'failed' | 'warm'; usage: CacheUsage | null } | { kind: 'nothing' };
-export type CacheUsage = { cacheRead: number; cacheWrite: number; input: number; output: number };
-
 // `$.model.fork`'s result. The cache held when it served at least half the context the console's
 // last response was answered over; without that figure, when it served more than it wrote.
 export function pingOutcome(result: unknown, contextTokens: number | undefined): PingOutcome {
@@ -92,11 +105,6 @@ export function pingOutcome(result: unknown, contextTokens: number | undefined):
   return { kind: held ? 'warm' : 'cold', usage };
 }
 
-// The band's line after the mod cleared an idle console, in place of the no-skill warning.
-export function clearedText(reason: string): string {
-  return `fresh console (cleared while idle: ${reason}); /${CONSOLE_SKILL} loads with the next prompt`;
-}
-
 function usageOf(value: unknown): CacheUsage | null {
   if (!isRecord(value)) return null;
   const count = (key: string): number => {
@@ -111,23 +119,12 @@ function usageOf(value: unknown): CacheUsage | null {
   };
 }
 
-// A band entry and the act its press does.
-export type BandEntry = { act: 'approve' | 'copy' | 'pane'; hotkey: string; id: number; label: string; text: string };
-
-export type ProjectGroup = { project: string; rows: ConductorWorker[]; running: number };
-
-// A lookup by the item key, or an inbox id written #12; a message when it doesn't resolve to one.
-export type Found<T> = { error: string; found?: undefined } | { error?: undefined; found: T };
-
 const BAND_LIMIT = 5;
 
-// `conductor 3▶ 2⏸ ✉2` for the pane's title, or undefined when no daemon answers.
-export function statusText(snapshot: ConductorSnapshot | null): string | undefined {
-  if (snapshot === null || snapshot.error !== null) return undefined;
-  const running = snapshot.workers.filter((w) => w.status === 'running').length;
-  const parked = snapshot.workers.filter((w) => w.status === 'parked').length;
-  return `conductor ${running}▶ ${parked}⏸ ✉${snapshot.inbox.length}`;
-}
+// What a worker is up to, by its status and its session's activity (manager.ts's activityOf):
+// in a turn, up between turns, stuck on a prompt (`waiting on permission`), parked on a wait,
+// failed or gone (exited too), or not up yet (launching, starting).
+export type WorkerState = 'failed' | 'idle' | 'parked' | 'prompt' | 'starting' | 'working';
 
 // The band's buttons: a plan approves (behind a confirm), an npm OTP copies its command, the rest
 // open the pane, where each item's commands and links are.
@@ -159,33 +156,141 @@ export function projectGroups(workers: readonly ConductorWorker[]): ProjectGroup
     }));
 }
 
-// A worker row's glyph: ▶ running, ⏸ parked, ✖ failed or stopped, · otherwise (launching, exited).
-export function glyph(status: string): string {
-  if (status === 'running') return '▶';
-  if (status === 'parked') return '⏸';
-  if (status === 'failed' || status === 'stopped-unexpectedly') return '✖';
-  return '·';
-}
+// `3 running · 2 parked · inbox 2` beside the pane's title, or undefined when no daemon answers.
+export function statusText(snapshot: ConductorSnapshot | null): string | undefined {
+  if (snapshot === null || snapshot.error !== null) return undefined;
+  const running = snapshot.workers.filter((w) => w.status === 'running').length;
+  const parked = snapshot.workers.filter((w) => w.status === 'parked').length;
+  return `${running} running · ${parked} parked · inbox ${snapshot.inbox.length}`;
+}
+
+export function workerState(w: Pick<ConductorWorker, 'activity' | 'status'>): WorkerState {
+  if (w.status === 'failed' || w.status === 'stopped-unexpectedly' || w.status === 'exited') return 'failed';
+  if (w.status === 'parked') return 'parked';
+  if (w.status !== 'running') return 'starting';
+  if (w.activity === 'working') return 'working';
+  if (w.activity.startsWith('idle')) return 'idle';
+  if (w.activity.startsWith('waiting on ')) return 'prompt';
+  if (w.activity === 'stopped' || w.activity === 'no session') return 'failed';
+  return 'starting';
+}
+
+// A row's glyph and its theme color. None has an emoji form, which Windows Terminal draws two cells
+// wide (⏸ ✖ ✉ did, ATK-521); the shapes are East Asian ambiguous width, one cell outside CJK setups.
+export const GLYPHS: Readonly<Record<WorkerState, { char: string; color: string }>> = {
+  failed: { char: '×', color: 'error' },
+  idle: { char: '◌', color: 'suggestion' },
+  parked: { char: '○', color: 'subtle' },
+  prompt: { char: '!', color: 'warning' },
+  starting: { char: '·', color: 'subtle' },
+  working: { char: '●', color: 'success' },
+};
 
 // A worker's PR as its row shows it: `#1850`; the expanded row shows the whole ref.
 export function prLabel(pr: null | string): string {
   return pr === null ? '' : `#${pr.slice(pr.lastIndexOf('#') + 1)}`;
 }
 
-// What a worker waits on or does: its open wait, else the session's activity.
-// A link the terminal's [open] hands to the OS opener (ATK-494): one a Link would make a link of,
-// an https: URL or http://localhost. Anything else, such as a path, stays a Link, drawn as text.
-export function isWebLink(href: string): boolean {
-  try {
-    const url = new URL(href);
-    return url.protocol === 'https:' || (url.protocol === 'http:' && url.hostname === 'localhost');
-  } catch {
-    return false;
+const PR_EVENTS: Readonly<Record<string, string>> = { merged: 'to merge' };
+
+// The fleet's column widths: the widest name, phase (at most PHASE_MAX) and PR across every project,
+// so the rows line up under each other wherever they are.
+export type FleetColumns = { key: number; phase: number; pr: number };
+
+// One worker's row as the pane draws it, in segments, each with its leading space: together at
+// most the pane's width, so it never wraps. `isWait` says `doing` is a wait (drawn full strength).
+export type FleetRow = {
+  age: string;
+  color: string;
+  doing: string;
+  glyph: string;
+  isWait: boolean;
+  key: string;
+  meta: string;
+};
+
+// A wait's condition key (conditions.ts's formatCondition) in words, the telling part first so a
+// truncated row keeps it: `PR #557 to merge (agentic-toolkit-registry)`, `npm 1.2.3 on dev (atk)`.
+// A kind this doesn't know, or a key it can't read, stays as it is.
+export function waitLabel(condition: string, now: number): string {
+  const colon = condition.indexOf(':');
+  if (colon === -1) return condition;
+  const rest = condition.slice(colon + 1);
+  const read = (pattern: RegExp): null | string[] => pattern.exec(rest)?.slice(1) ?? null;
+  const short = (sha: string): string => sha.slice(0, 7);
+  const last = (path: string): string => path.slice(path.lastIndexOf('/') + 1);
+  switch (condition.slice(0, colon)) {
+    case 'approval':
+      return 'plan approval';
+    case 'health': {
+      const [env = '', field = '', value = ''] = read(/^([^:]+):(commit|version)=(.+)$/) ?? [];
+      if (env) return `${env} health at ${field === 'commit' ? short(value) : value}`;
+      break;
+    }
+    case 'item': {
+      const [item = '', field = '', value = ''] = read(/^[^:]+:([^:]+):(state|label|note)=(.*)$/) ?? [];
+      if (item) return `${item} ${field} ${value}`.trimEnd();
+      break;
+    }
+    case 'login': {
+      const [provider = ''] = read(/^([^:]+):/) ?? [];
+      if (provider) return `login (${provider})`;
+      break;
+    }
+    case 'merge': {
+      const [sha = '', only] = read(/^(?:ado|github):[^@]+@([0-9a-f]+)(?::for=(.+))?$/i) ?? [];
+      if (sha) return `runs of ${short(sha)}${only ? ` (${only})` : ''}`;
+      break;
+    }
+    case 'npm': {
+      const [pkg = '', version = '', tag = ''] = read(/^(.+)@([^@:]+):([^:]+)$/) ?? [];
+      if (pkg) return `npm ${version} on ${tag} (${last(pkg)})`;
+      break;
+    }
+    case 'pr': {
+      const [host = '', repo = '', number = '', on = ''] = read(/^(ado|github):([^#]+)#(\d+):(\w+)$/) ?? [];
+      // An ADO PR is in the project's own repo; a GitHub one names its repo.
+      if (host) return `PR #${number} ${PR_EVENTS[on] ?? on}${host === 'github' ? ` (${last(repo)})` : ''}`;
+      break;
+    }
+    case 'run': {
+      const [pipeline = '', id = ''] = read(/^(?:ado|github):(.+)#(\d+):done$/) ?? [];
+      if (pipeline) return `run #${id} to finish (${last(pipeline).replace(/\.ya?ml$/, '')})`;
+      break;
+    }
+    case 'time':
+      if (!Number.isNaN(Date.parse(rest))) return `timer, ${remaining(rest, now)} left`;
+      break;
   }
+  return condition;
 }
 
-export function workerDoing(w: ConductorWorker): string {
-  return w.waits[0] ?? w.activity;
+// What a worker waits on, in words (and how many more waits), else the session's activity.
+export function workerDoing(w: ConductorWorker, now: number): string {
+  const [first, ...more] = w.waits;
+  if (first === undefined) return w.activity;
+  return `${waitLabel(first, now)}${more.length > 0 ? ` +${more.length}` : ''}`;
+}
+
+const PHASE_MAX = 13;
+const DOING_MIN = 12;
+const DOING_SHORT = 6;
+const AGE_WIDTH = 4;
+
+// "now", "12m", "3h", "2d".
+export function age(iso: string, now: number): string {
+  const minutes = Math.floor((now - Date.parse(iso)) / 60_000);
+  if (!(minutes >= 1)) return 'now';
+  if (minutes < 60) return `${minutes}m`;
+  if (minutes < 24 * 60) return `${Math.floor(minutes / 60)}h`;
+  return `${Math.floor(minutes / (24 * 60))}d`;
+}
+
+// The error an API answer carries (`{ error, details }`), as one line.
+export function errorOf(answer: ApiAnswer): string {
+  const { body } = answer;
+  if (isRecord(body) && typeof body.error === 'string') return [body.error, ...strings(body.details)].join('; ');
+  return `the conductor answered ${answer.status}`;
 }
 
 // The open plan of `ref` (as `conduct approve` finds it): an item key, or an inbox id as #12.
@@ -214,6 +319,51 @@ export function findWorker(workers: readonly ConductorWorker[], ref: string): Fo
   return { error: `"${ref}" names several workers: ${matches.map((w) => `${w.name} in ${w.project}`).join(', ')}` };
 }
 
+export function fleetColumns(workers: readonly ConductorWorker[]): FleetColumns {
+  const widest = (texts: string[]): number => Math.max(0, ...texts.map((t) => t.length));
+  return {
+    key: widest(workers.map((w) => w.name)),
+    phase: Math.min(PHASE_MAX, widest(workers.map((w) => w.phase ?? ''))),
+    pr: widest(workers.map((w) => prLabel(w.pr))),
+  };
+}
+
+// The row in `width` cells: glyph, name, phase, PR, what it does or waits on, age. Where they don't
+// all fit, the age goes first, then the doing text, then the PR, then the phase. Which columns show
+// depends only on the fleet's widths, so every row keeps the same ones.
+export function fleetRow(w: ConductorWorker, columns: FleetColumns, width: number, now: number): FleetRow {
+  const key = Math.max(1, Math.min(columns.key, width - 2));
+  // In the order the row draws them.
+  /* eslint-disable perfectionist/sort-maps */
+  const shown = new Map<'age' | 'doing' | 'phase' | 'pr', number>([
+    ['phase', columns.phase],
+    ['pr', columns.pr],
+    ['doing', DOING_MIN],
+    ['age', AGE_WIDTH],
+  ]);
+  /* eslint-enable perfectionist/sort-maps */
+  for (const [column, cells] of shown) if (cells === 0 && column !== 'doing') shown.delete(column);
+  const need = (): number => 2 + key + [...shown.values()].reduce((sum, cells) => sum + cells + 1, 0);
+  for (const column of ['age', 'doing', 'pr', 'phase'] as const) if (need() > width) shown.delete(column);
+  // The doing text comes back in what room is left, while that still shows a few words.
+  if (!shown.has('doing') && width - need() - 1 >= DOING_SHORT) shown.set('doing', width - need() - 1);
+  const cell = (column: 'age' | 'doing' | 'phase' | 'pr', text: string): string => {
+    const cells = shown.get(column);
+    if (cells === undefined) return '';
+    return ` ${column === 'doing' ? fit(text, cells + Math.max(0, width - need())) : fit(text, cells)}`;
+  };
+  const { char, color } = GLYPHS[workerState(w)];
+  return {
+    age: shown.has('age') ? ` ${age(w.updatedAt, now).padStart(AGE_WIDTH)}` : '',
+    color,
+    doing: cell('doing', workerDoing(w, now)),
+    glyph: char,
+    isWait: w.waits.length > 0,
+    key: ` ${fit(w.name, key)}`,
+    meta: `${cell('phase', w.phase ?? '')}${cell('pr', prLabel(w.pr))}`,
+  };
+}
+
 // `/inbox`'s answer: one line per item, then its commands and links.
 export function inboxText(inbox: readonly ConductorInboxItem[], now: number): string {
   if (inbox.length === 0) return 'The inbox is empty.';
@@ -227,33 +377,65 @@ export function inboxText(inbox: readonly ConductorInboxItem[], now: number): st
     .join('\n');
 }
 
-// "now", "12m", "3h", "2d".
-export function age(iso: string, now: number): string {
-  const minutes = Math.floor((now - Date.parse(iso)) / 60_000);
-  if (!(minutes >= 1)) return 'now';
-  if (minutes < 60) return `${minutes}m`;
-  if (minutes < 24 * 60) return `${Math.floor(minutes / 60)}h`;
-  return `${Math.floor(minutes / (24 * 60))}d`;
-}
-
-// The time left until `iso`: "12m", "3h", "2d"; "<1m" when it is (almost) up.
-export function remaining(iso: string, now: number): string {
-  const minutes = Math.floor((Date.parse(iso) - now) / 60_000);
-  if (!(minutes >= 1)) return '<1m';
-  if (minutes < 60) return `${minutes}m`;
-  if (minutes < 24 * 60) return `${Math.floor(minutes / 60)}h`;
-  return `${Math.floor(minutes / (24 * 60))}d`;
+// A link the terminal's [open] hands to the OS opener (ATK-494): one a Link would make a link of,
+// an https: URL or http://localhost. Anything else, such as a path, stays a Link, drawn as text.
+export function isWebLink(href: string): boolean {
+  try {
+    const url = new URL(href);
+    return url.protocol === 'https:' || (url.protocol === 'http:' && url.hostname === 'localhost');
+  } catch {
+    return false;
+  }
 }
 
-// 950, 42k, 6.1M.
-export function tokens(n: number): string {
-  if (n < 1000) return String(n);
-  if (n < 1_000_000) return `${Math.round(n / 1000)}k`;
-  return `${(n / 1_000_000).toFixed(1)}M`;
+// GET /fleet's body, kept to the fields the mod draws; null when it isn't one.
+export function parseFleet(body: unknown): ConductorWorker[] | null {
+  if (!isRecord(body) || !Array.isArray(body.workers)) return null;
+  return body.workers.flatMap((w): ConductorWorker[] => {
+    if (!isRecord(w) || typeof w.id !== 'number' || typeof w.name !== 'string' || typeof w.status !== 'string')
+      return [];
+    const spend = isRecord(w.spend) && typeof w.spend.today === 'number' ? w.spend.today : 0;
+    const waits = Array.isArray(w.waits)
+      ? w.waits.flatMap((x) =>
+          isRecord(x) && typeof x.condition === 'string' && x.resolvedAt === null ? [x.condition] : [],
+        )
+      : [];
+    return [
+      {
+        activity: typeof w.activity === 'string' ? w.activity : w.status,
+        id: w.id,
+        item: typeof w.item === 'string' ? w.item : w.name,
+        name: w.name,
+        phase: typeof w.phase === 'string' ? w.phase : null,
+        pr: typeof w.pr === 'string' ? w.pr : null,
+        project: typeof w.project === 'string' ? w.project : '?',
+        spendToday: spend,
+        status: w.status,
+        updatedAt: typeof w.updatedAt === 'string' ? w.updatedAt : '',
+        waits,
+      },
+    ];
+  });
 }
 
-export function spendToday(workers: readonly ConductorWorker[]): number {
-  return workers.reduce((sum, w) => sum + w.spendToday, 0);
+// GET /inbox's body; null when it isn't one.
+export function parseInbox(body: unknown): ConductorInboxItem[] | null {
+  if (!isRecord(body) || !Array.isArray(body.items)) return null;
+  return body.items.flatMap((i): ConductorInboxItem[] => {
+    if (!isRecord(i) || typeof i.id !== 'number' || typeof i.kind !== 'string' || typeof i.text !== 'string') return [];
+    return [
+      {
+        commands: strings(i.commands),
+        id: i.id,
+        item: typeof i.item === 'string' ? i.item : null,
+        kind: i.kind,
+        links: links(i.links),
+        project: typeof i.project === 'string' ? i.project : null,
+        raisedAt: typeof i.raisedAt === 'string' ? i.raisedAt : '',
+        text: i.text,
+      },
+    ];
+  });
 }
 
 // One line of the follow stream, or null for anything that isn't an event object.
@@ -285,6 +467,9 @@ export function reaction(line: StreamLine): Reaction {
       return { kind: 'refresh', toast: null };
     case 'conduct.disconnected':
       return { kind: 'disconnected' };
+    case 'console.cache':
+    case 'watcher.stats':
+      return { kind: 'ignore' };
     case 'console.escalated': {
       const ask = text('text');
       // The id is what the console reports back on (`conduct escalations done <id>`).
@@ -313,9 +498,6 @@ export function reaction(line: StreamLine): Reaction {
         ? { kind: 'push', message }
         : { kind: 'ignore' };
     }
-    case 'console.cache':
-    case 'watcher.stats':
-      return { kind: 'ignore' };
     case 'worker.message-requested': {
       const to = text('to');
       const message = text('message');
@@ -326,61 +508,30 @@ export function reaction(line: StreamLine): Reaction {
   }
 }
 
-// GET /fleet's body, kept to the fields the mod draws; null when it isn't one.
-export function parseFleet(body: unknown): ConductorWorker[] | null {
-  if (!isRecord(body) || !Array.isArray(body.workers)) return null;
-  return body.workers.flatMap((w): ConductorWorker[] => {
-    if (!isRecord(w) || typeof w.id !== 'number' || typeof w.name !== 'string' || typeof w.status !== 'string')
-      return [];
-    const spend = isRecord(w.spend) && typeof w.spend.today === 'number' ? w.spend.today : 0;
-    const waits = Array.isArray(w.waits)
-      ? w.waits.flatMap((x) =>
-          isRecord(x) && typeof x.condition === 'string' && x.resolvedAt === null ? [x.condition] : [],
-        )
-      : [];
-    return [
-      {
-        activity: typeof w.activity === 'string' ? w.activity : w.status,
-        id: w.id,
-        item: typeof w.item === 'string' ? w.item : w.name,
-        name: w.name,
-        phase: typeof w.phase === 'string' ? w.phase : null,
-        pr: typeof w.pr === 'string' ? w.pr : null,
-        project: typeof w.project === 'string' ? w.project : '?',
-        spendToday: spend,
-        status: w.status,
-        updatedAt: typeof w.updatedAt === 'string' ? w.updatedAt : '',
-        waits,
-      },
-    ];
-  });
+// The time left until `iso`: "12m", "3h", "2d"; "<1m" when it is (almost) up.
+export function remaining(iso: string, now: number): string {
+  const minutes = Math.floor((Date.parse(iso) - now) / 60_000);
+  if (!(minutes >= 1)) return '<1m';
+  if (minutes < 60) return `${minutes}m`;
+  if (minutes < 24 * 60) return `${Math.floor(minutes / 60)}h`;
+  return `${Math.floor(minutes / (24 * 60))}d`;
 }
 
-// GET /inbox's body; null when it isn't one.
-export function parseInbox(body: unknown): ConductorInboxItem[] | null {
-  if (!isRecord(body) || !Array.isArray(body.items)) return null;
-  return body.items.flatMap((i): ConductorInboxItem[] => {
-    if (!isRecord(i) || typeof i.id !== 'number' || typeof i.kind !== 'string' || typeof i.text !== 'string') return [];
-    return [
-      {
-        commands: strings(i.commands),
-        id: i.id,
-        item: typeof i.item === 'string' ? i.item : null,
-        kind: i.kind,
-        links: links(i.links),
-        project: typeof i.project === 'string' ? i.project : null,
-        raisedAt: typeof i.raisedAt === 'string' ? i.raisedAt : '',
-        text: i.text,
-      },
-    ];
-  });
+export function spendToday(workers: readonly ConductorWorker[]): number {
+  return workers.reduce((sum, w) => sum + w.spendToday, 0);
 }
 
-// The error an API answer carries (`{ error, details }`), as one line.
-export function errorOf(answer: ApiAnswer): string {
-  const { body } = answer;
-  if (isRecord(body) && typeof body.error === 'string') return [body.error, ...strings(body.details)].join('; ');
-  return `the conductor answered ${answer.status}`;
+// 950, 42k, 6.1M.
+export function tokens(n: number): string {
+  if (n < 1000) return String(n);
+  if (n < 1_000_000) return `${Math.round(n / 1000)}k`;
+  return `${(n / 1_000_000).toFixed(1)}M`;
+}
+
+// `text` in exactly `cells` cells: padded, or cut with an ellipsis.
+function fit(text: string, cells: number): string {
+  if (text.length <= cells) return text.padEnd(cells);
+  return cells <= 1 ? '…'.slice(0, cells) : `${text.slice(0, cells - 1).trimEnd()}…`.padEnd(cells);
 }
 
 // What `conduct approve|revise` adds when the daemon can't say whether it posted the comment.
@@ -401,26 +552,11 @@ export function answerText(action: 'approve' | 'done' | 'revise', id: number, an
   return `${action === 'approve' ? 'approved' : 'asked for a revision of'} ${key}: ${where}`;
 }
 
-// A `conduct` run (attach, approve, revise) as the line to show: what it printed when it succeeded
-// (`woke …`, `approved …`), else `failed`, then its error and details without the `conduct: `
-// prefix, and without anything node wrote before it (a warning).
-export function runText(
-  run: { exitCode: number; stderr: string; stdout: string },
-  says: { failed: string; ok: string },
-): string {
-  const lines = (text: string): string[] =>
-    text
-      .split('\n')
-      .map((l) => l.trim())
-      .filter((l) => l !== '');
-  if (run.exitCode === 0) return lines(run.stdout).join('; ') || says.ok;
-  const stderr = lines(run.stderr);
-  const from = stderr.findIndex((l) => l.startsWith('conduct: '));
-  const error = stderr
-    .slice(Math.max(from, 0))
-    .map((l) => l.replace(/^conduct: /, ''))
-    .join('; ');
-  return `${says.failed}: ${error || `conduct exited ${run.exitCode}`}`;
+// The port and token files' text as an endpoint; null unless both are whole.
+export function endpointOf(portText: string, tokenText: string): null | { port: number; token: string } {
+  const port = Number(portText.trim());
+  const token = tokenText.trim();
+  return Number.isInteger(port) && port > 0 && /^[0-9a-f]{64}$/.test(token) ? { port, token } : null;
 }
 
 // The daemon's home as the CLI finds it (apps/conductor/src/paths.ts): CONDUCTOR_HOME, else
@@ -431,27 +567,15 @@ export function homeOf(env: { conductorHome?: string; home?: string; userProfile
   return user ? `${user.replace(/[\\/]+$/, '')}/.conductor` : null;
 }
 
-// The port and token files' text as an endpoint; null unless both are whole.
-export function endpointOf(portText: string, tokenText: string): { port: number; token: string } | null {
-  const port = Number(portText.trim());
-  const token = tokenText.trim();
-  return Number.isInteger(port) && port > 0 && /^[0-9a-f]{64}$/.test(token) ? { port, token } : null;
-}
-
-// GET /fleet, GET /inbox and GET /notify as one snapshot; `error` set when the daemon didn't answer
-// the first two. A daemon older than the notifier answers /notify 404, which leaves `notify` null.
-export function snapshotOf(fleet: ApiAnswer, inbox: ApiAnswer, readAt: number, notify?: ApiAnswer): ConductorSnapshot {
-  const workers = fleet.status === 200 ? parseFleet(fleet.body) : null;
-  if (workers === null) return { error: errorOf(fleet), inbox: [], notify: null, readAt, workers: [] };
-  const items = inbox.status === 200 ? parseInbox(inbox.body) : null;
-  if (items === null) return { error: errorOf(inbox), inbox: [], notify: null, readAt, workers: [] };
-  return {
-    error: null,
-    inbox: items,
-    notify: notify?.status === 200 ? parseNotify(notify.body) : null,
-    readAt,
-    workers,
-  };
+// `/notify <profile> [--until <when>]`: --until is a local time (the next one), a date (local
+// midnight) or a date and time, as `conduct notify profile` reads it.
+export function notifyArgs(args: string, now: number): { error: string } | { name: string; until: null | string } {
+  const typed = /^(\S+)(?:\s+--until\s+(\S+))?$/.exec(args.trim());
+  if (!typed?.[1]) return { error: 'usage: /notify [<profile> [--until <when>]]' };
+  const when = typed[2];
+  if (when === undefined) return { name: typed[1], until: null };
+  const until = untilOf(when, now);
+  return typeof until === 'string' ? { name: typed[1], until } : until;
 }
 
 // GET /notify's body, kept to what the mod draws; null when it isn't one.
@@ -494,41 +618,54 @@ export function pushOutcome(answer: unknown): PushOutcome {
   return { detail: detail || 'PushNotification said nothing about the phone', state: 'skipped' };
 }
 
-// `/notify <profile> [--until <when>]`: --until is a local time (the next one), a date (local
-// midnight) or a date and time, as `conduct notify profile` reads it.
-export function notifyArgs(args: string, now: number): { error: string } | { name: string; until: null | string } {
-  const typed = /^(\S+)(?:\s+--until\s+(\S+))?$/.exec(args.trim());
-  if (!typed?.[1]) return { error: 'usage: /notify [<profile> [--until <when>]]' };
-  const when = typed[2];
-  if (when === undefined) return { name: typed[1], until: null };
-  const until = untilOf(when, now);
-  return typeof until === 'string' ? { name: typed[1], until } : until;
+// A `conduct` run (attach, approve, revise) as the line to show: what it printed when it succeeded
+// (`woke …`, `approved …`), else `failed`, then its error and details without the `conduct: `
+// prefix, and without anything node wrote before it (a warning).
+export function runText(
+  run: { exitCode: number; stderr: string; stdout: string },
+  says: { failed: string; ok: string },
+): string {
+  const lines = (text: string): string[] =>
+    text
+      .split('\n')
+      .map((l) => l.trim())
+      .filter((l) => l !== '');
+  if (run.exitCode === 0) return lines(run.stdout).join('; ') || says.ok;
+  const stderr = lines(run.stderr);
+  const from = stderr.findIndex((l) => l.startsWith('conduct: '));
+  const error = stderr
+    .slice(Math.max(from, 0))
+    .map((l) => l.replace(/^conduct: /, ''))
+    .join('; ');
+  return `${says.failed}: ${error || `conduct exited ${run.exitCode}`}`;
+}
+
+// GET /fleet, GET /inbox and GET /notify as one snapshot; `error` set when the daemon didn't answer
+// the first two. A daemon older than the notifier answers /notify 404, which leaves `notify` null.
+export function snapshotOf(fleet: ApiAnswer, inbox: ApiAnswer, readAt: number, notify?: ApiAnswer): ConductorSnapshot {
+  const workers = fleet.status === 200 ? parseFleet(fleet.body) : null;
+  if (workers === null) return { error: errorOf(fleet), inbox: [], notify: null, readAt, workers: [] };
+  const items = inbox.status === 200 ? parseInbox(inbox.body) : null;
+  if (items === null) return { error: errorOf(inbox), inbox: [], notify: null, readAt, workers: [] };
+  return {
+    error: null,
+    inbox: items,
+    notify: notify?.status === 200 ? parseNotify(notify.body) : null,
+    readAt,
+    workers,
+  };
 }
 
 const DAYS = ['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'];
 
-// `--until <when>` as an ISO time: 17:00 (the next one), tomorrow or a day (local midnight), a date
-// (local midnight), or a date and time, as `conduct` reads them.
-export function untilOf(when: string, now: number): string | { error: string } {
-  const clock = /^([01]?\d|2[0-3]):([0-5]\d)$/.exec(when);
-  const lower = when.toLowerCase();
-  const day = DAYS.findIndex((d) => d === lower || d.slice(0, 3) === lower);
-  const at = new Date(now);
-  if (clock) {
-    at.setHours(Number(clock[1]), Number(clock[2]), 0, 0);
-    if (at.getTime() <= now) at.setDate(at.getDate() + 1);
-  } else if (lower === 'tomorrow' || day !== -1) {
-    at.setHours(0, 0, 0, 0);
-    at.setDate(at.getDate() + (lower === 'tomorrow' ? 1 : (day - at.getDay() + 7) % 7 || 7));
-  } else {
-    at.setTime(new Date(/^\d{4}-\d{2}-\d{2}$/.test(when) ? `${when}T00:00` : when).getTime());
-  }
-  if (Number.isNaN(at.getTime())) {
-    return {
-      error: `--until "${when}" is not a time: 17:00, tomorrow, a day such as monday, or a date and time such as 2026-10-12T09:00`,
-    };
-  }
-  return at.toISOString();
+// `/notify` with no profile: the profile, quiet hours, Remote Control.
+export function notifyText(notify: ConductorNotify | null, now: number): string {
+  if (notify === null) return 'the running conductor has no notifier: restart it on this build (conduct upgrade)';
+  const until = notify.profileUntil === null ? '' : ` for ${remaining(notify.profileUntil, now)} more`;
+  return [
+    `notify profile: ${notify.profile}${until} (profiles: ${notify.profiles.join(', ')}; /notify <profile> switches)`,
+    `Remote Control: ${notify.remoteControl}${notify.quietNow ? ` · quiet hours now, ${notify.held} held for the summary` : ''}`,
+  ].join('\n');
 }
 
 // `/pause [<project>] [--until <when>]`, `/unpause [<project>]` and `/focus-project <project> [--until
@@ -586,6 +723,38 @@ export function overrideText(
   return `${who} goes first${until}`;
 }
 
+// POST /notify/profile's answer as the line to show.
+export function profileText(name: string, answer: ApiAnswer, now: number): string {
+  if (answer.status !== 200) return `notify profile not switched: ${errorOf(answer)}`;
+  const notify = parseNotify(answer.body);
+  const until = notify?.profileUntil ? ` for ${remaining(notify.profileUntil, now)}` : '';
+  return `notify profile: ${notify?.profile ?? name}${until}`;
+}
+
+// `--until <when>` as an ISO time: 17:00 (the next one), tomorrow or a day (local midnight), a date
+// (local midnight), or a date and time, as `conduct` reads them.
+export function untilOf(when: string, now: number): string | { error: string } {
+  const clock = /^([01]?\d|2[0-3]):([0-5]\d)$/.exec(when);
+  const lower = when.toLowerCase();
+  const day = DAYS.findIndex((d) => d === lower || d.slice(0, 3) === lower);
+  const at = new Date(now);
+  if (clock) {
+    at.setHours(Number(clock[1]), Number(clock[2]), 0, 0);
+    if (at.getTime() <= now) at.setDate(at.getDate() + 1);
+  } else if (lower === 'tomorrow' || day !== -1) {
+    at.setHours(0, 0, 0, 0);
+    at.setDate(at.getDate() + (lower === 'tomorrow' ? 1 : (day - at.getDay() + 7) % 7 || 7));
+  } else {
+    at.setTime(new Date(/^\d{4}-\d{2}-\d{2}$/.test(when) ? `${when}T00:00` : when).getTime());
+  }
+  if (Number.isNaN(at.getTime())) {
+    return {
+      error: `--until "${when}" is not a time: 17:00, tomorrow, a day such as monday, or a date and time such as 2026-10-12T09:00`,
+    };
+  }
+  return at.toISOString();
+}
+
 // GET /why?item=…'s answer: the rule behind the item's newest action, in one line.
 export function whyText(item: string, answer: ApiAnswer): string {
   if (answer.status === 404)
@@ -605,24 +774,6 @@ export function whyText(item: string, answer: ApiAnswer): string {
   return `${item}: ${what}${rule.ref}${text}`;
 }
 
-// `/notify` with no profile: the profile, quiet hours, Remote Control.
-export function notifyText(notify: ConductorNotify | null, now: number): string {
-  if (notify === null) return 'the running conductor has no notifier: restart it on this build (conduct upgrade)';
-  const until = notify.profileUntil === null ? '' : ` for ${remaining(notify.profileUntil, now)} more`;
-  return [
-    `notify profile: ${notify.profile}${until} (profiles: ${notify.profiles.join(', ')}; /notify <profile> switches)`,
-    `Remote Control: ${notify.remoteControl}${notify.quietNow ? ` · quiet hours now, ${notify.held} held for the summary` : ''}`,
-  ].join('\n');
-}
-
-// POST /notify/profile's answer as the line to show.
-export function profileText(name: string, answer: ApiAnswer, now: number): string {
-  if (answer.status !== 200) return `notify profile not switched: ${errorOf(answer)}`;
-  const notify = parseNotify(answer.body);
-  const until = notify?.profileUntil ? ` for ${remaining(notify.profileUntil, now)}` : '';
-  return `notify profile: ${notify?.profile ?? name}${until}`;
-}
-
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === 'object' && value !== null && !Array.isArray(value);
 }