mcp-adr-analysis-server 1.1.0 → 2.0.2

package/dist/src/utils/prompt-execution.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Prompt Execution Utilities
+ *
+ * This module provides utilities for executing prompts with AI when enabled,
+ * or falling back to returning prompts for external execution.
+ */
+import { AIExecutionResult } from './ai-executor.js';
+export interface PromptExecutionOptions {
+    /** Whether to force prompt-only mode regardless of configuration */
+    forcePromptOnly?: boolean;
+    /** Model to use for AI execution */
+    model?: string;
+    /** Temperature for AI responses */
+    temperature?: number;
+    /** Maximum tokens for AI responses */
+    maxTokens?: number;
+    /** System prompt to use */
+    systemPrompt?: string;
+    /** Expected response format */
+    responseFormat?: 'text' | 'json';
+    /** Schema for JSON validation (if responseFormat is 'json') */
+    schema?: any;
+}
+export interface PromptExecutionResult {
+    /** The result content (either AI response or formatted prompt) */
+    content: string;
+    /** Whether the result was generated by AI or is a prompt */
+    isAIGenerated: boolean;
+    /** AI execution metadata (if AI was used) */
+    aiMetadata?: AIExecutionResult['metadata'];
+    /** Token usage (if AI was used) */
+    usage?: AIExecutionResult['usage'];
+    /** Model used (if AI was used) */
+    model?: string;
+}
+/**
+ * Execute a prompt with AI if enabled, otherwise return formatted prompt
+ */
+export declare function executePromptWithFallback(prompt: string, instructions: string, options?: PromptExecutionOptions): Promise<PromptExecutionResult>;
+/**
+ * Execute a prompt that expects structured ADR suggestions
+ */
+export declare function executeADRSuggestionPrompt(prompt: string, instructions: string, options?: PromptExecutionOptions): Promise<PromptExecutionResult>;
+/**
+ * Execute a prompt that expects to generate actual ADRs
+ */
+export declare function executeADRGenerationPrompt(prompt: string, instructions: string, options?: PromptExecutionOptions): Promise<PromptExecutionResult>;
+/**
+ * Execute a prompt for project ecosystem analysis
+ */
+export declare function executeEcosystemAnalysisPrompt(prompt: string, instructions: string, options?: PromptExecutionOptions): Promise<PromptExecutionResult>;
+/**
+ * Execute a prompt for research question generation
+ */
+export declare function executeResearchPrompt(prompt: string, instructions: string, options?: PromptExecutionOptions): Promise<PromptExecutionResult>;
+/**
+ * Check if AI execution is currently available
+ */
+export declare function isAIExecutionAvailable(): boolean;
+/**
+ * Get AI execution status for debugging
+ */
+export declare function getAIExecutionStatus(): {
+    isEnabled: boolean;
+    hasApiKey: boolean;
+    executionMode: string;
+    model: string;
+    reason: string | undefined;
+};
+/**
+ * Get AI execution status and configuration info (legacy)
+ */
+export declare function getAIExecutionInfo(): {
+    available: boolean;
+    mode: 'full' | 'prompt-only';
+    model?: string;
+    cacheEnabled?: boolean;
+};
+/**
+ * Format execution result for MCP tool response
+ */
+export declare function formatMCPResponse(result: PromptExecutionResult): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+//# sourceMappingURL=prompt-execution.d.ts.map

package/dist/src/utils/prompt-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-execution.d.ts","sourceRoot":"","sources":["../../../src/utils/prompt-execution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGpE,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,aAAa,EAAE,OAAO,CAAC;IACvB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC3C,mCAAmC;IACnC,KAAK,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACnC,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAyDhC;AASD;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAchC;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAchC;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAchC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAchC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAOhD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CA6BA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAeA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG;IAChE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAuBA"}

package/dist/src/utils/prompt-execution.js

