@compilr-dev/cli 0.4.0 → 0.5.1

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

@@ -0,0 +1,287 @@
+/**
+ * Help Overlay V2
+ *
+ * Displays available commands in a searchable, categorized list.
+ * Uses TabbedListOverlayV2 for the new Overlay interface.
+ *
+ * Features:
+ * - Tabs: All, Built-in, Custom
+ * - Search with / toggle
+ * - Detail view for full command information
+ * - Works with TerminalUI's overlay management
+ */
+import chalk from 'chalk';
+import * as terminal from '../../terminal.js';
+import { getCustomCommandRegistry } from '../../../commands/index.js';
+import { TabbedListOverlayV2, BaseScreen, stay, popScreen, closeOverlay, isEscape, isCtrlC, isClose, renderBorder, wrapText, truncateAnsi, } from '../../base/index.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const VERSION = 'compilr.dev/agent';
+const PAGE_SIZE = 10;
+const TABS = [
+    { id: 'all', label: 'All' },
+    { id: 'builtin', label: 'Built-in' },
+    { id: 'custom', label: 'Custom' },
+];
+// =============================================================================
+// Detail Screens
+// =============================================================================
+/**
+ * Built-in command detail screen
+ */
+class CommandDetailScreen extends BaseScreen {
+    item;
+    styles;
+    getCommand;
+    constructor(item, styles, getCommand) {
+        super();
+        this.item = item;
+        this.styles = styles;
+        this.getCommand = getCommand;
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const maxLineWidth = cols - 2;
+        const border = renderBorder(cols, s);
+        const cmd = this.item.commandName
+            ? this.getCommand(this.item.commandName)
+            : null;
+        const lines = [];
+        lines.push(border);
+        lines.push(' ' + s.primaryBold('Command Reference'));
+        lines.push('');
+        if (!cmd) {
+            lines.push(s.error(' Command not found'));
+            lines.push(border);
+            lines.push(`  ${s.muted('q/Esc Back')}`);
+            lines.push(border);
+            return lines;
+        }
+        // Command name
+        lines.push(chalk.bold(` /${cmd.name}`));
+        lines.push('');
+        // Description
+        lines.push(' ' + s.primary('DESCRIPTION'));
+        lines.push(truncateAnsi('   ' + cmd.description, maxLineWidth));
+        lines.push('');
+        // Details
+        if (cmd.details) {
+            lines.push(' ' + s.primary('ABOUT'));
+            const maxWidth = Math.min(cols - 6, 70);
+            const words = cmd.details.split(' ');
+            let currentLine = '   ';
+            for (const word of words) {
+                if (currentLine.length + word.length + 1 > maxWidth) {
+                    lines.push(truncateAnsi(currentLine, maxLineWidth));
+                    currentLine = '   ' + word;
+                }
+                else {
+                    currentLine += (currentLine.length > 3 ? ' ' : '') + word;
+                }
+            }
+            if (currentLine.length > 3) {
+                lines.push(truncateAnsi(currentLine, maxLineWidth));
+            }
+            lines.push('');
+        }
+        // Aliases
+        if (cmd.aliases && cmd.aliases.length > 0) {
+            lines.push(' ' + s.primary('ALIASES'));
+            lines.push(truncateAnsi('   ' + cmd.aliases.map((a) => `/${a}`).join(', '), maxLineWidth));
+            lines.push('');
+        }
+        // Examples
+        if (cmd.examples && cmd.examples.length > 0) {
+            lines.push(' ' + s.primary('EXAMPLES'));
+            for (const example of cmd.examples) {
+                if (example.description) {
+                    const paddedCode = example.code.padEnd(22);
+                    const exLine = `   ${s.muted(paddedCode)}${s.muted('·')} ${example.description}`;
+                    lines.push(truncateAnsi(exLine, maxLineWidth));
+                }
+                else {
+                    lines.push(truncateAnsi('   ' + s.muted(example.code), maxLineWidth));
+                }
+            }
+            lines.push('');
+        }
+        // Interactions
+        if (cmd.interactions && cmd.interactions.length > 0) {
+            lines.push(' ' + s.primary('INTERACTIONS'));
+            for (const hint of cmd.interactions) {
+                lines.push(truncateAnsi('   ' + s.muted('• ' + hint), maxLineWidth));
+            }
+            lines.push('');
+        }
+        // Footer
+        lines.push(border);
+        lines.push(`  ${s.muted('q/Esc Back')}`);
+        lines.push(border);
+        return lines;
+    }
+    handleKey(data) {
+        if (isCtrlC(data)) {
+            return closeOverlay(undefined);
+        }
+        if (isEscape(data) || isClose(data)) {
+            return popScreen();
+        }
+        return stay(false);
+    }
+    /**
+     * Minimum height for stable rendering.
+     * Covers: header(3) + name(2) + desc(3) + about(5) + aliases(3) + examples(6) + interactions(4) + footer(3) = 29
+     */
+    getMinHeight() {
+        return 25;
+    }
+}
+/**
+ * Custom command detail screen
+ */
+class CustomCommandDetailScreen extends BaseScreen {
+    item;
+    styles;
+    constructor(item, styles) {
+        super();
+        this.item = item;
+        this.styles = styles;
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const border = renderBorder(cols, s);
+        const registry = getCustomCommandRegistry();
+        const lines = [];
+        lines.push(border);
+        lines.push(' ' + s.primaryBold('Custom Command Details'));
+        lines.push('');
+        // Command name
+        lines.push(chalk.bold(` /${this.item.name}`));
+        lines.push('');
+        // Location
+        lines.push(' ' + s.primary('LOCATION'));
+        const loc = this.item.location ?? 'personal';
+        lines.push(`   ${loc === 'project' ? 'Project' : 'Personal'} (${loc})`);
+        lines.push('');
+        // File path
+        lines.push(' ' + s.primary('FILE'));
+        const basePath = loc === 'project'
+            ? registry.getProjectDir()
+            : registry.getUserDir();
+        lines.push(s.muted(`   ${basePath}/${this.item.name}.md`));
+        lines.push('');
+        // Description
+        lines.push(' ' + s.primary('DESCRIPTION'));
+        lines.push(...wrapText(this.item.description, cols - 6, '   '));
+        lines.push('');
+        // Prompt
+        if (this.item.prompt) {
+            lines.push(' ' + s.primary('PROMPT TEMPLATE'));
+            lines.push(...wrapText(this.item.prompt, cols - 6, '   '));
+            lines.push('');
+        }
+        // Footer
+        lines.push(border);
+        lines.push(`  ${s.muted('q/Esc Back')}`);
+        lines.push(border);
+        return lines;
+    }
+    handleKey(data) {
+        if (isCtrlC(data)) {
+            return closeOverlay(undefined);
+        }
+        if (isEscape(data) || isClose(data)) {
+            return popScreen();
+        }
+        return stay(false);
+    }
+    /**
+     * Minimum height for stable rendering.
+     * Covers: header(3) + name(2) + location(3) + file(3) + desc(5) + prompt(5) + footer(3) = 24
+     */
+    getMinHeight() {
+        return 22;
+    }
+}
+// =============================================================================
+// Help Overlay V2 Class
+// =============================================================================
+/**
+ * Help overlay using the new Overlay interface.
+ * Displays available commands in a searchable, tabbed list.
+ */
+export class HelpOverlayV2 extends TabbedListOverlayV2 {
+    type = 'inline';
+    id = 'help-overlay-v2';
+    getCommandDetail;
+    constructor(options) {
+        // Build unified items list
+        const items = [];
+        // Add built-in commands
+        const helpCommands = options.getHelpCommands();
+        for (const cmd of helpCommands) {
+            items.push({
+                name: cmd.name,
+                description: cmd.description,
+                type: 'builtin',
+                commandName: cmd.name.startsWith('/') ? cmd.name.slice(1) : cmd.name,
+            });
+        }
+        // Add custom commands
+        const registry = getCustomCommandRegistry();
+        const customCommands = registry.getAll();
+        for (const cmd of customCommands) {
+            items.push({
+                name: `/${cmd.name}`,
+                description: cmd.description,
+                type: 'custom',
+                prompt: cmd.prompt,
+                location: cmd.location,
+            });
+        }
+        super({
+            title: VERSION,
+            tabs: TABS,
+            items,
+            pageSize: PAGE_SIZE,
+            filterByTab: (item, tabId) => {
+                if (tabId === 'all')
+                    return true;
+                if (tabId === 'builtin')
+                    return item.type === 'builtin';
+                if (tabId === 'custom')
+                    return item.type === 'custom';
+                return true;
+            },
+            getSearchText: (item) => `${item.name} ${item.description}`,
+            renderItem: (item, isSelected, styles) => {
+                const prefix = isSelected ? styles.primary(' > ') : '   ';
+                const name = isSelected
+                    ? styles.primary(item.name.padEnd(20))
+                    : styles.muted(item.name.padEnd(20));
+                const desc = styles.muted(item.description);
+                const badge = item.type === 'custom' ? styles.muted(' (custom)') : '';
+                return prefix + name + desc + badge;
+            },
+            footerHints: (searchMode) => {
+                if (searchMode) {
+                    return 'Type to filter · ↑↓/jk Navigate · Enter Details · Esc Exit search';
+                }
+                return 'Tab Filter · ↑↓/jk · ←→/hl Pages · / Search · Enter Details · q/Esc Close';
+            },
+            emptyMessage: 'No commands available.',
+            noResultsMessage: 'No commands match the search.',
+        });
+        this.getCommandDetail = options.getCommand;
+    }
+    createDetailScreen(item) {
+        const styles = this.getStyles();
+        if (item.type === 'builtin') {
+            return new CommandDetailScreen(item, styles, this.getCommandDetail);
+        }
+        return new CustomCommandDetailScreen(item, styles);
+    }
+}

