@timmeck/brain-core 1.1.0 → 1.5.0

package/dist/synapses/synapse-manager.js

@@ -0,0 +1,72 @@
+import { strengthen, weaken } from './hebbian.js';
+import { decayAll } from './decay.js';
+import { spreadingActivation } from './activation.js';
+import { findPath } from './pathfinder.js';
+import { getLogger } from '../utils/logger.js';
+/**
+ * Base synapse manager shared across all brains.
+ * Each brain extends this with domain-specific context methods
+ * (e.g. getErrorContext, getPostContext, getTradeContext).
+ */
+export class BaseSynapseManager {
+    repo;
+    config;
+    logger = getLogger();
+    constructor(repo, config) {
+        this.repo = repo;
+        this.config = config;
+    }
+    strengthen(source, target, synapseType, context) {
+        this.logger.debug(`Strengthening synapse ${source.type}:${source.id} --${synapseType}--> ${target.type}:${target.id}`);
+        return strengthen(this.repo, source, target, synapseType, this.hebbianConfig(), context);
+    }
+    weaken(synapseId, factor = 0.5) {
+        this.logger.debug(`Weakening synapse ${synapseId} by factor ${factor}`);
+        weaken(this.repo, synapseId, this.hebbianConfig(), factor);
+    }
+    find(source, target, synapseType) {
+        return this.repo.findBySourceTarget(source.type, source.id, target.type, target.id, synapseType);
+    }
+    activate(startNode, maxDepth, minWeight) {
+        return spreadingActivation(this.repo, startNode, maxDepth ?? this.config.maxDepth, minWeight ?? this.config.minActivationWeight);
+    }
+    findPath(from, to, maxDepth) {
+        return findPath(this.repo, from, to, maxDepth ?? this.config.maxDepth + 2);
+    }
+    runDecay() {
+        this.logger.info('Running synapse decay cycle');
+        const result = decayAll(this.repo, this.decayConfig());
+        this.logger.info(`Decay complete: ${result.decayed} decayed, ${result.pruned} pruned`);
+        return result;
+    }
+    getStrongestSynapses(limit = 20) {
+        return this.repo.topByWeight(limit);
+    }
+    getDiverseSynapses(perType = 25) {
+        return this.repo.topDiverse(perType);
+    }
+    getNetworkStats() {
+        return {
+            totalNodes: this.repo.countNodes(),
+            totalSynapses: this.repo.totalCount(),
+            avgWeight: this.repo.avgWeight(),
+            nodesByType: {},
+            synapsesByType: this.repo.countByType(),
+        };
+    }
+    hebbianConfig() {
+        return {
+            initialWeight: this.config.initialWeight,
+            learningRate: this.config.learningRate,
+            pruneThreshold: this.config.pruneThreshold,
+        };
+    }
+    decayConfig() {
+        return {
+            decayHalfLifeDays: this.config.decayHalfLifeDays,
+            decayAfterDays: this.config.decayAfterDays,
+            pruneThreshold: this.config.pruneThreshold,
+        };
+    }
+}
+//# sourceMappingURL=synapse-manager.js.map

package/dist/synapses/synapse-manager.js.map

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

