@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/ui/subagent-renderer.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Subagent Renderer
+ *
+ * Renders subagent status in Claude Code style:
+ * - Single agent: bullet with status and last action
+ * - Multiple agents: tree structure with all agents listed
+ * - Live updates as tools execute
+ *
+ * Visual style:
+ * ● Explore(Find CLI entry points)
+ *   ⎿  Read 67 lines
+ *      Found 100 files
+ *      +3 more tool uses (ctrl+o to expand)
+ *
+ * ● Running 3 Explore agents... (ctrl+o to expand)
+ *    ├─ Find state management · 3 tool uses · 20.7k tokens
+ *    │  ⎿  Bash: List TypeScript files
+ *    └─ Find utility functions · 5 tool uses · 18.9k tokens
+ *       ⎿  Read: src/utils/project-memory.ts
+ */
+export interface SubagentState {
+    id: string;
+    type: string;
+    description: string;
+    status: 'running' | 'done' | 'error';
+    toolCount: number;
+    tokenCount: number;
+    lastAction: string;
+    lastActionDetails: string[];
+    startTime: number;
+    endTime?: number;
+    error?: string;
+}
+export interface SubagentRendererOptions {
+    /** Max detail lines to show per agent in compact mode (default: 1) */
+    maxDetailLines?: number;
+    /** Show token counts (default: true) */
+    showTokens?: boolean;
+}
+export declare class SubagentRenderer {
+    private readonly agents;
+    private isExpanded;
+    private readonly maxDetailLines;
+    private readonly showTokens;
+    private onUpdate;
+    constructor(options?: SubagentRendererOptions);
+    /**
+     * Called when a subagent starts
+     */
+    onSubagentStart(id: string, type: string, description: string): void;
+    /**
+     * Called when a subagent uses a tool
+     */
+    onToolUse(agentId: string, toolName: string, summary?: string): void;
+    /**
+     * Called when a subagent completes
+     */
+    onSubagentEnd(id: string, success: boolean, tokenCount: number, error?: string): void;
+    /**
+     * Toggle expanded/collapsed view (Ctrl+O)
+     */
+    toggleExpand(): void;
+    /**
+     * Check if there are any active subagents
+     */
+    hasActiveSubagents(): boolean;
+    /**
+     * Check if there are any subagents to display
+     */
+    hasSubagents(): boolean;
+    /**
+     * Get count of agents by status
+     */
+    getCounts(): {
+        running: number;
+        done: number;
+        error: number;
+        total: number;
+    };
+    /**
+     * Get the last agent's stats (for persisting to scrolling zone)
+     * Returns null if no agents tracked
+     */
+    getLastAgentStats(): {
+        type: string;
+        description: string;
+        toolCount: number;
+        tokenCount: number;
+        durationMs: number;
+    } | null;
+    /**
+     * Clear all agents (after rendering final output to scrolling zone)
+     */
+    clear(): void;
+    /**
+     * Set callback for state updates
+     */
+    setUpdateCallback(callback: (() => void) | null): void;
+    /**
+     * Render the subagent zone - returns array of lines
+     * Only renders running agents - completed agents are shown via printSubagentResponse
+     */
+    render(): string[];
+    private triggerUpdate;
+    /**
+     * Render single agent display
+     */
+    private renderSingleAgent;
+    /**
+     * Render multiple agents in tree display
+     */
+    private renderMultipleAgents;
+    /**
+     * Get common type label if all agents are same type, otherwise "mixed"
+     */
+    private getCommonTypeLabel;
+}

package/dist/ui/subagent-renderer.js

