@compilr-dev/cli 0.4.0 → 0.5.0

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

@@ -0,0 +1,43 @@
+/**
+ * Guardrail Confirmation Overlay V2
+ *
+ * Shows when a guardrail with action='confirm' is triggered.
+ * User must approve or deny the risky operation.
+ * Uses BaseOverlayV2 for TerminalUI integration.
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../types.js';
+interface GuardrailState {
+    selectedIndex: number;
+}
+export interface GuardrailConfirmOptionsV2 {
+    /** Guardrail name */
+    name: string;
+    /** Guardrail description/message */
+    message: string;
+    /** Action type (for display) */
+    action: 'warn' | 'confirm' | 'block';
+    /** Tool that triggered the guardrail */
+    toolName: string;
+    /** The input that matched the pattern */
+    matchedInput: string;
+    /** Category (e.g., 'git', 'filesystem', 'database') */
+    category?: string;
+}
+export interface GuardrailConfirmResultV2 {
+    /** Whether to proceed with the operation */
+    approved: boolean;
+}
+export declare class GuardrailOverlayV2 extends BaseOverlayV2<GuardrailState, GuardrailConfirmResultV2> {
+    readonly type: "inline";
+    readonly id = "guardrail-overlay-v2";
+    private readonly options;
+    constructor(options: GuardrailConfirmOptionsV2);
+    protected renderContent(context: RenderContext): string[];
+    handleKey(key: KeyEvent): OverlayAction<GuardrailConfirmResultV2>;
+    /**
+     * Summary shown after overlay closes.
+     */
+    getCloseSummary(result: GuardrailConfirmResultV2): string | null;
+}
+export {};

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

@@ -0,0 +1,114 @@
+/**
+ * Guardrail Confirmation Overlay V2
+ *
+ * Shows when a guardrail with action='confirm' is triggered.
+ * User must approve or deny the risky operation.
+ * Uses BaseOverlayV2 for TerminalUI integration.
+ */
+import chalk from 'chalk';
+import { BaseOverlayV2, renderBorder, wrapText } from '../../base/index.js';
+// =============================================================================
+// Overlay Implementation
+// =============================================================================
+export class GuardrailOverlayV2 extends BaseOverlayV2 {
+    type = 'inline';
+    id = 'guardrail-overlay-v2';
+    options;
+    constructor(options) {
+        super({
+            selectedIndex: 0, // Default to Deny (safer)
+        });
+        this.options = options;
+        this.minHeight = 15; // Prevent jitter
+    }
+    renderContent(context) {
+        const s = context.styles;
+        const lines = [];
+        const cols = context.width;
+        const border = renderBorder(cols, s);
+        // Header with warning icon
+        lines.push(border);
+        lines.push(' ' + s.warning('! Risky Operation Detected'));
+        lines.push('');
+        // Guardrail info
+        const category = this.options.category ? `[${this.options.category}]` : '';
+        lines.push(s.muted(` ${category} `) + chalk.bold(this.options.name));
+        lines.push('');
+        // Message
+        const msgLines = wrapText(this.options.message, cols - 4);
+        for (const line of msgLines) {
+            lines.push('   ' + s.muted(line));
+        }
+        lines.push('');
+        // Tool and matched input
+        lines.push(s.muted(' Tool: ') + s.primary(this.options.toolName));
+        // Show truncated matched input
+        const maxInputLen = cols - 12;
+        let displayInput = this.options.matchedInput;
+        if (displayInput.length > maxInputLen) {
+            displayInput = displayInput.substring(0, maxInputLen - 3) + '...';
+        }
+        // Replace newlines with visible markers
+        displayInput = displayInput.replace(/\n/g, '↵');
+        lines.push(s.muted(' Match: ') + s.warning(displayInput));
+        lines.push('');
+        // Action buttons
+        const denyLabel = this.state.selectedIndex === 0
+            ? s.error(' > Deny ')
+            : s.muted('   Deny ');
+        const allowLabel = this.state.selectedIndex === 1
+            ? s.warning(' > Allow ')
+            : s.muted('   Allow ');
+        lines.push(' ' + denyLabel + '  ' + allowLabel);
+        lines.push('');
+        // Footer
+        lines.push(s.muted(' Left/Right Select | Enter Confirm | Esc Deny'));
+        lines.push(border);
+        return lines;
+    }
+    handleKey(key) {
+        // Ctrl+C or Escape = Deny
+        if ((key.ctrl && key.name === 'c') || key.name === 'escape') {
+            return this.close({ approved: false });
+        }
+        // Left arrow or h for Deny
+        if (key.name === 'left' || key.char === 'h') {
+            this.state.selectedIndex = 0;
+            return this.rerender();
+        }
+        // Right arrow or l for Allow
+        if (key.name === 'right' || key.char === 'l') {
+            this.state.selectedIndex = 1;
+            return this.rerender();
+        }
+        // Tab to toggle
+        if (key.name === 'tab') {
+            this.state.selectedIndex = this.state.selectedIndex === 0 ? 1 : 0;
+            return this.rerender();
+        }
+        // Enter to confirm selection
+        if (key.name === 'return') {
+            return this.close({ approved: this.state.selectedIndex === 1 });
+        }
+        // 'd' or 'n' for Deny
+        const keyChar = key.char?.toLowerCase() ?? '';
+        if (keyChar === 'd' || keyChar === 'n') {
+            return this.close({ approved: false });
+        }
+        // 'a' or 'y' for Allow
+        if (keyChar === 'a' || keyChar === 'y') {
+            return this.close({ approved: true });
+        }
+        return this.noAction();
+    }
+    /**
+     * Summary shown after overlay closes.
+     */
+    getCloseSummary(result) {
+        const s = this.getStyles();
+        if (result.approved) {
+            return s.muted('Guardrail: ') + s.warning('Allowed ') + s.muted(this.options.name);
+        }
+        return s.muted('Guardrail: ') + s.error('Denied ') + s.muted(this.options.name);
+    }
+}

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