package/dist/synapses/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Generic synapse network types for the Brain ecosystem.
+ * Each brain provides its own NodeType/SynapseType string unions,
+ * but the record shape and algorithms are shared.
+ */
+export interface NodeRef {
+    type: string;
+    id: number;
+}
+export interface SynapseRecord {
+    id: number;
+    source_type: string;
+    source_id: number;
+    target_type: string;
+    target_id: number;
+    synapse_type: string;
+    weight: number;
+    activation_count: number;
+    last_activated_at: string;
+    metadata: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface ActivationResult {
+    node: NodeRef;
+    activation: number;
+    depth: number;
+    path: string[];
+}
+export interface PathNode {
+    type: string;
+    id: number;
+}
+export interface SynapsePath {
+    from: PathNode;
+    to: PathNode;
+    synapses: SynapseRecord[];
+    totalWeight: number;
+    hops: number;
+}
+export interface NetworkStats {
+    totalNodes: number;
+    totalSynapses: number;
+    avgWeight: number;
+    nodesByType: Record<string, number>;
+    synapsesByType: Record<string, number>;
+}
+export interface HebbianConfig {
+    initialWeight: number;
+    learningRate: number;
+    pruneThreshold: number;
+}
+export interface DecayConfig {
+    decayHalfLifeDays: number;
+    decayAfterDays: number;
+    pruneThreshold: number;
+}
+/**
+ * Interface that synapse repositories must implement
+ * for the shared algorithms to work.
+ */
+export interface SynapseRepoInterface {
+    findBySourceTarget(sourceType: string, sourceId: number, targetType: string, targetId: number, synapseType: string): SynapseRecord | undefined;
+    create(data: {
+        source_type: string;
+        source_id: number;
+        target_type: string;
+        target_id: number;
+        synapse_type: string;
+        weight: number;
+        metadata: string | null;
+    }): number;
+    getById(id: number): SynapseRecord | undefined;
+    update(id: number, data: Partial<SynapseRecord>): void;
+    delete(id: number): void;
+    getOutgoing(nodeType: string, nodeId: number): SynapseRecord[];
+    getIncoming(nodeType: string, nodeId: number): SynapseRecord[];
+    findInactiveSince(cutoffIso: string): SynapseRecord[];
+    topByWeight(limit: number): SynapseRecord[];
+    topDiverse(perType: number): SynapseRecord[];
+    countNodes(): number;
+    totalCount(): number;
+    avgWeight(): number;
+    countByType(): Record<string, number>;
+}

package/dist/synapses/types.js

@@ -0,0 +1,7 @@
+/**
+ * Generic synapse network types for the Brain ecosystem.
+ * Each brain provides its own NodeType/SynapseType string unions,
+ * but the record shape and algorithms are shared.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/synapses/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/synapses/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/__tests__/events.test.d.ts

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

package/dist/utils/__tests__/events.test.js

@@ -0,0 +1,38 @@
+import { describe, it, expect, vi } from 'vitest';
+import { TypedEventBus } from '../events.js';
+describe('TypedEventBus', () => {
+    it('emits and receives events', () => {
+        const bus = new TypedEventBus();
+        const handler = vi.fn();
+        bus.on('test:fired', handler);
+        bus.emit('test:fired', { value: 42 });
+        expect(handler).toHaveBeenCalledWith({ value: 42 });
+    });
+    it('supports once listener', () => {
+        const bus = new TypedEventBus();
+        const handler = vi.fn();
+        bus.once('test:fired', handler);
+        bus.emit('test:fired', { value: 1 });
+        bus.emit('test:fired', { value: 2 });
+        expect(handler).toHaveBeenCalledTimes(1);
+    });
+    it('supports off to remove listener', () => {
+        const bus = new TypedEventBus();
+        const handler = vi.fn();
+        bus.on('test:fired', handler);
+        bus.off('test:fired', handler);
+        bus.emit('test:fired', { value: 1 });
+        expect(handler).not.toHaveBeenCalled();
+    });
+    it('handles multiple event types independently', () => {
+        const bus = new TypedEventBus();
+        const handler1 = vi.fn();
+        const handler2 = vi.fn();
+        bus.on('test:fired', handler1);
+        bus.on('test:other', handler2);
+        bus.emit('test:fired', { value: 10 });
+        expect(handler1).toHaveBeenCalledTimes(1);
+        expect(handler2).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=events.test.js.map

package/dist/utils/__tests__/events.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/events.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAO7C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,GAAG,GAAG,IAAI,aAAa,EAAc,CAAC;QAC5C,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACxB,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,GAAG,GAAG,IAAI,aAAa,EAAc,CAAC;QAC5C,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACrC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,GAAG,GAAG,IAAI,aAAa,EAAc,CAAC;QAC5C,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACxB,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC9B,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,GAAG,GAAG,IAAI,aAAa,EAAc,CAAC;QAC5C,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/B,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/__tests__/hash.test.d.ts

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

package/dist/utils/__tests__/hash.test.js

@@ -0,0 +1,25 @@
+import { describe, it, expect } from 'vitest';
+import { sha256 } from '../hash.js';
+describe('sha256', () => {
+    it('returns consistent hash for same input', () => {
+        expect(sha256('hello')).toBe(sha256('hello'));
+    });
+    it('returns different hashes for different inputs', () => {
+        expect(sha256('hello')).not.toBe(sha256('world'));
+    });
+    it('returns 64-char hex string', () => {
+        expect(sha256('test')).toMatch(/^[a-f0-9]{64}$/);
+    });
+    it('matches known SHA-256 value', () => {
+        expect(sha256('hello')).toBe('2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824');
+    });
+    it('handles empty string', () => {
+        expect(sha256('')).toBe('e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855');
+    });
+    it('handles unicode', () => {
+        const hash = sha256('こんにちは');
+        expect(hash).toMatch(/^[a-f0-9]{64}$/);
+        expect(hash).toBe(sha256('こんにちは'));
+    });
+});
+//# sourceMappingURL=hash.test.js.map

package/dist/utils/__tests__/hash.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/hash.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IACnG,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/__tests__/logger.test.d.ts

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

package/dist/utils/__tests__/logger.test.js

@@ -0,0 +1,29 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { createLogger, getLogger, resetLogger } from '../logger.js';
+describe('logger', () => {
+    afterEach(() => {
+        resetLogger();
+    });
+    it('createLogger returns a logger instance', () => {
+        const logger = createLogger({ level: 'error' });
+        expect(logger).toBeDefined();
+        expect(typeof logger.info).toBe('function');
+        expect(typeof logger.error).toBe('function');
+    });
+    it('getLogger returns the same singleton', () => {
+        const a = createLogger({ level: 'error' });
+        const b = getLogger();
+        expect(a).toBe(b);
+    });
+    it('resetLogger allows creating a new logger', () => {
+        const a = createLogger({ level: 'error' });
+        resetLogger();
+        const b = createLogger({ level: 'warn' });
+        expect(a).not.toBe(b);
+    });
+    it('getLogger auto-creates if none exists', () => {
+        const logger = getLogger();
+        expect(logger).toBeDefined();
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/dist/utils/__tests__/logger.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/logger.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEpE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;QACtB,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,WAAW,EAAE,CAAC;QACd,MAAM,CAAC,GAAG,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/__tests__/paths.test.d.ts

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

package/dist/utils/__tests__/paths.test.js

@@ -0,0 +1,50 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { normalizePath, getDataDir, getPipeName } from '../paths.js';
+describe('normalizePath', () => {
+    it('converts backslashes to forward slashes', () => {
+        expect(normalizePath('C:\\Users\\test\\file.ts')).toBe('C:/Users/test/file.ts');
+    });
+    it('leaves forward slashes unchanged', () => {
+        expect(normalizePath('/home/user/file.ts')).toBe('/home/user/file.ts');
+    });
+    it('handles mixed slashes', () => {
+        expect(normalizePath('C:\\Users/test\\file.ts')).toBe('C:/Users/test/file.ts');
+    });
+});
+describe('getDataDir', () => {
+    afterEach(() => {
+        delete process.env['TEST_DATA_DIR'];
+    });
+    it('uses env var when set', () => {
+        process.env['TEST_DATA_DIR'] = '/custom/dir';
+        const result = getDataDir('TEST_DATA_DIR', '.brain');
+        // path.resolve normalises to platform-native form
+        expect(result).toContain('custom');
+        expect(result).not.toContain('.brain');
+    });
+    it('falls back to home dir', () => {
+        const result = getDataDir('NONEXISTENT_VAR_XYZ', '.test-brain');
+        expect(result).toContain('.test-brain');
+    });
+});
+describe('getPipeName', () => {
+    it('returns platform-specific path', () => {
+        const name = getPipeName('test-brain');
+        if (process.platform === 'win32') {
+            expect(name).toBe('\\\\.\\pipe\\test-brain');
+        }
+        else {
+            expect(name).toContain('test-brain.sock');
+        }
+    });
+    it('defaults to brain', () => {
+        const name = getPipeName();
+        if (process.platform === 'win32') {
+            expect(name).toBe('\\\\.\\pipe\\brain');
+        }
+        else {
+            expect(name).toContain('brain.sock');
+        }
+    });
+});
+//# sourceMappingURL=paths.test.js.map

package/dist/utils/__tests__/paths.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/paths.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAM,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAErE,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,aAAa,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,aAAa,CAAC;QAC7C,MAAM,MAAM,GAAG,UAAU,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QACrD,kDAAkD;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,MAAM,GAAG,UAAU,CAAC,qBAAqB,EAAE,aAAa,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/eslint.config.js

@@ -0,0 +1,14 @@
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  ...tseslint.configs.recommended,
+  {
+    ignores: ['dist/', 'node_modules/', '**/*.js', '**/*.d.ts'],
+  },
+  {
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+    },
+  },
+);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timmeck/brain-core",
-  "version": "1.1.0",
+  "version": "1.5.0",
   "description": "Shared core infrastructure for the Brain ecosystem — IPC, MCP, CLI, DB connection, and utilities",
   "type": "module",
   "main": "dist/index.js",
@@ -20,12 +20,24 @@
     "./mcp/http-server": "./dist/mcp/http-server.js",
     "./cli/colors": "./dist/cli/colors.js",
     "./api/server": "./dist/api/server.js",
+    "./math/wilson-score": "./dist/math/wilson-score.js",
+    "./math/time-decay": "./dist/math/time-decay.js",
+    "./config/loader": "./dist/config/loader.js",
+    "./synapses/types": "./dist/synapses/types.js",
+    "./synapses/hebbian": "./dist/synapses/hebbian.js",
+    "./synapses/decay": "./dist/synapses/decay.js",
+    "./synapses/activation": "./dist/synapses/activation.js",
+    "./synapses/pathfinder": "./dist/synapses/pathfinder.js",
+    "./synapses/synapse-manager": "./dist/synapses/synapse-manager.js",
     "./cross-brain": "./dist/cross-brain/client.js"
   },
   "scripts": {
     "build": "tsc",
     "dev": "tsx src/index.ts",
-    "test": "vitest"
+    "test": "vitest",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "test:coverage": "vitest --coverage"
   },
   "keywords": [
     "brain",
@@ -53,8 +65,11 @@
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.39.3",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0",
+    "typescript-eslint": "^8.56.1",
     "vitest": "^3.0.0"
   }
 }

package/.github/FUNDING.yml

@@ -1 +0,0 @@
-github: timmeck

package/.github/workflows/ci.yml

@@ -1,21 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [master, main]
-  pull_request:
-    branches: [master, main]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: npm
-      - run: npm ci
-      - run: npm run build
-      - run: npm test
-        if: ${{ hashFiles('vitest.config.*', 'src/**/*.test.ts', 'tests/**/*.test.ts') != '' }}

package/src/api/server.ts

@@ -1,210 +0,0 @@
-import http from 'node:http';
-import { getLogger } from '../utils/logger.js';
-import type { IpcRouter } from '../ipc/server.js';
-
-export interface ApiServerOptions {
-  port: number;
-  router: IpcRouter;
-  apiKey?: string;
-}
-
-export interface RouteDefinition {
-  method: string;
-  pattern: RegExp;
-  ipcMethod: string;
-  extractParams: (match: RegExpMatchArray, query: URLSearchParams, body?: unknown) => unknown;
-}
-
-export class BaseApiServer {
-  private server: http.Server | null = null;
-  protected logger = getLogger();
-  private routes: RouteDefinition[];
-  protected sseClients: Set<http.ServerResponse> = new Set();
-
-  constructor(protected options: ApiServerOptions) {
-    this.routes = this.buildRoutes();
-  }
-
-  start(): void {
-    const { port, apiKey } = this.options;
-
-    this.server = http.createServer((req, res) => {
-      res.setHeader('Access-Control-Allow-Origin', '*');
-      res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
-      res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-API-Key');
-
-      if (req.method === 'OPTIONS') {
-        res.writeHead(204);
-        res.end();
-        return;
-      }
-
-      if (apiKey) {
-        const provided = (req.headers['x-api-key'] as string) ??
-          req.headers.authorization?.replace('Bearer ', '');
-        if (provided !== apiKey) {
-          this.json(res, 401, { error: 'Unauthorized', message: 'Invalid or missing API key' });
-          return;
-        }
-      }
-
-      this.handleRequest(req, res).catch((err) => {
-        this.logger.error('API error:', err);
-        this.json(res, 500, {
-          error: 'Internal Server Error',
-          message: err instanceof Error ? err.message : String(err),
-        });
-      });
-    });
-
-    this.server.listen(port, () => {
-      this.logger.info(`REST API server started on http://localhost:${port}`);
-    });
-  }
-
-  stop(): void {
-    for (const client of this.sseClients) {
-      try { client.end(); } catch { /* ignore */ }
-    }
-    this.sseClients.clear();
-    this.server?.close();
-    this.server = null;
-    this.logger.info('REST API server stopped');
-  }
-
-  /** Override to add domain-specific RESTful routes */
-  protected buildRoutes(): RouteDefinition[] {
-    return [];
-  }
-
-  private async handleRequest(req: http.IncomingMessage, res: http.ServerResponse): Promise<void> {
-    const url = new URL(req.url ?? '/', 'http://localhost');
-    const pathname = url.pathname;
-    const method = req.method ?? 'GET';
-    const query = url.searchParams;
-
-    // Health check
-    if (pathname === '/api/v1/health') {
-      this.json(res, 200, { status: 'ok', timestamp: new Date().toISOString() });
-      return;
-    }
-
-    // SSE event stream
-    if (pathname === '/api/v1/events' && method === 'GET') {
-      res.writeHead(200, {
-        'Content-Type': 'text/event-stream',
-        'Cache-Control': 'no-cache',
-        'Connection': 'keep-alive',
-      });
-      res.write('data: {"type":"connected"}\n\n');
-      this.sseClients.add(res);
-      req.on('close', () => this.sseClients.delete(res));
-      return;
-    }
-
-    // List all available methods
-    if (pathname === '/api/v1/methods' && method === 'GET') {
-      const methods = this.options.router.listMethods();
-      this.json(res, 200, {
-        methods,
-        rpcEndpoint: '/api/v1/rpc',
-        usage: 'POST /api/v1/rpc with body { "method": "<method>", "params": {...} }',
-      });
-      return;
-    }
-
-    // Generic RPC endpoint
-    if (pathname === '/api/v1/rpc' && method === 'POST') {
-      const body = await this.readBody(req);
-      if (!body) {
-        this.json(res, 400, { error: 'Bad Request', message: 'Empty request body' });
-        return;
-      }
-
-      const parsed = JSON.parse(body);
-
-      // Batch RPC support
-      if (Array.isArray(parsed)) {
-        const results = parsed.map((call: { method: string; params?: unknown; id?: string | number }) => {
-          try {
-            const result = this.options.router.handle(call.method, call.params ?? {});
-            return { id: call.id, result };
-          } catch (err) {
-            return { id: call.id, error: err instanceof Error ? err.message : String(err) };
-          }
-        });
-        this.json(res, 200, results);
-        return;
-      }
-
-      if (!parsed.method) {
-        this.json(res, 400, { error: 'Bad Request', message: 'Missing "method" field' });
-        return;
-      }
-
-      try {
-        const result = this.options.router.handle(parsed.method, parsed.params ?? {});
-        this.json(res, 200, { result });
-      } catch (err) {
-        this.json(res, 400, { error: err instanceof Error ? err.message : String(err) });
-      }
-      return;
-    }
-
-    // RESTful routes
-    let body: unknown = undefined;
-    if (method === 'POST' || method === 'PUT') {
-      try {
-        const raw = await this.readBody(req);
-        body = raw ? JSON.parse(raw) : {};
-      } catch {
-        this.json(res, 400, { error: 'Bad Request', message: 'Invalid JSON body' });
-        return;
-      }
-    }
-
-    for (const route of this.routes) {
-      if (route.method !== method) continue;
-      const match = pathname.match(route.pattern);
-      if (!match) continue;
-
-      try {
-        const params = route.extractParams(match, query, body);
-        const result = this.options.router.handle(route.ipcMethod, params);
-        this.json(res, method === 'POST' ? 201 : 200, { result });
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        const status = msg.startsWith('Unknown method') ? 404 : 400;
-        this.json(res, status, { error: msg });
-      }
-      return;
-    }
-
-    this.json(res, 404, { error: 'Not Found', message: `No route for ${method} ${pathname}` });
-  }
-
-  protected json(res: http.ServerResponse, status: number, data: unknown): void {
-    res.writeHead(status, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify(data));
-  }
-
-  protected readBody(req: http.IncomingMessage): Promise<string> {
-    return new Promise((resolve, reject) => {
-      const chunks: Buffer[] = [];
-      req.on('data', (chunk: Buffer) => chunks.push(chunk));
-      req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
-      req.on('error', reject);
-    });
-  }
-
-  protected broadcastSSE(data: unknown): void {
-    const msg = `data: ${JSON.stringify(data)}\n\n`;
-    for (const client of this.sseClients) {
-      try {
-        client.write(msg);
-      } catch {
-        this.sseClients.delete(client);
-      }
-    }
-  }
-}