@pellux/goodvibes-tui 0.27.0 → 0.28.0

package/src/panels/provider-stats-panel.ts

@@ -5,18 +5,31 @@ import type { UiEventFeed } from '../runtime/ui-events.ts';
 import type { UiProvidersSnapshot, UiReadModel } from '../runtime/ui-read-models.ts';
 import {
   buildEmptyState,
+  buildKeyboardHints,
   buildKeyValueLine,
+  buildPanelLine,
   buildStyledPanelLine,
   buildPanelWorkspace,
   DEFAULT_PANEL_PALETTE,
+  extendPalette,
   type PanelWorkspaceSection,
 } from './polish.ts';
 import { truncateDisplay } from '../utils/terminal-width.ts';
+import { formatLatencyMs } from '../utils/format-duration.ts';
 
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
 
+// Domain-specific tones not covered by the base palette (latency/token greys).
+const C = extendPalette(DEFAULT_PANEL_PALETTE, {
+  muted2:    '#6b7280', // secondary dim grey for unit labels
+  sep:       '#374151', // inline separator grey
+  tokenDim:  '#64748b', // token-count grey
+  p95:       '#a78bfa', // p95 latency accent
+  latYellow: '#eab308', // mid-latency warning
+});
+
 const SPARKLINE_CHARS = '._-:=+*#';
 const LATENCY_RING_SIZE = 20;
 
@@ -202,7 +215,10 @@ export class ProviderStatsPanel extends BasePanel {
               width,
               ' No providers registered',
               'Load or configure a provider to begin collecting per-provider latency and error metrics.',
-              [],
+              [
+                { command: '/provider', summary: 'review current provider and model selection' },
+                { command: '/subscription', summary: 'sign in to a subscription-backed provider' },
+              ],
               DEFAULT_PANEL_PALETTE,
             ),
           },
@@ -245,6 +261,18 @@ export class ProviderStatsPanel extends BasePanel {
       title: ' Provider Stats',
       intro: 'Per-provider request performance, latency distribution, error pressure, and session totals.',
       sections: providerSections,
+      footerLines: [
+        buildPanelLine(width, [
+          ['  sparkline ', C.muted2],
+          ['low', C.good],
+          [' → ', C.muted2],
+          ['high latency', C.bad],
+        ]),
+        buildKeyboardHints(width, [
+          { keys: '/provider', label: 'switch provider/model' },
+          { keys: '/health', label: 'live provider health' },
+        ], DEFAULT_PANEL_PALETTE),
+      ],
       palette: DEFAULT_PANEL_PALETTE,
     });
   }