@@ -0,0 +1,34 @@
+/**
+ * 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 { TabbedListOverlayV2, BaseScreen } from '../../base/index.js';
+interface HelpItem {
+    name: string;
+    description: string;
+    type: 'builtin' | 'custom';
+    /** For custom commands */
+    prompt?: string;
+    location?: 'project' | 'personal';
+    /** Index in COMMANDS array for built-in commands */
+    commandIndex?: number;
+}
+/**
+ * Help overlay using the new Overlay interface.
+ * Displays available commands in a searchable, tabbed list.
+ */
+export declare class HelpOverlayV2 extends TabbedListOverlayV2<HelpItem> {
+    readonly type: "inline";
+    readonly id = "help-overlay-v2";
+    constructor();
+    protected createDetailScreen(item: HelpItem): BaseScreen | null;
+}
+export {};

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

@@ -0,0 +1,309 @@
+/**
+ * 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 { getHelpCommands, getCommandByIndex } from '../../../commands.js';
+import { getCustomCommandRegistry } from '../../../commands/index.js';
+import { TabbedListOverlayV2, BaseScreen, stay, popScreen, closeOverlay, isEscape, isCtrlC, isClose, renderBorder, wrapText, } 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;
+    constructor(item, styles) {
+        super();
+        this.item = item;
+        this.styles = styles;
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const maxLineWidth = cols - 2;
+        const border = renderBorder(cols, s);
+        const cmd = this.item.commandIndex !== undefined
+            ? getCommandByIndex(this.item.commandIndex)
+            : 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;
+        }
+        // Helper to truncate
+        const truncate = (line, max = maxLineWidth) => {
+            // eslint-disable-next-line no-control-regex
+            const stripped = line.replace(/\x1b\[[0-9;]*m/g, '');
+            if (stripped.length <= max)
+                return line;
+            let visibleLen = 0;
+            let cutIndex = 0;
+            for (let i = 0; i < line.length; i++) {
+                if (line[i] === '\x1b') {
+                    const end = line.indexOf('m', i);
+                    if (end !== -1) {
+                        i = end;
+                        continue;
+                    }
+                }
+                visibleLen++;
+                if (visibleLen >= max - 3) {
+                    cutIndex = i + 1;
+                    break;
+                }
+            }
+            return line.slice(0, cutIndex) + '...';
+        };
+        // Command name
+        lines.push(chalk.bold(` /${cmd.name}`));
+        lines.push('');
+        // Description
+        lines.push(' ' + s.primary('DESCRIPTION'));
+        lines.push(truncate('   ' + cmd.description));
+        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(truncate(currentLine));
+                    currentLine = '   ' + word;
+                }
+                else {
+                    currentLine += (currentLine.length > 3 ? ' ' : '') + word;
+                }
+            }
+            if (currentLine.length > 3) {
+                lines.push(truncate(currentLine));
+            }
+            lines.push('');
+        }
+        // Aliases
+        if (cmd.aliases && cmd.aliases.length > 0) {
+            lines.push(' ' + s.primary('ALIASES'));
+            lines.push(truncate('   ' + cmd.aliases.map((a) => `/${a}`).join(', ')));
+            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(truncate(exLine));
+                }
+                else {
+                    lines.push(truncate('   ' + s.muted(example.code)));
+                }
+            }
+            lines.push('');
+        }
+        // Interactions
+        if (cmd.interactions && cmd.interactions.length > 0) {
+            lines.push(' ' + s.primary('INTERACTIONS'));
+            for (const hint of cmd.interactions) {
+                lines.push(truncate('   ' + s.muted('• ' + hint)));
+            }
+            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';
+    constructor() {
+        // Build unified items list
+        const items = [];
+        // Add built-in commands
+        const helpCommands = getHelpCommands();
+        for (let i = 0; i < helpCommands.length; i++) {
+            const cmd = helpCommands[i];
+            items.push({
+                name: cmd.name,
+                description: cmd.description,
+                type: 'builtin',
+                commandIndex: i,
+            });
+        }
+        // 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.',
+        });
+    }
+    createDetailScreen(item) {
+        const styles = this.getStyles();
+        if (item.type === 'builtin') {
+            return new CommandDetailScreen(item, styles);
+        }
+        return new CustomCommandDetailScreen(item, styles);
+    }
+}

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

@@ -0,0 +1,77 @@
+/**
+ * Init Overlay V2
+ *
+ * Modal overlay for the /init wizard - creates new projects with structured workflow.
+ * Uses BaseOverlayV2 for TerminalUI integration.
+ *
+ * Steps:
+ *   0. Project type (new vs existing)
+ *   1. Project name
+ *   2. Description
+ *   3. Repo pattern (single vs two-repo)
+ *   4. Tech stack
+ *   5. Coding standards
+ *   6. Initialize git?
+ *   7. Track with project database?
+ *   8. Workflow mode (if tracking enabled)
+ *   9. Confirmation
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../types.js';
+import { type TechStack, type CodingStandards, type RepoPattern } from '../../../templates/index.js';
+type WizardStep = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+type WorkflowMode = 'flexible' | 'guided';
+interface InitState {
+    step: WizardStep;
+    projectType: 'new' | 'existing' | null;
+    projectName: string;
+    description: string;
+    repoPattern: RepoPattern | null;
+    techStack: TechStack | null;
+    codingStandards: CodingStandards | null;
+    initGit: boolean;
+    trackInDatabase: boolean;
+    workflowMode: WorkflowMode;
+    selectedIndex: number;
+    inputBuffer: string;
+    error: string | null;
+    isGenerating: boolean;
+}
+export interface InitResultV2 {
+    created: boolean;
+    projectPath?: string;
+    docsPath?: string;
+    filesCreated?: string[];
+    trackInDatabase?: boolean;
+    workflowMode?: WorkflowMode;
+    projectName?: string;
+    description?: string;
+}
+export declare class InitOverlayV2 extends BaseOverlayV2<InitState, InitResultV2> {
+    readonly type: "inline";
+    readonly id = "init-overlay-v2";
+    constructor();
+    protected renderContent(context: RenderContext): string[];
+    private renderGenerating;
+    private renderStepFooter;
+    private renderSelectionOption;
+    private renderStep0;
+    private renderStep1;
+    private renderStep2;
+    private renderStep3;
+    private renderStep4;
+    private renderStep5;
+    private renderStep6;
+    private renderStep7;
+    private renderStep8;
+    private renderStep9;
+    handleKey(key: KeyEvent): OverlayAction<InitResultV2> | Promise<OverlayAction<InitResultV2>>;
+    private handleSelectionKey;
+    private handleSelectionEnter;
+    private handleInputKey;
+    private nextStep;
+    private prevStep;
+    private validateInput;
+    getCloseSummary(result: InitResultV2): string | null;
+}
+export {};