@office-ai/aioncli-core 0.2.3 → 0.18.4

package/dist/src/telemetry/gcp-exporters.test.js

@@ -0,0 +1,318 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { ExportResultCode } from '@opentelemetry/core';
+import { GcpTraceExporter, GcpMetricExporter, GcpLogExporter, } from './gcp-exporters.js';
+const mockLogEntry = { test: 'entry' };
+const mockLogWrite = vi.fn().mockResolvedValue(undefined);
+const mockLog = {
+    entry: vi.fn().mockReturnValue(mockLogEntry),
+    write: mockLogWrite,
+};
+const mockLogging = {
+    projectId: 'test-project',
+    log: vi.fn().mockReturnValue(mockLog),
+};
+vi.mock('@google-cloud/opentelemetry-cloud-trace-exporter', () => ({
+    TraceExporter: vi.fn().mockImplementation(() => ({
+        export: vi.fn(),
+        shutdown: vi.fn(),
+        forceFlush: vi.fn(),
+    })),
+}));
+vi.mock('@google-cloud/opentelemetry-cloud-monitoring-exporter', () => ({
+    MetricExporter: vi.fn().mockImplementation(() => ({
+        export: vi.fn(),
+        shutdown: vi.fn(),
+        forceFlush: vi.fn(),
+    })),
+}));
+vi.mock('@google-cloud/logging', () => ({
+    Logging: vi.fn().mockImplementation(() => mockLogging),
+}));
+describe('GCP Exporters', () => {
+    describe('GcpTraceExporter', () => {
+        it('should create a trace exporter with correct configuration', () => {
+            const exporter = new GcpTraceExporter('test-project');
+            expect(exporter).toBeDefined();
+        });
+        it('should create a trace exporter without project ID', () => {
+            const exporter = new GcpTraceExporter();
+            expect(exporter).toBeDefined();
+        });
+    });
+    describe('GcpMetricExporter', () => {
+        it('should create a metric exporter with correct configuration', () => {
+            const exporter = new GcpMetricExporter('test-project');
+            expect(exporter).toBeDefined();
+        });
+        it('should create a metric exporter without project ID', () => {
+            const exporter = new GcpMetricExporter();
+            expect(exporter).toBeDefined();
+        });
+    });
+    describe('GcpLogExporter', () => {
+        let exporter;
+        beforeEach(() => {
+            vi.clearAllMocks();
+            mockLogWrite.mockResolvedValue(undefined);
+            mockLog.entry.mockReturnValue(mockLogEntry);
+            exporter = new GcpLogExporter('test-project');
+        });
+        describe('constructor', () => {
+            it('should create a log exporter with project ID', () => {
+                expect(exporter).toBeDefined();
+                expect(mockLogging.log).toHaveBeenCalledWith('gemini_cli');
+            });
+            it('should create a log exporter without project ID', () => {
+                const exporterNoProject = new GcpLogExporter();
+                expect(exporterNoProject).toBeDefined();
+            });
+        });
+        describe('export', () => {
+            it('should export logs successfully', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        severityNumber: 9,
+                        severityText: 'INFO',
+                        body: 'Test log message',
+                        attributes: {
+                            'session.id': 'test-session',
+                            'custom.attribute': 'value',
+                        },
+                        resource: {
+                            attributes: {
+                                'service.name': 'test-service',
+                            },
+                        },
+                    },
+                ];
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                await new Promise((resolve) => setTimeout(resolve, 0));
+                expect(mockLog.entry).toHaveBeenCalledWith(expect.objectContaining({
+                    severity: 'INFO',
+                    timestamp: expect.any(Date),
+                    resource: {
+                        type: 'global',
+                        labels: {
+                            project_id: 'test-project',
+                        },
+                    },
+                }), expect.objectContaining({
+                    message: 'Test log message',
+                    'session.id': 'test-session',
+                    'custom.attribute': 'value',
+                    'service.name': 'test-service',
+                }));
+                expect(mockLog.write).toHaveBeenCalledWith([mockLogEntry]);
+                expect(callback).toHaveBeenCalledWith({
+                    code: ExportResultCode.SUCCESS,
+                });
+            });
+            it('should handle export failures', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                const error = new Error('Write failed');
+                mockLogWrite.mockRejectedValueOnce(error);
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                await new Promise((resolve) => setTimeout(resolve, 0));
+                expect(callback).toHaveBeenCalledWith({
+                    code: ExportResultCode.FAILED,
+                    error,
+                });
+            });
+            it('should handle synchronous errors', () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                mockLog.entry.mockImplementation(() => {
+                    throw new Error('Entry creation failed');
+                });
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                expect(callback).toHaveBeenCalledWith({
+                    code: ExportResultCode.FAILED,
+                    error: expect.any(Error),
+                });
+            });
+        });
+        describe('severity mapping', () => {
+            it('should map OpenTelemetry severity numbers to Cloud Logging levels', () => {
+                const testCases = [
+                    { severityNumber: undefined, expected: 'DEFAULT' },
+                    { severityNumber: 1, expected: 'DEFAULT' },
+                    { severityNumber: 5, expected: 'DEBUG' },
+                    { severityNumber: 9, expected: 'INFO' },
+                    { severityNumber: 13, expected: 'WARNING' },
+                    { severityNumber: 17, expected: 'ERROR' },
+                    { severityNumber: 21, expected: 'CRITICAL' },
+                    { severityNumber: 25, expected: 'CRITICAL' },
+                ];
+                testCases.forEach(({ severityNumber, expected }) => {
+                    const mockLogRecords = [
+                        {
+                            hrTime: [1234567890, 123456789],
+                            hrTimeObserved: [1234567890, 123456789],
+                            severityNumber,
+                            body: 'Test message',
+                        },
+                    ];
+                    const callback = vi.fn();
+                    exporter.export(mockLogRecords, callback);
+                    expect(mockLog.entry).toHaveBeenCalledWith(expect.objectContaining({
+                        severity: expected,
+                    }), expect.any(Object));
+                    mockLog.entry.mockClear();
+                });
+            });
+        });
+        describe('forceFlush', () => {
+            it('should resolve immediately when no pending writes exist', async () => {
+                await expect(exporter.forceFlush()).resolves.toBeUndefined();
+            });
+            it('should wait for pending writes to complete', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                let resolveWrite;
+                const writePromise = new Promise((resolve) => {
+                    resolveWrite = resolve;
+                });
+                mockLogWrite.mockReturnValueOnce(writePromise);
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                const flushPromise = exporter.forceFlush();
+                await new Promise((resolve) => setTimeout(resolve, 1));
+                resolveWrite();
+                await writePromise;
+                await expect(flushPromise).resolves.toBeUndefined();
+            });
+            it('should handle multiple pending writes', async () => {
+                const mockLogRecords1 = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message 1',
+                    },
+                ];
+                const mockLogRecords2 = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message 2',
+                    },
+                ];
+                let resolveWrite1;
+                let resolveWrite2;
+                const writePromise1 = new Promise((resolve) => {
+                    resolveWrite1 = resolve;
+                });
+                const writePromise2 = new Promise((resolve) => {
+                    resolveWrite2 = resolve;
+                });
+                mockLogWrite
+                    .mockReturnValueOnce(writePromise1)
+                    .mockReturnValueOnce(writePromise2);
+                const callback = vi.fn();
+                exporter.export(mockLogRecords1, callback);
+                exporter.export(mockLogRecords2, callback);
+                const flushPromise = exporter.forceFlush();
+                resolveWrite1();
+                await writePromise1;
+                resolveWrite2();
+                await writePromise2;
+                await expect(flushPromise).resolves.toBeUndefined();
+            });
+            it('should handle write failures gracefully', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                const error = new Error('Write failed');
+                mockLogWrite.mockRejectedValueOnce(error);
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                await expect(exporter.forceFlush()).resolves.toBeUndefined();
+                await new Promise((resolve) => setTimeout(resolve, 10));
+                expect(callback).toHaveBeenCalledWith({
+                    code: ExportResultCode.FAILED,
+                    error,
+                });
+            });
+        });
+        describe('shutdown', () => {
+            it('should call forceFlush', async () => {
+                const forceFlushSpy = vi.spyOn(exporter, 'forceFlush');
+                await exporter.shutdown();
+                expect(forceFlushSpy).toHaveBeenCalled();
+            });
+            it('should handle shutdown gracefully', async () => {
+                const forceFlushSpy = vi.spyOn(exporter, 'forceFlush');
+                await expect(exporter.shutdown()).resolves.toBeUndefined();
+                expect(forceFlushSpy).toHaveBeenCalled();
+            });
+            it('should wait for pending writes before shutting down', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                let resolveWrite;
+                const writePromise = new Promise((resolve) => {
+                    resolveWrite = resolve;
+                });
+                mockLogWrite.mockReturnValueOnce(writePromise);
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                const shutdownPromise = exporter.shutdown();
+                await new Promise((resolve) => setTimeout(resolve, 1));
+                resolveWrite();
+                await writePromise;
+                await expect(shutdownPromise).resolves.toBeUndefined();
+            });
+            it('should clear pending writes array after shutdown', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                await new Promise((resolve) => setTimeout(resolve, 10));
+                await exporter.shutdown();
+                const start = Date.now();
+                await exporter.forceFlush();
+                const elapsed = Date.now() - start;
+                expect(elapsed).toBeLessThan(50);
+            });
+        });
+    });
+});
+//# sourceMappingURL=gcp-exporters.test.js.map

