@detergent-software/conductor 2.2.0-dev.1 → 2.2.0-dev.3

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;
 
-// `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}`;
-}
+// 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,10 +156,13 @@ export function projectGroups(workers: readonly ConductorWorker[]): ProjectGroup
     }));
 }
 
-// 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';
+// `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';
@@ -193,6 +193,22 @@ export function prLabel(pr: null | string): string {
 
 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.
@@ -200,7 +216,7 @@ 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): string[] | null => pattern.exec(rest)?.slice(1) ?? null;
+  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)) {
@@ -256,27 +272,53 @@ export function workerDoing(w: ConductorWorker, now: number): string {
   return `${waitLabel(first, now)}${more.length > 0 ? ` +${more.length}` : ''}`;
 }
 
-// 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;
-};
-
 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.
+export function findPlan(inbox: readonly ConductorInboxItem[], ref: string): Found<ConductorInboxItem> {
+  const byId = /^#(\d+)$/.exec(ref.trim());
+  if (byId) {
+    const item = inbox.find((i) => i.id === Number(byId[1]));
+    return item ? { found: item } : { error: `no open inbox item ${ref}` };
+  }
+  if (/^\d+$/.test(ref.trim()))
+    return {
+      error: `"${ref}" is ambiguous: name the item, such as ATK-${ref.trim()}, or the inbox id as #${ref.trim()}`,
+    };
+  const plans = inbox.filter((i) => i.kind === 'plan' && i.item?.toUpperCase() === ref.trim().toUpperCase());
+  if (plans.length === 1 && plans[0]) return { found: plans[0] };
+  if (plans.length === 0) return { error: `no plan of ${ref} waits in the inbox` };
+  return { error: `several plans of ${ref} wait: name one as ${plans.map((p) => `#${p.id}`).join(' or ')}` };
+}
+
+// A worker in flight by name or item; a name match wins, as `conduct attach` finds it.
+export function findWorker(workers: readonly ConductorWorker[], ref: string): Found<ConductorWorker> {
+  const byName = workers.filter((w) => w.name === ref);
+  const matches = byName.length > 0 ? byName : workers.filter((w) => w.item.toUpperCase() === ref.toUpperCase());
+  if (matches.length === 1 && matches[0]) return { found: matches[0] };
+  if (matches.length === 0) return { error: `no worker "${ref}" in flight` };
+  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 {
@@ -291,12 +333,15 @@ export function fleetColumns(workers: readonly ConductorWorker[]): FleetColumns
 // 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);
@@ -319,10 +364,17 @@ export function fleetRow(w: ConductorWorker, columns: FleetColumns, width: numbe
   };
 }
 
-// `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);
+// `/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.';
+  return inbox
+    .flatMap((i) => [
+      `#${i.id}  ${i.kind}  ${i.item ?? ''}${i.project ? ` (${i.project})` : ''}  ${age(i.raisedAt, now)}`,
+      `    ${i.text}`,
+      ...i.commands.map((c) => `    $ ${c}`),
+      ...i.links.map((l) => `    ${l.label}: ${l.href}`),
+    ])
+    .join('\n');
 }
 
 // A link the terminal's [open] hands to the OS opener (ATK-494): one a Link would make a link of,
@@ -336,89 +388,71 @@ export function isWebLink(href: string): boolean {
   }
 }
 
-// The open plan of `ref` (as `conduct approve` finds it): an item key, or an inbox id as #12.
-export function findPlan(inbox: readonly ConductorInboxItem[], ref: string): Found<ConductorInboxItem> {
-  const byId = /^#(\d+)$/.exec(ref.trim());
-  if (byId) {
-    const item = inbox.find((i) => i.id === Number(byId[1]));
-    return item ? { found: item } : { error: `no open inbox item ${ref}` };
-  }
-  if (/^\d+$/.test(ref.trim()))
-    return {
-      error: `"${ref}" is ambiguous: name the item, such as ATK-${ref.trim()}, or the inbox id as #${ref.trim()}`,
-    };
-  const plans = inbox.filter((i) => i.kind === 'plan' && i.item?.toUpperCase() === ref.trim().toUpperCase());
-  if (plans.length === 1 && plans[0]) return { found: plans[0] };
-  if (plans.length === 0) return { error: `no plan of ${ref} waits in the inbox` };
-  return { error: `several plans of ${ref} wait: name one as ${plans.map((p) => `#${p.id}`).join(' or ')}` };
+// 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,
+      },
+    ];
+  });
 }
 
-// A worker in flight by name or item; a name match wins, as `conduct attach` finds it.
-export function findWorker(workers: readonly ConductorWorker[], ref: string): Found<ConductorWorker> {
-  const byName = workers.filter((w) => w.name === ref);
-  const matches = byName.length > 0 ? byName : workers.filter((w) => w.item.toUpperCase() === ref.toUpperCase());
-  if (matches.length === 1 && matches[0]) return { found: matches[0] };
-  if (matches.length === 0) return { error: `no worker "${ref}" in flight` };
-  return { error: `"${ref}" names several workers: ${matches.map((w) => `${w.name} in ${w.project}`).join(', ')}` };
+// 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,
+      },
+    ];
+  });
 }
 
-// `/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.';
-  return inbox
-    .flatMap((i) => [
-      `#${i.id}  ${i.kind}  ${i.item ?? ''}${i.project ? ` (${i.project})` : ''}  ${age(i.raisedAt, now)}`,
-      `    ${i.text}`,
-      ...i.commands.map((c) => `    $ ${c}`),
-      ...i.links.map((l) => `    ${l.label}: ${l.href}`),
-    ])
-    .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`;
-}
-
-// 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`;
-}
-
-export function spendToday(workers: readonly ConductorWorker[]): number {
-  return workers.reduce((sum, w) => sum + w.spendToday, 0);
-}
-
-// One line of the follow stream, or null for anything that isn't an event object.
-export function parseLine(line: string): null | StreamLine {
-  let value: unknown;
-  try {
-    value = JSON.parse(line);
-  } catch {
-    return null;
-  }
-  if (!isRecord(value) || typeof value.kind !== 'string') return null;
-  return {
-    data: isRecord(value.data) ? value.data : {},
-    id: typeof value.id === 'number' ? value.id : null,
-    kind: value.kind,
-    subject: typeof value.subject === 'string' ? value.subject : null,
-  };
+// One line of the follow stream, or null for anything that isn't an event object.
+export function parseLine(line: string): null | StreamLine {
+  let value: unknown;
+  try {
+    value = JSON.parse(line);
+  } catch {
+    return null;
+  }
+  if (!isRecord(value) || typeof value.kind !== 'string') return null;
+  return {
+    data: isRecord(value.data) ? value.data : {},
+    id: typeof value.id === 'number' ? value.id : null,
+    kind: value.kind,
+    subject: typeof value.subject === 'string' ? value.subject : null,
+  };
 }
 
 // What an event asks of the mod. Remote Control pushes, escalations and worker messages are
@@ -433,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>`).
@@ -461,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');
@@ -474,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.
@@ -549,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
@@ -579,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.
@@ -642,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
@@ -734,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)
@@ -753,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);
 }