@timmeck/brain 1.8.0 → 1.8.2

package/src/synapses/activation.ts

@@ -1,80 +1,80 @@
-import type { NodeType } from '../types/synapse.types.js';
-import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
-
-export interface ActivationNode {
-  type: NodeType;
-  id: number;
-}
-
-export interface ActivationResult {
-  node: ActivationNode;
-  activation: number;
-  depth: number;
-  path: string[];
-}
-
-export function spreadingActivation(
-  repo: SynapseRepository,
-  startNode: ActivationNode,
-  maxDepth: number = 3,
-  minWeight: number = 0.2,
-): ActivationResult[] {
-  const visited = new Set<string>();
-  const results: ActivationResult[] = [];
-
-  const queue: Array<{
-    node: ActivationNode;
-    depth: number;
-    pathWeight: number;
-    path: string[];
-  }> = [{ node: startNode, depth: 0, pathWeight: 1.0, path: [] }];
-
-  while (queue.length > 0) {
-    const current = queue.shift()!;
-    const key = `${current.node.type}:${current.node.id}`;
-
-    if (visited.has(key)) continue;
-    if (current.depth > maxDepth) continue;
-    if (current.pathWeight < minWeight) continue;
-
-    visited.add(key);
-
-    if (current.depth > 0) {
-      results.push({
-        node: current.node,
-        activation: current.pathWeight,
-        depth: current.depth,
-        path: current.path,
-      });
-    }
-
-    const outgoing = repo.getOutgoing(current.node.type, current.node.id);
-    const incoming = repo.getIncoming(current.node.type, current.node.id);
-
-    for (const synapse of outgoing) {
-      const nextWeight = current.pathWeight * synapse.weight;
-      if (nextWeight >= minWeight) {
-        queue.push({
-          node: { type: synapse.target_type, id: synapse.target_id },
-          depth: current.depth + 1,
-          pathWeight: nextWeight,
-          path: [...current.path, `--${synapse.synapse_type}-->`],
-        });
-      }
-    }
-
-    for (const synapse of incoming) {
-      const nextWeight = current.pathWeight * synapse.weight;
-      if (nextWeight >= minWeight) {
-        queue.push({
-          node: { type: synapse.source_type, id: synapse.source_id },
-          depth: current.depth + 1,
-          pathWeight: nextWeight,
-          path: [...current.path, `<--${synapse.synapse_type}--`],
-        });
-      }
-    }
-  }
-
-  return results.sort((a, b) => b.activation - a.activation);
-}
+import type { NodeType } from '../types/synapse.types.js';
+import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
+
+export interface ActivationNode {
+  type: NodeType;
+  id: number;
+}
+
+export interface ActivationResult {
+  node: ActivationNode;
+  activation: number;
+  depth: number;
+  path: string[];
+}
+
+export function spreadingActivation(
+  repo: SynapseRepository,
+  startNode: ActivationNode,
+  maxDepth: number = 3,
+  minWeight: number = 0.2,
+): ActivationResult[] {
+  const visited = new Set<string>();
+  const results: ActivationResult[] = [];
+
+  const queue: Array<{
+    node: ActivationNode;
+    depth: number;
+    pathWeight: number;
+    path: string[];
+  }> = [{ node: startNode, depth: 0, pathWeight: 1.0, path: [] }];
+
+  while (queue.length > 0) {
+    const current = queue.shift()!;
+    const key = `${current.node.type}:${current.node.id}`;
+
+    if (visited.has(key)) continue;
+    if (current.depth > maxDepth) continue;
+    if (current.pathWeight < minWeight) continue;
+
+    visited.add(key);
+
+    if (current.depth > 0) {
+      results.push({
+        node: current.node,
+        activation: current.pathWeight,
+        depth: current.depth,
+        path: current.path,
+      });
+    }
+
+    const outgoing = repo.getOutgoing(current.node.type, current.node.id);
+    const incoming = repo.getIncoming(current.node.type, current.node.id);
+
+    for (const synapse of outgoing) {
+      const nextWeight = current.pathWeight * synapse.weight;
+      if (nextWeight >= minWeight) {
+        queue.push({
+          node: { type: synapse.target_type, id: synapse.target_id },
+          depth: current.depth + 1,
+          pathWeight: nextWeight,
+          path: [...current.path, `--${synapse.synapse_type}-->`],
+        });
+      }
+    }
+
+    for (const synapse of incoming) {
+      const nextWeight = current.pathWeight * synapse.weight;
+      if (nextWeight >= minWeight) {
+        queue.push({
+          node: { type: synapse.source_type, id: synapse.source_id },
+          depth: current.depth + 1,
+          pathWeight: nextWeight,
+          path: [...current.path, `<--${synapse.synapse_type}--`],
+        });
+      }
+    }
+  }
+
+  return results.sort((a, b) => b.activation - a.activation);
+}

