@timmeck/brain-core 1.1.0 → 1.5.0

package/dist/learning/__tests__/base-engine.test.js

@@ -0,0 +1,49 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { BaseLearningEngine } from '../base-engine.js';
+class TestLearningEngine extends BaseLearningEngine {
+    cycleCount = 0;
+    runCycle() {
+        this.cycleCount++;
+        return { count: this.cycleCount };
+    }
+}
+describe('BaseLearningEngine', () => {
+    beforeEach(() => { vi.useFakeTimers(); });
+    afterEach(() => { vi.useRealTimers(); });
+    it('should run cycles at the configured interval', () => {
+        const engine = new TestLearningEngine({ intervalMs: 1000 });
+        engine.start();
+        expect(engine.cycleCount).toBe(0);
+        vi.advanceTimersByTime(1000);
+        expect(engine.cycleCount).toBe(1);
+        vi.advanceTimersByTime(2000);
+        expect(engine.cycleCount).toBe(3);
+        engine.stop();
+    });
+    it('should stop the timer', () => {
+        const engine = new TestLearningEngine({ intervalMs: 500 });
+        engine.start();
+        vi.advanceTimersByTime(500);
+        expect(engine.cycleCount).toBe(1);
+        engine.stop();
+        vi.advanceTimersByTime(2000);
+        expect(engine.cycleCount).toBe(1);
+    });
+    it('should handle errors in runCycle gracefully', () => {
+        class FailingEngine extends BaseLearningEngine {
+            runCycle() { throw new Error('boom'); }
+        }
+        const engine = new FailingEngine({ intervalMs: 100 });
+        engine.start();
+        // Should not throw
+        expect(() => vi.advanceTimersByTime(100)).not.toThrow();
+        engine.stop();
+    });
+    it('should be safe to call stop multiple times', () => {
+        const engine = new TestLearningEngine({ intervalMs: 1000 });
+        engine.start();
+        engine.stop();
+        engine.stop(); // No error
+    });
+});
+//# sourceMappingURL=base-engine.test.js.map

package/dist/learning/__tests__/base-engine.test.js.map

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

package/dist/learning/base-engine.d.ts

@@ -0,0 +1,16 @@
+export interface LearningEngineConfig {
+    intervalMs: number;
+}
+/**
+ * Abstract base class for learning engines.
+ * Handles timer lifecycle — subclasses implement runCycle().
+ */
+export declare abstract class BaseLearningEngine {
+    protected engineConfig: LearningEngineConfig;
+    protected timer: ReturnType<typeof setInterval> | null;
+    protected logger: import("winston").Logger;
+    constructor(engineConfig: LearningEngineConfig);
+    start(): void;
+    stop(): void;
+    abstract runCycle(): unknown;
+}

package/dist/learning/base-engine.js

