mcp-adr-analysis-server 1.1.0 → 3.0.0

package/dist/src/config/ai-config.js

@@ -0,0 +1,134 @@
+/**
+ * AI Configuration for OpenRouter.ai Integration
+ *
+ * This module handles configuration for AI execution capabilities,
+ * allowing the MCP server to execute prompts internally and return
+ * actual results instead of prompts.
+ */
+/**
+ * Available AI models for different use cases
+ */
+export const AVAILABLE_MODELS = {
+    'claude-3-sonnet': {
+        id: 'anthropic/claude-3-sonnet',
+        name: 'Claude 3 Sonnet',
+        provider: 'anthropic',
+        inputCost: 3.0,
+        outputCost: 15.0,
+        contextLength: 200000,
+        useCases: ['analysis', 'reasoning', 'code-generation']
+    },
+    'claude-3-haiku': {
+        id: 'anthropic/claude-3-haiku',
+        name: 'Claude 3 Haiku',
+        provider: 'anthropic',
+        inputCost: 0.25,
+        outputCost: 1.25,
+        contextLength: 200000,
+        useCases: ['quick-analysis', 'simple-tasks']
+    },
+    'gpt-4o': {
+        id: 'openai/gpt-4o',
+        name: 'GPT-4 Omni',
+        provider: 'openai',
+        inputCost: 5.0,
+        outputCost: 15.0,
+        contextLength: 128000,
+        useCases: ['analysis', 'reasoning', 'creative-tasks']
+    },
+    'gpt-4o-mini': {
+        id: 'openai/gpt-4o-mini',
+        name: 'GPT-4 Omni Mini',
+        provider: 'openai',
+        inputCost: 0.15,
+        outputCost: 0.6,
+        contextLength: 128000,
+        useCases: ['quick-analysis', 'simple-tasks', 'cost-effective']
+    }
+};
+/**
+ * Default AI configuration
+ */
+export const DEFAULT_AI_CONFIG = {
+    apiKey: '',
+    baseURL: 'https://openrouter.ai/api/v1',
+    defaultModel: 'anthropic/claude-3-sonnet',
+    executionMode: 'full',
+    siteUrl: 'https://github.com/tosin2013/mcp-adr-analysis-server',
+    siteName: 'MCP ADR Analysis Server',
+    timeout: 60000, // 60 seconds
+    maxRetries: 3,
+    temperature: 0.1, // Lower for more consistent results
+    maxTokens: 4000,
+    cacheEnabled: true,
+    cacheTTL: 3600 // 1 hour
+};
+/**
+ * Load AI configuration from environment variables
+ */
+export function loadAIConfig() {
+    const config = {
+        apiKey: process.env['OPENROUTER_API_KEY'] || '',
+        baseURL: 'https://openrouter.ai/api/v1',
+        defaultModel: process.env['AI_MODEL'] || DEFAULT_AI_CONFIG.defaultModel,
+        executionMode: process.env['EXECUTION_MODE'] || DEFAULT_AI_CONFIG.executionMode,
+        siteUrl: process.env['SITE_URL'] || DEFAULT_AI_CONFIG.siteUrl,
+        siteName: process.env['SITE_NAME'] || DEFAULT_AI_CONFIG.siteName,
+        timeout: parseInt(process.env['AI_TIMEOUT'] || '') || DEFAULT_AI_CONFIG.timeout,
+        maxRetries: parseInt(process.env['AI_MAX_RETRIES'] || '') || DEFAULT_AI_CONFIG.maxRetries,
+        temperature: parseFloat(process.env['AI_TEMPERATURE'] || '') || DEFAULT_AI_CONFIG.temperature,
+        maxTokens: parseInt(process.env['AI_MAX_TOKENS'] || '') || DEFAULT_AI_CONFIG.maxTokens,
+        cacheEnabled: process.env['AI_CACHE_ENABLED'] !== 'false',
+        cacheTTL: parseInt(process.env['AI_CACHE_TTL'] || '') || DEFAULT_AI_CONFIG.cacheTTL
+    };
+    return config;
+}
+/**
+ * Validate AI configuration
+ */
+export function validateAIConfig(config) {
+    if (config.executionMode === 'full' && !config.apiKey) {
+        throw new Error('OPENROUTER_API_KEY is required when execution mode is "full"');
+    }
+    if (!AVAILABLE_MODELS[config.defaultModel.replace('anthropic/', '').replace('openai/', '')]) {
+        console.warn(`Unknown model: ${config.defaultModel}. Using default.`);
+    }
+    if (config.temperature < 0 || config.temperature > 1) {
+        throw new Error('Temperature must be between 0 and 1');
+    }
+    if (config.maxTokens < 100 || config.maxTokens > 8000) {
+        throw new Error('Max tokens must be between 100 and 8000');
+    }
+    if (config.timeout < 1000 || config.timeout > 300000) {
+        throw new Error('Timeout must be between 1000ms and 300000ms');
+    }
+}
+/**
+ * Get model configuration by ID
+ */
+export function getModelConfig(modelId) {
+    const normalizedId = modelId.replace('anthropic/', '').replace('openai/', '');
+    return AVAILABLE_MODELS[normalizedId];
+}
+/**
+ * Check if AI execution is enabled
+ */
+export function isAIExecutionEnabled(config) {
+    return config.executionMode === 'full' && !!config.apiKey;
+}
+/**
+ * Get recommended model for a specific use case
+ */
+export function getRecommendedModel(useCase, costSensitive = false) {
+    const models = Object.values(AVAILABLE_MODELS);
+    const suitableModels = models.filter(model => model.useCases.includes(useCase) || model.useCases.includes('analysis'));
+    if (suitableModels.length === 0) {
+        return DEFAULT_AI_CONFIG.defaultModel;
+    }
+    if (costSensitive) {
+        // Sort by cost (input + output cost)
+        suitableModels.sort((a, b) => (a.inputCost + a.outputCost) - (b.inputCost + b.outputCost));
+    }
+    return suitableModels[0].id;
+}
+//# sourceMappingURL=ai-config.js.map

