@compilr-dev/cli 0.5.0 → 0.5.2

package/dist/ui/footer.js

@@ -1,16 +1,20 @@
 /**
+ * @deprecated DEAD CODE — This class is never instantiated. Do NOT modify this file.
+ *
+ * The active footer/render pipeline is in TerminalUI (src/ui/terminal-ui.ts).
+ * TerminalUI has its own inline render loop with numbered sections (1-8),
+ * status bar items, mode indicator, etc. All footer changes should go there.
+ *
+ * This file is kept only because it is type-imported by terminal-renderer.ts
+ * and memory-handler.ts. It can be safely deleted once those imports are removed.
+ *
+ * --- Original description ---
  * Footer Orchestrator
  *
  * Manages all persistent UI elements below the scrolling zone:
  * - TodoZone (spinner + todo list)
  * - Queued input display
  * - InputPrompt
- *
- * Handles:
- * - Coordinated rendering via single render loop
- * - Event forwarding from InputPrompt
- * - Clearing for scrolling output
- * - State management for agent running/idle modes
  */
 import { EventEmitter } from 'events';
 import { MODE_INFO } from './types.js';
@@ -21,6 +25,8 @@ import { InputPrompt, DEFAULT_COMMANDS } from './input-prompt.js';
 import { SubagentRenderer } from './subagent-renderer.js';
 import { debugLog, debugRender } from '../utils/debug-log.js';
 import { getPhysicalLineCount, getVisibleLength } from './line-utils.js';
+import { getPendingRequestsManager } from '../multi-agent/index.js';
+import { getSessionRegistry } from '../multi-agent/session-registry.js';
 // =============================================================================
 // Footer Class
 // =============================================================================
@@ -39,6 +45,7 @@ export class Footer extends EventEmitter {
     cursorLineFromBottom = 0; // Track cursor position for clear()
     projectName = null; // Current active project name
     externalRendererEnabled = false; // When true, skip internal render loop
+    activeTeamAgent = null; // Active team agent
     // Render loop
     renderInterval;
     renderTimer = null;
@@ -88,6 +95,18 @@ export class Footer extends EventEmitter {
             this.subagentRenderer.toggleExpand();
             this.needsRender = true;
         });
+        // Phase 3b: Listen to pending requests changes for footer indicator
+        const pendingManager = getPendingRequestsManager();
+        pendingManager.on('count-changed', () => {
+            this.needsRender = true;
+        });
+        // Multi-terminal: Listen to session count changes from heartbeat
+        const registry = getSessionRegistry();
+        if (registry) {
+            registry.onCountChange(() => {
+                this.needsRender = true;
+            });
+        }
     }
     // ===========================================================================
     // Public API
