@compilr-dev/cli 0.4.0 → 0.5.1

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

@@ -0,0 +1,290 @@
+/**
+ * Core Commands for REPL V2
+ *
+ * Essential commands: exit, clear, help
+ */
+import { HelpOverlayV2, TutorialOverlayV2, CommandsOverlayV2, DashboardOverlayV2, ChangelogOverlayV2, } from '../../ui/overlay/index.js';
+import { executeCommand, getHelpCommands, getCommand } from '../registry.js';
+import { projectRepository } from '../../db/repositories/index.js';
+import { setCurrentProject } from '../../tools/project-db.js';
+import { getStyles } from '../../themes/index.js';
+import { getCurrentProjectIdForTracking, handleProjectSwitch, convertMessagesToItems } from './session.js';
+// =============================================================================
+// Exit Command
+// =============================================================================
+export const exitCommand = {
+    name: 'exit',
+    aliases: ['quit', 'q'],
+    description: 'Exit the REPL',
+    details: 'Exits the CLI. Your conversation is not saved unless you export it first.',
+    examples: [
+        { code: '/exit' },
+        { code: '/quit', description: 'Alias' },
+        { code: '/q', description: 'Short alias' },
+    ],
+    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',
+    details: 'Clears the terminal screen. Does not affect conversation history or context.',
+    examples: [{ code: '/clear' }],
+    async execute(_args, ctx) {
+        // Pause footer render loop so console.log() in printWelcome doesn't
+        // race with footer positioning (causes hints to land below the footer)
+        ctx.ui.pauseAnimation();
+        await ctx.printWelcome();
+        ctx.ui.resumeAnimation();
+        return true;
+    },
+};
+// =============================================================================
+// Help Command
+// =============================================================================
+export const helpCommand = {
+    name: 'help',
+    aliases: ['h', '?'],
+    description: 'Show available commands',
+    details: 'Opens the help overlay with tabs for general info, commands list, and custom commands.',
+    examples: [
+        { code: '/help' },
+        { code: '/?', description: 'Short alias' },
+    ],
+    interactions: [
+        'Tab cycles: All → Built-in → Custom',
+        '↑/↓ to navigate command list',
+        'Enter to view command details',
+        'Esc to go back or close',
+    ],
+    async execute(_args, ctx) {
+        const helpOverlay = new HelpOverlayV2({ getHelpCommands, getCommand });
+        await ctx.ui.showOverlay(helpOverlay);
+        return true;
+    },
+};
+// =============================================================================
+// Tutorial Command
+// =============================================================================
+export const tutorialCommand = {
+    name: 'tutorial',
+    description: 'Interactive workflow tutorial',
+    details: 'Opens a comprehensive tutorial covering all CLI features. Browse by category (Basics, Projects, Planning, Teams, Config) and view detailed guides for each topic.',
+    examples: [{ code: '/tutorial' }],
+    interactions: [
+        '←/→ or Tab to switch between category tabs',
+        '↑/↓ or j/k to navigate topics',
+        'Enter to view topic details',
+        '/ to search tutorials',
+        'Esc to go back or close',
+    ],
+    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;
+    },
+};
+// =============================================================================
+// Changelog Command
+// =============================================================================
+export const changelogCommand = {
+    name: 'changelog',
+    aliases: ['changes', 'whatsnew'],
+    description: 'View release notes',
+    details: 'Opens a browsable overlay showing release notes for each version. View categorized changes (added, changed, fixed) for any release.',
+    examples: [
+        { code: '/changelog' },
+        { code: '/whatsnew', description: 'Alias' },
+    ],
+    interactions: [
+        '↑/↓ or j/k to navigate releases',
+        'Enter to view release details',
+        '/ to search releases',
+        'Esc to go back or close',
+    ],
+    async execute(_args, ctx) {
+        const overlay = new ChangelogOverlayV2();
+        await ctx.ui.showOverlay(overlay);
+        return true;
+    },
+};
+// =============================================================================
+// Commands Command
+// =============================================================================
+export const commandsCommand = {
+    name: 'commands',
+    description: 'Manage custom commands',
+    details: 'Create, edit, or delete custom slash commands. Custom commands are markdown files that expand into prompts when invoked.',
+    examples: [{ code: '/commands' }],
+    interactions: [
+        '↑/↓ to navigate commands',
+        'Enter to select or create new',
+        'Esc to close',
+    ],
+    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',
+    details: 'Opens the Project Dashboard where you can see current project info, switch projects, or start new work. From the dashboard you can create new projects, open existing ones, or start Quick Chat mode.',
+    examples: [{ code: '/menu' }],
+    interactions: [
+        '↑/↓ or j/k to navigate',
+        '←/→ or h/l to switch tabs (Dashboard ↔ More)',
+        'Enter to select, q/Esc to exit',
+        'n for /new, p for projects, c for chat, w for workflow',
+    ],
+    async execute(_args, ctx) {
+        // Print logo to scrolling area (stays visible while overlays render below)
+        ctx.printLogo();
+        // Show session restoration info if available (startup only, one-shot)
+        const sessionInfo = ctx.consumeRestoredSessionInfo();
+        if (sessionInfo) {
+            const s = getStyles();
+            console.log(s.info(sessionInfo));
+            console.log('');
+        }
+        // Show update notification if available
+        if (ctx.updateAvailable) {
+            const s = getStyles();
+            console.log(s.warning(`  ⬆ Update available: v${ctx.updateAvailable.current} → v${ctx.updateAvailable.latest}`));
+            console.log(s.muted('    Run: npm update -g @compilr-dev/cli'));
+            console.log('');
+        }
+        // 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 oldProjectId = getCurrentProjectIdForTracking();
+                        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}` });
+                            // Handle project switch - saves old session/team and loads new project's team
+                            const switchResult = await handleProjectSwitch(oldProjectId, ctx.agent ?? null, ctx.team && ctx.agentFactory ? {
+                                team: ctx.team,
+                                agentFactory: ctx.agentFactory,
+                            } : undefined);
+                            if (switchResult?.switched) {
+                                // Update the team if a new one was created/loaded
+                                if (switchResult.newTeam && ctx.setTeam) {
+                                    ctx.setTeam(switchResult.newTeam);
+                                    // Update footer with new active agent
+                                    const active = switchResult.newTeam.getActive();
+                                    ctx.ui.setActiveTeamAgent({
+                                        id: active.id,
+                                        displayName: active.displayName,
+                                        mascot: active.mascot,
+                                    });
+                                }
+                                if (switchResult.sessionRestored) {
+                                    ctx.ui.print({ type: 'info', message: `Session restored (${String(switchResult.messageCount)} messages).` });
+                                    ctx.ui.print({ type: 'info', message: 'Tip: Use Ctrl+R to view conversation history.' });
+                                    if (switchResult.restoredMessages) {
+                                        ctx.ui.setRestoredHistory(convertMessagesToItems(switchResult.restoredMessages));
+                                    }
+                                }
+                            }
+                        }
+                    }
+                    return true; // Exit loop, return to REPL
+                }
+                case 'chat': {
+                    // Track old project for team saving
+                    const oldProjectId = getCurrentProjectIdForTracking();
+                    // Save current team before clearing project (if in a project)
+                    if (oldProjectId !== null && ctx.team && ctx.agentFactory) {
+                        await handleProjectSwitch(oldProjectId, ctx.agent ?? null, {
+                            team: ctx.team,
+                            agentFactory: ctx.agentFactory,
+                        });
+                    }
+                    // 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,
+    changelogCommand,
+    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[];

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

@@ -0,0 +1,177 @@
+/**
+ * Debug Commands for REPL V2
+ *
+ * Commands for testing and debugging: todos, suggest, bash, subagent
+ */
+import { spawn } from 'child_process';
+// =============================================================================
+// Sample Todos Command (Debug) - adds sample todos for testing
+// =============================================================================
+export const sampleTodosCommand = {
+    name: 'sample-todos',
+    description: 'Add sample todos for testing (debug)',
+    details: 'Debug command that adds sample todo items to the footer for testing the todo display. Not for regular use.',
+    examples: [{ code: '/sample-todos' }],
+    execute(_args, ctx) {
+        ctx.ui.setTodos([
+            { content: 'First task', status: 'completed' },
+            { content: 'Second task', status: 'in_progress' },
+            { content: 'Third task', status: 'pending' },
+        ]);
+        ctx.ui.print({ type: 'info', message: 'Added sample todos' });
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Suggest Command (Debug)
+// =============================================================================
+export const suggestCommand = {
+    name: 'suggest',
+    description: 'Set ghost text suggestion (debug)',
+    details: 'Debug command that sets a ghost text suggestion in the input prompt for testing the autocomplete display.',
+    examples: [
+        { code: '/suggest', description: 'Default suggestion' },
+        { code: '/suggest hello world', description: 'Custom suggestion' },
+    ],
+    execute(args, ctx) {
+        if (args) {
+            ctx.ui.setSuggestion(args);
+            ctx.ui.print({ type: 'info', message: `Suggestion set to: "${args}"` });
+        }
+        else {
+            ctx.ui.setSuggestion('try typing something...');
+            ctx.ui.print({ type: 'info', message: 'Suggestion set' });
+        }
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Bash Command (Debug) - Executes a real bash command with LiveRegion display
+// =============================================================================
+export const bashCommand = {
+    name: 'bash',
+    description: 'Execute a real bash command in LiveRegion (debug)',
+    details: 'Debug command that executes a real bash command and streams output to the LiveRegion. Used for testing bash display rendering.',
+    examples: [
+        { code: '/bash', description: 'Default hello command' },
+        { code: '/bash ls -la', description: 'Run ls command' },
+    ],
+    async execute(args, ctx) {
+        const command = args || 'echo "Hello from bash!" && sleep 1 && echo "Done!"';
+        const id = `bash-${String(Date.now())}`;
+        // Enable input queueing while bash is running
+        ctx.ui.setAgentRunning(true);
+        // Add bash command to LiveRegion
+        ctx.ui.addBashCommand(id, command);
+        // Execute the real command
+        const exitCode = await new Promise((resolve) => {
+            const child = spawn('bash', ['-c', command], {
+                cwd: process.cwd(),
+                env: process.env,
+            });
+            // Handle stdout - stream each line to LiveRegion
+            child.stdout.on('data', (data) => {
+                const lines = data.toString().split('\n').filter((line) => line.length > 0);
+                for (const line of lines) {
+                    ctx.ui.updateBashOutput(id, line);
+                }
+            });
+            // Handle stderr - also stream to LiveRegion
+            child.stderr.on('data', (data) => {
+                const lines = data.toString().split('\n').filter((line) => line.length > 0);
+                for (const line of lines) {
+                    ctx.ui.updateBashOutput(id, `[stderr] ${line}`);
+                }
+            });
+            // Handle completion
+            child.on('close', (code) => {
+                resolve(code ?? 0);
+            });
+            // Handle errors
+            child.on('error', (err) => {
+                ctx.ui.updateBashOutput(id, `[error] ${err.message}`);
+                resolve(1);
+            });
+        });
+        // Complete the bash command
+        ctx.ui.completeBashCommand(id, exitCode);
+        // Short delay to show completion state, then commit to scrolling zone
+        await sleep(1000);
+        ctx.ui.commitBashCommand(id);
+        // Disable input queueing
+        ctx.ui.setAgentRunning(false);
+        return true;
+    },
+};
+/**
+ * Sleep helper for simulating delays
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// =============================================================================
+// Subagent Command (Debug) - Simulates a running subagent
+// =============================================================================
+export const subagentCommand = {
+    name: 'subagent',
+    description: 'Simulate a subagent in LiveRegion (debug)',
+    details: 'Debug command that simulates subagent execution with tool calls and completion in the LiveRegion. Used for testing subagent display rendering.',
+    examples: [
+        { code: '/subagent', description: 'Single subagent' },
+        { code: '/subagent multi', description: 'Multiple subagents' },
+        { code: '/subagent 5', description: 'Run 5 subagents' },
+    ],
+    async execute(args, ctx) {
+        // Parse args: "single" or "multi" or number
+        const mode = args.trim().toLowerCase();
+        const count = parseInt(mode, 10) || (mode === 'multi' ? 3 : 1);
+        // Enable input queueing while subagents are running
+        ctx.ui.setAgentRunning(true);
+        ctx.ui.print({ type: 'info', message: `Starting ${String(count)} subagent simulation(s)...` });
+        const agentIds = [];
+        // Create subagents
+        for (let i = 0; i < count; i++) {
+            const id = `subagent-${String(Date.now())}-${String(i)}`;
+            agentIds.push(id);
+            ctx.ui.addSubagent(id, 'Explore', `Task ${String(i + 1)}: Search for files`);
+        }
+        // Simulate tool calls for each agent
+        const tools = ['Glob', 'Grep', 'Read', 'Grep', 'Read'];
+        const summaries = [
+            'Searching for *.ts files...',
+            'Looking for pattern "export"...',
+            'Reading src/index.ts...',
+            'Looking for imports...',
+            'Reading config files...',
+        ];
+        for (let t = 0; t < tools.length; t++) {
+            await sleep(1000);
+            for (const agentId of agentIds) {
+                ctx.ui.updateSubagentTool(agentId, tools[t], summaries[t]);
+            }
+        }
+        // Complete all agents
+        await sleep(500);
+        for (const agentId of agentIds) {
+            ctx.ui.completeSubagent(agentId, true, 5000);
+        }
+        // Wait then commit to scrolling zone
+        await sleep(2000);
+        for (const agentId of agentIds) {
+            ctx.ui.commitSubagent(agentId, 'Simulation completed', true);
+        }
+        // Disable input queueing
+        ctx.ui.setAgentRunning(false);
+        ctx.ui.print({ type: 'success', message: `${String(count)} subagent simulation(s) completed` });
+        return true;
+    },
+};
+// =============================================================================
+// Export All Debug Commands
+// =============================================================================
+export const debugCommands = [
+    sampleTodosCommand,
+    suggestCommand,
+    bashCommand,
+    subagentCommand,
+];

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

@@ -0,0 +1,8 @@
+/**
+ * Delegations Command Handler
+ *
+ * Opens the delegations overlay to view coordinator delegation status.
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const delegationsCommand: CommandHandlerV2;
+export declare const delegationsCommands: CommandHandlerV2[];

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

@@ -0,0 +1,29 @@
+/**
+ * Delegations Command Handler
+ *
+ * Opens the delegations overlay to view coordinator delegation status.
+ */
+import { DelegationsOverlayV2 } from '../../ui/overlay/index.js';
+export const delegationsCommand = {
+    name: 'delegations',
+    aliases: ['del'],
+    description: 'View delegation status and history',
+    details: 'Shows delegations from the coordinator to background specialists. ' +
+        'Displays active, completed, and failed delegations with timing and results.',
+    examples: [
+        { code: '/delegations', description: 'Open the delegations overlay' },
+        { code: '/del', description: 'Short alias' },
+    ],
+    interactions: [
+        '↑↓ to navigate',
+        'Enter to view details',
+        'c to clear completed',
+        'Esc to close',
+    ],
+    async execute(_args, ctx) {
+        const overlay = new DelegationsOverlayV2();
+        await ctx.ui.showOverlay(overlay);
+        return true;
+    },
+};
+export const delegationsCommands = [delegationsCommand];

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

@@ -0,0 +1,8 @@
+/**
+ * Files Command for REPL V2
+ *
+ * Shows files tracked during the session (read, modified, referenced).
+ * Supports multi-agent teams: shows files per agent.
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const filesCommands: CommandHandlerV2[];