@compilr-dev/cli 0.4.0 → 0.5.0

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

@@ -0,0 +1,334 @@
+/**
+ * Design Commands
+ *
+ * Commands for project design and requirements:
+ * - design: Full project design workflow
+ * - sketch: Quick project outline
+ * - refine: Refine existing requirements
+ * - arch: Create architecture documentation
+ */
+import * as conversation from '../../ui/conversation.js';
+import { showModelWarningOverlay } from '../../ui/model-warning-overlay.js';
+import { showArchTypeOverlay } from '../../ui/arch-type-overlay.js';
+import { getModelTier, modelMeetsTier } from '../../utils/model-tiers.js';
+// Note: findBacklogPath removed - backlog now tracked in database via workitem_* tools
+import { getActiveProject } from '../../tools/project-db.js';
+import { workItemRepository } from '../../db/repositories/index.js';
+import { detectCompilrProject, getSkillPrompt, } from '../../repl-helpers.js';
+// =============================================================================
+// Design Command
+// =============================================================================
+export const designCommand = {
+    name: 'design',
+    description: 'Design your project and populate the backlog',
+    async execute(_args, ctx) {
+        // Check if project is initialized
+        const designProject = detectCompilrProject();
+        if (!designProject.found) {
+            conversation.printError('No .compilr project found. Run /new first.');
+            return true;
+        }
+        // Check model tier - /design works best with large models
+        if (!modelMeetsTier(ctx.currentModel, '/design')) {
+            const modelTier = getModelTier(ctx.currentModel);
+            // Show warning overlay
+            const choice = await showModelWarningOverlay({
+                command: '/design',
+                currentModel: ctx.currentModel,
+                currentTier: modelTier.tier,
+                suggestedModel: modelTier.suggestedUpgrade,
+                alternativeCommand: '/sketch',
+            });
+            switch (choice) {
+                case 'cancel':
+                    return true;
+                case 'alternative':
+                    // Run /sketch instead
+                    return ctx.handleCommand('sketch', '');
+                case 'switch':
+                    // Hot-switch to the suggested model
+                    if (modelTier.suggestedUpgrade) {
+                        ctx.setModel(modelTier.suggestedUpgrade);
+                        conversation.printSuccess(`Switched to ${modelTier.suggestedUpgrade}`);
+                        conversation.printInfo('');
+                    }
+                    else {
+                        conversation.printWarning('No suggested upgrade available. Continuing with current model.');
+                        conversation.printInfo('');
+                    }
+                    break;
+                case 'continue':
+                    // Proceed with current model
+                    break;
+            }
+        }
+        // Get design skill prompt
+        const designPrompt = getSkillPrompt('design');
+        if (!designPrompt) {
+            conversation.printError('Design skill not found.');
+            return true;
+        }
+        // Clear footer before printing, then re-render after
+        ctx.footer.clearForOutput();
+        conversation.printInfo('📋 Starting project design...');
+        conversation.printInfo('');
+        ctx.footer.forceRender();
+        // Resume footer animation before processing message
+        ctx.footer.resumeAnimation();
+        // Get active project for context
+        const activeProject = getActiveProject();
+        const projectContext = activeProject
+            ? `
+Project context:
+- ID: ${String(activeProject.id)}
+- Name: ${activeProject.name}
+- Path: ${activeProject.path}`
+            : '';
+        // Inject design skill and send initial message
+        await ctx.processMessage(`I want to design my project and create the backlog.
+
+${designPrompt}
+
+## DATABASE INTEGRATION (IMPORTANT)
+Use database tools for all backlog management:
+
+1. **For backlog items**: Use \`workitem_add\` for EACH feature/requirement
+   - Example: workitem_add({ type: "feature", title: "User Authentication", description: "...", priority: "high" })
+
+2. **For documents**: Use \`project_document_add\`
+   - Example: project_document_add({ doc_type: "prd", title: "Product Requirements", content: "..." })
+${projectContext}
+
+Please start by using todo_write to track the design phases, then begin with Phase 1: Vision. Use the ask_user tool to gather information efficiently.`, {
+            displayMessage: 'Start the design process for my project.',
+        });
+        return true;
+    },
+};
+// =============================================================================
+// Sketch Command
+// =============================================================================
+export const sketchCommand = {
+    name: 'sketch',
+    description: 'Quick project outline (6 questions)',
+    async execute(_args, ctx) {
+        // Check if project is initialized
+        const sketchProject = detectCompilrProject();
+        if (!sketchProject.found) {
+            conversation.printError('No .compilr project found. Run /new first.');
+            return true;
+        }
+        // Get sketch skill prompt
+        const sketchPrompt = getSkillPrompt('sketch');
+        if (!sketchPrompt) {
+            conversation.printError('Sketch skill not found.');
+            return true;
+        }
+        // Clear footer before printing, then re-render after
+        ctx.footer.clearForOutput();
+        conversation.printInfo('✏️ Starting quick project sketch...');
+        conversation.printInfo('');
+        ctx.footer.forceRender();
+        // Resume footer animation before processing message
+        ctx.footer.resumeAnimation();
+        // Inject sketch skill and send initial message
+        await ctx.processMessage(`I want to quickly outline my project.
+
+${sketchPrompt}
+
+## DATABASE INTEGRATION
+Use \`workitem_add\` for backlog items and \`project_document_add\` for documents.
+
+Please start by asking me about the type of application I'm building using the ask_user_simple tool.`, {
+            displayMessage: 'Quick project outline.',
+        });
+        return true;
+    },
+};
+// =============================================================================
+// Refine Command
+// =============================================================================
+export const refineCommand = {
+    name: 'refine',
+    description: 'Refine existing requirements',
+    async execute(args, ctx) {
+        // Check for active project in database
+        const activeProject = getActiveProject();
+        if (!activeProject) {
+            conversation.printError('No active project. Run /new first or use /projects to select one.');
+            return true;
+        }
+        // Check if project has work items in database
+        const counts = workItemRepository.getStatusCounts(activeProject.id);
+        const totalItems = counts.backlog + counts.in_progress + counts.completed + counts.skipped;
+        if (totalItems === 0) {
+            conversation.printError('No backlog items found. Run /design first to create initial requirements.');
+            return true;
+        }
+        // Check if a specific item ID was provided (e.g., /refine REQ-001)
+        const itemId = args.trim().toUpperCase();
+        const isFocusedRefine = itemId && /^[A-Z]+-\d{3}$/.test(itemId);
+        // For full refine mode (no item ID), check model tier and warn
+        if (!isFocusedRefine && !modelMeetsTier(ctx.currentModel, '/refine')) {
+            const modelTier = getModelTier(ctx.currentModel);
+            const choice = await showModelWarningOverlay({
+                command: '/refine',
+                currentModel: ctx.currentModel,
+                currentTier: modelTier.tier,
+                suggestedModel: modelTier.suggestedUpgrade,
+                alternativeCommand: '/refine <ITEM-ID>',
+            });
+            switch (choice) {
+                case 'cancel':
+                    return true;
+                case 'alternative':
+                    // Show hint about using specific item ID
+                    conversation.printInfo('💡 Tip: Use /refine <ITEM-ID> for focused refinement with smaller models.');
+                    conversation.printInfo('   Example: /refine REQ-001');
+                    conversation.printInfo('');
+                    return true;
+                case 'switch':
+                    if (modelTier.suggestedUpgrade) {
+                        ctx.setModel(modelTier.suggestedUpgrade);
+                        conversation.printSuccess(`Switched to ${ctx.currentModel}`);
+                    }
+                    break;
+                case 'continue':
+                    // Continue with current model
+                    break;
+            }
+        }
+        // Get appropriate skill prompt
+        const skillName = isFocusedRefine ? 'refine-item' : 'refine';
+        const refinePrompt = getSkillPrompt(skillName);
+        if (!refinePrompt) {
+            conversation.printError(`${skillName} skill not found.`);
+            return true;
+        }
+        // Clear footer before printing, then re-render after
+        ctx.footer.clearForOutput();
+        if (isFocusedRefine) {
+            conversation.printInfo(`🔄 Refining item ${itemId}...`);
+        }
+        else {
+            conversation.printInfo('🔄 Starting requirements refinement...');
+        }
+        conversation.printInfo('');
+        ctx.footer.forceRender();
+        // Resume footer animation before processing message
+        ctx.footer.resumeAnimation();
+        // Build message based on mode
+        const userIntent = isFocusedRefine
+            ? `I want to refine backlog item ${itemId}.`
+            : 'I want to refine my project requirements.';
+        const agentInstructions = isFocusedRefine
+            ? `Please use workitem_query to find item "${itemId}", then guide me through refining it using workitem_update.`
+            : 'Please start by using workitem_query with limit:10 to get an overview, then ask me what I\'d like to focus on using ask_user_simple.';
+        await ctx.processMessage(`${userIntent}
+
+${refinePrompt}
+
+## DATABASE INTEGRATION
+Use \`workitem_query\` to read items and \`workitem_update\` to modify them.
+
+${agentInstructions}`, {
+            displayMessage: userIntent,
+        });
+        return true;
+    },
+};
+// =============================================================================
+// Arch Command
+// =============================================================================
+export const archCommand = {
+    name: 'arch',
+    description: 'Create architecture documentation',
+    async execute(_args, ctx) {
+        // Check if project is initialized
+        const archProject = detectCompilrProject();
+        if (!archProject.found) {
+            conversation.printError('No .compilr project found. Run /new first.');
+            return true;
+        }
+        // Check model tier - /arch requires large models
+        if (!modelMeetsTier(ctx.currentModel, '/arch')) {
+            const modelTier = getModelTier(ctx.currentModel);
+            const choice = await showModelWarningOverlay({
+                command: '/arch',
+                currentModel: ctx.currentModel,
+                currentTier: modelTier.tier,
+                suggestedModel: modelTier.suggestedUpgrade,
+                // No alternative command for /arch - it's inherently complex
+            });
+            switch (choice) {
+                case 'cancel':
+                    return true;
+                case 'switch':
+                    if (modelTier.suggestedUpgrade) {
+                        ctx.setModel(modelTier.suggestedUpgrade);
+                        conversation.printSuccess(`Switched to ${modelTier.suggestedUpgrade}`);
+                        conversation.printInfo('');
+                    }
+                    else {
+                        conversation.printWarning('No suggested upgrade available. Continuing with current model.');
+                        conversation.printInfo('');
+                    }
+                    break;
+                case 'continue':
+                    // Proceed with current model
+                    break;
+            }
+        }
+        // Show type selection overlay
+        const archChoice = await showArchTypeOverlay();
+        if (!archChoice) {
+            // User cancelled
+            return true;
+        }
+        // Get architecture skill prompt
+        const archPrompt = getSkillPrompt('architecture');
+        if (!archPrompt) {
+            conversation.printError('Architecture skill not found.');
+            return true;
+        }
+        // Build the document type description for display
+        const docTypeLabels = {
+            'adr': 'Architecture Decision Record',
+            'diagram': 'System Diagram',
+            'data-model': 'Data Model',
+            'api': 'API Design',
+            'custom': 'Custom Documentation',
+        };
+        const displayType = archChoice.customTopic
+            ? `Custom: ${archChoice.customTopic}`
+            : docTypeLabels[archChoice.type];
+        // Clear footer before printing, then re-render after
+        ctx.footer.clearForOutput();
+        conversation.printInfo(`📐 Creating ${displayType}...`);
+        conversation.printInfo('');
+        ctx.footer.forceRender();
+        // Resume footer animation before processing message
+        ctx.footer.resumeAnimation();
+        // Replace placeholders in skill prompt
+        const finalPrompt = archPrompt
+            .replace('{{doc_type}}', archChoice.type)
+            .replace('{{#if custom_topic}}Custom Topic: {{custom_topic}}{{/if}}', archChoice.customTopic ? `Custom Topic: ${archChoice.customTopic}` : '');
+        await ctx.processMessage(`I want to create architecture documentation.
+
+${finalPrompt}
+
+Please start by using project_document_list to find any existing PRD, and workitem_query to understand the project backlog. Then use ask_user to gather the information needed for this ${archChoice.type} document.`, {
+            displayMessage: `Create ${displayType} documentation.`,
+        });
+        return true;
+    },
+};
+// =============================================================================
+// Export All Design Commands
+// =============================================================================
+export const designCommands = [
+    archCommand,
+    designCommand,
+    refineCommand,
+    sketchCommand,
+];