@@ -262,7 +290,7 @@ export class ProviderStatsPanel extends BasePanel {
 
     // Determine health
     const hasErrors = rec !== undefined && rec.errors > 0;
-    const dotColor = hasErrors ? '#ef4444' : '#22c55e';
+    const dotColor = hasErrors ? C.bad : C.good;
 
     // Model ID (truncated)
     const modelId = rec?.lastModelId ?? 'n/a';
@@ -271,18 +299,18 @@ export class ProviderStatsPanel extends BasePanel {
     // Header row: * provider  model
     // Build as segments to avoid multi-byte char indexing issues
     const headerLine = buildStyledPanelLine(width, [
-      { text: '  ', fg: '#94a3b8' },
+      { text: '  ', fg: C.label },
       { text: '●', fg: dotColor },
-      { text: ' ', fg: '#94a3b8' },
-      { text: `${truncateDisplay(provName, 14).padEnd(14)} `, fg: '#e2e8f0', bold: true },
-      { text: modelDisplay, fg: '#cbd5e1' },
+      { text: ' ', fg: C.label },
+      { text: `${truncateDisplay(provName, 14).padEnd(14)} `, fg: C.value, bold: true },
+      { text: modelDisplay, fg: C.accent },
     ]);
 
     rows.push(headerLine);
 
     if (rec === undefined || rec.requests === 0) {
       rows.push(buildStyledPanelLine(width, [
-        { text: '    No requests yet.', fg: '#6b7280' },
+        { text: '    No requests yet.', fg: C.muted2 },
       ]));
     } else {
       const avgLatency = this._avg(rec.latencies);
@@ -291,24 +319,24 @@ export class ProviderStatsPanel extends BasePanel {
       const sparkline = this._sparkline(rec.latencies);
 
       const latFg = avgLatency < LATENCY_GREEN
-        ? '#22c55e'
+        ? C.good
         : avgLatency < LATENCY_YELLOW
-          ? '#eab308'
-          : '#ef4444';
+          ? C.latYellow
+          : C.bad;
 
       const segments = [
-        { text: '    avg ', fg: '#6b7280' },
+        { text: '    avg ', fg: C.muted2 },
         { text: this._fmtMs(avgLatency).padStart(6), fg: latFg, bold: true },
-        { text: '  p95 ', fg: '#6b7280' },
-        { text: this._fmtMs(p95Latency).padStart(6), fg: '#a78bfa' },
-        { text: '  ', fg: '#374151' },
+        { text: '  p95 ', fg: C.muted2 },
+        { text: this._fmtMs(p95Latency).padStart(6), fg: C.p95 },
+        { text: '  ', fg: C.sep },
         { text: sparkline, fg: latFg },
-        { text: '  err ', fg: '#6b7280' },
-        { text: `${errRate.toFixed(0).padStart(3)}%`, fg: errRate > 0 ? '#ef4444' : '#22c55e' },
-        { text: `  ${rec.requests.toString().padStart(4)}r`, fg: '#94a3b8' },
+        { text: '  err ', fg: C.muted2 },
+        { text: `${errRate.toFixed(0).padStart(3)}%`, fg: errRate > 0 ? C.bad : C.good },
+        { text: `  ${rec.requests.toString().padStart(4)}r`, fg: C.label },
       ] as const;
       const tokenSegment = rec.totalTokens > 0
-        ? [{ text: `  ${rec.totalTokens.toString().padStart(6)}tok`, fg: '#64748b' }]
+        ? [{ text: `  ${rec.totalTokens.toString().padStart(6)}tok`, fg: C.tokenDim }]
         : [];
       rows.push(buildStyledPanelLine(width, [...segments, ...tokenSegment]));
     }
@@ -351,10 +379,7 @@ export class ProviderStatsPanel extends BasePanel {
   }
 
   private _fmtMs(ms: number): string {
-    if (ms <= 0) return 'n/a';
-    if (ms >= 10000) return `${(ms / 1000).toFixed(1)}s`;
-    if (ms >= 1000) return `${(ms / 1000).toFixed(2)}s`;
-    return `${Math.round(ms)}ms`;
+    return formatLatencyMs(ms);
   }
 
   private _latencyColor(ms: number): string {

package/src/panels/qr-panel.ts

@@ -2,9 +2,12 @@ import type { Line } from '../types/grid.ts';
 import { createEmptyLine } from '../types/grid.ts';
 import { BasePanel } from './base-panel.ts';
 import {
+  buildKeyboardHints,
   buildPanelLine,
+  buildPanelTitle,
   DEFAULT_PANEL_PALETTE,
 } from './polish.ts';
+import { truncateDisplay } from '../utils/terminal-width.ts';
 import { renderQrMatrix, generateQrMatrix } from '../renderer/qr-renderer.ts';
 import { encodeConnectionPayload } from '@pellux/goodvibes-sdk/platform/pairing';
 
@@ -101,32 +104,41 @@ export class QrPanel extends BasePanel {
     const lines: Line[] = [];
 
     const { url, token, username, password } = this.connectionInfo;
+    const valueWidth = Math.max(0, width - 12);
+
+    // ── Title + purpose: tell the operator exactly what this code is for ────
+    lines.push(buildPanelTitle(width, 'Companion Pairing', C));
+    lines.push(
+      buildPanelLine(width, [
+        [' Scan with the GoodVibes companion app to pair this session.', C.hint],
+      ]),
+    );
 
     // ── Connection info header ─────────────────────────────────────────────
     lines.push(createEmptyLine(width));
     lines.push(
       buildPanelLine(width, [
         [' URL      ', C.label],
-        [url.slice(0, Math.max(0, width - 12)), C.url],
+        [truncateDisplay(url, valueWidth), C.url],
       ]),
     );
     lines.push(
       buildPanelLine(width, [
         [' Token    ', C.label],
-        [token, C.token],
+        [truncateDisplay(token, valueWidth), C.token],
       ]),
     );
     lines.push(
       buildPanelLine(width, [
         [' Username ', C.label],
-        [username.slice(0, Math.max(0, width - 12)), C.value],
+        [truncateDisplay(username, valueWidth), C.value],
       ]),
     );
     if (password !== undefined) {
       lines.push(
         buildPanelLine(width, [
           [' Password ', C.label],
-          [password, C.value],
+          [truncateDisplay(password, valueWidth), C.value],
         ]),
       );
     }
@@ -158,13 +170,13 @@ export class QrPanel extends BasePanel {
       );
     }
 
-    // ── Hints ──────────────────────────────────────────────────────────────
-    const hintsLine = buildPanelLine(width, [
-      [' r ', C.hint],
-      ['regenerate  ', C.dim],
-      [' c ', C.hint],
-      ['copy token', C.dim],
-    ]);
+    // ── Hints ── only advertise actions that are actually wired ─────────────
+    const hints: Array<{ keys: string; label: string }> = [];
+    if (this.regenerateToken) hints.push({ keys: 'r', label: 'regenerate token' });
+    if (this.copyToClipboard) hints.push({ keys: 'c', label: 'copy token' });
+    const hintsLine = hints.length > 0
+      ? buildKeyboardHints(width, hints, C)
+      : buildPanelLine(width, [[' Pairing is read-only in this surface.', C.dim]]);
 
     // Push hints at the bottom if we have room, otherwise append after QR
     const remaining = height - lines.length;

package/src/panels/remote-panel.ts

@@ -200,7 +200,7 @@ export class RemotePanel extends BasePanel {
     if (daemon.lastError) {
       postureLines.push(buildPanelLine(width, [
         [' daemon error ', C.label],
-        [daemon.lastError.slice(0, Math.max(0, width - 14)), C.error],
+        [truncateDisplay(daemon.lastError, Math.max(0, width - 14)), C.error],
       ]));
     }
     postureLines.push(
@@ -208,9 +208,16 @@ export class RemotePanel extends BasePanel {
       buildGuidanceLine(width, '/remote capabilities', 'inspect transport support before routing remote work or reattaching a session', C),
     );
 
+    const canBrowse = activeConnections.length > 0 || contracts.length > 0;
+    const canSwitch = contracts.length > 0 && activeConnections.length > 0;
+    const navHint = !canBrowse
+      ? `  focus=${this.browseMode}  idle - no connections or contracts to browse`
+      : canSwitch
+        ? `  focus=${this.browseMode}  Up/Down move  Tab switch connections/contracts`
+        : `  focus=${this.browseMode}  Up/Down move`;
     const footerLines = [
       buildGuidanceLine(width, '/remote setup', 'review bridge, tunnel, env, and bootstrap flows for self-hosted remote work', C),
-      buildPanelLine(width, [[`  focus=${this.browseMode}  Up/Down move  Tab switch connections/contracts`, C.dim]]),
+      buildPanelLine(width, [[navHint, C.dim]]),
     ] as const;
 
     if (activeConnections.length === 0 && contracts.length === 0) {
@@ -318,7 +325,7 @@ export class RemotePanel extends BasePanel {
           ['  Review: ', C.label],
           [supervisorEntry.negotiation.reviewMode, supervisorEntry.negotiation.reviewMode === 'wrfc' ? C.ok : C.dim],
         ]));
-        detailRows.push(buildPanelLine(width, [[`  ${supervisorEntry.heartbeat.detail}`.slice(0, width), C.dim]]));
+        detailRows.push(buildPanelLine(width, [[truncateDisplay(`  ${supervisorEntry.heartbeat.detail}`, width), C.dim]]));
       }
 
       const recentArtifact = snapshot.artifacts.find((artifact) => artifact.runnerId === selected.agentId);
@@ -400,7 +407,7 @@ export class RemotePanel extends BasePanel {
             { text: ` ${connection.transportState.padEnd(18)}`, fg: stateColor(connection.transportState) },
             { text: ` msgs=${String(connection.messageCount).padEnd(6)}`, fg: C.info },
             { text: ` errs=${String(connection.errorCount).padEnd(4)}`, fg: connection.errorCount > 0 ? C.warn : C.dim },
-            { text: ` ${connection.label}`.slice(0, Math.max(0, width - 56)), fg: C.dim },
+            { text: truncateDisplay(` ${connection.label}`, Math.max(0, width - 56)), fg: C.dim },
           ], C, { selected: absolute === this.selectedIndex, selectedBg: C.headerBg });
         })
       : [
@@ -408,7 +415,7 @@ export class RemotePanel extends BasePanel {
             return buildPanelListRow(width, [
               { text: contract.runnerId.padEnd(18), fg: C.value },
               { text: ` ${contract.transport.state.padEnd(18)}`, fg: stateColor(contract.transport.state) },
-              { text: ` ${contract.template}`.slice(0, Math.max(0, width - 42)), fg: C.dim },
+              { text: truncateDisplay(` ${contract.template}`, Math.max(0, width - 42)), fg: C.dim },
             ], C, { selected: absolute === this.selectedIndex, selectedBg: C.headerBg });
           }),
           buildPanelLine(width, [[' No active connection is currently attached to these contracts.', C.dim]]),

package/src/panels/routes-panel.ts

@@ -4,9 +4,11 @@ import { ScrollableListPanel } from './scrollable-list-panel.ts';
 import type { UiReadModel, UiRoutesSnapshot } from '../runtime/ui-read-models.ts';
 import { truncateDisplay } from '../utils/terminal-width.ts';
 import {
+  buildDetailBlock,
   buildEmptyState,
   buildGuidanceLine,
   buildKeyValueLine,
+  buildKeyboardHints,
   buildPanelLine,
   buildPanelWorkspace,
   buildStatusPill,
@@ -39,10 +41,20 @@ export class RoutesPanel extends ScrollableListPanel<RouteBinding> {
   public constructor(readModel?: UiReadModel<UiRoutesSnapshot>) {
     super('routes', 'Routes', 'R', 'monitoring');
     this.showSelectionGutter = true; // I5: non-color selection affordance
+    this.filterEnabled = true;
+    this.filterLabel = 'Filter routes';
     this.readModel = readModel;
     this.unsub = readModel ? readModel.subscribe(() => this.markDirty()) : null;
   }
 
+  protected override filterMatches(binding: RouteBinding, q: string): boolean {
+    return binding.surfaceKind.toLowerCase().includes(q)
+      || (binding.title ?? '').toLowerCase().includes(q)
+      || binding.externalId.toLowerCase().includes(q)
+      || (binding.sessionId ?? '').toLowerCase().includes(q)
+      || (binding.runId ?? '').toLowerCase().includes(q);
+  }
+
   public override onDestroy(): void {
     this.unsub?.();
   }
@@ -127,7 +139,7 @@ export class RoutesPanel extends ScrollableListPanel<RouteBinding> {
     this.clampSelection();
     const selected = bindings[this.selectedIndex]!;
 
-    const footerLines: Line[] = [
+    const detailRows: Line[] = [
       buildPanelLine(width, [
         ['  Binding: ', C.label],
         [selected.id, C.value],
@@ -159,20 +171,30 @@ export class RoutesPanel extends ScrollableListPanel<RouteBinding> {
     ];
 
     if (surfaceEntries.length > 0) {
-      footerLines.push(
-        ...surfaceEntries.slice(0, 6).map(([surface, ids]) => buildPanelLine(width, [
+      detailRows.push(
+        ...surfaceEntries.slice(0, 4).map(([surface, ids]) => buildPanelLine(width, [
           [' ', C.label],
           [surface.padEnd(10), C.info],
           [` ${String(ids.length)} binding(s)`, C.value],
         ])),
       );
     }
-    footerLines.push(buildPanelLine(width, [['  Up/Down move through route bindings', C.dim]]));
+
+    const hints = this.filterActive
+      ? [{ keys: 'type', label: 'filter' }, { keys: 'Enter', label: 'apply' }, { keys: 'Esc', label: 'clear' }]
+      : [
+          { keys: 'Up/Down', label: 'move' },
+          { keys: '/communication', label: 'inspect flow' },
+          { keys: '/', label: 'filter' },
+        ];
 
     return this.renderList(width, height, {
       title: 'Route Bindings',
       header: headerLines,
-      footer: footerLines,
+      footer: [
+        ...buildDetailBlock(width, `Binding · ${selected.surfaceKind}`, detailRows, C),
+        buildKeyboardHints(width, hints, C),
+      ],
     });
   }
 }

package/src/panels/sandbox-panel.ts

@@ -5,9 +5,11 @@ import { ConfigManager } from '@pellux/goodvibes-sdk/platform/config';
 import { buildSandboxReview, listSandboxPresets, listSandboxProfiles } from '@/runtime/index.ts';
 import type { SandboxSessionRegistry } from '@/runtime/index.ts';
 import {
+  buildAlignedRow,
   buildBodyText,
   buildEmptyState,
   buildGuidanceLine,
+  buildKeyboardHints,
   buildKeyValueLine,
   buildPanelLine,
   buildPanelWorkspace,
@@ -125,7 +127,10 @@ export class SandboxPanel extends BasePanel {
       buildGuidanceLine(width, '/sandbox wrapper-test <profile>', 'validate the wrapper bridge contract before wiring a real guest transport', C),
       buildGuidanceLine(width, '/sandbox session run <id> <command> [args...]', 'execute through a tracked sandbox session and capture runtime metadata on the session record', C),
       buildGuidanceLine(width, 'GV_SANDBOX_WRAPPER_MODE=host-exec', 'validate the wrapper contract on the host before wiring a real guest transport', C),
-      buildPanelLine(width, [[`  Up/Down move  Home/End jump  focus=profiles+sessions`, C.dim]]),
+      buildKeyboardHints(width, [
+        { keys: '↑/↓', label: 'select profile/session' },
+        { keys: 'Home/End', label: 'jump to first profile / first session' },
+      ], C),
     ];
 
     const selectionLines: Line[] = [];
@@ -185,41 +190,71 @@ export class SandboxPanel extends BasePanel {
       ));
     } else {
       for (const session of sessions) {
-        const bg = selectedSession?.id === session.id ? C.headerBg : undefined;
-        sessionLines.push(buildPanelLine(width, [
-          ['  ', C.label],
-          [session.profileId.padEnd(15), C.info, bg],
-          [session.state.padEnd(10), session.state === 'running' ? C.good : session.state === 'failed' ? C.bad : C.warn, bg],
-          [(session.shared ? 'shared' : 'dedicated').padEnd(12), C.value, bg],
-          [String(session.resolvedBackend ?? session.backend).padEnd(8), C.dim, bg],
-          [` ${(session.startupStatus ?? 'n/a').slice(0, 8).padEnd(8)}`, session.startupStatus === 'verified' ? C.good : session.startupStatus === 'failed' ? C.bad : C.warn, bg],
-          [` ${String(session.executionCount ?? 0).padStart(3)}x`, C.info, bg],
-          [` ${session.id.slice(0, Math.max(8, Math.min(14, width - 64)))}`, C.dim, bg],
-        ]));
+        const selectedRow = selectedSession?.id === session.id;
+        sessionLines.push(buildAlignedRow(
+          width,
+          [
+            { text: session.profileId, fg: C.info },
+            { text: session.state, fg: session.state === 'running' ? C.good : session.state === 'failed' ? C.bad : C.warn },
+            { text: session.shared ? 'shared' : 'dedicated', fg: C.value },
+            { text: String(session.resolvedBackend ?? session.backend), fg: C.dim },
+            { text: session.startupStatus ?? 'n/a', fg: session.startupStatus === 'verified' ? C.good : session.startupStatus === 'failed' ? C.bad : C.warn },
+            { text: `${session.executionCount ?? 0}x`, fg: C.info },
+            { text: session.id, fg: C.dim },
+          ],
+          [
+            { width: 15 },
+            { width: 10 },
+            { width: 12 },
+            { width: 8 },
+            { width: 9 },
+            { width: 5, align: 'right' },
+            { width: Math.max(8, width - 72) },
+          ],
+          { selected: selectedRow, selectedBg: C.headerBg },
+        ));
       }
     }
 
     const presetLines: Line[] = [];
     for (const preset of presets.slice(0, 2)) {
-      presetLines.push(buildPanelLine(width, [
-        ['  ', C.label],
-        [preset.id.padEnd(18), C.info],
-        [preset.config.replIsolation.padEnd(16), C.value],
-        [preset.config.mcpIsolation.padEnd(16), C.dim],
-        [preset.config.windowsMode, C.warn],
-      ]));
+      presetLines.push(buildAlignedRow(
+        width,
+        [
+          { text: preset.id, fg: C.info },
+          { text: preset.config.replIsolation, fg: C.value },
+          { text: preset.config.mcpIsolation, fg: C.dim },
+          { text: preset.config.windowsMode, fg: C.warn },
+        ],
+        [
+          { width: 18 },
+          { width: 16 },
+          { width: 16 },
+          { width: Math.max(8, width - 62) },
+        ],
+        {},
+      ));
     }
 
     const profileLines: Line[] = [];
     for (const profile of profiles) {
-      const bg = selectedProfile?.id === profile.id ? C.headerBg : undefined;
-      profileLines.push(buildPanelLine(width, [
-        ['  ', C.label],
-        [profile.id.padEnd(15), C.info, bg],
-        [profile.isolation.padEnd(14), C.value, bg],
-        [profile.kind.padEnd(12), C.dim, bg],
-        [` vm=${profile.requiresVm ? 'yes' : 'no'}`, profile.requiresVm ? C.good : C.warn, bg],
-      ]));
+      const selectedRow = selectedProfile?.id === profile.id;
+      profileLines.push(buildAlignedRow(
+        width,
+        [
+          { text: profile.id, fg: C.info },
+          { text: profile.isolation, fg: C.value },
+          { text: profile.kind, fg: C.dim },
+          { text: `vm=${profile.requiresVm ? 'yes' : 'no'}`, fg: profile.requiresVm ? C.good : C.warn },
+        ],
+        [
+          { width: 15 },
+          { width: 14 },
+          { width: 12 },
+          { width: Math.max(6, width - 53) },
+        ],
+        { selected: selectedRow, selectedBg: C.headerBg },
+      ));
     }
     const postureSection: PanelWorkspaceSection = { title: 'Sandbox posture', lines: overviewLines };
     const selectedSection: PanelWorkspaceSection = { title: selectedProfile ? 'Selected Profile' : 'Selected Session', lines: selectionLines };

package/src/panels/schedule-panel.ts

@@ -1,11 +1,13 @@
 import { BasePanel } from './base-panel.ts';
 import { type Line } from '../types/grid.ts';
+import { fitDisplay, truncateDisplay } from '../utils/terminal-width.ts';
 import type { AutomationManager } from '@pellux/goodvibes-sdk/platform/automation';
 import type { AutomationJob } from '@pellux/goodvibes-sdk/platform/automation';
 import type { AutomationRun } from '@pellux/goodvibes-sdk/platform/automation';
 import type { AutomationScheduleDefinition } from '@pellux/goodvibes-sdk/platform/automation';
 import {
   buildEmptyState,
+  buildKeyboardHints,
   buildPanelLine,
   buildPanelWorkspace,
   extendPalette,
@@ -87,11 +89,16 @@ export class SchedulePanel extends BasePanel {
   private refreshTimerId: ReturnType<typeof setInterval> | null = null;
   private readonly automationManager: ScheduleAutomationManager;
 
-  constructor(automationManager: ScheduleAutomationManager) {
+  constructor(automationManager: ScheduleAutomationManager, private readonly requestRender: () => void = () => {}) {
     super('schedule', 'Schedule', 'Z', 'agent');
     this.automationManager = automationManager;
   }
 
+  private _markDirtyAndRender(): void {
+    this.markDirty();
+    this.requestRender();
+  }
+
   // -------------------------------------------------------------------------
   // Lifecycle
   // -------------------------------------------------------------------------
@@ -100,12 +107,12 @@ export class SchedulePanel extends BasePanel {
     super.onActivate();
     void this.automationManager.start().then(() => {
       this.rebuild();
-      this.markDirty();
+      this._markDirtyAndRender();
     });
     this.rebuild();
     this.refreshTimerId = this.registerTimer(setInterval(() => {
       this.rebuild();
-      this.markDirty();
+      this._markDirtyAndRender();
     }, 5_000));
   }
 
@@ -221,14 +228,19 @@ export class SchedulePanel extends BasePanel {
             lines: buildEmptyState(
               width,
               ' No scheduled tasks',
-              'Use /schedule add to create a recurring task. Scheduled runs and history will appear here.',
-              [],
+              'Create a recurring task and its next-run timing, run history, and enablement state will appear here.',
+              [
+                { command: '/schedule add cron 0 * * * * repo sweep', summary: 'create a recurring cron task' },
+                { command: '/schedule list', summary: 'inspect scheduled tasks from the shell' },
+              ],
               DEFAULT_PANEL_PALETTE,
             ),
           },
         ],
         footerLines: [
-          buildPanelLine(width, [[' Up/Down', DEFAULT_PANEL_PALETTE.info], [' navigate', DEFAULT_PANEL_PALETTE.dim], ['   Space', DEFAULT_PANEL_PALETTE.info], [' toggle', DEFAULT_PANEL_PALETTE.dim], ['   r', DEFAULT_PANEL_PALETTE.info], [' run now', DEFAULT_PANEL_PALETTE.dim], ['   R', DEFAULT_PANEL_PALETTE.info], [' refresh', DEFAULT_PANEL_PALETTE.dim]]),
+          buildKeyboardHints(width, [
+            { keys: '/schedule add', label: 'create a task' },
+          ], DEFAULT_PANEL_PALETTE),
         ],
         palette: DEFAULT_PANEL_PALETTE,
       });
@@ -236,6 +248,7 @@ export class SchedulePanel extends BasePanel {
 
     const taskItems = this.items.filter((item): item is Extract<ViewItem, { kind: 'task' }> => item.kind === 'task');
     this.selectedIndex = Math.max(0, Math.min(this.selectedIndex, taskItems.length - 1));
+    const dueSoon = tasks.filter((task: AutomationJob) => typeof task.nextRunAt === 'number').length;
     const summarySection: PanelWorkspaceSection = {
       title: 'Summary',
       lines: [
@@ -244,14 +257,28 @@ export class SchedulePanel extends BasePanel {
           [String(tasks.length), DEFAULT_PANEL_PALETTE.value],
           ['   Enabled ', DEFAULT_PANEL_PALETTE.label],
           [String(enabled), enabled > 0 ? DEFAULT_PANEL_PALETTE.good : DEFAULT_PANEL_PALETTE.dim],
+          ['   Paused ', DEFAULT_PANEL_PALETTE.label],
+          [String(tasks.length - enabled), tasks.length - enabled > 0 ? DEFAULT_PANEL_PALETTE.warn : DEFAULT_PANEL_PALETTE.dim],
+          ['   Scheduled ', DEFAULT_PANEL_PALETTE.label],
+          [String(dueSoon), dueSoon > 0 ? DEFAULT_PANEL_PALETTE.info : DEFAULT_PANEL_PALETTE.dim],
         ]),
       ],
     };
+    const selectedTask = taskItems[this.selectedIndex]?.task;
+    const toggleLabel = selectedTask
+      ? (selectedTask.enabled ? 'pause task' : 'enable task')
+      : 'toggle';
+    const footerLines = [
+      buildKeyboardHints(width, [
+        { keys: 'Up/Down', label: 'navigate' },
+        { keys: 'Space', label: toggleLabel },
+        { keys: 'r', label: 'run now' },
+        { keys: 'R', label: 'refresh' },
+      ], DEFAULT_PANEL_PALETTE),
+    ];
     const scheduledTasksSection = resolveScrollablePanelSection(width, height, {
       intro: 'Review recurring scheduled tasks, next run timing, recent history, and enablement state.',
-      footerLines: [
-        buildPanelLine(width, [[' Up/Down', DEFAULT_PANEL_PALETTE.info], [' navigate', DEFAULT_PANEL_PALETTE.dim], ['   Space', DEFAULT_PANEL_PALETTE.info], [' toggle', DEFAULT_PANEL_PALETTE.dim], ['   r', DEFAULT_PANEL_PALETTE.info], [' run now', DEFAULT_PANEL_PALETTE.dim], ['   R', DEFAULT_PANEL_PALETTE.info], [' refresh', DEFAULT_PANEL_PALETTE.dim]]),
-      ],
+      footerLines,
       palette: DEFAULT_PANEL_PALETTE,
       beforeSections: [summarySection],
       section: {
@@ -272,9 +299,7 @@ export class SchedulePanel extends BasePanel {
       title: ' Schedule',
       intro: 'Review recurring scheduled tasks, next run timing, recent history, and enablement state.',
       sections,
-      footerLines: [
-        buildPanelLine(width, [[' Up/Down', DEFAULT_PANEL_PALETTE.info], [' navigate', DEFAULT_PANEL_PALETTE.dim], ['   Space', DEFAULT_PANEL_PALETTE.info], [' toggle', DEFAULT_PANEL_PALETTE.dim], ['   r', DEFAULT_PANEL_PALETTE.info], [' run now', DEFAULT_PANEL_PALETTE.dim], ['   R', DEFAULT_PANEL_PALETTE.info], [' refresh', DEFAULT_PANEL_PALETTE.dim]]),
-      ],
+      footerLines,
       palette: DEFAULT_PANEL_PALETTE,
     });
   }
@@ -291,11 +316,11 @@ export class SchedulePanel extends BasePanel {
 
     const bullet = task.enabled ? '* ' : 'o ';
     const bulletFg = task.enabled ? C.enabled : C.disabled;
-    const nameStr = task.name.length > 28 ? task.name.slice(0, 25) + '...' : task.name.padEnd(28);
+    const nameStr = fitDisplay(task.name, 28);
     const scheduleText = formatSchedule(task.schedule);
     const row1 = buildPanelLine(width, [
       [bullet, bulletFg, bg],
-      [task.id.slice(0, 12), fgBase ?? C.id, bg],
+      [fitDisplay(task.id, 12), fgBase ?? C.id, bg],
       ['  ', fgBase ?? C.prompt, bg],
       [nameStr, fgBase ?? C.prompt, bg],
       ['  ', fgBase ?? C.prompt, bg],
@@ -318,9 +343,7 @@ export class SchedulePanel extends BasePanel {
 
     const maxPromptLen = Math.max(20, width - indent.length - 30);
     const prompt = task.execution.prompt ?? task.description ?? '';
-    const promptPreview = prompt.length > maxPromptLen
-      ? prompt.slice(0, maxPromptLen - 1) + '\u2026'
-      : prompt;
+    const promptPreview = truncateDisplay(prompt, maxPromptLen);
 
     // Show last 3 run statuses as colored dots
     const recentRuns = history.slice(-3);