mcp-adr-analysis-server 2.6.20 → 2.7.19

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-adr-analysis-server",
   "mcpName": "io.github.tosin2013/mcp-adr-analysis-server",
-  "version": "2.6.20",
+  "version": "2.7.19",
   "description": "MCP server for analyzing Architectural Decision Records and project architecture",
   "main": "dist/src/index.js",
   "type": "module",
@@ -49,6 +49,7 @@
     "@mendable/firecrawl-js": "^4.25.2",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "fast-glob": "^3.3.2",
+    "js-yaml": "^4.1.0",
     "openai": "^6.1.0",
     "tree-sitter": "^0.21.1",
     "tree-sitter-bash": "^0.21.0",

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

@@ -1,249 +0,0 @@
-/**
- * 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 declare enum MetricType {
-    COUNTER = "counter",
-    GAUGE = "gauge",
-    HISTOGRAM = "histogram",
-    TIMER = "timer"
-}
-/**
- * Metric category for organization
- */
-export declare enum MetricCategory {
-    REQUEST = "request",
-    RESOURCE = "resource",
-    TOOL = "tool",
-    CACHE = "cache",
-    ERROR = "error",
-    PERFORMANCE = "performance",
-    SYSTEM = "system"
-}
-/**
- * Individual metric data point
- */
-export interface Metric {
-    name: string;
-    type: MetricType;
-    category: MetricCategory;
-    value: number;
-    timestamp: string;
-    tags?: Record<string, string>;
-    metadata?: Record<string, any>;
-}
-/**
- * Aggregated metric statistics
- */
-export interface MetricStats {
-    count: number;
-    sum: number;
-    min: number;
-    max: number;
-    avg: number;
-    p50: number;
-    p95: number;
-    p99: number;
-}
-/**
- * Health check result
- */
-export interface HealthCheck {
-    name: string;
-    status: 'healthy' | 'degraded' | 'unhealthy';
-    message?: string;
-    timestamp: string;
-    duration: number;
-    metadata?: Record<string, any>;
-}
-/**
- * Request tracking data
- */
-export interface RequestMetrics {
-    requestId: string;
-    type: 'tool' | 'resource' | 'prompt';
-    name: string;
-    startTime: string;
-    endTime?: string;
-    duration?: number;
-    status: 'pending' | 'success' | 'error';
-    error?: string;
-    metadata?: Record<string, any>;
-}
-/**
- * Performance snapshot
- */
-export interface PerformanceSnapshot {
-    timestamp: string;
-    requests: {
-        total: number;
-        success: number;
-        error: number;
-        pending: number;
-    };
-    latency: {
-        p50: number;
-        p95: number;
-        p99: number;
-        avg: number;
-    };
-    throughput: {
-        requestsPerSecond: number;
-        requestsPerMinute: number;
-    };
-    cache: {
-        hitRate: number;
-        totalHits: number;
-        totalMisses: number;
-    };
-    errors: {
-        total: number;
-        byType: Record<string, number>;
-    };
-}
-/**
- * Monitoring configuration
- */
-export interface MonitoringConfig {
-    enabled: boolean;
-    metricsRetentionMs: number;
-    aggregationIntervalMs: number;
-    maxMetricsInMemory: number;
-    enableHealthChecks: boolean;
-    healthCheckIntervalMs: number;
-}
-/**
- * Monitoring manager class
- */
-export declare class MonitoringManager {
-    private config;
-    private metrics;
-    private requests;
-    private healthChecks;
-    private aggregationTimer;
-    private healthCheckTimer;
-    private startTime;
-    constructor(config?: Partial<MonitoringConfig>);
-    /**
-     * Record a counter metric (incrementing value)
-     */
-    recordCounter(name: string, category: MetricCategory, value?: number, tags?: Record<string, string>, metadata?: Record<string, any>): void;
-    /**
-     * Record a gauge metric (point-in-time value)
-     */
-    recordGauge(name: string, category: MetricCategory, value: number, tags?: Record<string, string>, metadata?: Record<string, any>): void;
-    /**
-     * Record a histogram value (for distribution analysis)
-     */
-    recordHistogram(name: string, category: MetricCategory, value: number, tags?: Record<string, string>, metadata?: Record<string, any>): void;
-    /**
-     * Start tracking a request
-     */
-    startRequest(requestId: string, type: 'tool' | 'resource' | 'prompt', name: string, metadata?: Record<string, any>): void;
-    /**
-     * Complete a request successfully
-     */
-    completeRequest(requestId: string, metadata?: Record<string, any>): void;
-    /**
-     * Mark a request as failed
-     */
-    failRequest(requestId: string, error: string, metadata?: Record<string, any>): void;
-    /**
-     * Record cache hit
-     */
-    recordCacheHit(cacheKey: string): void;
-    /**
-     * Record cache miss
-     */
-    recordCacheMiss(cacheKey: string): void;
-    /**
-     * Register a health check
-     */
-    registerHealthCheck(_name: string, _check: () => Promise<{
-        status: 'healthy' | 'degraded' | 'unhealthy';
-        message?: string;
-    }>): void;
-    /**
-     * Run a health check
-     */
-    runHealthCheck(name: string, check: () => Promise<{
-        status: 'healthy' | 'degraded' | 'unhealthy';
-        message?: string;
-    }>): Promise<HealthCheck>;
-    /**
-     * Get all health checks
-     */
-    getHealthChecks(): HealthCheck[];
-    /**
-     * Get overall health status
-     */
-    getHealthStatus(): 'healthy' | 'degraded' | 'unhealthy';
-    /**
-     * Get performance snapshot
-     */
-    getPerformanceSnapshot(): PerformanceSnapshot;
-    /**
-     * Get metric statistics by name and category
-     */
-    getMetricStats(name: string, category: MetricCategory): MetricStats | null;
-    /**
-     * Get all metrics
-     */
-    getMetrics(): Metric[];
-    /**
-     * Get metrics by category
-     */
-    getMetricsByCategory(category: MetricCategory): Metric[];
-    /**
-     * Get recent requests
-     */
-    getRecentRequests(limit?: number): RequestMetrics[];
-    /**
-     * Clear old metrics based on retention policy
-     */
-    cleanup(): number;
-    /**
-     * Reset all metrics
-     */
-    reset(): void;
-    /**
-     * Stop monitoring
-     */
-    stop(): void;
-    /**
-     * Get uptime in milliseconds
-     */
-    getUptime(): number;
-    /**
-     * Export metrics to JSON
-     */
-    exportMetrics(): string;
-    private addMetric;
-    private getMetricSum;
-    private calculatePercentiles;
-    private calculateStats;
-    private percentile;
-    private startAggregation;
-    private startHealthChecks;
-}
-/**
- * Singleton monitoring instance
- */
-export declare const monitoring: MonitoringManager;
-/**
- * Helper to track async operations
- */
-export declare function trackOperation<T>(operation: () => Promise<T>, name: string, category: MetricCategory, tags?: Record<string, string>): Promise<T>;
-//# sourceMappingURL=monitoring.d.ts.map

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

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