@@ -0,0 +1,30 @@
+import { getLogger } from '../utils/logger.js';
+/**
+ * Abstract base class for learning engines.
+ * Handles timer lifecycle — subclasses implement runCycle().
+ */
+export class BaseLearningEngine {
+    engineConfig;
+    timer = null;
+    logger = getLogger();
+    constructor(engineConfig) {
+        this.engineConfig = engineConfig;
+    }
+    start() {
+        this.timer = setInterval(() => {
+            try {
+                this.runCycle();
+            }
+            catch (err) {
+                this.logger.error('Learning cycle error', { error: String(err) });
+            }
+        }, this.engineConfig.intervalMs);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+}
+//# sourceMappingURL=base-engine.js.map

package/dist/learning/base-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-engine.js","sourceRoot":"","sources":["../../src/learning/base-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAM/C;;;GAGG;AACH,MAAM,OAAgB,kBAAkB;IAIhB;IAHZ,KAAK,GAA0C,IAAI,CAAC;IACpD,MAAM,GAAG,SAAS,EAAE,CAAC;IAE/B,YAAsB,YAAkC;QAAlC,iBAAY,GAAZ,YAAY,CAAsB;IAAG,CAAC;IAE5D,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC;gBACH,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;CAGF"}

package/dist/math/__tests__/time-decay.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/math/__tests__/time-decay.test.js

@@ -0,0 +1,37 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { timeDecayFactor } from '../time-decay.js';
+describe('timeDecayFactor', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('returns ~1.0 for just-activated item', () => {
+        const now = new Date().toISOString();
+        const factor = timeDecayFactor(now, 30);
+        expect(factor).toBeGreaterThan(0.99);
+        expect(factor).toBeLessThanOrEqual(1.0);
+    });
+    it('returns ~0.5 at exactly one half-life', () => {
+        const halfLifeDays = 30;
+        const activatedAt = new Date(Date.now() - halfLifeDays * 24 * 60 * 60 * 1000).toISOString();
+        const factor = timeDecayFactor(activatedAt, halfLifeDays);
+        expect(factor).toBeCloseTo(0.5, 1);
+    });
+    it('returns ~0.25 at two half-lives', () => {
+        const halfLifeDays = 14;
+        const activatedAt = new Date(Date.now() - 28 * 24 * 60 * 60 * 1000).toISOString();
+        const factor = timeDecayFactor(activatedAt, halfLifeDays);
+        expect(factor).toBeCloseTo(0.25, 1);
+    });
+    it('returns very small value for very old items', () => {
+        const activatedAt = new Date(Date.now() - 365 * 24 * 60 * 60 * 1000).toISOString();
+        const factor = timeDecayFactor(activatedAt, 30);
+        expect(factor).toBeLessThan(0.01);
+    });
+    it('works with different half-life values', () => {
+        const activatedAt = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
+        const shortHalfLife = timeDecayFactor(activatedAt, 7);
+        const longHalfLife = timeDecayFactor(activatedAt, 45);
+        expect(shortHalfLife).toBeLessThan(longHalfLife);
+    });
+});
+//# sourceMappingURL=time-decay.test.js.map

package/dist/math/__tests__/time-decay.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-decay.test.js","sourceRoot":"","sources":["../../../src/math/__tests__/time-decay.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,YAAY,GAAG,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5F,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,YAAY,GAAG,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAClF,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QACnF,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QACjF,MAAM,aAAa,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,aAAa,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/math/__tests__/wilson-score.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/math/__tests__/wilson-score.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect } from 'vitest';
+import { wilsonScore } from '../wilson-score.js';
+describe('wilsonScore', () => {
+    it('returns 0 for zero trials', () => {
+        expect(wilsonScore(0, 0)).toBe(0);
+    });
+    it('returns low confidence for single success', () => {
+        const score = wilsonScore(1, 1);
+        expect(score).toBeGreaterThan(0);
+        expect(score).toBeLessThan(0.8);
+    });
+    it('converges toward actual rate with large samples', () => {
+        const score = wilsonScore(950, 1000);
+        expect(score).toBeGreaterThan(0.93);
+        expect(score).toBeLessThan(0.96);
+    });
+    it('penalizes small sample sizes', () => {
+        const small = wilsonScore(5, 5);
+        const large = wilsonScore(500, 500);
+        expect(large).toBeGreaterThan(small);
+    });
+    it('returns higher confidence with lower z-score', () => {
+        const z90 = wilsonScore(7, 10, 1.64);
+        const z95 = wilsonScore(7, 10, 1.96);
+        const z99 = wilsonScore(7, 10, 2.33);
+        expect(z90).toBeGreaterThan(z95);
+        expect(z95).toBeGreaterThan(z99);
+    });
+    it('handles 0 successes', () => {
+        const score = wilsonScore(0, 10);
+        expect(score).toBe(0);
+    });
+    it('handles 50/50 split', () => {
+        const score = wilsonScore(50, 100);
+        expect(score).toBeGreaterThan(0.39);
+        expect(score).toBeLessThan(0.51);
+    });
+    it('never returns negative', () => {
+        expect(wilsonScore(0, 1)).toBeGreaterThanOrEqual(0);
+        expect(wilsonScore(0, 100)).toBeGreaterThanOrEqual(0);
+    });
+});
+//# sourceMappingURL=wilson-score.test.js.map

