@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/ui/render-modes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Render Modes
+ *
+ * The terminal operates in one of three mutually exclusive modes.
+ * Each mode has different rendering behavior and keyboard handling.
+ */
+/**
+ * Terminal render modes
+ *
+ * MENU:    Full-screen startup menu (no scroll regions)
+ * REPL:    Scroll zone + footer (normal chat mode)
+ * OVERLAY: Full-screen overlay (config, backlog, permissions)
+ */
+export declare enum RenderMode {
+    MENU = "MENU",
+    REPL = "REPL",
+    OVERLAY = "OVERLAY"
+}
+/**
+ * Mode transition events for debugging/logging
+ */
+export interface ModeTransition {
+    from: RenderMode;
+    to: RenderMode;
+    reason: string;
+    timestamp: number;
+}
+/**
+ * Valid mode transitions
+ *
+ * MENU -> REPL:      User selects option (init, chat, continue, etc.)
+ * REPL -> OVERLAY:   User triggers overlay (/config, /backlog, permission)
+ * OVERLAY -> REPL:   User closes overlay (Esc, Enter, etc.)
+ * REPL -> MENU:      User runs /menu command
+ */
+export declare function isValidTransition(from: RenderMode, to: RenderMode): boolean;

package/dist/ui/render-modes.js

@@ -0,0 +1,44 @@
+/**
+ * Render Modes
+ *
+ * The terminal operates in one of three mutually exclusive modes.
+ * Each mode has different rendering behavior and keyboard handling.
+ */
+/**
+ * Terminal render modes
+ *
+ * MENU:    Full-screen startup menu (no scroll regions)
+ * REPL:    Scroll zone + footer (normal chat mode)
+ * OVERLAY: Full-screen overlay (config, backlog, permissions)
+ */
+export var RenderMode;
+(function (RenderMode) {
+    RenderMode["MENU"] = "MENU";
+    RenderMode["REPL"] = "REPL";
+    RenderMode["OVERLAY"] = "OVERLAY";
+})(RenderMode || (RenderMode = {}));
+/**
+ * Valid mode transitions
+ *
+ * MENU -> REPL:      User selects option (init, chat, continue, etc.)
+ * REPL -> OVERLAY:   User triggers overlay (/config, /backlog, permission)
+ * OVERLAY -> REPL:   User closes overlay (Esc, Enter, etc.)
+ * REPL -> MENU:      User runs /menu command
+ */
+export function isValidTransition(from, to) {
+    if (from === to)
+        return false;
+    switch (from) {
+        case RenderMode.MENU:
+            // Menu can go to REPL (user selects option) or OVERLAY (e.g., config from menu)
+            return to === RenderMode.REPL || to === RenderMode.OVERLAY;
+        case RenderMode.REPL:
+            // REPL can go to OVERLAY (modal opened) or MENU (/menu command)
+            return to === RenderMode.OVERLAY || to === RenderMode.MENU;
+        case RenderMode.OVERLAY:
+            // Overlay can go back to REPL (closed) or MENU (rare, but valid)
+            return to === RenderMode.REPL || to === RenderMode.MENU;
+        default:
+            return false;
+    }
+}

package/dist/ui/startup-menu.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Startup Menu Overlay
+ *
+ * Provides a guided entry point for users with options to:
+ * - Start a new project (/new)
+ * - View & manage projects (/projects)
+ * - Continue last project
+ * - Free-form chat
+ * - Configure settings
+ * - Show help
+ * - Exit
+ *
+ * Inspired by ATLAS CLI interactiveMenu()
+ */
+export type MenuOption = 'init' | 'projects' | 'continue' | 'chat' | 'config' | 'help' | 'exit';
+export interface StartupMenuResult {
+    action: MenuOption;
+    project?: {
+        id: number;
+        name: string;
+        displayName: string;
+        path: string;
+    };
+}
+/**
+ * Show the startup menu and return the user's choice
+ */
+export declare function showStartupMenu(version: string): Promise<StartupMenuResult>;
+/**
+ * Find the last active project for the "continue" option
+ */
+export declare function findLastActiveProject(): {
+    id: number;
+    name: string;
+    path: string;
+} | null;

package/dist/ui/startup-menu.js