@@ -0,0 +1,318 @@
+/**
+ * Subagent Renderer
+ *
+ * Renders subagent status in Claude Code style:
+ * - Single agent: bullet with status and last action
+ * - Multiple agents: tree structure with all agents listed
+ * - Live updates as tools execute
+ *
+ * Visual style:
+ * ● Explore(Find CLI entry points)
+ *   ⎿  Read 67 lines
+ *      Found 100 files
+ *      +3 more tool uses (ctrl+o to expand)
+ *
+ * ● Running 3 Explore agents... (ctrl+o to expand)
+ *    ├─ Find state management · 3 tool uses · 20.7k tokens
+ *    │  ⎿  Bash: List TypeScript files
+ *    └─ Find utility functions · 5 tool uses · 18.9k tokens
+ *       ⎿  Read: src/utils/project-memory.ts
+ */
+import { getStyles } from '../themes/index.js';
+import { debugRender } from '../utils/debug-log.js';
+import { formatTokens, truncate } from './base/index.js';
+// =============================================================================
+// Formatting Helpers
+// =============================================================================
+/**
+ * Format duration in human-readable format (e.g., "1m 23s", "45s", "19.2s")
+ */
+function formatDuration(ms) {
+    const seconds = ms / 1000;
+    if (seconds < 60) {
+        return seconds < 10 ? `${seconds.toFixed(1)}s` : `${String(Math.floor(seconds))}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = Math.floor(seconds % 60);
+    return `${String(minutes)}m ${String(remainingSeconds)}s`;
+}
+/**
+ * Capitalize first letter
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+// =============================================================================
+// Tree Characters (Unicode box drawing)
+// =============================================================================
+const TREE = {
+    branch: '├─', // Non-last item
+    end: '└─', // Last item
+    vertical: '│', // Vertical continuation
+    result: '⎿', // Result/action marker
+    bullet: '●', // Header bullet
+};
+// =============================================================================
+// Subagent Renderer Class
+// =============================================================================
+export class SubagentRenderer {
+    agents = new Map();
+    isExpanded = false;
+    maxDetailLines;
+    showTokens;
+    // Callback for when state changes (trigger re-render)
+    onUpdate = null;
+    constructor(options = {}) {
+        this.maxDetailLines = options.maxDetailLines ?? 1;
+        this.showTokens = options.showTokens ?? true;
+    }
+    // ===========================================================================
+    // Public API
+    // ===========================================================================
+    /**
+     * Called when a subagent starts
+     */
+    onSubagentStart(id, type, description) {
+        this.agents.set(id, {
+            id,
+            type,
+            description: truncate(description, 50),
+            status: 'running',
+            toolCount: 0,
+            tokenCount: 0,
+            lastAction: '',
+            lastActionDetails: [],
+            startTime: Date.now(),
+        });
+        this.triggerUpdate();
+    }
+    /**
+     * Called when a subagent uses a tool
+     */
+    onToolUse(agentId, toolName, summary) {
+        const agent = this.agents.get(agentId);
+        if (!agent)
+            return;
+        agent.toolCount++;
+        agent.lastAction = summary
+            ? `${capitalize(toolName)}: ${truncate(summary, 40)}`
+            : capitalize(toolName);
+        this.triggerUpdate();
+    }
+    /**
+     * Called when a subagent completes
+     */
+    onSubagentEnd(id, success, tokenCount, error) {
+        const agent = this.agents.get(id);
+        if (!agent)
+            return;
+        agent.status = success ? 'done' : 'error';
+        agent.tokenCount = tokenCount;
+        agent.endTime = Date.now();
+        agent.error = error;
+        agent.lastAction = success ? 'Done' : `Error: ${error || 'Unknown'}`;
+        this.triggerUpdate();
+    }
+    /**
+     * Toggle expanded/collapsed view (Ctrl+O)
+     */
+    toggleExpand() {
+        this.isExpanded = !this.isExpanded;
+        this.triggerUpdate();
+    }
+    /**
+     * Check if there are any active subagents
+     */
+    hasActiveSubagents() {
+        return Array.from(this.agents.values()).some(a => a.status === 'running');
+    }
+    /**
+     * Check if there are any subagents to display
+     */
+    hasSubagents() {
+        return this.agents.size > 0;
+    }
+    /**
+     * Get count of agents by status
+     */
+    getCounts() {
+        let running = 0, done = 0, error = 0;
+        for (const agent of this.agents.values()) {
+            if (agent.status === 'running')
+                running++;
+            else if (agent.status === 'done')
+                done++;
+            else
+                error++;
+        }
+        return { running, done, error, total: this.agents.size };
+    }
+    /**
+     * Get the last agent's stats (for persisting to scrolling zone)
+     * Returns null if no agents tracked
+     */
+    getLastAgentStats() {
+        const agents = Array.from(this.agents.values());
+        if (agents.length === 0)
+            return null;
+        // Get the most recently added agent
+        const agent = agents[agents.length - 1];
+        const endTime = agent.endTime ?? Date.now();
+        const durationMs = endTime - agent.startTime;
+        return {
+            type: agent.type,
+            description: agent.description,
+            toolCount: agent.toolCount,
+            tokenCount: agent.tokenCount,
+            durationMs,
+        };
+    }
+    /**
+     * Clear all agents (after rendering final output to scrolling zone)
+     */
+    clear() {
+        this.agents.clear();
+        this.isExpanded = false;
+        this.triggerUpdate();
+    }
+    /**
+     * Set callback for state updates
+     */
+    setUpdateCallback(callback) {
+        this.onUpdate = callback;
+    }
+    /**
+     * Render the subagent zone - returns array of lines
+     * Only renders running agents - completed agents are shown via printSubagentResponse
+     */
+    render() {
+        if (this.agents.size === 0) {
+            debugRender('Subagent:render', 'no agents, returning []');
+            return [];
+        }
+        // Filter to only running agents - completed agents are shown via printSubagentResponse
+        const runningAgents = Array.from(this.agents.values()).filter(a => a.status === 'running');
+        const allStatuses = Array.from(this.agents.values()).map(a => `${a.id}:${a.status}`);
+        debugRender('Subagent:render', `total=${String(this.agents.size)} running=${String(runningAgents.length)} statuses=[${allStatuses.join(',')}]`);
+        if (runningAgents.length === 0) {
+            return [];
+        }
+        const s = getStyles();
+        // Single agent - simpler display
+        if (runningAgents.length === 1) {
+            const lines = this.renderSingleAgent(runningAgents[0], s);
+            debugRender('Subagent:render', `single agent, returning ${String(lines.length)} lines`);
+            return lines;
+        }
+        // Multiple agents - tree display
+        const counts = this.getCounts();
+        const lines = this.renderMultipleAgents(runningAgents, counts, s);
+        debugRender('Subagent:render', `multiple agents, returning ${String(lines.length)} lines`);
+        return lines;
+    }
+    // ===========================================================================
+    // Private Methods
+    // ===========================================================================
+    triggerUpdate() {
+        if (this.onUpdate) {
+            this.onUpdate();
+        }
+    }
+    /**
+     * Render single agent display
+     */
+    renderSingleAgent(agent, s) {
+        const lines = [];
+        const typeLabel = capitalize(agent.type);
+        // Header line: ● Explore(Find CLI entry points)
+        const header = `${TREE.bullet} ${typeLabel}(${agent.description})`;
+        if (agent.status === 'done') {
+            // Completed: show stats
+            const duration = formatDuration((agent.endTime ?? Date.now()) - agent.startTime);
+            const stats = this.showTokens
+                ? `${String(agent.toolCount)} tool uses · ${formatTokens(agent.tokenCount)} tokens · ${duration}`
+                : `${String(agent.toolCount)} tool uses · ${duration}`;
+            lines.push(s.primary(header));
+            lines.push(s.muted(`  ${TREE.result}  Done (${stats})`));
+        }
+        else if (agent.status === 'error') {
+            lines.push(s.error(header));
+            lines.push(s.error(`  ${TREE.result}  ${agent.lastAction}`));
+        }
+        else {
+            // Running: show last action
+            lines.push(s.primary(header));
+            if (agent.lastAction) {
+                lines.push(s.muted(`  ${TREE.result}  ${agent.lastAction}`));
+            }
+            if (agent.toolCount > 1) {
+                lines.push(s.muted(`     +${String(agent.toolCount - 1)} more tool uses (ctrl+o to expand)`));
+            }
+            // ctrl+b background: coming soon
+        }
+        return lines;
+    }
+    /**
+     * Render multiple agents in tree display
+     */
+    renderMultipleAgents(agents, counts, s) {
+        const lines = [];
+        // Header line
+        let headerText;
+        if (counts.running > 0 && counts.done > 0) {
+            // Mixed states
+            headerText = `${TREE.bullet} ${String(counts.total)} agents (${String(counts.running)} running, ${String(counts.done)} done)`;
+        }
+        else if (counts.running > 0) {
+            // All running
+            const typeLabel = this.getCommonTypeLabel(agents);
+            headerText = `${TREE.bullet} Running ${String(counts.total)} ${typeLabel} agents… (ctrl+o to expand)`;
+        }
+        else {
+            // All done
+            const typeLabel = this.getCommonTypeLabel(agents);
+            headerText = `${TREE.bullet} ${String(counts.total)} ${typeLabel} agents finished (ctrl+o to expand)`;
+        }
+        lines.push(s.primary(headerText));
+        // Render each agent in tree
+        for (let i = 0; i < agents.length; i++) {
+            const agent = agents[i];
+            const isLast = i === agents.length - 1;
+            const branch = isLast ? TREE.end : TREE.branch;
+            const continuation = isLast ? '   ' : `${TREE.vertical}  `;
+            // Agent line: ├─ Find state management · 3 tool uses · 20.7k tokens
+            const toolCountStr = String(agent.toolCount);
+            const stats = this.showTokens
+                ? `${toolCountStr} tool ${agent.toolCount === 1 ? 'use' : 'uses'} · ${formatTokens(agent.tokenCount)} tokens`
+                : `${toolCountStr} tool ${agent.toolCount === 1 ? 'use' : 'uses'}`;
+            const agentLine = `   ${branch} ${agent.description} · ${stats}`;
+            if (agent.status === 'error') {
+                lines.push(s.error(agentLine));
+            }
+            else if (agent.status === 'done') {
+                lines.push(s.muted(agentLine));
+            }
+            else {
+                lines.push(agentLine);
+            }
+            // Last action line:    │  ⎿  Read: src/auth.ts
+            const actionLine = `   ${continuation}${TREE.result}  ${agent.lastAction || (agent.status === 'done' ? 'Done' : 'Starting...')}`;
+            lines.push(s.muted(actionLine));
+        }
+        // Footer hint for running agents
+        if (counts.running > 0) {
+            // ctrl+b background: coming soon
+        }
+        return lines;
+    }
+    /**
+     * Get common type label if all agents are same type, otherwise "mixed"
+     */
+    getCommonTypeLabel(agents) {
+        if (agents.length === 0)
+            return '';
+        const firstType = agents[0].type;
+        const allSame = agents.every(a => a.type === firstType);
+        return allSame ? capitalize(firstType) : '';
+    }
+}

package/dist/ui/terminal-autocomplete-utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Standalone utility functions for input text formatting and autocomplete.
+ *
+ * Extracted from terminal-ui.ts for modularity.
+ * These are pure functions with no class dependencies.
+ */
+import type { CommandOption } from './types.js';
+/**
+ * Format input text with syntax highlighting for special prefixes.
+ * - $agent references: bold + secondary color
+ * - @path references: secondary color
+ * - /commands: primary color
+ */
+export declare function formatInputText(text: string): string;
+/**
+ * Calculate fuzzy match score for a query against a target string.
+ * Higher score = better match. Returns -1 if no match.
+ */
+export declare function fuzzyMatchScore(query: string, target: string): number;
+/**
+ * Filter and rank commands matching input using fuzzy matching
+ */
+export declare function filterCommands(input: string, commands: CommandOption[]): CommandOption[];

package/dist/ui/terminal-autocomplete-utils.js

@@ -0,0 +1,83 @@
+/**
+ * Standalone utility functions for input text formatting and autocomplete.
+ *
+ * Extracted from terminal-ui.ts for modularity.
+ * These are pure functions with no class dependencies.
+ */
+import { Chalk } from 'chalk';
+import { getStyles } from '../themes/index.js';
+// Force color output (level 3 = 24-bit true color)
+const chalk = new Chalk({ level: 3 });
+// =============================================================================
+// Input Text Formatting
+// =============================================================================
+/**
+ * Format input text with syntax highlighting for special prefixes.
+ * - $agent references: bold + secondary color
+ * - @path references: secondary color
+ * - /commands: primary color
+ */
+export function formatInputText(text) {
+    const s = getStyles();
+    let result = text;
+    // Format $agent references - bold + secondary
+    // Match $word at word boundaries (not inside other text)
+    result = result.replace(/(?<![$\w])\$([a-zA-Z_][a-zA-Z0-9_]*)\b/g, (_match, agentId) => chalk.bold(s.secondary(`$${agentId}`)));
+    // Format @path references - secondary (not bold, paths can be long)
+    // Match @word or @path/to/file patterns
+    result = result.replace(/(?<![@\w])@([\w./-]+)/g, (_match, path) => s.secondary(`@${path}`));
+    // Format /commands at start of input - primary color
+    // Only match at start of line (after optional whitespace)
+    result = result.replace(/^(\s*)(\/[a-zA-Z][a-zA-Z0-9_-]*)/g, (_match, space, cmd) => space + s.primary(cmd));
+    return result;
+}
+// =============================================================================
+// Fuzzy Matching
+// =============================================================================
+/**
+ * Calculate fuzzy match score for a query against a target string.
+ * Higher score = better match. Returns -1 if no match.
+ */
+export function fuzzyMatchScore(query, target) {
+    const queryLower = query.toLowerCase();
+    const targetLower = target.toLowerCase();
+    // Exact prefix match - highest priority (score 1000+)
+    if (targetLower.startsWith(queryLower)) {
+        return 1000 + (100 - target.length); // Shorter commands rank higher
+    }
+    // Contiguous substring match - high priority (score 500+)
+    if (targetLower.includes(queryLower)) {
+        const index = targetLower.indexOf(queryLower);
+        return 500 + (100 - index); // Earlier matches rank higher
+    }
+    // Fuzzy match - characters appear in order (score 100+)
+    let queryIdx = 0;
+    let consecutiveBonus = 0;
+    let lastMatchIdx = -1;
+    for (let i = 0; i < targetLower.length && queryIdx < queryLower.length; i++) {
+        if (targetLower[i] === queryLower[queryIdx]) {
+            if (lastMatchIdx === i - 1) {
+                consecutiveBonus += 10;
+            }
+            lastMatchIdx = i;
+            queryIdx++;
+        }
+    }
+    if (queryIdx === queryLower.length) {
+        return 100 + consecutiveBonus + (100 - target.length);
+    }
+    return -1;
+}
+/**
+ * Filter and rank commands matching input using fuzzy matching
+ */
+export function filterCommands(input, commands) {
+    const scored = commands
+        .map((cmd) => ({
+        cmd,
+        score: fuzzyMatchScore(input, cmd.command),
+    }))
+        .filter((item) => item.score >= 0);
+    scored.sort((a, b) => b.score - a.score);
+    return scored.map((item) => item.cmd);
+}

package/dist/ui/terminal-codes.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Terminal ANSI Escape Codes
+ *
+ * Constants and helper functions for ANSI escape sequences.
+ * Used by TerminalRenderer for cursor movement, scroll regions, clearing, etc.
+ *
+ * Reference: https://en.wikipedia.org/wiki/ANSI_escape_code
+ */
+/** Control Sequence Introducer */
+export declare const CSI = "\u001B[";
+/** Operating System Command (for title, etc.) */
+export declare const OSC = "\u001B]";
+/** String Terminator */
+export declare const ST = "\u0007";
+/** Move cursor up N lines */
+export declare const cursorUp: (n: number) => string;
+/** Move cursor down N lines */
+export declare const cursorDown: (n: number) => string;
+/** Move cursor forward (right) N columns */
+export declare const cursorForward: (n: number) => string;
+/** Move cursor back (left) N columns */
+export declare const cursorBack: (n: number) => string;
+/** Move cursor to specific row and column (1-indexed) */
+export declare const cursorTo: (row: number, col: number) => string;
+/** Move cursor to beginning of line */
+export declare const cursorToLineStart = "\r";
+/** Move cursor to specific column (1-indexed) */
+export declare const cursorToColumn: (col: number) => string;
+/** Save cursor position */
+export declare const saveCursor = "\u001B[s";
+/** Restore cursor position */
+export declare const restoreCursor = "\u001B[u";
+/** Hide cursor */
+export declare const hideCursor = "\u001B[?25l";
+/** Show cursor */
+export declare const showCursor = "\u001B[?25h";
+/**
+ * Set scroll region (DECSTBM - DEC Set Top and Bottom Margins)
+ *
+ * @param top - Top row of scroll region (1-indexed, inclusive)
+ * @param bottom - Bottom row of scroll region (1-indexed, inclusive)
+ *
+ * When set, scrolling only affects rows within this region.
+ * Text printed in the scroll region that would overflow scrolls the region.
+ * Content outside the region is not affected.
+ */
+export declare const setScrollRegion: (top: number, bottom: number) => string;
+/**
+ * Reset scroll region to full screen
+ *
+ * Removes any scroll region restrictions.
+ * Scrolling affects the entire terminal again.
+ */
+export declare const resetScrollRegion = "\u001B[r";
+/** Clear from cursor to end of line */
+export declare const clearToEndOfLine = "\u001B[K";
+/** Clear from cursor to start of line */
+export declare const clearToStartOfLine = "\u001B[1K";
+/** Clear entire line */
+export declare const clearLine = "\u001B[2K";
+/** Clear from cursor to end of screen */
+export declare const clearToEndOfScreen = "\u001B[J";
+/** Clear from cursor to start of screen */
+export declare const clearToStartOfScreen = "\u001B[1J";
+/** Clear entire screen (cursor position unchanged) */
+export declare const clearScreen = "\u001B[2J";
+/** Clear entire screen and move cursor to top-left */
+export declare const clearScreenAndHome = "\u001B[2J\u001B[H";
+/**
+ * Enter alternate screen buffer.
+ * Content shown here doesn't go to main scrollback.
+ * Used for modal UIs like menus, editors.
+ */
+export declare const enterAlternateScreen = "\u001B[?1049h";
+/**
+ * Leave alternate screen buffer.
+ * Returns to main screen (previous content restored).
+ */
+export declare const leaveAlternateScreen = "\u001B[?1049l";
+/** Disable all mouse tracking modes */
+export declare const disableMouseTracking = "\u001B[?1000l\u001B[?1002l\u001B[?1003l";
+/** Set terminal window title */
+export declare const setTitle: (title: string) => string;
+/** Ring terminal bell */
+export declare const bell = "\u0007";
+/**
+ * Position cursor at a specific location and clear to end of screen
+ * Useful for redrawing from a known position
+ */
+export declare const positionAndClear: (row: number, col: number) => string;
+/**
+ * Move to row 1, column 1 (home position)
+ */
+export declare const cursorHome = "\u001B[H";