package/dist/math/__tests__/wilson-score.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wilson-score.test.js","sourceRoot":"","sources":["../../../src/math/__tests__/wilson-score.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/math/time-decay.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Exponential time-decay factor based on half-life.
+ * Returns a multiplier between 0 and 1 — recent items are near 1.0,
+ * older items decay toward 0.
+ *
+ * @param lastActivatedAt ISO date string of last activation
+ * @param halfLifeDays Number of days for half-life
+ * @returns Decay factor (0-1)
+ */
+export declare function timeDecayFactor(lastActivatedAt: string, halfLifeDays: number): number;

package/dist/math/time-decay.js

@@ -0,0 +1,16 @@
+/**
+ * Exponential time-decay factor based on half-life.
+ * Returns a multiplier between 0 and 1 — recent items are near 1.0,
+ * older items decay toward 0.
+ *
+ * @param lastActivatedAt ISO date string of last activation
+ * @param halfLifeDays Number of days for half-life
+ * @returns Decay factor (0-1)
+ */
+export function timeDecayFactor(lastActivatedAt, halfLifeDays) {
+    const now = Date.now();
+    const activated = new Date(lastActivatedAt).getTime();
+    const ageDays = (now - activated) / (1000 * 60 * 60 * 24);
+    return Math.pow(0.5, ageDays / halfLifeDays);
+}
+//# sourceMappingURL=time-decay.js.map

package/dist/math/time-decay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-decay.js","sourceRoot":"","sources":["../../src/math/time-decay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,eAAuB,EAAE,YAAoB;IAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC;IACtD,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC;AAC/C,CAAC"}

package/dist/math/wilson-score.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Wilson Score Interval lower bound for low-sample-size confidence.
+ * Prevents unrealistic 100% from single success/failure.
+ *
+ * @param successes Number of successes
+ * @param total Total number of trials
+ * @param z Z-score for confidence level (1.64=90%, 1.96=95%, 2.33=99%)
+ * @returns Conservative lower bound estimate (0-1)
+ */
+export declare function wilsonScore(successes: number, total: number, z?: number): number;

package/dist/math/wilson-score.js

@@ -0,0 +1,21 @@
+/**
+ * Wilson Score Interval lower bound for low-sample-size confidence.
+ * Prevents unrealistic 100% from single success/failure.
+ *
+ * @param successes Number of successes
+ * @param total Total number of trials
+ * @param z Z-score for confidence level (1.64=90%, 1.96=95%, 2.33=99%)
+ * @returns Conservative lower bound estimate (0-1)
+ */
+export function wilsonScore(successes, total, z = 1.96) {
+    if (total === 0)
+        return 0;
+    const p = successes / total;
+    const z2 = z * z;
+    const n = total;
+    const denominator = 1 + z2 / n;
+    const centre = p + z2 / (2 * n);
+    const spread = z * Math.sqrt((p * (1 - p) + z2 / (4 * n)) / n);
+    return Math.max(0, (centre - spread) / denominator);
+}
+//# sourceMappingURL=wilson-score.js.map

package/dist/math/wilson-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wilson-score.js","sourceRoot":"","sources":["../../src/math/wilson-score.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,KAAa,EAAE,IAAY,IAAI;IAC5E,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE1B,MAAM,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC;IAC5B,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,MAAM,CAAC,GAAG,KAAK,CAAC;IAEhB,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE/D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC;AACtD,CAAC"}

package/dist/research/__tests__/base-engine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/research/__tests__/base-engine.test.js

