@compass-ai/nova 1.0.72 → 1.0.74

package/dist/services/iteration-scoper.d.ts.map

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

package/dist/services/iteration-scoper.js

@@ -0,0 +1,387 @@
+/**
+ * Iteration Scoper Service
+ *
+ * Manages per-task iteration counting for multi-step plan execution.
+ * Provides scoped iteration budgets to prevent early task exhaustion.
+ *
+ * @example
+ * ```typescript
+ * const scoper = getIterationScoper();
+ * scoper.startPlanExecution('plan-123', 50); // 50 iterations per task
+ *
+ * while (scoper.shouldContinueIteration(globalIterations)) {
+ *   scoper.incrementIteration();
+ *   // ... execute iteration ...
+ * }
+ *
+ * scoper.stopPlanExecution();
+ * ```
+ */
+import { getEventEmitter } from '../core/event-emitter.js';
+import { logger } from '../utils/logger.js';
+import { DEFAULT_MAX_ITERATIONS_PER_TASK } from '../constants/defaults.js';
+/**
+ * Default dynamic iteration configuration
+ *
+ * Values are set generously because plan execution involves multiple tool calls:
+ * - Read, search, edit cycles consume 3-5 iterations each
+ * - Compilation/test failures requiring fixes can consume 10+ iterations
+ * - Complex tasks legitimately need 40-60 iterations to complete
+ */
+export const DEFAULT_DYNAMIC_ITERATION_CONFIG = {
+    baseIterations: 35, // Complexity 1 task gets 35 iterations (was 25)
+    complexityMultiplier: 10, // Each complexity point adds 10 iterations (was 8)
+    minIterations: 35, // Never less than 35 (was 25)
+    maxIterations: 150, // Never more than 150 per task (was 100)
+};
+/**
+ * Calculates the maximum iterations for a task based on its complexity.
+ *
+ * Formula: baseIterations + (complexity - 1) * complexityMultiplier
+ * Result is clamped between minIterations and maxIterations.
+ *
+ * Examples with default config:
+ * - Complexity 1: 35 iterations (trivial task)
+ * - Complexity 3: 55 iterations (simple task)
+ * - Complexity 5: 75 iterations (moderate task)
+ * - Complexity 7: 95 iterations (complex task)
+ * - Complexity 10: 125 iterations (very complex task)
+ *
+ * @param complexity - Task complexity (1-10 scale)
+ * @param config - Optional configuration overrides
+ * @returns Calculated max iterations
+ */
+export function calculateIterationsForComplexity(complexity, config = DEFAULT_DYNAMIC_ITERATION_CONFIG) {
+    // Clamp complexity to valid range
+    const clampedComplexity = Math.max(1, Math.min(10, complexity));
+    // Calculate raw iterations
+    const rawIterations = config.baseIterations +
+        (clampedComplexity - 1) * config.complexityMultiplier;
+    // Clamp to min/max bounds
+    return Math.max(config.minIterations, Math.min(config.maxIterations, Math.round(rawIterations)));
+}
+/**
+ * Service for managing task-scoped iteration budgets in plan execution
+ */
+class IterationScoper {
+    context = {
+        planId: null,
+        currentTaskId: null,
+        taskIterations: 0,
+        totalIterations: 0,
+        maxIterationsPerTask: DEFAULT_MAX_ITERATIONS_PER_TASK,
+        currentTaskMaxIterations: DEFAULT_MAX_ITERATIONS_PER_TASK,
+        taskStartIteration: 0,
+        taskComplexities: new Map(),
+        dynamicConfig: DEFAULT_DYNAMIC_ITERATION_CONFIG,
+    };
+    /** History of iteration counts per task */
+    taskIterationHistory = new Map();
+    /** Event unsubscriber functions for cleanup */
+    eventUnsubscribers = [];
+    /** Flag to track if plan execution is active */
+    isActive = false;
+    /**
+     * Starts monitoring plan execution and subscribes to task boundary events
+     *
+     * @param planId - Unique plan identifier
+     * @param maxPerTask - Default maximum iterations allowed per task (default: DEFAULT_MAX_ITERATIONS_PER_TASK)
+     * @param taskComplexities - Optional array of task complexities for dynamic limits
+     * @param dynamicConfig - Optional configuration for dynamic iteration calculation
+     */
+    startPlanExecution(planId, maxPerTask = DEFAULT_MAX_ITERATIONS_PER_TASK, taskComplexities, dynamicConfig) {
+        if (this.isActive) {
+            logger.warn('IterationScoper: startPlanExecution called while already active, resetting');
+            this.stopPlanExecution();
+        }
+        logger.debug(`IterationScoper: Starting plan execution tracking for plan ${planId}`);
+        // Merge dynamic config with defaults
+        const mergedDynamicConfig = {
+            ...DEFAULT_DYNAMIC_ITERATION_CONFIG,
+            ...dynamicConfig,
+        };
+        // Build task complexity map
+        const complexityMap = new Map();
+        if (taskComplexities) {
+            for (const { taskId, complexity } of taskComplexities) {
+                const maxIterations = calculateIterationsForComplexity(complexity, mergedDynamicConfig);
+                complexityMap.set(taskId, { taskId, complexity, maxIterations });
+                logger.debug(`IterationScoper: Task ${taskId} complexity ${complexity} -> ${maxIterations} max iterations`);
+            }
+        }
+        this.context = {
+            planId,
+            currentTaskId: null,
+            taskIterations: 0,
+            totalIterations: 0,
+            maxIterationsPerTask: maxPerTask,
+            currentTaskMaxIterations: maxPerTask,
+            taskStartIteration: 0,
+            taskComplexities: complexityMap,
+            dynamicConfig: mergedDynamicConfig,
+        };
+        this.taskIterationHistory.clear();
+        this.isActive = true;
+        // Subscribe to task boundary events
+        const eventEmitter = getEventEmitter();
+        // Task started event
+        const unsubTaskStarted = eventEmitter.on('plan-task-started', ({ planId: eventPlanId, taskId }) => {
+            if (eventPlanId === this.context.planId) {
+                this.onTaskStarted(taskId);
+            }
+        });
+        this.eventUnsubscribers.push(unsubTaskStarted);
+        // Task completed event
+        const unsubTaskCompleted = eventEmitter.on('plan-task-completed', ({ planId: eventPlanId, taskId, status }) => {
+            if (eventPlanId === this.context.planId) {
+                this.onTaskCompleted(taskId, status);
+            }
+        });
+        this.eventUnsubscribers.push(unsubTaskCompleted);
+        // Also subscribe to plan-task-progress as a fallback for task detection
+        const unsubTaskProgress = eventEmitter.on('plan-task-progress', ({ planId: eventPlanId, taskId }) => {
+            if (eventPlanId === this.context.planId && taskId !== this.context.currentTaskId) {
+                logger.debug(`IterationScoper: Detected task transition via plan-task-progress: ${taskId}`);
+                this.onTaskStarted(taskId);
+            }
+        });
+        this.eventUnsubscribers.push(unsubTaskProgress);
+        logger.info(`IterationScoper: Subscribed to task boundary events for plan ${planId}`);
+    }
+    /**
+     * Handles task started event - resets iteration counter for new task
+     *
+     * @param taskId - ID of the task that started
+     */
+    onTaskStarted(taskId) {
+        // Complete previous task if exists
+        if (this.context.currentTaskId) {
+            const prevTaskId = this.context.currentTaskId;
+            const record = this.taskIterationHistory.get(prevTaskId);
+            if (record && !record.completedAt) {
+                record.completedAt = Date.now();
+                logger.debug(`IterationScoper: Auto-completed previous task ${prevTaskId} with ${record.iterations} iterations`);
+            }
+        }
+        // Determine max iterations for this task (dynamic or default)
+        const taskComplexityInfo = this.context.taskComplexities.get(taskId);
+        const taskMaxIterations = taskComplexityInfo
+            ? taskComplexityInfo.maxIterations
+            : this.context.maxIterationsPerTask;
+        logger.info(`IterationScoper: Task started: ${taskId}, ` +
+            `complexity: ${taskComplexityInfo?.complexity ?? 'unknown'}, ` +
+            `max iterations: ${taskMaxIterations}, ` +
+            `resetting counter (was at ${this.context.taskIterations})`);
+        // Reset task-scoped counter and set dynamic max
+        this.context.currentTaskId = taskId;
+        this.context.taskIterations = 0;
+        this.context.currentTaskMaxIterations = taskMaxIterations;
+        this.context.taskStartIteration = this.context.totalIterations;
+        // Initialize history record
+        this.taskIterationHistory.set(taskId, {
+            taskId,
+            iterations: 0,
+            startedAt: Date.now(),
+        });
+    }
+    /**
+     * Registers task complexity information after plan execution has started.
+     * Useful when task complexities are determined dynamically during execution.
+     *
+     * @param taskId - Task ID
+     * @param complexity - Task complexity (1-10)
+     */
+    registerTaskComplexity(taskId, complexity) {
+        if (!this.isActive) {
+            logger.warn('IterationScoper: registerTaskComplexity called while not active');
+            return;
+        }
+        const maxIterations = calculateIterationsForComplexity(complexity, this.context.dynamicConfig);
+        this.context.taskComplexities.set(taskId, { taskId, complexity, maxIterations });
+        logger.debug(`IterationScoper: Registered task ${taskId} complexity ${complexity} -> ${maxIterations} max iterations`);
+        // If this is the current task, update its max iterations
+        if (this.context.currentTaskId === taskId) {
+            this.context.currentTaskMaxIterations = maxIterations;
+            logger.info(`IterationScoper: Updated current task max iterations to ${maxIterations}`);
+        }
+    }
+    /**
+     * Handles task completed event - finalizes task iteration record
+     *
+     * @param taskId - ID of the task that completed
+     * @param status - Final status of the task
+     */
+    onTaskCompleted(taskId, status) {
+        logger.info(`IterationScoper: Task completed: ${taskId} with status ${status}, used ${this.context.taskIterations} iterations`);
+        const record = this.taskIterationHistory.get(taskId);
+        if (record) {
+            record.completedAt = Date.now();
+            record.iterations = this.context.taskIterations;
+        }
+        // If this was the current task, clear it
+        if (this.context.currentTaskId === taskId) {
+            this.context.currentTaskId = null;
+            this.context.taskIterations = 0;
+        }
+    }
+    /**
+     * Checks if the current task should continue iterating based on its budget
+     *
+     * @param globalIterations - Current global iteration count (optional, for logging)
+     * @returns true if task has budget remaining, false otherwise
+     */
+    shouldContinueIteration(globalIterations) {
+        if (!this.isActive) {
+            // Not in plan mode, always allow iteration
+            return true;
+        }
+        // Use current task's dynamic max iterations
+        const maxIterations = this.context.currentTaskMaxIterations;
+        const canContinue = this.context.taskIterations < maxIterations;
+        if (!canContinue) {
+            const taskInfo = this.context.taskComplexities.get(this.context.currentTaskId || '');
+            logger.warn(`IterationScoper: Task ${this.context.currentTaskId} reached max iterations ` +
+                `(${this.context.taskIterations}/${maxIterations}` +
+                `${taskInfo ? `, complexity: ${taskInfo.complexity}` : ''}), ` +
+                `global: ${globalIterations || this.context.totalIterations}`);
+        }
+        return canContinue;
+    }
+    /**
+     * Increments both task-scoped and total iteration counters
+     */
+    incrementIteration() {
+        if (!this.isActive) {
+            // Not in plan mode, no-op
+            return;
+        }
+        this.context.taskIterations++;
+        this.context.totalIterations++;
+        // Update history record
+        if (this.context.currentTaskId) {
+            const record = this.taskIterationHistory.get(this.context.currentTaskId);
+            if (record) {
+                record.iterations = this.context.taskIterations;
+            }
+        }
+        logger.debug(`IterationScoper: Iteration incremented - Task: ${this.context.taskIterations}/${this.context.maxIterationsPerTask}, ` +
+            `Total: ${this.context.totalIterations}`);
+    }
+    /**
+     * Gets current iteration status for UI display
+     *
+     * @returns Iteration status information
+     */
+    getIterationStatus() {
+        const taskInfo = this.context.currentTaskId
+            ? this.context.taskComplexities.get(this.context.currentTaskId)
+            : undefined;
+        return {
+            task: this.context.currentTaskId || '',
+            iteration: this.context.taskIterations,
+            max: this.context.currentTaskMaxIterations,
+            total: this.context.totalIterations,
+            isActive: this.isActive,
+            complexity: taskInfo?.complexity,
+        };
+    }
+    /**
+     * Gets the complete task iteration history for logging
+     *
+     * @returns Map of task IDs to iteration records
+     */
+    getTaskIterationHistory() {
+        return new Map(this.taskIterationHistory);
+    }
+    /**
+     * Stops plan execution monitoring and cleans up event subscriptions
+     */
+    stopPlanExecution() {
+        if (!this.isActive) {
+            return;
+        }
+        logger.debug(`IterationScoper: Stopping plan execution tracking for plan ${this.context.planId}`);
+        // Complete current task if exists
+        if (this.context.currentTaskId) {
+            const record = this.taskIterationHistory.get(this.context.currentTaskId);
+            if (record && !record.completedAt) {
+                record.completedAt = Date.now();
+                record.iterations = this.context.taskIterations;
+            }
+        }
+        // Log final statistics
+        const taskCount = this.taskIterationHistory.size;
+        const avgIterations = taskCount > 0
+            ? Math.round(this.context.totalIterations / taskCount)
+            : 0;
+        logger.info(`IterationScoper: Plan execution complete - ` +
+            `Total tasks: ${taskCount}, ` +
+            `Total iterations: ${this.context.totalIterations}, ` +
+            `Avg per task: ${avgIterations}`);
+        // Unsubscribe from all events
+        for (const unsubscribe of this.eventUnsubscribers) {
+            unsubscribe();
+        }
+        this.eventUnsubscribers = [];
+        // Reset state
+        this.context = {
+            planId: null,
+            currentTaskId: null,
+            taskIterations: 0,
+            totalIterations: 0,
+            maxIterationsPerTask: DEFAULT_MAX_ITERATIONS_PER_TASK,
+            currentTaskMaxIterations: DEFAULT_MAX_ITERATIONS_PER_TASK,
+            taskStartIteration: 0,
+            taskComplexities: new Map(),
+            dynamicConfig: DEFAULT_DYNAMIC_ITERATION_CONFIG,
+        };
+        this.isActive = false;
+    }
+    /**
+     * Checks if currently in plan mode
+     *
+     * @returns true if plan execution is active
+     */
+    isInPlanMode() {
+        return this.isActive;
+    }
+    /**
+     * Gets the current plan ID (if in plan mode)
+     *
+     * @returns Current plan ID or null
+     */
+    getCurrentPlanId() {
+        return this.context.planId;
+    }
+    /**
+     * Gets the current task ID (if executing a task)
+     *
+     * @returns Current task ID or null
+     */
+    getCurrentTaskId() {
+        return this.context.currentTaskId;
+    }
+}
+// Singleton instance
+let instance = null;
+/**
+ * Gets the singleton IterationScoper instance
+ *
+ * @returns The global iteration scoper instance
+ */
+export function getIterationScoper() {
+    if (!instance) {
+        instance = new IterationScoper();
+    }
+    return instance;
+}
+/**
+ * Resets the singleton instance (for testing)
+ */
+export function resetIterationScoper() {
+    if (instance) {
+        instance.stopPlanExecution();
+    }
+    instance = null;
+}
+//# sourceMappingURL=iteration-scoper.js.map

