observability-toolkit 2.0.0 → 2.1.0

package/dist/lib/quality/bucket-utils.test.js

@@ -0,0 +1,42 @@
+import { describe, it } from 'vitest';
+import assert from 'node:assert';
+import { buildEvenBucketBoundaries, getEvenBucketIndex } from './bucket-utils.js';
+const START_ZERO = 0;
+const END_TEN = 10;
+const BUCKET_COUNT_FIVE = 5;
+const FIRST_INDEX = 0;
+const LAST_INDEX = BUCKET_COUNT_FIVE - 1;
+const BUCKET_WIDTH_TWO = 2;
+const MIDDLE_INDEX = 2;
+const VALUE_BEFORE_START = -1;
+const VALUE_IN_FIRST_BUCKET = 1;
+const VALUE_IN_MIDDLE_BUCKET = 5;
+const VALUE_AFTER_END = 11;
+const ZERO_WIDTH = 0;
+describe('bucket-utils', () => {
+    it('builds fixed-width bucket boundaries', () => {
+        const boundaries = buildEvenBucketBoundaries(START_ZERO, END_TEN, BUCKET_COUNT_FIVE);
+        assert.strictEqual(boundaries.length, BUCKET_COUNT_FIVE);
+        assert.deepStrictEqual(boundaries[FIRST_INDEX], { start: START_ZERO, end: BUCKET_WIDTH_TWO });
+        assert.deepStrictEqual(boundaries[LAST_INDEX], { start: END_TEN - BUCKET_WIDTH_TWO, end: END_TEN });
+    });
+    it('returns null for values before bucket start', () => {
+        const idx = getEvenBucketIndex(VALUE_BEFORE_START, START_ZERO, BUCKET_WIDTH_TWO, BUCKET_COUNT_FIVE);
+        assert.strictEqual(idx, null);
+    });
+    it('returns bucket index for in-range values', () => {
+        const firstIdx = getEvenBucketIndex(VALUE_IN_FIRST_BUCKET, START_ZERO, BUCKET_WIDTH_TWO, BUCKET_COUNT_FIVE);
+        const middleIdx = getEvenBucketIndex(VALUE_IN_MIDDLE_BUCKET, START_ZERO, BUCKET_WIDTH_TWO, BUCKET_COUNT_FIVE);
+        assert.strictEqual(firstIdx, FIRST_INDEX);
+        assert.strictEqual(middleIdx, MIDDLE_INDEX);
+    });
+    it('clamps values after range into the last bucket', () => {
+        const idx = getEvenBucketIndex(VALUE_AFTER_END, START_ZERO, BUCKET_WIDTH_TWO, BUCKET_COUNT_FIVE);
+        assert.strictEqual(idx, LAST_INDEX);
+    });
+    it('handles zero-width buckets like existing callers', () => {
+        const idx = getEvenBucketIndex(START_ZERO, START_ZERO, ZERO_WIDTH, BUCKET_COUNT_FIVE);
+        assert.strictEqual(idx, null);
+    });
+});
+//# sourceMappingURL=bucket-utils.test.js.map

package/dist/lib/quality/bucket-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucket-utils.test.js","sourceRoot":"","sources":["../../../src/lib/quality/bucket-utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAElF,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,OAAO,GAAG,EAAE,CAAC;AACnB,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,UAAU,GAAG,iBAAiB,GAAG,CAAC,CAAC;AACzC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,kBAAkB,GAAG,CAAC,CAAC,CAAC;AAC9B,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACjC,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,UAAU,GAAG,yBAAyB,CAAC,UAAU,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;QACrF,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QACzD,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC9F,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAAG,kBAAkB,CAC5B,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,CAClB,CAAC;QACF,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,QAAQ,GAAG,kBAAkB,CACjC,qBAAqB,EACrB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,CAClB,CAAC;QACF,MAAM,SAAS,GAAG,kBAAkB,CAClC,sBAAsB,EACtB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,CAClB,CAAC;QACF,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1C,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,GAAG,GAAG,kBAAkB,CAC5B,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,iBAAiB,CAClB,CAAC;QACF,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,kBAAkB,CAC5B,UAAU,EACV,UAAU,EACV,UAAU,EACV,iBAAiB,CAClB,CAAC;QACF,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/quality/qfe-backtest-detail.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Deep coverage for isPointBreaching (via backtestDegradationConfig).
+ */
+export {};
+//# sourceMappingURL=qfe-backtest-detail.test.d.ts.map

package/dist/lib/quality/qfe-backtest-detail.test.d.ts.map

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