@@ -0,0 +1,56 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { BaseResearchEngine } from '../base-engine.js';
+class TestResearchEngine extends BaseResearchEngine {
+    cycleCount = 0;
+    runCycle() {
+        this.cycleCount++;
+        return { count: this.cycleCount };
+    }
+}
+describe('BaseResearchEngine', () => {
+    beforeEach(() => { vi.useFakeTimers(); });
+    afterEach(() => { vi.useRealTimers(); });
+    it('should run without initial delay when not configured', () => {
+        const engine = new TestResearchEngine({ intervalMs: 1000 });
+        engine.start();
+        vi.advanceTimersByTime(1000);
+        expect(engine.cycleCount).toBe(1);
+        engine.stop();
+    });
+    it('should delay first cycle when initialDelayMs is set', () => {
+        const engine = new TestResearchEngine({ intervalMs: 1000, initialDelayMs: 5000 });
+        engine.start();
+        vi.advanceTimersByTime(4999);
+        expect(engine.cycleCount).toBe(0);
+        vi.advanceTimersByTime(1); // 5000ms total
+        expect(engine.cycleCount).toBe(1); // First cycle from delay
+        vi.advanceTimersByTime(1000);
+        expect(engine.cycleCount).toBe(2); // Second from interval
+        engine.stop();
+    });
+    it('should clean up both timers on stop', () => {
+        const engine = new TestResearchEngine({ intervalMs: 1000, initialDelayMs: 5000 });
+        engine.start();
+        engine.stop();
+        vi.advanceTimersByTime(10000);
+        expect(engine.cycleCount).toBe(0);
+    });
+    it('should handle errors in runCycle gracefully', () => {
+        class FailingEngine extends BaseResearchEngine {
+            runCycle() { throw new Error('boom'); }
+        }
+        const engine = new FailingEngine({ intervalMs: 100 });
+        engine.start();
+        expect(() => vi.advanceTimersByTime(100)).not.toThrow();
+        engine.stop();
+    });
+    it('should be safe to call stop before delay fires', () => {
+        const engine = new TestResearchEngine({ intervalMs: 1000, initialDelayMs: 5000 });
+        engine.start();
+        vi.advanceTimersByTime(2000);
+        engine.stop();
+        vi.advanceTimersByTime(10000);
+        expect(engine.cycleCount).toBe(0);
+    });
+});
+//# sourceMappingURL=base-engine.test.js.map

package/dist/research/__tests__/base-engine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-engine.test.js","sourceRoot":"","sources":["../../../src/research/__tests__/base-engine.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,kBAAmB,SAAQ,kBAAkB;IACjD,UAAU,GAAG,CAAC,CAAC;IACf,QAAQ;QACN,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IACpC,CAAC;CACF;AAED,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;QAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB;QAC5D,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB;QAC1D,MAAM,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,aAAc,SAAQ,kBAAkB;YAC5C,QAAQ,KAAW,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SAC9C;QACD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/research/base-engine.d.ts

@@ -0,0 +1,20 @@
+export interface ResearchEngineConfig {
+    intervalMs: number;
+    initialDelayMs?: number;
+}
+/**
+ * Abstract base class for research engines.
+ * Supports optional initial delay before first cycle.
+ * Handles timer lifecycle — subclasses implement runCycle().
+ */
+export declare abstract class BaseResearchEngine {
+    protected engineConfig: ResearchEngineConfig;
+    protected timer: ReturnType<typeof setInterval> | null;
+    protected delayTimer: ReturnType<typeof setTimeout> | null;
+    protected logger: import("winston").Logger;
+    constructor(engineConfig: ResearchEngineConfig);
+    start(): void;
+    stop(): void;
+    private safeRunCycle;
+    abstract runCycle(): unknown;
+}

package/dist/research/base-engine.js