package/dist/src/telemetry/gcp-exporters.test.js.map

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

package/dist/src/telemetry/high-water-mark-tracker.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * High-water mark tracker for memory metrics
+ * Only triggers when memory usage increases by a significant threshold
+ */
+export declare class HighWaterMarkTracker {
+    private waterMarks;
+    private lastUpdateTimes;
+    private readonly growthThresholdPercent;
+    constructor(growthThresholdPercent?: number);
+    /**
+     * Check if current value represents a new high-water mark that should trigger recording
+     * @param metricType - Type of metric (e.g., 'heap_used', 'rss')
+     * @param currentValue - Current memory value in bytes
+     * @returns true if this value should trigger a recording
+     */
+    shouldRecordMetric(metricType: string, currentValue: number): boolean;
+    /**
+     * Get current high-water mark for a metric type
+     */
+    getHighWaterMark(metricType: string): number;
+    /**
+     * Get all high-water marks
+     */
+    getAllHighWaterMarks(): Record<string, number>;
+    /**
+     * Reset high-water mark for a specific metric type
+     */
+    resetHighWaterMark(metricType: string): void;
+    /**
+     * Reset all high-water marks
+     */
+    resetAllHighWaterMarks(): void;
+    /**
+     * Remove stale entries to avoid unbounded growth if metric types are variable.
+     * Entries not updated within maxAgeMs will be removed.
+     */
+    cleanup(maxAgeMs?: number): void;
+}