package/dist/lib/quality/qfe-backtest-detail.test.js

@@ -0,0 +1,179 @@
+/**
+ * Deep coverage for isPointBreaching (via backtestDegradationConfig).
+ */
+import { describe, it } from 'vitest';
+import * as assert from 'node:assert';
+import { backtestDegradationConfig, } from './quality-feature-engineering.js';
+import { COUNT_TWO, COUNT_THREE, COUNT_FIVE, COUNT_TEN, COUNT_FORTY, COUNT_HUNDRED, DELTA, EPOCH_MS, } from '../../test-helpers/test-constants.js';
+import { LATENCY_SKEW_SIGNAL_THRESHOLD } from './quality-constants.js';
+// ============================================================================
+// Local test constants — no magic numbers
+// ============================================================================
+const VARIANCE_THRESHOLD_MEDIUM = 2.0;
+const COVERAGE_DROP_THRESHOLD_MEDIUM = 0.2;
+/** Baseline snapshot — no signals breaching */
+const QUIET_SNAPSHOT = {
+    currentStdDev: DELTA,
+    baselineStdDev: DELTA,
+    coverageGapCount: 0,
+    totalCoverageCells: COUNT_HUNDRED,
+    latencyP50: COUNT_TWO,
+    latencyP95: COUNT_TWO,
+};
+/** Snapshot with clear variance spike (ratio = 10 × baseline) */
+const VARIANCE_SPIKE_SNAPSHOT = {
+    currentStdDev: DELTA * COUNT_TEN,
+    baselineStdDev: DELTA,
+    coverageGapCount: 0,
+    totalCoverageCells: COUNT_HUNDRED,
+    latencyP50: COUNT_TWO,
+    latencyP95: COUNT_TWO,
+};
+const STEP_MS = 60_000;
+function makeTimeSeries(snapshots) {
+    return snapshots.map((s, i) => ({
+        timestamp: EPOCH_MS + i * STEP_MS,
+        currentStdDev: s.currentStdDev,
+        baselineStdDev: s.baselineStdDev,
+        coverageGapCount: s.coverageGapCount,
+        totalCoverageCells: s.totalCoverageCells,
+        latencyP50: s.latencyP50 ?? 0,
+        latencyP95: s.latencyP95 ?? 0,
+        historicalValues: [],
+    }));
+}
+function makeIncident(startIdx, endIdx) {
+    return {
+        startTime: new Date(EPOCH_MS + startIdx * STEP_MS).toISOString(),
+        endTime: new Date(EPOCH_MS + endIdx * STEP_MS).toISOString(),
+        severity: 'major',
+    };
+}
+// ============================================================================
+// Tests
+// ============================================================================
+describe('quality-feature-engineering — backtest detail', () => {
+    describe('isPointBreaching via backtestDegradationConfig', () => {
+        const BASE_CONFIG = {
+            varianceThreshold: VARIANCE_THRESHOLD_MEDIUM,
+            coverageDropoutThreshold: COVERAGE_DROP_THRESHOLD_MEDIUM,
+            latencySkewThreshold: LATENCY_SKEW_SIGNAL_THRESHOLD,
+            confirmationWindow: 1,
+        };
+        it('variance breach — varianceIncrease > threshold triggers detection', () => {
+            // currentStdDev / baselineStdDev = 5 > 2.0
+            const ts = makeTimeSeries([{
+                    currentStdDev: DELTA * COUNT_FIVE,
+                    baselineStdDev: DELTA,
+                    coverageGapCount: 0,
+                    totalCoverageCells: COUNT_HUNDRED,
+                    latencyP50: COUNT_TWO,
+                    latencyP95: COUNT_TWO,
+                }]);
+            const incidents = [makeIncident(0, 0)];
+            const r = backtestDegradationConfig(BASE_CONFIG, ts, incidents);
+            assert.strictEqual(r.truePositives, 1, 'variance breach should produce TP');
+            assert.strictEqual(r.falseNegatives, 0);
+        });
+        it('coverage breach — coverageDrop > threshold triggers detection', () => {
+            // dropout = 40/100 = 0.4 > 0.2
+            const ts = makeTimeSeries([{
+                    currentStdDev: DELTA,
+                    baselineStdDev: DELTA,
+                    coverageGapCount: COUNT_FORTY,
+                    totalCoverageCells: COUNT_HUNDRED,
+                    latencyP50: COUNT_TWO,
+                    latencyP95: COUNT_TWO,
+                }]);
+            const incidents = [makeIncident(0, 0)];
+            const r = backtestDegradationConfig(BASE_CONFIG, ts, incidents);
+            assert.strictEqual(r.truePositives, 1, 'coverage breach should produce TP');
+        });
+        it('both variance and coverage breach simultaneously', () => {
+            const ts = makeTimeSeries([{
+                    currentStdDev: DELTA * COUNT_FIVE,
+                    baselineStdDev: DELTA,
+                    coverageGapCount: COUNT_FORTY,
+                    totalCoverageCells: COUNT_HUNDRED,
+                    latencyP50: COUNT_TWO,
+                    latencyP95: COUNT_TWO,
+                }]);
+            const incidents = [makeIncident(0, 0)];
+            const r = backtestDegradationConfig(BASE_CONFIG, ts, incidents);
+            assert.strictEqual(r.truePositives, 1, 'dual breach should produce TP');
+            assert.strictEqual(r.falseNegatives, 0);
+        });
+        it('neither breach — point classified as true negative when outside incident', () => {
+            const ts = makeTimeSeries([QUIET_SNAPSHOT]);
+            // No incident — point is not labeled degraded
+            const r = backtestDegradationConfig(BASE_CONFIG, ts, []);
+            assert.strictEqual(r.trueNegatives, 1, 'non-breaching outside incident is TN');
+            assert.strictEqual(r.falsePositives, 0);
+        });
+        it('neither breach during labeled incident — false negative', () => {
+            const ts = makeTimeSeries([QUIET_SNAPSHOT]);
+            const incidents = [makeIncident(0, 0)];
+            const r = backtestDegradationConfig(BASE_CONFIG, ts, incidents);
+            assert.strictEqual(r.falseNegatives, 1, 'non-breaching inside incident is FN');
+            assert.strictEqual(r.truePositives, 0);
+        });
+        it('missing/zero baselineStdDev — varianceRatio defaults to 0 (no variance breach)', () => {
+            const ts = makeTimeSeries([{
+                    currentStdDev: COUNT_TEN,
+                    baselineStdDev: 0,
+                    coverageGapCount: 0,
+                    totalCoverageCells: COUNT_HUNDRED,
+                    latencyP50: COUNT_TWO,
+                    latencyP95: COUNT_TWO,
+                }]);
+            const incidents = [makeIncident(0, 0)];
+            const r = backtestDegradationConfig(BASE_CONFIG, ts, incidents);
+            // varianceRatio = 0 (because baselineStdDev = 0), no other signal → FN
+            assert.strictEqual(r.falseNegatives, 1, 'zero baseline produces varianceRatio=0 → no breach');
+        });
+        it('missing/zero totalCoverageCells — dropoutRate defaults to 0 (no coverage breach)', () => {
+            const ts = makeTimeSeries([{
+                    currentStdDev: DELTA,
+                    baselineStdDev: DELTA,
+                    coverageGapCount: COUNT_FORTY,
+                    totalCoverageCells: 0,
+                    latencyP50: COUNT_TWO,
+                    latencyP95: COUNT_TWO,
+                }]);
+            const incidents = [makeIncident(0, 0)];
+            const r = backtestDegradationConfig(BASE_CONFIG, ts, incidents);
+            // dropoutRate = 0 because totalCoverageCells=0 → no coverage breach → FN
+            assert.strictEqual(r.falseNegatives, 1, 'zero total cells produces dropoutRate=0 → no breach');
+        });
+        it('empty time series returns zero-valued result', () => {
+            const r = backtestDegradationConfig(BASE_CONFIG, [], []);
+            assert.strictEqual(r.truePositives, 0);
+            assert.strictEqual(r.falsePositives, 0);
+            assert.strictEqual(r.falseNegatives, 0);
+            assert.strictEqual(r.trueNegatives, 0);
+            assert.strictEqual(r.pointPrecision, 0);
+            assert.strictEqual(r.pointRecall, 0);
+            assert.strictEqual(r.pointF1, 0);
+        });
+        it('confirmationWindow=2 requires consecutive breaches before confirming', () => {
+            // [breach, quiet, breach, breach] — only last two consecutive fires
+            const twoWindowConfig = { ...BASE_CONFIG, confirmationWindow: COUNT_TWO };
+            const snapshots = [
+                VARIANCE_SPIKE_SNAPSHOT,
+                QUIET_SNAPSHOT,
+                VARIANCE_SPIKE_SNAPSHOT,
+                VARIANCE_SPIKE_SNAPSHOT,
+            ];
+            const ts = makeTimeSeries(snapshots);
+            const incidents = [makeIncident(0, COUNT_THREE)]; // entire range is "incident"
+            const r = backtestDegradationConfig(twoWindowConfig, ts, incidents);
+            // Idx 0: breach, consecutive=1 < 2 → not confirmed → FN
+            // Idx 1: quiet, consecutive=0 → not confirmed → FN
+            // Idx 2: breach, consecutive=1 < 2 → not confirmed → FN
+            // Idx 3: breach, consecutive=2 >= 2 → confirmed → TP
+            assert.strictEqual(r.truePositives, 1, 'only 4th point (2 consecutive breaches) is confirmed');
+            assert.strictEqual(r.falseNegatives, COUNT_THREE);
+        });
+    });
+});
+//# sourceMappingURL=qfe-backtest-detail.test.js.map