@@ -0,0 +1,46 @@
+import { getLogger } from '../utils/logger.js';
+/**
+ * Abstract base class for research engines.
+ * Supports optional initial delay before first cycle.
+ * Handles timer lifecycle — subclasses implement runCycle().
+ */
+export class BaseResearchEngine {
+    engineConfig;
+    timer = null;
+    delayTimer = null;
+    logger = getLogger();
+    constructor(engineConfig) {
+        this.engineConfig = engineConfig;
+    }
+    start() {
+        const delay = this.engineConfig.initialDelayMs;
+        if (delay && delay > 0) {
+            this.delayTimer = setTimeout(() => {
+                this.safeRunCycle();
+                this.timer = setInterval(() => this.safeRunCycle(), this.engineConfig.intervalMs);
+            }, delay);
+        }
+        else {
+            this.timer = setInterval(() => this.safeRunCycle(), this.engineConfig.intervalMs);
+        }
+    }
+    stop() {
+        if (this.delayTimer) {
+            clearTimeout(this.delayTimer);
+            this.delayTimer = null;
+        }
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    safeRunCycle() {
+        try {
+            this.runCycle();
+        }
+        catch (err) {
+            this.logger.error('Research cycle error', { error: String(err) });
+        }
+    }
+}
+//# sourceMappingURL=base-engine.js.map

package/dist/research/base-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-engine.js","sourceRoot":"","sources":["../../src/research/base-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAO/C;;;;GAIG;AACH,MAAM,OAAgB,kBAAkB;IAKhB;IAJZ,KAAK,GAA0C,IAAI,CAAC;IACpD,UAAU,GAAyC,IAAI,CAAC;IACxD,MAAM,GAAG,SAAS,EAAE,CAAC;IAE/B,YAAsB,YAAkC;QAAlC,iBAAY,GAAZ,YAAY,CAAsB;IAAG,CAAC;IAE5D,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC;QAC/C,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YACpF,CAAC,EAAE,KAAK,CAAC,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;CAGF"}

package/dist/synapses/__tests__/activation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/synapses/__tests__/activation.test.js

@@ -0,0 +1,87 @@
+import { describe, it, expect, vi } from 'vitest';
+import { spreadingActivation } from '../activation.js';
+function synapse(overrides) {
+    return {
+        id: 1,
+        source_type: 'a', source_id: 1,
+        target_type: 'b', target_id: 1,
+        synapse_type: 'test',
+        weight: 0.8,
+        activation_count: 1,
+        last_activated_at: new Date().toISOString(),
+        metadata: null,
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+        ...overrides,
+    };
+}
+function mockRepo(outgoingMap = {}, incomingMap = {}) {
+    return {
+        findBySourceTarget: vi.fn(),
+        create: vi.fn(),
+        getById: vi.fn(),
+        update: vi.fn(),
+        delete: vi.fn(),
+        getOutgoing: vi.fn().mockImplementation((type, id) => outgoingMap[`${type}:${id}`] ?? []),
+        getIncoming: vi.fn().mockImplementation((type, id) => incomingMap[`${type}:${id}`] ?? []),
+        findInactiveSince: vi.fn().mockReturnValue([]),
+        topByWeight: vi.fn().mockReturnValue([]),
+        topDiverse: vi.fn().mockReturnValue([]),
+        countNodes: vi.fn().mockReturnValue(0),
+        totalCount: vi.fn().mockReturnValue(0),
+        avgWeight: vi.fn().mockReturnValue(0),
+        countByType: vi.fn().mockReturnValue({}),
+    };
+}
+describe('spreadingActivation', () => {
+    it('returns empty for isolated node', () => {
+        const repo = mockRepo();
+        const results = spreadingActivation(repo, { type: 'a', id: 1 });
+        expect(results).toEqual([]);
+    });
+    it('finds directly connected nodes', () => {
+        const s = synapse({ target_type: 'b', target_id: 2, weight: 0.8 });
+        const repo = mockRepo({ 'a:1': [s] });
+        const results = spreadingActivation(repo, { type: 'a', id: 1 });
+        expect(results).toHaveLength(1);
+        expect(results[0].node).toEqual({ type: 'b', id: 2 });
+        expect(results[0].activation).toBe(0.8);
+        expect(results[0].depth).toBe(1);
+    });
+    it('propagates through multiple hops', () => {
+        const s1 = synapse({ target_type: 'b', target_id: 2, weight: 0.8 });
+        const s2 = synapse({ target_type: 'c', target_id: 3, weight: 0.5 });
+        const repo = mockRepo({ 'a:1': [s1], 'b:2': [s2] });
+        const results = spreadingActivation(repo, { type: 'a', id: 1 });
+        expect(results).toHaveLength(2);
+        expect(results.find(r => r.node.type === 'c')?.activation).toBeCloseTo(0.4);
+    });
+    it('respects maxDepth', () => {
+        const s1 = synapse({ target_type: 'b', target_id: 2, weight: 0.9 });
+        const s2 = synapse({ target_type: 'c', target_id: 3, weight: 0.9 });
+        const repo = mockRepo({ 'a:1': [s1], 'b:2': [s2] });
+        const results = spreadingActivation(repo, { type: 'a', id: 1 }, 1);
+        expect(results).toHaveLength(1);
+    });
+    it('filters by minWeight', () => {
+        const s = synapse({ target_type: 'b', target_id: 2, weight: 0.1 });
+        const repo = mockRepo({ 'a:1': [s] });
+        const results = spreadingActivation(repo, { type: 'a', id: 1 }, 3, 0.2);
+        expect(results).toHaveLength(0);
+    });
+    it('follows incoming synapses too', () => {
+        const s = synapse({ source_type: 'b', source_id: 2, weight: 0.7 });
+        const repo = mockRepo({}, { 'a:1': [s] });
+        const results = spreadingActivation(repo, { type: 'a', id: 1 });
+        expect(results).toHaveLength(1);
+        expect(results[0].node).toEqual({ type: 'b', id: 2 });
+    });
+    it('sorts by activation descending', () => {
+        const s1 = synapse({ target_type: 'b', target_id: 2, weight: 0.3 });
+        const s2 = synapse({ target_type: 'c', target_id: 3, weight: 0.9 });
+        const repo = mockRepo({ 'a:1': [s1, s2] });
+        const results = spreadingActivation(repo, { type: 'a', id: 1 });
+        expect(results[0].activation).toBeGreaterThan(results[1].activation);
+    });
+});
+//# sourceMappingURL=activation.test.js.map

package/dist/synapses/__tests__/activation.test.js.map

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

package/dist/synapses/__tests__/decay.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/synapses/__tests__/decay.test.js

@@ -0,0 +1,73 @@
+import { describe, it, expect, vi } from 'vitest';
+import { decayAll } from '../decay.js';
+function synapse(overrides) {
+    return {
+        id: 1,
+        source_type: 'a', source_id: 1,
+        target_type: 'b', target_id: 1,
+        synapse_type: 'test',
+        weight: 0.5,
+        activation_count: 1,
+        last_activated_at: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString(),
+        metadata: null,
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+        ...overrides,
+    };
+}
+function mockRepo(stale = []) {
+    return {
+        findBySourceTarget: vi.fn(),
+        create: vi.fn(),
+        getById: vi.fn(),
+        update: vi.fn(),
+        delete: vi.fn(),
+        getOutgoing: vi.fn().mockReturnValue([]),
+        getIncoming: vi.fn().mockReturnValue([]),
+        findInactiveSince: vi.fn().mockReturnValue(stale),
+        topByWeight: vi.fn().mockReturnValue([]),
+        topDiverse: vi.fn().mockReturnValue([]),
+        countNodes: vi.fn().mockReturnValue(0),
+        totalCount: vi.fn().mockReturnValue(0),
+        avgWeight: vi.fn().mockReturnValue(0),
+        countByType: vi.fn().mockReturnValue({}),
+    };
+}
+const config = { decayHalfLifeDays: 30, decayAfterDays: 14, pruneThreshold: 0.05 };
+describe('decayAll', () => {
+    it('returns zeros when no stale synapses', () => {
+        const repo = mockRepo();
+        const result = decayAll(repo, config);
+        expect(result).toEqual({ decayed: 0, pruned: 0 });
+    });
+    it('decays stale synapses', () => {
+        const s = synapse({ id: 1, weight: 0.5 });
+        const repo = mockRepo([s]);
+        const result = decayAll(repo, config);
+        expect(result.decayed).toBe(1);
+        expect(repo.update).toHaveBeenCalled();
+    });
+    it('prunes synapses that decay below threshold', () => {
+        const s = synapse({
+            id: 1,
+            weight: 0.03,
+            last_activated_at: new Date(Date.now() - 90 * 24 * 60 * 60 * 1000).toISOString(),
+        });
+        const repo = mockRepo([s]);
+        const result = decayAll(repo, config);
+        expect(result.pruned).toBe(1);
+        expect(repo.delete).toHaveBeenCalledWith(1);
+    });
+    it('handles mix of decayed and pruned', () => {
+        const healthy = synapse({ id: 1, weight: 0.8 });
+        const weak = synapse({
+            id: 2,
+            weight: 0.02,
+            last_activated_at: new Date(Date.now() - 120 * 24 * 60 * 60 * 1000).toISOString(),
+        });
+        const repo = mockRepo([healthy, weak]);
+        const result = decayAll(repo, config);
+        expect(result.decayed + result.pruned).toBe(2);
+    });
+});
+//# sourceMappingURL=decay.test.js.map

package/dist/synapses/__tests__/decay.test.js.map

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

package/dist/synapses/__tests__/hebbian.test.d.ts

@@ -0,0 +1 @@
+export {};