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

package/dist/layers/project-layer.js

@@ -0,0 +1,286 @@
+/**
+ * Project Knowledge Layer
+ *
+ * Loads project-specific knowledge overrides from ./bckb-overrides/ directory.
+ * This is the highest priority layer that can override any embedded knowledge.
+ */
+import { readFile, stat, access } from 'fs/promises';
+import { join, basename } from 'path';
+import * as yaml from 'yaml';
+import glob from 'fast-glob';
+import { AtomicTopicFrontmatterSchema } from '../types/bc-knowledge.js';
+import { LayerPriority } from '../types/layer-types.js';
+import { BaseKnowledgeLayer } from './base-layer.js';
+export class ProjectKnowledgeLayer extends BaseKnowledgeLayer {
+    projectPath;
+    constructor(projectPath = './bckb-overrides') {
+        super('project', LayerPriority.PROJECT, true);
+        this.projectPath = projectPath;
+    }
+    /**
+     * Initialize the project layer by checking for and loading overrides
+     */
+    async initialize() {
+        if (this.initialized) {
+            return this.loadResult;
+        }
+        const startTime = Date.now();
+        try {
+            // Check if the project overrides directory exists
+            const exists = await this.checkProjectDirectoryExists();
+            if (!exists) {
+                console.error(`No project overrides found at ${this.projectPath} - skipping project layer`);
+                const loadTimeMs = Date.now() - startTime;
+                this.initialized = true;
+                this.loadResult = this.createLoadResult(0, 0, loadTimeMs);
+                return this.loadResult;
+            }
+            console.error(`Initializing ${this.name} layer from ${this.projectPath}...`);
+            // Load all content types in parallel
+            const [topicsLoaded, specialistsLoaded, methodologiesLoaded, indexesLoaded] = await Promise.all([
+                this.loadTopics(),
+                this.loadSpecialists(),
+                this.loadMethodologies(),
+                this.loadIndexes()
+            ]);
+            const loadTimeMs = Date.now() - startTime;
+            this.initialized = true;
+            this.loadResult = this.createLoadResult(topicsLoaded, indexesLoaded, loadTimeMs);
+            console.error(`✅ ${this.name} layer loaded: ${topicsLoaded} topics, ${specialistsLoaded} specialists, ${methodologiesLoaded} methodologies, ${indexesLoaded} indexes (${loadTimeMs}ms)`);
+            return this.loadResult;
+        }
+        catch (error) {
+            const loadTimeMs = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.loadResult = this.createErrorResult(errorMessage, loadTimeMs);
+            console.error(`❌ Failed to initialize ${this.name} layer: ${errorMessage}`);
+            throw error;
+        }
+    }
+    /**
+     * Check if the project overrides directory exists
+     */
+    async checkProjectDirectoryExists() {
+        try {
+            await access(this.projectPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Load override topics from project directory
+     */
+    async loadTopics() {
+        // Look for markdown files in various potential structures
+        const patterns = [
+            join(this.projectPath, '**', '*.md'),
+            join(this.projectPath, 'domains', '**', '*.md'),
+            join(this.projectPath, 'topics', '**', '*.md'),
+            join(this.projectPath, 'overrides', '**', '*.md')
+        ];
+        let allTopicFiles = [];
+        for (const pattern of patterns) {
+            try {
+                const files = await glob(pattern.replace(/\\/g, '/'), {
+                    ignore: ['**/samples/**', '**/node_modules/**', '**/.git/**']
+                });
+                allTopicFiles.push(...files);
+            }
+            catch (error) {
+                // Pattern might not match anything, which is OK
+            }
+        }
+        // Remove duplicates
+        const uniqueTopicFiles = [...new Set(allTopicFiles)];
+        console.error(`Found ${uniqueTopicFiles.length} override topic files in ${this.projectPath}`);
+        let loadedCount = 0;
+        for (const filePath of uniqueTopicFiles) {
+            try {
+                const topic = await this.loadAtomicTopic(filePath);
+                if (topic && this.validateTopic(topic)) {
+                    this.topics.set(topic.id, topic);
+                    loadedCount++;
+                    console.error(`📝 Override loaded: ${topic.id}`);
+                }
+                else {
+                    console.error(`Invalid override topic structure in ${filePath}`);
+                }
+            }
+            catch (error) {
+                console.error(`Failed to load override topic ${filePath}:`, error instanceof Error ? error.message : String(error));
+            }
+        }
+        return loadedCount;
+    }
+    /**
+     * Load project-specific indexes (if any)
+     */
+    async loadIndexes() {
+        const indexPaths = [
+            join(this.projectPath, 'indexes'),
+            join(this.projectPath, 'config')
+        ];
+        let loadedIndexes = 0;
+        for (const indexesPath of indexPaths) {
+            try {
+                await access(indexesPath);
+                // Load any JSON files as indexes
+                const jsonFiles = await glob('*.json', { cwd: indexesPath });
+                for (const jsonFile of jsonFiles) {
+                    try {
+                        const filePath = join(indexesPath, jsonFile);
+                        const content = await readFile(filePath, 'utf-8');
+                        const cleanContent = content.replace(/^\uFEFF/, ''); // Remove BOM
+                        const indexData = JSON.parse(cleanContent);
+                        const indexName = `project:${basename(jsonFile, '.json')}`;
+                        this.indexes.set(indexName, indexData);
+                        loadedIndexes++;
+                        console.error(`📋 Project index loaded: ${indexName}`);
+                    }
+                    catch (error) {
+                        console.error(`Failed to load project index ${jsonFile}:`, error instanceof Error ? error.message : String(error));
+                    }
+                }
+            }
+            catch {
+                // Index directory doesn't exist, which is OK
+            }
+        }
+        return loadedIndexes;
+    }
+    /**
+     * Load project-specific specialists
+     */
+    async loadSpecialists() {
+        const specialistsPath = join(this.projectPath, 'specialists');
+        try {
+            await access(specialistsPath);
+            // TODO: Implement specialist loading when needed
+        }
+        catch (error) {
+            // specialists/ directory doesn't exist - that's okay
+        }
+        return this.specialists.size;
+    }
+    /**
+     * Load project-specific methodologies
+     */
+    async loadMethodologies() {
+        const methodologiesPath = join(this.projectPath, 'methodologies');
+        try {
+            await access(methodologiesPath);
+            // TODO: Implement methodology loading when needed
+        }
+        catch (error) {
+            // methodologies/ directory doesn't exist - that's okay
+        }
+        return this.methodologies.size;
+    }
+    /**
+     * Load a single override topic from a markdown file
+     */
+    async loadAtomicTopic(filePath) {
+        const content = await readFile(filePath, 'utf-8');
+        const stats = await stat(filePath);
+        // Normalize line endings
+        const normalizedContent = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+        // Extract YAML frontmatter
+        const frontmatterMatch = normalizedContent.match(/^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/);
+        if (!frontmatterMatch) {
+            return null;
+        }
+        const [, frontmatterContent, markdownContent] = frontmatterMatch;
+        // Parse and validate frontmatter
+        const frontmatterData = yaml.parse(frontmatterContent || '');
+        const frontmatter = AtomicTopicFrontmatterSchema.parse(frontmatterData);
+        // Generate topic ID from file path relative to project root
+        const topicId = this.normalizeTopicId(filePath, this.projectPath);
+        // Load companion sample file if exists
+        let samples;
+        if (frontmatter.samples) {
+            const samplesPath = join(filePath, '..', frontmatter.samples);
+            try {
+                const sampleContent = await readFile(samplesPath, 'utf-8');
+                samples = { filePath: samplesPath, content: sampleContent };
+            }
+            catch {
+                // Sample file doesn't exist, which is OK
+            }
+        }
+        return {
+            id: topicId,
+            title: frontmatter.title || topicId.replace(/-/g, ' '),
+            filePath,
+            frontmatter: {
+                ...frontmatter,
+                // Mark as override for identification
+                tags: [...(frontmatter.tags || []), 'project-override']
+            },
+            content: markdownContent?.trim() || '',
+            wordCount: markdownContent?.split(/\s+/).length || 0,
+            lastModified: stats.mtime,
+            samples: samples || undefined
+        };
+    }
+    /**
+     * Check if this layer can provide overrides for a specific topic
+     */
+    canOverride(topicId) {
+        return this.hasTopic(topicId);
+    }
+    /**
+     * Get the override configuration for this layer
+     */
+    getOverrideConfig() {
+        const config = {};
+        for (const topicId of this.getTopicIds()) {
+            config[topicId] = {
+                strategy: 'replace',
+                source: this.name
+            };
+        }
+        return config;
+    }
+    /**
+     * Create a sample project override structure
+     */
+    static generateSampleStructure() {
+        return `
+bckb-overrides/
+├── domains/
+│   ├── performance/
+│   │   └── al-performance-optimization.md    # Override embedded topic
+│   └── custom-domain/
+│       └── company-specific-pattern.md       # New company-specific topic
+├── indexes/
+│   └── company-standards.json                # Company-specific standards
+└── README.md                                 # Documentation for overrides
+
+Example override topic (bckb-overrides/domains/performance/al-performance-optimization.md):
+---
+title: "AL Performance Optimization - Company Standards"
+domain: "performance"
+difficulty: "intermediate"
+bc_versions: "14+"
+tags: ["performance", "sift", "company-standard"]
+related_topics: ["database-optimization", "query-patterns"]
+---
+
+# AL Performance Optimization - Company Standards
+
+This topic overrides the standard performance optimization guidance with
+company-specific requirements and standards.
+
+## Company Requirements
+
+- All queries must use SetLoadFields
+- SIFT optimization is mandatory for all reporting
+- Performance testing required for all table operations
+
+[Company-specific content here...]
+`.trim();
+    }
+}
+//# sourceMappingURL=project-layer.js.map

package/dist/layers/project-layer.js.map

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

package/dist/monitoring/production-monitor.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Production Monitoring & Health Management System
+ *
+ * Comprehensive monitoring, health checks, metrics collection, and alerting
+ * for production deployments with Docker, Kubernetes, and cloud integration.
+ */
+import { EventEmitter } from 'events';
+import { PerformanceMonitor } from '../performance/performance-monitor.js';
+import { SecurityManager } from '../security/access-control.js';
+import { AdvancedCacheManager } from '../cache/cache-manager.js';
+export interface HealthCheckResult {
+    service: string;
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    message: string;
+    details?: Record<string, any>;
+    response_time_ms: number;
+    timestamp: number;
+}
+export interface SystemMetrics {
+    timestamp: number;
+    system: {
+        uptime_seconds: number;
+        memory_usage_mb: number;
+        memory_usage_percentage: number;
+        cpu_usage_percentage: number;
+        process_id: number;
+        node_version: string;
+    };
+    application: {
+        active_layers: number;
+        total_topics: number;
+        cache_hit_rate: number;
+        average_response_time_ms: number;
+        requests_per_minute: number;
+        error_rate_percentage: number;
+    };
+    performance: {
+        slowest_operations: Array<{
+            operation: string;
+            duration_ms: number;
+        }>;
+        operations_per_second: number;
+        p95_response_time_ms: number;
+        p99_response_time_ms: number;
+    };
+    security: {
+        active_sessions: number;
+        failed_authentications_last_hour: number;
+        rate_limited_requests: number;
+        suspicious_activities: number;
+    };
+}
+export interface AlertRule {
+    id: string;
+    name: string;
+    condition: string;
+    severity: 'info' | 'warning' | 'critical';
+    cooldown_minutes: number;
+    enabled: boolean;
+}
+export interface Alert {
+    id: string;
+    rule_id: string;
+    message: string;
+    severity: AlertRule['severity'];
+    timestamp: number;
+    resolved: boolean;
+    resolved_at?: number;
+    metadata: Record<string, any>;
+}
+export declare class ProductionMonitor extends EventEmitter {
+    private readonly performanceMonitor;
+    private readonly securityManager?;
+    private readonly cacheManager?;
+    private readonly enableFileLogging;
+    private readonly metricsRetentionHours;
+    private healthChecks;
+    private activeAlerts;
+    private alertHistory;
+    private alertCooldowns;
+    private metricsHistory;
+    private startTime;
+    private healthCheckInterval?;
+    private metricsCollectionInterval?;
+    private readonly defaultAlertRules;
+    private alertRules;
+    constructor(performanceMonitor: PerformanceMonitor, securityManager?: SecurityManager, cacheManager?: AdvancedCacheManager, enableFileLogging?: boolean, metricsRetentionHours?: number);
+    /**
+     * Register a custom health check
+     */
+    registerHealthCheck(name: string, checkFn: () => Promise<HealthCheckResult>): void;
+    /**
+     * Run all health checks and return results
+     */
+    runHealthChecks(): Promise<{
+        status: 'healthy' | 'degraded' | 'unhealthy';
+        checks: HealthCheckResult[];
+    }>;
+    /**
+     * Collect current system metrics
+     */
+    collectMetrics(): Promise<SystemMetrics>;
+    /**
+     * Get metrics history for time range
+     */
+    getMetricsHistory(hoursBack?: number): SystemMetrics[];
+    /**
+     * Get active alerts
+     */
+    getActiveAlerts(): Alert[];
+    /**
+     * Get alert history
+     */
+    getAlertHistory(limit?: number): Alert[];
+    /**
+     * Resolve an active alert
+     */
+    resolveAlert(alertId: string): boolean;
+    /**
+     * Export comprehensive system status for monitoring dashboards
+     */
+    getSystemStatus(): Promise<{
+        overall_health: 'healthy' | 'degraded' | 'unhealthy';
+        health_checks: HealthCheckResult[];
+        current_metrics: SystemMetrics;
+        active_alerts: Alert[];
+        performance_summary: any;
+        uptime_seconds: number;
+    }>;
+    /**
+     * Export monitoring data for external systems (Prometheus, etc.)
+     */
+    exportMetricsForPrometheus(): string;
+    /**
+     * Shutdown monitoring and cleanup
+     */
+    shutdown(): void;
+    private setupDefaultHealthChecks;
+    private startMonitoring;
+    private evaluateAlerts;
+    private evaluateCondition;
+    private createAlert;
+    private logAlertToFile;
+    private getRecentFailedAuthentications;
+    private getSystemMemory;
+    private getCPUUsage;
+}
+//# sourceMappingURL=production-monitor.d.ts.map

package/dist/monitoring/production-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-monitor.d.ts","sourceRoot":"","sources":["../../src/monitoring/production-monitor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAuB,MAAM,uCAAuC,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAc,MAAM,2BAA2B,CAAC;AAE7E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,uBAAuB,EAAE,MAAM,CAAC;QAChC,oBAAoB,EAAE,MAAM,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,WAAW,EAAE;QACX,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,wBAAwB,EAAE,MAAM,CAAC;QACjC,mBAAmB,EAAE,MAAM,CAAC;QAC5B,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,WAAW,EAAE;QACX,kBAAkB,EAAE,KAAK,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACtE,qBAAqB,EAAE,MAAM,CAAC;QAC9B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,EAAE;QACR,eAAe,EAAE,MAAM,CAAC;QACxB,gCAAgC,EAAE,MAAM,CAAC;QACzC,qBAAqB,EAAE,MAAM,CAAC;QAC9B,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,qBAAa,iBAAkB,SAAQ,YAAY;IAgE/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAnExC,OAAO,CAAC,YAAY,CAAuD;IAC3E,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,mBAAmB,CAAC,CAAiB;IAC7C,OAAO,CAAC,yBAAyB,CAAC,CAAiB;IAEnD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAiDhC;IAEF,OAAO,CAAC,UAAU,CAA4C;gBAG3C,kBAAkB,EAAE,kBAAkB,EACtC,eAAe,CAAC,EAAE,eAAe,EACjC,YAAY,CAAC,EAAE,oBAAoB,EACnC,iBAAiB,GAAE,OAAc,EACjC,qBAAqB,GAAE,MAAW;IAUrD;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAKlF;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;QAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC;IA8B/G;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC;IAgE9C;;OAEG;IACH,iBAAiB,CAAC,SAAS,GAAE,MAAU,GAAG,aAAa,EAAE;IAKzD;;OAEG;IACH,eAAe,IAAI,KAAK,EAAE;IAI1B;;OAEG;IACH,eAAe,CAAC,KAAK,GAAE,MAAY,GAAG,KAAK,EAAE;IAI7C;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYtC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC;QAC/B,cAAc,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;QACrD,aAAa,EAAE,iBAAiB,EAAE,CAAC;QACnC,eAAe,EAAE,aAAa,CAAC;QAC/B,aAAa,EAAE,KAAK,EAAE,CAAC;QACvB,mBAAmB,EAAE,GAAG,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IAeF;;OAEG;IACH,0BAA0B,IAAI,MAAM;IA4CpC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAahB,OAAO,CAAC,wBAAwB;IAkEhC,OAAO,CAAC,eAAe;YAoBT,cAAc;IA+B5B,OAAO,CAAC,iBAAiB;IAyBzB,OAAO,CAAC,WAAW;YAeL,cAAc;IAiB5B,OAAO,CAAC,8BAA8B;YAWxB,eAAe;YAaf,WAAW;CAK1B"}