package/dist/lib/quality/qfe-backtest-detail.test.js.map

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

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

@@ -0,0 +1,5 @@
+/**
+ * Branch-coverage tests for shouldRecalibrate and computeCalibrationDistributions.
+ */
+export {};
+//# sourceMappingURL=qfe-calibration-paths.test.d.ts.map

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

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

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

@@ -0,0 +1,203 @@
+/**
+ * Branch-coverage tests for shouldRecalibrate and computeCalibrationDistributions.
+ */
+import { describe, it } from 'vitest';
+import * as assert from 'node:assert';
+import { shouldRecalibrate, computeCalibrationDistributions, MIN_QUANTILE_SAMPLE_SIZE, } from './quality-feature-engineering.js';
+import { PSI_RECALIBRATION_THRESHOLD, CALIBRATION_WINDOW_DAYS } from './quality-constants.js';
+import { COUNT_HUNDRED, COUNT_TWO_HUNDRED, COUNT_THREE_HUNDRED, } from '../../test-helpers/test-constants.js';
+import { TIME_MS } from '../core/units.js';
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+/** n uniformly-spread scores in [0, 1) */
+function makeUniform(n) {
+    return Array.from({ length: n }, (_, i) => i / n);
+}
+/** n scores tightly clustered near 0.9 (shifted distribution) */
+function makeShifted(n) {
+    return Array.from({ length: n }, (_, i) => 0.85 + (i / n) * 0.1);
+}
+const SAMPLE_WINDOW_START = '2026-02-08T00:00:00.000Z';
+const SAMPLE_WINDOW_END = '2026-03-10T00:00:00.000Z';
+const SAMPLE_LAST_CALIBRATED = '2026-03-10T00:00:00.000Z';
+/** Build a minimal CalibrationState with rawScores */
+function makeState(rawScores) {
+    return {
+        lastCalibrated: SAMPLE_LAST_CALIBRATED,
+        distributions: {
+            relevance: {
+                distribution: { p10: 0.1, p25: 0.25, p50: 0.5, p75: 0.75, p90: 0.9 },
+                sampleSize: COUNT_TWO_HUNDRED,
+                windowStart: SAMPLE_WINDOW_START,
+                windowEnd: SAMPLE_WINDOW_END,
+            },
+        },
+        rawScores,
+    };
+}
+// ---------------------------------------------------------------------------
+// shouldRecalibrate
+// ---------------------------------------------------------------------------
+describe('quality-feature-engineering — calibration paths', () => {
+    describe('shouldRecalibrate', () => {
+        it('returns shouldWrite: false and empty psiValues when currentScores is empty and state exists', () => {
+            const state = makeState({ relevance: makeUniform(COUNT_TWO_HUNDRED) });
+            const result = shouldRecalibrate(state, {});
+            assert.strictEqual(result.shouldWrite, false);
+            assert.deepStrictEqual(result.psiValues, {});
+        });
+        it('does not include new metric key in psiValues when no previous rawScores for that metric', () => {
+            const state = makeState({ relevance: makeUniform(COUNT_TWO_HUNDRED) });
+            const result = shouldRecalibrate(state, {
+                relevance: makeUniform(COUNT_TWO_HUNDRED),
+                coherence: makeUniform(COUNT_TWO_HUNDRED),
+            });
+            assert.strictEqual(result.shouldWrite, true);
+            assert.ok(!('coherence' in result.psiValues), 'coherence should not appear in psiValues');
+        });
+        it('includes PSI value for stable metric (PSI <= threshold)', () => {
+            const scores = makeUniform(COUNT_TWO_HUNDRED);
+            const state = makeState({ relevance: scores });
+            const result = shouldRecalibrate(state, { relevance: scores });
+            assert.ok('relevance' in result.psiValues, 'expected relevance in psiValues');
+            assert.ok(result.psiValues['relevance'] <= PSI_RECALIBRATION_THRESHOLD, `PSI ${result.psiValues['relevance']} should be <= ${PSI_RECALIBRATION_THRESHOLD}`);
+        });
+        it('includes PSI value for drifted metric and value exceeds threshold', () => {
+            const previous = makeUniform(COUNT_TWO_HUNDRED);
+            const current = makeShifted(COUNT_TWO_HUNDRED);
+            const state = makeState({ relevance: previous });
+            const result = shouldRecalibrate(state, { relevance: current });
+            assert.ok('relevance' in result.psiValues, 'expected relevance in psiValues');
+            assert.ok(result.psiValues['relevance'] > PSI_RECALIBRATION_THRESHOLD, `PSI ${result.psiValues['relevance']} should be > ${PSI_RECALIBRATION_THRESHOLD}`);
+        });
+        it('returns shouldWrite: false and psiValues for all metrics when all stable', () => {
+            const scores = makeUniform(COUNT_TWO_HUNDRED);
+            const rawScores = {
+                relevance: scores,
+                coherence: scores,
+                faithfulness: scores,
+            };
+            const state = {
+                lastCalibrated: SAMPLE_LAST_CALIBRATED,
+                distributions: {},
+                rawScores,
+            };
+            const result = shouldRecalibrate(state, { relevance: scores, coherence: scores, faithfulness: scores });
+            assert.strictEqual(result.shouldWrite, false);
+            assert.ok('relevance' in result.psiValues);
+            assert.ok('coherence' in result.psiValues);
+            assert.ok('faithfulness' in result.psiValues);
+        });
+        it('returns shouldWrite: true only because of one drifted metric among many stable ones', () => {
+            const stable = makeUniform(COUNT_TWO_HUNDRED);
+            const drifted = makeShifted(COUNT_TWO_HUNDRED);
+            const state = {
+                lastCalibrated: SAMPLE_LAST_CALIBRATED,
+                distributions: {},
+                rawScores: {
+                    relevance: stable,
+                    coherence: stable,
+                    faithfulness: stable,
+                },
+            };
+            const result = shouldRecalibrate(state, {
+                relevance: stable,
+                coherence: stable,
+                faithfulness: drifted,
+            });
+            assert.strictEqual(result.shouldWrite, true);
+            assert.ok('relevance' in result.psiValues);
+            assert.ok('coherence' in result.psiValues);
+            assert.ok('faithfulness' in result.psiValues);
+            assert.ok(result.psiValues['faithfulness'] > PSI_RECALIBRATION_THRESHOLD, 'faithfulness PSI should exceed threshold');
+        });
+        it('returns shouldWrite: true and empty psiValues when rawScores property is undefined on state', () => {
+            const state = {
+                lastCalibrated: SAMPLE_LAST_CALIBRATED,
+                distributions: {},
+                // rawScores intentionally absent
+            };
+            const result = shouldRecalibrate(state, { relevance: makeUniform(COUNT_TWO_HUNDRED) });
+            assert.strictEqual(result.shouldWrite, true);
+            assert.deepStrictEqual(result.psiValues, {});
+        });
+    });
+    // ---------------------------------------------------------------------------
+    // computeCalibrationDistributions
+    // ---------------------------------------------------------------------------
+    describe('computeCalibrationDistributions', () => {
+        it('includes entry for metric with exactly MIN_QUANTILE_SAMPLE_SIZE scores', () => {
+            const scores = makeUniform(MIN_QUANTILE_SAMPLE_SIZE);
+            const result = computeCalibrationDistributions({ relevance: scores });
+            assert.ok(result['relevance'], 'expected distribution entry at boundary sample size');
+            assert.strictEqual(result['relevance'].sampleSize, MIN_QUANTILE_SAMPLE_SIZE);
+        });
+        it('sampleSize on distribution matches the number of scores passed in', () => {
+            const result = computeCalibrationDistributions({ relevance: makeUniform(COUNT_THREE_HUNDRED) });
+            assert.strictEqual(result['relevance']?.sampleSize, COUNT_THREE_HUNDRED);
+        });
+        it('handles a single metric with large sample (all percentile keys present)', () => {
+            const result = computeCalibrationDistributions({ coherence: makeUniform(COUNT_TWO_HUNDRED) });
+            const entry = result['coherence'];
+            assert.ok(entry, 'expected coherence entry');
+            const { p10, p25, p50, p75, p90 } = entry.distribution;
+            assert.ok(typeof p10 === 'number', 'p10 should be a number');
+            assert.ok(typeof p25 === 'number', 'p25 should be a number');
+            assert.ok(typeof p50 === 'number', 'p50 should be a number');
+            assert.ok(typeof p75 === 'number', 'p75 should be a number');
+            assert.ok(typeof p90 === 'number', 'p90 should be a number');
+            assert.ok(p10 <= p25 && p25 <= p50 && p50 <= p75 && p75 <= p90, 'percentiles should be non-decreasing');
+        });
+        it('handles 5 metrics with mixed sample sizes — only qualifying ones included', () => {
+            const input = {
+                m1: makeUniform(COUNT_HUNDRED),
+                m2: makeUniform(COUNT_TWO_HUNDRED),
+                m3: makeUniform(MIN_QUANTILE_SAMPLE_SIZE - 1),
+                m4: makeUniform(COUNT_THREE_HUNDRED),
+                m5: makeUniform(MIN_QUANTILE_SAMPLE_SIZE - 1),
+            };
+            const result = computeCalibrationDistributions(input);
+            assert.ok(result['m1'], 'expected m1 (at threshold)');
+            assert.ok(result['m2'], 'expected m2 (above threshold)');
+            assert.strictEqual(result['m3'], undefined, 'm3 should be skipped');
+            assert.ok(result['m4'], 'expected m4');
+            assert.strictEqual(result['m5'], undefined, 'm5 should be skipped');
+        });
+        it('windowEnd is a valid ISO string close to now', () => {
+            const before = Date.now();
+            const result = computeCalibrationDistributions({ relevance: makeUniform(COUNT_HUNDRED) });
+            const after = Date.now();
+            const entry = result['relevance'];
+            assert.ok(entry, 'expected relevance entry');
+            const windowEndMs = new Date(entry.windowEnd).getTime();
+            assert.ok(windowEndMs >= before - 1000 && windowEndMs <= after + 1000, 'windowEnd should be close to now');
+        });
+        it('windowStart is approximately CALIBRATION_WINDOW_DAYS before windowEnd', () => {
+            const result = computeCalibrationDistributions({ relevance: makeUniform(COUNT_HUNDRED) });
+            const entry = result['relevance'];
+            assert.ok(entry, 'expected relevance entry');
+            const windowEndMs = new Date(entry.windowEnd).getTime();
+            const windowStartMs = new Date(entry.windowStart).getTime();
+            const diffDays = (windowEndMs - windowStartMs) / TIME_MS.DAY;
+            // Allow 1-second tolerance in the difference
+            assert.ok(Math.abs(diffDays - CALIBRATION_WINDOW_DAYS) < 0.02, `expected ~${CALIBRATION_WINDOW_DAYS} days gap, got ${diffDays}`);
+        });
+        it('all qualifying metrics share the same windowStart and windowEnd values', () => {
+            const result = computeCalibrationDistributions({
+                relevance: makeUniform(COUNT_HUNDRED),
+                coherence: makeUniform(COUNT_TWO_HUNDRED),
+                faithfulness: makeUniform(COUNT_THREE_HUNDRED),
+            });
+            const relevance = result['relevance'];
+            const coherence = result['coherence'];
+            const faithfulness = result['faithfulness'];
+            assert.ok(relevance && coherence && faithfulness, 'all three should be present');
+            assert.strictEqual(relevance.windowStart, coherence.windowStart);
+            assert.strictEqual(relevance.windowStart, faithfulness.windowStart);
+            assert.strictEqual(relevance.windowEnd, coherence.windowEnd);
+            assert.strictEqual(relevance.windowEnd, faithfulness.windowEnd);
+        });
+    });
+});
+//# sourceMappingURL=qfe-calibration-paths.test.js.map

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

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

