@compilr-dev/cli 0.4.0

package/dist/state.d.ts

@@ -0,0 +1,75 @@
+/**
+ * REPL State
+ *
+ * Central state management for the REPL.
+ * Components read from this state but don't own it.
+ */
+import type { ConversationMessage, TodoItem, SpinnerState, REPLState } from './ui/types.js';
+/**
+ * Create initial REPL state
+ */
+export declare function createInitialState(model: string): REPLState;
+/**
+ * Update todos
+ */
+export declare function updateTodos(state: REPLState, todos: TodoItem[]): void;
+/**
+ * Add a pending message (queued while agent works)
+ */
+export declare function addPendingMessage(state: REPLState, message: string): void;
+/**
+ * Get and clear pending messages
+ */
+export declare function clearPendingMessages(state: REPLState): string[];
+/**
+ * Add message to conversation history
+ */
+export declare function addToHistory(state: REPLState, message: ConversationMessage): void;
+/**
+ * Clear conversation history
+ */
+export declare function clearHistory(state: REPLState): void;
+/**
+ * Set spinner state
+ */
+export declare function setSpinner(state: REPLState, spinner: SpinnerState | null): void;
+/**
+ * Set agent running state
+ */
+export declare function setAgentRunning(state: REPLState, running: boolean): void;
+/**
+ * Add to input history
+ */
+export declare function addToInputHistory(state: REPLState, input: string): void;
+/**
+ * Add tool to always-allowed set
+ */
+export declare function allowTool(state: REPLState, toolName: string): void;
+/**
+ * Check if tool is always allowed
+ */
+export declare function isToolAllowed(state: REPLState, toolName: string): boolean;
+/**
+ * Reset allowed tools
+ */
+export declare function resetAllowedTools(state: REPLState): void;
+/**
+ * Get active todo (in_progress)
+ */
+export declare function getActiveTodo(state: REPLState): TodoItem | undefined;
+/**
+ * Get completed todos count
+ */
+export declare function getCompletedCount(state: REPLState): number;
+/**
+ * Get pending todos count
+ */
+export declare function getPendingCount(state: REPLState): number;
+/**
+ * Get total message count
+ */
+export declare function getMessageCount(state: REPLState): number;
+/**
+ * Get turn count (user message + assistant response pairs)
+ */
+export declare function getTurnCount(state: REPLState): number;

package/dist/state.js

@@ -0,0 +1,130 @@
+/**
+ * REPL State
+ *
+ * Central state management for the REPL.
+ * Components read from this state but don't own it.
+ */
+// =============================================================================
+// State Creation
+// =============================================================================
+/**
+ * Create initial REPL state
+ */
+export function createInitialState(model) {
+    return {
+        conversationHistory: [],
+        spinner: null,
+        todos: [],
+        pendingMessages: [],
+        isAgentRunning: false,
+        currentModel: model,
+        inputHistory: [],
+        allowedTools: new Set(),
+    };
+}
+// =============================================================================
+// State Update Helpers
+// =============================================================================
+/**
+ * Update todos
+ */
+export function updateTodos(state, todos) {
+    state.todos = todos;
+}
+/**
+ * Add a pending message (queued while agent works)
+ */
+export function addPendingMessage(state, message) {
+    state.pendingMessages.push(message);
+}
+/**
+ * Get and clear pending messages
+ */
+export function clearPendingMessages(state) {
+    const messages = [...state.pendingMessages];
+    state.pendingMessages = [];
+    return messages;
+}
+/**
+ * Add message to conversation history
+ */
+export function addToHistory(state, message) {
+    state.conversationHistory.push(message);
+}
+/**
+ * Clear conversation history
+ */
+export function clearHistory(state) {
+    state.conversationHistory = [];
+}
+/**
+ * Set spinner state
+ */
+export function setSpinner(state, spinner) {
+    state.spinner = spinner;
+}
+/**
+ * Set agent running state
+ */
+export function setAgentRunning(state, running) {
+    state.isAgentRunning = running;
+}
+/**
+ * Add to input history
+ */
+export function addToInputHistory(state, input) {
+    if (input.trim() && (state.inputHistory.length === 0 || state.inputHistory[state.inputHistory.length - 1] !== input)) {
+        state.inputHistory.push(input);
+    }
+}
+/**
+ * Add tool to always-allowed set
+ */
+export function allowTool(state, toolName) {
+    state.allowedTools.add(toolName);
+}
+/**
+ * Check if tool is always allowed
+ */
+export function isToolAllowed(state, toolName) {
+    return state.allowedTools.has(toolName);
+}
+/**
+ * Reset allowed tools
+ */
+export function resetAllowedTools(state) {
+    state.allowedTools.clear();
+}
+// =============================================================================
+// Computed Values
+// =============================================================================
+/**
+ * Get active todo (in_progress)
+ */
+export function getActiveTodo(state) {
+    return state.todos.find((t) => t.status === 'in_progress');
+}
+/**
+ * Get completed todos count
+ */
+export function getCompletedCount(state) {
+    return state.todos.filter((t) => t.status === 'completed').length;
+}
+/**
+ * Get pending todos count
+ */
+export function getPendingCount(state) {
+    return state.todos.filter((t) => t.status === 'pending').length;
+}
+/**
+ * Get total message count
+ */
+export function getMessageCount(state) {
+    return state.conversationHistory.length;
+}
+/**
+ * Get turn count (user message + assistant response pairs)
+ */
+export function getTurnCount(state) {
+    return Math.floor(state.conversationHistory.filter((m) => m.type === 'user').length);
+}

