@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/commands/registry.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Command Registry
+ *
+ * Central registry for command handlers. Commands are registered
+ * at startup and executed by REPL.handleCommand().
+ */
+import type { CommandHandler, CommandContext, CommandResult } from './handler-types.js';
+declare class CommandRegistry {
+    private readonly handlers;
+    /**
+     * Register a command handler.
+     * Registers both the primary name and any aliases.
+     */
+    register(handler: CommandHandler): void;
+    /**
+     * Register multiple handlers at once.
+     */
+    registerAll(handlers: CommandHandler[]): void;
+    /**
+     * Execute a command by name.
+     *
+     * @param command - Command name (without leading slash)
+     * @param args - Arguments string
+     * @param ctx - Command context
+     * @returns true to continue REPL, false to exit, null if not found
+     */
+    execute(command: string, args: string, ctx: CommandContext): Promise<CommandResult>;
+    /**
+     * Check if a command is registered.
+     */
+    has(command: string): boolean;
+    /**
+     * Get a handler by name.
+     */
+    get(command: string): CommandHandler | undefined;
+    /**
+     * Get all unique handlers (no duplicates from aliases).
+     */
+    getAll(): CommandHandler[];
+    /**
+     * Get all registered command names (including aliases).
+     */
+    getCommandNames(): string[];
+}
+/**
+ * Global command registry instance.
+ * Use this to register and execute commands.
+ */
+export declare const commandRegistry: CommandRegistry;
+export {};

package/dist/commands/registry.js

@@ -0,0 +1,75 @@
+/**
+ * Command Registry
+ *
+ * Central registry for command handlers. Commands are registered
+ * at startup and executed by REPL.handleCommand().
+ */
+// =============================================================================
+// Command Registry Class
+// =============================================================================
+class CommandRegistry {
+    handlers = new Map();
+    /**
+     * Register a command handler.
+     * Registers both the primary name and any aliases.
+     */
+    register(handler) {
+        this.handlers.set(handler.name, handler);
+        handler.aliases?.forEach((alias) => this.handlers.set(alias, handler));
+    }
+    /**
+     * Register multiple handlers at once.
+     */
+    registerAll(handlers) {
+        handlers.forEach((h) => {
+            this.register(h);
+        });
+    }
+    /**
+     * Execute a command by name.
+     *
+     * @param command - Command name (without leading slash)
+     * @param args - Arguments string
+     * @param ctx - Command context
+     * @returns true to continue REPL, false to exit, null if not found
+     */
+    async execute(command, args, ctx) {
+        const handler = this.handlers.get(command);
+        if (!handler) {
+            return null; // Not found
+        }
+        return handler.execute(args, ctx);
+    }
+    /**
+     * Check if a command is registered.
+     */
+    has(command) {
+        return this.handlers.has(command);
+    }
+    /**
+     * Get a handler by name.
+     */
+    get(command) {
+        return this.handlers.get(command);
+    }
+    /**
+     * Get all unique handlers (no duplicates from aliases).
+     */
+    getAll() {
+        return [...new Set(this.handlers.values())];
+    }
+    /**
+     * Get all registered command names (including aliases).
+     */
+    getCommandNames() {
+        return [...this.handlers.keys()];
+    }
+}
+// =============================================================================
+// Singleton Export
+// =============================================================================
+/**
+ * Global command registry instance.
+ * Use this to register and execute commands.
+ */
+export const commandRegistry = new CommandRegistry();

package/dist/commands-v2/handlers/context.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context Commands for REPL V2
+ *
+ * Commands for context management: compact, context, tokens, status, todos, export
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const compactCommand: CommandHandlerV2;
+export declare const contextCommand: CommandHandlerV2;
+export declare const tokensCommand: CommandHandlerV2;
+export declare const statusCommand: CommandHandlerV2;
+export declare const todosCommand: CommandHandlerV2;
+export declare const exportCommand: CommandHandlerV2;
+export declare const contextCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/context.js

