@skillsmith/core 0.7.2 → 0.8.0

package/dist/src/telemetry/wrap.test.js

@@ -0,0 +1,283 @@
+/**
+ * SMI-5016: Unit tests for withTelemetry HOF + isTelemetered registry.
+ *
+ * Covers the shared-state matrix invariants from plan line 720:
+ *   - function-decl wrap
+ *   - arrow-const export wrap (H3 critical case)
+ *   - double-register idempotency (Set dedupes by reference)
+ *   - isTelemetered true/false
+ *   - emit-on-throw (success:false, then re-throw)
+ *   - telemetry emit failure does NOT affect wrapped fn
+ *   - per-request framework (H4 — not memoised)
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { withTelemetry, isTelemetered, setEmissionGate } from './wrap.js';
+// ---------------------------------------------------------------------------
+// Mock trackSkillInvoke so tests run without a live PostHog instance
+// ---------------------------------------------------------------------------
+vi.mock('./posthog.js', () => ({
+    trackSkillInvoke: vi.fn(),
+}));
+import { trackSkillInvoke } from './posthog.js';
+const mockTrack = vi.mocked(trackSkillInvoke);
+beforeEach(() => {
+    mockTrack.mockReset();
+    // SMI-5019 wire-in: default is now suppress-when-no-gate. Install a permissive
+    // gate so the legacy SMI-5016 tests below (which predate the consent gate)
+    // continue to assert against emit behaviour. The new emission-gate describe
+    // block at the bottom overrides this per-case.
+    setEmissionGate(() => true);
+});
+afterEach(() => {
+    // Reset to default-suppress so a leaked gate from one test does not flow
+    // into the next file's tests or pollute the per-process module state.
+    setEmissionGate(undefined);
+});
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const BASE_OPTS = {
+    source: 'mcp-tool',
+    extractSkillId: () => 'test/skill',
+};
+// ---------------------------------------------------------------------------
+// 1. Function-declaration wrap
+// ---------------------------------------------------------------------------
+describe('function-declaration wrap', () => {
+    it('wraps a named function declaration and registers it', async () => {
+        function myHandler(x) {
+            return x * 2;
+        }
+        const wrapped = withTelemetry(myHandler, BASE_OPTS);
+        expect(isTelemetered(wrapped)).toBe(true);
+        expect(isTelemetered(myHandler)).toBe(false);
+        const result = await wrapped(3);
+        expect(result).toBe(6);
+        expect(mockTrack).toHaveBeenCalledOnce();
+        expect(mockTrack).toHaveBeenCalledWith(expect.objectContaining({ skillId: 'test/skill', success: true }));
+    });
+});
+// ---------------------------------------------------------------------------
+// 2. Arrow-const export wrap (H3 critical case)
+// ---------------------------------------------------------------------------
+describe('arrow-const export wrap', () => {
+    it('wraps an arrow-const and registers the returned function (not the original)', async () => {
+        // This is the exact pattern that plan review change H3 was about:
+        // arrow-const exports cannot be mutated, so the registry MUST track the
+        // returned wrappedFn, not mutate the original.
+        const originalFn = (v) => v.toUpperCase();
+        const wrappedExport = withTelemetry(originalFn, BASE_OPTS);
+        // The returned function is telemetered; the original is not.
+        expect(isTelemetered(wrappedExport)).toBe(true);
+        expect(isTelemetered(originalFn)).toBe(false);
+        const result = await wrappedExport('hello');
+        expect(result).toBe('HELLO');
+        expect(mockTrack).toHaveBeenCalledOnce();
+    });
+});
+// ---------------------------------------------------------------------------
+// 3. Double-register idempotency
+// ---------------------------------------------------------------------------
+describe('double-register', () => {
+    it('re-wrapping the same RETURNED function adds no new entries (Set dedupes by ref)', () => {
+        const original = () => 'value';
+        const w1 = withTelemetry(original, BASE_OPTS);
+        // Capture Set size after first wrap
+        expect(isTelemetered(w1)).toBe(true);
+        // Now attempt to re-wrap the *returned* function.
+        // The Set already contains w1, so adding it again is a no-op by Set semantics.
+        const w2 = withTelemetry(w1, BASE_OPTS);
+        // w2 is a NEW wrapper around w1 — both are in the Set, but w1 wasn't
+        // added a second time.  isTelemetered(w1) is still true, and w2 is also true.
+        expect(isTelemetered(w1)).toBe(true);
+        expect(isTelemetered(w2)).toBe(true);
+    });
+    it('wrapping the same original fn twice produces two distinct wrapped fns, both registered', () => {
+        const original = () => 'x';
+        const wa = withTelemetry(original, BASE_OPTS);
+        const wb = withTelemetry(original, BASE_OPTS);
+        // Different wrapper references
+        expect(wa).not.toBe(wb);
+        expect(isTelemetered(wa)).toBe(true);
+        expect(isTelemetered(wb)).toBe(true);
+        // Original still not in registry
+        expect(isTelemetered(original)).toBe(false);
+    });
+});
+// ---------------------------------------------------------------------------
+// 4. isTelemetered true/false
+// ---------------------------------------------------------------------------
+describe('isTelemetered', () => {
+    it('returns false for an arbitrary unwrapped function', () => {
+        const plain = () => { };
+        expect(isTelemetered(plain)).toBe(false);
+    });
+    it('returns true only for the wrapped return value', () => {
+        const original = () => 42;
+        const result = withTelemetry(original, BASE_OPTS);
+        expect(isTelemetered(result)).toBe(true);
+        expect(isTelemetered(original)).toBe(false);
+    });
+});
+// ---------------------------------------------------------------------------
+// 5. Emit happens even on thrown errors
+// ---------------------------------------------------------------------------
+describe('emit-on-throw', () => {
+    it('emits with success:false and re-throws when handler throws', async () => {
+        const boom = () => {
+            throw new Error('handler exploded');
+        };
+        const wrappedBoom = withTelemetry(boom, BASE_OPTS);
+        await expect(wrappedBoom()).rejects.toThrow('handler exploded');
+        expect(mockTrack).toHaveBeenCalledOnce();
+        expect(mockTrack).toHaveBeenCalledWith(expect.objectContaining({ success: false, skillId: 'test/skill' }));
+    });
+});
+// ---------------------------------------------------------------------------
+// 6. Telemetry emission failure does NOT affect wrapped fn
+// ---------------------------------------------------------------------------
+describe('emit-failure survival', () => {
+    it('returns the handler result even when trackSkillInvoke throws', async () => {
+        mockTrack.mockImplementation(() => {
+            throw new Error('PostHog is down');
+        });
+        const stable = () => 'still works';
+        const wrappedStable = withTelemetry(stable, BASE_OPTS);
+        const result = await wrappedStable();
+        expect(result).toBe('still works');
+        // trackSkillInvoke was called (and threw), but the wrapper swallowed it.
+        expect(mockTrack).toHaveBeenCalledOnce();
+    });
+});
+// ---------------------------------------------------------------------------
+// 7. Per-request framework value (H4 — not memoised)
+// ---------------------------------------------------------------------------
+describe('per-request framework', () => {
+    it('reflects opts.extractFramework return value at each call independently', async () => {
+        let frameValue = 'cursor';
+        const handler = () => 'ok';
+        const wrappedWithFramework = withTelemetry(handler, {
+            ...BASE_OPTS,
+            extractFramework: () => frameValue,
+        });
+        await wrappedWithFramework();
+        expect(mockTrack).toHaveBeenLastCalledWith(expect.objectContaining({ framework: 'cursor' }));
+        // Mutate the frame value — simulates a different client on the same server
+        frameValue = 'copilot';
+        mockTrack.mockReset();
+        await wrappedWithFramework();
+        expect(mockTrack).toHaveBeenLastCalledWith(expect.objectContaining({ framework: 'copilot' }));
+    });
+    it('defaults framework to "unknown" when extractFramework is not provided', async () => {
+        const handler = () => 'ok';
+        const wrappedNoFrame = withTelemetry(handler, BASE_OPTS // no extractFramework
+        );
+        await wrappedNoFrame();
+        expect(mockTrack).toHaveBeenCalledWith(expect.objectContaining({ framework: 'unknown' }));
+    });
+});
+// ---------------------------------------------------------------------------
+// 8. Overhead gate (Risk #7 — p99 < 1ms per wrapped call)
+// ---------------------------------------------------------------------------
+describe('overhead gate (risk #7)', () => {
+    it('p99 per-call overhead is < 1ms over 10 000 iterations', async () => {
+        const ITERATIONS = 10_000;
+        const noopHandler = async () => 42;
+        const wrappedNoop = withTelemetry(noopHandler, {
+            source: 'mcp-tool',
+            extractSkillId: () => 'bench/skill',
+        });
+        // JIT warm-up — stabilise before measuring
+        for (let i = 0; i < 100; i++) {
+            await wrappedNoop();
+        }
+        mockTrack.mockReset();
+        const elapsed = [];
+        for (let i = 0; i < ITERATIONS; i++) {
+            const t0 = performance.now();
+            await wrappedNoop();
+            elapsed.push(performance.now() - t0);
+        }
+        elapsed.sort((a, b) => a - b);
+        const p99 = elapsed[Math.ceil(ITERATIONS * 0.99) - 1];
+        const mean = elapsed.reduce((s, v) => s + v, 0) / ITERATIONS;
+        // Risk #7 gate: p99 must be below 1ms
+        expect(p99).toBeLessThan(1);
+        // Sanity gate: mean overhead should be well below 0.5ms
+        expect(mean).toBeLessThan(0.5);
+        expect(mockTrack).toHaveBeenCalledTimes(ITERATIONS);
+    });
+});
+// ---------------------------------------------------------------------------
+// 9. Emission gate (SMI-5019 wire-in)
+// ---------------------------------------------------------------------------
+//
+// These tests verify the privacy-safe default-suppress contract:
+//
+//   - No gate installed → withTelemetry must NOT call trackSkillInvoke
+//   - Gate returns true → emit
+//   - Gate returns false → suppress
+//   - Gate is evaluated per-call (not memoised), so a toggling predicate
+//     produces different outcomes on consecutive calls
+//
+// The outer `beforeEach` installs a permissive gate for the legacy tests;
+// these cases override that gate explicitly per-case.
+describe('emission gate (SMI-5019 wire-in)', () => {
+    beforeEach(() => {
+        // Override the outer permissive gate — start each case with no gate
+        // installed, so the default-suppress behaviour is the natural baseline.
+        setEmissionGate(undefined);
+    });
+    it('default-suppress: no gate installed → no emit', async () => {
+        const handler = () => 'ok';
+        const wrappedFn = withTelemetry(handler, BASE_OPTS);
+        const result = await wrappedFn();
+        expect(result).toBe('ok');
+        expect(mockTrack).not.toHaveBeenCalled();
+    });
+    it('gate returns true → emit', async () => {
+        setEmissionGate(() => true);
+        const handler = () => 'ok';
+        const wrappedFn = withTelemetry(handler, BASE_OPTS);
+        await wrappedFn();
+        expect(mockTrack).toHaveBeenCalledOnce();
+        expect(mockTrack).toHaveBeenCalledWith(expect.objectContaining({ skillId: 'test/skill', success: true }));
+    });
+    it('gate returns false → no emit', async () => {
+        setEmissionGate(() => false);
+        const handler = () => 'ok';
+        const wrappedFn = withTelemetry(handler, BASE_OPTS);
+        await wrappedFn();
+        expect(mockTrack).not.toHaveBeenCalled();
+    });
+    it('gate is evaluated per-call (toggling predicate produces emit then no-emit)', async () => {
+        // Toggle true → false across the two invocations. Verifies the gate is
+        // NOT memoised at install time — each call queries it fresh, matching
+        // the per-call extractFramework contract (H4).
+        let nextReturn = true;
+        setEmissionGate(() => {
+            const value = nextReturn;
+            nextReturn = !nextReturn;
+            return value;
+        });
+        const handler = () => 'ok';
+        const wrappedFn = withTelemetry(handler, BASE_OPTS);
+        await wrappedFn();
+        expect(mockTrack).toHaveBeenCalledOnce();
+        mockTrack.mockReset();
+        await wrappedFn();
+        expect(mockTrack).not.toHaveBeenCalled();
+    });
+    it('gate is also consulted on throw — no emit when suppressed even if handler fails', async () => {
+        // Reinforces the privacy-safe invariant: a throwing handler must not
+        // smuggle telemetry past a suppressing gate via the finally block.
+        setEmissionGate(() => false);
+        const boom = () => {
+            throw new Error('handler exploded');
+        };
+        const wrappedBoom = withTelemetry(boom, BASE_OPTS);
+        await expect(wrappedBoom()).rejects.toThrow('handler exploded');
+        expect(mockTrack).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=wrap.test.js.map

package/dist/src/telemetry/wrap.test.js.map

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

package/dist/tests/embeddings/probe.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SMI-5039: Unit tests for the canonical `probeEmbeddingCapability` helper in
+ * `@skillsmith/core/embeddings/probe`. Mirrors the shape of the legacy
+ * `packages/mcp-server/tests/startup-probe.test.ts` unit tier (SMI-5009) but
+ * exercises the real exported function — not an inline copy — so the four
+ * consumers (mcp-server, doc-retrieval-mcp server/cli, cli) all share the
+ * same audited behavior.
+ *
+ * The mcp-server integration tier (spawn-based) is preserved separately to
+ * pin the MCP stdio invariant — see SMI-5009 for the rationale.
+ */
+export {};
+//# sourceMappingURL=probe.test.d.ts.map

