mcp-adr-analysis-server 2.1.20 → 2.1.27

package/dist/src/utils/adr-planning-task-integration.d.ts

@@ -0,0 +1,260 @@
+/**
+ * MCP Tasks Integration for Interactive ADR Planning Tool
+ *
+ * This module provides standardized task tracking for the interactive ADR planning tool,
+ * implementing ADR-020: MCP Tasks Integration Strategy.
+ *
+ * Key features:
+ * - Creates MCP Tasks for ADR planning sessions
+ * - Tracks progress through planning phases (problem_definition, research, options, decision, impact, implementation, generation)
+ * - Supports cancellation between phases
+ * - Handles input_required state for interactive planning
+ * - Provides memory integration for planning context tracking
+ *
+ * @see ADR-020: MCP Tasks Integration Strategy
+ * @see https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/tasks
+ */
+import { type AdrTask, type TaskResult, type TaskManager } from './task-manager.js';
+/**
+ * ADR Planning phases that map to MCP Task phases
+ */
+export declare const ADR_PLANNING_PHASES: readonly ["problem_definition", "research_analysis", "option_exploration", "decision_making", "impact_assessment", "implementation_planning", "adr_generation"];
+export type AdrPlanningPhase = (typeof ADR_PLANNING_PHASES)[number];
+/**
+ * ADR planning task context for tracking state across planning steps
+ */
+export interface AdrPlanningTaskContext {
+    taskId: string;
+    sessionId: string;
+    currentPhase: AdrPlanningPhase;
+    cancelled: boolean;
+    awaitingInput: boolean;
+    problemStatement?: string;
+    researchCount?: number;
+    optionCount?: number;
+    selectedOption?: string;
+    impactAssessment?: {
+        technicalImpacts: number;
+        businessImpacts: number;
+        risks: number;
+    };
+    todoCount?: number;
+    adrGenerated?: boolean;
+}
+/**
+ * Options for creating an ADR planning task
+ */
+export interface CreateAdrPlanningTaskOptions {
+    projectPath: string;
+    adrDirectory?: string;
+    sessionId?: string;
+    initialProblem?: string;
+    enableResearchIntegration?: boolean;
+    enableTodoGeneration?: boolean;
+}
+/**
+ * Result from ADR planning task execution
+ */
+export interface AdrPlanningTaskResult extends TaskResult {
+    data?: {
+        success: boolean;
+        sessionId: string;
+        phase: AdrPlanningPhase | 'completed';
+        adrPath?: string;
+        adrTitle?: string;
+        todoCount?: number;
+        researchFindingsCount?: number;
+        optionsEvaluated?: number;
+        awaitingInput?: boolean;
+        inputPrompt?: string;
+    };
+}
+/**
+ * ADR Planning Task Manager - Provides MCP Tasks integration for interactive ADR planning
+ *
+ * This class wraps the TaskManager to provide ADR planning-specific functionality:
+ * - Creates tasks with ADR planning phases
+ * - Tracks planning progress through multiple steps
+ * - Supports input_required state for interactive workflows
+ * - Supports cancellation between phases
+ * - Integrates with memory for planning context tracking
+ */
+export declare class AdrPlanningTaskManager {
+    private taskManager;
+    private activeContexts;
+    constructor(taskManager?: TaskManager);
+    /**
+     * Initialize the ADR planning task manager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create a new ADR planning task
+     *
+     * @returns The created task and context
+     */
+    createAdrPlanningTask(options: CreateAdrPlanningTaskOptions): Promise<{
+        task: AdrTask;
+        context: AdrPlanningTaskContext;
+    }>;
+    /**
+     * Get ADR planning task context
+     */
+    getContext(taskId: string): AdrPlanningTaskContext | undefined;
+    /**
+     * Start an ADR planning phase
+     */
+    startPhase(taskId: string, phase: AdrPlanningPhase, message?: string): Promise<void>;
+    /**
+     * Update phase progress
+     */
+    updatePhaseProgress(taskId: string, phase: AdrPlanningPhase, phaseProgress: number, message?: string): Promise<void>;
+    /**
+     * Complete an ADR planning phase
+     */
+    completePhase(taskId: string, phase: AdrPlanningPhase, _message?: string): Promise<void>;
+    /**
+     * Fail an ADR planning phase
+     */
+    failPhase(taskId: string, phase: AdrPlanningPhase, error: string): Promise<void>;
+    /**
+     * Request input from user (sets task to input_required state)
+     */
+    requestInput(taskId: string, prompt: string): Promise<void>;
+    /**
+     * Resume task after receiving input
+     */
+    resumeAfterInput(taskId: string): Promise<void>;
+    /**
+     * Store problem definition result
+     */
+    storeProblemDefinition(taskId: string, problemStatement: string): Promise<void>;
+    /**
+     * Store research findings
+     */
+    storeResearchFindings(taskId: string, findingsCount: number): Promise<void>;
+    /**
+     * Store options explored
+     */
+    storeOptionsExplored(taskId: string, optionCount: number): Promise<void>;
+    /**
+     * Store decision made
+     */
+    storeDecision(taskId: string, selectedOption: string, _rationale: string): Promise<void>;
+    /**
+     * Store impact assessment result
+     */
+    storeImpactAssessment(taskId: string, assessment: {
+        technicalImpacts: number;
+        businessImpacts: number;
+        risks: number;
+    }): Promise<void>;
+    /**
+     * Store implementation plan result
+     */
+    storeImplementationPlan(taskId: string, todoCount: number): Promise<void>;
+    /**
+     * Store ADR generation result
+     */
+    storeAdrGenerated(taskId: string, adrPath: string): Promise<void>;
+    /**
+     * Check if task is cancelled
+     */
+    isCancelled(taskId: string): Promise<boolean>;
+    /**
+     * Check if task is awaiting input
+     */
+    isAwaitingInput(taskId: string): boolean;
+    /**
+     * Cancel an ADR planning task
+     */
+    cancelTask(taskId: string, reason?: string): Promise<void>;
+    /**
+     * Complete an ADR planning task successfully
+     */
+    completeTask(taskId: string, result: AdrPlanningTaskResult): Promise<void>;
+    /**
+     * Fail an ADR planning task
+     */
+    failTask(taskId: string, error: string): Promise<void>;
+    /**
+     * Get task status
+     */
+    getTaskStatus(taskId: string): Promise<{
+        task: AdrTask | null;
+        context: AdrPlanningTaskContext | undefined;
+    }>;
+}
+export declare function getAdrPlanningTaskManager(): AdrPlanningTaskManager;
+/**
+ * Reset the global AdrPlanningTaskManager (for testing)
+ */
+export declare function resetAdrPlanningTaskManager(): Promise<void>;
+/**
+ * Helper function to wrap ADR planning execution with task tracking
+ *
+ * This can be used by the interactive_adr_planning tool to automatically
+ * track progress through MCP Tasks.
+ *
+ * @example
+ * ```typescript
+ * const result = await executeAdrPlanningWithTaskTracking(
+ *   {
+ *     projectPath: '/path/to/project',
+ *     adrDirectory: 'docs/adrs',
+ *   },
+ *   async (tracker) => {
+ *     // Problem definition phase
+ *     await tracker.startPhase('problem_definition');
+ *     const problem = await getProblemStatement();
+ *     await tracker.storeProblemDefinition(problem);
+ *     await tracker.completePhase('problem_definition');
+ *
+ *     // Research phase
+ *     await tracker.startPhase('research_analysis');
+ *     const findings = await conductResearch();
+ *     await tracker.storeResearchFindings(findings.length);
+ *     await tracker.completePhase('research_analysis');
+ *
+ *     // Return final result
+ *     return {
+ *       success: true,
+ *       sessionId: tracker.sessionId,
+ *       phase: 'completed',
+ *       adrPath: '/path/to/adr.md',
+ *     };
+ *   }
+ * );
+ * ```
+ */
+export declare function executeAdrPlanningWithTaskTracking<T extends AdrPlanningTaskResult>(options: CreateAdrPlanningTaskOptions, executor: (tracker: AdrPlanningTaskTracker) => Promise<T['data']>): Promise<{
+    taskId: string;
+    result: T;
+}>;
+/**
+ * Task tracker interface provided to ADR planning executor
+ */
+export interface AdrPlanningTaskTracker {
+    taskId: string;
+    sessionId: string;
+    startPhase: (phase: AdrPlanningPhase, message?: string) => Promise<void>;
+    updatePhaseProgress: (phase: AdrPlanningPhase, progress: number, message?: string) => Promise<void>;
+    completePhase: (phase: AdrPlanningPhase, message?: string) => Promise<void>;
+    failPhase: (phase: AdrPlanningPhase, error: string) => Promise<void>;
+    requestInput: (prompt: string) => Promise<void>;
+    resumeAfterInput: () => Promise<void>;
+    storeProblemDefinition: (problem: string) => Promise<void>;
+    storeResearchFindings: (count: number) => Promise<void>;
+    storeOptionsExplored: (count: number) => Promise<void>;
+    storeDecision: (option: string, rationale: string) => Promise<void>;
+    storeImpactAssessment: (assessment: {
+        technicalImpacts: number;
+        businessImpacts: number;
+        risks: number;
+    }) => Promise<void>;
+    storeImplementationPlan: (todoCount: number) => Promise<void>;
+    storeAdrGenerated: (adrPath: string) => Promise<void>;
+    isCancelled: () => Promise<boolean>;
+    isAwaitingInput: () => boolean;
+    getContext: () => AdrPlanningTaskContext;
+}
+//# sourceMappingURL=adr-planning-task-integration.d.ts.map

package/dist/src/utils/adr-planning-task-integration.d.ts.map

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