@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/commands/handlers/overlay-commands.js

@@ -0,0 +1,287 @@
+/**
+ * Overlay Commands
+ *
+ * Commands that primarily show overlays without complex logic:
+ * - agents, anchors, backlog, commands, docs, help, keys, tutorial
+ */
+import * as conversation from '../../ui/conversation.js';
+import * as overlays from '../../ui/overlays.js';
+import { showAgentsOverlay } from '../../ui/agents-overlay.js';
+import { showAnchorsOverlay } from '../../ui/anchors-overlay.js';
+import { showBacklogOverlay } from '../../ui/backlog-overlay.js';
+import { showCommandsOverlay } from '../../ui/commands-overlay.js';
+import { showDocsOverlay } from '../../ui/docs-overlay.js';
+import { showKeysOverlay } from '../../ui/keys-overlay.js';
+import { showTutorialOverlay } from '../../ui/tutorial-overlay.js';
+import { showThemeOverlay } from '../../ui/theme-overlay.js';
+import { showModelOverlay } from '../../ui/model-overlay.js';
+import { showMascotOverlay } from '../../ui/mascot-overlay.js';
+import { showConfigOverlay } from '../../ui/config-overlay.js';
+import { debugLog } from '../../utils/debug-log.js';
+// =============================================================================
+// Agents Command
+// =============================================================================
+export const agentsCommand = {
+    name: 'agents',
+    description: 'View available sub-agent types',
+    async execute(_args, _ctx) {
+        await showAgentsOverlay();
+        return true;
+    },
+};
+// =============================================================================
+// Anchors Command
+// =============================================================================
+export const anchorsCommand = {
+    name: 'anchors',
+    description: 'View and manage context anchors',
+    async execute(_args, _ctx) {
+        await showAnchorsOverlay();
+        return true;
+    },
+};
+// =============================================================================
+// Backlog Command
+// =============================================================================
+export const backlogCommand = {
+    name: 'backlog',
+    description: 'View and manage the project backlog',
+    async execute(_args, _ctx) {
+        const result = await showBacklogOverlay();
+        if (result.modified) {
+            conversation.printSuccess('Backlog updated.');
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Commands Command
+// =============================================================================
+export const commandsCommand = {
+    name: 'commands',
+    description: 'View custom commands',
+    async execute(_args, _ctx) {
+        await showCommandsOverlay();
+        return true;
+    },
+};
+// =============================================================================
+// Docs Command
+// =============================================================================
+export const docsCommand = {
+    name: 'docs',
+    description: 'View project documentation',
+    async execute(_args, _ctx) {
+        await showDocsOverlay();
+        return true;
+    },
+};
+// =============================================================================
+// Help Command
+// =============================================================================
+export const helpCommand = {
+    name: 'help',
+    aliases: ['?'],
+    description: 'Show available commands and help',
+    async execute(_args, _ctx) {
+        await overlays.showHelp();
+        return true;
+    },
+};
+// =============================================================================
+// Keys Command
+// =============================================================================
+export const keysCommand = {
+    name: 'keys',
+    description: 'Manage API keys',
+    async execute(_args, _ctx) {
+        debugLog('REPL:keys', 'calling showKeysOverlay');
+        const result = await showKeysOverlay();
+        debugLog('REPL:keys', 'showKeysOverlay returned');
+        if (result.changed) {
+            conversation.printSuccess('API keys updated.');
+            conversation.printInfo('Restart the CLI to use the new keys.');
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Tutorial Command
+// =============================================================================
+export const tutorialCommand = {
+    name: 'tutorial',
+    description: 'Interactive tutorial',
+    async execute(_args, _ctx) {
+        await showTutorialOverlay();
+        return true;
+    },
+};
+// =============================================================================
+// Tools Command
+// =============================================================================
+export const toolsCommand = {
+    name: 'tools',
+    description: 'View available tools',
+    async execute(_args, ctx) {
+        await ctx.showTools();
+        return true;
+    },
+};
+// =============================================================================
+// Theme Command
+// =============================================================================
+export const themeCommand = {
+    name: 'theme',
+    description: 'Change the color theme',
+    async execute(_args, ctx) {
+        // Result may be undefined if user cancelled with Esc (base overlay casts undefined to TResult)
+        const themeResult = await showThemeOverlay();
+        // Theme is already persisted by the overlay
+        if (themeResult?.themeChanged) {
+            ctx.footer.clearForOutput();
+            conversation.printSuccess(`Theme changed to: ${themeResult.themeName ?? themeResult.themeChanged}`);
+            ctx.footer.refreshPrompt();
+            ctx.footer.forceRender();
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Model Command
+// =============================================================================
+export const modelCommand = {
+    name: 'model',
+    description: 'Change the AI model',
+    async execute(_args, ctx) {
+        // Result may be undefined if user cancelled with Esc (base overlay casts undefined to TResult)
+        const modelResult = await showModelOverlay({
+            currentModel: ctx.currentModel,
+            currentProvider: ctx.provider,
+        });
+        // Handle model change result
+        if (modelResult?.modelChanged) {
+            ctx.setModel(modelResult.modelChanged);
+            // Clear footer, print message, re-render footer
+            ctx.footer.clearForOutput();
+            if (modelResult.requiresRestart) {
+                conversation.printWarning(`Model set to: ${modelResult.modelChanged} (restart required)`);
+            }
+            else {
+                conversation.printSuccess(`Model switched to: ${modelResult.modelChanged}`);
+            }
+            ctx.footer.forceRender();
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Mascot Command
+// =============================================================================
+export const mascotCommand = {
+    name: 'mascot',
+    description: 'Change the mascot character',
+    async execute(_args, ctx) {
+        // Result may be undefined if user cancelled with Esc (base overlay casts undefined to TResult)
+        const mascotResult = await showMascotOverlay();
+        // Mascot is already persisted by the overlay
+        if (mascotResult?.mascotChanged) {
+            ctx.footer.clearForOutput();
+            conversation.printSuccess(`Mascot changed to: ${mascotResult.mascotChanged}`);
+            ctx.footer.forceRender();
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Config Command
+// =============================================================================
+export const configCommand = {
+    name: 'config',
+    description: 'View settings and configuration',
+    async execute(_args, ctx) {
+        // Get context stats for usage tab
+        const contextManager = ctx.agent.getContextManager();
+        const history = ctx.agent.getHistory();
+        let contextUsed = 0;
+        let contextMax = 200000;
+        if (contextManager) {
+            const stats = contextManager.getStats(history.length);
+            contextUsed = stats.currentTokens;
+            contextMax = stats.maxTokens;
+        }
+        // Loop to handle sub-overlay requests (user can return to config after sub-overlay)
+        let continueConfig = true;
+        while (continueConfig) {
+            const configResult = await showConfigOverlay({
+                version: ctx.version,
+                cwd: process.cwd(),
+                model: ctx.currentModel,
+                provider: ctx.provider,
+                toolCount: ctx.agent.getToolDefinitions().length,
+                startTime: ctx.startTime,
+                // Usage stats
+                inputTokens: ctx.sessionInputTokens,
+                outputTokens: ctx.sessionOutputTokens,
+                requests: ctx.sessionRequests,
+                contextUsed,
+                contextMax,
+                messageCount: history.length,
+                // Model change callback for hot-switch
+                onModelChange: (model) => {
+                    ctx.setModel(model);
+                },
+            });
+            // Handle sub-overlay requests
+            if (configResult.requestSubOverlay === 'theme') {
+                const themeResult = await showThemeOverlay();
+                if (themeResult.themeChanged) {
+                    ctx.footer.refreshPrompt();
+                }
+                // Continue loop to return to config overlay
+            }
+            else if (configResult.requestSubOverlay === 'model') {
+                const modelResult = await showModelOverlay({
+                    currentModel: ctx.currentModel,
+                    currentProvider: ctx.provider,
+                });
+                if (modelResult.modelChanged) {
+                    ctx.setModel(modelResult.modelChanged);
+                }
+                // Continue loop to return to config overlay
+            }
+            else if (configResult.requestSubOverlay === 'mascot') {
+                await showMascotOverlay();
+                // Continue loop to return to config overlay
+            }
+            else {
+                // No sub-overlay requested, exit the loop
+                continueConfig = false;
+                // Handle model change result (for hot-switch)
+                if (configResult.modelChanged) {
+                    ctx.setModel(configResult.modelChanged);
+                }
+            }
+        }
+        // Refresh prompt in case theme changed
+        ctx.footer.refreshPrompt();
+        return true;
+    },
+};
+// =============================================================================
+// Export All Overlay Commands
+// =============================================================================
+export const overlayCommands = [
+    agentsCommand,
+    anchorsCommand,
+    backlogCommand,
+    commandsCommand,
+    configCommand,
+    docsCommand,
+    helpCommand,
+    keysCommand,
+    mascotCommand,
+    modelCommand,
+    themeCommand,
+    toolsCommand,
+    tutorialCommand,
+];

package/dist/commands/handlers/project-commands.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Project Commands
+ *
+ * Commands related to project management:
+ * - init: Initialize a new project
+ * - projects: Switch between projects
+ */
+import type { CommandHandler } from '../handler-types.js';
+export declare const newCommand: CommandHandler;
+export declare const projectsCommand: CommandHandler;
+export declare const projectCommands: CommandHandler[];

package/dist/commands/handlers/project-commands.js

@@ -0,0 +1,167 @@
+/**
+ * Project Commands
+ *
+ * Commands related to project management:
+ * - init: Initialize a new project
+ * - projects: Switch between projects
+ */
+import * as conversation from '../../ui/conversation.js';
+import { showNewProjectOverlay } from '../../ui/new-overlay.js';
+import { showProjectsOverlay } from '../../ui/projects-overlay.js';
+import { showWorkflowOverlay } from '../../ui/workflow-overlay.js';
+import { showBacklogOverlay } from '../../ui/backlog-overlay.js';
+import { showAnchorsOverlay } from '../../ui/anchors-overlay.js';
+import { showDocsOverlay } from '../../ui/docs-overlay.js';
+import { projectRepository } from '../../db/repositories/index.js';
+import { setActiveProject, getActiveProject } from '../../tools/project-db.js';
+// =============================================================================
+// New Command
+// =============================================================================
+export const newCommand = {
+    name: 'new',
+    description: 'Create a new project',
+    async execute(_args, ctx) {
+        // Pause footer during overlay (command overlay - we handle footer ourselves)
+        ctx.footer.pauseAnimation();
+        // Result may be undefined if user cancelled with Esc
+        const newProjectResult = await showNewProjectOverlay();
+        // Resume footer if user cancelled (no project created)
+        if (!newProjectResult?.created) {
+            ctx.footer.resumeAnimation();
+            return true;
+        }
+        // Project was created - continue with success handling
+        // Show success message with created files info
+        conversation.printSuccess(`Project created: ${newProjectResult.projectPath ?? ''}`);
+        if (newProjectResult.docsPath) {
+            conversation.printSuccess(`Docs repo created: ${newProjectResult.docsPath}`);
+        }
+        // Register project in database if tracking is enabled
+        if (newProjectResult.trackInDatabase && newProjectResult.projectName && newProjectResult.projectPath) {
+            try {
+                const project = projectRepository.create({
+                    name: newProjectResult.projectName,
+                    display_name: newProjectResult.projectName.replace(/-/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase()),
+                    description: newProjectResult.description,
+                    path: newProjectResult.projectPath,
+                    type: 'general',
+                    workflow_mode: newProjectResult.workflowMode ?? 'flexible',
+                });
+                setActiveProject({ id: project.id, name: project.name, displayName: project.displayName, path: project.path });
+                conversation.printSuccess(`Project tracked in database (${newProjectResult.workflowMode ?? 'flexible'} mode)`);
+            }
+            catch (dbError) {
+                conversation.printWarning(`Could not register in database: ${dbError.message}`);
+            }
+        }
+        conversation.printInfo('');
+        conversation.printInfo('Next steps:');
+        conversation.printInfo(`  cd ${newProjectResult.projectPath?.split('/').pop() ?? 'project'}`);
+        conversation.printInfo('  npm install');
+        conversation.printInfo('  npm run dev');
+        conversation.printInfo('');
+        // Resume footer animation before processing message
+        ctx.footer.resumeAnimation();
+        // Ask agent to read the COMPILR.md and understand the project
+        const compilrMdPath = newProjectResult.docsPath
+            ? `${newProjectResult.docsPath}/COMPILR.md`
+            : `${newProjectResult.projectPath ?? '.'}/COMPILR.md`;
+        await ctx.processMessage(`I just created a new project using /new. Please read ${compilrMdPath} to understand the project context and confirm you're ready to help me build it.
+
+(Note to user: When you want to define requirements and populate the backlog, type /design)`);
+        return true;
+    },
+};
+// =============================================================================
+// Projects Command
+// =============================================================================
+export const projectsCommand = {
+    name: 'projects',
+    description: 'Switch between projects',
+    async execute(_args, ctx) {
+        // Remember old project for anchor cleanup
+        const oldProject = getActiveProject();
+        const oldProjectId = oldProject ? String(oldProject.id) : null;
+        // Loop between projects and workflow overlays
+        // User can: projects → workflow → back to projects → workflow → etc.
+        let stayInProjects = true;
+        while (stayInProjects) {
+            const projectsResult = await showProjectsOverlay();
+            if (projectsResult.action === 'open-workflow' && projectsResult.projectId) {
+                // Inner loop: workflow → view command → back to workflow
+                let stayInWorkflow = true;
+                while (stayInWorkflow) {
+                    const workflowResult = await showWorkflowOverlay(projectsResult.projectId);
+                    if (workflowResult.command) {
+                        const cmd = workflowResult.command.replace(/^\//, '');
+                        // Handle "view" commands within workflow loop
+                        if (cmd === 'backlog') {
+                            await showBacklogOverlay();
+                            // After backlog closes, loop back to workflow
+                        }
+                        else if (cmd === 'anchors') {
+                            await showAnchorsOverlay();
+                            // After anchors closes, loop back to workflow
+                        }
+                        else if (cmd === 'docs') {
+                            await showDocsOverlay();
+                            // After docs closes, loop back to workflow
+                        }
+                        else {
+                            // Other commands (design, build, scaffold, etc.) - set project and handle
+                            const project = projectRepository.getById(projectsResult.projectId);
+                            if (project) {
+                                // Set as active project
+                                setActiveProject({
+                                    id: project.id,
+                                    name: project.name,
+                                    displayName: project.displayName,
+                                    path: project.path,
+                                });
+                                projectRepository.touch(project.id);
+                                // Update footer with new project name
+                                ctx.footer.setProjectName(project.displayName);
+                                // Reload project-specific anchors (hot-reload)
+                                ctx.reloadProjectAnchors(oldProjectId, String(project.id));
+                                conversation.printSuccess(`Project "${project.displayName}" set as active`);
+                                conversation.printInfo('');
+                                // Handle the command
+                                await ctx.handleCommand(cmd, '');
+                            }
+                            stayInWorkflow = false;
+                            stayInProjects = false;
+                        }
+                    }
+                    else if (workflowResult.action) {
+                        // Handle manage actions (edit, delete)
+                        const project = projectRepository.getById(projectsResult.projectId);
+                        if (workflowResult.action === 'delete' && project) {
+                            conversation.printWarning(`Delete "${project.displayName}" via /projects (x to archive, d to delete)`);
+                        }
+                        else if (workflowResult.action === 'edit' && project) {
+                            conversation.printInfo(`Edit is not yet implemented. Use /projects to manage projects.`);
+                        }
+                        stayInWorkflow = false;
+                        stayInProjects = false;
+                    }
+                    else {
+                        // Workflow cancelled (Esc), go back to projects list
+                        stayInWorkflow = false;
+                    }
+                }
+            }
+            else {
+                // Projects cancelled (Esc), exit loop
+                stayInProjects = false;
+            }
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Export All Project Commands
+// =============================================================================
+export const projectCommands = [
+    newCommand,
+    projectsCommand,
+];

package/dist/commands/handlers/simple-commands.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Simple Commands
+ *
+ * Handles straightforward commands that don't require complex logic:
+ * - exit/quit/q - Exit the REPL
+ * - plan - Switch to plan mode
+ */
+import type { CommandHandler } from '../handler-types.js';
+export declare const exitCommand: CommandHandler;
+export declare const planCommand: CommandHandler;
+export declare const menuCommand: CommandHandler;
+export declare const clearCommand: CommandHandler;
+export declare const statusCommand: CommandHandler;
+export declare const tokensCommand: CommandHandler;
+export declare const contextCommand: CommandHandler;
+export declare const todosCommand: CommandHandler;
+export declare const compactCommand: CommandHandler;
+export declare const exportCommand: CommandHandler;
+export declare const simpleCommands: CommandHandler[];

package/dist/commands/handlers/simple-commands.js

@@ -0,0 +1,144 @@
+/**
+ * Simple Commands
+ *
+ * Handles straightforward commands that don't require complex logic:
+ * - exit/quit/q - Exit the REPL
+ * - plan - Switch to plan mode
+ */
+import * as conversation from '../../ui/conversation.js';
+import * as terminal from '../../ui/terminal.js';
+import { getActiveProject } from '../../tools/project-db.js';
+// =============================================================================
+// Exit Command
+// =============================================================================
+export const exitCommand = {
+    name: 'exit',
+    aliases: ['quit', 'q'],
+    description: 'Exit the REPL',
+    execute(_args, _ctx) {
+        // Return false to signal REPL should exit
+        return Promise.resolve(false);
+    },
+};
+// =============================================================================
+// Plan Command
+// =============================================================================
+export const planCommand = {
+    name: 'plan',
+    description: 'Switch to Plan mode (agent creates plans without executing)',
+    execute(_args, ctx) {
+        ctx.footer.setMode('plan');
+        if (ctx.onModeChange) {
+            ctx.onModeChange('plan');
+        }
+        conversation.printInfo('📋 Switched to Plan mode');
+        conversation.printInfo('The agent will create execution plans without performing actions.');
+        conversation.printInfo('Use Shift+Tab to switch back to Normal or Auto-accept mode.');
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Menu Command
+// =============================================================================
+export const menuCommand = {
+    name: 'menu',
+    description: 'Return to the startup menu',
+    execute(_args, ctx) {
+        // Signal that we want to return to the startup menu
+        ctx.setShouldReturnToMenu(true);
+        return Promise.resolve(false); // Exit REPL to return to menu
+    },
+};
+// =============================================================================
+// Clear Command
+// =============================================================================
+export const clearCommand = {
+    name: 'clear',
+    description: 'Clear the screen',
+    execute(_args, ctx) {
+        terminal.clearScreen();
+        conversation.printWelcome(ctx.model, ctx.version, getActiveProject()?.displayName ?? null);
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Status Command
+// =============================================================================
+export const statusCommand = {
+    name: 'status',
+    description: 'Show session status',
+    execute(_args, ctx) {
+        ctx.showStatus();
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Tokens Command
+// =============================================================================
+export const tokensCommand = {
+    name: 'tokens',
+    description: 'Show token usage',
+    execute(_args, ctx) {
+        ctx.showTokens();
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Context Command
+// =============================================================================
+export const contextCommand = {
+    name: 'context',
+    description: 'Show context statistics',
+    execute(_args, ctx) {
+        ctx.showContext();
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Todos Command
+// =============================================================================
+export const todosCommand = {
+    name: 'todos',
+    description: 'Show current todo list',
+    execute(_args, ctx) {
+        ctx.showTodos();
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Compact Command
+// =============================================================================
+export const compactCommand = {
+    name: 'compact',
+    description: 'Compact the conversation context',
+    async execute(_args, ctx) {
+        await ctx.handleCompact();
+        return true;
+    },
+};
+// =============================================================================
+// Export Command
+// =============================================================================
+export const exportCommand = {
+    name: 'export',
+    description: 'Export the conversation',
+    async execute(args, ctx) {
+        await ctx.handleExport(args);
+        return true;
+    },
+};
+// =============================================================================
+// Export All Simple Commands
+// =============================================================================
+export const simpleCommands = [
+    exitCommand,
+    planCommand,
+    menuCommand,
+    clearCommand,
+    statusCommand,
+    tokensCommand,
+    contextCommand,
+    todosCommand,
+    compactCommand,
+    exportCommand,
+];

package/dist/commands/index.d.ts

@@ -3,5 +3,6 @@
  *
  * Exports custom command types and registry.
  */
-export { CustomCommand, CommandLocation, PROJECT_COMMANDS_DIR, USER_COMMANDS_DIR, isValidCommandName, } from './types.js';
+export type { CustomCommand, CommandLocation } from './types.js';
+export { PROJECT_COMMANDS_DIR, USER_COMMANDS_DIR, isValidCommandName, } from './types.js';
 export { CustomCommandRegistry, getCustomCommandRegistry, resetCustomCommandRegistry, expandArguments, } from './custom-registry.js';