package/src/synapses/decay.ts

@@ -1,38 +1,38 @@
-import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
-
-export interface DecayConfig {
-  decayHalfLifeDays: number;
-  decayAfterDays: number;
-  pruneThreshold: number;
-}
-
-export function timeDecayFactor(lastActivatedAt: string, halfLifeDays: number): number {
-  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);
-}
-
-export function decayAll(repo: SynapseRepository, config: DecayConfig): { decayed: number; pruned: number } {
-  const cutoff = new Date();
-  cutoff.setDate(cutoff.getDate() - config.decayAfterDays);
-
-  const stale = repo.findInactiveSince(cutoff.toISOString());
-  let pruned = 0;
-  let decayed = 0;
-
-  for (const synapse of stale) {
-    const factor = timeDecayFactor(synapse.last_activated_at, config.decayHalfLifeDays);
-    const newWeight = synapse.weight * factor;
-
-    if (newWeight < config.pruneThreshold) {
-      repo.delete(synapse.id);
-      pruned++;
-    } else {
-      repo.update(synapse.id, { weight: newWeight });
-      decayed++;
-    }
-  }
-
-  return { decayed, pruned };
-}
+import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
+
+export interface DecayConfig {
+  decayHalfLifeDays: number;
+  decayAfterDays: number;
+  pruneThreshold: number;
+}
+
+export function timeDecayFactor(lastActivatedAt: string, halfLifeDays: number): number {
+  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);
+}
+
+export function decayAll(repo: SynapseRepository, config: DecayConfig): { decayed: number; pruned: number } {
+  const cutoff = new Date();
+  cutoff.setDate(cutoff.getDate() - config.decayAfterDays);
+
+  const stale = repo.findInactiveSince(cutoff.toISOString());
+  let pruned = 0;
+  let decayed = 0;
+
+  for (const synapse of stale) {
+    const factor = timeDecayFactor(synapse.last_activated_at, config.decayHalfLifeDays);
+    const newWeight = synapse.weight * factor;
+
+    if (newWeight < config.pruneThreshold) {
+      repo.delete(synapse.id);
+      pruned++;
+    } else {
+      repo.update(synapse.id, { weight: newWeight });
+      decayed++;
+    }
+  }
+
+  return { decayed, pruned };
+}

package/src/synapses/hebbian.ts

