aicodeman 0.2.9 → 0.3.0

package/dist/ralph-plan-tracker.d.ts

@@ -0,0 +1,201 @@
+/**
+ * @fileoverview RalphPlanTracker - Enhanced plan task management
+ *
+ * Manages plan tasks with verification criteria, dependencies,
+ * execution tracking, TDD workflow support, and plan versioning.
+ *
+ * Extracted from ralph-tracker.ts as part of domain splitting.
+ *
+ * @module ralph-plan-tracker
+ */
+import { EventEmitter } from 'node:events';
+import type { PlanTaskStatus, TddPhase } from './types.js';
+/**
+ * Enhanced plan task with verification criteria, dependencies, and execution tracking.
+ * Supports TDD workflow, failure tracking, and plan versioning.
+ */
+export interface EnhancedPlanTask {
+    /** Unique identifier (e.g., "P0-001") */
+    id: string;
+    /** Task description */
+    content: string;
+    /** Criticality level */
+    priority: 'P0' | 'P1' | 'P2' | null;
+    /** How to verify completion */
+    verificationCriteria?: string;
+    /** Command to run for verification */
+    testCommand?: string;
+    /** IDs of tasks that must complete first */
+    dependencies: string[];
+    /** Current execution status */
+    status: PlanTaskStatus;
+    /** How many times attempted */
+    attempts: number;
+    /** Most recent failure reason */
+    lastError?: string;
+    /** Timestamp of completion */
+    completedAt?: number;
+    /** Plan version this belongs to */
+    version: number;
+    /** TDD phase category */
+    tddPhase?: TddPhase;
+    /** ID of paired test/impl task */
+    pairedWith?: string;
+    /** Estimated complexity */
+    complexity?: 'low' | 'medium' | 'high';
+    /** Checklist items for review tasks (tddPhase: 'review') */
+    reviewChecklist?: string[];
+}
+/** Checkpoint review data */
+export interface CheckpointReview {
+    iteration: number;
+    timestamp: number;
+    summary: {
+        total: number;
+        completed: number;
+        failed: number;
+        blocked: number;
+        pending: number;
+        inProgress: number;
+    };
+    stuckTasks: Array<{
+        id: string;
+        content: string;
+        attempts: number;
+        lastError?: string;
+    }>;
+    recommendations: string[];
+}
+/**
+ * RalphPlanTracker - Manages enhanced plan tasks with versioning and checkpoints.
+ *
+ * Events emitted:
+ * - `planInitialized` - When a new plan is initialized
+ * - `planTaskUpdate` - When a plan task is updated
+ * - `taskBlocked` - When a task becomes blocked after too many failures
+ * - `taskUnblocked` - When a task's dependencies are all met
+ * - `planCheckpoint` - When a checkpoint review is triggered
+ * - `planTaskAdded` - When a new task is added to the plan
+ * - `planRollback` - When the plan is rolled back to a previous version
+ */
+export declare class RalphPlanTracker extends EventEmitter {
+    /** Current version of the plan (incremented on changes) */
+    private _planVersion;
+    /** History of plan versions for rollback support */
+    private _planHistory;
+    /** Enhanced plan tasks with execution tracking */
+    private _planTasks;
+    /** Checkpoint intervals (iterations at which to trigger review) */
+    private _checkpointIterations;
+    /** Last checkpoint iteration */
+    private _lastCheckpointIteration;
+    /** Current cycle count (fed by parent via notifyCycleCount) */
+    private _cycleCount;
+    constructor();
+    /**
+     * Notify the plan tracker of the current cycle count.
+     * Called by parent when iteration changes (for checkpoint detection).
+     */
+    notifyCycleCount(cycleCount: number): void;
+    /**
+     * Initialize plan tasks from generated plan items.
+     * Called when wizard generates a new plan.
+     */
+    initializePlanTasks(items: Array<{
+        id?: string;
+        content: string;
+        priority?: 'P0' | 'P1' | 'P2' | null;
+        verificationCriteria?: string;
+        testCommand?: string;
+        dependencies?: string[];
+        tddPhase?: TddPhase;
+        pairedWith?: string;
+        complexity?: 'low' | 'medium' | 'high';
+    }>): void;
+    /**
+     * Update a specific plan task's status, attempts, or error.
+     */
+    updatePlanTask(taskId: string, update: {
+        status?: PlanTaskStatus;
+        error?: string;
+        incrementAttempts?: boolean;
+    }): {
+        success: boolean;
+        task?: EnhancedPlanTask;
+        error?: string;
+    };
+    /**
+     * Add a new task to the plan (for runtime adaptation).
+     */
+    addPlanTask(task: {
+        content: string;
+        priority?: 'P0' | 'P1' | 'P2';
+        verificationCriteria?: string;
+        dependencies?: string[];
+        insertAfter?: string;
+    }): {
+        task: EnhancedPlanTask;
+    };
+    /**
+     * Get all plan tasks.
+     */
+    getPlanTasks(): EnhancedPlanTask[];
+    /**
+     * Generate a checkpoint review summarizing plan progress and stuck tasks.
+     */
+    generateCheckpointReview(): CheckpointReview;
+    /**
+     * Get plan version history.
+     */
+    getPlanHistory(): Array<{
+        version: number;
+        timestamp: number;
+        summary: string;
+        stats: {
+            total: number;
+            completed: number;
+            failed: number;
+        };
+    }>;
+    /**
+     * Rollback to a previous plan version.
+     */
+    rollbackToVersion(version: number): {
+        success: boolean;
+        plan?: EnhancedPlanTask[];
+        error?: string;
+    };
+    /**
+     * Check if checkpoint review is due for current iteration.
+     */
+    isCheckpointDue(): boolean;
+    /**
+     * Get current plan version.
+     */
+    get planVersion(): number;
+    /**
+     * Reset plan state (soft reset - keeps version history).
+     */
+    reset(): void;
+    /**
+     * Full reset - clears all plan state.
+     */
+    fullReset(): void;
+    /**
+     * Clean up all resources.
+     */
+    destroy(): void;
+    /**
+     * Unblock tasks that were waiting on a completed dependency.
+     */
+    private _unblockDependentTasks;
+    /**
+     * Check if current iteration is a checkpoint and emit review if so.
+     */
+    private _checkForCheckpoint;
+    /**
+     * Save current plan state to history.
+     */
+    private _savePlanToHistory;
+}
+//# sourceMappingURL=ralph-plan-tracker.d.ts.map

