@pellux/goodvibes-tui 2.0.20 → 2.1.0

package/src/panels/fleet-panel.ts

@@ -1,799 +0,0 @@
-// ---------------------------------------------------------------------------
-// fleet-panel.ts
-//
-//, FleetPanel: the live unified observability tree. Renders the
-// registered process fleet (agents incl. WRFC roles, WRFC chains/subtasks,
-// workflow-tool FSMs, watchers, background processes) as a depth-first tree
-// with a selected-row detail region. Session tabs (Part C): Enter on an
-// attachable node (agent/wrfc-chain) opens a tab with that process's
-// transcript/member summary, see fleet-tabs.ts + fleet-transcript.ts. This
-// file owns input dispatch and layout; fleet-deep-link.ts owns the
-// cross-panel jump target (item 4).
-// ---------------------------------------------------------------------------
-
-import { readFile } from 'node:fs/promises';
-import type { Line } from '@pellux/goodvibes-sdk/platform/types';
-import type { SteerResult } from '@pellux/goodvibes-sdk/platform/runtime/fleet';
-import type { ConversationMessageSnapshot } from '@pellux/goodvibes-sdk/platform/core';
-import type { ConfigManager } from '@pellux/goodvibes-sdk/platform/config';
-import { ScrollableListPanel } from './scrollable-list-panel.ts';
-import { PanelConfirmOverlay } from './panel-confirm-overlay.ts';
-import { isPanelSearchBackspace, isPanelSearchCancel, isPanelSearchCommit, isPanelSearchPrintable } from './search-focus.ts';
-import { buildKeyboardHints, buildPanelWorkspace, buildSearchInputLine, DEFAULT_PANEL_PALETTE, getPanelWorkspaceContentBudget, type PanelPalette } from './polish.ts';
-import {
-  isBlockedOnUserNode,
-  isRunningProcessState,
-  isTerminalProcessState,
-  type FleetReadModel,
-  type FleetTreeRow,
-} from './fleet-read-model.ts';
-import type { FleetActs } from './fleet-acts.ts';
-import type { FleetSpawn } from './fleet-spawn.ts';
-import {
-  activeFleetTab,
-  appendSteerText,
-  attachFleetTab,
-  detachActiveFleetTab,
-  EMPTY_FLEET_TABS_STATE,
-  isAttachableFleetKind,
-  stepFleetTab,
-  type FleetTab,
-  type FleetTabsState,
-  type SteerBadge,
-} from './fleet-tabs.ts';
-import { liveSteerableLabels, reconcileSteerBadges as reconcileSteerBadgesPure, renderSteerBadgeLine, steerRefusalMessage } from './fleet-steer.ts';
-import { FleetStopTracker, toggleFleetPause, buildFleetTreeHints, fleetKillConfirmArgs } from './fleet-stop.ts';
-import { resolveFleetDeepLinkIndex } from './fleet-deep-link.ts';
-import { parseAgentLedger, renderFleetAgentTranscript, renderFleetChainSummary, renderFleetLedgerFallback, renderFleetTranscriptLoading } from './fleet-transcript.ts';
-import { renderFleetTabStrip } from '../renderer/fleet-tab-strip.ts';
-import { renderFleetDetailLines, renderFleetRowLine } from './fleet-panel-format.ts';
-
-const C = DEFAULT_PANEL_PALETTE;
-
-export interface FleetActionCallbacks {
-  /** Graceful interruption (AgentManager.cancel / trigger-schedule disable, via the registry). */
-  readonly interrupt: (id: string) => boolean;
-  /** Re-arm a `paused` node (disabled trigger/schedule or automation job), interrupt()'s inverse. Honest false when not paused / non-resumable. */
-  readonly resume: (id: string) => boolean;
-  /** Hard stop, optionally cascading to killable descendants. Returns the node ids acted on. */
-  readonly kill: (id: string, opts: { readonly cascade: boolean }) => readonly string[];
-  /**
-   * Fetch an agent's conversation history, live (running) or
-   * frozen (just-completed, still in the SDK's retention ring). Empty array
-   * means "unavailable" (evicted, or never registered), FleetPanel degrades
-   * to the on-disk ledger fallback in that case, never fabricating content.
-   */
-  readonly getConversationSnapshot: (agentId: string) => readonly ConversationMessageSnapshot[];
-  /** Resolve the on-disk `<agentId>.jsonl` event-ledger path for the degraded fallback view. */
-  readonly resolveSessionLogPath: (agentId: string) => string;
-  /**
-   * Queue a human message for a live in-process agent (or a
-   * wrfc-subtask's current live member agent), delivered at the target's
-   * next turn boundary, never mid-token. Honest refusal
-   * (`{queued:false,reason}`) for anything that cannot take mid-run input
-   * (terminal nodes, non-agent kinds, the wrfc-chain coordinator itself).
-   */
-  readonly steer: (id: string, text: string) => SteerResult;
-}
-
-const NOOP_ACTIONS: FleetActionCallbacks = {
-  interrupt: (_id: string) => false,
-  resume: (_id: string) => false,
-  kill: (_id: string, _opts: { readonly cascade: boolean }) => [],
-  getConversationSnapshot: (_agentId: string) => [],
-  resolveSessionLogPath: (agentId: string) => agentId,
-  steer: (_id: string, _text: string) => ({ queued: false, reason: 'no live registry' }),
-};
-
-export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
-  private readonly unsub: () => void;
-  private readonly unsubConsumed: () => void;
-  private readonly actions: FleetActionCallbacks;
-  private readonly confirmOverlay: PanelConfirmOverlay;
-  private follow = false;
-  /** Tree view mode: the live fleet, or the session archive of finished subtrees. */
-  private viewMode: 'active' | 'archived' = 'active';
-  private tabsState: FleetTabsState = EMPTY_FLEET_TABS_STATE;
-  private tickTimer: ReturnType<typeof setInterval> | null = null;
-  /**
-   * The node id the cursor is anchored to, independent of its row index.
-   * `selectedIndex` is a plain offset into `getItems()`'s current (rebuilt-every-
-   * snapshot) order, so a stale index silently drifts; `reanchorSelection()`
-   * re-locates this id each snapshot and repoints selectedIndex. null means "no
-   * anchor yet" (base class index-0 default until first navigation/tick).
-   */
-  private selectedNodeId: string | null = null;
-
-  /** d1: the "stopping…" write-window overlay tracker (see fleet-stop.ts). */
-  private readonly stopTracker = new FleetStopTracker();
-
-  public constructor(
-    private readonly readModel: FleetReadModel,
-    actions: Partial<FleetActionCallbacks> = {},
-    private readonly configManager: ConfigManager | null = null,
-    // The waiting-on-human acts (pick / conflict / discard). Null in a runtime
-    // with no daemon gateway wired, those keys then fall through honestly.
-    private readonly acts: FleetActs | null = null,
-    // The ACP spawn affordance ('n' hosts a discovered third-party agent); null with no gateway wired.
-    private readonly spawn: FleetSpawn | null = null,
-  ) {
-    super('fleet', 'Fleet', '⊟', 'runtime-ops');
-    this.showSelectionGutter = true; // visible ▸ focus indicator
-    this.actions = { ...NOOP_ACTIONS, ...actions };
-    this.confirmOverlay = new PanelConfirmOverlay(() => this.markDirty());
-    this.unsub = readModel.subscribe(() => {
-      this.reanchorSelection();
-      this.applyFollow();
-      this.reconcileSteerBadges();
-      this.markDirty();
-    });
-    // The honest "the agent actually consumed this steer at
-    // its turn boundary" signal, see fleet-tabs.ts's SteerBadgeStatus doc.
-    // A read-model without a runtimeBus dep never invokes this (graceful
-    // no-op), same degrade as steer()/steerable without a messageBus dep.
-    this.unsubConsumed = readModel.subscribeConsumed((event) => {
-      let changed = false;
-      for (const tab of this.tabsState.tabs) {
-        const badge = tab.steerBadge;
-        if (!badge || badge.messageId !== event.messageId) continue;
-        // Consumed-wins: this real signal can still upgrade an already
-        // 'dropped' (inferred) badge, as long as it hasn't linger-cleared yet.
-        if (badge.status === 'queued' || badge.status === 'dropped') {
-          tab.steerBadge = { messageId: badge.messageId, status: 'consumed', queuedAt: badge.queuedAt, resolvedAt: Date.now() };
-          changed = true;
-        }
-      }
-      if (changed) this.markDirty();
-    });
-  }
-
-  public override onActivate(): void {
-    super.onActivate();
-    // Time-derived fields (elapsed, follow target) stay live even when no
-    // registry tick fires while this panel is on screen (cockpit-panel.ts
-    // STALL_TICK_MS precedent). Also re-anchors defensively in case the
-    // underlying list changed without a subscribe notification.
-    if (this.tickTimer === null) {
-      this.tickTimer = this.registerTimer(setInterval(() => {
-        this.reanchorSelection();
-        this.applyFollow();
-        this.reconcileSteerBadges();
-        this.markDirty();
-      }, 1000));
-    }
-  }
-
-  public override onDeactivate(): void {
-    super.onDeactivate();
-    if (this.tickTimer !== null) {
-      this.clearTimer(this.tickTimer);
-      this.tickTimer = null;
-    }
-  }
-
-  public override onDestroy(): void {
-    super.onDestroy();
-    this.unsub();
-    this.unsubConsumed();
-    for (const tab of this.tabsState.tabs) tab.lineCache.clear();
-  }
-
-  /** True while a session tab (not the root tree) is focused. Replaces the old isDetailFocused() seam. */
-  public isTabActive(): boolean {
-    return this.tabsState.activeTabIndex > 0;
-  }
-
-  /**
-   * True while the steer composer on the active tab is open,
-   * every character of a burst (paste, or several fast-typed chars in one
-   * stdin chunk) must land in the draft one at a time rather than being
-   * routed away as panel hotkeys or exploded to the main composer. See
-   * Panel.isCapturingTextBurst's doc comment and git-panel.ts's
-   * `commitMessage` precedent.
-   */
-  public override isCapturingTextBurst(): boolean {
-    const tab = activeFleetTab(this.tabsState);
-    return tab !== null && tab.steerDraft !== null;
-  }
-
-  /** Introspection for tests: the current tab-bar state (read-only). */
-  public getTabsState(): FleetTabsState {
-    return this.tabsState;
-  }
-
-  public isFollowing(): boolean {
-    return this.follow;
-  }
-
-  /**
-   * Ctrl+X (panel-close) collision resolution: the global
-   * shortcut route (handler-shortcuts.ts) calls this BEFORE closing the
-   * panel. Detaching the active tab consumes the key; on the root tree tab
-   * there is nothing to detach, so this returns false and Ctrl+X falls
-   * through to its ordinary panel-close behavior.
-   */
-  public interceptPanelClose(): boolean {
-    if (this.tabsState.activeTabIndex === 0) return false;
-    this.tabsState = detachActiveFleetTab(this.tabsState);
-    this.markDirty();
-    return true;
-  }
-
-  protected getItems(): readonly FleetTreeRow[] {
-    return this.viewMode === 'archived'
-      ? this.readModel.getArchivedSnapshot().rows
-      : this.readModel.getSnapshot().rows;
-  }
-
-  protected override getPalette(): PanelPalette {
-    return C;
-  }
-
-  protected override getEmptyStateMessage(): string {
-    return this.viewMode === 'archived'
-      ? ' Archive is empty: press a on a finished process (or A for all) to move it here.'
-      : ' No processes tracked yet.';
-  }
-
-  /**
-   * (cross-restart honesty): a restart starts from an empty `AgentManager` Map
-   * (no bridge from a prior registry), so a completed process from a previous
-   * session can never reappear here, a real, permanent limitation, documented
-   * rather than implying "nothing has ever run" or that a restart brings it back.
-   */
-  protected override getEmptyStateActions(): Array<{ command: string; summary: string }> {
-    return [
-      {
-        command: 'previous sessions',
-        summary: "not shown here: this list resets on TUI restart; each agent's .goodvibes/tui/sessions/<id>.jsonl event log still persists on disk",
-      },
-    ];
-  }
-
-  private applyFollow(): void {
-    if (!this.follow) return;
-    const rows = this.getItems();
-    if (rows.length === 0) return;
-    let bestIdx = -1;
-    let bestStarted = -Infinity;
-    rows.forEach((row, idx) => {
-      if (!isRunningProcessState(row.node.state)) return;
-      const started = row.node.startedAt ?? -Infinity;
-      if (started >= bestStarted) {
-        bestStarted = started;
-        bestIdx = idx;
-      }
-    });
-    if (bestIdx >= 0) {
-      this.selectedIndex = bestIdx;
-      this.selectedNodeId = rows[bestIdx]!.node.id;
-      this.needsRender = true;
-    }
-  }
-
-  /** Record the current selection's node id as the anchor for future snapshot updates. */
-  private captureSelectionAnchor(): void {
-    const item = this.getSelectedItem();
-    this.selectedNodeId = item ? item.node.id : null;
-  }
-
-  /**
-   * Re-locate `selectedNodeId` in the current snapshot and repoint
-   * `selectedIndex` at it, so the selection follows a specific process across
-   * adds/removes/reorders instead of drifting onto whatever row occupies the old
-   * index. When the anchored node is gone (pruned), or no anchor exists yet,
-   * falls back to clampSelection() (nearest valid index) and re-anchors there.
-   */
-  private reanchorSelection(): void {
-    const rows = this.getItems();
-    if (this.selectedNodeId !== null) {
-      const idx = rows.findIndex((row) => row.node.id === this.selectedNodeId);
-      if (idx >= 0) {
-        this.selectedIndex = idx;
-        return;
-      }
-    }
-    this.clampSelection();
-    this.captureSelectionAnchor();
-  }
-
-  /** Find a node's live ProcessNode in the current snapshot, or null (pruned/never registered). */
-  private findLiveNode(nodeId: string): FleetTreeRow['node'] | null {
-    return this.getItems().find((row) => row.node.id === nodeId)?.node ?? null;
-  }
-
-  /** item 4 (see fleet-deep-link.ts). */
-  public receiveDeepLink(target: { readonly id: string; readonly kind?: string }): void {
-    const idx = resolveFleetDeepLinkIndex(this.getItems(), target);
-    if (idx < 0) { this.setError('node no longer present.'); return; }
-    // A successful reveal must be VISIBLE: with a session tab active, render()
-    // routes to the tab view and the selection change would be silently
-    // swallowed (batch refutation finding 1), return to the tree first
-    // (tabs kept; only the active view switches).
-    this.tabsState = { tabs: this.tabsState.tabs, activeTabIndex: 0 };
-    this.clearError(); this.selectedIndex = idx; this.selectedNodeId = target.id; this.markDirty();
-  }
-
-  /**
-   * Focus the next node blocked on the operator (awaiting approval/input),
-   * cycling in display order and wrapping. Resolves against the LIVE fleet
-   * (blocked nodes never live in the archive) and returns to the tree view from
-   * any attached tab so the reveal is visible (receiveDeepLink's contract).
-   * Honest no-op message when nothing waits; always consumes 'b' (returns true).
-   */
-  private jumpToNextBlocked(): boolean {
-    const snapshot = this.readModel.getSnapshot();
-    const blockedIds = snapshot.blockedNodeIds;
-    if (blockedIds.length === 0) {
-      this.setError('Nothing is blocked on you right now.');
-      this.markDirty();
-      return true;
-    }
-    // Pick the blocked id strictly after the current anchor (wrapping), so
-    // repeated presses cycle through every waiting node. Anchor on whatever row
-    // is actually selected right now (the base class defaults the cursor to
-    // row 0 before any explicit navigation sets selectedNodeId), so the first
-    // press already advances past a blocked node the cursor happens to sit on.
-    const anchorId = this.getSelectedItem()?.node.id ?? this.selectedNodeId;
-    const currentPos = anchorId === null || anchorId === undefined ? -1 : blockedIds.indexOf(anchorId);
-    const nextId = blockedIds[(currentPos + 1) % blockedIds.length]!;
-    // Reveal in the live tree: leave the archive view and any active session tab.
-    this.viewMode = 'active';
-    this.tabsState = { tabs: this.tabsState.tabs, activeTabIndex: 0 };
-    const idx = snapshot.rows.findIndex((row) => row.node.id === nextId);
-    if (idx >= 0) {
-      this.selectedIndex = idx;
-      this.selectedNodeId = nextId;
-    }
-    this.clearError();
-    this.markDirty();
-    return true;
-  }
-
-  /**
-   * The "dropped inference" reconciliation: called on every read-model
-   * snapshot update and on the panel's 1s tick. See fleet-steer.ts's
-   * reconcileSteerBadges doc for why this is needed (the SDK emits no
-   * cancelled/expired signal for a queued steer).
-   */
-  private reconcileSteerBadges(): void {
-    if (this.tabsState.tabs.length === 0) return;
-    const changed = reconcileSteerBadgesPure(this.tabsState.tabs, (id) => this.findLiveNode(id), Date.now());
-    if (changed) this.markDirty();
-  }
-
-  /** Kick off (once) the async ledger-fallback load for a tab whose conversation snapshot is unavailable. */
-  private ensureLedgerLoaded(tab: FleetTab): void {
-    if (tab.ledgerLoadStarted) return;
-    tab.ledgerLoadStarted = true;
-    const path = this.actions.resolveSessionLogPath(tab.agentId);
-    readFile(path, 'utf-8')
-      .then((raw) => {
-        tab.ledgerEntries = parseAgentLedger(raw);
-        this.markDirty();
-      })
-      .catch(() => {
-        tab.ledgerEntries = [];
-        this.markDirty();
-      });
-  }
-
-  public override handleInput(key: string): boolean {
-    if (this.lastError !== null) this.clearError();
-
-    // The candidate picker (a flagged pick decision) owns the view + input while active.
-    if (this.acts?.pickModeActive()) return this.acts.handlePickInput(key);
-    // The observed-agent steer composer (a drill-in) likewise owns EVERY key until Enter/Esc.
-    if (this.acts?.observedSteerActive()) return this.acts.handleObservedSteerInput(key);
-    // The ACP spawn picker (host a third-party agent) likewise owns view + input.
-    if (this.spawn?.spawnModeActive()) return this.spawn.handleSpawnInput(key);
-
-    // Confirm overlay owns input first (K-armed kill confirm).
-    if (this.confirmOverlay.handleInput(key)) return true;
-
-    // Once the steer composer is open on the active tab, it
-    // owns EVERY key (same full-priority-while-composing contract as
-    // git-panel.ts's commitMessage entry) until Enter (submit) or Esc
-    // (cancel), a burst/paste and single hotkeys like 'j'/'s'/'[' all land
-    // in the draft, never as tree/tab navigation (focus rule).
-    const composingTab = activeFleetTab(this.tabsState);
-    if (composingTab && composingTab.steerDraft !== null) {
-      return this.handleSteerInput(composingTab, key);
-    }
-
-    // Tab switching works from ANY view (root tree or an attached tab) once
-    // at least one tab is open, [ / ] step through Tree, tab 1, tab 2, ...
-    // Ctrl+X detach is handled by interceptPanelClose(), not handleInput (it
-    // must win a global-shortcut race, see that method's doc comment).
-    if ((key === '[' || key === ']') && this.tabsState.tabs.length > 0) {
-      this.tabsState = stepFleetTab(this.tabsState, key === ']' ? 1 : -1);
-      this.markDirty();
-      return true;
-    }
-
-    // Jump-to-blocked works from ANYWHERE in the panel (root tree OR an attached
-    // session tab): it steps to the next node waiting on the operator and
-    // reveals it in the live tree so the selection is actually visible.
-    if (key === 'b') {
-      return this.jumpToNextBlocked();
-    }
-
-    if (this.tabsState.activeTabIndex > 0) {
-      if (key === 's') {
-        return this.tryOpenSteerDraft(activeFleetTab(this.tabsState)!);
-      }
-      // A session tab is focused, the tree isn't visible, so tree-only keys
-      // (navigate/i/K/f/Enter) don't apply here.
-      return false;
-    }
-
-    const selected = this.getSelectedItem();
-
-    // Waiting-on-human acts on the selected row: Enter on a flagged pick/conflict
-    // row, D on a worktree-owning row. Returns false (falls through to attach /
-    // ordinary handling) for any other row, so Enter still opens an agent tab.
-    if (this.acts && selected && this.acts.handleTreeKey(key, selected.node)) {
-      this.captureSelectionAnchor();
-      return true;
-    }
-
-    // Host a third-party ACP agent: lists discovered agents, then a known dir,
-    // then spawns it as an acp-agent row. Quiet when none are discovered.
-    if (key === 'n' && this.spawn) { void this.spawn.begin(); return true; }
-
-    // Archive controls: v toggles the live fleet <-> session archive view;
-    // a archives the selected finished subtree (or restores it from the
-    // archive view); A archives every fully-finished root subtree.
-    if (key === 'v') {
-      this.viewMode = this.viewMode === 'active' ? 'archived' : 'active';
-      this.markDirty();
-      return true;
-    }
-    if (key === 'a') {
-      if (!selected) return false;
-      if (this.viewMode === 'archived') {
-        const restored = this.readModel.unarchive(selected.node.id);
-        if (restored === 0) this.setError('Nothing restored for this node.');
-        this.markDirty();
-        return true;
-      }
-      if (!isTerminalProcessState(selected.node.state)) {
-        this.setError('Only finished processes can be archived.');
-        return true;
-      }
-      const result = this.readModel.archive(selected.node.id);
-      if (!result.archived) this.setError(result.reason ?? 'Could not archive this process.');
-      this.markDirty();
-      return true;
-    }
-    if (key === 'A' && this.viewMode === 'active') {
-      const count = this.readModel.archiveFinished();
-      if (count === 0) this.setError('No fully-finished processes to archive.');
-      this.markDirty();
-      return true;
-    }
-
-    if (key === 'i') {
-      // Guard: only consume on a real, non-terminal node (cockpit-panel.ts
-      // precedent) so the key falls through when there is nothing to act on.
-      if (!selected || isTerminalProcessState(selected.node.state)) return false;
-      // Not every kind can be interrupted (only 'agent' nodes ever are, see
-      // the SDK's fleet adapters: schedule/trigger/watcher/workflow/
-      // wrfc-chain/wrfc-subtask/background-process all report
-      // capabilities.interruptible: false unconditionally). Consume the key
-      // and say so rather than silently calling interrupt() on a node the
-      // registry has no interrupt route for.
-      if (!selected.node.capabilities.interruptible) {
-        this.setError(`${selected.node.kind} does not support interrupt.`);
-        return true;
-      }
-      this.actions.interrupt(selected.node.id);
-      this.stopTracker.mark(selected.node.id);
-      this.markDirty();
-      return true;
-    }
-
-    if (key === 'K') {
-      if (!selected || isTerminalProcessState(selected.node.state)) return false;
-      // Observed foreign agents have killable:false, the refusal below reads
-      // honestly; goodvibes only observes them, so stop is never offered.
-      if (!selected.node.capabilities.killable) {
-        this.setError(`${selected.node.kind} does not support kill.`);
-        return true;
-      }
-      this.confirmOverlay.arm(fleetKillConfirmArgs(selected.node, this.getItems(), {
-        kill: (id) => this.actions.kill(id, { cascade: true }),
-        markStopping: (id) => this.stopTracker.mark(id),
-      }));
-      return true;
-    }
-
-    // d2: 'p' toggles pause<->resume by the selected node's state (see
-    // toggleFleetPause in fleet-stop.ts).
-    if (key === 'p') {
-      if (!selected) return false;
-      return toggleFleetPause(selected.node, {
-        interrupt: (id) => this.actions.interrupt(id),
-        resume: (id) => this.actions.resume(id),
-        setError: (m) => this.setError(m),
-        markDirty: () => this.markDirty(),
-        tracker: this.stopTracker,
-      });
-    }
-
-    if (key === 'f') {
-      this.follow = !this.follow;
-      if (this.follow) this.applyFollow();
-      this.markDirty();
-      return true;
-    }
-
-    if (key === 'enter' || key === 'return') {
-      if (!selected) return false;
-      const node = selected.node;
-      if (!isAttachableFleetKind(node.kind)) {
-        this.setError(`${node.kind} has no transcript to attach.`);
-        return true;
-      }
-      this.tabsState = attachFleetTab(this.tabsState, node);
-      this.markDirty();
-      return true;
-    }
-
-    if (key === 's') {
-      // An earlier replay fix: 's' from the TREE was silently dead, steering
-      // required an undiscoverable Enter-attach first. Attach-and-steer in
-      // one press for a steerable node; honest refusal otherwise.
-      if (!selected) return false;
-      const node = selected.node;
-      // Observed foreign agents steer as a DRILL-IN only; that 's' is handled by
-      // acts.handleTreeKey above (opens the composer in the row's detail), so it
-      // never reaches this attach path.
-      // Closure replay note: a node that FINISHED in the hint→keypress race
-      // window must say so, "does not support steer" is misleading for an
-      // agent whose only problem is being done.
-      if (isTerminalProcessState(node.state)) {
-        this.setError(`${node.kind} already finished: nothing to steer.`);
-        return true;
-      }
-      if (!node.capabilities.steerable || !isAttachableFleetKind(node.kind)) {
-        this.setError(`${node.kind} does not support steer.`);
-        return true;
-      }
-      this.tabsState = attachFleetTab(this.tabsState, node);
-      this.markDirty();
-      return this.tryOpenSteerDraft(activeFleetTab(this.tabsState)!);
-    }
-
-    const consumed = super.handleInput(key);
-    if (consumed) this.captureSelectionAnchor();
-    return consumed;
-  }
-
-  /**
-   * The `s` gate, mirrors the i/K capability-gating template
-   * exactly (guard on the live node existing, non-terminal, and the specific
-   * capability; consume the key and say so rather than silently no-op-ing).
-   */
-  private tryOpenSteerDraft(tab: FleetTab): boolean {
-    const node = this.findLiveNode(tab.nodeId);
-    if (!node || isTerminalProcessState(node.state)) {
-      this.setError(`${node?.kind ?? tab.kind} already finished: nothing to steer.`);
-      return true;
-    }
-    if (!node.capabilities.steerable) {
-      this.setError(`${node.kind} does not support steering.`);
-      return true;
-    }
-    tab.steerDraft = '';
-    this.markDirty();
-    return true;
-  }
-
-  /** Dispatch for the open steer composer, mirrors git-panel.ts's handleCommitMessageInput. */
-  private handleSteerInput(tab: FleetTab, key: string): boolean {
-    if (isPanelSearchCancel(key)) {
-      tab.steerDraft = null;
-      this.markDirty();
-      return true;
-    }
-    if (isPanelSearchCommit(key)) {
-      const text = (tab.steerDraft ?? '').trim();
-      if (text.length === 0) {
-        tab.steerDraft = null;
-        this.markDirty();
-        return true;
-      }
-      // Clear the draft ONLY on a confirmed queue. A refusal keeps the composer
-      // open with the text intact (submitSteer explains why + suggests live targets)
-      // so the operator never loses what they typed to a just-idle agent.
-      if (this.submitSteer(tab, text)) tab.steerDraft = null;
-      this.markDirty();
-      return true;
-    }
-    if (isPanelSearchBackspace(key)) {
-      tab.steerDraft = (tab.steerDraft ?? '').slice(0, -1);
-      this.markDirty();
-      return true;
-    }
-    // Ordinary typing AND a pasted multi-line block's line-break characters
-    // (delivered one at a time through the same burst pipeline, see
-    // isCapturingTextBurst) both flow through appendSteerText, which
-    // normalizes \r/\n to a collapsed space instead of corrupting the
-    // one-line field or silently dropping the content.
-    if (key.length === 1 && (isPanelSearchPrintable(key) || key === '\r' || key === '\n')) {
-      tab.steerDraft = appendSteerText(tab.steerDraft ?? '', key);
-      this.markDirty();
-      return true;
-    }
-    return true; // absorb every other key while composing
-  }
-
-  /**
-   * Submit a composed steer message. Returns whether it was queued so the caller
-   * clears the draft only on a confirmed send (WO item 4): a refusal (target
-   * went idle while composing) PRESERVES the typed text and suggests which agents
-   * ARE steerable, instead of silently discarding the draft. On a successful queue
-   * the ⧗ badge line is the immediate honest acknowledgment.
-   */
-  private submitSteer(tab: FleetTab, text: string): boolean {
-    const result = this.actions.steer(tab.nodeId, text);
-    if (result.queued) {
-      // queuedAt drives reconcileSteerBadges' TTL-expiry fallback (fleet-steer.ts).
-      tab.steerBadge = { messageId: result.messageId, status: 'queued', queuedAt: Date.now() };
-      this.markDirty();
-      return true;
-    }
-    const siblings = liveSteerableLabels(this.readModel.getSnapshot().rows.map((row) => row.node), tab.nodeId);
-    this.setError(steerRefusalMessage(result.reason, siblings));
-    this.markDirty();
-    return false;
-  }
-
-  protected renderItem(row: FleetTreeRow, _index: number, _selected: boolean, width: number): Line {
-    // Display-only overrides (stopping wins, then blocked-on-user) are derived
-    // here from panel state and passed into the pure row renderer.
-    const stopping = this.stopTracker.isStopping(row.node.id);
-    const blocked = !stopping && isBlockedOnUserNode(row.node);
-    return renderFleetRowLine(row, width, stopping, blocked, this.steerBadgeForNode(row.node.id), C);
-  }
-
-  /** A node's steer badge, looked up via its attached tab (if any), null when the node has no tab or no active/recent steer. */
-  private steerBadgeForNode(nodeId: string): SteerBadge | null {
-    return this.tabsState.tabs.find((t) => t.nodeId === nodeId)?.steerBadge ?? null;
-  }
-
-  private renderDetail(row: FleetTreeRow, width: number): Line[] {
-    const node = row.node;
-    // Mirror the tree row's display-only overrides (stopping wins, then blocked)
-    // so the detail's literal state text never contradicts the row glyph.
-    const stopping = this.stopTracker.isStopping(node.id);
-    const blocked = !stopping && isBlockedOnUserNode(node);
-    // The drill-in observed-steer draft (when the composer is open on this row)
-    // renders an input line in the observed detail. For a workstream row, lazily
-    // fetch its task graph so the edges/pool posture renders in-panel.
-    this.acts?.ensureGraphFor(node);
-    return renderFleetDetailLines(node, width, stopping, blocked, C, this.acts?.observedSteerDraftFor(node.id) ?? null, this.acts?.graphFor(node.id) ?? null);
-  }
-
-  /** Renders the active session tab's content (transcript / chain summary / ledger fallback) in place of the tree. */
-  private renderTabView(width: number, height: number): Line[] {
-    const palette = this.getPalette();
-    const tab = activeFleetTab(this.tabsState);
-    if (!tab) return this.renderTreeView(width, height); // defensive; should be unreachable
-    const stripLine = renderFleetTabStrip(this.tabsState, width);
-
-    const snapshotRows = this.readModel.getSnapshot().rows;
-    const liveNode = snapshotRows.find((row) => row.node.id === tab.nodeId)?.node ?? null;
-    // The steer composer only ever applies to 'agent' tabs
-    // (wrfc-chain has no conversation loop of its own, see
-    // fleet-tabs.ts's FleetAttachableKind doc); the live-node lookup is
-    // shared with the isTerminal computation below either way.
-    const canSteer = liveNode !== null && !isTerminalProcessState(liveNode.state) && liveNode.capabilities.steerable;
-
-    // While composing, Enter/Esc replace the tab-switch/detach
-    // hints (mirrors git-panel.ts's renderCommitCompose footer) so the
-    // footer never advertises a key the composer itself has absorbed.
-    const hints: Array<{ keys: string; label: string }> = tab.steerDraft !== null
-      ? [{ keys: 'Enter', label: 'send' }, { keys: 'Esc', label: 'cancel' }]
-      : [
-        { keys: '[ ]', label: 'switch tab' },
-        { keys: 'Ctrl+X', label: 'detach' },
-        ...(canSteer ? [{ keys: 's', label: 'steer' }] : []),
-      ];
-
-    const errorLine = this.renderErrorLine(width);
-    const composerLines: Line[] = [];
-    if (tab.steerDraft !== null) {
-      composerLines.push(buildSearchInputLine(
-        width,
-        'Steer: ',
-        `${tab.steerDraft}_`,
-        palette,
-        { active: true, bg: palette.inputBg, valueColor: palette.info },
-      ));
-    } else if (tab.steerBadge && !this.stopTracker.isStopping(tab.nodeId)) {
-      // A queued-steer promise ("delivers on its next turn") must not render
-      // while a stop is in flight for this node, there may be no next turn
-      // (refutation finding 4). The badge reconciles to dropped/consumed once
-      // the node's terminal state lands.
-      composerLines.push(renderSteerBadgeLine(tab.steerBadge, width, palette, liveNode?.label));
-    }
-
-    const footerLines = [
-      ...(errorLine ? [errorLine] : []),
-      ...composerLines,
-      buildKeyboardHints(width, hints, palette),
-    ];
-    const contentBudget = getPanelWorkspaceContentBudget(width, height, { footerLines, palette });
-    const contentHeight = Math.max(1, contentBudget - (stripLine ? 1 : 0));
-
-    let contentLines: Line[];
-
-    if (tab.kind === 'wrfc-chain') {
-      const memberRows = snapshotRows.filter((row) => row.node.parentId === tab.nodeId);
-      // d3: a completed chain prunes its wrapper node, so an empty member
-      // list can mean "finished", not "not started yet". Absent (pruned) OR
-      // terminal => the honest "completed" wording; present + non-terminal with
-      // no members yet => the "not started" wording.
-      const chainDoneOrAbsent = liveNode === null || isTerminalProcessState(liveNode.state);
-      contentLines = renderFleetChainSummary(memberRows, width, chainDoneOrAbsent);
-    } else {
-      const isTerminal = liveNode ? isTerminalProcessState(liveNode.state) : true;
-      const snapshot = this.actions.getConversationSnapshot(tab.agentId);
-      const result = renderFleetAgentTranscript(snapshot, isTerminal, tab.lineCache, width, contentHeight, this.configManager);
-      if (result.mode === 'unavailable') {
-        this.ensureLedgerLoaded(tab);
-        contentLines = tab.ledgerEntries !== null
-          ? renderFleetLedgerFallback(tab.ledgerEntries, width, contentHeight)
-          : renderFleetTranscriptLoading(width);
-      } else {
-        contentLines = result.lines;
-      }
-    }
-
-    const sections = [
-      ...(stripLine ? [{ lines: [stripLine] }] : []),
-      { lines: contentLines },
-    ];
-    return buildPanelWorkspace(width, height, { title: `Fleet: ${tab.label}`, sections, footerLines, palette });
-  }
-
-  private renderTreeView(width: number, height: number): Line[] {
-    const selected = this.getSelectedItem();
-    const footer: Line[] = [];
-    if (this.confirmOverlay.pending) {
-      footer.push(...(this.confirmOverlay.renderLines(width) ?? []));
-    } else if (selected) {
-      footer.push(...this.renderDetail(selected, width));
-    }
-
-    // Capability-gated tree hints, only advertise i/K/p when the selected node
-    // can actually accept them (most kinds are never interruptible; nothing is
-    // killable once terminal), incl. the d2 state-dependent p pause/resume chip.
-    // Mirrors the handleInput guards above. See buildFleetTreeHints (fleet-stop.ts).
-    // Blocked count is always taken from the LIVE fleet (blocked nodes never
-    // live in the archive), so the 'b' jump hint shows even from the archive view.
-    const blockedCount = this.readModel.getSnapshot().blockedNodeIds.length;
-    const hints = buildFleetTreeHints(selected?.node, this.follow, this.tabsState.tabs.length > 0, this.viewMode, blockedCount);
-
-    // Tab strip renders only when tabs exist, omitting it entirely with no
-    // tabs attached keeps the pre-session-tab root-tree rendering byte-identical.
-    const stripLine = renderFleetTabStrip(this.tabsState, width);
-    const header = stripLine ? [stripLine] : undefined;
-
-    return this.renderList(width, height, {
-      title: this.viewMode === 'archived' ? 'Fleet: Archived' : 'Fleet',
-      header,
-      footer,
-      hints,
-    });
-  }
-
-  public override render(width: number, height: number): Line[] {
-    if (this.acts?.pickModeActive()) return this.acts.renderPickMode(width, height, C);
-    if (this.spawn?.spawnModeActive()) return this.spawn.renderSpawnMode(width, height, C);
-    if (this.tabsState.activeTabIndex > 0) return this.renderTabView(width, height);
-    return this.renderTreeView(width, height);
-  }
-}