package/dist/tests/embeddings/probe.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.test.d.ts","sourceRoot":"","sources":["../../../tests/embeddings/probe.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/tests/embeddings/probe.test.js

@@ -0,0 +1,154 @@
+/**
+ * SMI-5039: Unit tests for the canonical `probeEmbeddingCapability` helper in
+ * `@skillsmith/core/embeddings/probe`. Mirrors the shape of the legacy
+ * `packages/mcp-server/tests/startup-probe.test.ts` unit tier (SMI-5009) but
+ * exercises the real exported function — not an inline copy — so the four
+ * consumers (mcp-server, doc-retrieval-mcp server/cli, cli) all share the
+ * same audited behavior.
+ *
+ * The mcp-server integration tier (spawn-based) is preserved separately to
+ * pin the MCP stdio invariant — see SMI-5009 for the rationale.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { EmbeddingService } from '../../src/embeddings/index.js';
+import { probeEmbeddingCapability } from '../../src/embeddings/probe.js';
+describe('SMI-5039 probeEmbeddingCapability — success path', () => {
+    let checkSpy;
+    beforeEach(() => {
+        checkSpy = vi.spyOn(EmbeddingService, 'checkAvailability');
+        // Spy on getTransformersLoadError to prevent any accidental real-module
+        // access during the test even though the success path never reads it.
+        vi.spyOn(EmbeddingService, 'getTransformersLoadError');
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        delete process.env['SKILLSMITH_QUIET'];
+    });
+    it('is silent when real embeddings are available', async () => {
+        checkSpy.mockResolvedValue(true);
+        const logs = [];
+        await probeEmbeddingCapability({ logger: (m) => logs.push(m) });
+        expect(logs).toEqual([]);
+    });
+});
+describe('SMI-5039 probeEmbeddingCapability — mock fallback path', () => {
+    let checkSpy;
+    let getErrSpy;
+    beforeEach(() => {
+        checkSpy = vi.spyOn(EmbeddingService, 'checkAvailability');
+        getErrSpy = vi.spyOn(EmbeddingService, 'getTransformersLoadError');
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        delete process.env['SKILLSMITH_QUIET'];
+    });
+    it('logs structured mock-fallback warning with reason when checkAvailability returns false', async () => {
+        checkSpy.mockResolvedValue(false);
+        getErrSpy.mockReturnValue(new Error('ENOENT: cannot find module @huggingface/transformers'));
+        const logs = [];
+        await probeEmbeddingCapability({ logger: (m) => logs.push(m) });
+        expect(logs).toHaveLength(1);
+        expect(logs[0]).toMatch(/\[skillsmith\] embeddings: mock \(transformers unavailable: ENOENT: cannot find module @huggingface\/transformers/);
+        // Remediation hint MUST be present.
+        expect(logs[0]).toContain('install @huggingface/transformers');
+        expect(logs[0]).toContain('SKILLSMITH_USE_MOCK_EMBEDDINGS=true');
+    });
+    it('falls back to "module-load-failed" when no load error is recorded', async () => {
+        checkSpy.mockResolvedValue(false);
+        getErrSpy.mockReturnValue(null);
+        const logs = [];
+        await probeEmbeddingCapability({ logger: (m) => logs.push(m) });
+        expect(logs).toHaveLength(1);
+        expect(logs[0]).toContain('transformers unavailable: module-load-failed');
+    });
+});
+describe('SMI-5039 probeEmbeddingCapability — timeout path', () => {
+    let checkSpy;
+    let getErrSpy;
+    beforeEach(() => {
+        checkSpy = vi.spyOn(EmbeddingService, 'checkAvailability');
+        getErrSpy = vi.spyOn(EmbeddingService, 'getTransformersLoadError');
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        delete process.env['SKILLSMITH_QUIET'];
+    });
+    it('emits probe-timeout line and returns within the bound when checkAvailability hangs', async () => {
+        // Hangs forever — only the timeout sentinel should resolve.
+        checkSpy.mockImplementation(() => new Promise(() => undefined));
+        getErrSpy.mockReturnValue(null);
+        const logs = [];
+        const start = Date.now();
+        await probeEmbeddingCapability({ logger: (m) => logs.push(m), timeoutMs: 100 });
+        const elapsed = Date.now() - start;
+        expect(logs).toHaveLength(1);
+        expect(logs[0]).toMatch(/embeddings: mock \(transformers unavailable: probe-timeout/);
+        // Must complete within a small multiple of the timeout — proves the
+        // hard-bound holds even when checkAvailability never resolves.
+        expect(elapsed).toBeLessThan(2000);
+    });
+});
+describe('SMI-5039 probeEmbeddingCapability — error path', () => {
+    let checkSpy;
+    let getErrSpy;
+    beforeEach(() => {
+        checkSpy = vi.spyOn(EmbeddingService, 'checkAvailability');
+        getErrSpy = vi.spyOn(EmbeddingService, 'getTransformersLoadError');
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        delete process.env['SKILLSMITH_QUIET'];
+    });
+    it('catches a thrown error and logs probe-failed without rethrowing', async () => {
+        checkSpy.mockRejectedValue(new Error('boom'));
+        getErrSpy.mockReturnValue(null);
+        const logs = [];
+        await expect(probeEmbeddingCapability({ logger: (m) => logs.push(m) })).resolves.toBeUndefined();
+        expect(logs).toHaveLength(1);
+        expect(logs[0]).toMatch(/embeddings: probe-failed \(boom/);
+        expect(logs[0]).toContain('install @huggingface/transformers');
+    });
+});
+describe('SMI-5039 probeEmbeddingCapability — quiet mode', () => {
+    let checkSpy;
+    let getErrSpy;
+    beforeEach(() => {
+        checkSpy = vi.spyOn(EmbeddingService, 'checkAvailability');
+        getErrSpy = vi.spyOn(EmbeddingService, 'getTransformersLoadError');
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        delete process.env['SKILLSMITH_QUIET'];
+    });
+    it('suppresses the warning when opts.quiet=true', async () => {
+        checkSpy.mockResolvedValue(false);
+        getErrSpy.mockReturnValue(new Error('boom'));
+        const logs = [];
+        await probeEmbeddingCapability({ logger: (m) => logs.push(m), quiet: true });
+        expect(logs).toEqual([]);
+    });
+    it('suppresses the warning when SKILLSMITH_QUIET=true', async () => {
+        checkSpy.mockResolvedValue(false);
+        getErrSpy.mockReturnValue(new Error('boom'));
+        process.env['SKILLSMITH_QUIET'] = 'true';
+        const logs = [];
+        await probeEmbeddingCapability({ logger: (m) => logs.push(m) });
+        expect(logs).toEqual([]);
+    });
+    it('honors SKILLSMITH_QUIET=1 (numeric truthy)', async () => {
+        checkSpy.mockResolvedValue(false);
+        getErrSpy.mockReturnValue(new Error('boom'));
+        process.env['SKILLSMITH_QUIET'] = '1';
+        const logs = [];
+        await probeEmbeddingCapability({ logger: (m) => logs.push(m) });
+        expect(logs).toEqual([]);
+    });
+    it('does NOT suppress when SKILLSMITH_QUIET is unset and quiet=false', async () => {
+        checkSpy.mockResolvedValue(false);
+        getErrSpy.mockReturnValue(new Error('boom'));
+        const logs = [];
+        await probeEmbeddingCapability({ logger: (m) => logs.push(m), quiet: false });
+        expect(logs).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=probe.test.js.map

package/dist/tests/embeddings/probe.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillsmith/core",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "description": "Core types and utilities for Skillsmith",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -21,6 +21,11 @@
       "import": "./dist/src/embeddings/index.js",
       "default": "./dist/src/embeddings/index.js"
     },
+    "./embeddings/probe": {
+      "types": "./dist/src/embeddings/probe.d.ts",
+      "import": "./dist/src/embeddings/probe.js",
+      "default": "./dist/src/embeddings/probe.js"
+    },
     "./testing": {
       "types": "./dist/src/testing/index.d.ts",
       "import": "./dist/src/testing/index.js",
@@ -60,6 +65,11 @@
       "types": "./dist/src/skills/index-local.d.ts",
       "import": "./dist/src/skills/index-local.js",
       "default": "./dist/src/skills/index-local.js"
+    },
+    "./telemetry": {
+      "types": "./dist/src/telemetry/index.d.ts",
+      "import": "./dist/src/telemetry/index.js",
+      "default": "./dist/src/telemetry/index.js"
     }
   },
   "scripts": {