package/dist/ralph-plan-tracker.d.ts.map

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

package/dist/ralph-plan-tracker.js

@@ -0,0 +1,325 @@
+/**
+ * @fileoverview RalphPlanTracker - Enhanced plan task management
+ *
+ * Manages plan tasks with verification criteria, dependencies,
+ * execution tracking, TDD workflow support, and plan versioning.
+ *
+ * Extracted from ralph-tracker.ts as part of domain splitting.
+ *
+ * @module ralph-plan-tracker
+ */
+import { EventEmitter } from 'node:events';
+const MAX_PLAN_HISTORY = 10;
+/**
+ * RalphPlanTracker - Manages enhanced plan tasks with versioning and checkpoints.
+ *
+ * Events emitted:
+ * - `planInitialized` - When a new plan is initialized
+ * - `planTaskUpdate` - When a plan task is updated
+ * - `taskBlocked` - When a task becomes blocked after too many failures
+ * - `taskUnblocked` - When a task's dependencies are all met
+ * - `planCheckpoint` - When a checkpoint review is triggered
+ * - `planTaskAdded` - When a new task is added to the plan
+ * - `planRollback` - When the plan is rolled back to a previous version
+ */
+export class RalphPlanTracker extends EventEmitter {
+    /** Current version of the plan (incremented on changes) */
+    _planVersion = 1;
+    /** History of plan versions for rollback support */
+    _planHistory = [];
+    /** Enhanced plan tasks with execution tracking */
+    _planTasks = new Map();
+    /** Checkpoint intervals (iterations at which to trigger review) */
+    _checkpointIterations = [5, 10, 20, 30, 50, 75, 100];
+    /** Last checkpoint iteration */
+    _lastCheckpointIteration = 0;
+    /** Current cycle count (fed by parent via notifyCycleCount) */
+    _cycleCount = 0;
+    constructor() {
+        super();
+    }
+    /**
+     * Notify the plan tracker of the current cycle count.
+     * Called by parent when iteration changes (for checkpoint detection).
+     */
+    notifyCycleCount(cycleCount) {
+        this._cycleCount = cycleCount;
+    }
+    /**
+     * Initialize plan tasks from generated plan items.
+     * Called when wizard generates a new plan.
+     */
+    initializePlanTasks(items) {
+        // Save current plan to history before replacing
+        if (this._planTasks.size > 0) {
+            this._savePlanToHistory('Plan replaced with new generation');
+        }
+        // Clear and rebuild
+        this._planTasks.clear();
+        this._planVersion++;
+        items.forEach((item, idx) => {
+            const id = item.id || `task-${idx}`;
+            const task = {
+                id,
+                content: item.content,
+                priority: item.priority || null,
+                verificationCriteria: item.verificationCriteria,
+                testCommand: item.testCommand,
+                dependencies: item.dependencies || [],
+                status: 'pending',
+                attempts: 0,
+                version: this._planVersion,
+                tddPhase: item.tddPhase,
+                pairedWith: item.pairedWith,
+                complexity: item.complexity,
+            };
+            this._planTasks.set(id, task);
+        });
+        this.emit('planInitialized', { version: this._planVersion, taskCount: this._planTasks.size });
+    }
+    /**
+     * Update a specific plan task's status, attempts, or error.
+     */
+    updatePlanTask(taskId, update) {
+        const task = this._planTasks.get(taskId);
+        if (!task) {
+            return { success: false, error: 'Task not found' };
+        }
+        if (update.status) {
+            task.status = update.status;
+            if (update.status === 'completed') {
+                task.completedAt = Date.now();
+            }
+        }
+        if (update.error) {
+            task.lastError = update.error;
+        }
+        if (update.incrementAttempts) {
+            task.attempts++;
+            // After 3 failed attempts, mark as blocked and emit warning
+            if (task.attempts >= 3 && task.status === 'failed') {
+                task.status = 'blocked';
+                this.emit('taskBlocked', {
+                    taskId,
+                    content: task.content,
+                    attempts: task.attempts,
+                    lastError: task.lastError,
+                });
+            }
+        }
+        // Update blocked tasks when a dependency completes
+        if (update.status === 'completed') {
+            this._unblockDependentTasks(taskId);
+        }
+        // Check for checkpoint
+        this._checkForCheckpoint();
+        this.emit('planTaskUpdate', { taskId, task });
+        return { success: true, task };
+    }
+    /**
+     * Add a new task to the plan (for runtime adaptation).
+     */
+    addPlanTask(task) {
+        // Generate unique ID
+        const existingIds = Array.from(this._planTasks.keys());
+        const prefix = task.priority || 'P1';
+        let counter = existingIds.filter((id) => id.startsWith(prefix)).length + 1;
+        let id = `${prefix}-${String(counter).padStart(3, '0')}`;
+        while (this._planTasks.has(id)) {
+            counter++;
+            id = `${prefix}-${String(counter).padStart(3, '0')}`;
+        }
+        const newTask = {
+            id,
+            content: task.content,
+            priority: task.priority || null,
+            verificationCriteria: task.verificationCriteria || 'Task completed successfully',
+            dependencies: task.dependencies || [],
+            status: 'pending',
+            attempts: 0,
+            version: this._planVersion,
+        };
+        this._planTasks.set(id, newTask);
+        this.emit('planTaskAdded', { task: newTask });
+        return { task: newTask };
+    }
+    /**
+     * Get all plan tasks.
+     */
+    getPlanTasks() {
+        return Array.from(this._planTasks.values());
+    }
+    /**
+     * Generate a checkpoint review summarizing plan progress and stuck tasks.
+     */
+    generateCheckpointReview() {
+        const tasks = Array.from(this._planTasks.values());
+        const summary = {
+            total: tasks.length,
+            completed: tasks.filter((t) => t.status === 'completed').length,
+            failed: tasks.filter((t) => t.status === 'failed').length,
+            blocked: tasks.filter((t) => t.status === 'blocked').length,
+            pending: tasks.filter((t) => t.status === 'pending').length,
+            inProgress: tasks.filter((t) => t.status === 'in_progress').length,
+        };
+        // Find stuck tasks (3+ attempts or blocked)
+        const stuckTasks = tasks
+            .filter((t) => t.attempts >= 3 || t.status === 'blocked')
+            .map((t) => ({
+            id: t.id,
+            content: t.content,
+            attempts: t.attempts,
+            lastError: t.lastError,
+        }));
+        // Generate recommendations
+        const recommendations = [];
+        if (stuckTasks.length > 0) {
+            recommendations.push(`${stuckTasks.length} task(s) are stuck. Consider breaking them into smaller steps.`);
+        }
+        if (summary.failed > summary.completed && summary.total > 5) {
+            recommendations.push('More tasks have failed than completed. Review approach and consider plan adjustment.');
+        }
+        const progressPercent = summary.total > 0 ? Math.round((summary.completed / summary.total) * 100) : 0;
+        if (progressPercent < 20 && this._cycleCount > 10) {
+            recommendations.push('Progress is slow. Consider simplifying tasks or reviewing dependencies.');
+        }
+        if (summary.total > 0 && summary.blocked > summary.total / 3) {
+            recommendations.push('Many tasks are blocked. Review dependency chain for bottlenecks.');
+        }
+        return {
+            iteration: this._cycleCount,
+            timestamp: Date.now(),
+            summary,
+            stuckTasks,
+            recommendations,
+        };
+    }
+    /**
+     * Get plan version history.
+     */
+    getPlanHistory() {
+        return this._planHistory.map((h) => {
+            const tasks = Array.from(h.tasks.values());
+            return {
+                version: h.version,
+                timestamp: h.timestamp,
+                summary: h.summary,
+                stats: {
+                    total: tasks.length,
+                    completed: tasks.filter((t) => t.status === 'completed').length,
+                    failed: tasks.filter((t) => t.status === 'failed').length,
+                },
+            };
+        });
+    }
+    /**
+     * Rollback to a previous plan version.
+     */
+    rollbackToVersion(version) {
+        const historyEntry = this._planHistory.find((h) => h.version === version);
+        if (!historyEntry) {
+            return { success: false, error: `Version ${version} not found in history` };
+        }
+        // Save current state first
+        this._savePlanToHistory(`Rolled back from v${this._planVersion} to v${version}`);
+        // Restore the historical version
+        this._planTasks.clear();
+        for (const [id, task] of historyEntry.tasks) {
+            // Reset execution state for retry
+            this._planTasks.set(id, {
+                ...task,
+                status: task.status === 'completed' ? 'completed' : 'pending',
+                attempts: task.status === 'completed' ? task.attempts : 0,
+                lastError: undefined,
+            });
+        }
+        this._planVersion++;
+        this.emit('planRollback', { version, newVersion: this._planVersion });
+        return { success: true, plan: Array.from(this._planTasks.values()) };
+    }
+    /**
+     * Check if checkpoint review is due for current iteration.
+     */
+    isCheckpointDue() {
+        return this._checkpointIterations.includes(this._cycleCount) && this._cycleCount > this._lastCheckpointIteration;
+    }
+    /**
+     * Get current plan version.
+     */
+    get planVersion() {
+        return this._planVersion;
+    }
+    /**
+     * Reset plan state (soft reset - keeps version history).
+     */
+    reset() {
+        // Don't clear history or version on soft reset
+    }
+    /**
+     * Full reset - clears all plan state.
+     */
+    fullReset() {
+        this._planTasks.clear();
+        this._planHistory.length = 0;
+        this._planVersion = 1;
+        this._lastCheckpointIteration = 0;
+        this._cycleCount = 0;
+    }
+    /**
+     * Clean up all resources.
+     */
+    destroy() {
+        this._planTasks.clear();
+        this._planHistory.length = 0;
+        this.removeAllListeners();
+    }
+    /**
+     * Unblock tasks that were waiting on a completed dependency.
+     */
+    _unblockDependentTasks(completedTaskId) {
+        for (const [_, task] of this._planTasks) {
+            if (task.dependencies.includes(completedTaskId)) {
+                // Check if all dependencies are now complete
+                const allDepsComplete = task.dependencies.every((depId) => {
+                    const dep = this._planTasks.get(depId);
+                    return dep && dep.status === 'completed';
+                });
+                if (allDepsComplete && task.status === 'blocked') {
+                    task.status = 'pending';
+                    this.emit('taskUnblocked', { taskId: task.id });
+                }
+            }
+        }
+    }
+    /**
+     * Check if current iteration is a checkpoint and emit review if so.
+     */
+    _checkForCheckpoint() {
+        if (this._checkpointIterations.includes(this._cycleCount) && this._cycleCount > this._lastCheckpointIteration) {
+            this._lastCheckpointIteration = this._cycleCount;
+            const checkpoint = this.generateCheckpointReview();
+            this.emit('planCheckpoint', checkpoint);
+        }
+    }
+    /**
+     * Save current plan state to history.
+     */
+    _savePlanToHistory(summary) {
+        // Clone current tasks
+        const tasksCopy = new Map();
+        for (const [id, task] of this._planTasks) {
+            tasksCopy.set(id, { ...task });
+        }
+        this._planHistory.push({
+            version: this._planVersion,
+            timestamp: Date.now(),
+            tasks: tasksCopy,
+            summary,
+        });
+        // Limit history size
+        if (this._planHistory.length > MAX_PLAN_HISTORY) {
+            this._planHistory.shift();
+        }
+    }
+}
+//# sourceMappingURL=ralph-plan-tracker.js.map

