observability-toolkit 2.0.0 → 2.1.1

package/dist/lib/quality/qfe-derived-paths.test.js

@@ -0,0 +1,372 @@
+import { describe, it } from 'vitest';
+import * as assert from 'node:assert';
+import { computeDerivedFeatures } from './quality-feature-engineering.js';
+import { TEST_SCORE_STRONG, TEST_SCORE_ADEQUATE, TEST_SCORE_GOOD, TEST_SCORE_PASSING, TEST_SCORE_BASELINE, TEST_SCORE_EXCELLENT, TEST_SCORE_MID, TEST_SCORE_WARNING, TEST_SCORE_LOW, TEST_SCORE_VERY_LOW, TEST_SCORE_POOR, } from './quality-test-constants.js';
+import { COUNT_TWO, COUNT_TEN, COUNT_HUNDRED, DELTA, } from '../../test-helpers/test-constants.js';
+import { requireDefined } from '../../test-helpers/assertions.js';
+const LATENCY_AVG_SECONDS = 5.0;
+const CUSTOM_WEIGHT_HIGH = 0.6;
+const CUSTOM_WEIGHT_LOW = 0.4;
+const LARGE_METRIC_COUNT = 10;
+const TEST_P50_DEFAULT = 0.84;
+const TEST_AVG_FAITHFULNESS = 0.9;
+const TEST_AVG_HALLUCINATION_LOW = 0.1;
+const TIMESERIES_SINGLE_POINT = [TEST_SCORE_STRONG];
+const TIMESERIES_MULTI_POINT = [
+    TEST_SCORE_GOOD,
+    TEST_SCORE_PASSING,
+    TEST_SCORE_BASELINE,
+    TEST_SCORE_MID,
+    TEST_SCORE_POOR,
+    TEST_SCORE_VERY_LOW,
+    TEST_SCORE_WARNING,
+    TEST_SCORE_LOW,
+    TEST_SCORE_ADEQUATE,
+    TEST_SCORE_STRONG,
+    TEST_SCORE_EXCELLENT,
+];
+function makeMetricResult(overrides) {
+    return {
+        displayName: overrides.name,
+        values: {
+            avg: TEST_SCORE_STRONG,
+            p50: TEST_P50_DEFAULT,
+            p95: TEST_SCORE_PASSING,
+            p99: null,
+            min: TEST_SCORE_BASELINE,
+            max: TEST_SCORE_EXCELLENT,
+            count: COUNT_HUNDRED,
+        },
+        sampleCount: COUNT_HUNDRED,
+        alerts: [],
+        status: 'healthy',
+        ...overrides,
+    };
+}
+describe('quality-feature-engineering — derived features paths', () => {
+    describe('no metrics', () => {
+        it('returns undefined cqi when metrics array is empty', () => {
+            const result = computeDerivedFeatures({ metrics: [] });
+            assert.strictEqual(result.cqi, undefined);
+        });
+        it('returns undefined cqiSensitivity when metrics array is empty', () => {
+            const result = computeDerivedFeatures({ metrics: [] });
+            assert.strictEqual(result.cqiSensitivity, undefined);
+        });
+        it('returns empty coverageConfidence map when metrics array is empty', () => {
+            const result = computeDerivedFeatures({ metrics: [] });
+            assert.strictEqual(result.coverageConfidence.size, 0);
+        });
+        it('returns empty correlations when metrics array is empty', () => {
+            const result = computeDerivedFeatures({ metrics: [] });
+            assert.strictEqual(result.correlations.length, 0);
+        });
+    });
+    describe('metrics without timeSeries', () => {
+        const metrics = [
+            makeMetricResult({ name: 'relevance' }),
+            makeMetricResult({ name: 'faithfulness', values: { avg: TEST_AVG_FAITHFULNESS, p50: null, p95: null, p99: null, min: null, max: null, count: COUNT_HUNDRED } }),
+        ];
+        it('computes CQI from available metrics', () => {
+            const result = computeDerivedFeatures({ metrics });
+            assert.ok(requireDefined(result.cqi).value > 0);
+        });
+        it('computes cqiSensitivity when CQI is defined', () => {
+            const result = computeDerivedFeatures({ metrics });
+            assert.ok(result.cqiSensitivity !== undefined);
+        });
+        it('returns empty correlations with no metricTimeSeries', () => {
+            const result = computeDerivedFeatures({ metrics });
+            assert.strictEqual(result.correlations.length, 0);
+        });
+        it('returns empty coverageConfidence with no evaluationsPerInput', () => {
+            const result = computeDerivedFeatures({ metrics });
+            assert.strictEqual(result.coverageConfidence.size, 0);
+        });
+    });
+    describe('metrics WITH metricTimeSeries', () => {
+        const metrics = [
+            makeMetricResult({ name: 'relevance' }),
+            makeMetricResult({ name: 'faithfulness' }),
+        ];
+        const metricTimeSeries = new Map([
+            ['relevance', TIMESERIES_MULTI_POINT],
+            ['faithfulness', [
+                    TEST_SCORE_POOR, TEST_SCORE_WARNING, TEST_SCORE_LOW, TEST_SCORE_VERY_LOW, TEST_SCORE_MID,
+                    TEST_SCORE_BASELINE, TEST_SCORE_ADEQUATE, TEST_SCORE_PASSING, TEST_SCORE_GOOD, TEST_SCORE_STRONG,
+                    TEST_SCORE_EXCELLENT,
+                ]],
+        ]);
+        it('produces non-empty correlations array', () => {
+            const result = computeDerivedFeatures({ metrics, metricTimeSeries });
+            assert.ok(result.correlations.length > 0);
+        });
+        it('each correlation entry has a pair of metric names', () => {
+            const result = computeDerivedFeatures({ metrics, metricTimeSeries });
+            const first = result.correlations[0];
+            assert.ok(first !== undefined);
+            assert.ok(typeof first.metricA === 'string');
+            assert.ok(typeof first.metricB === 'string');
+        });
+    });
+    describe('timeSeries with single point', () => {
+        const metrics = [
+            makeMetricResult({ name: 'relevance' }),
+            makeMetricResult({ name: 'faithfulness' }),
+        ];
+        const metricTimeSeries = new Map([
+            ['relevance', TIMESERIES_SINGLE_POINT],
+            ['faithfulness', TIMESERIES_SINGLE_POINT],
+        ]);
+        it('handles single-point timeSeries without throwing', () => {
+            assert.doesNotThrow(() => computeDerivedFeatures({ metrics, metricTimeSeries }));
+        });
+        it('returns defined result structure with single-point series', () => {
+            const result = computeDerivedFeatures({ metrics, metricTimeSeries });
+            assert.ok(Array.isArray(result.correlations));
+            assert.ok(result.coverageConfidence instanceof Map);
+        });
+    });
+    describe('evaluationsPerInput branch', () => {
+        const metricsWithConf = [
+            makeMetricResult({
+                name: 'relevance',
+                confidence: {
+                    level: 'high',
+                    sampleCount: COUNT_HUNDRED,
+                    scoreStdDev: DELTA,
+                    evaluatorCount: 1,
+                    evaluatorAgreement: null,
+                },
+            }),
+            makeMetricResult({
+                name: 'faithfulness',
+                confidence: {
+                    level: 'medium',
+                    sampleCount: COUNT_HUNDRED,
+                    scoreStdDev: DELTA,
+                    evaluatorCount: 1,
+                    evaluatorAgreement: null,
+                },
+            }),
+        ];
+        const evaluationsPerInput = new Map([
+            ['relevance', [COUNT_TEN, COUNT_TEN, COUNT_TEN, COUNT_TEN, COUNT_TEN]],
+            ['faithfulness', [COUNT_TEN, COUNT_TEN]],
+        ]);
+        it('populates coverageConfidence for metrics with confidence + evaluationsPerInput', () => {
+            const result = computeDerivedFeatures({ metrics: metricsWithConf, evaluationsPerInput });
+            assert.ok(result.coverageConfidence.size >= COUNT_TWO);
+        });
+        it('includes relevance key in coverageConfidence', () => {
+            const result = computeDerivedFeatures({ metrics: metricsWithConf, evaluationsPerInput });
+            assert.ok(result.coverageConfidence.has('relevance'));
+        });
+        it('includes faithfulness key in coverageConfidence', () => {
+            const result = computeDerivedFeatures({ metrics: metricsWithConf, evaluationsPerInput });
+            assert.ok(result.coverageConfidence.has('faithfulness'));
+        });
+        it('skips metrics with no evaluationsPerInput entry', () => {
+            const metricsNoConf = [
+                makeMetricResult({ name: 'coherence' }),
+            ];
+            const result = computeDerivedFeatures({ metrics: metricsNoConf, evaluationsPerInput });
+            assert.strictEqual(result.coverageConfidence.has('coherence'), false);
+        });
+        it('skips metrics with empty evaluationsPerInput array', () => {
+            const emptyEvals = new Map([['relevance', []]]);
+            const result = computeDerivedFeatures({ metrics: metricsWithConf, evaluationsPerInput: emptyEvals });
+            assert.strictEqual(result.coverageConfidence.has('relevance'), false);
+        });
+        it('skips metrics without confidence field', () => {
+            const noConfMetric = [
+                makeMetricResult({ name: 'relevance' }),
+            ];
+            const result = computeDerivedFeatures({ metrics: noConfMetric, evaluationsPerInput });
+            assert.strictEqual(result.coverageConfidence.has('relevance'), false);
+        });
+    });
+    describe('custom cqiWeights', () => {
+        const metrics = [
+            makeMetricResult({ name: 'relevance' }),
+            makeMetricResult({ name: 'faithfulness' }),
+        ];
+        it('uses custom weights, CQI contributions match weighted metrics only', () => {
+            const result = computeDerivedFeatures({
+                metrics,
+                cqiWeights: { relevance: CUSTOM_WEIGHT_HIGH, faithfulness: CUSTOM_WEIGHT_LOW },
+            });
+            assert.ok(result.cqi !== undefined);
+            assert.strictEqual(requireDefined(result.cqi).contributions.length, COUNT_TWO);
+        });
+        it('excludes metrics not in custom cqiWeights', () => {
+            const metricsWithExtra = [
+                makeMetricResult({ name: 'relevance' }),
+                makeMetricResult({ name: 'faithfulness' }),
+                makeMetricResult({ name: 'coherence' }),
+            ];
+            const result = computeDerivedFeatures({
+                metrics: metricsWithExtra,
+                cqiWeights: { relevance: CUSTOM_WEIGHT_HIGH },
+            });
+            const contributions = requireDefined(result.cqi).contributions;
+            assert.ok(contributions.every(c => c.metric !== 'coherence'));
+        });
+        it('computes cqiSensitivity with custom weights when CQI is defined', () => {
+            const result = computeDerivedFeatures({
+                metrics,
+                cqiWeights: { relevance: CUSTOM_WEIGHT_HIGH, faithfulness: CUSTOM_WEIGHT_LOW },
+            });
+            assert.ok(result.cqiSensitivity !== undefined);
+        });
+    });
+    describe('metric with avg null', () => {
+        it('excludes null-avg metric from CQI contributions', () => {
+            const metrics = [
+                makeMetricResult({ name: 'relevance', values: { avg: null, p50: null, p95: null, p99: null, min: null, max: null, count: 0 } }),
+                makeMetricResult({ name: 'faithfulness', values: { avg: TEST_SCORE_STRONG, p50: null, p95: null, p99: null, min: null, max: null, count: COUNT_HUNDRED } }),
+            ];
+            const result = computeDerivedFeatures({ metrics });
+            const contributions = requireDefined(result.cqi).contributions;
+            assert.ok(contributions.every(c => c.metric !== 'relevance'));
+        });
+        it('returns undefined CQI when all metrics have avg null', () => {
+            const metrics = [
+                makeMetricResult({ name: 'relevance', values: { avg: null, p50: null, p95: null, p99: null, min: null, max: null, count: 0 } }),
+            ];
+            const result = computeDerivedFeatures({ metrics });
+            assert.strictEqual(result.cqi, undefined);
+        });
+    });
+    describe('evaluation_latency metric (latency normalization branch)', () => {
+        const latencyMetric = makeMetricResult({
+            name: 'evaluation_latency',
+            values: {
+                avg: LATENCY_AVG_SECONDS,
+                p50: null, p95: null, p99: null, min: null, max: null,
+                count: COUNT_HUNDRED,
+            },
+        });
+        const metrics = [
+            makeMetricResult({ name: 'relevance' }),
+            latencyMetric,
+        ];
+        it('computes CQI when evaluation_latency metric is included', () => {
+            const result = computeDerivedFeatures({ metrics });
+            assert.ok(result.cqi !== undefined);
+        });
+        it('includes evaluation_latency in CQI contributions', () => {
+            const result = computeDerivedFeatures({ metrics });
+            const contributions = requireDefined(result.cqi).contributions;
+            const latencyContrib = contributions.find(c => c.metric === 'evaluation_latency');
+            assert.ok(latencyContrib !== undefined);
+        });
+        it('normalizes evaluation_latency score to 0-1 range', () => {
+            const result = computeDerivedFeatures({ metrics });
+            const contributions = requireDefined(result.cqi).contributions;
+            const latencyContrib = requireDefined(contributions.find(c => c.metric === 'evaluation_latency'));
+            assert.ok(latencyContrib.normalizedScore >= 0 && latencyContrib.normalizedScore <= 1);
+        });
+    });
+    describe('hallucination metric (minimize-invert branch)', () => {
+        const metrics = [
+            makeMetricResult({ name: 'relevance' }),
+            makeMetricResult({
+                name: 'hallucination',
+                values: { avg: DELTA, p50: null, p95: null, p99: null, min: null, max: null, count: COUNT_HUNDRED },
+            }),
+        ];
+        it('includes hallucination in CQI contributions with inverted score', () => {
+            const result = computeDerivedFeatures({ metrics });
+            const contributions = requireDefined(result.cqi).contributions;
+            const hallucinationContrib = contributions.find(c => c.metric === 'hallucination');
+            assert.ok(hallucinationContrib !== undefined);
+            assert.ok(requireDefined(hallucinationContrib).normalizedScore > requireDefined(hallucinationContrib).rawScore);
+        });
+    });
+    describe('large metric set (10+ metrics)', () => {
+        const metricNames = [
+            'relevance', 'faithfulness', 'coherence', 'task_completion',
+            'tool_correctness', 'custom_a', 'custom_b', 'custom_c', 'custom_d', 'custom_e',
+        ];
+        const metrics = metricNames.map(name => makeMetricResult({ name, values: { avg: TEST_SCORE_ADEQUATE, p50: null, p95: null, p99: null, min: null, max: null, count: COUNT_HUNDRED } }));
+        const customWeights = Object.fromEntries(metricNames.map(n => [n, 1 / LARGE_METRIC_COUNT]));
+        it('aggregates CQI over all metrics without error', () => {
+            assert.doesNotThrow(() => computeDerivedFeatures({ metrics, cqiWeights: customWeights }));
+        });
+        it('CQI value is in 0-1 range for large metric set', () => {
+            const result = computeDerivedFeatures({ metrics, cqiWeights: customWeights });
+            const cqi = requireDefined(result.cqi);
+            assert.ok(cqi.value >= 0 && cqi.value <= 1);
+        });
+        it('CQI contributions length matches metric count in weights', () => {
+            const result = computeDerivedFeatures({ metrics, cqiWeights: customWeights });
+            const cqi = requireDefined(result.cqi);
+            assert.strictEqual(cqi.contributions.length, LARGE_METRIC_COUNT);
+        });
+    });
+    describe('mix of latency and non-latency metrics', () => {
+        const metrics = [
+            makeMetricResult({ name: 'relevance' }),
+            makeMetricResult({ name: 'faithfulness' }),
+            makeMetricResult({
+                name: 'hallucination',
+                values: { avg: TEST_AVG_HALLUCINATION_LOW, p50: null, p95: null, p99: null, min: null, max: null, count: COUNT_HUNDRED },
+            }),
+            makeMetricResult({
+                name: 'evaluation_latency',
+                values: { avg: LATENCY_AVG_SECONDS, p50: null, p95: null, p99: null, min: null, max: null, count: COUNT_HUNDRED },
+            }),
+        ];
+        it('computes CQI for mix of metric types', () => {
+            const result = computeDerivedFeatures({ metrics });
+            assert.ok(result.cqi !== undefined);
+        });
+        it('all contributions have normalized scores in 0-1 range', () => {
+            const result = computeDerivedFeatures({ metrics });
+            const contributions = requireDefined(result.cqi).contributions;
+            for (const c of contributions) {
+                assert.ok(c.normalizedScore >= 0 && c.normalizedScore <= 1, `${c.metric} normalizedScore ${c.normalizedScore} out of range`);
+            }
+        });
+    });
+    describe('timeSeries with 10+ points', () => {
+        const metrics = [
+            makeMetricResult({ name: 'relevance' }),
+            makeMetricResult({ name: 'faithfulness' }),
+        ];
+        const metricTimeSeries = new Map([
+            ['relevance', TIMESERIES_MULTI_POINT],
+            ['faithfulness', TIMESERIES_MULTI_POINT.slice().reverse()],
+        ]);
+        it('computes correlations with 10+ point series', () => {
+            const result = computeDerivedFeatures({ metrics, metricTimeSeries });
+            assert.ok(result.correlations.length > 0);
+        });
+        it('computed correlation pearsonR is a finite number', () => {
+            const result = computeDerivedFeatures({ metrics, metricTimeSeries });
+            for (const c of result.correlations) {
+                assert.ok(isFinite(c.pearsonR), `pearsonR should be finite, got ${c.pearsonR}`);
+            }
+        });
+    });
+    describe('knownToxicCombos with metricTimeSeries', () => {
+        const metrics = [
+            makeMetricResult({ name: 'relevance' }),
+            makeMetricResult({ name: 'faithfulness' }),
+        ];
+        const metricTimeSeries = new Map([
+            ['relevance', TIMESERIES_MULTI_POINT],
+            ['faithfulness', TIMESERIES_MULTI_POINT],
+        ]);
+        const knownToxicCombos = new Set(['relevance:faithfulness']);
+        it('returns result without throwing when knownToxicCombos provided', () => {
+            assert.doesNotThrow(() => computeDerivedFeatures({ metrics, metricTimeSeries, knownToxicCombos }));
+        });
+        it('correlations array is non-empty with knownToxicCombos', () => {
+            const result = computeDerivedFeatures({ metrics, metricTimeSeries, knownToxicCombos });
+            assert.ok(result.correlations.length > 0);
+        });
+    });
+});
+//# sourceMappingURL=qfe-derived-paths.test.js.map

