@pellux/goodvibes-tui 1.9.1 → 1.9.2

package/src/input/onboarding/onboarding-wizard-apply.ts

@@ -86,13 +86,13 @@ export function buildOnboardingApplyRequest(controller: OnboardingWizardControll
     setConfig('service.autostart', hasServers);
     setConfig('service.restartOnFailure', true);
     // One-Platform daemon-by-default (SDK docs/decisions/2026-07-05-daemon-by-default.md):
-    // the loopback-only cross-surface session daemon is safe-by-design (Wave 1:
-    // loopback bind, auth-gated, rate-limited) and runs regardless of whether
+    // the loopback-only cross-surface session daemon is safe-by-design
+    // (loopback bind, auth-gated, rate-limited) and runs regardless of whether
     // browser/LAN/webhook/external-app capabilities are selected here — it is no
     // longer bundled with those network-exposing surfaces, so onboarding leaves
     // daemon.enabled untouched and lets the SDK's own default-true (or an existing
     // explicit user override) govern. (The deprecated danger.daemon alias this
-    // comment used to also name was removed in Wave 6.)
+    // comment used to also name was later removed.)
     setConfig('controlPlane.enabled', hasServers);
     setConfig('danger.httpListener', httpListener);
     setConfig('web.enabled', browserAccess);

package/src/input/onboarding/onboarding-wizard-network-adopt.ts

@@ -1,5 +1,5 @@
 /**
- * F1 (One-Platform Wave 2 friction fix): the Network step's daemon-source choice
+ * Friction fix: the Network step's daemon-source choice
  * — start a new daemon owned by this TUI (default) vs connect to one that is
  * already running elsewhere with a known token. Extracted from
  * onboarding-wizard-steps.ts to keep that file under the architecture line cap.
@@ -78,7 +78,7 @@ export function pushDaemonAdoptionFields(
 }
 
 /**
- * W4-D1: the guided, visible entry point for migrating a detected legacy
+ * The guided, visible entry point for migrating a detected legacy
  * `goodvibes-daemon.service` unit — closes the fast-follow-up flagged when
  * `handleMigrateLegacyDaemonServiceForHandler` (handler-onboarding-daemon-adopt.ts)
  * shipped fully built but not wired to any onboarding control. Independent of
@@ -107,7 +107,7 @@ export function pushLegacyDaemonMigrationFields(
     kind: 'status',
     id: 'network.migrate-legacy-daemon-detected',
     label: 'Legacy daemon service detected',
-    // F2 follow-up: name the unit this host actually resolves (carried on the
+    // Follow-up: name the unit this host actually resolves (carried on the
     // snapshot from `resolveConfiguredServiceName` at collection time) — the
     // MANAGED_SERVICE_NAME fallback only covers snapshots built without it.
     hint: legacyUnitNote(legacy, legacy.trackedServiceName ?? MANAGED_SERVICE_NAME),

package/src/input/onboarding/onboarding-wizard-steps.ts

@@ -533,7 +533,7 @@ export function buildNetworkStep(controller: OnboardingWizardControllerLike): On
       },
     ];
 
-    // F1: recognize an adoptable already-running daemon (see onboarding-wizard-network-adopt.ts).
+    // Recognize an adoptable already-running daemon (see onboarding-wizard-network-adopt.ts).
     const daemonSource = getDaemonSource(controller);
     pushDaemonAdoptionFields(fields, controller, daemonSource, bindSettings);
     pushLegacyDaemonMigrationFields(fields, controller);

package/src/input/session-picker-modal.ts

@@ -6,7 +6,7 @@
  * control-plane session, see below), tracks selected index, and handles
  * load/delete actions.
  *
- * W3-T2 (union-sessions surface): additionally surfaces the cross-surface
+ * Union-sessions surface: additionally surfaces the cross-surface
  * session union from `sessionBroker` (a SessionReadFacade — normally
  * `uiServices.sessions.sessionBroker`, the SessionUnionCache) so a user can
  * SEE what sessions are live/closed across every surface sharing this

package/src/input/settings-modal-data.ts

@@ -156,7 +156,7 @@ export function buildSettingGroups(
     }
   }
 
-  // Wave 5 (wo804): inject the storage.codeIndexEnabled toggle into the
+  // Inject the storage.codeIndexEnabled toggle into the
   // storage category. TUI-local synthetic setting (not in the SDK ConfigKey
   // union — see code-index-services.ts), same rationale as
   // notifyAfterSeconds above: opt-in, default off, states its own bounds.
@@ -342,7 +342,7 @@ export function buildNotifyAlertSyntheticEntries(configManager: Pick<ConfigManag
 }
 
 // ---------------------------------------------------------------------------
-// Wave 5 (wo804) — storage.codeIndexEnabled synthetic setting
+// storage.codeIndexEnabled synthetic setting
 // ---------------------------------------------------------------------------
 
 /**

package/src/main.ts

@@ -202,7 +202,7 @@ async function main() {
 
   const unsubs: Array<() => void> = [];
   let recoveryInterval: ReturnType<typeof setInterval> | null = null;
-  let stopSpokenOutputForExit: (() => void) | null = null;
+  let stopSpokenOutputForExit: (() => Promise<void>) | null = null;
   let recoveryPending = false;
   // Which file the current recovery prompt should load/delete from (see recovery-input-helpers.ts).
   let recoverySource: 'live' | 'preserved' = 'live';
@@ -240,7 +240,8 @@ async function main() {
     events: uiServices.events,
     notify: (message) => { systemMessageRouter.high(message); render(); },
   });
-  stopSpokenOutputForExit = () => spokenTurns.stop();
+  // Exit-path stop: bounded drain of the audio already playing (see stopForExit).
+  stopSpokenOutputForExit = () => spokenTurns.stopForExit();
   unsubs.push(...spokenTurns.unsubs);
   unsubs.push(attachSpokenTurnModelRouting({
     orchestrator,
@@ -497,7 +498,7 @@ async function main() {
       lastInputTokens: orchestrator.lastInputTokens,
       commandArgsHint,
       hitlMode: modeManager.getHITLMode(),
-      // S3d: cross-surface spine posture segment (adopted-daemon mode only).
+      // Cross-surface spine posture segment (adopted-daemon mode only).
       sessionSpineStatus: (() => { const s = uiServices.platform.externalServices?.inspect(); return s?.sessionSpineActive && s.sessionSpineStatus && s.sessionSpineStatus !== 'unknown' ? s.sessionSpineStatus : undefined; })(), runningAgentCount, runningProcessCount,
       // Composer must not read as focused while the panel/process indicator owns keyboard focus.
       promptFocused: !input.panelFocused && !input.indicatorFocused,
@@ -646,7 +647,7 @@ async function main() {
   const terminalOutputGuard = installTuiTerminalOutputGuard({ stdout, stderr: process.stderr, onCapture: (total) => { commandContext.session.runtime.terminalWritesIntercepted = total; render(); } });
 
   setRenderRequest(renderNow); // bootstrap's 16ms coalescer calls the composite directly
-  setPanelFrameRequester(render); // live panels repaint when idle (Wave-6 replay: fleet sat stale until keypress)
+  setPanelFrameRequester(render); // live panels repaint when idle (a replay finding: fleet sat stale until keypress)
   orchestratorRefs.requestRender = render;
   commandContext.renderRequest = render;
   wireShellUiOpeners({

package/src/panels/base-panel.ts

@@ -14,7 +14,7 @@ const ERROR_FG = '#ef4444';
  * markDirty() only sets a flag the compositor reads when a frame is ALREADY
  * being composed for another reason (input, streaming) — so a live panel
  * (fleet ticks, registry subscriptions) sat visibly stale while the app was
- * idle until the next keypress (Wave-6 replay finding). The scheduler
+ * idle until the next keypress (a replay finding). The scheduler
  * coalesces same-tick requests, so this stays cheap.
  */
 let panelFrameRequester: (() => void) | null = null;

package/src/panels/builtin/operations.ts

@@ -38,7 +38,7 @@ export function registerOperationsPanels(manager: PanelManager, deps: ResolvedBu
   // process registry constructed once in runtime/services.ts (shared with
   // every other consumer rather than duplicated here; the registry owns its
   // own coalesced tick, so no manual lifecycle-event wiring is needed).
-  // Wave-3 (W3.2): runtimeBus is also passed so the read model can subscribe
+  // runtimeBus is also passed so the read model can subscribe
   // to the honest COMMUNICATION_CONSUMED steer-ack signal (fleet-read-model.ts).
   const fleetReadModel = createFleetReadModel(ui.runtime.processRegistry, ui.runtime.runtimeBus);
 
@@ -51,16 +51,16 @@ export function registerOperationsPanels(manager: PanelManager, deps: ResolvedBu
     description: 'Live unified process tree: agents, WRFC chains, workflows, watchers, and background processes, with interrupt/kill/steer controls',
     factory: () => new FleetPanel(fleetReadModel, {
       interrupt: (id: string) => fleetReadModel.interrupt(id),
-      // Wave-6 (wo-F item d2): re-arm a paused trigger/schedule/automation job.
+      // Re-arm a paused trigger/schedule/automation job.
       resume: (id: string) => fleetReadModel.resume(id),
       kill: (id: string, opts: { cascade: boolean }) => fleetReadModel.kill(id, opts),
-      // Wave-3 (C6): full-fidelity transcript source for an attached agent
+      // Full-fidelity transcript source for an attached agent
       // tab — live while the agent runs, frozen briefly after it completes
       // (AgentManager's bounded retention ring), empty once evicted (the
       // panel degrades to the on-disk ledger fallback in that case).
       getConversationSnapshot: (agentId: string) => ui.agents.agentManager.getConversationSnapshot(agentId),
       resolveSessionLogPath: (agentId: string) => ui.environment.shellPaths.resolveProjectPath('tui', 'sessions', `${agentId}.jsonl`),
-      // Wave-3 (W3.2): queue a message for a live in-process agent/wrfc-subtask member.
+      // Queue a message for a live in-process agent/wrfc-subtask member.
       steer: (id: string, text: string) => fleetReadModel.steer(id, text),
     }, deps.configManager),
   });

package/src/panels/builtin/shared.ts

@@ -86,7 +86,7 @@ export interface BuiltinPanelDeps {
   /** Approval broker for control-plane/operator panels. */
   approvalBroker?: ApprovalBroker;
   /**
-   * S3d: cross-surface session READ facade for control-plane/operator panels.
+   * Cross-surface session READ facade for control-plane/operator panels.
    * Sync listSessions()/getSession() shape preserved; in adopted-daemon mode it
    * serves the daemon-hosted union (with an honest offline note when the wire is
    * down) instead of only this process's local broker. See session-union-cache.ts.

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

@@ -2,7 +2,7 @@
 // fleet-panel-format.ts
 //
 // Pure column-layout + cell-formatting helpers for FleetPanel's tree rows.
-// Extracted from fleet-panel.ts (S3b hygiene) to hold that file under the
+// Extracted from fleet-panel.ts (file-size hygiene) to hold that file under the
 // 800-line architecture cap; these are stateless functions the panel's
 // renderItem/renderDetail call, with no `this` dependency.
 // ---------------------------------------------------------------------------

package/src/panels/fleet-panel.ts

@@ -58,21 +58,21 @@ const C = DEFAULT_PANEL_PALETTE;
 export interface FleetActionCallbacks {
   /** Graceful interruption (AgentManager.cancel / trigger-schedule disable, via the registry). */
   readonly interrupt: (id: string) => boolean;
-  /** Wave-6 (wo-F item d2): re-arm a `paused` node (disabled trigger/schedule or automation job) — interrupt()'s inverse. Honest false when not paused / non-resumable. */
+  /** 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[];
   /**
-   * Wave-3 (C6): fetch an agent's conversation history — live (running) or
+   * 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[];
-  /** Wave-3 (C6): resolve the on-disk `<agentId>.jsonl` event-ledger path for the degraded fallback view. */
+  /** Resolve the on-disk `<agentId>.jsonl` event-ledger path for the degraded fallback view. */
   readonly resolveSessionLogPath: (agentId: string) => string;
   /**
-   * Wave-3 (W3.2): queue a human message for a live in-process agent (or a
+   * 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
@@ -128,7 +128,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
       this.reconcileSteerBadges();
       this.markDirty();
     });
-    // Wave-3 (W3.2): the honest "the agent actually consumed this steer at
+    // 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.
@@ -179,13 +179,13 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
     for (const tab of this.tabsState.tabs) tab.lineCache.clear();
   }
 
-  /** True while a session tab (not the root tree) is focused. Replaces the old Wave-2 isDetailFocused() seam. */
+  /** True while a session tab (not the root tree) is focused. Replaces the old isDetailFocused() seam. */
   public isTabActive(): boolean {
     return this.tabsState.activeTabIndex > 0;
   }
 
   /**
-   * Wave-3 (W3.2): true while the steer composer on the active tab is open —
+   * 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
@@ -207,7 +207,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
   }
 
   /**
-   * Ctrl+X (panel-close) collision resolution (Wave-3 Part C4): the global
+   * 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
@@ -317,7 +317,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
   }
 
   /**
-   * Wave-3 (W3.2, risk #2 — "dropped inference"): called on every read-model
+   * 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).
@@ -350,7 +350,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
     // Confirm overlay owns input first (K-armed kill confirm).
     if (this.confirmOverlay.handleInput(key)) return true;
 
-    // Wave-3 (W3.2): once the steer composer is open on the active tab, it
+    // 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
@@ -458,7 +458,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
     }
 
     if (key === 's') {
-      // Batch replay D4: 's' from the TREE was silently dead — steering
+      // 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;
@@ -485,7 +485,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
   }
 
   /**
-   * Wave-3 (W3.2): the `s` gate — mirrors the i/K capability-gating template
+   * 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).
    */
@@ -649,13 +649,13 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
 
     const snapshotRows = this.readModel.getSnapshot().rows;
     const liveNode = snapshotRows.find((row) => row.node.id === tab.nodeId)?.node ?? null;
-    // Wave-3 (W3.2): the steer composer only ever applies to 'agent' tabs
+    // 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;
 
-    // Wave-3 (W3.2): while composing, Enter/Esc replace the tab-switch/detach
+    // 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
@@ -739,7 +739,7 @@ export class FleetPanel extends ScrollableListPanel<FleetTreeRow> {
     const hints = buildFleetTreeHints(selected?.node, this.follow, this.tabsState.tabs.length > 0);
 
     // Tab strip renders only when tabs exist — omitting it entirely with no
-    // tabs attached keeps the pre-Wave-3 root-tree rendering byte-identical.
+    // tabs attached keeps the pre-session-tab root-tree rendering byte-identical.
     const stripLine = renderFleetTabStrip(this.tabsState, width);
     const header = stripLine ? [stripLine] : undefined;
 

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

@@ -71,7 +71,7 @@ export interface FleetSnapshot {
 
 export type FleetStateTone = 'active' | 'success' | 'failure' | 'warn' | 'muted';
 
-// W6-P1 ruling: this is a DIFFERENT table from the SDK presentation
+// Design ruling: this is a DIFFERENT table from the SDK presentation
 // contract's STATE_GLYPHS (@pellux/goodvibes-sdk/platform/presentation) — that
 // one is a 4-state semantic alias (good/warn/bad/info) shared by the TUI and
 // agent renderers; this one is a 12-state ProcessNode taxonomy specific to the
@@ -90,16 +90,16 @@ const STATE_GLYPHS: Record<ProcessState, string> = {
   done: '✓',
   failed: '✗',
   killed: '⊘',
-  // Wave-3 verb formalization: a distinct TERMINAL outcome from 'killed' —
+  // A distinct TERMINAL outcome from 'killed' —
   // both come from AgentManager.cancel(), but a graceful interrupt request
   // ('the operator asked nicely') is display-distinguishable from a hard
   // kill. '◌' verified free against every other glyph in this table.
   interrupted: '◌',
   idle: '·',
   queued: '…',
-  // Wave-6 SDK: schedules/triggers/automation jobs report 'paused' when
+  // SDK behavior: schedules/triggers/automation jobs report 'paused' when
   // disabled (previously mislabeled 'killed'). NOT terminal — resumable via
-  // ProcessRegistry.resume() (W6.2 d2 wires the full pause/resume UI in
+  // ProcessRegistry.resume() (the full pause/resume UI lives in
   // fleet-stop.ts). '❚' verified free against every other glyph in this table.
   paused: '❚',
 };
@@ -140,11 +140,11 @@ const KIND_TAGS: Record<ProcessKind, string> = {
   schedule: 'sched',
   watcher: 'watch',
   'background-process': 'exec',
-  // Wave 4 (wo703): orchestration-engine kinds (adapters/orchestration.ts).
+  // Orchestration-engine kinds (adapters/orchestration.ts).
   workstream: 'stream',
   phase: 'phase',
   'work-item': 'item',
-  // Wave 5 (wo804): the repo source-tree code index (adapters/code-index.ts).
+  // The repo source-tree code index (adapters/code-index.ts).
   // A single leaf node — never a rollup of other flat-list nodes (see
   // ROLLUP_KINDS below) — so no other list in this module needs updating.
   'code-index': 'index',
@@ -288,7 +288,7 @@ export function buildFleetRows(nodes: readonly ProcessNode[]): FleetTreeRow[] {
  *     nonzero cost/token reading (defense in depth against a future adapter
  *     change, not load-bearing).
  *
- * Wave 4 (wo703) additions — verified against adapters/orchestration.ts:
+ * Orchestration-engine additions — verified against adapters/orchestration.ts:
  *   - 'workstream': adaptWorkstream SUMS every work-item's usage/costUsd
  *     exactly once (sumWorkItemUsage/aggregateWorkItemCost), the same
  *     "rollup of nodes that also appear individually" shape as adaptChain —
@@ -308,7 +308,7 @@ export function buildFleetRows(nodes: readonly ProcessNode[]): FleetTreeRow[] {
  *     'wrfc-subtask'-for-capabilities analogue but the 'agent'-for-usage
  *     analogue. Excluding it would silently zero out real cost/token totals.
  *
- * Wave 5 (wo804): 'code-index' is deliberately NOT in this set either —
+ * 'code-index' is deliberately NOT in this set either —
  * adaptCodeIndex yields exactly one standalone ProcessNode per registry
  * (never a parent whose children ALSO appear individually in the flat
  * list), so it is a leaf like 'agent'/'work-item', not a grouping construct.
@@ -435,7 +435,7 @@ export interface FleetReadModel {
   /** Graceful interruption where the source supports one. Returns true when accepted. */
   interrupt(id: string): boolean;
   /**
-   * Wave-6 (wo-F item d2): re-arm a `paused` node (a disabled trigger/schedule,
+   * Re-arm a `paused` node (a disabled trigger/schedule,
    * or an automation job). The inverse of interrupt()'s pause. Returns true when
    * accepted; false for a node that is not currently `paused` or whose kind has
    * no resume path (honest refusal).
@@ -444,14 +444,14 @@ export interface FleetReadModel {
   /** Hard stop, optionally cascading to descendants. Returns the node ids acted on. */
   kill(id: string, opts?: { readonly cascade?: boolean }): readonly string[];
   /**
-   * Wave-3 (W3.2): queue a human message for a live in-process agent (or a
+   * Queue a human message for a live in-process agent (or a
    * wrfc-subtask's current live member), delivered at its next turn
    * boundary. Honest refusal (`{queued:false,reason}`) for anything that
    * cannot take mid-run input — see ProcessRegistry.steer's doc comment.
    */
   steer(id: string, text: string): SteerResult;
   /**
-   * Wave-3 (W3.2): subscribe to the honest "the agent actually consumed this
+   * Subscribe to the honest "the agent actually consumed this
    * steer at its turn boundary" signal (COMMUNICATION_CONSUMED on the
    * runtime bus's 'communication' domain). Returns an unsubscribe function.
    * A read-model constructed without a runtimeBus (e.g. the static factory,

package/src/panels/fleet-steer.ts

@@ -1,7 +1,7 @@
 // ---------------------------------------------------------------------------
 // fleet-steer.ts
 //
-// Wave-3 (W3.2) — steer-badge rendering helpers and the "dropped inference"
+// Steer-badge rendering helpers and the "dropped inference"
 // reconciliation pass, split out of fleet-panel.ts to keep that file under
 // the architecture line cap (see check-architecture.ts's 800-line gate).
 // Pure functions only; FleetPanel still owns the mutable FleetTab.steerBadge
@@ -67,7 +67,7 @@ export function renderSteerBadgeLine(badge: SteerBadge, width: number, palette:
 }
 
 /**
- * Wave-3 (W3.2, risk #2 — "dropped inference"): the SDK emits no
+ * The "dropped inference" risk: the SDK emits no
  * cancelled/expired signal for a queued steer, so a badge left `queued`
  * after its target node goes terminal (done/failed/killed/interrupted)
  * would hang forever with no honest resolution. Resolves any such badge to

package/src/panels/fleet-stop.ts

@@ -115,7 +115,7 @@ export function buildFleetTreeHints(
     { keys: 'j/k', label: 'navigate' },
     { keys: 'Enter', label: 'attach' },
   ];
-  if (live && selected.capabilities.steerable) hints.push({ keys: 's', label: 'steer' }); // D4: discoverable from the tree (attach-and-steer)
+  if (live && selected.capabilities.steerable) hints.push({ keys: 's', label: 'steer' }); // discoverable from the tree (attach-and-steer)
   if (live && selected.capabilities.interruptible) hints.push({ keys: 'i', label: 'interrupt' });
   if (live && selected.capabilities.killable) hints.push({ keys: 'K', label: 'kill' });
   if (live && !isPaused && selected.capabilities.pausable) hints.push({ keys: 'p', label: 'pause' });
@@ -125,7 +125,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" (Wave-3 C7), undercounting a mixed subtree. */
+/** 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. */
 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

@@ -1,7 +1,7 @@
 // ---------------------------------------------------------------------------
 // fleet-tabs.ts
 //
-// Wave-3 (W3.1 Part C) — pure, testable tab-state model for FleetPanel's
+// Pure, testable tab-state model for FleetPanel's
 // session tabs. No BasePanel/rendering dependency, mirroring the
 // fleet-read-model.ts convention: this module owns attach/detach/switch as
 // pure state transitions over a small immutable FleetTabsState, so the tab
@@ -32,7 +32,7 @@ export function isAttachableFleetKind(kind: ProcessKind): kind is FleetAttachabl
 }
 
 /**
- * Wave-3 (W3.2 steering) — lifecycle of a queued steer message, tracked
+ * Lifecycle of a queued steer message, tracked
  * per-tab. `queued` means `ProcessRegistry.steer()` accepted the message
  * onto the target's inbox, NOT that the agent has seen it — that is the
  * later, honest `consumed` transition (a `COMMUNICATION_CONSUMED` runtime-bus
@@ -119,14 +119,14 @@ export interface FleetTab {
   ledgerEntries: Record<string, unknown>[] | null;
   ledgerLoadStarted: boolean;
   /**
-   * Wave-3 (W3.2): the one-line steer composer's in-progress text, or `null`
+   * The one-line steer composer's in-progress text, or `null`
    * when not composing. Mirrors git-panel.ts's `commitMessage` mutable-slot
    * convention (FleetPanel.isCapturingTextBurst() gates on this being
    * non-null so a burst/paste lands here char-by-char, never as tree/tab
    * hotkeys — see FleetPanel.handleSteerInput).
    */
   steerDraft: string | null;
-  /** Wave-3 (W3.2): this tab's most recent steer message's lifecycle, or null. */
+  /** This tab's most recent steer message's lifecycle, or null. */
   steerBadge: SteerBadge | null;
 }
 

package/src/panels/fleet-transcript.ts

@@ -1,9 +1,9 @@
 // ---------------------------------------------------------------------------
 // fleet-transcript.ts
 //
-// Wave-3 (W3.1 Part C6) — renders the content of an attached FleetPanel
+// Renders the content of an attached FleetPanel
 // session tab. Three sources, chosen by what the SDK can actually provide
-// (see the W3.1 brief's "central reality check" — a full-fidelity live
+// (see the design brief's "central reality check" — a full-fidelity live
 // transcript needs a ConversationMessageSnapshot[] history source, which
 // only exists for a RUNNING agent or a just-completed one still inside the
 // SDK's bounded retention ring):
@@ -163,8 +163,8 @@ export function renderFleetAgentTranscript(
 /**
  * Render a live one-line-per-member summary for an attached wrfc-chain tab.
  *
- * `chainDoneOrAbsent` disambiguates an empty member list (d3, W6.2): a completed
- * chain prunes its wrapper node (Wave-3 reap), so zero members can mean the
+ * `chainDoneOrAbsent` disambiguates an empty member list: a completed
+ * chain prunes its wrapper node (zombie reap), so zero members can mean the
  * chain FINISHED, not that it has not started. When the chain node is absent
  * (pruned) or terminal, say so honestly instead of the "(no member agents yet)"
  * not-started wording.
@@ -284,7 +284,7 @@ function renderLedgerEntry(width: number, entry: Record<string, unknown>, palett
         { text: `${status}${formatLedgerDuration(entry['durationMs'])}`, fg: tone },
       ]);
     }
-    // W5.2 (wo803) — Wave-5 wo801 per-turn passive knowledge injection
+    // Per-turn passive knowledge injection
     // records, appended to this same JSONL ledger as
     // `{type:'knowledge_injection', turn, ...record}` (orchestrator-runner.ts).
     // Without this case these fell through to the generic 'event' default

package/src/panels/types.ts

@@ -142,7 +142,7 @@ export interface Panel {
   /**
    * Optional: called by the global Ctrl+X (`panel-close`) shortcut BEFORE it
    * closes this panel (handler-shortcuts.ts). Return `true` to consume
-   * Ctrl+X for an in-panel action instead — e.g. FleetPanel (Wave-3 session
+   * Ctrl+X for an in-panel action instead — e.g. FleetPanel (session
    * tabs) detaches its active tab and leaves the panel open. Return `false`
    * (or omit this hook) to fall through to the ordinary close behavior.
    * Ctrl+X never reaches a panel's own `handleInput` (ctrl/meta combos are

package/src/renderer/compaction-quality.ts

@@ -1,5 +1,5 @@
 /**
- * Compaction quality-score bridging (Wave-5 W5.4 / B28).
+ * Compaction quality-score bridging.
  *
  * Reality check (wo803): the SDK's `computeQualityScore()`
  * (platform/runtime/compaction/quality-score.ts) is only ever called from a

package/src/renderer/fleet-tab-strip.ts

@@ -1,7 +1,7 @@
 // ---------------------------------------------------------------------------
 // fleet-tab-strip.ts
 //
-// Wave-3 (W3.1 Part C3) — renders FleetPanel's session-tab strip by reusing
+// Renders FleetPanel's session-tab strip by reusing
 // renderTabStrip exactly as panel-workspace-bar.ts does for the workspace
 // tab bar. Deliberately a SEPARATE, visually distinct strip from the
 // workspace bar: workspace tabs switch PANELS, fleet session tabs switch
@@ -23,7 +23,7 @@ const LABEL_FG = UI_TONES.fg.secondary;
 /**
  * Render the fleet session-tab strip, or `null` when there are no attached
  * tabs — the panel omits the strip entirely in that case (root-tab-only),
- * which is what keeps the pre-Wave-3 fleet-panel goldens byte-identical.
+ * which is what keeps the pre-session-tab fleet-panel goldens byte-identical.
  */
 export function renderFleetTabStrip(
   state: FleetTabsState,

package/src/renderer/footer-tips.ts

@@ -29,7 +29,7 @@ export function isAgentActive(composerStatus: string | undefined): boolean {
 // shell/ui-openers.ts). The bare noun 'panels' undersold that; naming the verb
 // keeps the tip honest about what the chord actually does.
 const TIP_PANELS = 'Ctrl+P toggle panels';
-// W6.2 e: F2 now opens the Fleet panel (the process modal was retired), so the
+// F2 now opens the Fleet panel (the process modal was retired), so the
 // tip names 'fleet', not 'processes'.
 const TIP_PROCESSES = 'F2 fleet';
 const TIP_HELP = '? help';

package/src/renderer/model-workspace.ts

@@ -189,7 +189,7 @@ function detailLines(picker: ModelPickerModal, width: number): string[] {
   } else {
     lines.push(`Context cap overrides the detected local-model context window for this selection.`);
   }
-  // W3-T2: a visible cursor glyph on the query itself when search is focused —
+  // A visible cursor glyph on the query itself when search is focused —
   // the only prior affordance was a footer-hint text swap ('/ search' vs.
   // 'Typing filters search...'), buried at the end of a long hint line and
   // easy to miss (confirmed via live tmux repro). This puts the "you are

package/src/renderer/session-picker-modal.ts

@@ -6,7 +6,7 @@
  *   - name, timestamp (formatted), message count
  * Footer hints: [Enter] Load  [d] Delete  [Esc] Close
  *
- * W3-T2: when the modal was wired with a cross-surface session union
+ * When the modal was wired with a cross-surface session union
  * (`modal.crossSurfaceView.mode !== 'local'`), an additional read-only
  * "Cross-surface sessions" section is appended, badged kind/status/project
  * (parity with the webui SessionsView) with one of three honest states —
@@ -66,7 +66,7 @@ function isReapedRecord(record: SharedSessionRecord): boolean {
 }
 
 /**
- * Wave-4 UX-lens note: 'reaped' names a mechanism (the idle-session sweep),
+ * UX-lens note: 'reaped' names a mechanism (the idle-session sweep),
  * not a state a first-time reader can guess — the webui pairs its own
  * 'reaped' badge with a tooltip explaining it
  * (SessionsView.tsx: "Closed by the idle-session sweep — reopens
@@ -96,7 +96,7 @@ const MAX_CROSS_SURFACE_ROWS = 5;
 /**
  * The exact honest note for the current state, or null when the union view
  * needs no caveat (fresh/embedded with rows). Precedence: offline > stale >
- * true-empty — the three states from the W3-T2 brief, never collapsed into
+ * true-empty — the three designed states, never collapsed into
  * each other (an offline view never silently renders as "no sessions yet").
  */
 function crossSurfaceNote(view: SessionPickerModal['crossSurfaceView'], rowCount: number): string | null {
@@ -238,7 +238,7 @@ export function renderSessionPickerModal(
     }
   }
 
-  // W3-T2: cross-surface session union — visible only when a sessionBroker
+  // Cross-surface session union — visible only when a sessionBroker
   // was wired (mode !== 'local'); absent entirely otherwise, so the box size
   // and content of every pre-existing (local-only) caller is unaffected.
   if (modal.crossSurfaceView.mode !== 'local') {

package/src/renderer/shell-surface.ts

@@ -48,7 +48,7 @@ export interface ShellFooterBuildOptions {
    */
   readonly compact?: boolean;
   /**
-   * S3d: cross-surface session-spine posture for the context-info segment.
+   * Cross-surface session-spine posture for the context-info segment.
    * Set ONLY in adopted-daemon mode ('online'/'offline'); left undefined in
    * embedded/local mode so no segment renders.
    */

package/src/renderer/status-glyphs.ts

@@ -4,9 +4,9 @@
 // Extracted as a neutral module so both status-token.ts and polish.ts can
 // import from here without creating a circular ESM dependency.
 //
-// W6-P1: STATE_GLYPHS is no longer hardcoded here. It is the SDK presentation
-// contract (@pellux/goodvibes-sdk/platform/presentation, landed by W4-S1 and
-// already adopted by the agent in W4-R4), aliased to GLYPHS.status so the
+// STATE_GLYPHS is no longer hardcoded here. It is the SDK presentation
+// contract (@pellux/goodvibes-sdk/platform/presentation, and
+// already adopted by the agent), aliased to GLYPHS.status so the
 // four semantic glyphs are spelled out in exactly one place and can never
 // drift from the registry again. Re-exported under the historical name so
 // status-token.ts and polish.ts import unchanged.

package/src/renderer/terminal-bg-probe.ts

@@ -1,7 +1,7 @@
 /**
  * terminal-bg-probe — OSC 11 terminal-background detection for `auto` theme mode.
  *
- * DEBT-2 / F5. On startup, when appearance is `auto` and stdout is a TTY, we ask
+ * DEBT-2. On startup, when appearance is `auto` and stdout is a TTY, we ask
  * the terminal for its background colour with an OSC 11 query and classify the
  * reply as light or dark. Everything about this is best-effort and conservative:
  * any timeout, any unparseable reply, any ambiguity resolves to DARK, which is