@@ -197,6 +216,26 @@ export class Footer extends EventEmitter {
     getProjectName() {
         return this.projectName;
     }
+    /**
+     * Set the active team agent (displayed in footer)
+     * Pass null to clear (default agent or no team)
+     */
+    setActiveTeamAgent(agent) {
+        this.activeTeamAgent = agent;
+        this.needsRender = true;
+    }
+    /**
+     * Set the callback to get available team agents for $ autocomplete
+     */
+    setAgentSuggestionsCallback(callback) {
+        this.inputPrompt.setAgentSuggestionsCallback(callback);
+    }
+    /**
+     * Get the active team agent
+     */
+    getActiveTeamAgent() {
+        return this.activeTeamAgent;
+    }
     /**
      * Update the todo list
      */
@@ -227,11 +266,31 @@ export class Footer extends EventEmitter {
         this.needsRender = true;
     }
     /**
-     * Add tokens to the spinner counter
+     * Add tokens to the spinner counter (legacy)
      */
     addTokens(count) {
         this.todoZone.addTokens(count);
     }
+    /**
+     * Add input/output tokens separately (new API for live display)
+     */
+    addTokensDetailed(inputTokens, outputTokens) {
+        this.todoZone.addTokensDetailed(inputTokens, outputTokens);
+    }
+    /**
+     * Get current token counts
+     */
+    getTokenCounts() {
+        return this.todoZone.getTokenCounts();
+    }
+    /**
+     * Set whether extended thinking mode is active
+     * Shows "thinking" indicator in status line
+     */
+    setThinking(thinking) {
+        this.todoZone.setThinking(thinking);
+        this.needsRender = true;
+    }
     // ===========================================================================
     // Subagent API
     // ===========================================================================
@@ -438,17 +497,32 @@ export class Footer extends EventEmitter {
         // 2. Todo zone (spinner + todos)
         const todoLines = this.todoZone.render();
         allLines.push(...todoLines);
-        // 3. Queued inputs
+        // 3. Agent indicator (only if team agent is active and not default)
+        const agentIndicator = this.renderAgentIndicator();
+        if (agentIndicator) {
+            allLines.push(agentIndicator);
+        }
+        // 3b. Pending requests indicator (Phase 3b)
+        const pendingIndicator = this.renderPendingRequestsIndicator();
+        if (pendingIndicator) {
+            allLines.push(pendingIndicator);
+        }
+        // 3c. Terminal count indicator (multi-terminal awareness)
+        const terminalIndicator = this.renderTerminalCountIndicator();
+        if (terminalIndicator) {
+            allLines.push(terminalIndicator);
+        }
+        // 4. Queued inputs
         const queuedInputs = this.inputPrompt.getQueuedInputs();
         for (const queued of queuedInputs) {
             allLines.push(s.muted(`queued: "${queued}"`));
         }
-        // 4. Input prompt
+        // 5. Input prompt
         const inputLines = this.inputPrompt.render();
         allLines.push(...inputLines);
-        // 5. Mode indicator (below input, before autocomplete)
+        // 6. Mode indicator (below input, before autocomplete)
         allLines.push(this.renderModeIndicator());
-        // 6. Autocomplete dropdown (if active)
+        // 7. Autocomplete dropdown (if active)
         const autocompleteLines = this.inputPrompt.getAutocompleteLines();
         allLines.push(...autocompleteLines);
         return allLines;
@@ -467,6 +541,20 @@ export class Footer extends EventEmitter {
         }
         // Todo lines
         linesBeforeInput += this.todoZone.render().length;
+        // Agent indicator line (if active team agent and not default)
+        if (this.activeTeamAgent && this.activeTeamAgent.id !== 'default') {
+            linesBeforeInput += 1;
+        }
+        // Pending indicator line (Phase 3b)
+        const pendingIndicator = this.renderPendingRequestsIndicator();
+        if (pendingIndicator) {
+            linesBeforeInput += 1;
+        }
+        // Terminal count indicator (multi-terminal awareness)
+        const terminalIndicator = this.renderTerminalCountIndicator();
+        if (terminalIndicator) {
+            linesBeforeInput += 1;
+        }
         // Queued inputs
         linesBeforeInput += this.inputPrompt.getQueuedInputs().length;
         // cursorInfo.row is 1-indexed (row 1 = first line after separator)
@@ -577,18 +665,39 @@ export class Footer extends EventEmitter {
             // 2. Todo zone (spinner + todos)
             const todoLines = this.todoZone.render();
             allLines.push(...todoLines);
-            // 3. Queued inputs
+            // 3. Agent indicator (only if team agent is active and not default)
+            let agentIndicatorLineCount = 0;
+            const agentIndicator = this.renderAgentIndicator();
+            if (agentIndicator) {
+                allLines.push(agentIndicator);
+                agentIndicatorLineCount = 1;
+            }
+            // 3b. Pending requests indicator (Phase 3b: Background Agents)
+            let pendingIndicatorLineCount = 0;
+            const pendingIndicator = this.renderPendingRequestsIndicator();
+            if (pendingIndicator) {
+                allLines.push(pendingIndicator);
+                pendingIndicatorLineCount = 1;
+            }
+            // 3c. Terminal count indicator (multi-terminal awareness)
+            let terminalIndicatorLineCount = 0;
+            const terminalIndicator = this.renderTerminalCountIndicator();
+            if (terminalIndicator) {
+                allLines.push(terminalIndicator);
+                terminalIndicatorLineCount = 1;
+            }
+            // 4. Queued inputs
             const s = getStyles();
             const queuedInputs = this.inputPrompt.getQueuedInputs();
             for (const queued of queuedInputs) {
                 allLines.push(s.muted(`queued: "${queued}"`));
             }
-            // 4. Input prompt
+            // 5. Input prompt
             const inputLines = this.inputPrompt.render();
             allLines.push(...inputLines);
-            // 5. Mode indicator (below input, before autocomplete)
+            // 6. Mode indicator (below input, before autocomplete)
             allLines.push(this.renderModeIndicator());
-            // 6. Autocomplete dropdown (if active)
+            // 7. Autocomplete dropdown (if active)
             const autocompleteLines = this.inputPrompt.getAutocompleteLines();
             allLines.push(...autocompleteLines);
             // Calculate new height BEFORE clearing (to clear extra lines if growing)
@@ -616,7 +725,7 @@ export class Footer extends EventEmitter {
             this.lastRenderHeight = newHeight;
             debugRender('Footer:render', `lastRenderHeight set to ${String(newHeight)}`);
             // Position cursor within input prompt
-            this.positionCursor(allLines, subagentLineCount + todoLines.length + queuedInputs.length);
+            this.positionCursor(allLines, subagentLineCount + todoLines.length + agentIndicatorLineCount + pendingIndicatorLineCount + terminalIndicatorLineCount + queuedInputs.length);
         }
         finally {
             this.isRendering = false;
@@ -658,6 +767,54 @@ export class Footer extends EventEmitter {
         const padding = Math.max(2, termWidth - leftVisible - rightVisible);
         return leftPart + ' '.repeat(padding) + rightPart;
     }
+    /**
+     * Render agent indicator line (only when team agent is active and not default)
+     * Returns empty string if no team agent or default agent.
+     * Format: "[◈_◈] $arch (Solution Architect)  /team to switch"
+     */
+    renderAgentIndicator() {
+        if (!this.activeTeamAgent || this.activeTeamAgent.id === 'default') {
+            return '';
+        }
+        const s = getStyles();
+        const agent = this.activeTeamAgent;
+        const label = `${agent.mascot} $${agent.id} (${agent.displayName})`;
+        const hint = '/team to switch';
+        return s.secondary(label) + '  ' + s.muted(hint);
+    }
+    /**
+     * Render pending requests indicator (Phase 3b: Background Agents)
+     * Shows count of pending requests from background agents if any.
+     * Format: "⚠ 2 pending requests [/pending to view]"
+     * Returns empty string if no pending requests.
+     */
+    renderPendingRequestsIndicator() {
+        const pendingManager = getPendingRequestsManager();
+        const count = pendingManager.getCount();
+        if (count === 0) {
+            return '';
+        }
+        const s = getStyles();
+        const countText = count === 1 ? '1 pending request' : `${String(count)} pending requests`;
+        return s.warning(`⚠ ${countText}`) + '  ' + s.muted('[/pending to view]');
+    }
+    /**
+     * Render terminal count indicator (multi-terminal awareness).
+     * Shows count of active terminal sessions if more than 1.
+     * Format: "+ 2 terminals [/terminals]"
+     * Returns empty string if only this terminal is active.
+     */
+    renderTerminalCountIndicator() {
+        const registry = getSessionRegistry();
+        if (!registry)
+            return '';
+        const count = registry.getActiveSessionCount();
+        if (count <= 1)
+            return '';
+        const s = getStyles();
+        const text = `${String(count)} terminals`;
+        return s.muted(`+ ${text}`) + '  ' + s.muted('[/terminals]');
+    }
     /**
      * Calculate how many terminal rows a line takes (accounting for wrapping)
      * Uses unified line-utils for consistent calculation across all components.

package/dist/ui/input-controller.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Input state controller.
+ *
+ * Extracted from TerminalUI — owns all input state (lines, cursor,
+ * history, suggestion, queued inputs) and their manipulation methods.
+ * TerminalUI delegates to this controller via getter/setter wrappers.
+ */
+export declare class InputController {
+    lines: string[];
+    currentLine: number;
+    cursorPos: number;
+    readonly history: string[];
+    historyIndex: number;
+    savedInput: string;
+    suggestion: string | null;
+    queuedInputs: string[];
+    /** Get the full input value (all lines joined with newlines). */
+    getInputValue(): string;
+    /** Get the current line content. */
+    getCurrentLineContent(): string;
+    /** Clear input and reset to single empty line. */
+    clearInput(): void;
+    addToHistory(input: string): void;
+    /**
+     * Navigate to older history entry.
+     * @param isAutocompleteActive - when true, navigation is blocked
+     * @returns true if input changed
+     */
+    navigateHistoryUp(isAutocompleteActive: boolean): boolean;
+    /**
+     * Navigate to newer history entry.
+     * @param isAutocompleteActive - when true, navigation is blocked
+     * @returns true if input changed
+     */
+    navigateHistoryDown(isAutocompleteActive: boolean): boolean;
+    resetHistoryNavigation(): void;
+    /**
+     * Move cursor to previous word boundary (Option+Left).
+     * @returns true if cursor moved (caller should trigger render)
+     */
+    moveWordLeft(): boolean;
+    /**
+     * Move cursor to next word boundary (Option+Right).
+     * @returns true if cursor moved (caller should trigger render)
+     */
+    moveWordRight(): boolean;
+    getQueuedInputs(): string[];
+    popQueuedInput(): string | null;
+    hasQueuedInput(): boolean;
+    clearQueue(): void;
+}

package/dist/ui/input-controller.js

@@ -0,0 +1,176 @@
+/**
+ * Input state controller.
+ *
+ * Extracted from TerminalUI — owns all input state (lines, cursor,
+ * history, suggestion, queued inputs) and their manipulation methods.
+ * TerminalUI delegates to this controller via getter/setter wrappers.
+ */
+export class InputController {
+    // Core multiline input state
+    lines = [''];
+    currentLine = 0;
+    cursorPos = 0;
+    // Command history
+    history = [];
+    historyIndex = -1;
+    savedInput = '';
+    // Ghost text suggestion
+    suggestion = null;
+    // Queued user inputs (when agent is busy)
+    queuedInputs = [];
+    // ===========================================================================
+    // Input value helpers
+    // ===========================================================================
+    /** Get the full input value (all lines joined with newlines). */
+    getInputValue() {
+        return this.lines.join('\n');
+    }
+    /** Get the current line content. */
+    getCurrentLineContent() {
+        return this.lines[this.currentLine];
+    }
+    /** Clear input and reset to single empty line. */
+    clearInput() {
+        this.lines = [''];
+        this.currentLine = 0;
+        this.cursorPos = 0;
+    }
+    // ===========================================================================
+    // History
+    // ===========================================================================
+    addToHistory(input) {
+        const trimmed = input.trim();
+        // Don't add empty or duplicate consecutive entries
+        if (trimmed && (this.history.length === 0 || this.history[this.history.length - 1] !== trimmed)) {
+            this.history.push(trimmed);
+        }
+    }
+    /**
+     * Navigate to older history entry.
+     * @param isAutocompleteActive - when true, navigation is blocked
+     * @returns true if input changed
+     */
+    navigateHistoryUp(isAutocompleteActive) {
+        if (isAutocompleteActive)
+            return false;
+        if (this.history.length === 0)
+            return false;
+        // Save current input when starting to navigate
+        if (this.historyIndex === -1) {
+            this.savedInput = this.getInputValue();
+        }
+        // Navigate to older entry
+        if (this.historyIndex < this.history.length - 1) {
+            this.historyIndex++;
+            const historyEntry = this.history[this.history.length - 1 - this.historyIndex];
+            // History entries are single-line (newlines stripped on save)
+            this.lines = [historyEntry];
+            this.currentLine = 0;
+            this.cursorPos = historyEntry.length;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Navigate to newer history entry.
+     * @param isAutocompleteActive - when true, navigation is blocked
+     * @returns true if input changed
+     */
+    navigateHistoryDown(isAutocompleteActive) {
+        if (isAutocompleteActive)
+            return false;
+        if (this.historyIndex < 0)
+            return false;
+        this.historyIndex--;
+        if (this.historyIndex === -1) {
+            // Restore saved input (may be multiline)
+            this.lines = this.savedInput.split('\n');
+            if (this.lines.length === 0)
+                this.lines = [''];
+            this.currentLine = this.lines.length - 1;
+            this.cursorPos = this.lines[this.currentLine].length;
+        }
+        else {
+            // Navigate to newer entry
+            const historyEntry = this.history[this.history.length - 1 - this.historyIndex];
+            this.lines = [historyEntry];
+            this.currentLine = 0;
+            this.cursorPos = historyEntry.length;
+        }
+        return true;
+    }
+    resetHistoryNavigation() {
+        this.historyIndex = -1;
+        this.savedInput = '';
+    }
+    // ===========================================================================
+    // Word movement
+    // ===========================================================================
+    /**
+     * Move cursor to previous word boundary (Option+Left).
+     * @returns true if cursor moved (caller should trigger render)
+     */
+    moveWordLeft() {
+        const line = this.lines[this.currentLine];
+        if (this.cursorPos > 0) {
+            let pos = this.cursorPos;
+            // Skip spaces
+            while (pos > 0 && line[pos - 1] === ' ')
+                pos--;
+            // Skip word
+            while (pos > 0 && line[pos - 1] !== ' ')
+                pos--;
+            this.cursorPos = pos;
+            return true;
+        }
+        else if (this.currentLine > 0) {
+            // Move to end of previous line
+            this.currentLine--;
+            this.cursorPos = this.lines[this.currentLine].length;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Move cursor to next word boundary (Option+Right).
+     * @returns true if cursor moved (caller should trigger render)
+     */
+    moveWordRight() {
+        const line = this.lines[this.currentLine];
+        if (this.cursorPos < line.length) {
+            let pos = this.cursorPos;
+            // Skip word
+            while (pos < line.length && line[pos] !== ' ')
+                pos++;
+            // Skip spaces
+            while (pos < line.length && line[pos] === ' ')
+                pos++;
+            this.cursorPos = pos;
+            return true;
+        }
+        else if (this.currentLine < this.lines.length - 1) {
+            // Move to start of next line
+            this.currentLine++;
+            this.cursorPos = 0;
+            return true;
+        }
+        return false;
+    }
+    // ===========================================================================
+    // Input queue
+    // ===========================================================================
+    getQueuedInputs() {
+        return [...this.queuedInputs];
+    }
+    popQueuedInput() {
+        if (this.queuedInputs.length === 0)
+            return null;
+        return this.queuedInputs.shift() ?? null;
+    }
+    hasQueuedInput() {
+        return this.queuedInputs.length > 0;
+    }
+    clearQueue() {
+        this.queuedInputs = [];
+    }
+}

package/dist/ui/input-prompt.d.ts

@@ -21,6 +21,14 @@ export declare const DEFAULT_COMMANDS: CommandOption[];
  * Uses unified line-utils for consistent behavior across components.
  */
 export declare function stripAnsi(str: string): string;
+/**
+ * Agent suggestion for $ autocomplete
+ */
+export interface AgentSuggestion {
+    id: string;
+    displayName: string;
+    mascot: string;
+}
 export interface InputPromptEvents {
     submit: (input: string) => void;
     command: (command: string, args: string) => void;
@@ -33,15 +41,22 @@ export interface InputPromptOptions {
     prompt?: string;
     showSeparators?: boolean;
     commands?: CommandOption[];
+    /** Callback to get available team agents for $ autocomplete */
+    getAgentSuggestions?: () => AgentSuggestion[];
+    /** Callback to get available commands for / autocomplete */
+    getCommands?: () => CommandOption[];
 }
 export declare class InputPrompt extends EventEmitter {
     private prompt;
     private promptLen;
     private readonly showSeparators;
     private readonly commands;
+    private getAgentSuggestions?;
+    private readonly getCommands?;
     private state;
     private autocomplete;
     private fileAutocomplete;
+    private agentAutocomplete;
     private readonly history;
     private historyIndex;
     private savedInput;
@@ -72,6 +87,10 @@ export declare class InputPrompt extends EventEmitter {
      * Clear the current suggestion
      */
     clearSuggestion(): void;
+    /**
+     * Set the callback to get available team agents for $ autocomplete
+     */
+    setAgentSuggestionsCallback(callback: (() => AgentSuggestion[]) | undefined): void;
     /**
      * Start input capture (non-blocking, event-driven)
      */