@@ -0,0 +1,348 @@
+/**
+ * Context Commands for REPL V2
+ *
+ * Commands for context management: compact, context, tokens, status, todos, export
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import pc from 'picocolors';
+// =============================================================================
+// Helper: Progress Bar
+// =============================================================================
+function renderProgressBar(ratio, width) {
+    const clamped = Math.max(0, Math.min(1, ratio));
+    const filled = Math.round(clamped * width);
+    const empty = width - filled;
+    const color = clamped > 0.9 ? pc.red : clamped > 0.7 ? pc.yellow : pc.green;
+    return color('█'.repeat(filled)) + pc.dim('░'.repeat(empty));
+}
+// =============================================================================
+// Compact Command
+// =============================================================================
+export const compactCommand = {
+    name: 'compact',
+    description: 'Summarize old messages to free context',
+    async execute(_args, ctx) {
+        // Check if agent is available
+        if (!ctx.agent) {
+            ctx.ui.print({ type: 'warning', message: 'Agent not available for compaction' });
+            return true;
+        }
+        const contextManager = ctx.getContextManager?.();
+        if (!contextManager) {
+            ctx.ui.print({ type: 'warning', message: 'Context manager not available' });
+            return true;
+        }
+        const history = ctx.getHistory?.() ?? [];
+        if (history.length === 0) {
+            ctx.ui.print({ type: 'info', message: 'No conversation history to compact' });
+            return true;
+        }
+        // Show current stats
+        const stats = contextManager.getStats(history.length);
+        const pct = (stats.utilization * 100).toFixed(1);
+        ctx.ui.print({
+            type: 'info',
+            message: `Current: ${stats.currentTokens.toLocaleString()} tokens (${pct}%), ${String(history.length)} messages`,
+        });
+        // Start compaction (user explicitly requested via /compact)
+        ctx.ui.print({ type: 'info', message: 'Compacting context...' });
+        try {
+            // Use the agent's compact() method
+            const result = (await ctx.agent.compact());
+            if (!result.success) {
+                ctx.ui.print({ type: 'warning', message: 'Compaction not available' });
+                return true;
+            }
+            // Build status message
+            const newHistory = ctx.getHistory?.() ?? [];
+            const statusParts = [];
+            // Token reduction
+            const originalTokens = result.originalTokens ?? 0;
+            const summaryTokens = result.summaryTokens ?? 0;
+            const reduction = originalTokens > 0 ? Math.round((1 - summaryTokens / originalTokens) * 100) : 0;
+            statusParts.push(`Compacted: ${originalTokens.toLocaleString()} → ${summaryTokens.toLocaleString()} tokens (-${String(reduction)}%)`);
+            // Message count
+            statusParts.push(`Messages: ${String(history.length)} → ${String(newHistory.length)} (${String(result.messagesPreserved ?? 0)} preserved)`);
+            // Category actions
+            if (result.categoryStats) {
+                const actions = [];
+                if (result.categoryStats.toolResults.action === 'compacted') {
+                    actions.push('tool results → files');
+                }
+                if (result.categoryStats.history.action === 'summarized') {
+                    actions.push('history → summary');
+                }
+                if (actions.length > 0) {
+                    statusParts.push(`Actions: ${actions.join(', ')}`);
+                }
+            }
+            // Files created
+            if (result.filesCreated && result.filesCreated.length > 0) {
+                statusParts.push(`Files created: ${String(result.filesCreated.length)}`);
+            }
+            // Restoration hints
+            if (result.restorationHintsInjected) {
+                statusParts.push('File tracking hints injected');
+            }
+            // Tool results repaired
+            if (result.toolResultsRepaired && result.toolResultsRepaired > 0) {
+                statusParts.push(`Orphaned tool results removed: ${String(result.toolResultsRepaired)}`);
+            }
+            // Print results
+            for (const part of statusParts) {
+                ctx.ui.print({ type: 'success', message: part });
+            }
+        }
+        catch (error) {
+            ctx.ui.print({ type: 'error', message: `Compaction failed: ${error.message}` });
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Context Command
+// =============================================================================
+export const contextCommand = {
+    name: 'context',
+    description: 'Show context window usage',
+    execute(_args, ctx) {
+        const lines = [];
+        lines.push('');
+        lines.push(pc.bold('Context Usage'));
+        lines.push(pc.dim('─'.repeat(40)));
+        const contextManager = ctx.getContextManager?.();
+        const history = ctx.getHistory?.() ?? [];
+        if (contextManager) {
+            const stats = contextManager.getStats(history.length);
+            const pct = (stats.utilization * 100).toFixed(1);
+            const bar = renderProgressBar(stats.utilization, 20);
+            lines.push(`  Usage:    ${bar} ${pct}%`);
+            lines.push(`  Tokens:   ${pc.cyan(stats.currentTokens.toLocaleString())} / ${pc.dim(stats.maxTokens.toLocaleString())}`);
+            lines.push(`  Messages: ${pc.cyan(String(stats.messageCount))}`);
+            lines.push(`  Turns:    ${pc.cyan(String(stats.turnCount))}`);
+        }
+        else {
+            // Fallback to session tracking
+            const inputTokens = ctx.sessionInputTokens ?? 0;
+            const outputTokens = ctx.sessionOutputTokens ?? 0;
+            const total = inputTokens + outputTokens;
+            const maxTokens = 200000;
+            const utilization = total / maxTokens;
+            const pct = (utilization * 100).toFixed(1);
+            const bar = renderProgressBar(utilization, 20);
+            lines.push(`  Usage:    ${bar} ${pct}%`);
+            lines.push(`  Tokens:   ${pc.cyan(total.toLocaleString())} / ${pc.dim(maxTokens.toLocaleString())}`);
+            lines.push(`  Input:    ${pc.cyan(inputTokens.toLocaleString())}`);
+            lines.push(`  Output:   ${pc.cyan(outputTokens.toLocaleString())}`);
+            lines.push(`  Messages: ${pc.cyan(String(history.length))}`);
+        }
+        lines.push('');
+        ctx.ui.print({ type: 'raw-lines', lines });
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Tokens Command
+// =============================================================================
+export const tokensCommand = {
+    name: 'tokens',
+    description: 'Show token usage',
+    execute(_args, ctx) {
+        const lines = [];
+        lines.push('');
+        lines.push(pc.bold('Token Usage'));
+        lines.push(pc.dim('─'.repeat(40)));
+        const inputTokens = ctx.sessionInputTokens ?? 0;
+        const outputTokens = ctx.sessionOutputTokens ?? 0;
+        const total = inputTokens + outputTokens;
+        lines.push(`  Input:    ${pc.cyan(inputTokens.toLocaleString())} tokens`);
+        lines.push(`  Output:   ${pc.cyan(outputTokens.toLocaleString())} tokens`);
+        lines.push(pc.dim('  ─'.repeat(20)));
+        lines.push(`  Total:    ${pc.bold(pc.cyan(total.toLocaleString()))} tokens`);
+        lines.push('');
+        ctx.ui.print({ type: 'raw-lines', lines });
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Status Command
+// =============================================================================
+export const statusCommand = {
+    name: 'status',
+    description: 'Show session status',
+    execute(_args, ctx) {
+        const lines = [];
+        lines.push('');
+        lines.push(pc.bold('Status'));
+        lines.push(pc.dim('─'.repeat(40)));
+        lines.push(`  Version:  ${pc.cyan(ctx.version)}`);
+        lines.push(`  Model:    ${pc.cyan(ctx.model ?? 'not set')}`);
+        lines.push(`  Provider: ${pc.cyan(ctx.provider ?? 'not set')}`);
+        const contextManager = ctx.getContextManager?.();
+        const history = ctx.getHistory?.() ?? [];
+        if (contextManager) {
+            const stats = contextManager.getStats(history.length);
+            const pct = (stats.utilization * 100).toFixed(1);
+            const bar = renderProgressBar(stats.utilization, 20);
+            lines.push(`  Context:  ${bar} ${pct}%`);
+            lines.push(`  Messages: ${pc.cyan(String(stats.messageCount))}`);
+        }
+        else {
+            const inputTokens = ctx.sessionInputTokens ?? 0;
+            const outputTokens = ctx.sessionOutputTokens ?? 0;
+            const total = inputTokens + outputTokens;
+            lines.push(`  Tokens:   ${pc.cyan(total.toLocaleString())}`);
+            lines.push(`  Messages: ${pc.cyan(String(history.length))}`);
+        }
+        lines.push(`  Requests: ${pc.cyan(String(ctx.sessionRequests ?? 0))}`);
+        lines.push('');
+        ctx.ui.print({ type: 'raw-lines', lines });
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Todos Command
+// =============================================================================
+export const todosCommand = {
+    name: 'todos',
+    description: 'Show current todo list',
+    execute(_args, ctx) {
+        const todos = ctx.ui.getTodos();
+        const lines = [];
+        lines.push('');
+        if (todos.length === 0) {
+            lines.push(pc.dim('No todos. The agent will create todos when working on tasks.'));
+            lines.push('');
+            ctx.ui.print({ type: 'raw-lines', lines });
+            return Promise.resolve(true);
+        }
+        lines.push(pc.bold('Todos'));
+        lines.push(pc.dim('─'.repeat(40)));
+        for (const todo of todos) {
+            let icon;
+            let style;
+            switch (todo.status) {
+                case 'completed':
+                    icon = pc.green('✓');
+                    style = pc.strikethrough;
+                    break;
+                case 'in_progress':
+                    icon = pc.yellow('●');
+                    style = pc.bold;
+                    break;
+                default:
+                    icon = pc.dim('○');
+                    style = (s) => s;
+            }
+            lines.push(`  ${icon} ${style(todo.content)}`);
+        }
+        lines.push('');
+        ctx.ui.print({ type: 'raw-lines', lines });
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Export Command
+// =============================================================================
+export const exportCommand = {
+    name: 'export',
+    description: 'Export conversation to file',
+    execute(args, ctx) {
+        const history = ctx.getHistory?.() ?? [];
+        if (history.length === 0) {
+            ctx.ui.print({ type: 'warning', message: 'No conversation to export' });
+            return Promise.resolve(true);
+        }
+        // Format conversation as markdown
+        const markdown = formatConversationAsMarkdown(history, ctx.model ?? 'unknown');
+        // Determine filename
+        let filename;
+        if (args.trim()) {
+            filename = args.trim();
+        }
+        else {
+            // Default: conversation-YYYY-MM-DD-HHMMSS.md
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+            filename = `conversation-${timestamp}.md`;
+        }
+        const filepath = path.isAbsolute(filename) ? filename : path.join(process.cwd(), filename);
+        try {
+            fs.writeFileSync(filepath, markdown, 'utf-8');
+            ctx.ui.print({ type: 'success', message: `Exported ${String(history.length)} messages to ${filepath}` });
+        }
+        catch (error) {
+            ctx.ui.print({ type: 'error', message: `Failed to export: ${error.message}` });
+        }
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Helper: Format Conversation as Markdown
+// =============================================================================
+function formatConversationAsMarkdown(history, model) {
+    const lines = [];
+    const timestamp = new Date().toISOString().split('T')[0];
+    lines.push(`# Conversation Export`);
+    lines.push('');
+    lines.push(`**Model:** ${model}`);
+    lines.push(`**Date:** ${timestamp}`);
+    lines.push(`**Messages:** ${String(history.length)}`);
+    lines.push('');
+    lines.push('---');
+    lines.push('');
+    for (const msg of history) {
+        const role = msg.role === 'user' ? '👤 User' : '🤖 Assistant';
+        lines.push(`## ${role}`);
+        lines.push('');
+        if (typeof msg.content === 'string') {
+            lines.push(msg.content);
+        }
+        else if (Array.isArray(msg.content)) {
+            // Handle content blocks (tool calls, etc.)
+            for (const block of msg.content) {
+                if (typeof block === 'object' && block !== null) {
+                    const b = block;
+                    if (b.type === 'text' && typeof b.text === 'string') {
+                        lines.push(b.text);
+                    }
+                    else if (b.type === 'tool_use') {
+                        const toolName = typeof b.name === 'string' ? b.name : String(b.name);
+                        lines.push(`**Tool:** \`${toolName}\``);
+                        if (b.input) {
+                            lines.push('```json');
+                            lines.push(JSON.stringify(b.input, null, 2));
+                            lines.push('```');
+                        }
+                    }
+                    else if (b.type === 'tool_result') {
+                        lines.push(`**Tool Result:**`);
+                        if (typeof b.content === 'string') {
+                            lines.push('```');
+                            lines.push(b.content.slice(0, 500) + (b.content.length > 500 ? '...' : ''));
+                            lines.push('```');
+                        }
+                    }
+                }
+            }
+        }
+        else if (msg.content !== null && typeof msg.content === 'object') {
+            lines.push('```json');
+            lines.push(JSON.stringify(msg.content, null, 2));
+            lines.push('```');
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// =============================================================================
+// Export All Context Commands
+// =============================================================================
+export const contextCommands = [
+    compactCommand,
+    contextCommand,
+    tokensCommand,
+    statusCommand,
+    todosCommand,
+    exportCommand,
+];

package/dist/commands-v2/handlers/core.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Core Commands for REPL V2
+ *
+ * Essential commands: exit, clear, help
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const exitCommand: CommandHandlerV2;
+export declare const clearCommand: CommandHandlerV2;
+export declare const helpCommand: CommandHandlerV2;
+export declare const tutorialCommand: CommandHandlerV2;
+export declare const commandsCommand: CommandHandlerV2;
+export declare const menuCommand: CommandHandlerV2;
+export declare const coreCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/core.js

@@ -0,0 +1,165 @@
+/**
+ * Core Commands for REPL V2
+ *
+ * Essential commands: exit, clear, help
+ */
+import { HelpOverlayV2, TutorialOverlayV2, CommandsOverlayV2, DashboardOverlayV2, } from '../../ui/overlay/index.js';
+import { executeCommand } from '../registry.js';
+import { projectRepository } from '../../db/repositories/index.js';
+import { setCurrentProject } from '../../tools/project-db.js';
+// =============================================================================
+// Exit Command
+// =============================================================================
+export const exitCommand = {
+    name: 'exit',
+    aliases: ['quit', 'q'],
+    description: 'Exit the REPL',
+    execute(_args, ctx) {
+        ctx.ui.stop();
+        console.log('\nGoodbye!\n');
+        return Promise.resolve(false);
+    },
+};
+// =============================================================================
+// Clear Command
+// =============================================================================
+export const clearCommand = {
+    name: 'clear',
+    aliases: ['cls'],
+    description: 'Clear the screen',
+    execute(_args, ctx) {
+        ctx.printWelcome();
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Help Command
+// =============================================================================
+export const helpCommand = {
+    name: 'help',
+    aliases: ['h', '?'],
+    description: 'Show available commands',
+    async execute(_args, ctx) {
+        const helpOverlay = new HelpOverlayV2();
+        await ctx.ui.showOverlay(helpOverlay);
+        return true;
+    },
+};
+// =============================================================================
+// Tutorial Command
+// =============================================================================
+export const tutorialCommand = {
+    name: 'tutorial',
+    description: 'Interactive workflow tutorial',
+    async execute(_args, ctx) {
+        const tutorialOverlay = new TutorialOverlayV2();
+        const result = await ctx.ui.showOverlay(tutorialOverlay);
+        if (result?.completed) {
+            ctx.ui.print({ type: 'success', message: 'Tutorial completed!' });
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Commands Command
+// =============================================================================
+export const commandsCommand = {
+    name: 'commands',
+    description: 'Manage custom commands',
+    async execute(_args, ctx) {
+        const commandsOverlay = new CommandsOverlayV2();
+        const result = await ctx.ui.showOverlay(commandsOverlay);
+        if (result?.created) {
+            ctx.ui.print({ type: 'success', message: `Created command: /${result.created}` });
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Menu Command - Returns to Project Dashboard
+// =============================================================================
+export const menuCommand = {
+    name: 'menu',
+    description: 'Return to the Project Dashboard',
+    async execute(_args, ctx) {
+        // Print logo to scrolling area (stays visible while overlays render below)
+        ctx.printLogo();
+        // Dashboard loop - returns to dashboard after sub-commands until user exits or continues
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        while (true) {
+            const dashboard = new DashboardOverlayV2();
+            const result = await ctx.ui.showOverlay(dashboard);
+            if (!result) {
+                return true;
+            }
+            // Handle dashboard result actions
+            switch (result.action) {
+                case 'exit':
+                    ctx.ui.stop();
+                    console.log('\nGoodbye!\n');
+                    return false;
+                case 'continue':
+                    // Switch to selected project if different from current
+                    if (result.projectId) {
+                        const project = projectRepository.getById(result.projectId);
+                        if (project) {
+                            setCurrentProject({
+                                id: project.id,
+                                name: project.name,
+                                displayName: project.displayName,
+                                path: project.path,
+                            });
+                            ctx.ui.setProjectName(project.displayName);
+                            ctx.ui.print({ type: 'success', message: `Switched to project: ${project.displayName}` });
+                        }
+                    }
+                    return true; // Exit loop, return to REPL
+                case 'chat':
+                    // Clear current project for quick chat mode
+                    setCurrentProject(null);
+                    ctx.ui.setProjectName(null);
+                    ctx.ui.print({ type: 'warning', message: 'Quick Chat mode - no project context. Use /menu to select a project.' });
+                    return true; // Exit loop, return to REPL
+                case 'new':
+                    await executeCommand('new', '', ctx);
+                    // Loop back to dashboard after /new completes
+                    break;
+                case 'projects':
+                    await executeCommand('projects', '', ctx);
+                    // Loop back to dashboard after /projects completes
+                    break;
+                case 'workflow':
+                    await executeCommand('workflow', '', ctx);
+                    // Loop back to dashboard after /workflow completes
+                    break;
+                case 'help':
+                    await executeCommand('help', '', ctx);
+                    // Loop back to dashboard after /help closes
+                    break;
+                case 'config':
+                    await executeCommand('config', '', ctx);
+                    // Loop back to dashboard after /config closes
+                    break;
+                case 'about':
+                    ctx.ui.print({ type: 'info', message: '@compilr-dev/cli v0.4.0' });
+                    ctx.ui.print({ type: 'info', message: 'AI-powered coding assistant using @compilr-dev/agents' });
+                    ctx.ui.print({ type: 'info', message: 'https://github.com/compilr-dev/cli' });
+                    // Loop back to dashboard after showing about info
+                    break;
+                default:
+                    return true;
+            }
+        }
+    },
+};
+// =============================================================================
+// Export All Core Commands
+// =============================================================================
+export const coreCommands = [
+    exitCommand,
+    clearCommand,
+    helpCommand,
+    tutorialCommand,
+    commandsCommand,
+    menuCommand,
+];

package/dist/commands-v2/handlers/debug.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Debug Commands for REPL V2
+ *
+ * Commands for testing and debugging: todos, suggest, bash, subagent
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const sampleTodosCommand: CommandHandlerV2;
+export declare const suggestCommand: CommandHandlerV2;
+export declare const bashCommand: CommandHandlerV2;
+export declare const subagentCommand: CommandHandlerV2;
+export declare const debugCommands: CommandHandlerV2[];