mcp-agent-foundry 1.0.0

package/dist/tasks/persistent-state-coordinator.js

@@ -0,0 +1,371 @@
+/**
+ * Persistent State Coordinator
+ *
+ * Extends StateCoordinator to automatically persist all state changes
+ * to disk using StateStore. Supports state restoration on initialization.
+ */
+import { StateCoordinator } from './state-coordinator.js';
+import { createLogger } from '../observability/logger.js';
+const logger = createLogger({ name: 'persistent-state-coordinator' });
+/**
+ * PersistentStateCoordinator extends StateCoordinator with automatic
+ * state persistence. All state changes are automatically saved to disk
+ * via the StateStore, and state is restored on initialization.
+ *
+ * @example
+ * ```typescript
+ * const stateStore = new StateStore({ stateDir: '.agent-foundry' });
+ * const coordinator = new PersistentStateCoordinator(stateStore, '/path/to/repo');
+ *
+ * await coordinator.initialize();
+ *
+ * // All state changes are automatically persisted
+ * coordinator.createTask('task-1', 'coder');
+ * coordinator.startTask('task-1');
+ *
+ * // Clean shutdown ensures all pending writes complete
+ * await coordinator.shutdown();
+ * ```
+ */
+export class PersistentStateCoordinator extends StateCoordinator {
+    stateStore;
+    repoPath;
+    initialized = false;
+    constructor(stateStore, repoPath) {
+        super();
+        this.stateStore = stateStore;
+        this.repoPath = repoPath;
+        this.setupPersistenceHooks();
+    }
+    /**
+     * Initialize the coordinator - load persisted state and restore it.
+     */
+    async initialize() {
+        if (this.initialized) {
+            logger.warn('PersistentStateCoordinator already initialized');
+            return;
+        }
+        await this.stateStore.initialize(this.repoPath);
+        this.restoreFromPersistedState();
+        this.initialized = true;
+        logger.info('PersistentStateCoordinator initialized', {
+            repoPath: this.repoPath,
+            stats: this.getStats(),
+        });
+    }
+    /**
+     * Check if the coordinator has been initialized.
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Setup event listeners to persist state changes.
+     * Called in constructor before initialize.
+     */
+    setupPersistenceHooks() {
+        // Task lifecycle events
+        this.on('task:created', (task) => {
+            this.persistTaskCreated(task);
+        });
+        this.on('task:started', (task) => {
+            this.persistTaskUpdated(task);
+        });
+        this.on('task:completed', (task) => {
+            this.persistTaskUpdated(task);
+        });
+        this.on('task:failed', (task) => {
+            this.persistTaskUpdated(task);
+        });
+        // Worktree linking events
+        this.on('worktree:linked', (taskId, worktreeId) => {
+            this.persistWorktreeLink(taskId, worktreeId);
+        });
+        this.on('worktree:unlinked', (taskId, worktreeId) => {
+            this.persistWorktreeUnlink(taskId, worktreeId);
+        });
+        // Conflict events
+        this.on('conflict:detected', (taskId, state) => {
+            this.persistConflictDetected(taskId, state);
+        });
+        this.on('conflict:resolved', (taskId, state) => {
+            this.persistConflictResolved(taskId, state);
+        });
+    }
+    /**
+     * Restore in-memory state from persisted state.
+     * Handles stale/orphaned entries gracefully.
+     */
+    restoreFromPersistedState() {
+        const persistedState = this.stateStore.getState();
+        // Restore tasks
+        let restoredTasks = 0;
+        let skippedTasks = 0;
+        for (const persistedTask of persistedState.tasks) {
+            // Skip tasks in terminal states that are old (cleanup can handle them)
+            if ((persistedTask.status === 'completed' || persistedTask.status === 'failed') &&
+                Date.now() - persistedTask.updatedAt > 24 * 60 * 60 * 1000 // 24 hours
+            ) {
+                skippedTasks++;
+                continue;
+            }
+            // Recreate task via parent class createTask, then update status
+            // We need to access the internal maps, so we use the parent methods carefully
+            const task = super.createTask(persistedTask.taskId, persistedTask.role);
+            // Update task fields to match persisted state
+            if (persistedTask.status === 'running') {
+                super.startTask(persistedTask.taskId);
+            }
+            else if (persistedTask.status === 'completed') {
+                // Need to set startedAt first for proper state
+                const internalTask = super.getTask(persistedTask.taskId);
+                if (internalTask) {
+                    internalTask.startedAt = persistedTask.createdAt;
+                }
+                super.completeTask(persistedTask.taskId);
+            }
+            else if (persistedTask.status === 'failed') {
+                const internalTask = super.getTask(persistedTask.taskId);
+                if (internalTask) {
+                    internalTask.startedAt = persistedTask.createdAt;
+                }
+                super.failTask(persistedTask.taskId, persistedTask.error || 'Unknown error');
+            }
+            restoredTasks++;
+        }
+        // Restore worktree links
+        let restoredLinks = 0;
+        for (const persistedWorktree of persistedState.worktrees) {
+            if (persistedWorktree.taskId) {
+                const task = super.getTask(persistedWorktree.taskId);
+                if (task) {
+                    try {
+                        super.linkTaskToWorktree(persistedWorktree.taskId, persistedWorktree.id);
+                        restoredLinks++;
+                    }
+                    catch (error) {
+                        logger.warn('Failed to restore worktree link', {
+                            taskId: persistedWorktree.taskId,
+                            worktreeId: persistedWorktree.id,
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                    }
+                }
+            }
+        }
+        // Restore conflicts
+        let restoredConflicts = 0;
+        for (const persistedConflict of persistedState.conflicts) {
+            // Only restore unresolved conflicts for active tasks
+            if (!persistedConflict.resolved) {
+                const task = super.getTask(persistedConflict.taskId);
+                if (task) {
+                    const conflictState = {
+                        taskId: persistedConflict.taskId,
+                        worktreeId: persistedConflict.worktreeId,
+                        detectedAt: persistedConflict.detectedAt,
+                        files: persistedConflict.files.map(file => ({
+                            file,
+                            conflicts: [], // Full conflict markers not persisted
+                            totalConflicts: 1,
+                        })),
+                        totalConflicts: persistedConflict.files.length,
+                        resolved: persistedConflict.resolved,
+                        resolutionStrategy: persistedConflict.strategy,
+                        resolvedAt: persistedConflict.resolvedAt,
+                    };
+                    super.setConflictState(persistedConflict.taskId, conflictState);
+                    restoredConflicts++;
+                }
+            }
+        }
+        logger.info('State restored from persistence', {
+            restoredTasks,
+            skippedTasks,
+            restoredLinks,
+            restoredConflicts,
+        });
+    }
+    // ==========================================================================
+    // Persistence Methods
+    // ==========================================================================
+    /**
+     * Persist a newly created task.
+     */
+    persistTaskCreated(task) {
+        const now = Date.now();
+        this.stateStore.updateState((state) => {
+            // Check if task already exists (shouldn't happen, but be safe)
+            const existingIndex = state.tasks.findIndex(t => t.taskId === task.taskId);
+            if (existingIndex !== -1) {
+                state.tasks[existingIndex] = this.toPersistedTask(task, now);
+            }
+            else {
+                state.tasks.push(this.toPersistedTask(task, now));
+            }
+        });
+        logger.debug('Persisted task creation', { taskId: task.taskId });
+    }
+    /**
+     * Persist a task status update.
+     */
+    persistTaskUpdated(task) {
+        const now = Date.now();
+        this.stateStore.updateState((state) => {
+            const index = state.tasks.findIndex(t => t.taskId === task.taskId);
+            if (index !== -1) {
+                state.tasks[index] = {
+                    ...state.tasks[index],
+                    status: task.status,
+                    worktreeId: task.worktreeId,
+                    updatedAt: now,
+                    error: task.error,
+                };
+            }
+            else {
+                // Task doesn't exist in persisted state, create it
+                state.tasks.push(this.toPersistedTask(task, now));
+            }
+        });
+        logger.debug('Persisted task update', { taskId: task.taskId, status: task.status });
+    }
+    /**
+     * Persist a worktree link.
+     */
+    persistWorktreeLink(taskId, worktreeId) {
+        const now = Date.now();
+        this.stateStore.updateState((state) => {
+            // Update task's worktreeId
+            const taskIndex = state.tasks.findIndex(t => t.taskId === taskId);
+            if (taskIndex !== -1) {
+                state.tasks[taskIndex].worktreeId = worktreeId;
+                state.tasks[taskIndex].updatedAt = now;
+            }
+            // Find or create worktree entry
+            const worktreeIndex = state.worktrees.findIndex(w => w.id === worktreeId);
+            if (worktreeIndex !== -1) {
+                state.worktrees[worktreeIndex].taskId = taskId;
+                state.worktrees[worktreeIndex].lastActivityAt = now;
+            }
+            else {
+                // Create minimal worktree entry if it doesn't exist
+                // This handles cases where worktree was created outside the coordinator
+                state.worktrees.push({
+                    id: worktreeId,
+                    path: '', // Will be populated by worktree manager
+                    branch: '',
+                    baseBranch: '',
+                    status: 'assigned',
+                    taskId,
+                    createdAt: now,
+                    lastActivityAt: now,
+                });
+            }
+        });
+        logger.debug('Persisted worktree link', { taskId, worktreeId });
+    }
+    /**
+     * Persist a worktree unlink.
+     */
+    persistWorktreeUnlink(taskId, worktreeId) {
+        const now = Date.now();
+        this.stateStore.updateState((state) => {
+            // Clear task's worktreeId
+            const taskIndex = state.tasks.findIndex(t => t.taskId === taskId);
+            if (taskIndex !== -1) {
+                state.tasks[taskIndex].worktreeId = undefined;
+                state.tasks[taskIndex].updatedAt = now;
+            }
+            // Clear worktree's taskId
+            const worktreeIndex = state.worktrees.findIndex(w => w.id === worktreeId);
+            if (worktreeIndex !== -1) {
+                state.worktrees[worktreeIndex].taskId = undefined;
+                state.worktrees[worktreeIndex].status = 'available';
+                state.worktrees[worktreeIndex].lastActivityAt = now;
+            }
+        });
+        logger.debug('Persisted worktree unlink', { taskId, worktreeId });
+    }
+    /**
+     * Persist a conflict detection.
+     */
+    persistConflictDetected(taskId, conflictState) {
+        const now = Date.now();
+        this.stateStore.updateState((state) => {
+            // Check if conflict already exists for this task
+            const existingIndex = state.conflicts.findIndex(c => c.taskId === taskId);
+            const persistedConflict = {
+                taskId: conflictState.taskId,
+                worktreeId: conflictState.worktreeId,
+                files: conflictState.files.map(f => f.file),
+                resolved: conflictState.resolved,
+                strategy: conflictState.resolutionStrategy,
+                detectedAt: conflictState.detectedAt,
+                resolvedAt: conflictState.resolvedAt,
+            };
+            if (existingIndex !== -1) {
+                state.conflicts[existingIndex] = persistedConflict;
+            }
+            else {
+                state.conflicts.push(persistedConflict);
+            }
+        });
+        logger.debug('Persisted conflict detection', { taskId, files: conflictState.files.length });
+    }
+    /**
+     * Persist a conflict resolution.
+     */
+    persistConflictResolved(taskId, conflictState) {
+        this.stateStore.updateState((state) => {
+            const index = state.conflicts.findIndex(c => c.taskId === taskId);
+            if (index !== -1) {
+                state.conflicts[index] = {
+                    ...state.conflicts[index],
+                    resolved: true,
+                    strategy: conflictState.resolutionStrategy,
+                    resolvedAt: conflictState.resolvedAt || Date.now(),
+                };
+            }
+        });
+        logger.debug('Persisted conflict resolution', { taskId });
+    }
+    // ==========================================================================
+    // Helper Methods
+    // ==========================================================================
+    /**
+     * Convert TaskState to PersistedTaskState.
+     */
+    toPersistedTask(task, timestamp) {
+        return {
+            taskId: task.taskId,
+            role: task.role,
+            status: task.status,
+            worktreeId: task.worktreeId,
+            createdAt: task.startedAt || timestamp,
+            updatedAt: timestamp,
+            error: task.error,
+        };
+    }
+    // ==========================================================================
+    // Shutdown
+    // ==========================================================================
+    /**
+     * Shutdown the coordinator and ensure all state is persisted.
+     */
+    async shutdown() {
+        if (!this.initialized) {
+            logger.warn('PersistentStateCoordinator not initialized, skipping shutdown');
+            return;
+        }
+        await this.stateStore.shutdown(this.repoPath);
+        this.initialized = false;
+        logger.info('PersistentStateCoordinator shutdown complete');
+    }
+    /**
+     * Force an immediate save of all pending state changes.
+     */
+    async saveNow() {
+        await this.stateStore.saveNow(this.repoPath);
+    }
+}
+//# sourceMappingURL=persistent-state-coordinator.js.map

package/dist/tasks/persistent-state-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-state-coordinator.js","sourceRoot":"","sources":["../../src/tasks/persistent-state-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAkB,MAAM,wBAAwB,CAAC;AAS1E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IAC7C,UAAU,CAAa;IACvB,QAAQ,CAAS;IAC1B,WAAW,GAAY,KAAK,CAAC;IAErC,YAAY,UAAsB,EAAE,QAAgB;QAClD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAExB,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE;YACpD,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACK,qBAAqB;QAC3B,wBAAwB;QACxB,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,IAAe,EAAE,EAAE;YAC1C,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,IAAe,EAAE,EAAE;YAC1C,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,IAAe,EAAE,EAAE;YAC5C,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,IAAe,EAAE,EAAE;YACzC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,0BAA0B;QAC1B,IAAI,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,MAAc,EAAE,UAAkB,EAAE,EAAE;YAChE,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,MAAc,EAAE,UAAkB,EAAE,EAAE;YAClE,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,kBAAkB;QAClB,IAAI,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,MAAc,EAAE,KAAoB,EAAE,EAAE;YACpE,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,MAAc,EAAE,KAAoB,EAAE,EAAE;YACpE,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,yBAAyB;QAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QAElD,gBAAgB;QAChB,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,KAAK,MAAM,aAAa,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,uEAAuE;YACvE,IACE,CAAC,aAAa,CAAC,MAAM,KAAK,WAAW,IAAI,aAAa,CAAC,MAAM,KAAK,QAAQ,CAAC;gBAC3E,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW;cACtE,CAAC;gBACD,YAAY,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YAED,gEAAgE;YAChE,8EAA8E;YAC9E,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;YAExE,8CAA8C;YAC9C,IAAI,aAAa,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvC,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC;iBAAM,IAAI,aAAa,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAChD,+CAA+C;gBAC/C,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;gBACzD,IAAI,YAAY,EAAE,CAAC;oBACjB,YAAY,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC;gBACnD,CAAC;gBACD,KAAK,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;iBAAM,IAAI,aAAa,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC7C,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;gBACzD,IAAI,YAAY,EAAE,CAAC;oBACjB,YAAY,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC;gBACnD,CAAC;gBACD,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,IAAI,eAAe,CAAC,CAAC;YAC/E,CAAC;YAED,aAAa,EAAE,CAAC;QAClB,CAAC;QAED,yBAAyB;QACzB,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,KAAK,MAAM,iBAAiB,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC;YACzD,IAAI,iBAAiB,CAAC,MAAM,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBACrD,IAAI,IAAI,EAAE,CAAC;oBACT,IAAI,CAAC;wBACH,KAAK,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;wBACzE,aAAa,EAAE,CAAC;oBAClB,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;4BAC7C,MAAM,EAAE,iBAAiB,CAAC,MAAM;4BAChC,UAAU,EAAE,iBAAiB,CAAC,EAAE;4BAChC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAC9D,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,KAAK,MAAM,iBAAiB,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC;YACzD,qDAAqD;YACrD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBACrD,IAAI,IAAI,EAAE,CAAC;oBACT,MAAM,aAAa,GAAkB;wBACnC,MAAM,EAAE,iBAAiB,CAAC,MAAM;wBAChC,UAAU,EAAE,iBAAiB,CAAC,UAAU;wBACxC,UAAU,EAAE,iBAAiB,CAAC,UAAU;wBACxC,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;4BAC1C,IAAI;4BACJ,SAAS,EAAE,EAAE,EAAE,sCAAsC;4BACrD,cAAc,EAAE,CAAC;yBAClB,CAAC,CAAC;wBACH,cAAc,EAAE,iBAAiB,CAAC,KAAK,CAAC,MAAM;wBAC9C,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;wBACpC,kBAAkB,EAAE,iBAAiB,CAAC,QAA+C;wBACrF,UAAU,EAAE,iBAAiB,CAAC,UAAU;qBACzC,CAAC;oBACF,KAAK,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;oBAChE,iBAAiB,EAAE,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;YAC7C,aAAa;YACb,YAAY;YACZ,aAAa;YACb,iBAAiB;SAClB,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,sBAAsB;IACtB,6EAA6E;IAE7E;;OAEG;IACK,kBAAkB,CAAC,IAAe;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,KAAqB,EAAE,EAAE;YACpD,+DAA+D;YAC/D,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3E,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,IAAe;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,KAAqB,EAAE,EAAE;YACpD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;YACnE,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG;oBACnB,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,SAAS,EAAE,GAAG;oBACd,KAAK,EAAE,IAAI,CAAC,KAAK;iBAClB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,mDAAmD;gBACnD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,MAAc,EAAE,UAAkB;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,KAAqB,EAAE,EAAE;YACpD,2BAA2B;YAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;YAClE,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;gBACrB,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC;gBAC/C,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC;YACzC,CAAC;YAED,gCAAgC;YAChC,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;YAC1E,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;gBAC/C,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,cAAc,GAAG,GAAG,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,oDAAoD;gBACpD,wEAAwE;gBACxE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;oBACnB,EAAE,EAAE,UAAU;oBACd,IAAI,EAAE,EAAE,EAAE,wCAAwC;oBAClD,MAAM,EAAE,EAAE;oBACV,UAAU,EAAE,EAAE;oBACd,MAAM,EAAE,UAAU;oBAClB,MAAM;oBACN,SAAS,EAAE,GAAG;oBACd,cAAc,EAAE,GAAG;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,MAAc,EAAE,UAAkB;QAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,KAAqB,EAAE,EAAE;YACpD,0BAA0B;YAC1B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;YAClE,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;gBACrB,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC;gBAC9C,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC;YACzC,CAAC;YAED,0BAA0B;YAC1B,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;YAC1E,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC;gBAClD,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC;gBACpD,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,cAAc,GAAG,GAAG,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,MAAc,EAAE,aAA4B;QAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,KAAqB,EAAE,EAAE;YACpD,iDAAiD;YACjD,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;YAC1E,MAAM,iBAAiB,GAA2B;gBAChD,MAAM,EAAE,aAAa,CAAC,MAAM;gBAC5B,UAAU,EAAE,aAAa,CAAC,UAAU;gBACpC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC3C,QAAQ,EAAE,aAAa,CAAC,QAAQ;gBAChC,QAAQ,EAAE,aAAa,CAAC,kBAAkB;gBAC1C,UAAU,EAAE,aAAa,CAAC,UAAU;gBACpC,UAAU,EAAE,aAAa,CAAC,UAAU;aACrC,CAAC;YAEF,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,iBAAiB,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,MAAc,EAAE,aAA4B;QAC1E,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,KAAqB,EAAE,EAAE;YACpD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;YAClE,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;oBACvB,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC;oBACzB,QAAQ,EAAE,IAAI;oBACd,QAAQ,EAAE,aAAa,CAAC,kBAAkB;oBAC1C,UAAU,EAAE,aAAa,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE;iBACnD,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,6EAA6E;IAC7E,iBAAiB;IACjB,6EAA6E;IAE7E;;OAEG;IACK,eAAe,CAAC,IAAe,EAAE,SAAiB;QACxD,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS;YACtC,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,WAAW;IACX,6EAA6E;IAE7E;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/tasks/pipeline-manager.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Pipeline Manager
+ *
+ * Manages multi-step task DAGs with dependency resolution.
+ * Generates TaskCreate instructions for Claude to execute.
+ */
+import type { Logger } from "../observability/logger.js";
+import type { WorktreeManager } from "../worktrees/manager.js";
+import type { AgentResponse, PipelineDefinition, PipelineExecution, PipelineStep, StepWorktreeAllocation } from "../types.js";
+export declare class PipelineManager {
+    private executions;
+    private stepWorktrees;
+    private logger;
+    constructor(logger: Logger);
+    /**
+     * Allocate a worktree for a pipeline step.
+     */
+    allocateWorktreeForStep(stepId: string, allocation: StepWorktreeAllocation): void;
+    /**
+     * Get the worktree allocation for a step.
+     */
+    getStepWorktree(stepId: string): StepWorktreeAllocation | undefined;
+    /**
+     * Get all allocated worktrees.
+     */
+    getAllocatedWorktrees(): Map<string, StepWorktreeAllocation>;
+    /**
+     * Update the status of a step's worktree allocation.
+     */
+    updateStepWorktreeStatus(stepId: string, status: StepWorktreeAllocation['status']): void;
+    /**
+     * Validate pipeline definition for cycles and missing dependencies.
+     * Uses topological sort (Kahn's algorithm) to detect cycles.
+     * @throws Error if validation fails
+     */
+    validateDefinition(definition: PipelineDefinition): void;
+    /**
+     * Generate TaskCreate instructions for all pipeline steps.
+     * Returns a string with all the TaskCreate calls Claude should execute.
+     */
+    generatePipelineCreation(definition: PipelineDefinition): string;
+    /**
+     * Create a new pipeline execution tracker.
+     */
+    createExecution(definition: PipelineDefinition): PipelineExecution;
+    /**
+     * Get a pipeline execution by ID.
+     */
+    getExecution(pipelineId: string): PipelineExecution | undefined;
+    /**
+     * Register task IDs after Claude creates the tasks.
+     */
+    registerTaskIds(pipelineId: string, taskIdMap: Map<string, string>): void;
+    /**
+     * Determine which steps are ready to execute (all dependencies complete).
+     */
+    getReadySteps(execution: PipelineExecution): PipelineStep[];
+    /**
+     * Mark a step as completed with its result.
+     */
+    completeStep(pipelineId: string, stepName: string, result: AgentResponse): void;
+    /**
+     * Mark a step as failed.
+     */
+    failStep(pipelineId: string, stepName: string, error: Error): void;
+    /**
+     * Build context for a step, including results from completed dependencies.
+     * Truncates if total context exceeds MAX_CONTEXT_LENGTH.
+     */
+    buildStepContext(execution: PipelineExecution, step: PipelineStep): string;
+    /**
+     * Get all active pipeline executions.
+     */
+    getActiveExecutions(): PipelineExecution[];
+    /**
+     * Cleanup worktrees after successful pipeline merge.
+     * @param pipelineId - Pipeline to cleanup
+     * @param worktreeManager - WorktreeManager instance
+     * @param deleteBranches - Whether to delete the merged branches
+     */
+    cleanupPipelineWorktrees(pipelineId: string, worktreeManager: WorktreeManager, deleteBranches?: boolean): Promise<{
+        cleaned: number;
+        errors: string[];
+    }>;
+    /**
+     * Mark a pipeline as failed and preserve worktrees for debugging.
+     * @param pipelineId - Pipeline to rollback
+     * @param reason - Failure reason
+     */
+    markPipelineFailed(pipelineId: string, reason: string): void;
+    /**
+     * Get cleanup summary for a pipeline.
+     */
+    getWorktreeCleanupSummary(): {
+        total: number;
+        pending: number;
+        active: number;
+        completed: number;
+        merged: number;
+        conflict: number;
+    };
+}
+//# sourceMappingURL=pipeline-manager.d.ts.map

package/dist/tasks/pipeline-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-manager.d.ts","sourceRoot":"","sources":["../../src/tasks/pipeline-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAKrB,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAA6C;IAC/D,OAAO,CAAC,aAAa,CAAkD;IACvE,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI;IASjF;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAInE;;OAEG;IACH,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC;IAI5D;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,GAAG,IAAI;IAYxF;;;;OAIG;IACH,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAyDxD;;;OAGG;IACH,wBAAwB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM;IA2ChE;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,kBAAkB,GAAG,iBAAiB;IAuBlE;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI/D;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IASzE;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,iBAAiB,GAAG,YAAY,EAAE;IAc3D;;OAEG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,GACpB,IAAI;IAsBP;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAUlE;;;OAGG;IACH,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM;IA8C1E;;OAEG;IACH,mBAAmB,IAAI,iBAAiB,EAAE;IAM1C;;;;;OAKG;IACG,wBAAwB,CAC5B,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,eAAe,EAChC,cAAc,UAAO,GACpB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAyBjD;;;;OAIG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAe5D;;OAEG;IACH,yBAAyB,IAAI;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB;CAkCF"}