package/dist/tabbed-menu.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tabbed Help Menu
+ *
+ * Claude Code-style tabbed help menu with keyboard navigation.
+ * Uses alternate screen buffer to preserve terminal history.
+ */
+/**
+ * Show the tabbed help menu (in-place, not full screen)
+ * Returns a promise that resolves when the menu is closed
+ */
+export declare function showHelpMenu(): Promise<void>;

package/dist/tabbed-menu.js

@@ -0,0 +1,328 @@
+/**
+ * Tabbed Help Menu
+ *
+ * Claude Code-style tabbed help menu with keyboard navigation.
+ * Uses alternate screen buffer to preserve terminal history.
+ */
+import pc from 'picocolors';
+import { getCustomCommandRegistry } from './commands/index.js';
+// ANSI escape codes
+const ANSI = {
+    HIDE_CURSOR: '\x1B[?25l',
+    SHOW_CURSOR: '\x1B[?25h',
+    CLEAR_LINE: '\x1B[2K',
+    CLEAR_TO_END: '\x1B[J',
+    SAVE_CURSOR: '\x1B[s',
+    RESTORE_CURSOR: '\x1B[u',
+    MOVE_UP: (n) => `\x1B[${String(n)}A`,
+};
+// Version display
+const VERSION = 'compilr.dev/agent';
+const TABS = [
+    { id: 'general', label: 'general' },
+    { id: 'commands', label: 'commands' },
+    { id: 'custom-commands', label: 'custom-commands' },
+];
+const COMMANDS = [
+    { name: '/help', description: 'Show this help menu' },
+    { name: '/exit', description: 'Exit the REPL' },
+    { name: '/clear', description: 'Clear conversation history' },
+    { name: '/compact', description: 'Summarize old messages to free context' },
+    { name: '/tools', description: 'List available tools' },
+    { name: '/tokens', description: 'Show session token usage' },
+    { name: '/context', description: 'Visualize current context usage' },
+    { name: '/model', description: 'Show or change the current model' },
+    { name: '/provider', description: 'Show or change the LLM provider' },
+    { name: '/history', description: 'Show conversation history' },
+    { name: '/save', description: 'Save conversation to file' },
+    { name: '/load', description: 'Load conversation from file' },
+    { name: '/reset', description: 'Reset agent state' },
+    { name: '/verbose', description: 'Toggle verbose output mode' },
+    { name: '/debug', description: 'Toggle debug mode' },
+];
+const VISIBLE_COMMANDS = 10;
+/**
+ * Get terminal dimensions
+ */
+function getTerminalSize() {
+    return {
+        rows: process.stdout.rows || 24,
+        cols: process.stdout.columns || 80,
+    };
+}
+/**
+ * Render the header with version and tabs
+ */
+function renderHeader(state) {
+    const lines = [];
+    const { cols } = getTerminalSize();
+    // Separator line (cols - 1 to avoid terminal wrapping issues)
+    lines.push(pc.dim('─'.repeat(Math.max(1, cols - 1))));
+    // Version + tabs line
+    let tabLine = ' ' + pc.bold(pc.cyan(VERSION)) + '  ';
+    for (let i = 0; i < TABS.length; i++) {
+        const tab = TABS[i];
+        if (i === state.currentTab) {
+            tabLine += pc.bgBlue(pc.white(` ${tab.label} `)) + '  ';
+        }
+        else {
+            tabLine += pc.dim(` ${tab.label} `) + '  ';
+        }
+    }
+    tabLine += pc.dim('(tab to cycle)');
+    lines.push(tabLine);
+    lines.push('');
+    return lines;
+}
+/**
+ * Render the General tab content
+ */
+function renderGeneralTab() {
+    const lines = [];
+    lines.push(' An AI assistant that understands your codebase, makes edits with your permission, and executes commands — right from your terminal.');
+    lines.push('');
+    lines.push(pc.bold(' Shortcuts'));
+    const shortcuts = [
+        ['/ for commands', 'Enter to submit'],
+        ['↑↓ for history', 'Esc to cancel'],
+        ['Tab to autocomplete', 'Ctrl+C to exit'],
+    ];
+    for (const [left, right] of shortcuts) {
+        lines.push(' ' + pc.cyan(left.padEnd(25)) + pc.cyan(right));
+    }
+    lines.push('');
+    lines.push(pc.bold(' Features'));
+    lines.push(' ' + pc.dim('• Multi-LLM support (Claude, OpenAI, Gemini, Ollama)'));
+    lines.push(' ' + pc.dim('• Tool execution with permission prompts'));
+    lines.push(' ' + pc.dim('• Context management and compaction'));
+    lines.push(' ' + pc.dim('• Slash command autocomplete'));
+    return lines;
+}
+/**
+ * Render the Commands tab content
+ */
+function renderCommandsTab(state) {
+    const lines = [];
+    lines.push(pc.bold(' Browse available commands:'));
+    lines.push('');
+    const visibleCommands = COMMANDS.slice(state.scrollOffset, state.scrollOffset + VISIBLE_COMMANDS);
+    if (state.scrollOffset > 0) {
+        lines.push(pc.dim(' ↑'));
+    }
+    else {
+        lines.push('');
+    }
+    for (let i = 0; i < visibleCommands.length; i++) {
+        const cmd = visibleCommands[i];
+        const globalIndex = state.scrollOffset + i;
+        const isSelected = globalIndex === state.selectedCommand;
+        const prefix = isSelected ? pc.cyan(' ❯ ') : '   ';
+        const name = isSelected
+            ? pc.cyan(cmd.name.padEnd(20))
+            : pc.dim(cmd.name.padEnd(20));
+        const desc = pc.dim(cmd.description);
+        lines.push(prefix + name + desc);
+    }
+    if (state.scrollOffset + VISIBLE_COMMANDS < COMMANDS.length) {
+        lines.push(pc.dim(' ↓'));
+    }
+    else {
+        lines.push('');
+    }
+    return lines;
+}
+/**
+ * Render the Custom Commands tab content
+ */
+function renderCustomCommandsTab() {
+    const lines = [];
+    const registry = getCustomCommandRegistry();
+    const commands = registry.getAll();
+    lines.push(pc.bold(' Custom commands:'));
+    lines.push('');
+    if (commands.length === 0) {
+        lines.push(pc.dim(' No custom commands found'));
+        lines.push('');
+        lines.push(pc.dim(' Create commands with /commands'));
+        lines.push(pc.dim(' or add .md files to:'));
+        lines.push(pc.dim(`   ${registry.getProjectDir()}/`));
+        lines.push(pc.dim(`   ${registry.getUserDir()}/`));
+    }
+    else {
+        for (const cmd of commands) {
+            const name = `/${cmd.name}`.padEnd(20);
+            const desc = cmd.description.slice(0, 40) + (cmd.description.length > 40 ? '...' : '');
+            const location = ` (${cmd.location})`;
+            lines.push(' ' + pc.cyan(name) + pc.dim(desc) + pc.dim(location));
+        }
+        lines.push('');
+        lines.push(pc.dim(' Use /commands to manage custom commands'));
+    }
+    return lines;
+}
+/**
+ * Render the footer
+ */
+function renderFooter() {
+    const lines = [];
+    lines.push('');
+    lines.push(pc.dim(' For more help: https://github.com/scozzola/compilr-dev-cli'));
+    lines.push('');
+    lines.push(pc.dim(' Esc to exit'));
+    return lines;
+}
+/**
+ * Build all lines for current state
+ */
+function buildLines(state) {
+    const allLines = [];
+    allLines.push(...renderHeader(state));
+    switch (TABS[state.currentTab].id) {
+        case 'general':
+            allLines.push(...renderGeneralTab());
+            break;
+        case 'commands':
+            allLines.push(...renderCommandsTab(state));
+            break;
+        case 'custom-commands':
+            allLines.push(...renderCustomCommandsTab());
+            break;
+    }
+    allLines.push(...renderFooter());
+    return allLines;
+}
+/**
+ * Render the menu in-place (not full screen)
+ * Returns the number of lines rendered
+ */
+function render(state, prevLineCount) {
+    const lines = buildLines(state);
+    // Clear previous render
+    if (prevLineCount > 0) {
+        // Move to column 1, move up to first line, clear everything below
+        process.stdout.write('\r');
+        if (prevLineCount > 1) {
+            process.stdout.write(ANSI.MOVE_UP(prevLineCount - 1));
+        }
+        process.stdout.write(ANSI.CLEAR_TO_END);
+    }
+    // Render new content
+    process.stdout.write(lines.join('\n'));
+    return lines.length;
+}
+/**
+ * Handle keypress
+ * Returns { shouldContinue, lineCount } - lineCount is updated if re-render happened
+ */
+function handleKey(data, state, lineCount) {
+    const isEscape = data.length === 1 && data[0] === 0x1b;
+    const isTab = data.length === 1 && data[0] === 0x09;
+    const isUpArrow = data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x41;
+    const isDownArrow = data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x42;
+    const isCtrlC = data.length === 1 && data[0] === 0x03;
+    const isEnter = data.length === 1 && (data[0] === 0x0d || data[0] === 0x0a);
+    // Escape or Ctrl+C - exit
+    if (isEscape || isCtrlC) {
+        return { shouldContinue: false, lineCount };
+    }
+    // Enter on commands tab - could execute command (for now just exit)
+    if (isEnter && TABS[state.currentTab].id === 'commands') {
+        return { shouldContinue: false, lineCount };
+    }
+    // Tab - cycle tabs
+    if (isTab) {
+        state.currentTab = (state.currentTab + 1) % TABS.length;
+        if (TABS[state.currentTab].id === 'commands') {
+            state.selectedCommand = 0;
+            state.scrollOffset = 0;
+        }
+        const newLineCount = render(state, lineCount);
+        return { shouldContinue: true, lineCount: newLineCount };
+    }
+    // Arrow keys only work in commands tab
+    if (TABS[state.currentTab].id === 'commands') {
+        if (isUpArrow) {
+            if (state.selectedCommand > 0) {
+                state.selectedCommand--;
+                if (state.selectedCommand < state.scrollOffset) {
+                    state.scrollOffset = state.selectedCommand;
+                }
+                const newLineCount = render(state, lineCount);
+                return { shouldContinue: true, lineCount: newLineCount };
+            }
+            return { shouldContinue: true, lineCount };
+        }
+        if (isDownArrow) {
+            if (state.selectedCommand < COMMANDS.length - 1) {
+                state.selectedCommand++;
+                if (state.selectedCommand >= state.scrollOffset + VISIBLE_COMMANDS) {
+                    state.scrollOffset = state.selectedCommand - VISIBLE_COMMANDS + 1;
+                }
+                const newLineCount = render(state, lineCount);
+                return { shouldContinue: true, lineCount: newLineCount };
+            }
+            return { shouldContinue: true, lineCount };
+        }
+    }
+    return { shouldContinue: true, lineCount };
+}
+/**
+ * Show the tabbed help menu (in-place, not full screen)
+ * Returns a promise that resolves when the menu is closed
+ */
+export function showHelpMenu() {
+    return new Promise((resolve) => {
+        const state = {
+            currentTab: 0,
+            selectedCommand: 0,
+            scrollOffset: 0,
+        };
+        // Track rendered lines for cleanup
+        let lineCount = 0;
+        // Start on a new line (menu appears below the prompt)
+        process.stdout.write('\n');
+        // Hide cursor during menu display
+        process.stdout.write(ANSI.HIDE_CURSOR);
+        // Store original raw mode state
+        const wasRawMode = process.stdin.isRaw;
+        // Enable raw mode
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+        }
+        process.stdin.resume();
+        // Initial render
+        lineCount = render(state, 0);
+        const cleanup = () => {
+            // Clear the menu by moving up and clearing to end
+            // lineCount lines with lineCount-1 newlines between them, plus the initial \n we added
+            // So cursor is (lineCount-1)+1 = lineCount lines below where "You: /help" ended
+            if (lineCount > 0) {
+                process.stdout.write(ANSI.MOVE_UP(lineCount));
+                process.stdout.write(ANSI.CLEAR_TO_END);
+            }
+            // Print newline so next prompt appears on fresh line
+            process.stdout.write('\n');
+            // Show cursor
+            process.stdout.write(ANSI.SHOW_CURSOR);
+            // Restore raw mode to original state
+            if (process.stdin.isTTY && !wasRawMode) {
+                process.stdin.setRawMode(false);
+            }
+            process.stdin.removeListener('data', onData);
+            process.stdout.removeListener('resize', onResize);
+        };
+        const onData = (data) => {
+            const result = handleKey(data, state, lineCount);
+            lineCount = result.lineCount;
+            if (!result.shouldContinue) {
+                cleanup();
+                resolve();
+            }
+        };
+        const onResize = () => {
+            lineCount = render(state, lineCount);
+        };
+        process.stdin.on('data', onData);
+        process.stdout.on('resize', onResize);
+    });
+}