@@ -0,0 +1,227 @@
+/**
+ * Prompt Execution Utilities
+ *
+ * This module provides utilities for executing prompts with AI when enabled,
+ * or falling back to returning prompts for external execution.
+ */
+import { getAIExecutor } from './ai-executor.js';
+import { isAIExecutionEnabled, loadAIConfig } from '../config/ai-config.js';
+/**
+ * Execute a prompt with AI if enabled, otherwise return formatted prompt
+ */
+export async function executePromptWithFallback(prompt, instructions, options = {}) {
+    const config = loadAIConfig();
+    const shouldUseAI = !options.forcePromptOnly && isAIExecutionEnabled(config);
+    if (shouldUseAI) {
+        try {
+            const executor = getAIExecutor();
+            if (options.responseFormat === 'json') {
+                const execOptions = {};
+                if (options.model !== undefined)
+                    execOptions.model = options.model;
+                if (options.temperature !== undefined)
+                    execOptions.temperature = options.temperature;
+                if (options.maxTokens !== undefined)
+                    execOptions.maxTokens = options.maxTokens;
+                if (options.systemPrompt !== undefined)
+                    execOptions.systemPrompt = options.systemPrompt;
+                const result = await executor.executeStructuredPrompt(prompt, options.schema, execOptions);
+                return {
+                    content: typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2),
+                    isAIGenerated: true,
+                    aiMetadata: result.raw.metadata,
+                    usage: result.raw.usage,
+                    model: result.raw.model,
+                };
+            }
+            else {
+                const execOptions = {};
+                if (options.model !== undefined)
+                    execOptions.model = options.model;
+                if (options.temperature !== undefined)
+                    execOptions.temperature = options.temperature;
+                if (options.maxTokens !== undefined)
+                    execOptions.maxTokens = options.maxTokens;
+                if (options.systemPrompt !== undefined)
+                    execOptions.systemPrompt = options.systemPrompt;
+                const result = await executor.executePrompt(prompt, execOptions);
+                return {
+                    content: result.content,
+                    isAIGenerated: true,
+                    aiMetadata: result.metadata,
+                    usage: result.usage,
+                    model: result.model,
+                };
+            }
+        }
+        catch (error) {
+            console.error('AI execution failed, falling back to prompt-only mode:', error);
+            // Fall through to prompt-only mode
+        }
+    }
+    // Fallback to prompt-only mode
+    const formattedPrompt = formatPromptForExternal(prompt, instructions);
+    return {
+        content: formattedPrompt,
+        isAIGenerated: false,
+    };
+}
+/**
+ * Format a prompt for external execution
+ */
+function formatPromptForExternal(prompt, instructions) {
+    return `${instructions}\n\n${prompt}`;
+}
+/**
+ * Execute a prompt that expects structured ADR suggestions
+ */
+export async function executeADRSuggestionPrompt(prompt, instructions, options = {}) {
+    const systemPrompt = options.systemPrompt || `
+You are an expert software architect specializing in Architectural Decision Records (ADRs). 
+Analyze the provided context and generate specific, actionable ADR suggestions.
+Focus on identifying architectural decisions that need to be documented based on the project context.
+Provide clear reasoning for each suggestion and prioritize them by importance.
+`;
+    return executePromptWithFallback(prompt, instructions, {
+        ...options,
+        systemPrompt,
+        temperature: options.temperature ?? 0.1,
+        responseFormat: 'text',
+    });
+}
+/**
+ * Execute a prompt that expects to generate actual ADRs
+ */
+export async function executeADRGenerationPrompt(prompt, instructions, options = {}) {
+    const systemPrompt = options.systemPrompt || `
+You are an expert software architect who creates comprehensive Architectural Decision Records (ADRs).
+Generate well-structured ADRs that follow best practices and include all necessary sections.
+Ensure each ADR is complete, actionable, and provides clear guidance for the development team.
+Use the standard ADR format with Status, Context, Decision, and Consequences sections.
+`;
+    return executePromptWithFallback(prompt, instructions, {
+        ...options,
+        systemPrompt,
+        temperature: options.temperature ?? 0.1,
+        responseFormat: 'text',
+    });
+}
+/**
+ * Execute a prompt for project ecosystem analysis
+ */
+export async function executeEcosystemAnalysisPrompt(prompt, instructions, options = {}) {
+    const systemPrompt = options.systemPrompt || `
+You are a senior software architect specializing in technology ecosystem analysis.
+Analyze the provided project context to identify technologies, patterns, and architectural decisions.
+Provide comprehensive insights about the project's technical landscape and recommendations for improvement.
+Focus on practical, actionable insights that can guide architectural decisions.
+`;
+    return executePromptWithFallback(prompt, instructions, {
+        ...options,
+        systemPrompt,
+        temperature: options.temperature ?? 0.1,
+        responseFormat: 'text',
+    });
+}
+/**
+ * Execute a prompt for research question generation
+ */
+export async function executeResearchPrompt(prompt, instructions, options = {}) {
+    const systemPrompt = options.systemPrompt || `
+You are a research specialist who generates comprehensive research questions and methodologies.
+Create detailed research plans that help teams investigate architectural decisions and technologies.
+Focus on practical research approaches that can be executed by development teams.
+Provide clear guidance on research methods, success criteria, and expected outcomes.
+`;
+    return executePromptWithFallback(prompt, instructions, {
+        ...options,
+        systemPrompt,
+        temperature: options.temperature ?? 0.2, // Slightly higher for creativity
+        responseFormat: 'text',
+    });
+}
+/**
+ * Check if AI execution is currently available
+ */
+export function isAIExecutionAvailable() {
+    try {
+        const executor = getAIExecutor();
+        return executor.isAvailable();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get AI execution status for debugging
+ */
+export function getAIExecutionStatus() {
+    try {
+        const config = loadAIConfig();
+        const hasApiKey = !!config.apiKey;
+        const isEnabled = isAIExecutionEnabled(config);
+        let reason = undefined;
+        if (!hasApiKey) {
+            reason = 'Missing OPENROUTER_API_KEY environment variable';
+        }
+        else if (config.executionMode !== 'full') {
+            reason = `EXECUTION_MODE is '${config.executionMode}', should be 'full'`;
+        }
+        return {
+            isEnabled,
+            hasApiKey,
+            executionMode: config.executionMode,
+            model: config.defaultModel,
+            reason
+        };
+    }
+    catch (error) {
+        return {
+            isEnabled: false,
+            hasApiKey: false,
+            executionMode: 'unknown',
+            model: 'unknown',
+            reason: `Configuration error: ${error instanceof Error ? error.message : String(error)}`
+        };
+    }
+}
+/**
+ * Get AI execution status and configuration info (legacy)
+ */
+export function getAIExecutionInfo() {
+    const config = loadAIConfig();
+    const available = isAIExecutionAvailable();
+    const result = {
+        available,
+        mode: config.executionMode,
+    };
+    if (available) {
+        result.model = config.defaultModel;
+        result.cacheEnabled = config.cacheEnabled;
+    }
+    return result;
+}
+/**
+ * Format execution result for MCP tool response
+ */
+export function formatMCPResponse(result) {
+    let responseText = result.content;
+    // Add metadata footer if AI was used
+    if (result.isAIGenerated && result.aiMetadata) {
+        const metadata = [
+            `\n\n---`,
+            `**AI Generated Response**`,
+            `- Model: ${result.model}`,
+            `- Execution Time: ${result.aiMetadata.executionTime}ms`,
+            `- Cached: ${result.aiMetadata.cached ? 'Yes' : 'No'}`,
+        ];
+        if (result.usage) {
+            metadata.push(`- Tokens Used: ${result.usage.totalTokens} (${result.usage.promptTokens} prompt + ${result.usage.completionTokens} completion)`);
+        }
+        responseText += metadata.join('\n');
+    }
+    return {
+        content: [{ type: 'text', text: responseText }],
+    };
+}
+//# sourceMappingURL=prompt-execution.js.map

package/dist/src/utils/prompt-execution.js.map

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

package/dist/src/utils/reflexion.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Reflexion Utility Module - 100% Prompt-Driven Architecture
+ * Implements Actor-Evaluator-Self-Reflection pattern for continuous learning
+ * All functions return prompts for AI execution, never execute operations directly
+ */
+import { ReflexionConfig, ReflexionMemory, MemoryType, EvaluationCriterion, ReflectionDepth, MemoryQuery } from '../types/reflexion-framework.js';
+import { PromptObject } from './prompt-composition.js';
+/**
+ * Generate AI delegation prompt for executing a task with reflexion learning
+ * Returns prompts for AI to execute tasks with memory-enhanced context
+ */
+export declare function executeWithReflexion(basePrompt: PromptObject, config?: Partial<ReflexionConfig>): Promise<{
+    prompt: string;
+    instructions: string;
+    context: any;
+}>;
+/**
+ * Generate AI delegation prompt for retrieving relevant memories
+ * Returns prompts for AI to search and retrieve relevant past experiences
+ */
+export declare function retrieveRelevantMemories(taskType: string, context: any, query?: Partial<MemoryQuery>): Promise<{
+    prompt: string;
+    instructions: string;
+    context: any;
+}>;
+/**
+ * Generate AI delegation prompt for persisting reflexion memories
+ * Returns prompts for AI to save memories using file system operations
+ */
+export declare function persistReflexionMemory(memory: ReflexionMemory): Promise<{
+    prompt: string;
+    instructions: string;
+    context: any;
+}>;
+/**
+ * Generate AI delegation prompt for tracking learning progress
+ * Returns prompts for AI to analyze and report learning progress
+ */
+export declare function getLearningProgress(taskType: string): Promise<{
+    prompt: string;
+    instructions: string;
+    context: any;
+}>;
+/**
+ * Generate cache key for reflexion requests
+ */
+export declare function generateReflexionCacheKey(promptHash: string, config: ReflexionConfig): string;
+/**
+ * Get default reflexion configuration
+ */
+export declare function getDefaultReflexionConfig(): Required<ReflexionConfig>;
+/**
+ * Validate reflexion configuration
+ */
+export declare function validateReflexionConfig(config: Partial<ReflexionConfig>): void;
+/**
+ * Get supported memory types
+ */
+export declare function getSupportedMemoryTypes(): MemoryType[];
+/**
+ * Get supported evaluation criteria
+ */
+export declare function getSupportedEvaluationCriteria(): EvaluationCriterion[];
+/**
+ * Get supported reflection depths
+ */
+export declare function getSupportedReflectionDepths(): ReflectionDepth[];
+/**
+ * Create tool-specific reflexion configuration
+ */
+export declare function createToolReflexionConfig(toolName: string, customConfig?: Partial<ReflexionConfig>): ReflexionConfig;
+/**
+ * Generate memory ID for new memories
+ */
+export declare function generateMemoryId(memoryType: MemoryType, category: string): string;
+/**
+ * Calculate memory expiration date
+ */
+export declare function calculateMemoryExpiration(retentionDays: number, importance?: 'low' | 'medium' | 'high' | 'critical'): string;
+/**
+ * Create memory query from context
+ */
+export declare function createMemoryQuery(taskType: string, context: any, options?: Partial<MemoryQuery>): MemoryQuery;
+/**
+ * Enhance prompt with memory context
+ */
+export declare function enhancePromptWithMemories(basePrompt: PromptObject, memories: ReflexionMemory[]): Promise<{
+    prompt: string;
+    instructions: string;
+    context: any;
+}>;
+//# sourceMappingURL=reflexion.d.ts.map

package/dist/src/utils/reflexion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflexion.d.ts","sourceRoot":"","sources":["../../../src/utils/reflexion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,eAAe,EACf,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,WAAW,EACZ,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAyBvD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,YAAY,EACxB,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,GACpC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAkVjE;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,GAAG,EACZ,KAAK,GAAE,OAAO,CAAC,WAAW,CAAM,GAC/B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CA0KjE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAiJjE;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAyLjE;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,GACtB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,QAAQ,CAAC,eAAe,CAAC,CAErE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAoB9E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,UAAU,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,mBAAmB,EAAE,CAWtE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,eAAe,EAAE,CAEhE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,OAAO,CAAC,eAAe,CAAM,GAC1C,eAAe,CA0CjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIjF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,UAAU,GAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAqB,GAC5D,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,GAAG,EACZ,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GACjC,WAAW,CAcb;AAsCD;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,YAAY,EACxB,QAAQ,EAAE,eAAe,EAAE,GAC1B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAmEjE"}