@@ -1,69 +1,69 @@
-import type { SynapseRecord, NodeType, SynapseType } from '../types/synapse.types.js';
-import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
-
-export interface HebbianConfig {
-  initialWeight: number;
-  learningRate: number;
-  pruneThreshold: number;
-}
-
-export interface NodeRef {
-  type: NodeType;
-  id: number;
-}
-
-export function strengthen(
-  repo: SynapseRepository,
-  source: NodeRef,
-  target: NodeRef,
-  synapseType: SynapseType,
-  config: HebbianConfig,
-  context?: Record<string, unknown>,
-): SynapseRecord {
-  const existing = repo.findBySourceTarget(
-    source.type, source.id, target.type, target.id, synapseType,
-  );
-
-  if (existing) {
-    // Hebbian: weight grows logarithmically, saturates at 1.0
-    const newWeight = Math.min(
-      1.0,
-      existing.weight + (1.0 - existing.weight) * config.learningRate,
-    );
-    repo.update(existing.id, {
-      weight: newWeight,
-      activation_count: existing.activation_count + 1,
-      last_activated_at: new Date().toISOString(),
-    });
-    return { ...existing, weight: newWeight, activation_count: existing.activation_count + 1 };
-  }
-
-  const id = repo.create({
-    source_type: source.type,
-    source_id: source.id,
-    target_type: target.type,
-    target_id: target.id,
-    synapse_type: synapseType,
-    weight: config.initialWeight,
-    metadata: context ? JSON.stringify(context) : null,
-  });
-
-  return repo.getById(id)!;
-}
-
-export function weaken(
-  repo: SynapseRepository,
-  synapseId: number,
-  config: HebbianConfig,
-  factor: number = 0.5,
-): void {
-  const synapse = repo.getById(synapseId);
-  if (!synapse) return;
-
-  const newWeight = synapse.weight * factor;
-  if (newWeight < config.pruneThreshold) {
-    repo.delete(synapseId);
-  } else {
-    repo.update(synapseId, { weight: newWeight });
-  }
-}
+import type { SynapseRecord, NodeType, SynapseType } from '../types/synapse.types.js';
+import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
+
+export interface HebbianConfig {
+  initialWeight: number;
+  learningRate: number;
+  pruneThreshold: number;
+}
+
+export interface NodeRef {
+  type: NodeType;
+  id: number;
+}
+
+export function strengthen(
+  repo: SynapseRepository,
+  source: NodeRef,
+  target: NodeRef,
+  synapseType: SynapseType,
+  config: HebbianConfig,
+  context?: Record<string, unknown>,
+): SynapseRecord {
+  const existing = repo.findBySourceTarget(
+    source.type, source.id, target.type, target.id, synapseType,
+  );
+
+  if (existing) {
+    // Hebbian: weight grows logarithmically, saturates at 1.0
+    const newWeight = Math.min(
+      1.0,
+      existing.weight + (1.0 - existing.weight) * config.learningRate,
+    );
+    repo.update(existing.id, {
+      weight: newWeight,
+      activation_count: existing.activation_count + 1,
+      last_activated_at: new Date().toISOString(),
+    });
+    return { ...existing, weight: newWeight, activation_count: existing.activation_count + 1 };
+  }
+
+  const id = repo.create({
+    source_type: source.type,
+    source_id: source.id,
+    target_type: target.type,
+    target_id: target.id,
+    synapse_type: synapseType,
+    weight: config.initialWeight,
+    metadata: context ? JSON.stringify(context) : null,
+  });
+
+  return repo.getById(id)!;
+}
+
+export function weaken(
+  repo: SynapseRepository,
+  synapseId: number,
+  config: HebbianConfig,
+  factor: number = 0.5,
+): void {
+  const synapse = repo.getById(synapseId);
+  if (!synapse) return;
+
+  const newWeight = synapse.weight * factor;
+  if (newWeight < config.pruneThreshold) {
+    repo.delete(synapseId);
+  } else {
+    repo.update(synapseId, { weight: newWeight });
+  }
+}

package/src/synapses/pathfinder.ts