@@ -0,0 +1,236 @@
+/**
+ * Startup Menu Overlay
+ *
+ * Provides a guided entry point for users with options to:
+ * - Start a new project (/new)
+ * - View & manage projects (/projects)
+ * - Continue last project
+ * - Free-form chat
+ * - Configure settings
+ * - Show help
+ * - Exit
+ *
+ * Inspired by ATLAS CLI interactiveMenu()
+ */
+import { getStyles } from '../themes/index.js';
+import * as terminal from './terminal.js';
+import { projectRepository } from '../db/repositories/index.js';
+import { setActiveProject } from '../tools/project-db.js';
+import { printLogo } from './conversation.js';
+// =============================================================================
+// Menu Options
+// =============================================================================
+function getMenuOptions(hasLastProject, lastProjectName) {
+    return [
+        {
+            key: 'init',
+            label: 'init',
+            description: 'Start a new project',
+        },
+        {
+            key: 'projects',
+            label: 'projects',
+            description: 'View & manage projects',
+        },
+        {
+            key: 'continue',
+            label: 'continue',
+            description: hasLastProject
+                ? `Resume: ${lastProjectName ?? 'project'}`
+                : 'No recent project',
+            disabled: !hasLastProject,
+        },
+        {
+            key: 'chat',
+            label: 'chat',
+            description: 'Free-form AI chat',
+        },
+        {
+            key: 'config',
+            label: 'config',
+            description: 'Configure settings',
+        },
+        {
+            key: 'help',
+            label: 'help',
+            description: 'Show help and shortcuts',
+        },
+        {
+            key: 'exit',
+            label: 'exit',
+            description: 'Exit CLI',
+        },
+    ];
+}
+// =============================================================================
+// Rendering
+// =============================================================================
+function renderMenu(state) {
+    const s = getStyles();
+    const lines = [];
+    lines.push('');
+    lines.push(' What would you like to do?');
+    lines.push('');
+    // Menu options - left-aligned like /config overlay
+    const labelWidth = 14;
+    for (let i = 0; i < state.options.length; i++) {
+        const opt = state.options[i];
+        const isSelected = i === state.selectedIndex;
+        const prefix = isSelected ? s.primary(' ❯ ') : '   ';
+        const rawLabel = opt.label.padEnd(labelWidth);
+        const rawDesc = opt.description;
+        let label;
+        let description;
+        if (opt.disabled) {
+            label = s.muted(rawLabel);
+            description = s.muted(rawDesc);
+        }
+        else if (isSelected) {
+            label = s.primary(rawLabel);
+            description = s.foreground(rawDesc);
+        }
+        else {
+            label = s.foreground(rawLabel);
+            description = s.muted(rawDesc);
+        }
+        lines.push(prefix + label + description);
+    }
+    lines.push('');
+    lines.push(s.muted(' ↑/↓: navigate  Enter: select'));
+    return lines;
+}
+// =============================================================================
+// Main Function
+// =============================================================================
+/**
+ * Show the startup menu and return the user's choice
+ */
+export async function showStartupMenu(version) {
+    return new Promise((resolve) => {
+        // Check for last active project
+        let lastProject = null;
+        try {
+            const result = projectRepository.list({ status: 'active', limit: 1 });
+            if (result.projects.length > 0) {
+                const p = result.projects[0];
+                lastProject = { id: p.id, name: p.name, displayName: p.displayName, path: p.path };
+            }
+        }
+        catch {
+            // DB might not exist yet
+        }
+        const hasLastProject = lastProject !== null;
+        const lastProjectName = lastProject?.displayName;
+        const state = {
+            selectedIndex: 0,
+            options: getMenuOptions(hasLastProject, lastProjectName),
+            hasLastProject,
+            lastProjectName,
+        };
+        // Enable raw mode for key detection (no readline - it causes echo)
+        const wasRawMode = process.stdin.isRaw;
+        terminal.enableRawMode();
+        terminal.hideCursor();
+        let prevLineCount = 0;
+        const render = (isInitial = false) => {
+            if (isInitial) {
+                // First render: print logo and save cursor position
+                printLogo(version, lastProject?.displayName ?? null);
+                terminal.saveCursor();
+            }
+            else {
+                // Subsequent renders: restore cursor and clear to end of screen
+                terminal.restoreCursor();
+                terminal.clearToEndOfScreen();
+            }
+            // Render the menu
+            const lines = renderMenu(state);
+            const termWidth = terminal.getTerminalWidth();
+            const physicalLines = terminal.totalPhysicalLines(lines, termWidth);
+            // Pad to previous height to prevent shrinking
+            for (let i = physicalLines; i < prevLineCount; i++) {
+                lines.push('');
+            }
+            process.stdout.write(lines.join('\n') + '\n');
+            prevLineCount = Math.max(prevLineCount, physicalLines);
+        };
+        // Define handleKey first, then cleanup references it
+        const handleKey = (key) => {
+            const keyStr = key.toString();
+            // Arrow keys
+            if (keyStr === '\x1b[A' || keyStr === 'k') {
+                // Up
+                do {
+                    state.selectedIndex = (state.selectedIndex - 1 + state.options.length) % state.options.length;
+                } while (state.options[state.selectedIndex].disabled);
+                render(false);
+            }
+            else if (keyStr === '\x1b[B' || keyStr === 'j') {
+                // Down
+                do {
+                    state.selectedIndex = (state.selectedIndex + 1) % state.options.length;
+                } while (state.options[state.selectedIndex].disabled);
+                render(false);
+            }
+            else if (keyStr === '\r' || keyStr === '\n') {
+                // Enter
+                const selected = state.options[state.selectedIndex];
+                if (!selected.disabled) {
+                    // Cleanup: Remove listener BEFORE changing raw mode to prevent issues
+                    process.stdin.removeListener('data', handleKey);
+                    if (!wasRawMode) {
+                        terminal.disableRawMode();
+                    }
+                    terminal.showCursor();
+                    // Handle continue option - set active project
+                    if (selected.key === 'continue' && lastProject) {
+                        setActiveProject({
+                            id: lastProject.id,
+                            name: lastProject.name,
+                            displayName: lastProject.displayName,
+                            path: lastProject.path,
+                        });
+                        resolve({
+                            action: 'continue',
+                            project: {
+                                id: lastProject.id,
+                                name: lastProject.name,
+                                displayName: lastProject.displayName,
+                                path: lastProject.path,
+                            },
+                        });
+                    }
+                    else {
+                        resolve({ action: selected.key });
+                    }
+                }
+            }
+            else if (keyStr === '\x03') {
+                // Ctrl+C - cleanup and exit
+                process.stdin.removeListener('data', handleKey);
+                terminal.disableRawMode();
+                terminal.showCursor();
+                process.exit(0);
+            }
+        };
+        process.stdin.on('data', handleKey);
+        // Initial render
+        render(true);
+    });
+}
+/**
+ * Find the last active project for the "continue" option
+ */
+export function findLastActiveProject() {
+    try {
+        const result = projectRepository.list({ status: 'active', limit: 1 });
+        if (result.projects.length > 0) {
+            const p = result.projects[0];
+            return { id: p.id, name: p.name, path: p.path };
+        }
+    }
+    catch {
+        // DB might not exist
+    }
+    return null;
+}

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;
+}