mcp-adr-analysis-server 2.1.19 → 2.1.22

package/dist/src/utils/task-manager.js

@@ -0,0 +1,528 @@
+/**
+ * Task Manager for MCP Tasks Integration
+ *
+ * This module provides a unified interface for managing MCP Tasks across
+ * long-running operations in the mcp-adr-analysis-server.
+ *
+ * Implements ADR-018: MCP Tasks Integration Strategy
+ *
+ * @experimental MCP Tasks is an experimental feature in the MCP specification
+ */
+import { randomBytes } from 'node:crypto';
+import { createComponentLogger } from './enhanced-logging.js';
+import { createTaskPersistence, } from './task-persistence.js';
+const logger = createComponentLogger('TaskManager');
+/**
+ * Check if a task status represents a terminal state
+ */
+export function isTerminalStatus(status) {
+    return status === 'completed' || status === 'failed' || status === 'cancelled';
+}
+/**
+ * Generate a unique task ID
+ */
+function generateTaskId() {
+    return randomBytes(16).toString('hex');
+}
+/**
+ * Task Manager for coordinating long-running operations
+ *
+ * Features:
+ * - Creates and tracks tasks for tool operations
+ * - Updates task progress and status
+ * - Supports multi-phase operations with individual phase tracking
+ * - Provides cancellation support
+ * - File-based persistence for durability across restarts
+ * - Designed to work with MCP SDK experimental tasks API
+ */
+export class TaskManager {
+    tasks = new Map();
+    taskProgress = new Map();
+    cleanupTimers = new Map();
+    persistence = null;
+    initialized = false;
+    constructor(options = {}) {
+        const { persistence, enablePersistence = true } = options;
+        if (enablePersistence) {
+            this.persistence = createTaskPersistence(persistence);
+        }
+        logger.info('TaskManager initialized', { persistenceEnabled: enablePersistence });
+    }
+    /**
+     * Initialize the TaskManager - loads persisted tasks
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        if (this.persistence) {
+            await this.persistence.initialize();
+            const { tasks, progress } = await this.persistence.load();
+            // Restore tasks and progress
+            for (const [taskId, task] of tasks) {
+                this.tasks.set(taskId, task);
+                // Re-establish TTL timers for non-terminal tasks
+                if (!isTerminalStatus(task.status) && task.ttl !== null && task.ttl > 0) {
+                    const elapsed = Date.now() - new Date(task.createdAt).getTime();
+                    const remainingTtl = Math.max(0, task.ttl - elapsed);
+                    if (remainingTtl > 0) {
+                        const timer = setTimeout(() => {
+                            this.cleanupTask(taskId);
+                        }, remainingTtl);
+                        this.cleanupTimers.set(taskId, timer);
+                    }
+                    else {
+                        // Task expired while server was down
+                        this.cleanupTask(taskId);
+                    }
+                }
+            }
+            for (const [taskId, prog] of progress) {
+                this.taskProgress.set(taskId, prog);
+            }
+            logger.info('TaskManager restored from persistence', { taskCount: this.tasks.size });
+        }
+        this.initialized = true;
+    }
+    /**
+     * Persist current state to disk
+     */
+    async persistState() {
+        if (this.persistence?.isEnabled()) {
+            await this.persistence.save(this.tasks, this.taskProgress);
+        }
+    }
+    /**
+     * Create a new task for a tool operation
+     */
+    async createTask(options) {
+        const { type, tool, phases, dependencies, projectPath, adrDirectory, ttl = 3600000, // Default 1 hour TTL
+        pollInterval = 1000, } = options;
+        const now = new Date().toISOString();
+        const taskId = generateTaskId();
+        // Initialize metadata
+        const metadata = {
+            type,
+            tool,
+        };
+        // Only add optional properties if they have values
+        if (projectPath !== undefined) {
+            metadata.projectPath = projectPath;
+        }
+        if (adrDirectory !== undefined) {
+            metadata.adrDirectory = adrDirectory;
+        }
+        if (dependencies !== undefined && dependencies.length > 0) {
+            metadata.dependencies = dependencies;
+        }
+        // Initialize phases if provided
+        if (phases !== undefined && phases.length > 0) {
+            metadata.phases = phases.map((name, index) => ({
+                name,
+                description: `Phase ${index + 1}: ${name}`,
+                progress: 0,
+                status: 'pending',
+            }));
+        }
+        const task = {
+            taskId,
+            status: 'working',
+            ttl,
+            createdAt: now,
+            lastUpdatedAt: now,
+            pollInterval,
+            metadata,
+        };
+        this.tasks.set(taskId, task);
+        this.taskProgress.set(taskId, 0);
+        // Set up automatic cleanup if TTL is specified
+        if (ttl !== null && ttl > 0) {
+            const timer = setTimeout(() => {
+                this.cleanupTask(taskId);
+            }, ttl);
+            this.cleanupTimers.set(taskId, timer);
+        }
+        logger.info('Task created', {
+            taskId,
+            type,
+            tool,
+            phaseCount: phases?.length ?? 0,
+        });
+        // Persist state
+        await this.persistState();
+        return task;
+    }
+    /**
+     * Get a task by ID
+     */
+    async getTask(taskId) {
+        const task = this.tasks.get(taskId);
+        return task ?? null;
+    }
+    /**
+     * Get task result
+     */
+    async getTaskResult(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return null;
+        return task.result ?? null;
+    }
+    /**
+     * List all tasks
+     */
+    async listTasks(cursor) {
+        const allTasks = Array.from(this.tasks.values());
+        // Simple pagination: cursor is the index to start from
+        const startIndex = cursor ? parseInt(cursor, 10) : 0;
+        const pageSize = 50;
+        const tasks = allTasks.slice(startIndex, startIndex + pageSize);
+        // Handle nextCursor properly for exactOptionalPropertyTypes
+        if (startIndex + pageSize < allTasks.length) {
+            return { tasks, nextCursor: String(startIndex + pageSize) };
+        }
+        return { tasks };
+    }
+    /**
+     * Update task progress
+     */
+    async updateProgress(update) {
+        const { taskId, progress, phase, phaseProgress, message } = update;
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            logger.warn('Task not found for progress update', { taskId });
+            return;
+        }
+        // Update overall progress
+        this.taskProgress.set(taskId, progress);
+        task.lastUpdatedAt = new Date().toISOString();
+        // Update phase progress if applicable
+        if (phase !== undefined && task.metadata?.phases !== undefined) {
+            const phases = task.metadata.phases;
+            const phaseIndex = phases.findIndex(p => p.name === phase);
+            if (phaseIndex >= 0) {
+                const currentPhase = phases[phaseIndex];
+                if (currentPhase !== undefined) {
+                    currentPhase.progress = phaseProgress ?? progress;
+                    if (phaseProgress === 100) {
+                        currentPhase.status = 'completed';
+                        currentPhase.endTime = new Date().toISOString();
+                        // Start next phase if available
+                        const nextPhase = phases[phaseIndex + 1];
+                        if (nextPhase !== undefined) {
+                            nextPhase.status = 'running';
+                            nextPhase.startTime = new Date().toISOString();
+                        }
+                    }
+                }
+            }
+        }
+        // Update status message if provided
+        if (message !== undefined) {
+            task.statusMessage = message;
+        }
+        logger.debug('Task progress updated', {
+            taskId,
+            progress,
+            phase,
+            phaseProgress,
+        });
+        // Persist state
+        await this.persistState();
+    }
+    /**
+     * Start a phase
+     */
+    async startPhase(taskId, phaseName) {
+        const task = this.tasks.get(taskId);
+        if (!task?.metadata?.phases)
+            return;
+        const phase = task.metadata.phases.find(p => p.name === phaseName);
+        if (phase !== undefined) {
+            phase.status = 'running';
+            phase.startTime = new Date().toISOString();
+            task.statusMessage = `Starting phase: ${phaseName}`;
+            task.lastUpdatedAt = new Date().toISOString();
+            logger.info('Phase started', { taskId, phaseName });
+            // Persist state
+            await this.persistState();
+        }
+    }
+    /**
+     * Complete a phase
+     */
+    async completePhase(taskId, phaseName) {
+        const task = this.tasks.get(taskId);
+        if (!task?.metadata?.phases)
+            return;
+        const phases = task.metadata.phases;
+        const phaseIndex = phases.findIndex(p => p.name === phaseName);
+        if (phaseIndex >= 0) {
+            const phase = phases[phaseIndex];
+            if (phase !== undefined) {
+                phase.status = 'completed';
+                phase.progress = 100;
+                phase.endTime = new Date().toISOString();
+                // Calculate overall progress based on completed phases
+                const completedCount = phases.filter(p => p.status === 'completed').length;
+                const totalProgress = Math.round((completedCount / phases.length) * 100);
+                this.taskProgress.set(taskId, totalProgress);
+                // Start next phase if available
+                const nextPhase = phases[phaseIndex + 1];
+                if (nextPhase !== undefined) {
+                    nextPhase.status = 'running';
+                    nextPhase.startTime = new Date().toISOString();
+                }
+                task.lastUpdatedAt = new Date().toISOString();
+                logger.info('Phase completed', { taskId, phaseName, totalProgress });
+                // Persist state
+                await this.persistState();
+            }
+        }
+    }
+    /**
+     * Fail a phase
+     */
+    async failPhase(taskId, phaseName, error) {
+        const task = this.tasks.get(taskId);
+        if (!task?.metadata?.phases)
+            return;
+        const phase = task.metadata.phases.find(p => p.name === phaseName);
+        if (phase !== undefined) {
+            phase.status = 'failed';
+            phase.error = error;
+            phase.endTime = new Date().toISOString();
+            task.lastUpdatedAt = new Date().toISOString();
+            logger.error('Phase failed', undefined, { taskId, phaseName, errorMessage: error });
+            // Persist state
+            await this.persistState();
+        }
+    }
+    /**
+     * Complete a task successfully
+     */
+    async completeTask(taskId, result) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Task ${taskId} not found`);
+        }
+        task.status = 'completed';
+        task.result = result;
+        task.lastUpdatedAt = new Date().toISOString();
+        this.taskProgress.set(taskId, 100);
+        // Mark all pending/running phases as completed
+        if (task.metadata?.phases) {
+            for (const phase of task.metadata.phases) {
+                if (phase.status !== 'failed') {
+                    phase.status = 'completed';
+                    phase.progress = 100;
+                    if (!phase.endTime) {
+                        phase.endTime = new Date().toISOString();
+                    }
+                }
+            }
+        }
+        logger.info('Task completed', { taskId });
+        // Persist state
+        await this.persistState();
+    }
+    /**
+     * Fail a task
+     */
+    async failTask(taskId, error) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Task ${taskId} not found`);
+        }
+        task.status = 'failed';
+        task.result = {
+            success: false,
+            error: {
+                code: 'TASK_FAILED',
+                message: error,
+                recoverable: false,
+            },
+        };
+        task.statusMessage = error;
+        task.lastUpdatedAt = new Date().toISOString();
+        logger.error('Task failed', undefined, { taskId, errorMessage: error });
+        // Persist state
+        await this.persistState();
+    }
+    /**
+     * Cancel a task
+     */
+    async cancelTask(taskId, reason) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Task ${taskId} not found`);
+        }
+        if (isTerminalStatus(task.status)) {
+            throw new Error(`Task ${taskId} is already in terminal state: ${task.status}`);
+        }
+        task.status = 'cancelled';
+        task.statusMessage = reason ?? 'Cancelled by user';
+        task.lastUpdatedAt = new Date().toISOString();
+        // Mark running/pending phases as skipped
+        if (task.metadata?.phases) {
+            for (const phase of task.metadata.phases) {
+                if (phase.status === 'running' || phase.status === 'pending') {
+                    phase.status = 'skipped';
+                    phase.endTime = new Date().toISOString();
+                }
+            }
+        }
+        logger.info('Task cancelled', { taskId, reason });
+        // Persist state
+        await this.persistState();
+    }
+    /**
+     * Check if a task is still running
+     */
+    async isTaskRunning(taskId) {
+        const task = this.tasks.get(taskId);
+        return task !== undefined && !isTerminalStatus(task.status);
+    }
+    /**
+     * Request input from the user (sets task to input_required state)
+     * Used for interactive tools that need user input during execution
+     */
+    async requestInput(taskId, prompt) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            logger.warn('Task not found for input request', { taskId });
+            return;
+        }
+        task.status = 'input_required';
+        task.statusMessage = prompt;
+        task.lastUpdatedAt = new Date().toISOString();
+        logger.info('Task awaiting input', { taskId, prompt });
+        // Persist state
+        await this.persistState();
+    }
+    /**
+     * Resume a task after receiving input (sets task back to working state)
+     */
+    async resumeTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            logger.warn('Task not found for resume', { taskId });
+            return;
+        }
+        if (task.status !== 'input_required') {
+            logger.warn('Task not in input_required state', { taskId, status: task.status });
+            return;
+        }
+        task.status = 'working';
+        task.statusMessage = 'Resumed after input';
+        task.lastUpdatedAt = new Date().toISOString();
+        logger.info('Task resumed', { taskId });
+        // Persist state
+        await this.persistState();
+    }
+    /**
+     * Get task progress (0-100)
+     */
+    getProgress(taskId) {
+        return this.taskProgress.get(taskId) ?? 0;
+    }
+    /**
+     * Get task metadata
+     */
+    getMetadata(taskId) {
+        const task = this.tasks.get(taskId);
+        return task?.metadata;
+    }
+    /**
+     * Get all tasks for a specific tool
+     */
+    async getTasksByTool(tool) {
+        const { tasks } = await this.listTasks();
+        return tasks.filter(task => task.metadata?.tool === tool);
+    }
+    /**
+     * Get all tasks of a specific type
+     */
+    async getTasksByType(type) {
+        const { tasks } = await this.listTasks();
+        return tasks.filter(task => task.metadata?.type === type);
+    }
+    /**
+     * Clean up a specific task
+     */
+    cleanupTask(taskId) {
+        const timer = this.cleanupTimers.get(taskId);
+        if (timer) {
+            clearTimeout(timer);
+            this.cleanupTimers.delete(taskId);
+        }
+        this.tasks.delete(taskId);
+        this.taskProgress.delete(taskId);
+        logger.debug('Task cleaned up', { taskId });
+    }
+    /**
+     * Cleanup completed/failed tasks older than specified duration
+     */
+    async cleanup(maxAgeMs = 24 * 60 * 60 * 1000) {
+        const now = Date.now();
+        let cleanedCount = 0;
+        for (const [taskId, task] of this.tasks) {
+            if (isTerminalStatus(task.status)) {
+                const updatedAt = new Date(task.lastUpdatedAt).getTime();
+                if (now - updatedAt > maxAgeMs) {
+                    this.cleanupTask(taskId);
+                    cleanedCount++;
+                }
+            }
+        }
+        if (cleanedCount > 0) {
+            logger.info('Cleaned up old tasks', { count: cleanedCount });
+        }
+        return cleanedCount;
+    }
+    /**
+     * Cleanup all tasks and timers (for graceful shutdown)
+     */
+    async shutdown() {
+        // Flush persistence before clearing data
+        if (this.persistence?.isEnabled()) {
+            await this.persistence.saveImmediate(this.tasks, this.taskProgress);
+            await this.persistence.shutdown();
+        }
+        for (const timer of this.cleanupTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.cleanupTimers.clear();
+        this.tasks.clear();
+        this.taskProgress.clear();
+        this.initialized = false;
+        logger.info('TaskManager shut down');
+    }
+}
+// Singleton instance for global use
+let globalTaskManager = null;
+/**
+ * Get the global TaskManager instance
+ */
+export function getTaskManager() {
+    if (!globalTaskManager) {
+        globalTaskManager = new TaskManager();
+    }
+    return globalTaskManager;
+}
+/**
+ * Set the global TaskManager instance (for testing or custom stores)
+ */
+export function setTaskManager(manager) {
+    globalTaskManager = manager;
+}
+/**
+ * Reset the global TaskManager (for testing)
+ */
+export async function resetTaskManager() {
+    if (globalTaskManager) {
+        await globalTaskManager.shutdown();
+        globalTaskManager = null;
+    }
+}
+//# sourceMappingURL=task-manager.js.map

package/dist/src/utils/task-manager.js.map

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

package/dist/src/utils/task-persistence.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Task Persistence for MCP Tasks Integration
+ *
+ * Provides file-based persistence for tasks to survive server restarts.
+ * Uses JSON files stored in a configurable cache directory.
+ *
+ * Implements ADR-018: MCP Tasks Integration Strategy
+ *
+ * @experimental MCP Tasks is an experimental feature in the MCP specification
+ */
+import type { AdrTask } from './task-manager.js';
+/**
+ * Configuration for task persistence
+ */
+export interface TaskPersistenceConfig {
+    /** Directory to store task data (default: .mcp-adr-cache/tasks) */
+    cacheDir: string;
+    /** Whether persistence is enabled (default: true) */
+    enabled: boolean;
+    /** Maximum age of persisted tasks in ms (default: 7 days) */
+    maxAge: number;
+    /** Write delay in ms for debouncing (default: 1000) */
+    writeDelay: number;
+}
+/**
+ * Task Persistence Manager
+ *
+ * Handles saving and loading tasks to/from disk for durability across
+ * server restarts. Uses debounced writes to avoid excessive disk I/O.
+ */
+export declare class TaskPersistence {
+    private config;
+    private writeTimer;
+    private pendingWrite;
+    private initialized;
+    constructor(config?: Partial<TaskPersistenceConfig>);
+    /**
+     * Initialize persistence - create cache directory if needed
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the path to the tasks file
+     */
+    private getTasksFilePath;
+    /**
+     * Load persisted tasks from disk
+     */
+    load(): Promise<{
+        tasks: Map<string, AdrTask>;
+        progress: Map<string, number>;
+    }>;
+    /**
+     * Save tasks to disk (debounced)
+     */
+    save(tasks: Map<string, AdrTask>, progress: Map<string, number>): Promise<void>;
+    /**
+     * Force immediate save (for shutdown)
+     */
+    saveImmediate(tasks: Map<string, AdrTask>, progress: Map<string, number>): Promise<void>;
+    /**
+     * Write data to file
+     */
+    private writeToFile;
+    /**
+     * Delete persisted task data
+     */
+    clear(): Promise<void>;
+    /**
+     * Cleanup old task files
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Shutdown persistence - flush pending writes
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Check if persistence is enabled
+     */
+    isEnabled(): boolean;
+}
+export declare function createTaskPersistence(config?: Partial<TaskPersistenceConfig>): TaskPersistence;
+//# sourceMappingURL=task-persistence.d.ts.map

package/dist/src/utils/task-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-persistence.d.ts","sourceRoot":"","sources":["../../../src/utils/task-persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAoBD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAIvD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAyDrF;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BrF;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB9F;;OAEG;YACW,WAAW;IAwBzB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBhC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB;AAGD,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,eAAe,CAE9F"}