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

package/dist/performance/performance-monitor.js

@@ -0,0 +1,253 @@
+/**
+ * Performance Monitor for BCKB System
+ *
+ * Tracks performance metrics, identifies bottlenecks, and provides
+ * optimization recommendations for production deployments.
+ */
+export class PerformanceMonitor {
+    enableDetailedTracking;
+    enableSlowQueryLogging;
+    slowQueryThresholdMs;
+    metrics = [];
+    errorCount = 0;
+    totalRequests = 0;
+    startTime = Date.now();
+    maxMetrics = 1000; // Keep last 1000 metrics
+    constructor(enableDetailedTracking = true, enableSlowQueryLogging = true, slowQueryThresholdMs = 1000) {
+        this.enableDetailedTracking = enableDetailedTracking;
+        this.enableSlowQueryLogging = enableSlowQueryLogging;
+        this.slowQueryThresholdMs = slowQueryThresholdMs;
+        console.log(`📊 Performance monitor initialized (detailed: ${enableDetailedTracking})`);
+    }
+    /**
+     * Track a performance metric
+     */
+    trackOperation(operation, durationMs, metadata) {
+        if (!this.enableDetailedTracking)
+            return;
+        const metric = {
+            operation,
+            duration_ms: durationMs,
+            timestamp: Date.now(),
+            metadata
+        };
+        this.metrics.push(metric);
+        // Log slow operations
+        if (this.enableSlowQueryLogging && durationMs > this.slowQueryThresholdMs) {
+            console.warn(`🐌 Slow operation detected: ${operation} took ${durationMs}ms`, metadata);
+        }
+        // Keep only recent metrics to prevent memory growth
+        if (this.metrics.length > this.maxMetrics) {
+            this.metrics.shift();
+        }
+        this.totalRequests++;
+    }
+    /**
+     * Time and track an async operation
+     */
+    async timeOperation(operation, fn, metadata) {
+        const startTime = Date.now();
+        try {
+            const result = await fn();
+            const duration = Date.now() - startTime;
+            this.trackOperation(operation, duration, { ...metadata, success: true });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.errorCount++;
+            this.trackOperation(operation, duration, {
+                ...metadata,
+                success: false,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+    /**
+     * Create a timer for manual tracking
+     */
+    createTimer(operation, metadata) {
+        const startTime = Date.now();
+        return {
+            stop: (additionalMetadata) => {
+                const duration = Date.now() - startTime;
+                this.trackOperation(operation, duration, { ...metadata, ...additionalMetadata });
+                return duration;
+            }
+        };
+    }
+    /**
+     * Get performance summary for a specific operation
+     */
+    getOperationSummary(operation) {
+        const operationMetrics = this.metrics.filter(m => m.operation === operation);
+        if (operationMetrics.length === 0)
+            return null;
+        const durations = operationMetrics.map(m => m.duration_ms).sort((a, b) => a - b);
+        const total = durations.reduce((sum, d) => sum + d, 0);
+        return {
+            total_operations: operationMetrics.length,
+            average_duration_ms: total / operationMetrics.length,
+            p95_duration_ms: durations[Math.floor(durations.length * 0.95)] || 0,
+            p99_duration_ms: durations[Math.floor(durations.length * 0.99)] || 0,
+            operations_per_second: this.calculateOpsPerSecond(operationMetrics),
+            slowest_operations: [...operationMetrics]
+                .sort((a, b) => (b.duration_ms || 0) - (a.duration_ms || 0))
+                .slice(0, 5),
+            fastest_operations: [...operationMetrics]
+                .sort((a, b) => (a.duration_ms || 0) - (b.duration_ms || 0))
+                .slice(0, 5)
+        };
+    }
+    /**
+     * Get overall system performance summary
+     */
+    getOverallSummary() {
+        if (this.metrics.length === 0) {
+            return {
+                total_operations: 0,
+                average_duration_ms: 0,
+                p95_duration_ms: 0,
+                p99_duration_ms: 0,
+                operations_per_second: 0,
+                slowest_operations: [],
+                fastest_operations: []
+            };
+        }
+        const durations = this.metrics.map(m => m.duration_ms).sort((a, b) => a - b);
+        const total = durations.reduce((sum, d) => sum + d, 0);
+        return {
+            total_operations: this.metrics.length,
+            average_duration_ms: total / this.metrics.length,
+            p95_duration_ms: durations[Math.floor(durations.length * 0.95)] || 0,
+            p99_duration_ms: durations[Math.floor(durations.length * 0.99)] || 0,
+            operations_per_second: this.calculateOpsPerSecond(this.metrics),
+            slowest_operations: [...this.metrics]
+                .sort((a, b) => (b.duration_ms || 0) - (a.duration_ms || 0))
+                .slice(0, 10),
+            fastest_operations: [...this.metrics]
+                .sort((a, b) => (a.duration_ms || 0) - (b.duration_ms || 0))
+                .slice(0, 10)
+        };
+    }
+    /**
+     * Get system health metrics
+     */
+    getSystemHealth() {
+        const memoryUsage = process.memoryUsage();
+        const uptime = (Date.now() - this.startTime) / 1000;
+        // Calculate average response time from recent metrics
+        const recentMetrics = this.metrics.slice(-100); // Last 100 operations
+        const avgResponseTime = recentMetrics.length > 0
+            ? recentMetrics.reduce((sum, m) => sum + m.duration_ms, 0) / recentMetrics.length
+            : 0;
+        return {
+            memory_usage_mb: memoryUsage.heapUsed / 1024 / 1024,
+            cache_hit_rate: 0, // This would be provided by cache manager
+            active_layers: 0, // This would be provided by layer service
+            total_topics: 0, // This would be provided by layer service
+            average_response_time_ms: avgResponseTime,
+            error_rate: this.totalRequests > 0 ? (this.errorCount / this.totalRequests * 100) : 0,
+            uptime_seconds: uptime
+        };
+    }
+    /**
+     * Get optimization recommendations based on performance data
+     */
+    getOptimizationRecommendations() {
+        const recommendations = [];
+        const summary = this.getOverallSummary();
+        const health = this.getSystemHealth();
+        // High latency detection
+        if (summary.average_duration_ms > 500) {
+            recommendations.push({
+                type: 'latency',
+                message: 'Average response time is high. Consider optimizing slow operations or increasing cache size.',
+                priority: 'high',
+                impact: 'Significant performance improvement'
+            });
+        }
+        // Memory usage recommendations
+        if (health.memory_usage_mb > 500) {
+            recommendations.push({
+                type: 'memory',
+                message: 'High memory usage detected. Consider reducing cache size or optimizing memory-intensive operations.',
+                priority: 'medium',
+                impact: 'Reduced memory pressure'
+            });
+        }
+        // Error rate recommendations
+        if (health.error_rate > 5) {
+            recommendations.push({
+                type: 'reliability',
+                message: 'High error rate detected. Review error logs and improve error handling.',
+                priority: 'high',
+                impact: 'Improved system stability'
+            });
+        }
+        // Performance variance recommendations
+        if (summary.p99_duration_ms > summary.average_duration_ms * 5) {
+            recommendations.push({
+                type: 'consistency',
+                message: 'High performance variance detected. Some operations are much slower than others.',
+                priority: 'medium',
+                impact: 'More consistent response times'
+            });
+        }
+        return recommendations;
+    }
+    /**
+     * Get operation breakdown by frequency and performance
+     */
+    getOperationBreakdown() {
+        const breakdown = {};
+        for (const metric of this.metrics) {
+            if (!breakdown[metric.operation]) {
+                breakdown[metric.operation] = { count: 0, total_duration: 0 };
+            }
+            breakdown[metric.operation].count++;
+            breakdown[metric.operation].total_duration += metric.duration_ms;
+        }
+        // Convert to final format with averages
+        const result = {};
+        for (const [operation, data] of Object.entries(breakdown)) {
+            result[operation] = {
+                count: data.count,
+                avg_duration: data.total_duration / data.count,
+                total_time: data.total_duration
+            };
+        }
+        return result;
+    }
+    /**
+     * Clear all metrics (useful for testing or memory management)
+     */
+    clearMetrics() {
+        this.metrics = [];
+        this.errorCount = 0;
+        this.totalRequests = 0;
+        console.log('📊 Performance metrics cleared');
+    }
+    /**
+     * Export metrics for external analysis
+     */
+    exportMetrics() {
+        return {
+            metrics: [...this.metrics], // Copy to prevent external modification
+            summary: this.getOverallSummary(),
+            system_health: this.getSystemHealth(),
+            operation_breakdown: this.getOperationBreakdown()
+        };
+    }
+    // Private helper methods
+    calculateOpsPerSecond(metrics) {
+        if (metrics.length < 2)
+            return 0;
+        const timeSpan = metrics[metrics.length - 1].timestamp - metrics[0].timestamp;
+        if (timeSpan === 0)
+            return 0;
+        return (metrics.length / timeSpan) * 1000; // Convert to operations per second
+    }
+}
+//# sourceMappingURL=performance-monitor.js.map

package/dist/performance/performance-monitor.js.map

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

package/dist/sdk/bc-code-intel-client.d.ts

@@ -0,0 +1,175 @@
+/**
+ * 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 { EventEmitter } from 'events';
+export interface BCCodeIntelClientConfig {
+    server_command: string;
+    server_args?: string[];
+    auto_reconnect?: boolean;
+    request_timeout_ms?: number;
+    cache_enabled?: boolean;
+    cache_ttl_seconds?: number;
+    debug_logging?: boolean;
+}
+export interface TopicSearchOptions {
+    tags?: string[];
+    domain?: string;
+    difficulty?: 'beginner' | 'intermediate' | 'advanced' | 'expert';
+    code_context?: string;
+    bc_version?: string;
+    limit?: number;
+}
+export interface SmartSearchOptions extends TopicSearchOptions {
+    user_context?: {
+        current_domain?: string;
+        difficulty_preference?: 'beginner' | 'intermediate' | 'advanced' | 'expert';
+        recent_topics?: string[];
+        project_type?: 'new' | 'maintenance' | 'optimization' | 'migration';
+    };
+    include_layer_info?: boolean;
+    layer_filter?: string[];
+}
+export interface BCCodeIntelTopic {
+    id: string;
+    title: string;
+    domain: string;
+    difficulty: string;
+    tags: string[];
+    prerequisites: string[];
+    related_topics: string[];
+    bc_versions: string;
+    estimated_time?: string;
+    content: string;
+    word_count: number;
+    last_modified: string;
+    relevance_score?: number;
+    samples?: {
+        file_path: string;
+        code: string;
+    };
+    layer_info?: {
+        source_layer: string;
+        is_override: boolean;
+        overridden_count: number;
+    };
+    relevance_reasons?: string[];
+    recommendation_strength?: 'high' | 'medium' | 'low';
+}
+export interface CodeAnalysisOptions {
+    code_snippet: string;
+    analysis_type?: 'performance' | 'validation' | 'architecture' | 'general';
+    suggest_topics?: boolean;
+    bc_version?: string;
+}
+export interface SystemStatus {
+    overall_health: 'healthy' | 'degraded' | 'unhealthy';
+    configuration_loaded: boolean;
+    layers_active: number;
+    total_topics: number;
+    cache_hit_rate: number;
+    uptime_seconds: number;
+}
+export declare class BCCodeIntelClient extends EventEmitter {
+    private readonly config;
+    private client;
+    private transport;
+    private connected;
+    private cache;
+    private reconnectTimer?;
+    constructor(config: BCCodeIntelClientConfig);
+    /**
+     * Connect to the BC Code Intelligence MCP server
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the server
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Search for BC knowledge topics
+     */
+    searchTopics(query: string, options?: TopicSearchOptions): Promise<BCCodeIntelTopic[]>;
+    /**
+     * Advanced layered search with AI-powered recommendations
+     */
+    smartSearch(query: string, options?: SmartSearchOptions): Promise<BCCodeIntelTopic[]>;
+    /**
+     * Get a specific topic by ID
+     */
+    getTopic(topicId: string, includeSamples?: boolean): Promise<BCCodeIntelTopic | null>;
+    /**
+     * Analyze AL code and get recommendations
+     */
+    analyzeCode(options: CodeAnalysisOptions): Promise<any>;
+    /**
+     * Get optimization workflow for a scenario
+     */
+    getOptimizationWorkflow(scenario: string, constraints?: string[]): Promise<any>;
+    /**
+     * Get system status and health information
+     */
+    getSystemStatus(): Promise<SystemStatus>;
+    /**
+     * Get layer information and statistics
+     */
+    getLayerInfo(includeStatistics?: boolean): Promise<any>;
+    /**
+     * Resolve topic across layers to see override information
+     */
+    resolveTopicLayers(topicId: string): Promise<any>;
+    /**
+     * Get comprehensive system analytics
+     */
+    getSystemAnalytics(): Promise<any>;
+    /**
+     * Reload server configuration (useful for development)
+     */
+    reloadConfiguration(force?: boolean): Promise<any>;
+    /**
+     * Get available MCP tools from the server
+     */
+    getAvailableTools(): Promise<any[]>;
+    /**
+     * Health check - verify connection and basic functionality
+     */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        latency_ms: number;
+        error?: string;
+    }>;
+    /**
+     * Batch operations for efficiency
+     */
+    batchGetTopics(topicIds: string[]): Promise<(BCCodeIntelTopic | null)[]>;
+    /**
+     * Smart topic recommendations based on current context
+     */
+    getRecommendations(currentTopic: string, maxRecommendations?: number): Promise<any[]>;
+    /**
+     * Export client configuration (sanitized)
+     */
+    getClientConfig(): Omit<BCCodeIntelClientConfig, 'debug_logging'>;
+    /**
+     * Check if client is connected
+     */
+    isConnected(): boolean;
+    callTool(toolName: string, args: any): Promise<any>;
+    private ensureConnected;
+    private scheduleReconnect;
+}
+/**
+ * Convenience factory function for creating BC Code Intelligence clients
+ */
+export declare function createBCCodeIntelClient(config: BCCodeIntelClientConfig): BCCodeIntelClient;
+/**
+ * Default configuration for common scenarios
+ */
+export declare const BCCodeIntelClientDefaults: {
+    local: (serverPath?: string) => BCCodeIntelClientConfig;
+    development: (serverPath?: string) => BCCodeIntelClientConfig;
+    production: (serverPath: string) => BCCodeIntelClientConfig;
+};
+//# sourceMappingURL=bc-code-intel-client.d.ts.map

package/dist/sdk/bc-code-intel-client.d.ts.map

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