package/dist/templates/backlog-md.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Backlog Template Generator
+ *
+ * Generates the task tracking file.
+ */
+import type { ProjectConfig } from './types.js';
+export declare function generateBacklogMd(config: ProjectConfig): string;

package/dist/templates/backlog-md.js

@@ -0,0 +1,94 @@
+/**
+ * Backlog Template Generator
+ *
+ * Generates the task tracking file.
+ */
+export function generateBacklogMd(config) {
+    return `# Backlog - ${config.name}
+
+**Last Updated:** ${new Date().toISOString().split('T')[0]}
+**Status Legend:** ✅ Completed | 🚧 In Progress | 📋 Planned | 🔮 Future
+
+---
+
+## 🎯 Current Sprint
+
+*Add your first tasks here*
+
+### Phase 1: Setup & Foundation
+
+| # | Task | Status | Notes |
+|---|------|--------|-------|
+| 1 | Project scaffolding | ✅ | Created by \`compilr init\` |
+| 2 | Development environment setup | 📋 | |
+| 3 | CI/CD pipeline | 📋 | |
+
+---
+
+## 📋 Backlog
+
+### Phase 2: Core Features
+
+| # | Task | Status | Notes |
+|---|------|--------|-------|
+| 4 | *Define your first feature* | 📋 | |
+| 5 | | 📋 | |
+| 6 | | 📋 | |
+
+### Phase 3: Polish & Launch
+
+| # | Task | Status | Notes |
+|---|------|--------|-------|
+| 7 | Testing | 📋 | |
+| 8 | Documentation | 📋 | |
+| 9 | Deploy to production | 📋 | |
+
+---
+
+## 🔮 Future Ideas
+
+*Capture ideas for future development*
+
+-
+-
+-
+
+---
+
+## 📊 Progress Summary
+
+| Phase | Total | Done | Progress |
+|-------|-------|------|----------|
+| Phase 1 | 3 | 1 | 33% |
+| Phase 2 | 0 | 0 | 0% |
+| Phase 3 | 0 | 0 | 0% |
+
+---
+
+## Usage
+
+### Adding Tasks
+
+Add tasks to the appropriate phase table:
+\`\`\`markdown
+| 10 | New task description | 📋 | Optional notes |
+\`\`\`
+
+### Updating Status
+
+Change the status emoji:
+- 📋 → 🚧 when starting work
+- 🚧 → ✅ when completed
+
+### Session Integration
+
+Run \`compilr save\` at the end of each session to:
+- Auto-update task statuses
+- Generate session notes
+- Track progress over time
+
+---
+
+*This backlog is a living document. Reprioritize freely as requirements evolve.*
+`;
+}

package/dist/templates/claude-md.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLAUDE.md Template Generator
+ *
+ * Generates the AI assistant context file.
+ */
+import type { ProjectConfig } from './types.js';
+export declare function generateClaudeMd(config: ProjectConfig): string;