mcp-adr-analysis-server 2.1.20 → 2.1.22

package/dist/src/config/ai-config.d.ts

@@ -1,10 +1,21 @@
 /**
- * AI Configuration for OpenRouter.ai Integration
+ * AI Configuration for OpenRouter.ai Integration and CE-MCP
  *
  * This module handles configuration for AI execution capabilities,
- * allowing the MCP server to execute prompts internally and return
- * actual results instead of prompts.
+ * supporting both legacy OpenRouter execution and the new CE-MCP
+ * (Code Execution with MCP) paradigm.
+ *
+ * @see ADR-014: CE-MCP Architecture
+ */
+/**
+ * Execution mode for AI operations
+ *
+ * - 'full': Execute prompts via OpenRouter (legacy)
+ * - 'prompt-only': Return prompts without execution (legacy)
+ * - 'ce-mcp': Return orchestration directives for host LLM (recommended)
+ * - 'hybrid': Support both CE-MCP and OpenRouter fallback
  */
+export type ExecutionMode = 'full' | 'prompt-only' | 'ce-mcp' | 'hybrid';
 export interface AIConfig {
     /** OpenRouter API key for authentication */
     apiKey: string;
@@ -12,8 +23,8 @@ export interface AIConfig {
     baseURL: string;
     /** Default AI model to use for prompt execution */
     defaultModel: string;
-    /** Execution mode: 'full' executes prompts, 'prompt-only' returns prompts */
-    executionMode: 'full' | 'prompt-only';
+    /** Execution mode */
+    executionMode: ExecutionMode;
     /** Site URL for OpenRouter rankings (optional) */
     siteUrl?: string;
     /** Site name for OpenRouter rankings (optional) */
@@ -30,6 +41,27 @@ export interface AIConfig {
     cacheEnabled: boolean;
     /** Cache TTL in seconds */
     cacheTTL: number;
+    /** CE-MCP specific configuration */
+    cemcp?: CEMCPSettings;
+}
+/**
+ * CE-MCP specific settings
+ */
+export interface CEMCPSettings {
+    /** Enable sandbox execution */
+    sandboxEnabled: boolean;
+    /** Sandbox execution timeout in ms */
+    sandboxTimeout: number;
+    /** Sandbox memory limit in bytes */
+    sandboxMemoryLimit: number;
+    /** Maximum file system operations */
+    sandboxFsLimit: number;
+    /** Allow network access in sandbox */
+    sandboxNetworkAllowed: boolean;
+    /** Enable lazy prompt loading */
+    lazyPromptLoading: boolean;
+    /** Use OpenRouter as fallback when CE-MCP fails */
+    openRouterFallback: boolean;
 }
 export interface ModelConfig {
     /** Model identifier for OpenRouter */
@@ -51,6 +83,10 @@ export interface ModelConfig {
  * Available AI models for different use cases
  */
 export declare const AVAILABLE_MODELS: Record<string, ModelConfig>;
+/**
+ * Default CE-MCP settings
+ */
+export declare const DEFAULT_CEMCP_SETTINGS: CEMCPSettings;
 /**
  * Default AI configuration
  */
@@ -71,9 +107,21 @@ export declare function validateAIConfig(config: AIConfig): void;
  */
 export declare function getModelConfig(modelId: string): ModelConfig | undefined;
 /**
- * Check if AI execution is enabled
+ * Check if AI execution is enabled (legacy OpenRouter mode)
  */
 export declare function isAIExecutionEnabled(config: AIConfig): boolean;
+/**
+ * Check if CE-MCP mode is enabled
+ */
+export declare function isCEMCPEnabled(config: AIConfig): boolean;
+/**
+ * Check if OpenRouter fallback is available
+ */
+export declare function isOpenRouterFallbackAvailable(config: AIConfig): boolean;
+/**
+ * Get the effective execution mode based on configuration and available resources
+ */
+export declare function getEffectiveExecutionMode(config: AIConfig): ExecutionMode;
 /**
  * Get recommended model for a specific use case
  */

package/dist/src/config/ai-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-config.d.ts","sourceRoot":"","sources":["../../../src/config/ai-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,QAAQ;IACvB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,aAAa,EAAE,MAAM,GAAG,aAAa,CAAC;IACtC,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAqCxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAclB,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAkBvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAoBvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGvE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,GAAE,OAAe,GAAG,MAAM,CAiB3F"}
+{"version":3,"file":"ai-config.d.ts","sourceRoot":"","sources":["../../../src/config/ai-config.ts"],"names":[],"mappings":"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"}

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

@@ -1,9 +1,11 @@
 /**
- * AI Configuration for OpenRouter.ai Integration
+ * AI Configuration for OpenRouter.ai Integration and CE-MCP
  *
  * This module handles configuration for AI execution capabilities,
- * allowing the MCP server to execute prompts internally and return
- * actual results instead of prompts.
+ * supporting both legacy OpenRouter execution and the new CE-MCP
+ * (Code Execution with MCP) paradigm.
+ *
+ * @see ADR-014: CE-MCP Architecture
  */
 /**
  * Available AI models for different use cases
@@ -46,6 +48,18 @@ export const AVAILABLE_MODELS = {
         useCases: ['quick-analysis', 'simple-tasks', 'cost-effective'],
     },
 };
+/**
+ * Default CE-MCP settings
+ */
+export const DEFAULT_CEMCP_SETTINGS = {
+    sandboxEnabled: true,
+    sandboxTimeout: 30000, // 30 seconds
+    sandboxMemoryLimit: 256 * 1024 * 1024, // 256 MB
+    sandboxFsLimit: 1000,
+    sandboxNetworkAllowed: false,
+    lazyPromptLoading: true,
+    openRouterFallback: true,
+};
 /**
  * Default AI configuration
  */
@@ -53,7 +67,7 @@ export const DEFAULT_AI_CONFIG = {
     apiKey: '',
     baseURL: 'https://openrouter.ai/api/v1',
     defaultModel: 'anthropic/claude-3-sonnet',
-    executionMode: 'full',
+    executionMode: 'ce-mcp', // Default to CE-MCP mode (was 'full')
     siteUrl: 'https://github.com/tosin2013/mcp-adr-analysis-server',
     siteName: 'MCP ADR Analysis Server',
     timeout: 60000, // 60 seconds
@@ -62,11 +76,24 @@ export const DEFAULT_AI_CONFIG = {
     maxTokens: 4000,
     cacheEnabled: true,
     cacheTTL: 3600, // 1 hour
+    cemcp: DEFAULT_CEMCP_SETTINGS,
 };
 /**
  * Load AI configuration from environment variables
  */
 export function loadAIConfig() {
+    // Load CE-MCP settings
+    const cemcpSettings = {
+        sandboxEnabled: process.env['CEMCP_SANDBOX_ENABLED'] !== 'false',
+        sandboxTimeout: parseInt(process.env['CEMCP_SANDBOX_TIMEOUT'] || '') || DEFAULT_CEMCP_SETTINGS.sandboxTimeout,
+        sandboxMemoryLimit: parseInt(process.env['CEMCP_SANDBOX_MEMORY'] || '') ||
+            DEFAULT_CEMCP_SETTINGS.sandboxMemoryLimit,
+        sandboxFsLimit: parseInt(process.env['CEMCP_SANDBOX_FS_LIMIT'] || '') ||
+            DEFAULT_CEMCP_SETTINGS.sandboxFsLimit,
+        sandboxNetworkAllowed: process.env['CEMCP_SANDBOX_NETWORK'] === 'true',
+        lazyPromptLoading: process.env['CEMCP_LAZY_PROMPTS'] !== 'false',
+        openRouterFallback: process.env['CEMCP_OPENROUTER_FALLBACK'] !== 'false',
+    };
     const config = {
         apiKey: process.env['OPENROUTER_API_KEY'] || '',
         baseURL: 'https://openrouter.ai/api/v1',
@@ -80,6 +107,7 @@ export function loadAIConfig() {
         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,
+        cemcp: cemcpSettings,
     };
     return config;
 }
@@ -111,10 +139,45 @@ export function getModelConfig(modelId) {
     return AVAILABLE_MODELS[normalizedId];
 }
 /**
- * Check if AI execution is enabled
+ * Check if AI execution is enabled (legacy OpenRouter mode)
  */
 export function isAIExecutionEnabled(config) {
-    return config.executionMode === 'full' && !!config.apiKey;
+    return (config.executionMode === 'full' || config.executionMode === 'hybrid') && !!config.apiKey;
+}
+/**
+ * Check if CE-MCP mode is enabled
+ */
+export function isCEMCPEnabled(config) {
+    return config.executionMode === 'ce-mcp' || config.executionMode === 'hybrid';
+}
+/**
+ * Check if OpenRouter fallback is available
+ */
+export function isOpenRouterFallbackAvailable(config) {
+    return ((config.executionMode === 'hybrid' || config.cemcp?.openRouterFallback === true) &&
+        !!config.apiKey);
+}
+/**
+ * Get the effective execution mode based on configuration and available resources
+ */
+export function getEffectiveExecutionMode(config) {
+    if (config.executionMode === 'ce-mcp') {
+        // If CE-MCP is requested but sandbox is disabled, check for fallback
+        if (!config.cemcp?.sandboxEnabled) {
+            if (isOpenRouterFallbackAvailable(config)) {
+                return 'full';
+            }
+            return 'prompt-only';
+        }
+        return 'ce-mcp';
+    }
+    if (config.executionMode === 'hybrid') {
+        return 'hybrid';
+    }
+    if (config.executionMode === 'full' && !config.apiKey) {
+        return 'prompt-only';
+    }
+    return config.executionMode;
 }
 /**
  * Get recommended model for a specific use case

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

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

package/dist/src/config/ape-descriptions.d.ts

@@ -0,0 +1,77 @@
+/**
+ * APE (Automatic Prompt Engineering) Description Constants
+ *
+ * This file extracts hardcoded description maps from the APE module
+ * to reduce memory footprint and enable configuration reuse.
+ *
+ * Optimization Benefits:
+ * - Reduces memory churn by ~1.2KB per module load
+ * - Enables lazy loading of descriptions
+ * - Centralizes APE configuration for easier maintenance
+ * - Supports future internationalization
+ *
+ * @see ADR-015 for optimization rationale
+ */
+import type { GenerationStrategy, EvaluationCriterion, SelectionStrategy } from '../types/ape-framework.js';
+/**
+ * Descriptions for prompt generation strategies
+ * Used in candidate generation to explain each strategy's approach
+ */
+export declare const STRATEGY_DESCRIPTIONS: Record<GenerationStrategy, string>;
+/**
+ * Descriptions for prompt evaluation criteria
+ * Used to explain what each criterion measures during evaluation
+ */
+export declare const CRITERION_DESCRIPTIONS: Record<EvaluationCriterion, string>;
+/**
+ * Descriptions for candidate selection strategies
+ * Explains how the best prompt candidate is selected
+ */
+export declare const SELECTION_STRATEGY_DESCRIPTIONS: Record<SelectionStrategy, string>;
+/**
+ * Tool-specific optimization priorities for APE
+ * Defines what aspects to focus on when optimizing prompts for specific tools
+ */
+export declare const TOOL_OPTIMIZATION_PRIORITIES: Record<string, string[]>;
+/**
+ * Default optimization priorities for tools not in the specific list
+ */
+export declare const DEFAULT_TOOL_PRIORITIES: string[];
+/**
+ * Get description for a generation strategy with fallback
+ */
+export declare function getStrategyDescription(strategy: GenerationStrategy): string;
+/**
+ * Get description for an evaluation criterion with fallback
+ */
+export declare function getCriterionDescription(criterion: EvaluationCriterion): string;
+/**
+ * Get description for a selection strategy with fallback
+ */
+export declare function getSelectionStrategyDescription(strategy: SelectionStrategy): string;
+/**
+ * Get tool-specific optimization priorities
+ * Returns formatted string for prompt inclusion
+ */
+export declare function getToolOptimizationPriorities(toolName: string): string;
+/**
+ * Get raw priorities array for a tool (for programmatic use)
+ */
+export declare function getToolPrioritiesArray(toolName: string): string[];
+/**
+ * Get or create a cached template section
+ * Reduces regeneration of static template portions
+ */
+export declare function getCachedTemplateSection(sectionKey: string, generator: () => string): string;
+/**
+ * Clear template cache (useful for testing or config updates)
+ */
+export declare function clearTemplateCache(): void;
+/**
+ * Get template cache statistics
+ */
+export declare function getTemplateCacheStats(): {
+    size: number;
+    keys: string[];
+};
+//# sourceMappingURL=ape-descriptions.d.ts.map

package/dist/src/config/ape-descriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ape-descriptions.d.ts","sourceRoot":"","sources":["../../../src/config/ape-descriptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAMnC;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAOpE,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAOtE,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAM7E,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA+BjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,EAK3C,CAAC;AAMF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAE3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAEnF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjE;AAYD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,MAAM,GAAG,MAAM,CAO5F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAKxE"}

package/dist/src/config/ape-descriptions.js

@@ -0,0 +1,177 @@
+/**
+ * APE (Automatic Prompt Engineering) Description Constants
+ *
+ * This file extracts hardcoded description maps from the APE module
+ * to reduce memory footprint and enable configuration reuse.
+ *
+ * Optimization Benefits:
+ * - Reduces memory churn by ~1.2KB per module load
+ * - Enables lazy loading of descriptions
+ * - Centralizes APE configuration for easier maintenance
+ * - Supports future internationalization
+ *
+ * @see ADR-015 for optimization rationale
+ */
+// ============================================================================
+// Generation Strategy Descriptions
+// ============================================================================
+/**
+ * Descriptions for prompt generation strategies
+ * Used in candidate generation to explain each strategy's approach
+ */
+export const STRATEGY_DESCRIPTIONS = {
+    'template-variation': 'Use different prompt templates and structural formats',
+    'semantic-variation': 'Rephrase while preserving meaning and intent',
+    'style-variation': 'Adjust tone, formality, and communication style',
+    'length-variation': 'Create concise, detailed, and balanced versions',
+    'structure-variation': 'Reorganize content with different patterns',
+    'hybrid-approach': 'Combine multiple strategies for optimal results',
+};
+// ============================================================================
+// Evaluation Criterion Descriptions
+// ============================================================================
+/**
+ * Descriptions for prompt evaluation criteria
+ * Used to explain what each criterion measures during evaluation
+ */
+export const CRITERION_DESCRIPTIONS = {
+    'task-completion': 'How well the prompt achieves the intended task outcome',
+    clarity: 'How clear, unambiguous, and easy to understand the prompt is',
+    specificity: 'How specific, actionable, and detailed the prompt is',
+    robustness: 'How well the prompt handles edge cases and variations',
+    efficiency: 'How concise yet comprehensive the prompt is',
+    'context-awareness': 'How well the prompt fits the specific context and domain',
+};
+// ============================================================================
+// Selection Strategy Descriptions
+// ============================================================================
+/**
+ * Descriptions for candidate selection strategies
+ * Explains how the best prompt candidate is selected
+ */
+export const SELECTION_STRATEGY_DESCRIPTIONS = {
+    'highest-score': 'Select the candidate with the highest overall evaluation score',
+    'multi-criteria': 'Balance multiple evaluation criteria with appropriate weights',
+    ensemble: 'Combine strengths of multiple high-performing candidates',
+    'context-aware': 'Choose based on context-specific suitability and requirements',
+    balanced: 'Balance quality, diversity, and context appropriateness',
+};
+// ============================================================================
+// Tool-Specific Optimization Priorities
+// ============================================================================
+/**
+ * Tool-specific optimization priorities for APE
+ * Defines what aspects to focus on when optimizing prompts for specific tools
+ */
+export const TOOL_OPTIMIZATION_PRIORITIES = {
+    generate_adrs_from_prd: [
+        'Context Analysis: Better understanding of PRD requirements and constraints',
+        'Decision Quality: Clearer architectural decision rationale and justification',
+        'Stakeholder Alignment: Improved ADR clarity and relevance for stakeholders',
+        'Technical Depth: Appropriate level of technical detail for the context',
+    ],
+    suggest_adrs: [
+        'Relevance: Highly relevant ADR suggestions based on project context',
+        'Prioritization: Clear prioritization of suggested ADRs by importance',
+        'Feasibility: Realistic and implementable architectural decisions',
+        'Impact Assessment: Clear understanding of decision impacts and trade-offs',
+    ],
+    analyze_project_ecosystem: [
+        'Technology Detection: Accurate identification of technologies and frameworks',
+        'Pattern Recognition: Better identification of architectural patterns',
+        'Context Understanding: Comprehensive project context analysis',
+        'Insight Generation: Valuable and actionable architectural insights',
+    ],
+    generate_research_questions: [
+        'Question Quality: High-quality, targeted research questions',
+        'Relevance: Questions directly relevant to project needs',
+        'Depth: Appropriate depth and scope for research objectives',
+        'Actionability: Questions that lead to actionable insights',
+    ],
+    incorporate_research: [
+        'Integration Quality: Effective integration of research findings',
+        'Synthesis: Good synthesis of multiple research sources',
+        'Relevance: Focus on most relevant research findings',
+        'Actionability: Clear actionable recommendations from research',
+    ],
+};
+/**
+ * Default optimization priorities for tools not in the specific list
+ */
+export const DEFAULT_TOOL_PRIORITIES = [
+    "Task Effectiveness: Optimize for the tool's primary task objectives",
+    'Context Awareness: Improve understanding of tool-specific context',
+    'Output Quality: Enhance the quality and relevance of tool outputs',
+    'User Experience: Improve clarity and usability of tool interactions',
+];
+// ============================================================================
+// Helper Functions for Accessing Descriptions
+// ============================================================================
+/**
+ * Get description for a generation strategy with fallback
+ */
+export function getStrategyDescription(strategy) {
+    return STRATEGY_DESCRIPTIONS[strategy] || 'Apply the specified generation strategy';
+}
+/**
+ * Get description for an evaluation criterion with fallback
+ */
+export function getCriterionDescription(criterion) {
+    return CRITERION_DESCRIPTIONS[criterion] || 'Evaluate based on this criterion';
+}
+/**
+ * Get description for a selection strategy with fallback
+ */
+export function getSelectionStrategyDescription(strategy) {
+    return SELECTION_STRATEGY_DESCRIPTIONS[strategy] || 'Apply the specified selection strategy';
+}
+/**
+ * Get tool-specific optimization priorities
+ * Returns formatted string for prompt inclusion
+ */
+export function getToolOptimizationPriorities(toolName) {
+    const priorities = TOOL_OPTIMIZATION_PRIORITIES[toolName] || DEFAULT_TOOL_PRIORITIES;
+    return priorities.map(p => `- **${p}**`).join('\n');
+}
+/**
+ * Get raw priorities array for a tool (for programmatic use)
+ */
+export function getToolPrioritiesArray(toolName) {
+    return TOOL_OPTIMIZATION_PRIORITIES[toolName] || DEFAULT_TOOL_PRIORITIES;
+}
+// ============================================================================
+// Template Caching Support
+// ============================================================================
+/**
+ * Cache for generated prompt templates
+ * Key format: `${templateType}:${configHash}`
+ */
+const templateCache = new Map();
+/**
+ * Get or create a cached template section
+ * Reduces regeneration of static template portions
+ */
+export function getCachedTemplateSection(sectionKey, generator) {
+    if (templateCache.has(sectionKey)) {
+        return templateCache.get(sectionKey);
+    }
+    const content = generator();
+    templateCache.set(sectionKey, content);
+    return content;
+}
+/**
+ * Clear template cache (useful for testing or config updates)
+ */
+export function clearTemplateCache() {
+    templateCache.clear();
+}
+/**
+ * Get template cache statistics
+ */
+export function getTemplateCacheStats() {
+    return {
+        size: templateCache.size,
+        keys: Array.from(templateCache.keys()),
+    };
+}
+//# sourceMappingURL=ape-descriptions.js.map

package/dist/src/config/ape-descriptions.js.map

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

package/dist/src/index.d.ts

@@ -147,6 +147,10 @@ export declare class McpAdrAnalysisServer {
      * Perform research tool implementation
      */
     private performResearch;
+    /**
+     * Search codebase tool implementation
+     */
+    private searchCodebase;
     /**
      * LLM web search tool implementation
      */
@@ -243,10 +247,46 @@ export declare class McpAdrAnalysisServer {
      * Retrieves conversation memory statistics
      */
     private getMemoryStats;
+    /**
+     * Update Knowledge Tool (ADR-018)
+     * Simple CRUD operations for knowledge graph
+     */
+    private updateKnowledge;
     /**
      * Get Server Context Tool
      * Generates comprehensive server context file for LLM @ referencing
      */
     private getServerContext;
+    /**
+     * Get Current Datetime Tool
+     * Returns the current date and time in various formats for ADR generation and timestamping
+     */
+    private getCurrentDatetime;
+    /**
+     * Set Project Path Tool - Dynamic Session Configuration
+     *
+     * @description Dynamically sets the active project path for the current session.
+     * This allows switching between projects without restarting the server or modifying
+     * environment variables. Updates both the config and the RootManager.
+     *
+     * @param args - Set project path arguments
+     * @param args.path - Absolute path to the project directory
+     * @param args.validatePath - Whether to validate the path exists (default: true)
+     * @returns Promise<CallToolResult> - Confirmation of the path change
+     */
+    private setProjectPath;
+    /**
+     * Load Prompt Tool - CE-MCP Phase 4 Lazy Loading
+     *
+     * @description Loads prompts on-demand instead of eagerly loading all prompts at startup.
+     * This reduces token usage by ~96% (from 28K tokens to ~1K on-demand).
+     *
+     * @param args - Load prompt arguments
+     * @param args.promptName - Name of the prompt to load
+     * @param args.section - Optional section within the prompt
+     * @param args.estimateOnly - If true, returns only token estimate
+     * @returns Promise<CallToolResult> - Loaded prompt content or estimate
+     */
+    private loadPrompt;
 }
 //# 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;AAiHH;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,yBAAyB,CAA4B;IAC7D,OAAO,CAAC,yBAAyB,CAA4B;IAC7D,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CAAyB;;IAkCjD;;OAEG;YACW,qBAAqB;IAWnC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;IAo/GrB;;OAEG;YACW,sBAAsB;YA0GtB,mBAAmB;YAsMnB,sBAAsB;YA4QtB,uBAAuB;YA+bvB,uBAAuB;YAwQvB,mBAAmB;YA6VnB,kBAAkB;IA+HhC;;OAEG;YACW,4BAA4B;IA+F1C;;OAEG;YACW,+BAA+B;IAuO7C;;OAEG;IACH,OAAO,CAAC,cAAc;IAmCtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqHtB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAiDlC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IA+FvC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAuCjC;;OAEG;IACH,OAAO,CAAC,oCAAoC;IAqE5C;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAoCjC;;OAEG;YACW,sBAAsB;YAKtB,sBAAsB;YAKtB,uBAAuB;YAOvB,wBAAwB;YAOxB,sBAAsB;YAKtB,WAAW;YAoJX,sBAAsB;IA2HpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAyDnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6F3B;;OAEG;YACW,WAAW;YAKX,uBAAuB;YAOvB,oBAAoB;YAOpB,uBAAuB;YAOvB,oBAAoB;YAgCpB,kBAAkB;YA4FlB,kBAAkB;IAKhC;;OAEG;YACW,WAAW;YAKX,eAAe;IAK7B;;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,eAAe;IA6C7B;;OAEG;YACW,YAAY;IA2B1B;;OAEG;YACW,kBAAkB;IA+BhC;;OAEG;YACW,qBAAqB;IA+BnC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;IACH;;OAEG;YACW,qBAAqB;IAiCnC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA2G/B;;OAEG;YACW,kBAAkB;YA0FlB,kBAAkB;IAWhC;;;;;;;OAOG;YACW,oCAAoC;IAuFlD;;OAEG;YACW,YAAY;IA4X1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC5B;;OAEG;IAEH;;OAEG;YACW,SAAS;IAiBvB;;OAEG;YACW,aAAa;YA+Cb,QAAQ;YAuCR,SAAS;YAqCT,aAAa;YAsCb,0BAA0B;YAY1B,YAAY;YAYZ,mBAAmB;YAYnB,0BAA0B;YAc1B,UAAU;YAwBV,WAAW;YAYX,aAAa;YAab,qBAAqB;YAYrB,sBAAsB;IAYpC;;OAEG;YACW,qBAAqB;IAYnC;;;OAGG;YACW,YAAY;IAY1B;;;OAGG;YACW,wBAAwB;IAYtC;;;OAGG;YACW,uBAAuB;IAYrC;;;OAGG;YACW,cAAc;IAY5B;;;OAGG;YACW,gBAAgB;CAgB/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}