@skillsmith/core 0.4.14 → 0.4.15

package/dist/tests/testing/MultiLLMProvider.metrics.test.js

@@ -0,0 +1,149 @@
+/**
+ * SMI-2754: MultiLLMProvider Metrics Tests
+ *
+ * Tests for aggregateMetrics and runCompatibilityTest:
+ * - aggregateMetrics with populated map
+ * - aggregateMetrics with empty map (providerCount === 0 branch)
+ * - runCompatibilityTest with all providers succeeding
+ * - runCompatibilityTest with one provider throwing
+ * - runCompatibilityTest result filtering (score >= 0.7)
+ * - runCompatibilityTest with no providers
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { aggregateMetrics, runCompatibilityTest, } from '../../src/testing/MultiLLMProvider.metrics.js';
+function makeMetrics(provider, overrides = {}) {
+    return {
+        provider,
+        timestamp: new Date(),
+        avgLatencyMs: 100,
+        errorRate: 0,
+        successRate: 1,
+        load: 0,
+        totalCost: 0.5,
+        totalRequests: 10,
+        availability: 1,
+        ...overrides,
+    };
+}
+function makeLLMResponse(provider, latencyMs = 200) {
+    return {
+        content: 'Test response content',
+        provider,
+        model: 'test-model',
+        usage: { inputTokens: 10, outputTokens: 20, totalTokens: 30 },
+        cost: 0.001,
+        latencyMs,
+        usedFallback: false,
+    };
+}
+// ============================================================================
+// aggregateMetrics
+// ============================================================================
+describe('aggregateMetrics', () => {
+    it('aggregates totals correctly from a populated map', () => {
+        const metricsMap = new Map([
+            [
+                'anthropic',
+                makeMetrics('anthropic', {
+                    totalRequests: 10,
+                    totalCost: 1.0,
+                    avgLatencyMs: 200,
+                    successRate: 0.9,
+                }),
+            ],
+            [
+                'openai',
+                makeMetrics('openai', {
+                    totalRequests: 5,
+                    totalCost: 0.5,
+                    avgLatencyMs: 100,
+                    successRate: 0.8,
+                }),
+            ],
+        ]);
+        const result = aggregateMetrics(metricsMap);
+        expect(result.totalRequests).toBe(15);
+        expect(result.totalCost).toBeCloseTo(1.5);
+        // weighted avg: (200*10 + 100*5) / 15 = 2500/15 ≈ 166.67
+        expect(result.avgLatencyMs).toBeCloseTo(166.67, 1);
+        // avg success rate: (0.9 + 0.8) / 2 = 0.85
+        expect(result.avgSuccessRate).toBeCloseTo(0.85);
+        expect(result.providerBreakdown.anthropic).toBe(10);
+        expect(result.providerBreakdown.openai).toBe(5);
+    });
+    it('returns zero values when map is empty (providerCount === 0)', () => {
+        const metricsMap = new Map();
+        const result = aggregateMetrics(metricsMap);
+        expect(result.totalRequests).toBe(0);
+        expect(result.totalCost).toBe(0);
+        expect(result.avgLatencyMs).toBe(0);
+        expect(result.avgSuccessRate).toBe(0);
+    });
+});
+// ============================================================================
+// runCompatibilityTest
+// ============================================================================
+describe('runCompatibilityTest', () => {
+    it('records compatible=true with positive score when all providers succeed', async () => {
+        const completer = vi
+            .fn()
+            .mockImplementation(async (req) => makeLLMResponse(req.provider, 100));
+        const result = await runCompatibilityTest('community/jest-helper', ['anthropic', 'openai'], completer);
+        expect(result.skillId).toBe('community/jest-helper');
+        expect(result.results.anthropic.compatible).toBe(true);
+        expect(result.results.anthropic.score).toBeGreaterThan(0);
+        expect(result.results.openai.compatible).toBe(true);
+        expect(result.overallScore).toBeGreaterThan(0);
+    });
+    it('records compatible=false with score 0 when a provider throws', async () => {
+        const completer = vi.fn().mockImplementation(async (req) => {
+            if (req.provider === 'openai') {
+                throw new Error('Provider unavailable');
+            }
+            return makeLLMResponse(req.provider, 200);
+        });
+        const result = await runCompatibilityTest('community/jest-helper', ['anthropic', 'openai'], completer);
+        expect(result.results.anthropic.compatible).toBe(true);
+        expect(result.results.openai.compatible).toBe(false);
+        expect(result.results.openai.score).toBe(0);
+        expect(result.results.openai.error).toBe('Provider unavailable');
+    });
+    it('includes only providers with score >= 0.7 in recommendedProviders', async () => {
+        const completer = vi.fn().mockImplementation(async (req) => {
+            // Low latency → high score (1 - 50/5000 + 0.3 = 1.29 → clamped to 1.0)
+            if (req.provider === 'anthropic') {
+                return makeLLMResponse('anthropic', 50);
+            }
+            // Very high latency → score of 0.3 (1 - 4900/5000 + 0.3 = 0.32)
+            return makeLLMResponse('openai', 4900);
+        });
+        const result = await runCompatibilityTest('community/test-skill', ['anthropic', 'openai'], completer);
+        // anthropic has a high score (>= 0.7); openai has score ~0.32 (< 0.7)
+        expect(result.recommendedProviders).toContain('anthropic');
+        expect(result.recommendedProviders).not.toContain('openai');
+    });
+    it('returns overallScore 0 and empty recommendedProviders when no providers given', async () => {
+        const completer = vi.fn();
+        const result = await runCompatibilityTest('skill/empty', [], completer);
+        expect(result.overallScore).toBe(0);
+        expect(result.recommendedProviders).toHaveLength(0);
+        expect(completer).not.toHaveBeenCalled();
+    });
+    it('sets testedAt to a Date close to now', async () => {
+        const before = new Date();
+        const completer = vi.fn().mockResolvedValue(makeLLMResponse('anthropic', 100));
+        const result = await runCompatibilityTest('skill/time-check', ['anthropic'], completer);
+        const after = new Date();
+        expect(result.testedAt.getTime()).toBeGreaterThanOrEqual(before.getTime());
+        expect(result.testedAt.getTime()).toBeLessThanOrEqual(after.getTime() + 5);
+    });
+    it('handles non-Error throws by recording "Unknown error"', async () => {
+        const completer = vi.fn().mockImplementationOnce(() => {
+            throw 'string error thrown'; // non-Error object
+        });
+        const result = await runCompatibilityTest('skill/string-throw', ['anthropic'], completer);
+        expect(result.results.anthropic.compatible).toBe(false);
+        expect(result.results.anthropic.error).toBe('Unknown error');
+    });
+});
+//# sourceMappingURL=MultiLLMProvider.metrics.test.js.map

package/dist/tests/testing/MultiLLMProvider.metrics.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiLLMProvider.metrics.test.js","sourceRoot":"","sources":["../../../tests/testing/MultiLLMProvider.metrics.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/testing/MultiLLMProvider.selection.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SMI-2754: MultiLLMProvider Selection Strategy Tests
+ *
+ * Tests for selectProvider and getFallbackProvider covering all uncovered branches:
+ * - cost-constraint branch
+ * - least-loaded strategy
+ * - latency-based strategy
+ * - cost-based strategy
+ * - default-provider fallback
+ * - first-available fallback
+ * - getFallbackProvider: no matching rule
+ * - getFallbackProvider: matching rule with excluded current provider
+ */
+export {};
+//# sourceMappingURL=MultiLLMProvider.selection.test.d.ts.map

