@pellux/goodvibes-tui 1.16.1 → 1.17.0

package/src/panels/fleet-panel-format.ts

@@ -11,7 +11,7 @@ import type { ProcessCostState, ProcessNode, ProcessUsage } from '@pellux/goodvi
 import type { Line } from '../types/grid.ts';
 import { formatAgentCost } from './agent-inspector-shared.ts';
 import { buildPanelLine, DEFAULT_PANEL_PALETTE, type ColumnSpec, type PanelPalette } from './polish.ts';
-import { fleetUsageTokens, hasFleetCost, type FleetStateTone } from './fleet-read-model.ts';
+import { fleetAttentionText, fleetNodeAttention, fleetStallMarker, fleetUsageTokens, hasFleetCost, type FleetStateTone } from './fleet-read-model.ts';
 import { fleetStateDisplay } from './fleet-stop.ts';
 import { formatElapsed } from '../utils/format-elapsed.ts';
 import { truncateDisplay } from '../utils/terminal-width.ts';
@@ -96,16 +96,39 @@ export function renderFleetRowLine(
     ? ` [attempt ${node.attemptGroup.index + 1}/${node.attemptGroup.total}${node.attemptGroup.held ? ', held' : ''}]`
     : '';
   const label = `${row.treePrefix}${node.label}${attemptBadge}`;
-  // Activity column doubles as the badge slot: 'blocked on you' shouts the
-  // wait louder than the raw currentActivity text ('awaiting approval …').
+  // Activity column doubles as the badge slot, in priority order:
+  //   stopping > waiting-on-human text ('blocked on you' / 'needs your input')
+  //   > the read-model HEADLINE (derived from task/phase identity only —
+  //   replaced in place, never a scrolling feed) with the stall marker
+  //   ('quiet Nm') appended when the node has gone observably silent.
+  // Nodes without a headline fall back to the live currentActivity text.
+  const attention = fleetNodeAttention(node);
+  const stallMarker = fleetStallMarker(node);
+  const steadyText = node.headline?.text ?? node.currentActivity?.text ?? '';
+  // The stall marker must survive the 20-char activity cell: budget the
+  // headline around it (the marker is the honesty signal; a stalled node must
+  // never render as if it were healthily mid-headline).
+  const steadyWithStall = stallMarker
+    ? (steadyText
+        ? `${truncateDisplay(steadyText, Math.max(1, ACTIVITY_W - stallMarker.length - 3))} · ${stallMarker}`
+        : stallMarker)
+    : steadyText;
   const activity = stopping
     ? disp.label
     : blocked
-      ? 'blocked on you'
+      ? fleetAttentionText(attention ?? { reason: 'approval' })
       : badge
-        ? `${steerBadgeGlyph(badge.status)} ${node.currentActivity?.text ?? ''}`.trimEnd()
-        : (node.currentActivity?.text ?? '');
-  const activityColor = stopping ? color : blocked ? color : badge ? steerBadgeTone(badge.status, C) : C.dim;
+        ? `${steerBadgeGlyph(badge.status)} ${steadyWithStall}`.trimEnd()
+        : steadyWithStall;
+  const activityColor = stopping
+    ? color
+    : blocked
+      ? color
+      : badge
+        ? steerBadgeTone(badge.status, C)
+        : stallMarker
+          ? (C.warn ?? DEFAULT_PANEL_PALETTE.warn)
+          : C.dim;
 
   return buildAlignedRow(
     width,
@@ -160,6 +183,19 @@ export function renderFleetDetailLines(
     ['  cost ', C.label],
     [formatFleetCost(node.costUsd, node.costState), C.value],
   ]);
+  // The headline (task/phase identity, replaced in place) gets its own row
+  // when present, with the stall marker appended — the detail block mirrors
+  // exactly what the tree row's steady slot shows.
+  const stallMarker = fleetStallMarker(node);
+  const headlineText = node.headline
+    ? `${node.headline.text}${stallMarker ? ` · ${stallMarker}` : ''}`
+    : stallMarker;
+  const headlineLine = headlineText
+    ? [buildPanelLine(width, [
+        [' headline ', C.label],
+        [truncateDisplay(headlineText, Math.max(0, width - 11)), stallMarker ? (C.warn ?? DEFAULT_PANEL_PALETTE.warn) : C.value],
+      ])]
+    : [];
   const activityText = node.currentActivity
     ? `${node.currentActivity.kind}: ${node.currentActivity.text}`
     : '(no recent activity)';
@@ -170,5 +206,5 @@ export function renderFleetDetailLines(
   // Approval history attaches here once session tabs land.
   const line4 = buildPanelLine(width, [[' approvals ', C.label], ['—', C.dim]]);
   const isolationDetail = node.kind === 'work-item' ? formatWorkItemIsolationDetailFromRaw(node.raw) : null;
-  return [line1, line2, line3, line4, ...(isolationDetail ? [buildPanelLine(width, [[' isolation ', C.label], [isolationDetail, C.dim]])] : [])];
+  return [line1, line2, ...headlineLine, line3, line4, ...(isolationDetail ? [buildPanelLine(width, [[' isolation ', C.label], [isolationDetail, C.dim]])] : [])];
 }

package/src/panels/fleet-panel.ts

@@ -1,14 +1,14 @@
 // ---------------------------------------------------------------------------
 // fleet-panel.ts
 //
-// W2.2 — FleetPanel: the live unified observability tree. Renders the
+// — 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 (W3.1 Part C): Enter on an
+// 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 (DEBT-5 item 4).
+// cross-panel jump target (item 4).
 // ---------------------------------------------------------------------------
 
 import { readFile } from 'node:fs/promises';
@@ -21,7 +21,7 @@ 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 {
-  isBlockedOnUserState,
+  isBlockedOnUserNode,
   isRunningProcessState,
   isTerminalProcessState,
   type FleetReadModel,
@@ -105,7 +105,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
    */
   private selectedNodeId: string | null = null;
 
-  /** d1 (W6.2): the "stopping…" write-window overlay tracker (see fleet-stop.ts). */
+  /** d1: the "stopping…" write-window overlay tracker (see fleet-stop.ts). */
   private readonly stopTracker = new FleetStopTracker();
 
   public constructor(
@@ -114,7 +114,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
     private readonly configManager: ConfigManager | null = null,
   ) {
     super('fleet', 'Fleet', '⊟', 'runtime-ops');
-    this.showSelectionGutter = true; // W0.8: visible ▸ focus indicator
+    this.showSelectionGutter = true; // visible ▸ focus indicator
     this.actions = { ...NOOP_ACTIONS, ...actions };
     this.confirmOverlay = new PanelConfirmOverlay(() => this.markDirty());
     this.unsub = readModel.subscribe(() => {
@@ -232,10 +232,10 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
   }
 
   /**
-   * W3.3 (cross-restart honesty): a restart always starts from an empty
+   * (cross-restart honesty): a restart always starts from an empty
    * `AgentManager` Map (no bridge from a prior TUI/daemon registry), so a
    * completed process from a previous session can never reappear here — a
-   * real, permanent limitation (W3.3 brief point 5), documented rather than
+   * real, permanent limitation (brief point 5), documented rather than
    * silently implying "nothing has ever run" or that a restart brings it back.
    */
   protected override getEmptyStateActions(): Array<{ command: string; summary: string }> {
@@ -303,7 +303,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
     return this.getItems().find((row) => row.node.id === nodeId)?.node ?? null;
   }
 
-  /** DEBT-5 item 4 (see fleet-deep-link.ts). */
+  /** 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; }
@@ -391,7 +391,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
     // 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 (W0.8 focus rule).
+    // 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);
@@ -491,7 +491,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
         id: node.id,
         label: `${node.kind} ${shortId}${suffix}`,
         verb: 'Kill',
-        // d1 (W6.2): mark 'stopping…' only once the kill is confirmed, not while
+        // d1: mark 'stopping…' only once the kill is confirmed, not while
         // the confirm overlay is merely armed.
         onConfirm: () => {
           this.actions.kill(node.id, { cascade: true });
@@ -501,7 +501,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
       return true;
     }
 
-    // d2 (W6.2): 'p' toggles pause<->resume by the selected node's state (see
+    // d2: 'p' toggles pause<->resume by the selected node's state (see
     // toggleFleetPause in fleet-stop.ts).
     if (key === 'p') {
       if (!selected) return false;
@@ -621,7 +621,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
 
   /**
    * Submit a composed steer message. Returns whether it was queued so the caller
-   * clears the draft only on a confirmed send (WO UX-A item 4): a refusal (target
+   * 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.
@@ -644,7 +644,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
     // 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 && isBlockedOnUserState(row.node.state);
+    const blocked = !stopping && isBlockedOnUserNode(row.node);
     return renderFleetRowLine(row, width, stopping, blocked, this.steerBadgeForNode(row.node.id), C);
   }
 
@@ -658,7 +658,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
     // 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 && isBlockedOnUserState(node.state);
+    const blocked = !stopping && isBlockedOnUserNode(node);
     return renderFleetDetailLines(node, width, stopping, blocked, C);
   }
 
@@ -718,7 +718,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
 
     if (tab.kind === 'wrfc-chain') {
       const memberRows = snapshotRows.filter((row) => row.node.parentId === tab.nodeId);
-      // d3 (W6.2): a completed chain prunes its wrapper node, so an empty member
+      // 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.

package/src/panels/fleet-read-model.ts

@@ -1,14 +1,14 @@
 // ---------------------------------------------------------------------------
 // fleet-read-model.ts
 //
-// W2.2 (Fleet tree panel) — pure, testable read-model over the SDK's live
+// (Fleet tree panel) — pure, testable read-model over the SDK's live
 // process registry (@pellux/goodvibes-sdk/platform/runtime/fleet, landed on
-// SDK main as W2.1). No BasePanel/rendering dependency: this module owns the
+// SDK main as). No BasePanel/rendering dependency: this module owns the
 // flat ProcessNode[] -> tree transformation, the honest cost/token
 // aggregates, and the state->glyph/tone mapping that FleetPanel renders.
 //
 // Design notes:
-//   - The W2.2 brief predates the real SDK API and sketched a bespoke
+//   - The brief predates the real SDK API and sketched a bespoke
 //     FleetRegistryNode/FleetRegistry adapter pair. The real
 //     createProcessRegistry() ProcessNode already carries elapsedMs,
 //     usage, costUsd, costState, and currentActivity directly, so no
@@ -30,6 +30,7 @@
 
 import type {
   ArchivableProcessRegistry,
+  ProcessAttention,
   ProcessCostState,
   ProcessKind,
   ProcessNode,
@@ -136,13 +137,11 @@ const STATE_TONES: Record<ProcessState, FleetStateTone> = {
 const TERMINAL_STATES = new Set<ProcessState>(['done', 'failed', 'killed', 'interrupted']);
 
 /**
- * States that mean "this node is waiting on ME right now" — a user approval or
- * user input. Today the registry derives exactly one such state,
- * `awaiting-approval` (an agent parked at a permission prompt). This is the
- * single place that mapping lives, so if the SDK adds a distinct
- * awaiting-user-input state later it joins here and every "blocked on me"
- * surface (badge, sort, jump) picks it up for free. Kept as a set for that
- * forward-compatibility, not because more than one state qualifies today.
+ * States that mean "this node is waiting on ME right now" via the state field
+ * alone. The registry now also publishes the canonical `needsAttention`
+ * projection (reason 'approval' | 'input' — see fleetNodeAttention below),
+ * which every surface prefers; this set remains only as the fallback mapping
+ * for nodes without the projection, so nothing regresses on older registries.
  */
 const BLOCKED_ON_USER_STATES = new Set<ProcessState>(['awaiting-approval']);
 
@@ -195,8 +194,48 @@ export function isBlockedOnUserState(state: ProcessState): boolean {
   return BLOCKED_ON_USER_STATES.has(state);
 }
 
+/**
+ * The node's waiting-on-human classification, preferring the SDK's canonical
+ * `needsAttention` projection (reason 'approval' | 'input' — broader than the
+ * awaiting-approval state alone: it also covers a session waiting on user
+ * input). Falls back to the state-derived mapping for registries that predate
+ * the projection, so nothing regresses. This is THE membership every
+ * "blocked on me" surface (badge, sort, jump) derives from.
+ */
+export function fleetNodeAttention(node: ProcessNode): ProcessAttention | null {
+  if (node.needsAttention) return node.needsAttention;
+  if (isBlockedOnUserState(node.state)) return { reason: 'approval' };
+  return null;
+}
+
+/** True when the node is waiting on the operator right now (approval or input). */
+export function isBlockedOnUserNode(node: ProcessNode): boolean {
+  return fleetNodeAttention(node) !== null;
+}
+
+/** The literal badge text for a waiting-on-human node, by reason. */
+export function fleetAttentionText(attention: ProcessAttention): string {
+  return attention.reason === 'input' ? 'needs your input' : 'blocked on you';
+}
+
+/**
+ * The stall marker for a row — 'quiet Nm' (or 'quiet NhMm' past an hour),
+ * derived from the read-model's stall tell (pure timestamp comparison on the
+ * registry side; a live node whose last observable output is older than the
+ * threshold). Null when the node is not stalled-quiet.
+ */
+export function fleetStallMarker(node: ProcessNode): string | null {
+  const stall = node.stall;
+  if (!stall) return null;
+  const minutes = Math.max(1, Math.floor(stall.quietForMs / 60_000));
+  if (minutes < 60) return `quiet ${minutes}m`;
+  const hours = Math.floor(minutes / 60);
+  const rest = minutes % 60;
+  return rest > 0 ? `quiet ${hours}h${rest}m` : `quiet ${hours}h`;
+}
+
 // ---------------------------------------------------------------------------
-// Honest usage/cost helpers (W0.9 convention, ported from agent-inspector-shared.ts)
+// Honest usage/cost helpers (convention, ported from agent-inspector-shared.ts)
 // ---------------------------------------------------------------------------
 
 /**
@@ -261,7 +300,7 @@ function collectBlockedSubtrees(
     if (cached !== undefined) return cached;
     if (visiting.has(node.id)) return false; // cycle guard
     visiting.add(node.id);
-    let has = isBlockedOnUserState(node.state);
+    let has = isBlockedOnUserNode(node);
     for (const child of childrenByParent.get(node.id) ?? []) {
       if (dfs(child)) has = true;
     }
@@ -458,7 +497,7 @@ export function buildFleetSnapshot(nodes: readonly ProcessNode[], capturedAt: nu
   // Blocked ids in display (row) order so the panel's jump key steps through
   // them top-to-bottom exactly as they appear on screen.
   const blockedNodeIds = rows
-    .filter((row) => isBlockedOnUserState(row.node.state))
+    .filter((row) => isBlockedOnUserNode(row.node))
     .map((row) => row.node.id);
 
   return { rows, totalCost, totalTokens, runningCount, blockedNodeIds, capturedAt };

package/src/panels/fleet-steer.ts

@@ -34,7 +34,7 @@ export function steerBadgeTone(status: SteerBadgeStatus, palette: PanelPalette):
   }
 }
 
-/** Labels of the currently live, steerable agent nodes other than `excludeNodeId` — offered when a steer target has gone inactive (WO UX-A item 4). */
+/** Labels of the currently live, steerable agent nodes other than `excludeNodeId` — offered when a steer target has gone inactive (WO item 4). */
 export function liveSteerableLabels(nodes: readonly ProcessNode[], excludeNodeId: string): string[] {
   return nodes
     .filter((node) => node.id !== excludeNodeId && node.kind === 'agent' && node.capabilities.steerable && !isTerminalProcessState(node.state))
@@ -49,7 +49,7 @@ export function steerRefusalMessage(reason: string, siblingLabels: readonly stri
   return `${reason}.${suggestion}`;
 }
 
-/** One-line honest status for a tab's steer badge; the queued line names the target and points at the ⧗ delivery badge (WO UX-A item 4). */
+/** One-line honest status for a tab's steer badge; the queued line names the target and points at the ⧗ delivery badge (WO item 4). */
 export function renderSteerBadgeLine(badge: SteerBadge, width: number, palette: PanelPalette, targetLabel?: string): Line {
   const glyph = steerBadgeGlyph(badge.status);
   const tone = steerBadgeTone(badge.status, palette);

package/src/panels/fleet-stop.ts

@@ -1,7 +1,7 @@
 // ---------------------------------------------------------------------------
 // fleet-stop.ts
 //
-// d1 (W6.2) — the "stopping…" write-window overlay, split out of fleet-panel.ts
+// d1 — the "stopping…" write-window overlay, split out of fleet-panel.ts
 // to keep that file under the architecture 800-line gate (same rationale as
 // fleet-steer.ts). FleetPanel owns nothing here beyond a FleetStopTracker
 // instance; all the state->display logic lives in these pure helpers.
@@ -80,7 +80,7 @@ export interface FleetPauseDeps {
 }
 
 /**
- * d2 (W6.2): 'p' toggles pause<->resume by the node's state. A `paused`
+ * d2: 'p' toggles pause<->resume by the node's state. A `paused`
  * resumable node is resumed (interrupt's inverse); a live pausable node is
  * paused via the registry's interrupt() (its disable path). Honest refusal for
  * non-resumable/non-pausable kinds. Returns true when the key is consumed,
@@ -152,7 +152,7 @@ export function buildFleetTreeHints(
   return hints;
 }
 
-/** K-confirm descendant stats (UX-C item 6): total = every non-terminal descendant (what a cascade kill takes down); active = the individually-killable subset. Was "active only" in an earlier version, undercounting a mixed subtree. */
+/** K-confirm descendant stats (item 6): total = every non-terminal descendant (what a cascade kill takes down); active = the individually-killable subset. Was "active only" in an earlier version, undercounting a mixed subtree. */
 export function countDescendantStats(rows: readonly FleetTreeRow[], nodeId: string): { total: number; active: number } {
   const byParent = new Map<string, string[]>();
   for (const row of rows) {

package/src/panels/fleet-tabs.ts

@@ -91,17 +91,16 @@ export function appendSteerText(draft: string, ch: string): string {
  * One attached session tab. `agentId` is the SDK attach handle for
  * `AgentManager.getConversationSnapshot(agentId)` — populated only for
  * 'agent' tabs (agent.ts sets ProcessNode.id = record.id, so node.id IS the
- * agentId; see the W3.1 brief's C2 note). 'wrfc-chain' tabs render a live
- * member-summary instead of a transcript (a chain has no single conversation
- * of its own — see fleet-transcript.ts renderFleetChainSummary) and carry an
- * empty agentId, unused.
+ * agentId). 'wrfc-chain' tabs render a live member-summary instead of a
+ * transcript (a chain has no single conversation of its own — see
+ * fleet-transcript.ts renderFleetChainSummary) and carry an empty agentId,
+ * unused.
  *
- * `lineCache` is a PER-TAB `MessageLineCache` (C5 backpressure): switching
- * tabs must never invalidate or thrash the main session's own cache, and a
- * background (non-focused) tab must render nothing beyond its existing
- * tree-row, so its cache simply stays empty (size 0) until the tab is
- * focused. Disposed (`.clear()`) on detach so a closed tab's rendered
- * Line[] are not retained (brief risk #8).
+ * `lineCache` is a PER-TAB `MessageLineCache`: switching tabs must never
+ * invalidate or thrash the main session's own cache, and a background
+ * (non-focused) tab must render nothing beyond its existing tree-row, so its
+ * cache simply stays empty (size 0) until the tab is focused. Disposed
+ * (`.clear()`) on detach so a closed tab's rendered Line[] are not retained.
  */
 export interface FleetTab {
   readonly nodeId: string;
@@ -111,10 +110,10 @@ export interface FleetTab {
   readonly lineCache: MessageLineCache;
   /**
    * Cached parsed ledger fallback for a terminal agent whose conversation
-   * snapshot has been evicted from the SDK's retention ring (C6 degraded
-   * path). `null` = not yet loaded/attempted; `[]` = loaded and empty (or
-   * the load failed) — both render the same honest "no transcript" state
-   * once loaded is true.
+   * snapshot has been evicted from the SDK's retention ring (the degraded
+   * fallback path). `null` = not yet loaded/attempted; `[]` = loaded and
+   * empty (or the load failed) — both render the same honest "no transcript"
+   * state once loaded is true.
    */
   ledgerEntries: Record<string, unknown>[] | null;
   ledgerLoadStarted: boolean;

package/src/panels/fleet-transcript.ts

@@ -59,7 +59,7 @@ function toneColor(tone: FleetStateTone, palette: PanelPalette): string {
 }
 
 // ---------------------------------------------------------------------------
-// Agent transcript (C6 live/frozen split)
+// Agent transcript (live/frozen split)
 // ---------------------------------------------------------------------------
 
 export type FleetTranscriptMode = 'live' | 'frozen' | 'unavailable';
@@ -70,7 +70,7 @@ export interface FleetTranscriptRender {
 }
 
 /**
- * W3.3 (design point 4) — a 'frozen' transcript is a static capture of a
+ * (design point 4) — a 'frozen' transcript is a static capture of a
  * completed process, not something that will change on the next render. The
  * distinction matters because this wave also introduced kill/interrupt
  * display bugs (elapsed/usage briefly climbing after a terminal state
@@ -157,7 +157,7 @@ export function renderFleetAgentTranscript(
 }
 
 // ---------------------------------------------------------------------------
-// Chain summary — 'wrfc-chain' tabs have no single conversation (C2/C6)
+// Chain summary — 'wrfc-chain' tabs have no single conversation
 // ---------------------------------------------------------------------------
 
 /**
@@ -197,7 +197,7 @@ export function renderFleetChainSummary(
 
 // ---------------------------------------------------------------------------
 // Ledger fallback — degraded activity view for a terminal agent whose
-// full-fidelity snapshot is unavailable (C6 "honest fallback")
+// full-fidelity snapshot is unavailable (an honest fallback)
 // ---------------------------------------------------------------------------
 
 /**
@@ -257,7 +257,7 @@ function renderLedgerEntry(width: number, entry: Record<string, unknown>, palett
       const toolName = typeof entry['toolName'] === 'string' ? entry['toolName'] : 'tool';
       const success = entry['success'] !== false;
       const bad = palette.bad ?? DEFAULT_PANEL_PALETTE.bad;
-      // W3.3: the writer already truncates this to 500 chars (session.ts's
+      // the writer already truncates this to 500 chars (session.ts's
       // resultPreview field) — passed through verbatim (collapsed to one
       // line), never re-summarized or fabricated, then tail-truncated again
       // to fit the row.

package/src/panels/git-panel.ts

@@ -77,7 +77,7 @@ const C = extendPalette(DEFAULT_PANEL_PALETTE, {
   commitAuthor: '244',
   selected: '#1c1c1c',
   selectedFg: '#ffffff',
-  diffMeta: DIFF_TONES.hunk, // WO-204: shared diff-hunk token, was a local literal
+  diffMeta: DIFF_TONES.hunk, // shared diff-hunk token, was a local literal
   diffNeutral: '250',
   // Reuses the existing workflow accent token rather than adding a new hex
   // literal (architecture gate ratchets the raw-hex-literal count).
@@ -626,7 +626,7 @@ export class GitPanel extends BasePanel {
         { keys: 'r', label: 'refresh' },
       ], DEFAULT_PANEL_PALETTE),
     ];
-    const emptyStateLines = buildEmptyState(width, ' No git rows', 'This repository has no staged or unstaged changes and no commits to display yet.', [{ command: 'r', summary: 'refresh working-tree status in this panel, or stage changes to populate this view' }], DEFAULT_PANEL_PALETTE); // WO-160: was '/git status' (chat-only, never touches this panel)
+    const emptyStateLines = buildEmptyState(width, ' No git rows', 'This repository has no staged or unstaged changes and no commits to display yet.', [{ command: 'r', summary: 'refresh working-tree status in this panel, or stage changes to populate this view' }], DEFAULT_PANEL_PALETTE); // was '/git status' (chat-only, never touches this panel)
     const rows: Line[] = [];
     for (let i = 0; i < this.items.length; i++) {
       const item = this.items[i];

package/src/panels/index.ts

@@ -7,7 +7,7 @@ export { CostTrackerPanel } from './cost-tracker-panel.ts';
 export { GitPanel } from './git-panel.ts';
 export { registerBuiltinPanels } from './builtin-panels.ts';
 export type { BuiltinPanelDeps } from './builtin-panels.ts';
-// W6.1 (the purge) — group B: plugins/skills panels are register-retired but
+// (the purge) — group B: plugins/skills panels are register-retired but
 // their modules are retained for shared non-class exports (PluginManagerControls;
 // discoverSkills + SkillRecord/SkillOrigin, consumed by command runtimes and the
 // skills modal). The other group-A and group-B panel classes are deleted outright
@@ -16,3 +16,6 @@ export { PluginsPanel } from './plugins-panel.ts';
 export { SkillsPanel } from './skills-panel.ts';
 export { FleetPanel } from './fleet-panel.ts';
 export type { FleetActionCallbacks } from './fleet-panel.ts';
+export { NotificationsPanel } from './notifications-panel.ts';
+export { PanelNotificationFeed, getSharedNotificationFeed } from './notifications-feed.ts';
+export type { PanelFeedEntry } from './notifications-feed.ts';

package/src/panels/local-auth-panel.ts

@@ -21,7 +21,7 @@ import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import { type ConfirmState, handleConfirmInput } from './confirm-state.ts';
 
 // Base chrome only — state colors and text tokens come straight from
-// DEFAULT_PANEL_PALETTE (WO-002).
+// DEFAULT_PANEL_PALETTE.
 const C = DEFAULT_PANEL_PALETTE;
 
 function formatRoles(roles: readonly string[]): string {

package/src/panels/modals/hooks-modal.ts

@@ -16,7 +16,7 @@ import type {
 } from '../../input/config-modal-types.ts';
 
 // ---------------------------------------------------------------------------
-// Hooks → config-modal surface (W6.1 group-B port). Two tabs: 'Hooks' (active
+// Hooks → config-modal surface (group-B port). Two tabs: 'Hooks' (active
 // registrations + contract posture) and 'Activity' (recent runtime activity +
 // managed authoring + last simulation — the panel's expand-activity view, now a
 // dedicated tab). All sources are in-memory (dispatcher/workbench/tracker hold

package/src/panels/modals/keybindings-modal.ts

@@ -9,7 +9,7 @@ import type {
 import { KeybindingsManager } from '../../input/keybindings.ts';
 
 // ---------------------------------------------------------------------------
-// Docs + Shortcuts → 'keybindings' config-modal surface (W6.1 group-B port).
+// Docs + Shortcuts → 'keybindings' config-modal surface (group-B port).
 // A MERGE of the retired DocsPanel (tools/models/shortcuts) and the
 // shortcuts-overlay reference. Three tabs: 'Tools', 'Models', and 'Shortcuts'
 // (the categorized keyboard reference — driven live off keybindingsManager so
@@ -112,7 +112,7 @@ class KeybindingsModalSurface implements ConfigModalSurface {
     if (id === 'refresh') { ctx.setStatus('Docs & shortcuts are read live.'); ctx.requestRender(); return; }
     if (id !== 'activate') return;
     if (ctx.tabId === 'tools') {
-      // DEBT-5 item 4: pass the tool name through as a deep-link target.
+      // item 4: pass the tool name through as a deep-link target.
       // Honest caveat (documented, not a bug to silently paper over): fleet's
       // ProcessKind set has no 'tool' node — a docs Tools row names a static
       // tool DEFINITION, not a live process, so FleetPanel.receiveDeepLink

package/src/panels/modals/knowledge-modal.ts

@@ -9,7 +9,7 @@ import type {
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 
 // ---------------------------------------------------------------------------
-// Knowledge (graph) → config-modal surface (W6.1 group-B port). Two tabs:
+// Knowledge (graph) → config-modal surface (group-B port). Two tabs:
 // 'Browse' (sources/nodes/issues + schedules) and 'Review' (the open-issue
 // queue) — the panel's browse/review toggle, now host tabs. Issue review
 // mutations (accept/reject/resolve/reopen) route to the `/knowledge

package/src/panels/modals/marketplace-modal.ts

@@ -38,14 +38,14 @@ interface MarketplaceRow {
 const KINDS: readonly EcosystemEntryKind[] = ['plugin', 'skill', 'hook-pack', 'policy-pack'];
 
 /**
- * Marketplace → config-modal surface (W6.1 group-B port). Local-first
+ * Marketplace → config-modal surface (group-B port). Local-first
  * publish/import catalog (NOT a remote store) with provenance, compatibility,
  * and install posture. Disk catalog loads happen in refresh() (never in
  * buildView), mirroring the panel's explicit render()/refresh() split.
  * Install/uninstall route to the `/marketplace` command path (charter: no
  * destructive confirm folded into a modal).
  *
- * B30 (honest empty-state): the panel's original "No curated marketplace
+ * Honest empty-state: the panel's original "No curated marketplace
  * entries found yet." copy implied a curated remote catalog. It isn't one —
  * loadEcosystemCatalog only ever reads .goodvibes/ecosystem/<kind>s.json under
  * the project/home, populated solely by `/marketplace publish` and
@@ -118,7 +118,7 @@ class MarketplaceModalSurface implements ConfigModalSurface {
     const snapshot = this.deps.readModel?.getSnapshot();
     const rows: ConfigModalRow[] = [];
 
-    // Honest empty / degraded state (B30). loadError → degraded banner.
+    // Honest empty / degraded state. loadError → degraded banner.
     if (this.loadError) {
       return { title: 'Marketplace', degraded: this.loadError, tabs: [{ id: 'catalog', label: 'Catalog', rows: [] }] };
     }
@@ -205,7 +205,7 @@ export function createMarketplaceModalSurface(deps: MarketplaceModalDeps): Confi
  * Deterministic golden fixture: catalog roots wired at a fresh tmp path that is
  * removed immediately (loadEcosystemCatalog/listInstalledEcosystemEntries guard
  * missing paths with existsSync → [], so refresh() finds nothing and renders the
- * B30 honest empty-state copy). The random tmp path never appears in the
+ * honest empty-state copy). The random tmp path never appears in the
  * rendered lines (the empty-state copy is static), so the golden is byte-stable.
  */
 export function marketplaceModalGoldenSurface(): ConfigModalSurface {

package/src/panels/modals/memory-modal.ts

@@ -9,7 +9,7 @@ import type {
 import { memoryRecordTemporalStatus } from '@pellux/goodvibes-sdk/platform/state';
 
 // ---------------------------------------------------------------------------
-// Memory → config-modal surface (W6.1 group-B port). Two tabs: 'All Records'
+// Memory → config-modal surface (group-B port). Two tabs: 'All Records'
 // (the full record list) and 'Review Queue' (the operator review queue) — the
 // same split the panel toggled with Tab, now real host tabs. Review-state
 // mutations (reviewed/stale/contradicted/fresh) and record delete route to the
@@ -227,9 +227,9 @@ export async function memoryModalGoldenSurface(): Promise<ConfigModalSurface> {
   const records: readonly MemoryRecordLike[] = [
     {
       id: 'mem-0000001a', scope: 'project', cls: 'decision',
-      summary: 'Wave-6 batches panel retirements behind modal builders.',
-      detail: 'Applies to KNOWLEDGE, MEMORY, WORK-PLAN in WO-B.',
-      tags: ['wave-6', 'modals'], reviewState: 'reviewed', confidence: 90,
+      summary: 'Panel retirements are batched behind modal builders.',
+      detail: 'Applies to the knowledge, memory, and work-plan modals.',
+      tags: ['panels', 'modals'], reviewState: 'reviewed', confidence: 90,
       reviewedAt: FIXED_CREATED_AT + 3600000, reviewedBy: 'operator', createdAt: FIXED_CREATED_AT,
       provenance: [{ kind: 'session', ref: 'session-fixed-1' }],
     },

package/src/panels/modals/modal-surface-helpers.ts

@@ -3,7 +3,7 @@ import type { ModalSectionStyle } from '../../renderer/modal-factory.ts';
 import type { ConfigModalRow } from '../../input/config-modal-types.ts';
 
 /**
- * Shared formatting helpers for W6.1 config-modal surfaces. Row styling reuses
+ * Shared formatting helpers for config-modal surfaces. Row styling reuses
  * DEFAULT_PANEL_PALETTE (the retired panels' palette) so a migrated modal reads
  * as the same surface it replaced — the goldens stay panel-consistent.
  */

package/src/panels/modals/modal-theme.ts

@@ -1,7 +1,7 @@
 import { activeUiTones, registerThemeRefresh } from '../../renderer/theme.ts';
 
 // ---------------------------------------------------------------------------
-// Semantic tone tokens for the W6.1 group-B config modals.
+// Semantic tone tokens for the group-B config modals.
 //
 // Derived entirely from the chrome token set so the builders carry NO raw hex
 // color literals (architecture: no-raw-hex-literal-growth). Rebuilt IN PLACE