package/dist/lib/quality/qfe-correlation-helpers.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tests for internal correlation helpers: fractionalRanks (via computeSpearmanR)
+ * and correlationToCohenD (via computeCorrelationMatrix).
+ */
+export {};
+//# sourceMappingURL=qfe-correlation-helpers.test.d.ts.map

package/dist/lib/quality/qfe-correlation-helpers.test.d.ts.map

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

package/dist/lib/quality/qfe-correlation-helpers.test.js

@@ -0,0 +1,143 @@
+/**
+ * Tests for internal correlation helpers: fractionalRanks (via computeSpearmanR)
+ * and correlationToCohenD (via computeCorrelationMatrix).
+ */
+import { describe, it } from 'vitest';
+import * as assert from 'node:assert';
+import { computeSpearmanR, computeCorrelationMatrix, computePearsonR, } from './quality-feature-engineering.js';
+import { COUNT_THREE, COUNT_FIVE, COUNT_TEN, DELTA, } from '../../test-helpers/test-constants.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Build a simple Map with two named series for computeCorrelationMatrix calls. */
+function twoSeriesMap(a, b) {
+    return new Map([
+        ['metricA', a],
+        ['metricB', b],
+    ]);
+}
+// ---------------------------------------------------------------------------
+// fractionalRanks (exercised via computeSpearmanR)
+// ---------------------------------------------------------------------------
+describe('quality-feature-engineering — correlation helpers', () => {
+    describe('fractionalRanks via computeSpearmanR', () => {
+        it('all unique values produce ranks 1,2,3', () => {
+            const xs = [1, 2, COUNT_THREE];
+            const ys = [1, 2, COUNT_THREE];
+            assert.strictEqual(computeSpearmanR(xs, ys), 1);
+        });
+        it('two tied values both receive average rank', () => {
+            const xs = [1, 1, COUNT_THREE];
+            const ys = [1, 1, COUNT_THREE];
+            assert.strictEqual(computeSpearmanR(xs, ys), 1);
+        });
+        it('three-way tie: all three get same average rank', () => {
+            // constant ranks → zero variance → Pearson on ranks = 0
+            const xs = [COUNT_FIVE, COUNT_FIVE, COUNT_FIVE];
+            const ys = [1, 2, COUNT_THREE];
+            assert.strictEqual(computeSpearmanR(xs, ys), 0);
+        });
+        it('all same values: returns 0 (constant ranks, zero variance)', () => {
+            const xs = Array(COUNT_TEN).fill(COUNT_FIVE);
+            const ys = [1, 2, COUNT_THREE, 4, COUNT_FIVE, 6, 7, 8, 9, COUNT_TEN];
+            assert.strictEqual(computeSpearmanR(xs, ys), 0);
+        });
+        it('single value: returns 0 (below minimum points threshold)', () => {
+            assert.strictEqual(computeSpearmanR([1], [1]), 0);
+        });
+        it('descending order input produces correct negative correlation', () => {
+            // xs ascending, ys strictly descending → Spearman = -1
+            const xs = [1, 2, COUNT_THREE, 4, COUNT_FIVE];
+            const ys = [COUNT_FIVE, 4, COUNT_THREE, 2, 1];
+            assert.strictEqual(computeSpearmanR(xs, ys), -1);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // computeSpearmanR — public wrapper behaviour
+    // -------------------------------------------------------------------------
+    describe('computeSpearmanR public API', () => {
+        it('longer xs than ys: uses min length', () => {
+            const xs = [1, 2, COUNT_THREE, 4, COUNT_FIVE];
+            const ys = [1, 2, COUNT_THREE];
+            const result = computeSpearmanR(xs, ys);
+            assert.strictEqual(result, computeSpearmanR(xs.slice(0, COUNT_THREE), ys));
+        });
+        it('shorter xs: same min-length behaviour', () => {
+            const xs = [1, 2, COUNT_THREE];
+            const ys = [1, 2, COUNT_THREE, 4, COUNT_FIVE];
+            const result = computeSpearmanR(xs, ys);
+            assert.strictEqual(result, computeSpearmanR(xs, ys.slice(0, COUNT_THREE)));
+        });
+        it('short series (< 3 points) returns 0', () => {
+            assert.strictEqual(computeSpearmanR([], []), 0);
+            assert.strictEqual(computeSpearmanR([1], [1]), 0);
+            assert.strictEqual(computeSpearmanR([1, 2], [1, 2]), 0);
+        });
+        it('Spearman handles outliers better than Pearson', () => {
+            // Series with one extreme outlier in xs. Spearman dampens the effect of
+            // the outlier because it operates on ranks, not raw values.
+            const xs = [1, 2, COUNT_THREE, 4, 1000];
+            const ys = [1, 2, COUNT_THREE, 4, COUNT_FIVE];
+            const pearson = computePearsonR(xs, ys);
+            const spearman = computeSpearmanR(xs, ys);
+            // Pearson is pulled toward the outlier; Spearman stays close to 1.0
+            assert.ok(spearman > pearson, `Expected spearman (${spearman}) > pearson (${pearson}) when outlier present`);
+            // Spearman should be very close to 1.0 (rank order is preserved)
+            assert.ok(spearman >= 1 - DELTA, `Expected spearman ≈ 1, got ${spearman}`);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // correlationToCohenD via computeCorrelationMatrix
+    // -------------------------------------------------------------------------
+    describe('correlationToCohenD via computeCorrelationMatrix', () => {
+        it('correlation matrix result includes effectSize field', () => {
+            const xs = [1, 2, COUNT_THREE, 4, COUNT_FIVE, 6, 7, 8, 9, COUNT_TEN];
+            const ys = [1, 2, COUNT_THREE, 4, COUNT_FIVE, 6, 7, 8, 9, COUNT_TEN];
+            const results = computeCorrelationMatrix(twoSeriesMap(xs, ys));
+            assert.ok(results.length > 0);
+            const [pair] = results;
+            assert.ok('effectSize' in pair, 'effectSize field must exist in result');
+        });
+        it('positive r produces positive effectSize', () => {
+            // Strongly positively correlated series
+            const xs = [1, 2, COUNT_THREE, 4, COUNT_FIVE, 6, 7, 8, 9, COUNT_TEN];
+            const ys = [2, 4, 6, 8, COUNT_TEN, 12, 14, 16, 18, 20];
+            const [pair] = computeCorrelationMatrix(twoSeriesMap(xs, ys));
+            assert.ok(pair.effectSize > 0, `Expected effectSize > 0, got ${pair.effectSize}`);
+        });
+        it('negative r still produces positive effectSize (d uses |r|)', () => {
+            // Perfectly negatively correlated series
+            const xs = [1, 2, COUNT_THREE, 4, COUNT_FIVE, 6, 7, 8, 9, COUNT_TEN];
+            const ys = [COUNT_TEN, 9, 8, 7, 6, COUNT_FIVE, 4, COUNT_THREE, 2, 1];
+            const [pair] = computeCorrelationMatrix(twoSeriesMap(xs, ys));
+            assert.ok(pair.effectSize > 0, `Expected effectSize > 0 for negative r, got ${pair.effectSize}`);
+        });
+        it('zero r produces effectSize = 0', () => {
+            // xs symmetric about 0: [-4,-3,-2,-1,0,1,2,3,4] → mean=0
+            // ys = xs^2: covariance(x, x^2) = E[x^3] = 0 by symmetry → r = 0 exactly
+            const xs = [-4, -COUNT_THREE, -2, -1, 0, 1, 2, COUNT_THREE, 4];
+            const ys = xs.map(x => x * x);
+            const pearson = computePearsonR(xs, ys);
+            assert.ok(Math.abs(pearson) < DELTA, `Expected pearsonR ≈ 0, got ${pearson}`);
+            const [pair] = computeCorrelationMatrix(twoSeriesMap(xs, ys));
+            assert.ok(Math.abs(pair.effectSize) < DELTA, `Expected effectSize ≈ 0, got ${pair.effectSize}`);
+        });
+        it('r close to 1.0 produces large effectSize (Cohen d grows as r approaches 1)', () => {
+            const xs = Array.from({ length: COUNT_TEN }, (_, i) => i + 1);
+            const ys = Array.from({ length: COUNT_TEN }, (_, i) => i + 1 + 0.001 * Math.sin(i));
+            const [pair] = computeCorrelationMatrix(twoSeriesMap(xs, ys));
+            // d = 2r / sqrt(1-r^2) — for r≈1, d should be large (>> 1)
+            assert.ok(pair.effectSize > 1, `Expected large effectSize for r≈1, got ${pair.effectSize}`);
+        });
+        it('small r produces small effectSize (d < 0.5 for small category)', () => {
+            const xs = [1, 2, COUNT_THREE, 4, COUNT_FIVE, 6, 7, 8, 9, COUNT_TEN];
+            const ys = [COUNT_FIVE, 1, COUNT_TEN, 2, 6, COUNT_THREE, 8, 4, 9, 7];
+            const pearson = computePearsonR(xs, ys);
+            const [pair] = computeCorrelationMatrix(twoSeriesMap(xs, ys));
+            // d = 2|r|/sqrt(1-r^2); for small |r| this stays small
+            const expectedD = (2 * Math.abs(pearson)) / Math.sqrt(1 - pearson * pearson);
+            assert.ok(Math.abs(pair.effectSize - expectedD) < DELTA, `effectSize ${pair.effectSize} should match computed d ${expectedD}`);
+        });
+    });
+});
+//# sourceMappingURL=qfe-correlation-helpers.test.js.map