package/dist/src/telemetry/high-water-mark-tracker.js

@@ -0,0 +1,88 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * High-water mark tracker for memory metrics
+ * Only triggers when memory usage increases by a significant threshold
+ */
+export class HighWaterMarkTracker {
+    waterMarks = new Map();
+    lastUpdateTimes = new Map();
+    growthThresholdPercent;
+    constructor(growthThresholdPercent = 5) {
+        if (growthThresholdPercent < 0) {
+            throw new Error('growthThresholdPercent must be non-negative.');
+        }
+        this.growthThresholdPercent = growthThresholdPercent;
+    }
+    /**
+     * Check if current value represents a new high-water mark that should trigger recording
+     * @param metricType - Type of metric (e.g., 'heap_used', 'rss')
+     * @param currentValue - Current memory value in bytes
+     * @returns true if this value should trigger a recording
+     */
+    shouldRecordMetric(metricType, currentValue) {
+        const now = Date.now();
+        // Track last seen time for cleanup regardless of whether we record
+        this.lastUpdateTimes.set(metricType, now);
+        // Get current high-water mark
+        const currentWaterMark = this.waterMarks.get(metricType) || 0;
+        // For first measurement, always record
+        if (currentWaterMark === 0) {
+            this.waterMarks.set(metricType, currentValue);
+            this.lastUpdateTimes.set(metricType, now);
+            return true;
+        }
+        // Check if current value exceeds threshold
+        const thresholdValue = currentWaterMark * (1 + this.growthThresholdPercent / 100);
+        if (currentValue > thresholdValue) {
+            // Update high-water mark
+            this.waterMarks.set(metricType, currentValue);
+            this.lastUpdateTimes.set(metricType, now);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get current high-water mark for a metric type
+     */
+    getHighWaterMark(metricType) {
+        return this.waterMarks.get(metricType) || 0;
+    }
+    /**
+     * Get all high-water marks
+     */
+    getAllHighWaterMarks() {
+        return Object.fromEntries(this.waterMarks);
+    }
+    /**
+     * Reset high-water mark for a specific metric type
+     */
+    resetHighWaterMark(metricType) {
+        this.waterMarks.delete(metricType);
+        this.lastUpdateTimes.delete(metricType);
+    }
+    /**
+     * Reset all high-water marks
+     */
+    resetAllHighWaterMarks() {
+        this.waterMarks.clear();
+        this.lastUpdateTimes.clear();
+    }
+    /**
+     * Remove stale entries to avoid unbounded growth if metric types are variable.
+     * Entries not updated within maxAgeMs will be removed.
+     */
+    cleanup(maxAgeMs = 3600000) {
+        const cutoffTime = Date.now() - maxAgeMs;
+        for (const [metricType, lastTime] of this.lastUpdateTimes.entries()) {
+            if (lastTime < cutoffTime) {
+                this.lastUpdateTimes.delete(metricType);
+                this.waterMarks.delete(metricType);
+            }
+        }
+    }
+}
+//# sourceMappingURL=high-water-mark-tracker.js.map

package/dist/src/telemetry/high-water-mark-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"high-water-mark-tracker.js","sourceRoot":"","sources":["../../../src/telemetry/high-water-mark-tracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACvB,UAAU,GAAwB,IAAI,GAAG,EAAE,CAAC;IAC5C,eAAe,GAAwB,IAAI,GAAG,EAAE,CAAC;IACxC,sBAAsB,CAAS;IAEhD,YAAY,yBAAiC,CAAC;QAC5C,IAAI,sBAAsB,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,sBAAsB,GAAG,sBAAsB,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,UAAkB,EAAE,YAAoB;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,mEAAmE;QACnE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC1C,8BAA8B;QAC9B,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAE9D,uCAAuC;QACvC,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YAC9C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2CAA2C;QAC3C,MAAM,cAAc,GAClB,gBAAgB,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC;QAE7D,IAAI,YAAY,GAAG,cAAc,EAAE,CAAC;YAClC,yBAAyB;YACzB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YAC9C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,UAAkB;QACjC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,UAAkB;QACnC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,WAAmB,OAAO;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;QACzC,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC;YACpE,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;gBAC1B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACxC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/src/telemetry/high-water-mark-tracker.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/telemetry/high-water-mark-tracker.test.js

@@ -0,0 +1,152 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { HighWaterMarkTracker } from './high-water-mark-tracker.js';
+describe('HighWaterMarkTracker', () => {
+    let tracker;
+    beforeEach(() => {
+        tracker = new HighWaterMarkTracker(5); // 5% threshold
+    });
+    describe('constructor', () => {
+        it('should initialize with default values', () => {
+            const defaultTracker = new HighWaterMarkTracker();
+            expect(defaultTracker).toBeInstanceOf(HighWaterMarkTracker);
+        });
+        it('should initialize with custom values', () => {
+            const customTracker = new HighWaterMarkTracker(10);
+            expect(customTracker).toBeInstanceOf(HighWaterMarkTracker);
+        });
+        it('should throw on negative threshold', () => {
+            expect(() => new HighWaterMarkTracker(-1)).toThrow('growthThresholdPercent must be non-negative.');
+        });
+    });
+    describe('shouldRecordMetric', () => {
+        it('should return true for first measurement', () => {
+            const result = tracker.shouldRecordMetric('heap_used', 1000000);
+            expect(result).toBe(true);
+        });
+        it('should return false for small increases', () => {
+            // Set initial high-water mark
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Small increase (less than 5%)
+            const result = tracker.shouldRecordMetric('heap_used', 1030000); // 3% increase
+            expect(result).toBe(false);
+        });
+        it('should return true for significant increases', () => {
+            // Set initial high-water mark
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Add several readings to build up smoothing window
+            tracker.shouldRecordMetric('heap_used', 1100000); // 10% increase
+            tracker.shouldRecordMetric('heap_used', 1150000); // Additional growth
+            const result = tracker.shouldRecordMetric('heap_used', 1200000); // Sustained growth
+            expect(result).toBe(true);
+        });
+        it('should handle decreasing values correctly', () => {
+            // Set initial high-water mark
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Decrease (should not trigger)
+            const result = tracker.shouldRecordMetric('heap_used', 900000); // 10% decrease
+            expect(result).toBe(false);
+        });
+        it('should update high-water mark when threshold exceeded', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            const beforeMark = tracker.getHighWaterMark('heap_used');
+            // Create sustained growth pattern to trigger update
+            tracker.shouldRecordMetric('heap_used', 1100000);
+            tracker.shouldRecordMetric('heap_used', 1150000);
+            tracker.shouldRecordMetric('heap_used', 1200000);
+            const afterMark = tracker.getHighWaterMark('heap_used');
+            expect(afterMark).toBeGreaterThan(beforeMark);
+        });
+        it('should handle multiple metric types independently', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('rss', 2000000);
+            expect(tracker.getHighWaterMark('heap_used')).toBeGreaterThan(0);
+            expect(tracker.getHighWaterMark('rss')).toBeGreaterThan(0);
+            expect(tracker.getHighWaterMark('heap_used')).not.toBe(tracker.getHighWaterMark('rss'));
+        });
+    });
+    describe('smoothing functionality', () => {
+        it('should reduce noise from garbage collection spikes', () => {
+            // Establish baseline
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Single spike (should be smoothed out)
+            const result = tracker.shouldRecordMetric('heap_used', 2000000);
+            // With the new responsive algorithm, large spikes do trigger
+            expect(result).toBe(true);
+        });
+        it('should eventually respond to sustained growth', () => {
+            // Establish baseline
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Sustained growth pattern
+            tracker.shouldRecordMetric('heap_used', 1100000);
+            tracker.shouldRecordMetric('heap_used', 1150000);
+            const result = tracker.shouldRecordMetric('heap_used', 1200000);
+            expect(result).toBe(true);
+        });
+    });
+    describe('getHighWaterMark', () => {
+        it('should return 0 for unknown metric types', () => {
+            const mark = tracker.getHighWaterMark('unknown_metric');
+            expect(mark).toBe(0);
+        });
+        it('should return correct value for known metric types', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            const mark = tracker.getHighWaterMark('heap_used');
+            expect(mark).toBeGreaterThan(0);
+        });
+    });
+    describe('getAllHighWaterMarks', () => {
+        it('should return empty object initially', () => {
+            const marks = tracker.getAllHighWaterMarks();
+            expect(marks).toEqual({});
+        });
+        it('should return all recorded marks', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('rss', 2000000);
+            const marks = tracker.getAllHighWaterMarks();
+            expect(Object.keys(marks)).toHaveLength(2);
+            expect(marks['heap_used']).toBeGreaterThan(0);
+            expect(marks['rss']).toBeGreaterThan(0);
+        });
+    });
+    describe('resetHighWaterMark', () => {
+        it('should reset specific metric type', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('rss', 2000000);
+            tracker.resetHighWaterMark('heap_used');
+            expect(tracker.getHighWaterMark('heap_used')).toBe(0);
+            expect(tracker.getHighWaterMark('rss')).toBeGreaterThan(0);
+        });
+    });
+    describe('resetAllHighWaterMarks', () => {
+        it('should reset all metrics', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('rss', 2000000);
+            tracker.resetAllHighWaterMarks();
+            expect(tracker.getHighWaterMark('heap_used')).toBe(0);
+            expect(tracker.getHighWaterMark('rss')).toBe(0);
+            expect(tracker.getAllHighWaterMarks()).toEqual({});
+        });
+    });
+    describe('time-based cleanup', () => {
+        it('should clean up old readings', () => {
+            vi.useFakeTimers();
+            // Add readings
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Advance time significantly
+            vi.advanceTimersByTime(15000); // 15 seconds
+            // Explicit cleanup should remove stale entries when age exceeded
+            tracker.cleanup(10000); // 10 seconds
+            // Entry should be removed
+            expect(tracker.getHighWaterMark('heap_used')).toBe(0);
+            vi.useRealTimers();
+        });
+    });
+});
+//# sourceMappingURL=high-water-mark-tracker.test.js.map