package/dist/ui/overlay/impl/init-setup-overlay-v2.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Init Setup Overlay V2 (Placeholder)
+ *
+ * Shows current CLI configuration status and directs users to /config.
+ * This is a placeholder - full setup wizard will be implemented in a future session.
+ *
+ * Displays:
+ * - API key status for each provider
+ * - Current settings summary
+ * - Instructions for configuration
+ */
+import { BaseOverlayV2 } from '../../base/overlay-base-v2.js';
+import type { OverlayAction, KeyEvent, RenderContext } from '../types.js';
+type InitSetupState = Record<string, never>;
+export interface InitSetupResultV2 {
+    dismissed: boolean;
+}
+export declare class InitSetupOverlayV2 extends BaseOverlayV2<InitSetupState, InitSetupResultV2> {
+    readonly type: "inline";
+    readonly id = "init-setup-overlay-v2";
+    constructor();
+    protected renderContent(_context: RenderContext): string[];
+    handleKey(_key: KeyEvent): OverlayAction<InitSetupResultV2>;
+}
+export {};

package/dist/ui/overlay/impl/init-setup-overlay-v2.js

@@ -0,0 +1,97 @@
+/**
+ * Init Setup Overlay V2 (Placeholder)
+ *
+ * Shows current CLI configuration status and directs users to /config.
+ * This is a placeholder - full setup wizard will be implemented in a future session.
+ *
+ * Displays:
+ * - API key status for each provider
+ * - Current settings summary
+ * - Instructions for configuration
+ */
+import { BaseOverlayV2 } from '../../base/overlay-base-v2.js';
+import { renderBorder } from '../../base/index.js';
+import { hasApiKey, getMaskedKey, isKeyFromEnv } from '../../../utils/credentials.js';
+import { getSettings } from '../../../settings/index.js';
+import * as terminal from '../../terminal.js';
+// =============================================================================
+// Init Setup Overlay V2
+// =============================================================================
+export class InitSetupOverlayV2 extends BaseOverlayV2 {
+    type = 'inline';
+    id = 'init-setup-overlay-v2';
+    constructor() {
+        super({});
+        this.minHeight = 24;
+    }
+    renderContent(_context) {
+        const s = this.getStyles();
+        const cols = terminal.getTerminalWidth();
+        const border = renderBorder(cols, s);
+        const lines = [];
+        const settings = getSettings();
+        // Header
+        lines.push(border);
+        lines.push(`  ${s.primaryBold('CLI SETUP STATUS')}`);
+        lines.push(border);
+        lines.push('');
+        // API Keys Section
+        lines.push(`  ${s.secondary('API Keys')}`);
+        lines.push('');
+        const providers = [
+            { key: 'anthropic', name: 'Anthropic (Claude)', envVar: 'ANTHROPIC_API_KEY' },
+            { key: 'openai', name: 'OpenAI', envVar: 'OPENAI_API_KEY' },
+            { key: 'google', name: 'Google AI (Gemini)', envVar: 'GOOGLE_API_KEY' },
+        ];
+        for (const provider of providers) {
+            const has = hasApiKey(provider.key);
+            const fromEnv = isKeyFromEnv(provider.key);
+            const masked = getMaskedKey(provider.key);
+            let status;
+            if (has) {
+                if (fromEnv) {
+                    status = s.success(`✓ From env (${provider.envVar})`);
+                }
+                else {
+                    status = s.success(`✓ Configured (${masked ?? '***'})`);
+                }
+            }
+            else {
+                status = s.muted('○ Not configured');
+            }
+            lines.push(`    ${provider.name.padEnd(22)} ${status}`);
+        }
+        // Ollama (always available)
+        lines.push(`    ${'Ollama (Local)'.padEnd(22)} ${s.muted('○ No key needed')}`);
+        lines.push('');
+        // Current Settings Summary
+        lines.push(`  ${s.secondary('Current Settings')}`);
+        lines.push('');
+        lines.push(`    Default provider:    ${s.primary(settings.defaultProvider)}`);
+        lines.push(`    Default model:       ${s.primary(settings.defaultModel ?? 'auto')}`);
+        lines.push(`    Startup mode:        ${s.primary(settings.startupMode)}`);
+        lines.push(`    Project auto-open:   ${s.primary(settings.projectStartup)}`);
+        lines.push('');
+        // Instructions
+        lines.push(border);
+        lines.push('');
+        lines.push(`  ${s.secondary('To configure the CLI:')}`);
+        lines.push('');
+        lines.push(`    ${s.primary('/config')}     Open settings overlay`);
+        lines.push(`    ${s.primary('/keys')}       Manage API keys`);
+        lines.push(`    ${s.primary('/theme')}      Change color theme`);
+        lines.push(`    ${s.primary('/model')}      Select AI model`);
+        lines.push('');
+        lines.push(s.muted('  Settings are stored in ~/.compilr-dev/'));
+        lines.push('');
+        // Footer
+        lines.push(border);
+        lines.push(s.muted('  Press any key to close'));
+        lines.push(border);
+        return lines;
+    }
+    handleKey(_key) {
+        // Any key closes
+        return this.close({ dismissed: true });
+    }
+}

