@skillsmith/core 0.5.5 → 0.5.6

package/dist/analysis/memory-monitor.d.ts

@@ -0,0 +1,199 @@
+/**
+ * SMI-1308: Memory Monitor
+ *
+ * Monitors memory usage and triggers cleanup when thresholds are exceeded.
+ * Integrates with ParseCache for memory pressure handling.
+ *
+ * @see docs/internal/architecture/multi-language-analysis.md
+ * @module analysis/memory-monitor
+ */
+import type { ParseCache } from './cache.js';
+/**
+ * Memory usage statistics
+ */
+export interface MemoryStats {
+    /** Heap used in bytes */
+    heapUsed: number;
+    /** Total heap size in bytes */
+    heapTotal: number;
+    /** External memory in bytes */
+    external: number;
+    /** ArrayBuffers memory in bytes */
+    arrayBuffers: number;
+    /** Resident set size in bytes */
+    rss: number;
+    /** Memory threshold in bytes */
+    threshold: number;
+    /** Whether currently over threshold */
+    isOverThreshold: boolean;
+}
+/**
+ * Result of a cleanup operation
+ */
+export interface CleanupResult {
+    /** Whether cleanup was performed */
+    cleaned: boolean;
+    /** Bytes freed (estimated) */
+    freedBytes: number;
+    /** Cleanup reason */
+    reason?: string;
+}
+/**
+ * Options for MemoryMonitor
+ */
+export interface MemoryMonitorOptions {
+    /** Memory threshold in MB (default: 500) */
+    thresholdMB?: number;
+    /** ParseCache instance for cleanup */
+    cache?: ParseCache;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Monitor memory usage and trigger cleanup when needed
+ *
+ * Provides:
+ * - Real-time memory statistics
+ * - Automatic cleanup when threshold exceeded
+ * - Periodic monitoring with configurable interval
+ * - Integration with ParseCache
+ *
+ * @example
+ * ```typescript
+ * const cache = new ParseCache({ maxMemoryMB: 200 })
+ * const monitor = new MemoryMonitor({
+ *   thresholdMB: 500,
+ *   cache
+ * })
+ *
+ * // Check memory and cleanup if needed
+ * const result = monitor.checkAndCleanup()
+ * if (result.cleaned) {
+ *   console.log(`Freed ${MemoryMonitor.formatBytes(result.freedBytes)}`)
+ * }
+ *
+ * // Start periodic monitoring
+ * const stop = monitor.startMonitoring(10000) // 10 seconds
+ *
+ * // Later...
+ * stop()
+ * ```
+ */
+export declare class MemoryMonitor {
+    private readonly thresholdBytes;
+    private readonly cache;
+    private readonly verbose;
+    private monitorInterval;
+    private cleanupCount;
+    private totalFreedBytes;
+    constructor(options?: MemoryMonitorOptions);
+    /**
+     * Get current memory statistics
+     *
+     * @returns Current memory usage statistics
+     *
+     * @example
+     * ```typescript
+     * const stats = monitor.getStats()
+     * console.log(`Heap: ${MemoryMonitor.formatBytes(stats.heapUsed)}`)
+     * console.log(`Over threshold: ${stats.isOverThreshold}`)
+     * ```
+     */
+    getStats(): MemoryStats;
+    /**
+     * Check memory and cleanup if needed
+     *
+     * Triggers cleanup when heap usage exceeds threshold.
+     * Clears cache and requests garbage collection.
+     *
+     * @returns Cleanup result with bytes freed
+     *
+     * @example
+     * ```typescript
+     * const result = monitor.checkAndCleanup()
+     * if (result.cleaned) {
+     *   console.log(`Cleaned up ${MemoryMonitor.formatBytes(result.freedBytes)}`)
+     * }
+     * ```
+     */
+    checkAndCleanup(): CleanupResult;
+    /**
+     * Force cleanup regardless of threshold
+     *
+     * Useful for explicit memory management before large operations.
+     *
+     * @returns Cleanup result with bytes freed
+     */
+    forceCleanup(): CleanupResult;
+    /**
+     * Start periodic monitoring
+     *
+     * Checks memory at the specified interval and performs
+     * cleanup when threshold is exceeded.
+     *
+     * @param intervalMs - Monitoring interval in milliseconds (default: 10000)
+     * @returns Stop function to cancel monitoring
+     *
+     * @example
+     * ```typescript
+     * const stop = monitor.startMonitoring(5000)
+     *
+     * // Later, when done...
+     * stop()
+     * ```
+     */
+    startMonitoring(intervalMs?: number): () => void;
+    /**
+     * Stop periodic monitoring
+     */
+    stopMonitoring(): void;
+    /**
+     * Get cleanup count
+     *
+     * @returns Number of cleanups performed
+     */
+    getCleanupCount(): number;
+    /**
+     * Get total bytes freed across all cleanups
+     *
+     * @returns Total bytes freed (estimated)
+     */
+    getTotalFreedBytes(): number;
+    /**
+     * Get monitoring status
+     *
+     * @returns Whether periodic monitoring is active
+     */
+    isMonitoring(): boolean;
+    /**
+     * Get memory threshold
+     *
+     * @returns Threshold in bytes
+     */
+    getThreshold(): number;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Format bytes for display
+     *
+     * @param bytes - Number of bytes
+     * @returns Human-readable string
+     *
+     * @example
+     * ```typescript
+     * MemoryMonitor.formatBytes(1024)        // "1.00 KB"
+     * MemoryMonitor.formatBytes(1048576)     // "1.00 MB"
+     * MemoryMonitor.formatBytes(1073741824)  // "1.00 GB"
+     * ```
+     */
+    static formatBytes(bytes: number): string;
+    /**
+     * Get memory usage summary string
+     *
+     * @returns Formatted summary of current memory usage
+     */
+    getSummary(): string;
+}
+//# sourceMappingURL=memory-monitor.d.ts.map

package/dist/analysis/memory-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-monitor.d.ts","sourceRoot":"","sources":["../../src/analysis/memory-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,eAAe,EAAE,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,eAAe,CAAI;gBAEf,OAAO,GAAE,oBAAyB;IAM9C;;;;;;;;;;;OAWG;IACH,QAAQ,IAAI,WAAW;IAavB;;;;;;;;;;;;;;;OAeG;IACH,eAAe,IAAI,aAAa;IA8ChC;;;;;;OAMG;IACH,YAAY,IAAI,aAAa;IA0B7B;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,UAAU,SAAQ,GAAG,MAAM,IAAI;IAe/C;;OAEG;IACH,cAAc,IAAI,IAAI;IAOtB;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;OAIG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;;OAIG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAczC;;;;OAIG;IACH,UAAU,IAAI,MAAM;CAWrB"}

package/dist/analysis/memory-monitor.js

@@ -0,0 +1,271 @@
+/**
+ * SMI-1308: Memory Monitor
+ *
+ * Monitors memory usage and triggers cleanup when thresholds are exceeded.
+ * Integrates with ParseCache for memory pressure handling.
+ *
+ * @see docs/internal/architecture/multi-language-analysis.md
+ * @module analysis/memory-monitor
+ */
+/**
+ * Monitor memory usage and trigger cleanup when needed
+ *
+ * Provides:
+ * - Real-time memory statistics
+ * - Automatic cleanup when threshold exceeded
+ * - Periodic monitoring with configurable interval
+ * - Integration with ParseCache
+ *
+ * @example
+ * ```typescript
+ * const cache = new ParseCache({ maxMemoryMB: 200 })
+ * const monitor = new MemoryMonitor({
+ *   thresholdMB: 500,
+ *   cache
+ * })
+ *
+ * // Check memory and cleanup if needed
+ * const result = monitor.checkAndCleanup()
+ * if (result.cleaned) {
+ *   console.log(`Freed ${MemoryMonitor.formatBytes(result.freedBytes)}`)
+ * }
+ *
+ * // Start periodic monitoring
+ * const stop = monitor.startMonitoring(10000) // 10 seconds
+ *
+ * // Later...
+ * stop()
+ * ```
+ */
+export class MemoryMonitor {
+    thresholdBytes;
+    cache;
+    verbose;
+    monitorInterval = null;
+    cleanupCount = 0;
+    totalFreedBytes = 0;
+    constructor(options = {}) {
+        this.thresholdBytes = (options.thresholdMB ?? 500) * 1024 * 1024;
+        this.cache = options.cache ?? null;
+        this.verbose = options.verbose ?? false;
+    }
+    /**
+     * Get current memory statistics
+     *
+     * @returns Current memory usage statistics
+     *
+     * @example
+     * ```typescript
+     * const stats = monitor.getStats()
+     * console.log(`Heap: ${MemoryMonitor.formatBytes(stats.heapUsed)}`)
+     * console.log(`Over threshold: ${stats.isOverThreshold}`)
+     * ```
+     */
+    getStats() {
+        const usage = process.memoryUsage();
+        return {
+            heapUsed: usage.heapUsed,
+            heapTotal: usage.heapTotal,
+            external: usage.external,
+            arrayBuffers: usage.arrayBuffers,
+            rss: usage.rss,
+            threshold: this.thresholdBytes,
+            isOverThreshold: usage.heapUsed > this.thresholdBytes,
+        };
+    }
+    /**
+     * Check memory and cleanup if needed
+     *
+     * Triggers cleanup when heap usage exceeds threshold.
+     * Clears cache and requests garbage collection.
+     *
+     * @returns Cleanup result with bytes freed
+     *
+     * @example
+     * ```typescript
+     * const result = monitor.checkAndCleanup()
+     * if (result.cleaned) {
+     *   console.log(`Cleaned up ${MemoryMonitor.formatBytes(result.freedBytes)}`)
+     * }
+     * ```
+     */
+    checkAndCleanup() {
+        const stats = this.getStats();
+        if (!stats.isOverThreshold) {
+            return { cleaned: false, freedBytes: 0 };
+        }
+        const beforeHeap = stats.heapUsed;
+        if (this.verbose) {
+            console.warn(`[MemoryMonitor] Memory pressure: ${MemoryMonitor.formatBytes(stats.heapUsed)} ` +
+                `(threshold: ${MemoryMonitor.formatBytes(this.thresholdBytes)})`);
+        }
+        // Clear cache if available
+        if (this.cache) {
+            const cacheStats = this.cache.getStats();
+            this.cache.clear();
+            if (this.verbose) {
+                console.warn(`[MemoryMonitor] Cleared cache (${cacheStats.entries} entries)`);
+            }
+        }
+        // Request garbage collection if available
+        if (typeof global.gc === 'function') {
+            global.gc();
+            if (this.verbose) {
+                console.warn('[MemoryMonitor] Triggered garbage collection');
+            }
+        }
+        this.cleanupCount++;
+        const afterUsage = process.memoryUsage();
+        const freedBytes = Math.max(0, beforeHeap - afterUsage.heapUsed);
+        this.totalFreedBytes += freedBytes;
+        return {
+            cleaned: true,
+            freedBytes,
+            reason: `Heap exceeded threshold (${MemoryMonitor.formatBytes(beforeHeap)})`,
+        };
+    }
+    /**
+     * Force cleanup regardless of threshold
+     *
+     * Useful for explicit memory management before large operations.
+     *
+     * @returns Cleanup result with bytes freed
+     */
+    forceCleanup() {
+        const beforeHeap = process.memoryUsage().heapUsed;
+        // Clear cache if available
+        if (this.cache) {
+            this.cache.clear();
+        }
+        // Request garbage collection if available
+        if (typeof global.gc === 'function') {
+            global.gc();
+        }
+        this.cleanupCount++;
+        const afterUsage = process.memoryUsage();
+        const freedBytes = Math.max(0, beforeHeap - afterUsage.heapUsed);
+        this.totalFreedBytes += freedBytes;
+        return {
+            cleaned: true,
+            freedBytes,
+            reason: 'Forced cleanup',
+        };
+    }
+    /**
+     * Start periodic monitoring
+     *
+     * Checks memory at the specified interval and performs
+     * cleanup when threshold is exceeded.
+     *
+     * @param intervalMs - Monitoring interval in milliseconds (default: 10000)
+     * @returns Stop function to cancel monitoring
+     *
+     * @example
+     * ```typescript
+     * const stop = monitor.startMonitoring(5000)
+     *
+     * // Later, when done...
+     * stop()
+     * ```
+     */
+    startMonitoring(intervalMs = 10000) {
+        if (this.monitorInterval) {
+            return () => this.stopMonitoring();
+        }
+        this.monitorInterval = setInterval(() => {
+            this.checkAndCleanup();
+        }, intervalMs);
+        // Prevent interval from keeping process alive
+        this.monitorInterval.unref();
+        return () => this.stopMonitoring();
+    }
+    /**
+     * Stop periodic monitoring
+     */
+    stopMonitoring() {
+        if (this.monitorInterval) {
+            clearInterval(this.monitorInterval);
+            this.monitorInterval = null;
+        }
+    }
+    /**
+     * Get cleanup count
+     *
+     * @returns Number of cleanups performed
+     */
+    getCleanupCount() {
+        return this.cleanupCount;
+    }
+    /**
+     * Get total bytes freed across all cleanups
+     *
+     * @returns Total bytes freed (estimated)
+     */
+    getTotalFreedBytes() {
+        return this.totalFreedBytes;
+    }
+    /**
+     * Get monitoring status
+     *
+     * @returns Whether periodic monitoring is active
+     */
+    isMonitoring() {
+        return this.monitorInterval !== null;
+    }
+    /**
+     * Get memory threshold
+     *
+     * @returns Threshold in bytes
+     */
+    getThreshold() {
+        return this.thresholdBytes;
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.cleanupCount = 0;
+        this.totalFreedBytes = 0;
+    }
+    /**
+     * Format bytes for display
+     *
+     * @param bytes - Number of bytes
+     * @returns Human-readable string
+     *
+     * @example
+     * ```typescript
+     * MemoryMonitor.formatBytes(1024)        // "1.00 KB"
+     * MemoryMonitor.formatBytes(1048576)     // "1.00 MB"
+     * MemoryMonitor.formatBytes(1073741824)  // "1.00 GB"
+     * ```
+     */
+    static formatBytes(bytes) {
+        const units = ['B', 'KB', 'MB', 'GB'];
+        let size = Math.abs(bytes);
+        let unitIndex = 0;
+        while (size >= 1024 && unitIndex < units.length - 1) {
+            size /= 1024;
+            unitIndex++;
+        }
+        const prefix = bytes < 0 ? '-' : '';
+        return `${prefix}${size.toFixed(2)} ${units[unitIndex]}`;
+    }
+    /**
+     * Get memory usage summary string
+     *
+     * @returns Formatted summary of current memory usage
+     */
+    getSummary() {
+        const stats = this.getStats();
+        return [
+            `Heap: ${MemoryMonitor.formatBytes(stats.heapUsed)} / ${MemoryMonitor.formatBytes(stats.heapTotal)}`,
+            `RSS: ${MemoryMonitor.formatBytes(stats.rss)}`,
+            `Threshold: ${MemoryMonitor.formatBytes(stats.threshold)}`,
+            `Status: ${stats.isOverThreshold ? 'OVER THRESHOLD' : 'OK'}`,
+            `Cleanups: ${this.cleanupCount}`,
+            `Total freed: ${MemoryMonitor.formatBytes(this.totalFreedBytes)}`,
+        ].join(', ');
+    }
+}
+//# sourceMappingURL=memory-monitor.js.map

package/dist/analysis/memory-monitor.js.map

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

package/dist/analysis/metrics.d.ts

@@ -0,0 +1,103 @@
+/**
+ * SMI-1337: Analysis Pipeline Metrics and Telemetry
+ *
+ * Provides metrics collection for the multi-language analysis pipeline:
+ * - Files parsed per language (counter)
+ * - Parse duration by language (histogram)
+ * - Cache hit/miss rates (gauge)
+ * - Worker pool utilization (gauge)
+ * - Memory usage (gauge)
+ * - Error counts by type (counter)
+ *
+ * @see docs/internal/architecture/multi-language-analysis.md
+ * @module analysis/metrics
+ */
+import type { SupportedLanguage } from './types.js';
+import type { AnalysisMetricsConfig, AnalysisMetricsSnapshot } from './metrics.types.js';
+import { InMemoryCounter, InMemoryHistogram, InMemoryGauge } from './metrics.implementations.js';
+export type { AnalysisMetricsConfig, AnalysisMetricsSnapshot } from './metrics.types.js';
+/**
+ * Analysis Pipeline Metrics Collector
+ *
+ * Provides comprehensive metrics collection for the multi-language
+ * analysis pipeline with graceful fallback when telemetry is unavailable.
+ *
+ * @example
+ * ```typescript
+ * const metrics = new AnalysisMetrics()
+ *
+ * // Record file parse
+ * metrics.recordFileParsed('typescript')
+ *
+ * // Record parse duration
+ * metrics.recordParseDuration('typescript', 15.5)
+ *
+ * // Record cache operations
+ * metrics.recordCacheHit()
+ * metrics.recordCacheMiss()
+ *
+ * // Get snapshot
+ * const snapshot = metrics.getSnapshot()
+ * console.log(`Parse p95: ${snapshot.parseDuration.stats.p95}ms`)
+ * ```
+ */
+export declare class AnalysisMetrics {
+    private readonly enabled;
+    private readonly prefix;
+    readonly filesParsed: InMemoryCounter;
+    readonly parseDuration: InMemoryHistogram;
+    readonly cacheHits: InMemoryCounter;
+    readonly cacheMisses: InMemoryCounter;
+    readonly cacheSize: InMemoryGauge;
+    readonly workerPoolActive: InMemoryGauge;
+    readonly workerPoolQueued: InMemoryGauge;
+    readonly workerPoolUtilization: InMemoryGauge;
+    readonly memoryHeapUsed: InMemoryGauge;
+    readonly memoryHeapTotal: InMemoryGauge;
+    readonly memoryRss: InMemoryGauge;
+    readonly errorCount: InMemoryCounter;
+    readonly aggregatorFilesProcessed: InMemoryGauge;
+    readonly aggregatorImports: InMemoryGauge;
+    readonly aggregatorExports: InMemoryGauge;
+    readonly aggregatorFunctions: InMemoryGauge;
+    constructor(config?: AnalysisMetricsConfig);
+    /** Check if metrics collection is enabled */
+    isEnabled(): boolean;
+    /** Record a file being parsed */
+    recordFileParsed(language: SupportedLanguage | string): void;
+    /** Record parse duration for a file */
+    recordParseDuration(language: SupportedLanguage | string, durationMs: number): void;
+    /** Record a cache hit */
+    recordCacheHit(language?: SupportedLanguage | string): void;
+    /** Record a cache miss */
+    recordCacheMiss(language?: SupportedLanguage | string): void;
+    /** Update cache size */
+    updateCacheSize(size: number, entries?: number): void;
+    /** Update worker pool metrics */
+    updateWorkerPool(activeWorkers: number, queuedTasks: number, poolSize?: number): void;
+    /** Update memory usage metrics */
+    updateMemoryUsage(): void;
+    /** Record an error */
+    recordError(errorType: string, language?: SupportedLanguage | string): void;
+    /** Update aggregator metrics */
+    updateAggregatorStats(filesProcessed: number, imports: number, exports: number, functions: number): void;
+    /** Get cache hit rate */
+    getCacheHitRate(): number;
+    /** Get files parsed by language */
+    getFilesByLanguage(): Record<string, number>;
+    /** Get parse duration stats by language */
+    getParseDurationByLanguage(language: SupportedLanguage | string): ReturnType<InMemoryHistogram['getStats']>;
+    /** Get complete metrics snapshot */
+    getSnapshot(): AnalysisMetricsSnapshot;
+    /** Reset all metrics */
+    reset(): void;
+}
+/** Get the default analysis metrics instance */
+export declare function getAnalysisMetrics(): AnalysisMetrics;
+/** Initialize the default analysis metrics instance */
+export declare function initializeAnalysisMetrics(config?: AnalysisMetricsConfig): AnalysisMetrics;
+/** Helper: Time an async operation and record to analysis metrics */
+export declare function timeParseAsync<T>(language: SupportedLanguage | string, fn: () => Promise<T>, metrics?: AnalysisMetrics): Promise<T>;
+/** Helper: Time a sync operation and record to analysis metrics */
+export declare function timeParseSync<T>(language: SupportedLanguage | string, fn: () => T, metrics?: AnalysisMetrics): T;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/analysis/metrics.d.ts.map

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

package/dist/analysis/metrics.implementations.d.ts

@@ -0,0 +1,39 @@
+/**
+ * In-Memory Metrics Implementations
+ * @module analysis/metrics.implementations
+ */
+import type { Counter, Histogram, Gauge, MetricLabels } from '../telemetry/metrics.js';
+import type { HistogramStats } from './metrics.types.js';
+/**
+ * In-memory counter implementation
+ */
+export declare class InMemoryCounter implements Counter {
+    private values;
+    add(value: number, labels?: MetricLabels): void;
+    increment(labels?: MetricLabels): void;
+    getValues(): Map<string, number>;
+    getTotal(): number;
+    reset(): void;
+}
+/**
+ * In-memory histogram implementation
+ */
+export declare class InMemoryHistogram implements Histogram {
+    private values;
+    private labeledValues;
+    record(value: number, labels?: MetricLabels): void;
+    getStats(): HistogramStats;
+    getStatsByLabel(labels: MetricLabels): HistogramStats;
+    reset(): void;
+}
+/**
+ * In-memory gauge implementation
+ */
+export declare class InMemoryGauge implements Gauge {
+    private values;
+    set(value: number, labels?: MetricLabels): void;
+    getValue(labels?: MetricLabels): number;
+    getAllValues(): Map<string, number>;
+    reset(): void;
+}
+//# sourceMappingURL=metrics.implementations.d.ts.map

package/dist/analysis/metrics.implementations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.implementations.d.ts","sourceRoot":"","sources":["../../src/analysis/metrics.implementations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD;;GAEG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,OAAO,CAAC,MAAM,CAA4B;IAE1C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAM/C,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAItC,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIhC,QAAQ,IAAI,MAAM;IAQlB,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,aAAa,CAA8B;IAEnD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAUlD,QAAQ,IAAI,cAAc;IAwB1B,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc;IA2BrD,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,KAAK;IACzC,OAAO,CAAC,MAAM,CAA4B;IAE1C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAK/C,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;IAKvC,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAInC,KAAK,IAAI,IAAI;CAGd"}