@jwikman/bc-code-intelligence-mcp 1.5.7-dev.1

package/dist/sdk/bc-code-intel-client.js

@@ -0,0 +1,380 @@
+/**
+ * BC Code Intelligence MCP Client SDK
+ *
+ * TypeScript/JavaScript SDK for connecting to BC Code Intelligence MCP servers
+ * with full type safety, intelligent caching, and developer-friendly APIs.
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { EventEmitter } from 'events';
+export class BCCodeIntelClient extends EventEmitter {
+    config;
+    client;
+    transport = null;
+    connected = false;
+    cache = new Map();
+    reconnectTimer;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.client = new Client({ name: 'bc-code-intel-client', version: '1.0.0' }, { capabilities: {} });
+        if (this.config.debug_logging) {
+            console.log('🔌 BC Code Intelligence Client initialized with config:', this.config);
+        }
+    }
+    /**
+     * Connect to the BC Code Intelligence MCP server
+     */
+    async connect() {
+        try {
+            if (this.connected) {
+                console.warn('🔌 Already connected to BC Code Intelligence server');
+                return;
+            }
+            this.transport = new StdioClientTransport({
+                command: this.config.server_command,
+                args: this.config.server_args || []
+            });
+            await this.client.connect(this.transport);
+            this.connected = true;
+            this.emit('connected');
+            if (this.config.debug_logging) {
+                console.log('✅ Connected to BC Code Intelligence MCP server');
+            }
+        }
+        catch (error) {
+            this.emit('error', error);
+            throw new Error(`Failed to connect to BC Code Intelligence server: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Disconnect from the server
+     */
+    async disconnect() {
+        if (!this.connected)
+            return;
+        try {
+            if (this.transport) {
+                await this.transport.close();
+                this.transport = null;
+            }
+            this.connected = false;
+            this.cache.clear();
+            if (this.reconnectTimer) {
+                clearTimeout(this.reconnectTimer);
+                this.reconnectTimer = undefined;
+            }
+            this.emit('disconnected');
+            if (this.config.debug_logging) {
+                console.log('🔌 Disconnected from BC Code Intelligence server');
+            }
+        }
+        catch (error) {
+            this.emit('error', error);
+        }
+    }
+    /**
+     * Search for BC knowledge topics
+     */
+    async searchTopics(query, options = {}) {
+        const toolArgs = {
+            tags: options.tags,
+            domain: options.domain,
+            difficulty: options.difficulty,
+            code_context: query,
+            bc_version: options.bc_version,
+            limit: options.limit || 10
+        };
+        const result = await this.callTool('find_bc_topics', toolArgs);
+        return JSON.parse(result.content[0].text).results;
+    }
+    /**
+     * Advanced layered search with AI-powered recommendations
+     */
+    async smartSearch(query, options = {}) {
+        const toolArgs = {
+            query,
+            layer_filter: options.layer_filter,
+            include_layer_info: options.include_layer_info !== false,
+            limit: options.limit || 10
+        };
+        const result = await this.callTool('search_layered_topics', toolArgs);
+        const response = JSON.parse(result.content[0].text);
+        return response.results;
+    }
+    /**
+     * Get a specific topic by ID
+     */
+    async getTopic(topicId, includeSamples = true) {
+        try {
+            const result = await this.callTool('get_topic_content', {
+                topic_id: topicId,
+                include_samples: includeSamples
+            });
+            return JSON.parse(result.content[0].text);
+        }
+        catch (error) {
+            if (this.config.debug_logging) {
+                console.warn(`🔍 Topic not found: ${topicId}`);
+            }
+            return null;
+        }
+    }
+    /**
+     * Analyze AL code and get recommendations
+     */
+    async analyzeCode(options) {
+        const result = await this.callTool('analyze_code_patterns', options);
+        return JSON.parse(result.content[0].text);
+    }
+    /**
+     * Get optimization workflow for a scenario
+     */
+    async getOptimizationWorkflow(scenario, constraints) {
+        const result = await this.callTool('get_optimization_workflow', {
+            scenario,
+            constraints: constraints || []
+        });
+        return JSON.parse(result.content[0].text);
+    }
+    /**
+     * Get system status and health information
+     */
+    async getSystemStatus() {
+        const result = await this.callTool('get_configuration_status', {
+            include_validation: true,
+            include_performance: true
+        });
+        const response = JSON.parse(result.content[0].text);
+        return {
+            overall_health: response.validation?.is_valid ? 'healthy' : 'degraded',
+            configuration_loaded: response.configuration_loaded,
+            layers_active: response.layers_initialized,
+            total_topics: response.layer_summary?.total_topics || 0,
+            cache_hit_rate: response.performance?.hit_rate || 0,
+            uptime_seconds: response.performance?.uptime_seconds || 0
+        };
+    }
+    /**
+     * Get layer information and statistics
+     */
+    async getLayerInfo(includeStatistics = true) {
+        const result = await this.callTool('get_layer_info', {
+            include_statistics: includeStatistics
+        });
+        return JSON.parse(result.content[0].text);
+    }
+    /**
+     * Resolve topic across layers to see override information
+     */
+    async resolveTopicLayers(topicId) {
+        const result = await this.callTool('resolve_topic_layers', {
+            topic_id: topicId,
+            show_overrides: true
+        });
+        return JSON.parse(result.content[0].text);
+    }
+    /**
+     * Get comprehensive system analytics
+     */
+    async getSystemAnalytics() {
+        const result = await this.callTool('get_system_analytics', {
+            include_topic_analytics: true,
+            include_layer_performance: true,
+            include_configuration_insights: true
+        });
+        return JSON.parse(result.content[0].text);
+    }
+    /**
+     * Reload server configuration (useful for development)
+     */
+    async reloadConfiguration(force = false) {
+        const result = await this.callTool('reload_configuration', {
+            force,
+            validate_only: false
+        });
+        return JSON.parse(result.content[0].text);
+    }
+    /**
+     * Get available MCP tools from the server
+     */
+    async getAvailableTools() {
+        try {
+            const response = await this.client.request({ method: 'tools/list', params: {} }, CallToolRequestSchema);
+            return response.tools || [];
+        }
+        catch (error) {
+            this.emit('error', error);
+            throw error;
+        }
+    }
+    /**
+     * Health check - verify connection and basic functionality
+     */
+    async healthCheck() {
+        const startTime = Date.now();
+        try {
+            await this.getSystemStatus();
+            const latency = Date.now() - startTime;
+            return { healthy: true, latency_ms: latency };
+        }
+        catch (error) {
+            const latency = Date.now() - startTime;
+            return {
+                healthy: false,
+                latency_ms: latency,
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    /**
+     * Batch operations for efficiency
+     */
+    async batchGetTopics(topicIds) {
+        const promises = topicIds.map(id => this.getTopic(id));
+        return Promise.all(promises);
+    }
+    /**
+     * Smart topic recommendations based on current context
+     */
+    async getRecommendations(currentTopic, maxRecommendations = 5) {
+        // This would use AI-powered recommendations if available
+        // For now, we'll simulate with related topics search
+        const topic = await this.getTopic(currentTopic);
+        if (!topic)
+            return [];
+        const relatedSearches = await Promise.all([
+            this.searchTopics(`domain:${topic.domain}`, { limit: 3 }),
+            this.searchTopics(`difficulty:${topic.difficulty}`, { limit: 3 })
+        ]);
+        const recommendations = [...relatedSearches[0], ...relatedSearches[1]]
+            .filter(rec => rec.id !== currentTopic)
+            .slice(0, maxRecommendations);
+        return recommendations;
+    }
+    /**
+     * Export client configuration (sanitized)
+     */
+    getClientConfig() {
+        const { debug_logging, ...config } = this.config;
+        return config;
+    }
+    /**
+     * Check if client is connected
+     */
+    isConnected() {
+        return this.connected;
+    }
+    // Private helper methods
+    async callTool(toolName, args) {
+        this.ensureConnected();
+        // Check cache first
+        if (this.config.cache_enabled) {
+            const cacheKey = `${toolName}:${JSON.stringify(args)}`;
+            const cached = this.cache.get(cacheKey);
+            if (cached && Date.now() < cached.expires) {
+                if (this.config.debug_logging) {
+                    console.log(`💾 Cache hit for ${toolName}`);
+                }
+                return cached.data;
+            }
+        }
+        try {
+            const result = await this.client.request({
+                method: 'tools/call',
+                params: {
+                    name: toolName,
+                    arguments: args
+                }
+            }, CallToolRequestSchema);
+            // Cache the result
+            if (this.config.cache_enabled) {
+                const cacheKey = `${toolName}:${JSON.stringify(args)}`;
+                const ttl = (this.config.cache_ttl_seconds || 300) * 1000;
+                this.cache.set(cacheKey, {
+                    data: result,
+                    expires: Date.now() + ttl
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            // Auto-reconnect if enabled
+            if (this.config.auto_reconnect && !this.reconnectTimer) {
+                this.scheduleReconnect();
+            }
+            throw error;
+        }
+    }
+    ensureConnected() {
+        if (!this.connected) {
+            throw new Error('Not connected to BC Code Intelligence server. Call connect() first.');
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        this.reconnectTimer = setTimeout(async () => {
+            try {
+                if (this.config.debug_logging) {
+                    console.log('🔄 Attempting to reconnect to BC Code Intelligence server...');
+                }
+                await this.disconnect();
+                await this.connect();
+                this.reconnectTimer = undefined;
+                if (this.config.debug_logging) {
+                    console.log('✅ Reconnected to BC Code Intelligence server');
+                }
+            }
+            catch (error) {
+                if (this.config.debug_logging) {
+                    console.warn('❌ Reconnection failed:', error);
+                }
+                // Schedule another attempt
+                this.reconnectTimer = undefined;
+                this.scheduleReconnect();
+            }
+        }, 5000); // Retry after 5 seconds
+    }
+}
+/**
+ * Convenience factory function for creating BC Code Intelligence clients
+ */
+export function createBCCodeIntelClient(config) {
+    return new BCCodeIntelClient(config);
+}
+/**
+ * Default configuration for common scenarios
+ */
+export const BCCodeIntelClientDefaults = {
+    local: (serverPath) => ({
+        server_command: serverPath || 'node',
+        server_args: ['dist/index.js'],
+        auto_reconnect: true,
+        request_timeout_ms: 10000,
+        cache_enabled: true,
+        cache_ttl_seconds: 300,
+        debug_logging: false
+    }),
+    development: (serverPath) => ({
+        server_command: serverPath || 'npm',
+        server_args: ['run', 'dev'],
+        auto_reconnect: true,
+        request_timeout_ms: 30000,
+        cache_enabled: false, // Disable cache for development
+        cache_ttl_seconds: 60,
+        debug_logging: true
+    }),
+    production: (serverPath) => ({
+        server_command: serverPath,
+        server_args: [],
+        auto_reconnect: true,
+        request_timeout_ms: 5000,
+        cache_enabled: true,
+        cache_ttl_seconds: 600, // 10 minutes
+        debug_logging: false
+    })
+};
+//# sourceMappingURL=bc-code-intel-client.js.map

package/dist/sdk/bc-code-intel-client.js.map

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

package/dist/search/intelligent-search.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Intelligent Search Engine with AI-Powered Recommendations
+ *
+ * Advanced search capabilities including semantic search, context understanding,
+ * intelligent topic recommendations, and learning from user patterns.
+ */
+import { AtomicTopic, TopicSearchResult } from '../types/bc-knowledge.js';
+export interface SearchContext {
+    user_code_context?: string;
+    current_domain?: string;
+    difficulty_preference?: 'beginner' | 'intermediate' | 'advanced' | 'expert';
+    recent_topics?: string[];
+    user_skill_level?: number;
+    project_type?: 'new' | 'maintenance' | 'optimization' | 'migration';
+}
+export interface SmartSearchResult extends TopicSearchResult {
+    relevance_reasons: string[];
+    learning_path_position?: number;
+    prerequisite_satisfaction_score?: number;
+    difficulty_match_score?: number;
+    context_relevance_score?: number;
+    recommendation_strength?: 'high' | 'medium' | 'low';
+}
+export interface TopicRecommendation {
+    topic_id: string;
+    title: string;
+    reason: string;
+    confidence: number;
+    type: 'prerequisite' | 'related' | 'next_step' | 'alternative' | 'deep_dive';
+    estimated_value: number;
+}
+export interface LearningPath {
+    path_id: string;
+    name: string;
+    description: string;
+    topics: Array<{
+        topic_id: string;
+        position: number;
+        is_required: boolean;
+        estimated_time: string;
+    }>;
+    total_estimated_time: string;
+    difficulty_progression: string[];
+    success_criteria: string[];
+}
+export declare class IntelligentSearchEngine {
+    private readonly enableSemanticSearch;
+    private readonly enableLearningRecommendations;
+    private readonly maxSearchHistory;
+    private searchIndex;
+    private topicRelationships;
+    private searchHistory;
+    private userPreferences;
+    constructor(enableSemanticSearch?: boolean, enableLearningRecommendations?: boolean, maxSearchHistory?: number);
+    /**
+     * Build intelligent search index from topics
+     */
+    buildSearchIndex(topics: AtomicTopic[]): void;
+    /**
+     * Perform intelligent search with context awareness
+     */
+    intelligentSearch(query: string, context: SearchContext, limit?: number): Promise<SmartSearchResult[]>;
+    /**
+     * Generate intelligent topic recommendations based on context
+     */
+    getTopicRecommendations(currentTopic: string, context: SearchContext, maxRecommendations?: number): Promise<TopicRecommendation[]>;
+    /**
+     * Generate personalized learning path
+     */
+    generateLearningPath(goal: string, context: SearchContext): Promise<LearningPath>;
+    /**
+     * Update user preferences based on interaction patterns
+     */
+    updateUserPreferences(viewedTopics: string[], positiveInteractions: string[], negativeInteractions?: string[]): void;
+    private processSearchQuery;
+    private calculateRelevanceReasons;
+    private calculateLearningPathPosition;
+    private calculatePrerequisiteSatisfaction;
+    private calculateDifficultyMatch;
+    private calculateContextRelevance;
+    private calculateRecommendationStrength;
+    private reRankResults;
+    private buildTopicRelationships;
+    private extractCodeKeywords;
+    private topicToSearchResult;
+    private trackSearch;
+    private generatePrerequisiteRecommendations;
+    private generateNextStepRecommendations;
+    private generateAlternativeRecommendations;
+    private generateDeepDiveRecommendations;
+    private calculateRecommendationScore;
+    private findPathTopics;
+    private calculateTotalTime;
+    private calculateDifficultyProgression;
+    private generateSuccessCriteria;
+}
+//# sourceMappingURL=intelligent-search.d.ts.map

package/dist/search/intelligent-search.d.ts.map

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