package/dist/services/iteration-scoper.js.map

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

package/dist/services/llm-plan-generator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * LLM-Powered Plan Generator
+ *
+ * This module generates implementation plans using Claude AI instead of
+ * hardcoded pattern matching. It sends context about the project and user
+ * request to Claude and receives a structured ImplementationPlan in response.
+ */
+import type { ImplementationPlan, ContextGatheringResult, ComplexityClassificationResult, ClarificationResult } from '../types/workflow.js';
+/**
+ * Generates an implementation plan using Claude AI.
+ *
+ * @param userRequest - The user's original request
+ * @param context - Gathered project context
+ * @param complexity - Complexity classification results
+ * @param clarifications - Optional clarification results
+ * @param toolCallId - Optional tool call ID for status updates
+ * @returns A detailed implementation plan
+ */
+export declare function generatePlanWithLLM(userRequest: string, context: ContextGatheringResult, complexity: ComplexityClassificationResult, clarifications?: ClarificationResult, toolCallId?: string): Promise<ImplementationPlan>;
+/**
+ * Adopts a user-provided plan by validating and enriching it with technical details.
+ * Uses PLAN_ADOPT mode - preserves user's task structure, adds IDs/files/dependencies.
+ *
+ * @param userProvidedPlan - The user's structured plan input
+ * @param context - Gathered project context
+ * @param adoptedPlanSummary - Optional summary from classification of what was detected
+ * @param toolCallId - Optional tool call ID for status updates
+ * @returns An enriched implementation plan preserving user's structure
+ */
+export declare function adoptPlanWithLLM(userProvidedPlan: string, context: ContextGatheringResult, adoptedPlanSummary?: string, toolCallId?: string): Promise<ImplementationPlan>;
+/**
+ * Modifies an existing plan using the LLM.
+ * Preserves completed tasks and only updates affected portions.
+ *
+ * @param existingPlan - The current plan to modify
+ * @param modificationRequest - Description of what changes to make
+ * @param context - Gathered project context
+ * @param completedTaskIds - IDs of tasks already completed
+ * @param preserveCompleted - Whether to preserve completed tasks (default: true)
+ * @param toolCallId - Optional tool call ID for status updates
+ * @returns The updated implementation plan
+ */
+export declare function modifyPlanWithLLM(existingPlan: ImplementationPlan, modificationRequest: string, context: ContextGatheringResult, completedTaskIds: string[], preserveCompleted?: boolean, toolCallId?: string, skipContextInjection?: boolean): Promise<ImplementationPlan>;
+//# sourceMappingURL=llm-plan-generator.d.ts.map

package/dist/services/llm-plan-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-plan-generator.d.ts","sourceRoot":"","sources":["../../src/services/llm-plan-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,mBAAmB,EAMpB,MAAM,sBAAsB,CAAC;AA8Z9B;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,EAC/B,UAAU,EAAE,8BAA8B,EAC1C,cAAc,CAAC,EAAE,mBAAmB,EACpC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA+E7B;AAiLD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,sBAAsB,EAC/B,kBAAkB,CAAC,EAAE,MAAM,EAC3B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA8E7B;AAoGD;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,kBAAkB,EAChC,mBAAmB,EAAE,MAAM,EAC3B,OAAO,EAAE,sBAAsB,EAC/B,gBAAgB,EAAE,MAAM,EAAE,EAC1B,iBAAiB,GAAE,OAAc,EACjC,UAAU,CAAC,EAAE,MAAM,EACnB,oBAAoB,GAAE,OAAe,GACpC,OAAO,CAAC,kBAAkB,CAAC,CAyH7B"}