package/dist/lib/quality/qfe-derived-paths.test.js.map

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

package/dist/lib/quality/qfe-dynamics-paths.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tests for computeMetricDynamics branch paths that exercise exponentialSmooth.
+ * Covers: single-value array, two-value, monotone increase/decrease,
+ * parabolic series, inflection flag, projection, confidence scaling,
+ * identical values, and long series (20+ points).
+ */
+export {};
+//# sourceMappingURL=qfe-dynamics-paths.test.d.ts.map

package/dist/lib/quality/qfe-dynamics-paths.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qfe-dynamics-paths.test.d.ts","sourceRoot":"","sources":["../../../src/lib/quality/qfe-dynamics-paths.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/lib/quality/qfe-dynamics-paths.test.js

@@ -0,0 +1,223 @@
+/**
+ * Tests for computeMetricDynamics branch paths that exercise exponentialSmooth.
+ * Covers: single-value array, two-value, monotone increase/decrease,
+ * parabolic series, inflection flag, projection, confidence scaling,
+ * identical values, and long series (20+ points).
+ */
+import { describe, it } from 'vitest';
+import * as assert from 'node:assert';
+import { computeMetricDynamics } from './quality-feature-engineering.js';
+import { roundTo, SCORE_PRECISION } from './quality-metrics.js';
+import { DYNAMICS_CONFIDENCE_BASE, DYNAMICS_CONFIDENCE_MAX, DYNAMICS_CONFIDENCE_STEP, } from './quality-constants.js';
+import { COUNT_THREE, COUNT_SIX, COUNT_NINE, COUNT_TWENTY, DELTA, } from '../../test-helpers/test-constants.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeTrend(overrides) {
+    return {
+        direction: 'stable',
+        delta: 0,
+        percentChange: 0,
+        previousValue: 0.8,
+        currentValue: 0.8,
+        aggregation: 'avg',
+        ...overrides,
+    };
+}
+/** Build a MetricTrend with the given delta value */
+function trendWithDelta(delta) {
+    return makeTrend({ delta });
+}
+// ---------------------------------------------------------------------------
+// Constants used in assertions
+// ---------------------------------------------------------------------------
+const PERIOD_1H = 1;
+const BASE_VALUE = 0.5;
+const STEP = 0.05;
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('quality-feature-engineering — metric dynamics paths', () => {
+    // -------------------------------------------------------------------------
+    // No trendHistory — fallback path (backward-compat)
+    // -------------------------------------------------------------------------
+    describe('fallback path (no trendHistory)', () => {
+        it('single trend: zero velocity and zero acceleration with no previous', () => {
+            const current = trendWithDelta(0);
+            const result = computeMetricDynamics(current, undefined, PERIOD_1H);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            assert.strictEqual(result.velocity, 0);
+            assert.strictEqual(result.acceleration, 0);
+            assert.strictEqual(result.inflectionDetected, false);
+        });
+        it('two trends: computes acceleration from raw deltas', () => {
+            // velocity = 0.1, previousVelocity = 0.05 → acceleration = 0.05
+            const current = trendWithDelta(0.1);
+            const previous = trendWithDelta(STEP);
+            const result = computeMetricDynamics(current, previous, PERIOD_1H);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            assert.strictEqual(result.velocity, roundTo(0.1, SCORE_PRECISION));
+            assert.strictEqual(result.acceleration, roundTo(STEP, SCORE_PRECISION));
+            assert.strictEqual(result.inflectionDetected, false);
+        });
+        it('inflection detected when raw velocity changes sign', () => {
+            const current = trendWithDelta(-0.1);
+            const previous = trendWithDelta(0.1);
+            const result = computeMetricDynamics(current, previous, PERIOD_1H);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            assert.strictEqual(result.inflectionDetected, true);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // trendHistory path — exercises exponentialSmooth
+    // -------------------------------------------------------------------------
+    describe('trendHistory path — exponentialSmooth exercised', () => {
+        it('single-item history (< 2): falls back to raw computation, no smoothing', () => {
+            // trendHistory.length === 1 → does NOT enter the smoothing branch
+            // Fallback uses currentTrend.delta, not history entries
+            const history = [trendWithDelta(0.1)];
+            const current = trendWithDelta(STEP);
+            const result = computeMetricDynamics(current, undefined, PERIOD_1H, undefined, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            assert.strictEqual(result.velocity, roundTo(STEP / PERIOD_1H, SCORE_PRECISION));
+            assert.strictEqual(result.acceleration, 0);
+        });
+        it('two-item history: smoothing applied, velocity equals EMA of two deltas', () => {
+            // EMA alpha=0.3: smoothed[0]=v0, smoothed[1]=0.3*v1 + 0.7*v0
+            const delta0 = 0.1;
+            const delta1 = 0.2;
+            const history = [trendWithDelta(delta0), trendWithDelta(delta1)];
+            const current = history[history.length - 1];
+            const result = computeMetricDynamics(current, undefined, PERIOD_1H, undefined, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            const alpha = 0.3;
+            const smoothed0 = delta0; // 0.1
+            const smoothed1 = alpha * delta1 + (1 - alpha) * smoothed0; // 0.3*0.2 + 0.7*0.1 = 0.13
+            assert.strictEqual(result.velocity, roundTo(smoothed1, SCORE_PRECISION));
+            // acceleration = (smoothed1 - smoothed0) / periodHours
+            assert.strictEqual(result.acceleration, roundTo((smoothed1 - smoothed0) / PERIOD_1H, SCORE_PRECISION));
+        });
+        it('3+ values monotone increase: positive velocity, low acceleration', () => {
+            const history = Array.from({ length: COUNT_THREE }, (_, i) => trendWithDelta(STEP * (i + 1)));
+            const result = computeMetricDynamics(history[history.length - 1], undefined, PERIOD_1H, undefined, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            assert.ok(result.velocity > 0, `velocity=${result.velocity} should be positive`);
+        });
+        it('3+ values monotone decrease: negative velocity', () => {
+            const history = Array.from({ length: COUNT_THREE }, (_, i) => trendWithDelta(-STEP * (i + 1)));
+            const result = computeMetricDynamics(history[history.length - 1], undefined, PERIOD_1H, undefined, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            assert.ok(result.velocity < 0, `velocity=${result.velocity} should be negative`);
+        });
+        it('identical values: zero velocity and zero acceleration', () => {
+            const history = Array.from({ length: COUNT_THREE }, () => trendWithDelta(0));
+            const result = computeMetricDynamics(history[0], undefined, PERIOD_1H, undefined, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            assert.strictEqual(result.velocity, 0);
+            assert.strictEqual(result.acceleration, 0);
+            assert.strictEqual(result.inflectionDetected, false);
+        });
+        it('parabolic series (up then down): non-zero acceleration when directions differ', () => {
+            // Increasing then decreasing deltas — the EMA will capture the change in slope
+            const rising = [0.05, 0.10, 0.15];
+            const falling = [0.10, 0.05, 0.00];
+            const deltas = [...rising, ...falling];
+            const history = deltas.map(d => trendWithDelta(d));
+            const result = computeMetricDynamics(history[history.length - 1], undefined, PERIOD_1H, undefined, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            // Acceleration should be non-zero because smoothed velocity is changing
+            assert.ok(Number.isFinite(result.acceleration));
+        });
+        it('inflection detected when smoothed velocity changes sign', () => {
+            // EMA alpha=0.3: after 4 entries of +0.5, EMA ≈ 0.2 at step 5 (after first -0.5).
+            // At step 6, EMA = 0.3*(-0.5) + 0.7*0.2 = -0.01 < 0.
+            // So last two smoothed velocities go from positive to negative → inflection = true.
+            const history = [
+                trendWithDelta(0.5),
+                trendWithDelta(0.5),
+                trendWithDelta(0.5),
+                trendWithDelta(0.5),
+                trendWithDelta(-0.5),
+                trendWithDelta(-0.5),
+            ];
+            const result = computeMetricDynamics(history[history.length - 1], undefined, PERIOD_1H, undefined, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            assert.strictEqual(result.inflectionDetected, true);
+        });
+        it('confidence increases with more data points (below cap)', () => {
+            // DYNAMICS_CONFIDENCE_MAX = 0.95, cap reached at n=10 (0.2 + 0.075*10 = 0.95).
+            // Compare n=3, n=6, n=9 — all below cap, strictly increasing.
+            const makeHistory = (n) => Array.from({ length: n }, () => trendWithDelta(STEP));
+            const hist3 = makeHistory(COUNT_THREE);
+            const hist6 = makeHistory(COUNT_SIX);
+            const hist9 = makeHistory(COUNT_NINE);
+            const r3 = computeMetricDynamics(hist3[hist3.length - 1], undefined, PERIOD_1H, undefined, hist3);
+            const r6 = computeMetricDynamics(hist6[hist6.length - 1], undefined, PERIOD_1H, undefined, hist6);
+            const r9 = computeMetricDynamics(hist9[hist9.length - 1], undefined, PERIOD_1H, undefined, hist9);
+            if (!r3 || !r6 || !r9)
+                throw new Error('expected r3, r6, r9 to be defined');
+            assert.ok(r3.confidence < r6.confidence, `conf3=${r3.confidence} should be < conf6=${r6.confidence}`);
+            assert.ok(r6.confidence < r9.confidence, `conf6=${r6.confidence} should be < conf9=${r9.confidence}`);
+        });
+        it('confidence for 3-item history matches formula: base + step * 3', () => {
+            const history = Array.from({ length: COUNT_THREE }, () => trendWithDelta(STEP));
+            const result = computeMetricDynamics(history[0], undefined, PERIOD_1H, undefined, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            const expected = roundTo(Math.min(DYNAMICS_CONFIDENCE_MAX, DYNAMICS_CONFIDENCE_BASE + DYNAMICS_CONFIDENCE_STEP * COUNT_THREE), SCORE_PRECISION);
+            assert.strictEqual(result.confidence, expected);
+        });
+        it('very long series (20+ points): confidence capped at max', () => {
+            const history = Array.from({ length: COUNT_TWENTY }, (_, i) => trendWithDelta(STEP * i));
+            const result = computeMetricDynamics(history[history.length - 1], undefined, PERIOD_1H, undefined, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            assert.strictEqual(result.confidence, DYNAMICS_CONFIDENCE_MAX);
+        });
+        it('projection: positive velocity toward above threshold produces warning status', () => {
+            const currentValue = BASE_VALUE;
+            const thresholdValue = BASE_VALUE + 0.1;
+            const history = Array.from({ length: COUNT_THREE }, () => makeTrend({ delta: 0.05, currentValue }));
+            const thresholds = [{ value: thresholdValue, direction: 'above', severity: 'warning' }];
+            const result = computeMetricDynamics(history[history.length - 1], undefined, PERIOD_1H, thresholds, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            assert.ok(result.projectedStatus === 'warning' || result.projectedStatus === 'healthy', `projectedStatus=${result.projectedStatus} should be warning or healthy`);
+        });
+        it('projection: positive velocity with above threshold produces non-null breachTime if moving toward it', () => {
+            // currentValue = 0.5, threshold above at 0.6, velocity positive → will breach
+            const current = makeTrend({ delta: 0.1, currentValue: BASE_VALUE });
+            const history = Array.from({ length: COUNT_THREE }, () => makeTrend({ delta: 0.1, currentValue: BASE_VALUE }));
+            const thresholds = [{ value: 0.6, direction: 'above', severity: 'critical' }];
+            const result = computeMetricDynamics(current, undefined, PERIOD_1H, thresholds, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            // projectedBreachTime will be set if smoothed velocity is positive
+            if (result.velocity > 0) {
+                assert.ok(result.projectedBreachTime !== undefined, 'expected projectedBreachTime to be set');
+                assert.ok(result.projectedStatus === 'critical');
+            }
+        });
+        it('stable long series: smooth velocity stays stable across many points', () => {
+            const history = Array.from({ length: COUNT_TWENTY }, () => trendWithDelta(STEP));
+            const result = computeMetricDynamics(history[history.length - 1], undefined, PERIOD_1H, undefined, history);
+            if (result === undefined)
+                throw new Error('expected result to be defined');
+            // Constant-delta series → smoothed velocity converges to delta/period = STEP
+            assert.ok(Math.abs(result.velocity - STEP) < DELTA, `velocity=${result.velocity} should be near ${STEP}`);
+            // Acceleration should converge near zero
+            assert.ok(Math.abs(result.acceleration) < DELTA, `acceleration=${result.acceleration} should be near 0`);
+        });
+    });
+});
+//# sourceMappingURL=qfe-dynamics-paths.test.js.map