package/dist/src/telemetry/high-water-mark-tracker.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"high-water-mark-tracker.test.js","sourceRoot":"","sources":["../../../src/telemetry/high-water-mark-tracker.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,IAAI,OAA6B,CAAC;IAElC,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,GAAG,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;IACxD,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAC;YAClD,MAAM,CAAC,cAAc,CAAC,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,aAAa,GAAG,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,CAAC,aAAa,CAAC,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAChD,8CAA8C,CAC/C,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAChE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,8BAA8B;YAC9B,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEjD,gCAAgC;YAChC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,cAAc;YAC/E,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,8BAA8B;YAC9B,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEjD,oDAAoD;YACpD,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,eAAe;YACjE,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,oBAAoB;YACtE,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,mBAAmB;YACpF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,8BAA8B;YAC9B,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEjD,gCAAgC;YAChC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,eAAe;YAC/E,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEjD,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YAEzD,oDAAoD;YACpD,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEjD,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YAExD,MAAM,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE3C,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YACjE,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAC3D,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CACpD,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAChC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,qBAAqB;YACrB,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEjD,wCAAwC;YACxC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEhE,6DAA6D;YAC7D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,qBAAqB;YACrB,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEjD,2BAA2B;YAC3B,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEhE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE3C,MAAM,KAAK,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAC7C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAC9C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE3C,OAAO,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAExC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE3C,OAAO,CAAC,sBAAsB,EAAE,CAAC;YAEjC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChD,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,EAAE,CAAC,aAAa,EAAE,CAAC;YAEnB,eAAe;YACf,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEjD,6BAA6B;YAC7B,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa;YAE5C,iEAAiE;YACjE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa;YAErC,0BAA0B;YAC1B,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAEtD,EAAE,CAAC,aAAa,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}