package/dist/commands/handlers/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Command Handlers
+ *
+ * Central export for all command handlers.
+ * Import this to register all handlers with the command registry.
+ */
+/**
+ * All command handlers, organized by category.
+ */
+export declare const allHandlers: import("../handler-types.js").CommandHandler[];
+/**
+ * Register all command handlers with the registry.
+ * Call this once at startup.
+ */
+export declare function registerAllHandlers(): void;
+export * from './simple-commands.js';
+export * from './overlay-commands.js';
+export * from './agent-commands.js';
+export * from './project-commands.js';
+export * from './design-commands.js';

package/dist/commands/handlers/index.js

@@ -0,0 +1,43 @@
+/**
+ * Command Handlers
+ *
+ * Central export for all command handlers.
+ * Import this to register all handlers with the command registry.
+ */
+import { commandRegistry } from '../registry.js';
+import { simpleCommands } from './simple-commands.js';
+import { overlayCommands } from './overlay-commands.js';
+import { agentCommands } from './agent-commands.js';
+import { projectCommands } from './project-commands.js';
+import { designCommands } from './design-commands.js';
+// =============================================================================
+// All Handlers
+// =============================================================================
+/**
+ * All command handlers, organized by category.
+ */
+export const allHandlers = [
+    ...simpleCommands,
+    ...overlayCommands,
+    ...agentCommands,
+    ...projectCommands,
+    ...designCommands,
+];
+// =============================================================================
+// Registration
+// =============================================================================
+/**
+ * Register all command handlers with the registry.
+ * Call this once at startup.
+ */
+export function registerAllHandlers() {
+    commandRegistry.registerAll(allHandlers);
+}
+// =============================================================================
+// Re-exports
+// =============================================================================
+export * from './simple-commands.js';
+export * from './overlay-commands.js';
+export * from './agent-commands.js';
+export * from './project-commands.js';
+export * from './design-commands.js';

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

@@ -0,0 +1,21 @@
+/**
+ * Overlay Commands
+ *
+ * Commands that primarily show overlays without complex logic:
+ * - agents, anchors, backlog, commands, docs, help, keys, tutorial
+ */
+import type { CommandHandler } from '../handler-types.js';
+export declare const agentsCommand: CommandHandler;
+export declare const anchorsCommand: CommandHandler;
+export declare const backlogCommand: CommandHandler;
+export declare const commandsCommand: CommandHandler;
+export declare const docsCommand: CommandHandler;
+export declare const helpCommand: CommandHandler;
+export declare const keysCommand: CommandHandler;
+export declare const tutorialCommand: CommandHandler;
+export declare const toolsCommand: CommandHandler;
+export declare const themeCommand: CommandHandler;
+export declare const modelCommand: CommandHandler;
+export declare const mascotCommand: CommandHandler;
+export declare const configCommand: CommandHandler;
+export declare const overlayCommands: CommandHandler[];