@@ -1,81 +1,81 @@
-import type { NodeType, SynapseRecord } from '../types/synapse.types.js';
-import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
-
-export interface PathNode {
-  type: NodeType;
-  id: number;
-}
-
-export interface SynapsePath {
-  from: PathNode;
-  to: PathNode;
-  synapses: SynapseRecord[];
-  totalWeight: number;
-  hops: number;
-}
-
-export function findPath(
-  repo: SynapseRepository,
-  from: PathNode,
-  to: PathNode,
-  maxDepth: number = 5,
-): SynapsePath | null {
-  const visited = new Set<string>();
-
-  const queue: Array<{
-    node: PathNode;
-    path: SynapseRecord[];
-    totalWeight: number;
-  }> = [{ node: from, path: [], totalWeight: 1.0 }];
-
-  let bestPath: SynapsePath | null = null;
-
-  while (queue.length > 0) {
-    const current = queue.shift()!;
-    const key = `${current.node.type}:${current.node.id}`;
-
-    if (visited.has(key)) continue;
-    visited.add(key);
-
-    if (current.node.type === to.type && current.node.id === to.id) {
-      if (!bestPath || current.totalWeight > bestPath.totalWeight) {
-        bestPath = {
-          from,
-          to,
-          synapses: current.path,
-          totalWeight: current.totalWeight,
-          hops: current.path.length,
-        };
-      }
-      continue;
-    }
-
-    if (current.path.length >= maxDepth) continue;
-
-    const outgoing = repo.getOutgoing(current.node.type, current.node.id);
-    for (const synapse of outgoing) {
-      const targetKey = `${synapse.target_type}:${synapse.target_id}`;
-      if (!visited.has(targetKey)) {
-        queue.push({
-          node: { type: synapse.target_type, id: synapse.target_id },
-          path: [...current.path, synapse],
-          totalWeight: current.totalWeight * synapse.weight,
-        });
-      }
-    }
-
-    const incoming = repo.getIncoming(current.node.type, current.node.id);
-    for (const synapse of incoming) {
-      const sourceKey = `${synapse.source_type}:${synapse.source_id}`;
-      if (!visited.has(sourceKey)) {
-        queue.push({
-          node: { type: synapse.source_type, id: synapse.source_id },
-          path: [...current.path, synapse],
-          totalWeight: current.totalWeight * synapse.weight,
-        });
-      }
-    }
-  }
-
-  return bestPath;
-}
+import type { NodeType, SynapseRecord } from '../types/synapse.types.js';
+import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
+
+export interface PathNode {
+  type: NodeType;
+  id: number;
+}
+
+export interface SynapsePath {
+  from: PathNode;
+  to: PathNode;
+  synapses: SynapseRecord[];
+  totalWeight: number;
+  hops: number;
+}
+
+export function findPath(
+  repo: SynapseRepository,
+  from: PathNode,
+  to: PathNode,
+  maxDepth: number = 5,
+): SynapsePath | null {
+  const visited = new Set<string>();
+
+  const queue: Array<{
+    node: PathNode;
+    path: SynapseRecord[];
+    totalWeight: number;
+  }> = [{ node: from, path: [], totalWeight: 1.0 }];
+
+  let bestPath: SynapsePath | null = null;
+
+  while (queue.length > 0) {
+    const current = queue.shift()!;
+    const key = `${current.node.type}:${current.node.id}`;
+
+    if (visited.has(key)) continue;
+    visited.add(key);
+
+    if (current.node.type === to.type && current.node.id === to.id) {
+      if (!bestPath || current.totalWeight > bestPath.totalWeight) {
+        bestPath = {
+          from,
+          to,
+          synapses: current.path,
+          totalWeight: current.totalWeight,
+          hops: current.path.length,
+        };
+      }
+      continue;
+    }
+
+    if (current.path.length >= maxDepth) continue;
+
+    const outgoing = repo.getOutgoing(current.node.type, current.node.id);
+    for (const synapse of outgoing) {
+      const targetKey = `${synapse.target_type}:${synapse.target_id}`;
+      if (!visited.has(targetKey)) {
+        queue.push({
+          node: { type: synapse.target_type, id: synapse.target_id },
+          path: [...current.path, synapse],
+          totalWeight: current.totalWeight * synapse.weight,
+        });
+      }
+    }
+
+    const incoming = repo.getIncoming(current.node.type, current.node.id);
+    for (const synapse of incoming) {
+      const sourceKey = `${synapse.source_type}:${synapse.source_id}`;
+      if (!visited.has(sourceKey)) {
+        queue.push({
+          node: { type: synapse.source_type, id: synapse.source_id },
+          path: [...current.path, synapse],
+          totalWeight: current.totalWeight * synapse.weight,
+        });
+      }
+    }
+  }
+
+  return bestPath;
+}