package/dist/src/config/ai-config.js.map

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

package/dist/src/index.d.ts

@@ -6,5 +6,100 @@
  * This server provides Tools, Resources, and Prompts for analyzing
  * Architectural Decision Records and project architecture.
  */
-export {};
+/**
+ * Main server class
+ */
+export declare class McpAdrAnalysisServer {
+    private server;
+    private maskingConfig;
+    private config;
+    private logger;
+    constructor();
+    /**
+     * Validate configuration and project setup
+     */
+    private validateConfiguration;
+    /**
+     * Public health check method for testing
+     */
+    healthCheck(): Promise<void>;
+    /**
+     * Setup MCP protocol handlers
+     */
+    private setupHandlers;
+    /**
+     * Tool implementations
+     */
+    private checkAIExecutionStatus;
+    private getWorkflowGuidance;
+    private getDevelopmentGuidance;
+    private analyzeProjectEcosystem;
+    private getArchitecturalContext;
+    private generateAdrsFromPrd;
+    private generateAdrTodo;
+    /**
+     * Content masking tool implementations
+     */
+    private analyzeContentSecurity;
+    private generateContentMasking;
+    private configureCustomPatterns;
+    private applyBasicContentMasking;
+    private validateContentMasking;
+    private manageCache;
+    private configureOutputMasking;
+    /**
+     * Helper method to get domains based on PRD type
+     */
+    private getPrdTypeDomains;
+    /**
+     * Helper method to get domains for ecosystem analysis based on technology focus
+     */
+    private getEcosystemAnalysisDomains;
+    /**
+     * Helper method to create base ADR generation prompt
+     */
+    private createBaseAdrPrompt;
+    /**
+     * ADR suggestion tool implementations
+     */
+    private suggestAdrs;
+    private generateAdrFromDecision;
+    private discoverExistingAdrs;
+    /**
+     * Research integration tool implementations
+     */
+    private incorporateResearch;
+    private createResearchTemplate;
+    private requestActionConfirmation;
+    /**
+     * Rule generation and validation tool implementations
+     */
+    private generateRules;
+    private validateRules;
+    private createRuleSet;
+    /**
+     * Environment analysis tool implementation
+     */
+    private analyzeEnvironment;
+    /**
+     * Research question generation tool implementation
+     */
+    private generateResearchQuestions;
+    /**
+     * Deployment analysis tool implementation
+     */
+    private analyzeDeploymentProgress;
+    /**
+     * Apply content masking to MCP response
+     */
+    private applyOutputMasking;
+    /**
+     * Read MCP resource with prompt-driven caching
+     */
+    private readResource;
+    /**
+     * Start the server
+     */
+    start(): Promise<void>;
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AA0BH;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAkC;;IAwBhD;;OAEG;YACW,qBAAqB;IAUnC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC;;OAEG;IACH,OAAO,CAAC,aAAa;IAqrCrB;;OAEG;YACW,sBAAsB;YAgGtB,mBAAmB;YAqMnB,sBAAsB;YAoPtB,uBAAuB;YAqUvB,uBAAuB;YA0PvB,mBAAmB;YA6RnB,eAAe;IAgK7B;;OAEG;YACW,sBAAsB;YAKtB,sBAAsB;YAKtB,uBAAuB;YAKvB,wBAAwB;YAKxB,sBAAsB;YAKtB,WAAW;YAkJX,sBAAsB;IAuHpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAyDnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyF3B;;OAEG;YACW,WAAW;YAKX,uBAAuB;YAKvB,oBAAoB;IAKlC;;OAEG;YACW,mBAAmB;YAKnB,sBAAsB;YAKtB,yBAAyB;IAKvC;;OAEG;YACW,aAAa;YAKb,aAAa;YAKb,aAAa;IAK3B;;OAEG;YACW,kBAAkB;IAKhC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;YACW,kBAAkB;IAWhC;;OAEG;YACW,YAAY;IAmF1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}