package/dist/tests/testing/MultiLLMProvider.selection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiLLMProvider.selection.test.d.ts","sourceRoot":"","sources":["../../../tests/testing/MultiLLMProvider.selection.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/tests/testing/MultiLLMProvider.selection.test.js

@@ -0,0 +1,249 @@
+/**
+ * SMI-2754: MultiLLMProvider Selection Strategy Tests
+ *
+ * Tests for selectProvider and getFallbackProvider covering all uncovered branches:
+ * - cost-constraint branch
+ * - least-loaded strategy
+ * - latency-based strategy
+ * - cost-based strategy
+ * - default-provider fallback
+ * - first-available fallback
+ * - getFallbackProvider: no matching rule
+ * - getFallbackProvider: matching rule with excluded current provider
+ */
+import { describe, it, expect } from 'vitest';
+import { selectProvider, getFallbackProvider, selectRoundRobin, selectLeastLoaded, selectByLatency, selectByCost, } from '../../src/testing/MultiLLMProvider.selection.js';
+// ============================================================================
+// Shared test fixtures
+// ============================================================================
+function makeConfig(overrides = {}) {
+    return {
+        defaultProvider: 'anthropic',
+        providers: {
+            anthropic: {
+                provider: 'anthropic',
+                model: 'claude-sonnet',
+                enabled: true,
+                priority: 'quality',
+                costPerInputToken: 0.003,
+                costPerOutputToken: 0.015,
+            },
+            openai: {
+                provider: 'openai',
+                model: 'gpt-4',
+                enabled: true,
+                priority: 'speed',
+                costPerInputToken: 0.01,
+                costPerOutputToken: 0.03,
+            },
+            google: {
+                provider: 'google',
+                model: 'gemini-pro',
+                enabled: true,
+                priority: 'cost',
+                costPerInputToken: 0.00025,
+                costPerOutputToken: 0.0005,
+            },
+        },
+        loadBalancing: { enabled: false, strategy: 'round-robin' },
+        costOptimization: { enabled: false },
+        circuitBreaker: {
+            timeoutMs: 30000,
+            errorThresholdPercentage: 50,
+            resetTimeoutMs: 60000,
+            volumeThreshold: 10,
+        },
+        enableMetrics: false,
+        useV3Integration: false,
+        fallbackStrategy: {
+            name: 'default',
+            enabled: true,
+            maxAttempts: 3,
+            rules: [],
+        },
+        ...overrides,
+    };
+}
+function makeStatus(currentLoad = 0) {
+    return {
+        available: true,
+        currentLoad,
+        queueLength: 0,
+        activeRequests: 0,
+        circuitState: 'closed',
+    };
+}
+function makeMetrics(avgLatencyMs = 100) {
+    return {
+        provider: 'anthropic',
+        timestamp: new Date(),
+        avgLatencyMs,
+        errorRate: 0,
+        successRate: 1,
+        load: 0,
+        totalCost: 0,
+        totalRequests: 10,
+        availability: 1,
+    };
+}
+// ============================================================================
+// selectRoundRobin
+// ============================================================================
+describe('selectRoundRobin', () => {
+    it('selects provider at roundRobinIndex % providers.length and increments index', () => {
+        const providers = ['anthropic', 'openai', 'google'];
+        const result = selectRoundRobin(providers, 1);
+        expect(result.provider).toBe('openai');
+        expect(result.nextIndex).toBe(2);
+    });
+    it('wraps around using modulo', () => {
+        const providers = ['anthropic', 'openai'];
+        const result = selectRoundRobin(providers, 4);
+        expect(result.provider).toBe('anthropic'); // 4 % 2 = 0
+    });
+});
+// ============================================================================
+// selectLeastLoaded
+// ============================================================================
+describe('selectLeastLoaded', () => {
+    it('selects the provider with the lowest currentLoad', () => {
+        const providers = ['anthropic', 'openai', 'google'];
+        const loads = { anthropic: 0.8, openai: 0.2, google: 0.5 };
+        const getStatus = (p) => makeStatus(loads[p]);
+        expect(selectLeastLoaded(providers, getStatus)).toBe('openai');
+    });
+});
+// ============================================================================
+// selectByLatency
+// ============================================================================
+describe('selectByLatency', () => {
+    it('selects the provider with the lowest avgLatencyMs', () => {
+        const providers = ['anthropic', 'openai', 'google'];
+        const latencies = { anthropic: 300, openai: 100, google: 200 };
+        const getMetrics = (p) => makeMetrics(latencies[p] ?? Infinity);
+        expect(selectByLatency(providers, getMetrics)).toBe('openai');
+    });
+    it('treats missing metrics as Infinity latency', () => {
+        const providers = ['anthropic', 'openai'];
+        const getMetrics = (p) => (p === 'openai' ? makeMetrics(50) : undefined);
+        expect(selectByLatency(providers, getMetrics)).toBe('openai');
+    });
+});
+// ============================================================================
+// selectByCost
+// ============================================================================
+describe('selectByCost', () => {
+    it('selects the provider with the lowest combined cost per token', () => {
+        const providers = ['anthropic', 'openai', 'google'];
+        const config = makeConfig();
+        // google has 0.00025 + 0.0005 = 0.00075 (cheapest)
+        expect(selectByCost(providers, config.providers)).toBe('google');
+    });
+});
+// ============================================================================
+// selectProvider
+// ============================================================================
+describe('selectProvider', () => {
+    const available = ['anthropic', 'openai', 'google'];
+    const getStatus = (p) => makeStatus(p === 'openai' ? 0.1 : 0.9);
+    const getMetrics = (p) => makeMetrics(p === 'google' ? 50 : 300);
+    it('throws when available list is empty', () => {
+        const config = makeConfig();
+        expect(() => selectProvider({ messages: [] }, [], config, 0, getStatus, getMetrics)).toThrow('No providers available');
+    });
+    it('uses cost constraint branch when costConstraints.maxCost is set and costOptimization is enabled', () => {
+        const config = makeConfig({ costOptimization: { enabled: true } });
+        const result = selectProvider({ messages: [], costConstraints: { maxCost: 0.1 } }, available, config, 0, getStatus, getMetrics);
+        // google is cheapest (0.00075 per token total)
+        expect(result.provider).toBe('google');
+        // round-robin index should be unchanged
+        expect(result.nextRoundRobinIndex).toBe(0);
+    });
+    it('uses least-loaded strategy when load balancing is enabled with least-loaded', () => {
+        const config = makeConfig({
+            loadBalancing: { enabled: true, strategy: 'least-loaded' },
+        });
+        const result = selectProvider({ messages: [] }, available, config, 0, getStatus, getMetrics);
+        expect(result.provider).toBe('openai'); // lowest load (0.1)
+    });
+    it('uses latency-based strategy when load balancing is enabled with latency-based', () => {
+        const config = makeConfig({
+            loadBalancing: { enabled: true, strategy: 'latency-based' },
+        });
+        const result = selectProvider({ messages: [] }, available, config, 0, getStatus, getMetrics);
+        expect(result.provider).toBe('google'); // lowest latency (50ms)
+    });
+    it('uses cost-based strategy when load balancing is enabled with cost-based', () => {
+        const config = makeConfig({
+            loadBalancing: { enabled: true, strategy: 'cost-based' },
+        });
+        const result = selectProvider({ messages: [] }, available, config, 0, getStatus, getMetrics);
+        expect(result.provider).toBe('google'); // lowest cost
+    });
+    it('falls back to configured defaultProvider when load balancing is disabled', () => {
+        const config = makeConfig({ loadBalancing: { enabled: false, strategy: 'round-robin' } });
+        const result = selectProvider({ messages: [] }, available, config, 0, getStatus, getMetrics);
+        expect(result.provider).toBe('anthropic'); // default
+    });
+    it('falls back to first-available when defaultProvider is not in available list', () => {
+        const config = makeConfig({
+            defaultProvider: 'cohere',
+            loadBalancing: { enabled: false, strategy: 'round-robin' },
+        });
+        const result = selectProvider({ messages: [] }, ['openai', 'google'], config, 0, getStatus, getMetrics);
+        expect(result.provider).toBe('openai'); // first available
+    });
+});
+// ============================================================================
+// getFallbackProvider
+// ============================================================================
+describe('getFallbackProvider', () => {
+    const available = ['anthropic', 'openai', 'google'];
+    it('returns null when no rule matches the error condition', () => {
+        const rules = [
+            {
+                condition: 'rate_limit',
+                fallbackProviders: ['openai'],
+                retryOriginal: false,
+            },
+        ];
+        // A generic error produces 'error' condition, no rule for that
+        const result = getFallbackProvider('anthropic', new Error('generic fail'), rules, available);
+        expect(result).toBeNull();
+    });
+    it('returns the first fallback provider that is not the current provider', () => {
+        const rules = [
+            {
+                condition: 'error',
+                fallbackProviders: ['anthropic', 'openai', 'google'],
+                retryOriginal: false,
+            },
+        ];
+        // current=anthropic is excluded; openai is next available
+        const result = getFallbackProvider('anthropic', new Error('provider error'), rules, available);
+        expect(result).toBe('openai');
+    });
+    it('returns null when all fallback providers are either current or unavailable', () => {
+        const rules = [
+            {
+                condition: 'error',
+                fallbackProviders: ['anthropic'], // only option is the current one
+                retryOriginal: false,
+            },
+        ];
+        const result = getFallbackProvider('anthropic', new Error('provider error'), rules, available);
+        expect(result).toBeNull();
+    });
+    it('uses rate_limit condition when error message contains "rate limit"', () => {
+        const rules = [
+            {
+                condition: 'rate_limit',
+                fallbackProviders: ['google'],
+                retryOriginal: true,
+            },
+        ];
+        const result = getFallbackProvider('anthropic', new Error('rate limit exceeded'), rules, available);
+        expect(result).toBe('google');
+    });
+});
+//# sourceMappingURL=MultiLLMProvider.selection.test.js.map