package/dist/ui/overlay/impl/iteration-limit-overlay-v2.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Iteration Limit Overlay V2
+ *
+ * Modal overlay shown when the agent reaches its iteration limit.
+ * Uses BaseOverlayV2 for TerminalUI integration.
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../types.js';
+export type IterationLimitResultV2 = {
+    continue: true;
+    additionalIterations: number;
+} | {
+    continue: false;
+};
+export interface IterationLimitOptionsV2 {
+    iteration: number;
+    maxIterations: number;
+    toolCallCount: number;
+}
+interface IterationLimitState {
+    selectedIndex: number;
+}
+export declare class IterationLimitOverlayV2 extends BaseOverlayV2<IterationLimitState, IterationLimitResultV2> {
+    readonly type: "inline";
+    readonly id = "iteration-limit-overlay-v2";
+    private readonly options;
+    constructor(options: IterationLimitOptionsV2);
+    protected renderContent(context: RenderContext): string[];
+    handleKey(key: KeyEvent): OverlayAction<IterationLimitResultV2>;
+    /**
+     * Summary shown after overlay closes.
+     */
+    getCloseSummary(result: IterationLimitResultV2): string | null;
+}
+export {};

package/dist/ui/overlay/impl/iteration-limit-overlay-v2.js

@@ -0,0 +1,105 @@
+/**
+ * Iteration Limit Overlay V2
+ *
+ * Modal overlay shown when the agent reaches its iteration limit.
+ * Uses BaseOverlayV2 for TerminalUI integration.
+ */
+import chalk from 'chalk';
+import { BaseOverlayV2, renderBorder } from '../../base/index.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const OPTIONS = [
+    { label: 'Yes, continue (+10 iterations)', key: '1', result: { continue: true, additionalIterations: 10 } },
+    { label: 'Yes, continue (+20 iterations)', key: '2', result: { continue: true, additionalIterations: 20 } },
+    { label: 'No, stop here', key: 'n', result: { continue: false } },
+];
+// =============================================================================
+// Overlay Implementation
+// =============================================================================
+export class IterationLimitOverlayV2 extends BaseOverlayV2 {
+    type = 'inline';
+    id = 'iteration-limit-overlay-v2';
+    options;
+    constructor(options) {
+        super({
+            selectedIndex: 0, // Default to "Yes, continue (+10)"
+        });
+        this.options = options;
+        this.minHeight = 14; // Prevent jitter
+    }
+    renderContent(context) {
+        const s = context.styles;
+        const lines = [];
+        const cols = context.width;
+        const border = renderBorder(cols, s);
+        // Header
+        lines.push(border);
+        lines.push(' ' + s.warning('!') + ' ' + chalk.bold('Iteration Limit Reached'));
+        lines.push('');
+        // Stats
+        lines.push('  Iterations: ' + s.primary(String(this.options.iteration)) + ' / ' + s.muted(String(this.options.maxIterations)));
+        lines.push('  Tool calls: ' + s.primary(String(this.options.toolCallCount)));
+        lines.push('');
+        lines.push('  ' + s.muted('The agent has reached its iteration limit.'));
+        lines.push('  ' + s.muted('Would you like to continue?'));
+        lines.push('');
+        // Options
+        for (let i = 0; i < OPTIONS.length; i++) {
+            const isCursor = this.state.selectedIndex === i;
+            const prefix = isCursor ? ' > ' : '   ';
+            const key = `[${OPTIONS[i].key}] `;
+            if (isCursor) {
+                lines.push(s.primary(prefix + key + OPTIONS[i].label));
+            }
+            else {
+                lines.push(s.muted(prefix + key + OPTIONS[i].label));
+            }
+        }
+        // Footer
+        lines.push('');
+        lines.push(s.muted(' Up/Down Navigate | Enter Select | 1/2/n Quick select'));
+        // Bottom border
+        lines.push(border);
+        return lines;
+    }
+    handleKey(key) {
+        // Ctrl+C or Escape = stop
+        if ((key.ctrl && key.name === 'c') || key.name === 'escape') {
+            return this.close({ continue: false });
+        }
+        // Quick keys
+        if (key.char === '1') {
+            return this.close({ continue: true, additionalIterations: 10 });
+        }
+        if (key.char === '2') {
+            return this.close({ continue: true, additionalIterations: 20 });
+        }
+        if (key.char?.toLowerCase() === 'n') {
+            return this.close({ continue: false });
+        }
+        // Arrow navigation
+        if (key.name === 'up') {
+            this.state.selectedIndex = Math.max(0, this.state.selectedIndex - 1);
+            return this.rerender();
+        }
+        if (key.name === 'down') {
+            this.state.selectedIndex = Math.min(OPTIONS.length - 1, this.state.selectedIndex + 1);
+            return this.rerender();
+        }
+        if (key.name === 'return') {
+            return this.close(OPTIONS[this.state.selectedIndex].result);
+        }
+        return this.noAction();
+    }
+    /**
+     * Summary shown after overlay closes.
+     */
+    getCloseSummary(result) {
+        const s = this.getStyles();
+        if (result.continue) {
+            return s.muted('Iteration limit: ') + s.success(`Continuing (+${String(result.additionalIterations)})`);
+        }
+        return s.muted('Iteration limit: ') + s.error('Stopped');
+    }
+}

package/dist/ui/overlay/impl/keys-overlay-v2.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Keys Overlay V2
+ *
+ * API key management overlay using the new Overlay interface.
+ * Shows status of all providers and allows setting/deleting keys.
+ *
+ * Features:
+ * - List all providers with key status
+ * - Set new API keys
+ * - Delete stored keys
+ * - Works with TerminalUI's overlay management
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import { getAllProviderStatuses } from '../../../utils/credentials.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../index.js';
+export interface KeysOverlayV2Result {
+    /** Whether any keys were changed */
+    changed: boolean;
+}
+interface KeysState {
+    selectedIndex: number;
+    changed: boolean;
+    providers: ReturnType<typeof getAllProviderStatuses>;
+}
+/**
+ * Keys overlay using the new Overlay interface.
+ * Manages API keys for LLM providers.
+ */
+export declare class KeysOverlayV2 extends BaseOverlayV2<KeysState, KeysOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "keys-overlay-v2";
+    private readonly screenStack;
+    constructor();
+    protected renderContent(_context: RenderContext): string[];
+    render(context: RenderContext): {
+        lines: string[];
+        minHeight?: number;
+    };
+    handleKey(key: KeyEvent): OverlayAction<KeysOverlayV2Result>;
+}
+export {};