@compass-ai/nova 1.0.72 → 1.0.74

package/dist/services/plan-mode-handler.js

@@ -0,0 +1,388 @@
+/**
+ * Handler for the enter_plan_mode tool.
+ *
+ * This module provides the handler function that executes when the LLM
+ * calls the enter_plan_mode tool to initiate structured planning for
+ * complex tasks.
+ *
+ * Uses LLM-powered plan generation and React/Ink UI for approval.
+ */
+import { logger } from '../utils/logger.js';
+import { ExecutionMode, WorkflowPhase } from '../types/workflow.js';
+import { getEnhancedContextGatherer } from './enhanced-context-gatherer.js';
+import { getComplexityClassifier } from './complexity-classifier.js';
+import { generatePlanWithLLM } from './llm-plan-generator.js';
+import { getApprovalManager } from './approval-manager.js';
+import { getPlanPersistence } from './plan-persistence.js';
+import { getEventEmitter } from '../core/event-emitter.js';
+/**
+ * Emits a status message for UI display during plan mode execution.
+ */
+function emitStatus(toolCallId, message) {
+    if (toolCallId) {
+        const eventEmitter = getEventEmitter();
+        eventEmitter.emit('tool-status-message', { toolId: toolCallId, message });
+    }
+}
+/**
+ * Emits complexity reasoning for persistent UI display during plan mode.
+ */
+function emitComplexityReasoning(toolCallId, reasoning) {
+    if (toolCallId) {
+        const eventEmitter = getEventEmitter();
+        eventEmitter.emit('tool-complexity-reasoning', { toolId: toolCallId, reasoning });
+    }
+}
+/**
+ * Formats the implementation plan for LLM consumption.
+ * Provides a structured summary that the LLM can use to guide execution.
+ */
+function formatPlanForLLM(plan) {
+    const lines = [
+        `## Implementation Plan: ${plan.id.slice(0, 8)}`,
+        '',
+        `**Problem:** ${plan.problemStatement}`,
+        '',
+        '### Requirements:',
+        ...plan.requirements.map((r) => `- ${r.description} (priority: ${r.priority})`),
+        '',
+        '### Tasks:',
+        ...plan.tasks.map((t) => `${t.order}. ${t.description} (complexity: ${t.complexity}/10)`),
+        '',
+        '### File Operations:',
+        ...plan.impact.fileOperations.map((op) => `- [${op.operation}] ${op.path}${op.changes ? `: ${op.changes}` : ''}`),
+        '',
+        '### Risks:',
+        ...plan.risks.map((r) => `- [${r.severity}] ${r.description}`),
+        '',
+        `**Total Complexity:** ${plan.totalComplexity}/10`,
+        `**Rollback Strategy:** ${plan.rollbackStrategy}`,
+    ];
+    return lines.join('\n');
+}
+/**
+ * Formats clarification results for LLM consumption.
+ */
+function formatClarificationsForLLM(clarifications) {
+    const lines = [
+        '### User Clarifications:',
+        '',
+        ...clarifications.qaRecords.map((qa) => `**Q:** ${qa.question.question}\n**A:** ${qa.answer.answer}`),
+        '',
+        `**Summary:** ${clarifications.decisionSummary}`,
+    ];
+    return lines.join('\n');
+}
+/**
+ * Handler for the enter_plan_mode tool.
+ *
+ * Uses LLM-powered plan generation and React/Ink UI for plan approval.
+ * Flow:
+ * 1. Gather project context
+ * 2. Assess complexity
+ * 3. Generate plan with LLM
+ * 4. Request user approval via UI
+ * 5. Return approved plan to LLM for execution
+ *
+ * @param input - Tool input parameters
+ * @param context - Tool execution context
+ * @returns Structured result containing the plan and approval status
+ */
+export async function planModeHandler(input, context) {
+    logger.info('Entering plan mode (LLM-powered)', {
+        taskSummary: input.task_summary,
+        complexityReason: input.complexity_reason,
+    });
+    try {
+        // Build the full request including complexity reason if provided
+        const fullRequest = input.complexity_reason
+            ? `${input.task_summary}\n\nReason for planning: ${input.complexity_reason}`
+            : input.task_summary;
+        // 1. Gather project context
+        emitStatus(context.toolCallId, 'Gathering project context...');
+        logger.debug('Gathering project context...');
+        const contextGatherer = getEnhancedContextGatherer(context.projectRoot);
+        const gatheredContext = await contextGatherer.gatherContext(fullRequest, {}, context.toolCallId);
+        logger.info('Context gathered', {
+            projectType: gatheredContext.projectType,
+            relevantFiles: gatheredContext.relevantFiles.length,
+            affectedAreas: gatheredContext.affectedAreas,
+        });
+        // 2. Assess complexity
+        emitStatus(context.toolCallId, 'Analyzing task complexity...');
+        logger.debug('Assessing complexity...');
+        const complexityClassifier = getComplexityClassifier();
+        const complexity = complexityClassifier.classify(fullRequest, gatheredContext);
+        logger.info('Complexity assessed', {
+            mode: complexity.mode,
+            confidence: complexity.confidence,
+            filesAffected: complexity.factors.filesAffected,
+        });
+        // Emit complexity reasoning so user understands why plan mode was entered
+        // Prefer the LLM's specific complexity_reason over the generic classifier reasoning
+        const reasoningToDisplay = input.complexity_reason || complexity.reasoning;
+        if (reasoningToDisplay) {
+            emitComplexityReasoning(context.toolCallId, reasoningToDisplay);
+        }
+        // 2b. SHORT-CIRCUIT: If mode is CLARIFICATION, ask questions instead of generating plan
+        // Note: TODO_LIST mode proceeds to plan generation like PLAN mode
+        if (complexity.mode === ExecutionMode.CLARIFICATION) {
+            const questions = complexity.potentialQuestions || [];
+            if (questions.length > 0) {
+                emitStatus(context.toolCallId, 'Requesting clarification from user...');
+                logger.info('Mode is CLARIFICATION, requesting user input', {
+                    questionCount: questions.length,
+                });
+                // Request clarification via wizard UI
+                const approvalManager = getApprovalManager();
+                const clarificationResponse = await approvalManager.requestClarification(input.task_summary, questions, complexity.reasoning);
+                if (!clarificationResponse.completed) {
+                    // User cancelled the wizard
+                    logger.info('Clarification wizard cancelled by user');
+                    return {
+                        success: false,
+                        workflowId: '',
+                        phase: WorkflowPhase.FAILED,
+                        error: 'Clarification cancelled by user',
+                        planCancelled: true,
+                    };
+                }
+                // Return with clarification results - let LLM proceed with answers
+                logger.debug('Clarification completed', {
+                    answerCount: clarificationResponse.answers?.length || 0,
+                });
+                return {
+                    success: true,
+                    workflowId: clarificationResponse.requestId,
+                    phase: WorkflowPhase.CLARIFICATION,
+                    clarifications: clarificationResponse.result,
+                    context: gatheredContext,
+                    complexity,
+                };
+            }
+            else {
+                // No questions generated, fall through to plan generation
+                logger.info('CLARIFICATION mode but no questions generated, proceeding to plan');
+            }
+        }
+        // 3. Generate plan with LLM (status updates are emitted by the generator itself)
+        logger.debug('Generating plan with LLM...');
+        const plan = await generatePlanWithLLM(fullRequest, gatheredContext, complexity, undefined, context.toolCallId);
+        logger.info('Plan generated', {
+            planId: plan.id,
+            taskCount: plan.tasks.length,
+            riskCount: plan.risks.length,
+            totalComplexity: plan.totalComplexity,
+        });
+        // 3b. Save plan to disk for analysis
+        const planPersistence = getPlanPersistence(context.projectRoot);
+        await planPersistence.createPlanRecord(plan, fullRequest, gatheredContext, complexity);
+        // 4. Request user approval via UI
+        emitStatus(context.toolCallId, 'Awaiting plan approval...');
+        logger.debug('Requesting plan approval...');
+        const approvalManager = getApprovalManager();
+        const approval = await approvalManager.requestPlanApproval(plan, gatheredContext, complexity);
+        // Handle approval response
+        if (!approval.approved) {
+            if (approval.choice === 'clarify') {
+                // User wants clarification - return with clarification request
+                logger.info('Plan approval: user requested clarification', {
+                    planId: plan.id,
+                    questions: approval.clarifications,
+                });
+                // Update plan record with clarification status
+                await planPersistence.updateApprovalStatus(plan.id, 'clarify', approval.clarifications, undefined);
+                return {
+                    success: false,
+                    workflowId: plan.id,
+                    phase: WorkflowPhase.CLARIFICATION,
+                    plan,
+                    needsClarification: true,
+                    clarificationQuestions: approval.clarifications,
+                    error: `User requested clarification: ${approval.clarifications || 'No specific questions provided'}`,
+                };
+            }
+            if (approval.choice === 'edit') {
+                // User wants to modify the plan - return with modification request
+                logger.info('Plan approval: user requested modifications', {
+                    planId: plan.id,
+                    modifications: approval.modifications,
+                });
+                // Update plan record with edit status
+                await planPersistence.updateApprovalStatus(plan.id, 'edit', undefined, approval.modifications);
+                return {
+                    success: false,
+                    workflowId: plan.id,
+                    phase: WorkflowPhase.PLAN_GENERATION,
+                    plan,
+                    needsModification: true,
+                    modificationRequest: approval.modifications,
+                    error: `User requested plan modifications: ${approval.modifications || 'No specific modifications provided'}`,
+                };
+            }
+            // User rejected the plan
+            logger.info('Plan approval: user rejected plan', { planId: plan.id });
+            // Update plan record with rejection status
+            await planPersistence.updateApprovalStatus(plan.id, 'reject');
+            return {
+                success: false,
+                workflowId: plan.id,
+                phase: WorkflowPhase.FAILED,
+                plan,
+                error: 'Plan rejected by user',
+                planCancelled: true,
+            };
+        }
+        // 5. Plan approved - return for LLM execution
+        logger.info('Plan approved by user', {
+            planId: plan.id,
+            taskCount: plan.tasks.length,
+        });
+        // Update plan record with approval status and start execution
+        await planPersistence.updateApprovalStatus(plan.id, 'approve');
+        await planPersistence.startExecution(plan.id);
+        return {
+            success: true,
+            workflowId: plan.id,
+            phase: WorkflowPhase.EXECUTION,
+            plan,
+            context: gatheredContext,
+            complexity,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error('Plan mode failed', { error: errorMessage });
+        return {
+            success: false,
+            workflowId: '',
+            phase: WorkflowPhase.FAILED,
+            error: errorMessage,
+        };
+    }
+}
+/**
+ * Formats the plan mode result into a human-readable string for the LLM.
+ * This is used when returning the tool result to the conversation.
+ */
+export function formatPlanModeResult(result) {
+    // Handle clarification completed (from wizard)
+    if (result.phase === WorkflowPhase.CLARIFICATION && result.clarifications) {
+        const parts = [
+            '# Clarification Completed',
+            '',
+            'The user has provided their preferences. You can now proceed with implementation.',
+            '',
+            '## User Preferences:',
+            '',
+        ];
+        // Add each Q&A pair
+        for (const qa of result.clarifications.qaRecords) {
+            const answerText = Array.isArray(qa.answer.answer)
+                ? qa.answer.answer.join(', ')
+                : qa.answer.answer;
+            parts.push(`**${qa.question.question}**`);
+            parts.push(`Answer: ${answerText}`);
+            parts.push('');
+        }
+        parts.push(`**Summary:** ${result.clarifications.decisionSummary}`);
+        parts.push('');
+        parts.push('You may now proceed with the task using these preferences. If the task is complex, you can call enter_plan_mode again to create a detailed plan incorporating these preferences.');
+        return parts.join('\n');
+    }
+    // Handle clarification request (user requested clarification from plan approval)
+    if (result.needsClarification) {
+        return [
+            '# Plan Needs Clarification',
+            '',
+            `The user has requested clarification before approving the plan.`,
+            '',
+            `**User's Questions:**`,
+            result.clarificationQuestions || 'Please clarify the requirements.',
+            '',
+            'Please address these questions and then call enter_plan_mode again with updated information.',
+        ].join('\n');
+    }
+    // Handle modification request
+    if (result.needsModification) {
+        return [
+            '# Plan Needs Modification',
+            '',
+            `The user has requested changes to the plan.`,
+            '',
+            `**Requested Changes:**`,
+            result.modificationRequest || 'Please modify the approach.',
+            '',
+            result.plan ? formatPlanForLLM(result.plan) : '',
+            '',
+            'Please update your approach based on the feedback and call enter_plan_mode again.',
+        ].join('\n');
+    }
+    // Handle failure
+    if (!result.success) {
+        return `Plan mode failed: ${result.error || 'Unknown error'}`;
+    }
+    // Success - format the approved plan with explicit task list and instructions
+    const parts = [
+        `✓ Plan Approved - Starting Execution`,
+        '',
+        `**Plan ID:** ${result.workflowId}`,
+        `**Total Tasks:** ${result.plan?.tasks.length || 0}`,
+        `**Complexity:** ${result.plan?.totalComplexity || 0}/10`,
+        '',
+    ];
+    // Include clarifications if present
+    if (result.clarifications) {
+        parts.push('### User Clarifications');
+        parts.push(formatClarificationsForLLM(result.clarifications));
+        parts.push('');
+    }
+    // Add complete task list with explicit instructions
+    if (result.plan && result.plan.tasks.length > 0) {
+        parts.push('## Tasks to Execute');
+        parts.push('');
+        for (const task of result.plan.tasks) {
+            parts.push(`### Task ${task.order} (${task.id}): ${task.description}`);
+            parts.push(`- **ID:** \`${task.id}\``);
+            parts.push(`- **Files:** ${task.targetFiles.length > 0 ? task.targetFiles.join(', ') : 'none specified'}`);
+            parts.push(`- **Dependencies:** ${task.dependencies.length > 0 ? task.dependencies.join(', ') : 'none'}`);
+            parts.push(`- **Complexity:** ${task.complexity}/10`);
+            if (task.changes) {
+                parts.push(`- **Changes:** ${task.changes}`);
+            }
+            parts.push('');
+        }
+        parts.push('## Execution Instructions');
+        parts.push('');
+        parts.push('**IMPORTANT:** You MUST actually call the `complete_plan_task` tool after each task. Do NOT just narrate "marking as complete" — invoke the tool.');
+        parts.push('');
+        const taskIdList = result.plan.tasks.map(t => `\`${t.id}\``).join(', ');
+        parts.push('Execute tasks sequentially. After completing each task, use the `complete_plan_task` tool with:');
+        parts.push('- plan_id: `' + result.workflowId + '`');
+        parts.push('- task_id: Use the **exact** task ID from the plan above. Task IDs are: ' + taskIdList);
+        parts.push('- status: "completed" (or "failed" with error message if it fails)');
+        parts.push('- files_modified: [files you changed]');
+        parts.push('- summary: "Brief description"');
+        parts.push('');
+        parts.push('Continue until all tasks are done or user instructs otherwise.');
+        parts.push('');
+        parts.push('## Communication Style');
+        parts.push('');
+        parts.push('Be a helpful companion, not a robot. When transitioning between tasks:');
+        parts.push('- **Vary your language** - don\'t repeat the same phrases');
+        parts.push('- **Share brief insights** - mention interesting decisions or what you\'re about to tackle');
+        parts.push('- **Be concise but warm** - one short sentence is enough');
+        parts.push('');
+        parts.push('Examples of good transitions:');
+        parts.push('- "Physics engine is ready. Now let\'s wire up collision detection."');
+        parts.push('- "That sets up the core structure. Next I\'ll add the rendering logic."');
+        parts.push('- "Done with the API layer. The UI components are next."');
+        parts.push('- "Looking good! Time to connect these pieces together."');
+        parts.push('');
+        parts.push('Avoid robotic phrases like "Now proceeding to Task X" or "Moving to the next task."');
+        parts.push('');
+        parts.push('Let\'s start!');
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=plan-mode-handler.js.map

package/dist/services/plan-mode-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode-handler.js","sourceRoot":"","sources":["../../src/services/plan-mode-handler.ts"],"names":[],"mappings":"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"}

package/dist/services/plan-persistence.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Plan Persistence Service
+ *
+ * Handles saving and loading implementation plans to the .compass/plans directory.
+ * Plans are stored as JSON files with full context for analysis and debugging.
+ */
+import type { ImplementationPlan, ContextGatheringResult, ComplexityClassificationResult, PlanTask } from '../types/workflow.js';
+/**
+ * Status of a plan task during execution
+ */
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'skipped';
+/**
+ * Task execution record with status and timing
+ */
+export interface TaskExecutionRecord {
+    taskId: string;
+    status: TaskStatus;
+    startedAt?: string;
+    completedAt?: string;
+    filesModified?: string[];
+    error?: string;
+}
+/**
+ * Complete plan record saved to disk
+ */
+export interface PlanRecord {
+    /** Plan ID (matches ImplementationPlan.id) */
+    id: string;
+    /** ISO timestamp when plan was created */
+    createdAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Current phase of the plan */
+    phase: 'generated' | 'pending_approval' | 'approved' | 'rejected' | 'executing' | 'completed' | 'failed';
+    /** Original user request */
+    userRequest: string;
+    /** Project root where plan applies */
+    projectRoot: string;
+    /** Context gathered for plan generation */
+    context: ContextGatheringResult;
+    /** Complexity classification */
+    complexity: ComplexityClassificationResult;
+    /** The generated implementation plan */
+    plan: ImplementationPlan;
+    /** User's approval choice */
+    approvalChoice?: 'approve' | 'clarify' | 'edit' | 'reject';
+    /** User's clarification questions (if choice was 'clarify') */
+    clarificationQuestions?: string;
+    /** User's modification request (if choice was 'edit') */
+    modificationRequest?: string;
+    /** Execution status of each task */
+    taskExecution: Record<string, TaskExecutionRecord>;
+    /** Overall execution start time */
+    executionStartedAt?: string;
+    /** Overall execution end time */
+    executionCompletedAt?: string;
+    /** Total execution duration in ms */
+    executionDurationMs?: number;
+}
+/**
+ * Plan Persistence Service class
+ */
+declare class PlanPersistenceService {
+    private projectRoot;
+    private workflowsDir;
+    private activePlanId;
+    private activePlan;
+    private fileMonitorUnsubscribe;
+    constructor(projectRoot: string);
+    /**
+     * Sets the project root and updates workflows directory
+     */
+    setProjectRoot(projectRoot: string): void;
+    /**
+     * Ensures the workflows directory exists
+     */
+    private ensureDir;
+    /**
+     * Gets the file path for a plan record
+     */
+    private getPlanPath;
+    /**
+     * Creates a new plan record after generation
+     */
+    createPlanRecord(plan: ImplementationPlan, userRequest: string, context: ContextGatheringResult, complexity: ComplexityClassificationResult): Promise<PlanRecord>;
+    /**
+     * Saves a plan record to disk
+     */
+    savePlanRecord(record: PlanRecord): Promise<void>;
+    /**
+     * Loads a plan record from disk
+     */
+    loadPlanRecord(planId: string): Promise<PlanRecord | null>;
+    /**
+     * Updates plan phase after approval decision
+     */
+    updateApprovalStatus(planId: string, choice: 'approve' | 'clarify' | 'edit' | 'reject', clarificationQuestions?: string, modificationRequest?: string): Promise<void>;
+    /**
+     * Marks plan execution as started and begins file monitoring
+     */
+    startExecution(planId: string): Promise<void>;
+    /**
+     * Starts monitoring file operations to detect task progress
+     */
+    private startFileMonitoring;
+    /**
+     * Stops monitoring file operations
+     */
+    stopFileMonitoring(): void;
+    /**
+     * Refreshes the in-memory active plan after a mid-execution update.
+     * Keeps the existing file-monitoring subscription but points it at the
+     * updated plan so new targetFiles are recognised.
+     */
+    refreshActivePlan(updatedPlan: ImplementationPlan): void;
+    /**
+     * Gets the currently active plan ID
+     */
+    getActivePlanId(): string | null;
+    /**
+     * Updates task status based on file operations or explicit completion
+     */
+    updateTaskStatus(planId: string, taskId: string, status: TaskStatus, filesModified?: string[], error?: string): Promise<TaskExecutionRecord | null>;
+    /**
+     * Marks plan execution as completed and stops file monitoring
+     */
+    completeExecution(planId: string, success: boolean): Promise<void>;
+    /**
+     * Detects task progress from a file operation
+     * Returns the task that matches the file path, if any
+     */
+    detectTaskFromFileOperation(plan: ImplementationPlan, filePath: string): PlanTask | null;
+    /**
+     * Gets execution summary for display
+     */
+    getExecutionSummary(planId: string): Promise<{
+        total: number;
+        completed: number;
+        inProgress: number;
+        pending: number;
+        failed: number;
+        tasks: Array<{
+            task: PlanTask;
+            status: TaskStatus;
+        }>;
+    } | null>;
+    /**
+     * Gets pending tasks context for LLM injection when resuming plan execution.
+     * Returns null if no active plan or all tasks are complete.
+     */
+    getPendingTasksContext(planId: string): Promise<{
+        planId: string;
+        planTitle: string;
+        totalTasks: number;
+        completedTasks: number;
+        pendingTasks: Array<{
+            id: string;
+            index: number;
+            description: string;
+            targetFiles: string[];
+        }>;
+        nextTask: {
+            id: string;
+            index: number;
+            description: string;
+            targetFiles: string[];
+        } | null;
+        formattedContext: string;
+    } | null>;
+    /**
+     * Lists all plan records in the workflows directory
+     */
+    listPlanRecords(): Promise<Array<{
+        id: string;
+        createdAt: string;
+        phase: string;
+    }>>;
+    /**
+     * Archives a plan version before modification.
+     * Stores in a versions subdirectory for potential rollback.
+     */
+    archivePlanVersion(planId: string, plan: ImplementationPlan): Promise<void>;
+    /**
+     * Retrieves archived plan versions for a given plan ID.
+     * Returns versions sorted by version number descending (newest first).
+     */
+    getPlanVersions(planId: string): Promise<Array<{
+        version: number;
+        archivedAt: string;
+        plan: ImplementationPlan;
+    }>>;
+    /**
+     * Restores a plan to a previous version.
+     * Useful for rollback scenarios.
+     */
+    restorePlanVersion(planId: string, version: number): Promise<boolean>;
+}
+/**
+ * Gets the PlanPersistenceService instance for a project
+ */
+export declare function getPlanPersistence(projectRoot: string): PlanPersistenceService;
+export { PlanPersistenceService };
+//# sourceMappingURL=plan-persistence.d.ts.map

package/dist/services/plan-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-persistence.d.ts","sourceRoot":"","sources":["../../src/services/plan-persistence.ts"],"names":[],"mappings":"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"}