package/dist/tests/testing/MultiLLMProvider.selection.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiLLMProvider.selection.test.js","sourceRoot":"","sources":["../../../tests/testing/MultiLLMProvider.selection.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,YAAY,GACb,MAAM,iDAAiD,CAAA;AASxD,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,SAAS,UAAU,CAAC,YAA6C,EAAE;IACjE,OAAO;QACL,eAAe,EAAE,WAAW;QAC5B,SAAS,EAAE;YACT,SAAS,EAAE;gBACT,QAAQ,EAAE,WAAW;gBACrB,KAAK,EAAE,eAAe;gBACtB,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,SAAS;gBACnB,iBAAiB,EAAE,KAAK;gBACxB,kBAAkB,EAAE,KAAK;aAC1B;YACD,MAAM,EAAE;gBACN,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,OAAO;gBACjB,iBAAiB,EAAE,IAAI;gBACvB,kBAAkB,EAAE,IAAI;aACzB;YACD,MAAM,EAAE;gBACN,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,YAAY;gBACnB,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,MAAM;gBAChB,iBAAiB,EAAE,OAAO;gBAC1B,kBAAkB,EAAE,MAAM;aAC3B;SACF;QACD,aAAa,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE;QAC1D,gBAAgB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;QACpC,cAAc,EAAE;YACd,SAAS,EAAE,KAAK;YAChB,wBAAwB,EAAE,EAAE;YAC5B,cAAc,EAAE,KAAK;YACrB,eAAe,EAAE,EAAE;SACpB;QACD,aAAa,EAAE,KAAK;QACpB,gBAAgB,EAAE,KAAK;QACvB,gBAAgB,EAAE;YAChB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,CAAC;YACd,KAAK,EAAE,EAAE;SACV;QACD,GAAG,SAAS;KACb,CAAA;AACH,CAAC;AAED,SAAS,UAAU,CAAC,WAAW,GAAG,CAAC;IACjC,OAAO;QACL,SAAS,EAAE,IAAI;QACf,WAAW;QACX,WAAW,EAAE,CAAC;QACd,cAAc,EAAE,CAAC;QACjB,YAAY,EAAE,QAAQ;KACvB,CAAA;AACH,CAAC;AAED,SAAS,WAAW,CAAC,YAAY,GAAG,GAAG;IACrC,OAAO;QACL,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,YAAY;QACZ,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;QACd,IAAI,EAAE,CAAC;QACP,SAAS,EAAE,CAAC;QACZ,aAAa,EAAE,EAAE;QACjB,YAAY,EAAE,CAAC;KAChB,CAAA;AACH,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,SAAS,GAAsB,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;QACtE,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,SAAS,GAAsB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QAC5D,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA,CAAC,YAAY;IACxD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,SAAS,GAAsB,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;QACtE,MAAM,KAAK,GAA2B,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;QAClF,MAAM,SAAS,GAAG,CAAC,CAAkB,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC9D,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAChE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,SAAS,GAAsB,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;QACtE,MAAM,SAAS,GAA2B,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;QACtF,MAAM,UAAU,GAAG,CAAC,CAAkB,EAAmB,EAAE,CACzD,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAA;QACvC,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,SAAS,GAAsB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QAC5D,MAAM,UAAU,GAAG,CAAC,CAAkB,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QACzF,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,SAAS,GAAsB,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;QACtE,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,mDAAmD;QACnD,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,MAAM,SAAS,GAAsB,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACtE,MAAM,SAAS,GAAG,CAAC,CAAkB,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAChF,MAAM,UAAU,GAAG,CAAC,CAAkB,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAEjF,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAC1F,wBAAwB,CACzB,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iGAAiG,EAAE,GAAG,EAAE;QACzG,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;QAClE,MAAM,MAAM,GAAG,cAAc,CAC3B,EAAE,QAAQ,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EACnD,SAAS,EACT,MAAM,EACN,CAAC,EACD,SAAS,EACT,UAAU,CACX,CAAA;QACD,+CAA+C;QAC/C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACtC,wCAAwC;QACxC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,MAAM,GAAG,UAAU,CAAC;YACxB,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE;SAC3D,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;QAC5F,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA,CAAC,oBAAoB;IAC7D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,MAAM,MAAM,GAAG,UAAU,CAAC;YACxB,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE;SAC5D,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;QAC5F,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA,CAAC,wBAAwB;IACjE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,MAAM,GAAG,UAAU,CAAC;YACxB,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE;SACzD,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;QAC5F,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA,CAAC,cAAc;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;QACzF,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;QAC5F,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA,CAAC,UAAU;IACtD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,MAAM,GAAG,UAAU,CAAC;YACxB,eAAe,EAAE,QAAQ;YACzB,aAAa,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE;SAC3D,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,cAAc,CAC3B,EAAE,QAAQ,EAAE,EAAE,EAAE,EAChB,CAAC,QAAQ,EAAE,QAAQ,CAAsB,EACzC,MAAM,EACN,CAAC,EACD,SAAS,EACT,UAAU,CACX,CAAA;QACD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA,CAAC,kBAAkB;IAC3D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,MAAM,SAAS,GAAsB,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAEtE,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,KAAK,GAAmB;YAC5B;gBACE,SAAS,EAAE,YAAY;gBACvB,iBAAiB,EAAE,CAAC,QAAQ,CAAC;gBAC7B,aAAa,EAAE,KAAK;aACrB;SACF,CAAA;QACD,+DAA+D;QAC/D,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;QAC5F,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,KAAK,GAAmB;YAC5B;gBACE,SAAS,EAAE,OAAO;gBAClB,iBAAiB,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC;gBACpD,aAAa,EAAE,KAAK;aACrB;SACF,CAAA;QACD,0DAA0D;QAC1D,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;QAC9F,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACpF,MAAM,KAAK,GAAmB;YAC5B;gBACE,SAAS,EAAE,OAAO;gBAClB,iBAAiB,EAAE,CAAC,WAAW,CAAC,EAAE,iCAAiC;gBACnE,aAAa,EAAE,KAAK;aACrB;SACF,CAAA;QACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;QAC9F,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,KAAK,GAAmB;YAC5B;gBACE,SAAS,EAAE,YAAY;gBACvB,iBAAiB,EAAE,CAAC,QAAQ,CAAC;gBAC7B,aAAa,EAAE,IAAI;aACpB;SACF,CAAA;QACD,MAAM,MAAM,GAAG,mBAAmB,CAChC,WAAW,EACX,IAAI,KAAK,CAAC,qBAAqB,CAAC,EAChC,KAAK,EACL,SAAS,CACV,CAAA;QACD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/tests/unit/quarantine-query-builder.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SMI-2755 Wave 2: Quarantine query builder pure-function tests
+ *
+ * Tests for buildFilteredQuery and rowToEntry from
+ * packages/core/src/repositories/quarantine/query-builder.ts.
+ *
+ * No mocking needed — both are pure functions.
+ */
+export {};
+//# sourceMappingURL=quarantine-query-builder.test.d.ts.map