package/dist/ralph-plan-tracker.js.map

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

package/dist/ralph-stall-detector.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview RalphStallDetector - Iteration stall detection
+ *
+ * Monitors iteration progress and emits warnings when the loop
+ * appears to be stalled (no iteration changes for extended periods).
+ *
+ * Extracted from ralph-tracker.ts as part of domain splitting.
+ *
+ * @module ralph-stall-detector
+ */
+import { EventEmitter } from 'node:events';
+/**
+ * RalphStallDetector - Detects iteration stalls in the Ralph loop.
+ *
+ * Events emitted:
+ * - `iterationStallWarning` - When iteration hasn't changed for warning threshold
+ * - `iterationStallCritical` - When iteration hasn't changed for critical threshold
+ */
+export declare class RalphStallDetector extends EventEmitter {
+    /** Timestamp when iteration count last changed */
+    private _lastIterationChangeTime;
+    /** Last observed iteration count for stall detection */
+    private _lastObservedIteration;
+    /** Timer for iteration stall detection */
+    private _iterationStallTimer;
+    /** Iteration stall warning threshold (ms) - default 10 minutes */
+    private _iterationStallWarningMs;
+    /** Iteration stall critical threshold (ms) - default 20 minutes */
+    private _iterationStallCriticalMs;
+    /** Whether stall warning has been emitted */
+    private _iterationStallWarned;
+    /** Whether the loop is currently active */
+    private _loopActive;
+    constructor();
+    /**
+     * Start iteration stall detection timer.
+     * Should be called when the loop becomes active.
+     */
+    startIterationStallDetection(): void;
+    /**
+     * Stop iteration stall detection timer.
+     */
+    stopIterationStallDetection(): void;
+    /**
+     * Notify the detector that the iteration has changed.
+     * Resets stall tracking state.
+     */
+    notifyIterationChanged(iteration: number): void;
+    /**
+     * Set whether the loop is currently active.
+     * Stall detection only fires when loop is active.
+     */
+    setLoopActive(active: boolean): void;
+    /**
+     * Check for iteration stall and emit appropriate events.
+     */
+    private checkIterationStall;
+    /**
+     * Get iteration stall metrics for monitoring.
+     */
+    getIterationStallMetrics(): {
+        lastIterationChangeTime: number;
+        stallDurationMs: number;
+        warningThresholdMs: number;
+        criticalThresholdMs: number;
+        isWarned: boolean;
+        currentIteration: number;
+    };
+    /**
+     * Configure iteration stall thresholds.
+     * @param warningMs - Warning threshold in milliseconds
+     * @param criticalMs - Critical threshold in milliseconds
+     */
+    configureIterationStallThresholds(warningMs: number, criticalMs: number): void;
+    /**
+     * Reset stall detector state.
+     */
+    reset(): void;
+    /**
+     * Clean up all resources.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=ralph-stall-detector.d.ts.map

package/dist/ralph-stall-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-stall-detector.d.ts","sourceRoot":"","sources":["../src/ralph-stall-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,kDAAkD;IAClD,OAAO,CAAC,wBAAwB,CAAa;IAE7C,wDAAwD;IACxD,OAAO,CAAC,sBAAsB,CAAa;IAE3C,0CAA0C;IAC1C,OAAO,CAAC,oBAAoB,CAA+B;IAE3D,kEAAkE;IAClE,OAAO,CAAC,wBAAwB,CAA0B;IAE1D,mEAAmE;IACnE,OAAO,CAAC,yBAAyB,CAA0B;IAE3D,6CAA6C;IAC7C,OAAO,CAAC,qBAAqB,CAAkB;IAE/C,2CAA2C;IAC3C,OAAO,CAAC,WAAW,CAAkB;;IAOrC;;;OAGG;IACH,4BAA4B,IAAI,IAAI;IAWpC;;OAEG;IACH,2BAA2B,IAAI,IAAI;IAOnC;;;OAGG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAM/C;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,wBAAwB,IAAI;QAC1B,uBAAuB,EAAE,MAAM,CAAC;QAChC,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,QAAQ,EAAE,OAAO,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAWD;;;;OAIG;IACH,iCAAiC,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAK9E;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}