@compilr-dev/cli 0.5.0 → 0.5.1

package/dist/ui/overlay/impl/workflow-overlay-v2.js

@@ -20,6 +20,7 @@ import { projectRepository, workItemRepository, documentRepository } from '../..
 import { BacklogOverlayV2 } from './backlog-overlay-v2.js';
 import { DocsOverlayV2 } from './docs-overlay-v2.js';
 import { AnchorsOverlayV2 } from './anchors-overlay-v2.js';
+import { ProjectEditOverlayV2 } from './project-edit-overlay-v2.js';
 // =============================================================================
 // Constants
 // =============================================================================
@@ -550,7 +551,8 @@ export class WorkflowOverlayV2 extends BaseOverlayV2 {
         const projectId = this.state.project?.id;
         switch (command) {
             case '/backlog':
-                return new BacklogOverlayV2(projectId);
+                // Note: teamAgentIds not available here, owner cycling disabled
+                return new BacklogOverlayV2(projectId, []);
             case '/docs':
                 return new DocsOverlayV2(projectId);
             case '/anchors':
@@ -615,6 +617,8 @@ export class WorkflowOverlayV2 extends BaseOverlayV2 {
                 this.refreshProject();
                 return this.rerender();
             case 'edit':
+                // Push the edit overlay
+                return this.push(new ProjectEditOverlayV2(this.state.project));
             case 'delete':
                 return this.close({
                     command: null,

package/dist/ui/overlay/index.d.ts

@@ -6,7 +6,7 @@
 export type { Overlay, RenderContext, OverlayContent, OverlayAction, KeyEvent, OverlayResolver, OverlayRenderState, } from './types.js';
 export { isCloseWithResult, isCloseCancelled } from './types.js';
 export { parseKeyEvent, matchesKey } from './key-utils.js';
-export { HelpOverlayV2 } from './impl/help-overlay-v2.js';
+export { HelpOverlayV2, type HelpOverlayV2Options } from './impl/help-overlay-v2.js';
 export { ThemeOverlayV2, type ThemeOverlayOptions, type ThemeOverlayResult } from './impl/theme-overlay-v2.js';
 export { ModelOverlayV2, type ModelOverlayV2Options, type ModelOverlayV2Result } from './impl/model-overlay-v2.js';
 export { ToolsOverlayV2, type ToolsOverlayV2Options, type ToolsOverlayV2Result, type ToolInfo, type ToolParameter, type ToolPermissionInfo } from './impl/tools-overlay-v2.js';
@@ -21,6 +21,7 @@ export { DocsOverlayV2, type DocsOverlayV2Result } from './impl/docs-overlay-v2.
 export { DocumentDetailOverlayV2, type DocumentDetailResult } from './impl/document-detail-overlay-v2.js';
 export { AnchorsOverlayV2, type AnchorsOverlayV2Result } from './impl/anchors-overlay-v2.js';
 export { ProjectsOverlayV2, type ProjectsOverlayV2Result } from './impl/projects-overlay-v2.js';
+export { ProjectEditOverlayV2, type ProjectEditResult } from './impl/project-edit-overlay-v2.js';
 export { ConfigOverlayV2, type ConfigOverlayV2Options, type ConfigOverlayV2Result } from './impl/config-overlay-v2.js';
 export { AskUserSimpleOverlayV2, type AskUserSimpleOptionsV2, type AskUserSimpleResultV2 } from './impl/ask-user-simple-overlay-v2.js';
 export { GuardrailOverlayV2, type GuardrailConfirmOptionsV2, type GuardrailConfirmResultV2 } from './impl/guardrail-overlay-v2.js';
@@ -31,3 +32,21 @@ export { NewProjectOverlayV2, type NewProjectResultV2 } from './impl/new-overlay
 export { InitSetupOverlayV2, type InitSetupResultV2 } from './impl/init-setup-overlay-v2.js';
 export { ArchTypeOverlayV2, type ArchTypeChoiceV2, type ArchDocType } from './impl/arch-type-overlay-v2.js';
 export { DashboardOverlayV2, type DashboardOverlayV2Result } from './impl/dashboard-overlay-v2.js';
+export { OnboardingWizardOverlayV2, type OnboardingWizardResult } from './impl/onboarding-wizard-overlay-v2.js';
+export { ResumeOverlayV2, type ResumeOverlayV2Options, type ResumeOverlayV2Result, type SessionItem } from './impl/resume-overlay-v2.js';
+export { PlanApprovalOverlayV2, type PlanApprovalOverlayOptions, type PlanApprovalResult, type PlanApprovalAction } from './impl/plan-approval-overlay-v2.js';
+export { PermissionsOverlayV2, type PermissionsOverlayV2Options, type PermissionsOverlayV2Result } from './impl/permissions-overlay-v2.js';
+export { ResetOverlayV2, type ResetOverlayV2Options, type ResetOverlayV2Result, type ResetOption } from './impl/reset-overlay-v2.js';
+export { SessionModeOverlayV2, type SessionModeOverlayV2Options, type SessionModeOverlayV2Result, type SessionModeOption } from './impl/session-mode-overlay-v2.js';
+export { TeamOverlayV2, type TeamOverlayV2Result } from './impl/team-overlay-v2.js';
+export { CustomAgentFormOverlayV2, type CustomAgentFormOptions, type CustomAgentFormResult } from './impl/custom-agent-form-overlay-v2.js';
+export { ArtifactOverlayV2, type ArtifactOverlayV2Result } from './impl/artifact-overlay-v2.js';
+export { ArtifactDetailOverlayV2, type ArtifactDetailOverlayV2Result } from './impl/artifact-detail-overlay-v2.js';
+export { GamesOverlayV2, type GamesOverlayV2Result, type GamesOverlayV2Options } from './impl/games-overlay-v2.js';
+export { PendingOverlayV2, type PendingOverlayResult } from './impl/pending-overlay-v2.js';
+export { BackgroundOverlayV2, type BackgroundOverlayResult, type BackgroundOverlayOptions } from './impl/background-overlay-v2.js';
+export { FilterOverlayV2, type FilterOverlayV2Result, type FilterOverlayV2Config } from './impl/filter-overlay-v2.js';
+export { ChangelogOverlayV2, type ChangelogOverlayV2Result } from './impl/changelog-overlay-v2.js';
+export { NotificationsOverlayV2 } from './impl/notifications-overlay-v2.js';
+export { MCPOverlayV2, type MCPOverlayV2Result } from './impl/mcp-overlay-v2.js';
+export { DelegationsOverlayV2 } from './impl/delegations-overlay-v2.js';

package/dist/ui/overlay/index.js

@@ -23,6 +23,7 @@ export { DocsOverlayV2 } from './impl/docs-overlay-v2.js';
 export { DocumentDetailOverlayV2 } from './impl/document-detail-overlay-v2.js';
 export { AnchorsOverlayV2 } from './impl/anchors-overlay-v2.js';
 export { ProjectsOverlayV2 } from './impl/projects-overlay-v2.js';
+export { ProjectEditOverlayV2 } from './impl/project-edit-overlay-v2.js';
 export { ConfigOverlayV2 } from './impl/config-overlay-v2.js';
 export { AskUserSimpleOverlayV2 } from './impl/ask-user-simple-overlay-v2.js';
 export { GuardrailOverlayV2 } from './impl/guardrail-overlay-v2.js';
@@ -33,3 +34,21 @@ export { NewProjectOverlayV2 } from './impl/new-overlay-v2.js';
 export { InitSetupOverlayV2 } from './impl/init-setup-overlay-v2.js';
 export { ArchTypeOverlayV2 } from './impl/arch-type-overlay-v2.js';
 export { DashboardOverlayV2 } from './impl/dashboard-overlay-v2.js';
+export { OnboardingWizardOverlayV2 } from './impl/onboarding-wizard-overlay-v2.js';
+export { ResumeOverlayV2 } from './impl/resume-overlay-v2.js';
+export { PlanApprovalOverlayV2 } from './impl/plan-approval-overlay-v2.js';
+export { PermissionsOverlayV2 } from './impl/permissions-overlay-v2.js';
+export { ResetOverlayV2 } from './impl/reset-overlay-v2.js';
+export { SessionModeOverlayV2 } from './impl/session-mode-overlay-v2.js';
+export { TeamOverlayV2 } from './impl/team-overlay-v2.js';
+export { CustomAgentFormOverlayV2 } from './impl/custom-agent-form-overlay-v2.js';
+export { ArtifactOverlayV2 } from './impl/artifact-overlay-v2.js';
+export { ArtifactDetailOverlayV2 } from './impl/artifact-detail-overlay-v2.js';
+export { GamesOverlayV2 } from './impl/games-overlay-v2.js';
+export { PendingOverlayV2 } from './impl/pending-overlay-v2.js';
+export { BackgroundOverlayV2 } from './impl/background-overlay-v2.js';
+export { FilterOverlayV2 } from './impl/filter-overlay-v2.js';
+export { ChangelogOverlayV2 } from './impl/changelog-overlay-v2.js';
+export { NotificationsOverlayV2 } from './impl/notifications-overlay-v2.js';
+export { MCPOverlayV2 } from './impl/mcp-overlay-v2.js';
+export { DelegationsOverlayV2 } from './impl/delegations-overlay-v2.js';

package/dist/ui/overlay/types.d.ts

@@ -26,6 +26,11 @@ export interface Overlay<TState = unknown, TResult = unknown> {
     onMount?(): void | Promise<void>;
     /** Called when overlay is unmounted. Cleanup. */
     onUnmount?(): void;
+    /**
+     * Set callback for requesting re-render from async operations.
+     * Called by TerminalUI when mounting the overlay.
+     */
+    setRenderCallback?(callback: () => void): void;
     /** Get current state (for TerminalUI to access if needed) */
     getState(): TState;
     /**

package/dist/ui/overlay-manager.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Overlay lifecycle manager.
+ *
+ * Extracted from TerminalUI — owns the overlay stack, resolvers,
+ * render state, and print buffer. Uses host interface for footer
+ * clear/render and console output.
+ */
+import type { PrintableItem } from './terminal-types.js';
+import type { Overlay } from './overlay/index.js';
+export interface OverlayManagerHost {
+    clearFooter(): void;
+    renderFooter(): void;
+    print(item: PrintableItem): void;
+    renderItemToConsole(item: PrintableItem): void;
+}
+export declare class OverlayManager {
+    private readonly stack;
+    private readonly resolvers;
+    private renderState;
+    private printBuffer;
+    private readonly host;
+    constructor(host: OverlayManagerHost);
+    hasActiveOverlay(): boolean;
+    getActiveOverlay(): Overlay | null;
+    showOverlay<TResult>(overlay: Overlay<unknown, TResult>): Promise<TResult | null>;
+    closeCurrentOverlay(result: unknown, cancelled: boolean): void;
+    private enterFullscreenOverlayMode;
+    private enterInlineOverlayMode;
+    private exitOverlayMode;
+    bufferItem(item: PrintableItem): void;
+    private flushPrintBuffer;
+    requestOverlayRender(): void;
+    private clearOverlayRender;
+    private renderOverlay;
+    private renderFullscreenOverlay;
+    private renderInlineOverlay;
+    processOverlayAction(action: {
+        type: 'none' | 'render' | 'close' | 'push' | 'pop';
+        result?: unknown;
+        cancelled?: boolean;
+        overlay?: Overlay;
+    }): void;
+}

package/dist/ui/overlay-manager.js

@@ -0,0 +1,238 @@
+/**
+ * Overlay lifecycle manager.
+ *
+ * Extracted from TerminalUI — owns the overlay stack, resolvers,
+ * render state, and print buffer. Uses host interface for footer
+ * clear/render and console output.
+ */
+import * as terminal from './terminal.js';
+import { getVisibleLength } from './line-utils.js';
+import { getStyles } from '../themes/index.js';
+export class OverlayManager {
+    stack = [];
+    resolvers = new Map();
+    renderState = { lineCount: 0, maxLineCount: 0 };
+    printBuffer = [];
+    host;
+    constructor(host) {
+        this.host = host;
+    }
+    // ===========================================================================
+    // Queries
+    // ===========================================================================
+    hasActiveOverlay() {
+        return this.stack.length > 0;
+    }
+    getActiveOverlay() {
+        return this.stack.length > 0
+            ? this.stack[this.stack.length - 1]
+            : null;
+    }
+    // ===========================================================================
+    // Show / Close
+    // ===========================================================================
+    async showOverlay(overlay) {
+        const isPushingOntoExisting = this.stack.length > 0;
+        if (isPushingOntoExisting) {
+            this.clearOverlayRender();
+        }
+        this.stack.push(overlay);
+        overlay.setRenderCallback?.(() => { this.requestOverlayRender(); });
+        await overlay.onMount?.();
+        if (!overlay.usesAlternateScreen) {
+            if (overlay.type === 'fullscreen') {
+                this.enterFullscreenOverlayMode();
+            }
+            else {
+                this.enterInlineOverlayMode();
+            }
+        }
+        this.renderOverlay();
+        return new Promise((resolve) => {
+            this.resolvers.set(overlay.id, resolve);
+        });
+    }
+    closeCurrentOverlay(result, cancelled) {
+        const overlay = this.stack.pop();
+        if (!overlay)
+            return;
+        const usesAlternateScreen = overlay.usesAlternateScreen === true;
+        overlay.onUnmount?.();
+        const summary = (!cancelled && result !== null)
+            ? overlay.getCloseSummary?.(result)
+            : null;
+        if (this.stack.length === 0) {
+            if (usesAlternateScreen) {
+                this.renderState = { lineCount: 0, maxLineCount: 0 };
+                this.flushPrintBuffer();
+            }
+            else {
+                this.exitOverlayMode();
+            }
+        }
+        else {
+            if (!usesAlternateScreen) {
+                this.clearOverlayRender();
+            }
+            this.renderState = { lineCount: 0, maxLineCount: 0 };
+            this.renderOverlay();
+        }
+        if (summary) {
+            this.host.print({ type: 'info', message: summary });
+        }
+        const resolver = this.resolvers.get(overlay.id);
+        resolver?.(result);
+        this.resolvers.delete(overlay.id);
+    }
+    // ===========================================================================
+    // Overlay mode transitions
+    // ===========================================================================
+    enterFullscreenOverlayMode() {
+        this.host.clearFooter();
+        process.stdout.write('\x1b[2J\x1b[H');
+        this.renderState = { lineCount: 0, maxLineCount: 0 };
+    }
+    enterInlineOverlayMode() {
+        this.host.clearFooter();
+        this.renderState = { lineCount: 0, maxLineCount: 0 };
+    }
+    exitOverlayMode() {
+        this.clearOverlayRender();
+        this.renderState = { lineCount: 0, maxLineCount: 0 };
+        this.flushPrintBuffer();
+        this.host.renderFooter();
+    }
+    // ===========================================================================
+    // Print buffer (items queued while overlay is active)
+    // ===========================================================================
+    bufferItem(item) {
+        this.printBuffer.push(item);
+    }
+    flushPrintBuffer() {
+        if (this.printBuffer.length === 0)
+            return;
+        for (const item of this.printBuffer) {
+            this.host.renderItemToConsole(item);
+        }
+        this.printBuffer = [];
+    }
+    // ===========================================================================
+    // Render
+    // ===========================================================================
+    requestOverlayRender() {
+        if (this.getActiveOverlay()) {
+            this.renderOverlay();
+        }
+    }
+    clearOverlayRender() {
+        const linesToClear = this.renderState.maxLineCount;
+        if (linesToClear > 0) {
+            process.stdout.write(`\x1b[${String(linesToClear)}A`);
+            process.stdout.write('\r');
+            process.stdout.write('\x1b[J');
+        }
+    }
+    renderOverlay() {
+        const overlay = this.getActiveOverlay();
+        if (!overlay)
+            return;
+        const termWidth = terminal.getTerminalWidth();
+        const termHeight = terminal.getTerminalHeight();
+        const s = getStyles();
+        const context = {
+            width: termWidth,
+            height: termHeight,
+            styles: s,
+        };
+        const content = overlay.render(context);
+        if (overlay.type === 'fullscreen') {
+            this.renderFullscreenOverlay(content, termWidth);
+        }
+        else {
+            this.renderInlineOverlay(content, termWidth);
+        }
+    }
+    renderFullscreenOverlay(content, termWidth) {
+        this.clearOverlayRender();
+        let physicalLines = 0;
+        for (const line of content.lines) {
+            const visibleLen = getVisibleLength(line);
+            physicalLines += Math.max(1, Math.ceil(visibleLen / termWidth));
+        }
+        const contentMinHeight = content.minHeight ?? 0;
+        const naturalHeight = Math.max(physicalLines, contentMinHeight);
+        this.renderState.maxLineCount = Math.max(this.renderState.maxLineCount, naturalHeight);
+        const targetHeight = this.renderState.maxLineCount;
+        const paddedLines = [...content.lines];
+        while (physicalLines < targetHeight) {
+            paddedLines.push('');
+            physicalLines++;
+        }
+        this.renderState.lineCount = physicalLines;
+        for (let i = 0; i < paddedLines.length; i++) {
+            process.stdout.write(paddedLines[i]);
+            if (i < paddedLines.length - 1) {
+                process.stdout.write('\n');
+            }
+        }
+        if (content.cursorPosition) {
+            const { line, column } = content.cursorPosition;
+            const linesFromEnd = paddedLines.length - 1 - line;
+            if (linesFromEnd > 0) {
+                process.stdout.write(`\x1b[${String(linesFromEnd)}A`);
+            }
+            process.stdout.write(`\x1b[${String(column)}G`);
+        }
+        terminal.showCursor();
+    }
+    renderInlineOverlay(content, termWidth) {
+        this.clearOverlayRender();
+        let physicalLines = 0;
+        for (const line of content.lines) {
+            const visibleLen = getVisibleLength(line);
+            physicalLines += Math.max(1, Math.ceil(visibleLen / termWidth));
+        }
+        const contentMinHeight = content.minHeight ?? 0;
+        const naturalHeight = Math.max(physicalLines, contentMinHeight);
+        this.renderState.maxLineCount = Math.max(this.renderState.maxLineCount, naturalHeight);
+        const targetHeight = this.renderState.maxLineCount;
+        const paddedLines = [...content.lines];
+        while (physicalLines < targetHeight) {
+            paddedLines.push('');
+            physicalLines++;
+        }
+        this.renderState.lineCount = physicalLines;
+        for (const line of paddedLines) {
+            process.stdout.write(line + '\n');
+        }
+        terminal.showCursor();
+    }
+    // ===========================================================================
+    // Action processing
+    // ===========================================================================
+    processOverlayAction(action) {
+        switch (action.type) {
+            case 'none':
+                break;
+            case 'render':
+                this.renderOverlay();
+                break;
+            case 'close':
+                if (action.cancelled) {
+                    this.closeCurrentOverlay(null, true);
+                }
+                else {
+                    this.closeCurrentOverlay(action.result ?? null, false);
+                }
+                break;
+            case 'push':
+                if (action.overlay) {
+                    void this.showOverlay(action.overlay);
+                }
+                break;
+            case 'pop':
+                this.closeCurrentOverlay(null, true);
+                break;
+        }
+    }
+}

package/dist/ui/overlays.js

@@ -10,6 +10,7 @@
 import chalk from 'chalk';
 import * as terminal from './terminal.js';
 import { getStyles } from '../themes/index.js';
+import { renderProgressBar, truncate } from './base/index.js';
 /**
  * Show a confirmation dialog
  */
@@ -59,7 +60,7 @@ export function showPermissionPrompt(tool, args) {
         terminal.writeLine('');
         terminal.writeLine('  Tool: ' + s.primary(tool));
         if (args) {
-            terminal.writeLine('  Args: ' + s.muted(args.slice(0, 60) + (args.length > 60 ? '...' : '')));
+            terminal.writeLine('  Args: ' + s.muted(truncate(args, 60)));
         }
         terminal.writeLine('');
         terminal.write(s.muted('  [') +
@@ -119,8 +120,9 @@ export function showPermissionPrompt(tool, args) {
  * Show context window usage stats
  */
 export function showContextStats(stats) {
+    const s = getStyles();
     const pct = (stats.utilization * 100).toFixed(1);
-    const bar = renderProgressBar(stats.utilization, 30);
+    const bar = renderProgressBar(stats.utilization, 30, s);
     terminal.writeLine('');
     terminal.writeLine(chalk.bold('Context Usage'));
     terminal.writeLine('');
@@ -130,20 +132,6 @@ export function showContextStats(stats) {
     terminal.writeLine(`  Turns: ${String(stats.turns)}`);
     terminal.writeLine('');
 }
-/**
- * Render a progress bar
- */
-function renderProgressBar(value, width) {
-    const s = getStyles();
-    const filled = Math.round(value * width);
-    const empty = width - filled;
-    let color = s.success;
-    if (value > 0.8)
-        color = s.error;
-    else if (value > 0.6)
-        color = s.warning;
-    return color('█'.repeat(filled)) + s.muted('░'.repeat(empty));
-}
 /**
  * Show session token usage
  */

package/dist/ui/permission-overlay.js

@@ -7,6 +7,7 @@
 import chalk from 'chalk';
 import { getStyles } from '../themes/index.js';
 import { InlineOverlay } from './base/inline-overlay.js';
+import { truncate } from './base/index.js';
 // =============================================================================
 // Helpers (unchanged from original)
 // =============================================================================
@@ -17,7 +18,7 @@ import { InlineOverlay } from './base/inline-overlay.js';
 function formatValue(value, maxLen) {
     if (typeof value === 'string') {
         const singleLine = value.replace(/\r?\n|\r/g, '↵');
-        return singleLine.length > maxLen ? singleLine.slice(0, maxLen) + '...' : singleLine;
+        return truncate(singleLine, maxLen);
     }
     if (typeof value === 'boolean' || typeof value === 'number') {
         return String(value);
@@ -75,7 +76,7 @@ function formatArgs(toolName, args, maxWidth) {
         else {
             lines.push(prefix);
             const maxCmdLength = availableWidth * 3;
-            const truncatedCmd = cmd.length > maxCmdLength ? cmd.slice(0, maxCmdLength) + '...' : cmd;
+            const truncatedCmd = truncate(cmd, maxCmdLength);
             lines.push('  ' + truncatedCmd);
         }
         return lines;
@@ -128,7 +129,7 @@ function formatArgs(toolName, args, maxWidth) {
         const valueStr = formatValue(value, maxWidth - key.length - 6);
         const line = `${key}: ${valueStr}`;
         if (line.length > maxWidth - 4) {
-            lines.push(line.slice(0, maxWidth - 7) + '...');
+            lines.push(truncate(line, maxWidth - 4));
         }
         else {
             lines.push(line);
@@ -234,7 +235,7 @@ class PermissionOverlayImpl extends InlineOverlay {
         const maxArgWidth = cols - 6;
         const argLines = formatArgs(this.options.toolName, this.options.args, maxArgWidth);
         for (const argLine of argLines) {
-            const safeArg = argLine.length > maxArgWidth ? argLine.slice(0, maxArgWidth - 3) + '...' : argLine;
+            const safeArg = truncate(argLine, maxArgWidth);
             lines.push('  ' + s.muted(safeArg));
         }
         lines.push('');
@@ -274,7 +275,7 @@ class PermissionOverlayImpl extends InlineOverlay {
         const endLine = Math.min(this.state.detailScrollOffset + visibleLines, contentLines.length);
         for (let i = this.state.detailScrollOffset; i < endLine; i++) {
             const line = contentLines[i];
-            const safeLine = line.length > cols - 4 ? line.slice(0, cols - 7) + '...' : line;
+            const safeLine = truncate(line, cols - 4);
             lines.push(' ' + safeLine);
         }
         // Pad to fixed height

package/dist/ui/status-bar-controller.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Status bar navigation controller.
+ *
+ * Extracted from TerminalUI — manages the navigable status bar indicators
+ * (pending requests, background agents, terminals, notifications).
+ */
+import type { KeypressKey } from './terminal-types.js';
+export interface StatusBarItem {
+    id: 'pending' | 'bg-agents' | 'terminals' | 'notifications' | 'mcp';
+    action: string;
+}
+export interface StatusBarHost {
+    requestRender(): void;
+    emit(event: string, ...args: unknown[]): void;
+}
+export declare class StatusBarController {
+    navActive: boolean;
+    selectedIndex: number;
+    backgroundAgentCount: number;
+    mcpLoading: boolean;
+    mcpToolCount: number;
+    private readonly host;
+    constructor(host: StatusBarHost);
+    /** Set background agent count (called by REPL to keep UI in sync). */
+    setBackgroundAgentCount(count: number): void;
+    /** Set MCP loading state (shown while MCP servers connect in background). */
+    setMCPLoading(loading: boolean, toolCount?: number): void;
+    /** Returns navigable status bar indicators based on current state. */
+    getItems(): StatusBarItem[];
+    /** Handle keys while in status bar navigation mode. */
+    handleKey(_str: string, key: KeypressKey): void;
+    exitNav(): void;
+}

package/dist/ui/status-bar-controller.js

@@ -0,0 +1,99 @@
+/**
+ * Status bar navigation controller.
+ *
+ * Extracted from TerminalUI — manages the navigable status bar indicators
+ * (pending requests, background agents, terminals, notifications).
+ */
+import { getPendingRequestsManager } from '../multi-agent/index.js';
+import { getSessionRegistry } from '../multi-agent/session-registry.js';
+import { getNotificationManager } from '../multi-agent/notification-manager.js';
+export class StatusBarController {
+    navActive = false;
+    selectedIndex = 0;
+    backgroundAgentCount = 0;
+    mcpLoading = false;
+    mcpToolCount = 0;
+    host;
+    constructor(host) {
+        this.host = host;
+    }
+    /** Set background agent count (called by REPL to keep UI in sync). */
+    setBackgroundAgentCount(count) {
+        this.backgroundAgentCount = count;
+        this.host.requestRender();
+    }
+    /** Set MCP loading state (shown while MCP servers connect in background). */
+    setMCPLoading(loading, toolCount) {
+        this.mcpLoading = loading;
+        if (toolCount !== undefined)
+            this.mcpToolCount = toolCount;
+        this.host.requestRender();
+    }
+    /** Returns navigable status bar indicators based on current state. */
+    getItems() {
+        const items = [];
+        const notifManager = getNotificationManager();
+        if (notifManager && notifManager.getUnreadCount() > 0) {
+            items.push({ id: 'notifications', action: 'notifications' });
+        }
+        if (getPendingRequestsManager().getCount() > 0) {
+            items.push({ id: 'pending', action: 'pending' });
+        }
+        if (this.backgroundAgentCount > 0) {
+            items.push({ id: 'bg-agents', action: 'bg' });
+        }
+        const registry = getSessionRegistry();
+        if (registry && registry.getProjectScopedSessionCount() > 1) {
+            items.push({ id: 'terminals', action: 'terminals' });
+        }
+        if (this.mcpLoading) {
+            items.push({ id: 'mcp', action: 'mcp' });
+        }
+        return items;
+    }
+    /** Handle keys while in status bar navigation mode. */
+    handleKey(_str, key) {
+        const items = this.getItems();
+        if (items.length === 0) {
+            this.exitNav();
+            return;
+        }
+        if (key.name === 'right' || key.name === 'down') {
+            if (this.selectedIndex < items.length - 1) {
+                this.selectedIndex++;
+                this.host.requestRender();
+            }
+        }
+        else if (key.name === 'left') {
+            if (this.selectedIndex > 0) {
+                this.selectedIndex--;
+                this.host.requestRender();
+            }
+        }
+        else if (key.name === 'up') {
+            if (this.selectedIndex > 0) {
+                this.selectedIndex--;
+                this.host.requestRender();
+            }
+            else {
+                this.exitNav();
+            }
+        }
+        else if (key.name === 'return') {
+            const item = items[this.selectedIndex];
+            this.exitNav();
+            this.host.emit('command', item.action, '');
+        }
+        else if (key.name === 'escape') {
+            this.exitNav();
+        }
+        else {
+            this.exitNav();
+        }
+    }
+    exitNav() {
+        this.navActive = false;
+        this.selectedIndex = 0;
+        this.host.requestRender();
+    }
+}