package/dist/tests/unit/quarantine-query-builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quarantine-query-builder.test.d.ts","sourceRoot":"","sources":["../../../tests/unit/quarantine-query-builder.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/tests/unit/quarantine-query-builder.test.js

@@ -0,0 +1,157 @@
+/**
+ * SMI-2755 Wave 2: Quarantine query builder pure-function tests
+ *
+ * Tests for buildFilteredQuery and rowToEntry from
+ * packages/core/src/repositories/quarantine/query-builder.ts.
+ *
+ * No mocking needed — both are pure functions.
+ */
+import { describe, it, expect } from 'vitest';
+import { buildFilteredQuery, rowToEntry } from '../../src/repositories/quarantine/query-builder.js';
+// ============================================================================
+// buildFilteredQuery — filter branch coverage
+// ============================================================================
+describe('buildFilteredQuery', () => {
+    it('returns base WHERE 1=1 query when no filters are provided', () => {
+        const result = buildFilteredQuery({});
+        expect(result.query).toContain('WHERE 1=1');
+        expect(result.countQuery).toContain('WHERE 1=1');
+        // No additional WHERE clauses beyond the base
+        expect(result.query).not.toContain('AND skill_id');
+        expect(result.query).not.toContain('AND source');
+        expect(result.query).not.toContain('AND severity');
+        expect(result.params).toHaveLength(2); // limit + offset are appended
+    });
+    it('appends reviewedBy filter correctly', () => {
+        const result = buildFilteredQuery({ reviewedBy: 'alice' });
+        expect(result.query).toContain('AND reviewed_by = ?');
+        expect(result.countQuery).toContain('AND reviewed_by = ?');
+        expect(result.params).toContain('alice');
+        expect(result.countParams).toContain('alice');
+    });
+    it('appends since date filter correctly', () => {
+        const since = new Date('2025-01-01T00:00:00Z');
+        const result = buildFilteredQuery({ since });
+        expect(result.query).toContain('AND quarantine_date >= ?');
+        expect(result.countQuery).toContain('AND quarantine_date >= ?');
+        expect(result.params).toContain(since.toISOString());
+        expect(result.countParams).toContain(since.toISOString());
+    });
+    it('appends until date filter correctly', () => {
+        const until = new Date('2025-12-31T23:59:59Z');
+        const result = buildFilteredQuery({ until });
+        expect(result.query).toContain('AND quarantine_date <= ?');
+        expect(result.countQuery).toContain('AND quarantine_date <= ?');
+        expect(result.params).toContain(until.toISOString());
+        expect(result.countParams).toContain(until.toISOString());
+    });
+    it('applies combined since + until range', () => {
+        const since = new Date('2025-01-01T00:00:00Z');
+        const until = new Date('2025-06-30T23:59:59Z');
+        const result = buildFilteredQuery({ since, until });
+        expect(result.query).toContain('AND quarantine_date >= ?');
+        expect(result.query).toContain('AND quarantine_date <= ?');
+        expect(result.params).toContain(since.toISOString());
+        expect(result.params).toContain(until.toISOString());
+    });
+    it('applies all filters simultaneously and builds correct param array', () => {
+        const since = new Date('2025-01-01T00:00:00Z');
+        const until = new Date('2025-12-31T00:00:00Z');
+        const result = buildFilteredQuery({
+            skillId: 'skill-abc',
+            source: 'github',
+            severity: 'MALICIOUS',
+            reviewStatus: 'pending',
+            reviewedBy: 'bob',
+            since,
+            until,
+            limit: 50,
+            offset: 10,
+        });
+        expect(result.query).toContain('AND skill_id = ?');
+        expect(result.query).toContain('AND source = ?');
+        expect(result.query).toContain('AND severity = ?');
+        expect(result.query).toContain('AND review_status = ?');
+        expect(result.query).toContain('AND reviewed_by = ?');
+        expect(result.query).toContain('AND quarantine_date >= ?');
+        expect(result.query).toContain('AND quarantine_date <= ?');
+        expect(result.query).toContain('LIMIT ? OFFSET ?');
+        // Verify param ordering: skill_id, source, severity, review_status, reviewed_by, since, until, limit, offset
+        expect(result.params).toEqual([
+            'skill-abc',
+            'github',
+            'MALICIOUS',
+            'pending',
+            'bob',
+            since.toISOString(),
+            until.toISOString(),
+            50,
+            10,
+        ]);
+    });
+    it('uses default limit=20 and offset=0 when not specified', () => {
+        const result = buildFilteredQuery({});
+        // Last two params should be limit and offset defaults
+        const lastTwo = result.params.slice(-2);
+        expect(lastTwo).toEqual([20, 0]);
+    });
+});
+// ============================================================================
+// rowToEntry — column mapping
+// ============================================================================
+describe('rowToEntry', () => {
+    it('maps all database row columns to the correct output properties', () => {
+        const row = {
+            id: 'entry-001',
+            skill_id: 'community/bad-skill',
+            source: 'github',
+            quarantine_reason: 'Detected malicious pattern',
+            severity: 'MALICIOUS',
+            detected_patterns: '["eval(", "require(fs)"]',
+            quarantine_date: '2025-06-15T10:00:00.000Z',
+            reviewed_by: 'security-team',
+            review_status: 'approved',
+            review_notes: 'Confirmed malicious',
+            review_date: '2025-06-16T09:00:00.000Z',
+            created_at: '2025-06-15T10:00:00.000Z',
+            updated_at: '2025-06-16T09:00:00.000Z',
+        };
+        const entry = rowToEntry(row);
+        expect(entry.id).toBe('entry-001');
+        expect(entry.skillId).toBe('community/bad-skill');
+        expect(entry.source).toBe('github');
+        expect(entry.quarantineReason).toBe('Detected malicious pattern');
+        expect(entry.severity).toBe('MALICIOUS');
+        expect(entry.detectedPatterns).toEqual(['eval(', 'require(fs)']);
+        expect(entry.quarantineDate).toBe('2025-06-15T10:00:00.000Z');
+        expect(entry.reviewedBy).toBe('security-team');
+        expect(entry.reviewStatus).toBe('approved');
+        expect(entry.reviewNotes).toBe('Confirmed malicious');
+        expect(entry.reviewDate).toBe('2025-06-16T09:00:00.000Z');
+        expect(entry.createdAt).toBe('2025-06-15T10:00:00.000Z');
+        expect(entry.updatedAt).toBe('2025-06-16T09:00:00.000Z');
+    });
+    it('handles null optional fields correctly', () => {
+        const row = {
+            id: 'entry-002',
+            skill_id: 'community/suspicious-skill',
+            source: 'registry',
+            quarantine_reason: 'High risk score',
+            severity: 'SUSPICIOUS',
+            detected_patterns: '[]',
+            quarantine_date: '2025-07-01T00:00:00.000Z',
+            reviewed_by: null,
+            review_status: 'pending',
+            review_notes: null,
+            review_date: null,
+            created_at: '2025-07-01T00:00:00.000Z',
+            updated_at: '2025-07-01T00:00:00.000Z',
+        };
+        const entry = rowToEntry(row);
+        expect(entry.reviewedBy).toBeNull();
+        expect(entry.reviewNotes).toBeNull();
+        expect(entry.reviewDate).toBeNull();
+        expect(entry.detectedPatterns).toEqual([]);
+    });
+});
+//# sourceMappingURL=quarantine-query-builder.test.js.map

package/dist/tests/unit/quarantine-query-builder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quarantine-query-builder.test.js","sourceRoot":"","sources":["../../../tests/unit/quarantine-query-builder.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillsmith/core",
-  "version": "0.4.14",
+  "version": "0.4.15",
   "description": "Core types and utilities for Skillsmith",
   "type": "module",
   "main": "./dist/src/index.js",