mcp-adr-analysis-server 2.1.11 → 2.1.20

package/dist/src/utils/monitoring.d.ts.map

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

package/dist/src/utils/monitoring.js

@@ -0,0 +1,513 @@
+/**
+ * Monitoring and Analytics Framework
+ *
+ * Provides comprehensive monitoring and analytics for MCP server:
+ * - Request/response tracking
+ * - Performance metrics (latency, throughput)
+ * - Error tracking and reporting
+ * - Resource usage analytics
+ * - Cache performance metrics
+ * - Tool execution metrics
+ * - Health checks
+ * - Metrics aggregation and reporting
+ */
+/**
+ * Metric types for categorization
+ */
+export var MetricType;
+(function (MetricType) {
+    MetricType["COUNTER"] = "counter";
+    MetricType["GAUGE"] = "gauge";
+    MetricType["HISTOGRAM"] = "histogram";
+    MetricType["TIMER"] = "timer";
+})(MetricType || (MetricType = {}));
+/**
+ * Metric category for organization
+ */
+export var MetricCategory;
+(function (MetricCategory) {
+    MetricCategory["REQUEST"] = "request";
+    MetricCategory["RESOURCE"] = "resource";
+    MetricCategory["TOOL"] = "tool";
+    MetricCategory["CACHE"] = "cache";
+    MetricCategory["ERROR"] = "error";
+    MetricCategory["PERFORMANCE"] = "performance";
+    MetricCategory["SYSTEM"] = "system";
+})(MetricCategory || (MetricCategory = {}));
+/**
+ * Default monitoring configuration
+ */
+const DEFAULT_CONFIG = {
+    enabled: true,
+    metricsRetentionMs: 3600000, // 1 hour
+    aggregationIntervalMs: 60000, // 1 minute
+    maxMetricsInMemory: 10000,
+    enableHealthChecks: true,
+    healthCheckIntervalMs: 30000, // 30 seconds
+};
+/**
+ * Monitoring manager class
+ */
+export class MonitoringManager {
+    config;
+    metrics = [];
+    requests = new Map();
+    healthChecks = new Map();
+    aggregationTimer = null;
+    healthCheckTimer = null;
+    startTime;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.startTime = new Date().toISOString();
+        if (this.config.enabled) {
+            this.startAggregation();
+            if (this.config.enableHealthChecks) {
+                this.startHealthChecks();
+            }
+        }
+    }
+    /**
+     * Record a counter metric (incrementing value)
+     */
+    recordCounter(name, category, value = 1, tags, metadata) {
+        if (!this.config.enabled)
+            return;
+        const metric = {
+            name,
+            type: MetricType.COUNTER,
+            category,
+            value,
+            timestamp: new Date().toISOString(),
+        };
+        if (tags) {
+            metric.tags = tags;
+        }
+        if (metadata) {
+            metric.metadata = metadata;
+        }
+        this.addMetric(metric);
+    }
+    /**
+     * Record a gauge metric (point-in-time value)
+     */
+    recordGauge(name, category, value, tags, metadata) {
+        if (!this.config.enabled)
+            return;
+        const metric = {
+            name,
+            type: MetricType.GAUGE,
+            category,
+            value,
+            timestamp: new Date().toISOString(),
+        };
+        if (tags) {
+            metric.tags = tags;
+        }
+        if (metadata) {
+            metric.metadata = metadata;
+        }
+        this.addMetric(metric);
+    }
+    /**
+     * Record a histogram value (for distribution analysis)
+     */
+    recordHistogram(name, category, value, tags, metadata) {
+        if (!this.config.enabled)
+            return;
+        const metric = {
+            name,
+            type: MetricType.HISTOGRAM,
+            category,
+            value,
+            timestamp: new Date().toISOString(),
+        };
+        if (tags) {
+            metric.tags = tags;
+        }
+        if (metadata) {
+            metric.metadata = metadata;
+        }
+        this.addMetric(metric);
+    }
+    /**
+     * Start tracking a request
+     */
+    startRequest(requestId, type, name, metadata) {
+        if (!this.config.enabled)
+            return;
+        const request = {
+            requestId,
+            type,
+            name,
+            startTime: new Date().toISOString(),
+            status: 'pending',
+        };
+        if (metadata) {
+            request.metadata = metadata;
+        }
+        this.requests.set(requestId, request);
+        this.recordCounter('request.started', MetricCategory.REQUEST, 1, { type, name });
+    }
+    /**
+     * Complete a request successfully
+     */
+    completeRequest(requestId, metadata) {
+        if (!this.config.enabled)
+            return;
+        const request = this.requests.get(requestId);
+        if (!request)
+            return;
+        const endTime = new Date().toISOString();
+        const duration = new Date(endTime).getTime() - new Date(request.startTime).getTime();
+        request.endTime = endTime;
+        request.duration = duration;
+        request.status = 'success';
+        if (metadata) {
+            request.metadata = { ...request.metadata, ...metadata };
+        }
+        this.recordCounter('request.completed', MetricCategory.REQUEST, 1, {
+            type: request.type,
+            name: request.name,
+        });
+        this.recordHistogram('request.duration', MetricCategory.PERFORMANCE, duration, {
+            type: request.type,
+            name: request.name,
+        });
+    }
+    /**
+     * Mark a request as failed
+     */
+    failRequest(requestId, error, metadata) {
+        if (!this.config.enabled)
+            return;
+        const request = this.requests.get(requestId);
+        if (!request)
+            return;
+        const endTime = new Date().toISOString();
+        const duration = new Date(endTime).getTime() - new Date(request.startTime).getTime();
+        request.endTime = endTime;
+        request.duration = duration;
+        request.status = 'error';
+        request.error = error;
+        if (metadata) {
+            request.metadata = { ...request.metadata, ...metadata };
+        }
+        this.recordCounter('request.failed', MetricCategory.REQUEST, 1, {
+            type: request.type,
+            name: request.name,
+        });
+        this.recordCounter('error.total', MetricCategory.ERROR, 1, {
+            type: request.type,
+            name: request.name,
+            error,
+        });
+    }
+    /**
+     * Record cache hit
+     */
+    recordCacheHit(cacheKey) {
+        if (!this.config.enabled)
+            return;
+        this.recordCounter('cache.hit', MetricCategory.CACHE, 1, { key: cacheKey });
+    }
+    /**
+     * Record cache miss
+     */
+    recordCacheMiss(cacheKey) {
+        if (!this.config.enabled)
+            return;
+        this.recordCounter('cache.miss', MetricCategory.CACHE, 1, { key: cacheKey });
+    }
+    /**
+     * Register a health check
+     */
+    registerHealthCheck(_name, _check) {
+        // Store health check function for periodic execution
+        // Implementation would store the check function and run it periodically
+        // For now, we'll just track the results when manually called
+    }
+    /**
+     * Run a health check
+     */
+    async runHealthCheck(name, check) {
+        const startTime = Date.now();
+        const timestamp = new Date().toISOString();
+        try {
+            const result = await check();
+            const duration = Date.now() - startTime;
+            const healthCheck = {
+                name,
+                status: result.status,
+                timestamp,
+                duration,
+            };
+            if (result.message) {
+                healthCheck.message = result.message;
+            }
+            this.healthChecks.set(name, healthCheck);
+            return healthCheck;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const healthCheck = {
+                name,
+                status: 'unhealthy',
+                message: error instanceof Error ? error.message : 'Unknown error',
+                timestamp,
+                duration,
+            };
+            this.healthChecks.set(name, healthCheck);
+            return healthCheck;
+        }
+    }
+    /**
+     * Get all health checks
+     */
+    getHealthChecks() {
+        return Array.from(this.healthChecks.values());
+    }
+    /**
+     * Get overall health status
+     */
+    getHealthStatus() {
+        const checks = this.getHealthChecks();
+        if (checks.length === 0)
+            return 'healthy';
+        const unhealthy = checks.filter(c => c.status === 'unhealthy');
+        const degraded = checks.filter(c => c.status === 'degraded');
+        if (unhealthy.length > 0)
+            return 'unhealthy';
+        if (degraded.length > 0)
+            return 'degraded';
+        return 'healthy';
+    }
+    /**
+     * Get performance snapshot
+     */
+    getPerformanceSnapshot() {
+        const now = new Date().toISOString();
+        const requests = Array.from(this.requests.values());
+        const total = requests.length;
+        const success = requests.filter(r => r.status === 'success').length;
+        const error = requests.filter(r => r.status === 'error').length;
+        const pending = requests.filter(r => r.status === 'pending').length;
+        // Calculate latency percentiles
+        const durations = requests
+            .filter(r => r.duration !== undefined)
+            .map(r => r.duration)
+            .sort((a, b) => a - b);
+        const latency = this.calculatePercentiles(durations);
+        // Calculate throughput
+        const oneMinuteAgo = Date.now() - 60000;
+        const recentRequests = requests.filter(r => r.startTime && new Date(r.startTime).getTime() > oneMinuteAgo);
+        const throughput = {
+            requestsPerSecond: recentRequests.length / 60,
+            requestsPerMinute: recentRequests.length,
+        };
+        // Cache metrics
+        const cacheHits = this.getMetricSum('cache.hit', MetricCategory.CACHE);
+        const cacheMisses = this.getMetricSum('cache.miss', MetricCategory.CACHE);
+        const cacheTotal = cacheHits + cacheMisses;
+        const hitRate = cacheTotal > 0 ? cacheHits / cacheTotal : 0;
+        // Error metrics
+        const errorMetrics = this.metrics.filter(m => m.category === MetricCategory.ERROR);
+        const errorsByType = {};
+        for (const metric of errorMetrics) {
+            const errorType = metric.tags?.['error'] || 'unknown';
+            errorsByType[errorType] = (errorsByType[errorType] || 0) + metric.value;
+        }
+        return {
+            timestamp: now,
+            requests: { total, success, error, pending },
+            latency,
+            throughput,
+            cache: {
+                hitRate,
+                totalHits: cacheHits,
+                totalMisses: cacheMisses,
+            },
+            errors: {
+                total: error,
+                byType: errorsByType,
+            },
+        };
+    }
+    /**
+     * Get metric statistics by name and category
+     */
+    getMetricStats(name, category) {
+        const metricValues = this.metrics
+            .filter(m => m.name === name && m.category === category)
+            .map(m => m.value)
+            .sort((a, b) => a - b);
+        if (metricValues.length === 0)
+            return null;
+        return this.calculateStats(metricValues);
+    }
+    /**
+     * Get all metrics
+     */
+    getMetrics() {
+        return [...this.metrics];
+    }
+    /**
+     * Get metrics by category
+     */
+    getMetricsByCategory(category) {
+        return this.metrics.filter(m => m.category === category);
+    }
+    /**
+     * Get recent requests
+     */
+    getRecentRequests(limit = 100) {
+        return Array.from(this.requests.values())
+            .sort((a, b) => new Date(b.startTime).getTime() - new Date(a.startTime).getTime())
+            .slice(0, limit);
+    }
+    /**
+     * Clear old metrics based on retention policy
+     */
+    cleanup() {
+        const cutoff = Date.now() - this.config.metricsRetentionMs;
+        const initialCount = this.metrics.length;
+        this.metrics = this.metrics.filter(m => new Date(m.timestamp).getTime() > cutoff);
+        // Also clean up old requests
+        const requestsToDelete = [];
+        for (const [id, request] of this.requests.entries()) {
+            if (request.endTime && new Date(request.endTime).getTime() < cutoff) {
+                requestsToDelete.push(id);
+            }
+        }
+        requestsToDelete.forEach(id => this.requests.delete(id));
+        return initialCount - this.metrics.length;
+    }
+    /**
+     * Reset all metrics
+     */
+    reset() {
+        this.metrics = [];
+        this.requests.clear();
+        this.healthChecks.clear();
+    }
+    /**
+     * Stop monitoring
+     */
+    stop() {
+        if (this.aggregationTimer) {
+            clearInterval(this.aggregationTimer);
+            this.aggregationTimer = null;
+        }
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = null;
+        }
+    }
+    /**
+     * Get uptime in milliseconds
+     */
+    getUptime() {
+        return Date.now() - new Date(this.startTime).getTime();
+    }
+    /**
+     * Export metrics to JSON
+     */
+    exportMetrics() {
+        return JSON.stringify({
+            metrics: this.metrics,
+            requests: Array.from(this.requests.values()),
+            healthChecks: Array.from(this.healthChecks.values()),
+            performance: this.getPerformanceSnapshot(),
+            uptime: this.getUptime(),
+            timestamp: new Date().toISOString(),
+        }, null, 2);
+    }
+    // Private methods
+    addMetric(metric) {
+        this.metrics.push(metric);
+        // Enforce max metrics limit
+        if (this.metrics.length > this.config.maxMetricsInMemory) {
+            const toRemove = this.metrics.length - this.config.maxMetricsInMemory;
+            this.metrics.splice(0, toRemove);
+        }
+    }
+    getMetricSum(name, category) {
+        return this.metrics
+            .filter(m => m.name === name && m.category === category)
+            .reduce((sum, m) => sum + m.value, 0);
+    }
+    calculatePercentiles(values) {
+        if (values.length === 0) {
+            return { p50: 0, p95: 0, p99: 0, avg: 0 };
+        }
+        const sorted = [...values].sort((a, b) => a - b);
+        const avg = sorted.reduce((sum, v) => sum + v, 0) / sorted.length;
+        return {
+            p50: this.percentile(sorted, 50),
+            p95: this.percentile(sorted, 95),
+            p99: this.percentile(sorted, 99),
+            avg,
+        };
+    }
+    calculateStats(values) {
+        if (values.length === 0) {
+            return { count: 0, sum: 0, min: 0, max: 0, avg: 0, p50: 0, p95: 0, p99: 0 };
+        }
+        const sorted = [...values].sort((a, b) => a - b);
+        const sum = sorted.reduce((s, v) => s + v, 0);
+        const avg = sum / sorted.length;
+        return {
+            count: sorted.length,
+            sum,
+            min: sorted[0],
+            max: sorted[sorted.length - 1],
+            avg,
+            p50: this.percentile(sorted, 50),
+            p95: this.percentile(sorted, 95),
+            p99: this.percentile(sorted, 99),
+        };
+    }
+    percentile(sorted, p) {
+        if (sorted.length === 0)
+            return 0;
+        const index = Math.ceil((p / 100) * sorted.length) - 1;
+        return sorted[Math.max(0, index)] || 0;
+    }
+    startAggregation() {
+        this.aggregationTimer = setInterval(() => {
+            this.cleanup();
+        }, this.config.aggregationIntervalMs);
+    }
+    startHealthChecks() {
+        // Placeholder for periodic health check execution
+        this.healthCheckTimer = setInterval(() => {
+            // Would run registered health checks here
+        }, this.config.healthCheckIntervalMs);
+    }
+}
+/**
+ * Singleton monitoring instance
+ */
+export const monitoring = new MonitoringManager();
+/**
+ * Helper to track async operations
+ */
+export async function trackOperation(operation, name, category, tags) {
+    const startTime = Date.now();
+    try {
+        const result = await operation();
+        const duration = Date.now() - startTime;
+        monitoring.recordHistogram(`${name}.duration`, category, duration, tags);
+        monitoring.recordCounter(`${name}.success`, category, 1, tags);
+        return result;
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        monitoring.recordHistogram(`${name}.duration`, category, duration, tags);
+        monitoring.recordCounter(`${name}.error`, category, 1, {
+            ...tags,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=monitoring.js.map

package/dist/src/utils/monitoring.js.map

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

package/dist/src/utils/pattern-contribution-helper.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Pattern Contribution Helper
+ *
+ * Helps users contribute missing patterns to the validatedpatterns project
+ * by creating well-formatted GitHub issues with detection evidence.
+ */
+import type { PlatformDetectionResult } from './platform-detector.js';
+/**
+ * GitHub issue creation result
+ */
+export interface GitHubIssueResult {
+    success: boolean;
+    issueUrl?: string;
+    issueNumber?: number;
+    issueTitle: string;
+    issueBody: string;
+    error?: string;
+}
+/**
+ * Helper for creating GitHub issues for missing patterns
+ */
+export declare class PatternContributionHelper {
+    private logger;
+    constructor();
+    /**
+     * Prompt user to contribute missing pattern
+     */
+    promptUserForContribution(platform: string, detection: PlatformDetectionResult): string;
+    /**
+     * Prepare GitHub issue content for missing pattern
+     */
+    prepareIssueContent(platform: string, detection: PlatformDetectionResult): {
+        title: string;
+        body: string;
+    };
+    /**
+     * Create GitHub issue (placeholder for actual GitHub API integration)
+     *
+     * In production, this would use Octokit to create the issue.
+     * For now, it returns the issue content for manual creation.
+     */
+    createGitHubIssue(platform: string, detection: PlatformDetectionResult, _options?: {
+        githubToken?: string;
+        repository?: string;
+        owner?: string;
+    }): Promise<GitHubIssueResult>;
+    /**
+     * Generate summary message for user after issue creation
+     */
+    generateSuccessMessage(result: GitHubIssueResult, platform: string): string;
+    /**
+     * Check if GitHub token is configured for automatic issue creation
+     */
+    isGitHubConfigured(): boolean;
+    /**
+     * Get GitHub configuration status message
+     */
+    getConfigurationStatus(): string;
+}
+//# sourceMappingURL=pattern-contribution-helper.d.ts.map

package/dist/src/utils/pattern-contribution-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-contribution-helper.d.ts","sourceRoot":"","sources":["../../../src/utils/pattern-contribution-helper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGtE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAiB;;IAM/B;;OAEG;IACH,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,uBAAuB,GAAG,MAAM;IA2CvF;;OAEG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,uBAAuB,GACjC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IA4JlC;;;;;OAKG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,uBAAuB,EAClC,QAAQ,CAAC,EAAE;QACT,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,iBAAiB,CAAC;IA+C7B;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAuC3E;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,sBAAsB,IAAI,MAAM;CAOjC"}