@timmeck/brain 1.8.5 → 2.0.0

package/src/services/solution.service.ts

@@ -1,174 +0,0 @@
-import type { SolutionRecord } from '../types/solution.types.js';
-import type { SolutionRepository } from '../db/repositories/solution.repository.js';
-import type { SynapseManager } from '../synapses/synapse-manager.js';
-import { getEventBus } from '../utils/events.js';
-import { getLogger } from '../utils/logger.js';
-
-export interface ReportSolutionInput {
-  errorId: number;
-  description: string;
-  commands?: string;
-  codeChange?: string;
-  source?: string;
-}
-
-export interface RateOutcomeInput {
-  errorId: number;
-  solutionId: number;
-  success: boolean;
-  terminalId?: number;
-  output?: string;
-  durationMs?: number;
-}
-
-export class SolutionService {
-  private logger = getLogger();
-  private eventBus = getEventBus();
-
-  constructor(
-    private solutionRepo: SolutionRepository,
-    private synapseManager: SynapseManager,
-  ) {}
-
-  report(input: ReportSolutionInput): number {
-    const solutionId = this.solutionRepo.create({
-      description: input.description,
-      commands: input.commands ?? null,
-      code_change: input.codeChange ?? null,
-      source: input.source ?? 'manual',
-      confidence: 0.5,
-    });
-
-    this.solutionRepo.linkToError(input.errorId, solutionId);
-
-    // Create synapse: solution solves error
-    this.synapseManager.strengthen(
-      { type: 'solution', id: solutionId },
-      { type: 'error', id: input.errorId },
-      'solves',
-    );
-
-    this.eventBus.emit('solution:created', { solutionId });
-    this.logger.info(`Solution reported (id=${solutionId}) for error ${input.errorId}`);
-
-    return solutionId;
-  }
-
-  rateOutcome(input: RateOutcomeInput): void {
-    // Record the attempt
-    const errorSolutions = this.solutionRepo.findForError(input.errorId);
-    const link = errorSolutions.find(s => s.id === input.solutionId);
-    if (!link) {
-      this.solutionRepo.linkToError(input.errorId, input.solutionId);
-    }
-
-    // Find the error_solution link id via DB
-    this.solutionRepo.recordAttempt({
-      errorSolutionId: input.errorId, // will be resolved via link
-      terminalId: input.terminalId,
-      success: input.success ? 1 : 0,
-      output: input.output,
-      durationMs: input.durationMs,
-    });
-
-    // Update synapse
-    if (input.success) {
-      this.synapseManager.strengthen(
-        { type: 'solution', id: input.solutionId },
-        { type: 'error', id: input.errorId },
-        'solves',
-        { outcome: 'success' },
-      );
-      // Update solution confidence based on success rate
-      const rate = this.solutionRepo.successRate(input.solutionId);
-      this.solutionRepo.update(input.solutionId, { confidence: rate });
-    } else {
-      const synapse = this.synapseManager.find(
-        { type: 'solution', id: input.solutionId },
-        { type: 'error', id: input.errorId },
-        'solves',
-      );
-      if (synapse) {
-        this.synapseManager.weaken(synapse.id, 0.7);
-      }
-      const rate = this.solutionRepo.successRate(input.solutionId);
-      this.solutionRepo.update(input.solutionId, { confidence: rate });
-    }
-
-    this.eventBus.emit('solution:applied', {
-      errorId: input.errorId,
-      solutionId: input.solutionId,
-      success: input.success,
-    });
-  }
-
-  findForError(errorId: number): SolutionRecord[] {
-    return this.solutionRepo.findForError(errorId);
-  }
-
-  getById(id: number): SolutionRecord | undefined {
-    return this.solutionRepo.getById(id);
-  }
-
-  successRate(solutionId: number): number {
-    return this.solutionRepo.successRate(solutionId);
-  }
-
-  analyzeEfficiency(): {
-    avgDurationMs: number;
-    slowSolutions: Array<{ solutionId: number; avgDuration: number; description: string }>;
-    successRateOverall: number;
-    totalAttempts: number;
-  } {
-    const allSolutions = this.solutionRepo.getAll();
-    let totalDuration = 0;
-    let totalAttempts = 0;
-    let totalSuccessRate = 0;
-    let solutionCount = 0;
-    const solutionDurations: Array<{ solutionId: number; avgDuration: number; description: string }> = [];
-
-    for (const solution of allSolutions) {
-      const rate = this.solutionRepo.successRate(solution.id);
-      if (solution.success_count + solution.fail_count > 0) {
-        totalSuccessRate += rate;
-        solutionCount++;
-      }
-
-      // Check attempts for duration data
-      const attempts = this.solutionRepo.getAttempts(solution.id);
-      if (attempts.length > 0) {
-        let solDuration = 0;
-        let solAttemptCount = 0;
-        for (const attempt of attempts) {
-          if (attempt.duration_ms && attempt.duration_ms > 0) {
-            solDuration += attempt.duration_ms;
-            solAttemptCount++;
-            totalDuration += attempt.duration_ms;
-            totalAttempts++;
-          }
-        }
-        if (solAttemptCount > 0) {
-          solutionDurations.push({
-            solutionId: solution.id,
-            avgDuration: solDuration / solAttemptCount,
-            description: solution.description,
-          });
-        }
-      }
-    }
-
-    // Find slow solutions (above 2x average)
-    const avgDurationMs = totalAttempts > 0 ? totalDuration / totalAttempts : 0;
-    const slowSolutions = solutionDurations
-      .filter(s => s.avgDuration > avgDurationMs * 2)
-      .sort((a, b) => b.avgDuration - a.avgDuration)
-      .slice(0, 10);
-
-    return {
-      avgDurationMs,
-      slowSolutions,
-      successRateOverall: solutionCount > 0 ? totalSuccessRate / solutionCount : 0,
-      totalAttempts,
-    };
-  }
-}

package/src/services/synapse.service.ts

@@ -1,59 +0,0 @@
-import type { NodeType, SynapseRecord, NetworkStats } from '../types/synapse.types.js';
-import type { SynapseManager } from '../synapses/synapse-manager.js';
-import type { ActivationResult } from '../synapses/activation.js';
-import type { SynapsePath } from '../synapses/pathfinder.js';
-
-export interface ErrorContext {
-  solutions: ActivationResult[];
-  relatedErrors: ActivationResult[];
-  relevantModules: ActivationResult[];
-  preventionRules: ActivationResult[];
-  insights: ActivationResult[];
-}
-
-export interface RelatedQuery {
-  nodeType: NodeType;
-  nodeId: number;
-  maxDepth?: number;
-  minWeight?: number;
-}
-
-export class SynapseService {
-  constructor(private manager: SynapseManager) {}
-
-  getErrorContext(errorId: number): ErrorContext {
-    return this.manager.getErrorContext(errorId);
-  }
-
-  findPath(
-    fromType: NodeType,
-    fromId: number,
-    toType: NodeType,
-    toId: number,
-  ): SynapsePath | null {
-    return this.manager.findPath(
-      { type: fromType, id: fromId },
-      { type: toType, id: toId },
-    );
-  }
-
-  getRelated(query: RelatedQuery): ActivationResult[] {
-    return this.manager.activate(
-      { type: query.nodeType, id: query.nodeId },
-      query.maxDepth,
-      query.minWeight,
-    );
-  }
-
-  getNetworkStats(): NetworkStats {
-    return this.manager.getNetworkStats();
-  }
-
-  getStrongestSynapses(limit?: number): SynapseRecord[] {
-    return this.manager.getStrongestSynapses(limit);
-  }
-
-  runDecay(): { decayed: number; pruned: number } {
-    return this.manager.runDecay();
-  }
-}

package/src/services/terminal.service.ts

@@ -1,81 +0,0 @@
-import type { TerminalRepository } from '../db/repositories/terminal.repository.js';
-import { getEventBus } from '../utils/events.js';
-import { getLogger } from '../utils/logger.js';
-
-export interface RegisterTerminalInput {
-  uuid: string;
-  projectId?: number;
-  pid?: number;
-  shell?: string;
-  cwd?: string;
-}
-
-export class TerminalService {
-  private logger = getLogger();
-  private eventBus = getEventBus();
-
-  constructor(
-    private terminalRepo: TerminalRepository,
-    private staleTimeout: number,
-  ) {}
-
-  register(input: RegisterTerminalInput): number {
-    const existing = this.terminalRepo.findByUuid(input.uuid);
-    if (existing) {
-      this.terminalRepo.update(existing.id, {
-        last_seen: new Date().toISOString(),
-        disconnected_at: null,
-        project_id: input.projectId ?? existing.project_id,
-        cwd: input.cwd ?? existing.cwd,
-      });
-      this.logger.info(`Terminal reconnected (id=${existing.id}, uuid=${input.uuid})`);
-      this.eventBus.emit('terminal:connected', { terminalId: existing.id, uuid: input.uuid });
-      return existing.id;
-    }
-
-    const id = this.terminalRepo.create({
-      uuid: input.uuid,
-      project_id: input.projectId ?? null,
-      pid: input.pid ?? null,
-      shell: input.shell ?? null,
-      cwd: input.cwd ?? null,
-    });
-
-    this.logger.info(`Terminal registered (id=${id}, uuid=${input.uuid})`);
-    this.eventBus.emit('terminal:connected', { terminalId: id, uuid: input.uuid });
-    return id;
-  }
-
-  heartbeat(uuid: string): void {
-    const terminal = this.terminalRepo.findByUuid(uuid);
-    if (terminal) {
-      this.terminalRepo.update(terminal.id, {
-        last_seen: new Date().toISOString(),
-      });
-    }
-  }
-
-  disconnect(uuid: string): void {
-    const terminal = this.terminalRepo.findByUuid(uuid);
-    if (terminal) {
-      this.terminalRepo.update(terminal.id, {
-        disconnected_at: new Date().toISOString(),
-      });
-      this.eventBus.emit('terminal:disconnected', { terminalId: terminal.id });
-      this.logger.info(`Terminal disconnected (id=${terminal.id}, uuid=${uuid})`);
-    }
-  }
-
-  cleanup(): number {
-    const cutoff = new Date(Date.now() - this.staleTimeout).toISOString();
-    const count = this.terminalRepo.cleanupStale(cutoff);
-    if (count > 0) {
-      this.logger.info(`Cleaned up ${count} stale terminal(s)`);
-    }
-    return count;
-  }
-
-  getConnected() {
-    return this.terminalRepo.findConnected();
-  }
-}

package/src/synapses/activation.ts

@@ -1,80 +0,0 @@
-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 +0,0 @@
-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 +0,0 @@
-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 +0,0 @@
-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;
-}

package/src/synapses/synapse-manager.ts

@@ -1,113 +0,0 @@
-import type { SynapsesConfig } from '../types/config.types.js';
-import type { NodeType, SynapseType, SynapseRecord, NetworkStats } from '../types/synapse.types.js';
-import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
-import { strengthen, weaken, type NodeRef } from './hebbian.js';
-import { decayAll } from './decay.js';
-import { spreadingActivation, type ActivationResult } from './activation.js';
-import { findPath, type SynapsePath } from './pathfinder.js';
-import { getLogger } from '../utils/logger.js';
-
-export class SynapseManager {
-  private logger = getLogger();
-
-  constructor(
-    private repo: SynapseRepository,
-    private config: SynapsesConfig,
-  ) {}
-
-  strengthen(
-    source: NodeRef,
-    target: NodeRef,
-    synapseType: SynapseType,
-    context?: Record<string, unknown>,
-  ): SynapseRecord {
-    this.logger.debug(`Strengthening synapse ${source.type}:${source.id} --${synapseType}--> ${target.type}:${target.id}`);
-    return strengthen(this.repo, source, target, synapseType, {
-      initialWeight: this.config.initialWeight,
-      learningRate: this.config.learningRate,
-      pruneThreshold: this.config.pruneThreshold,
-    }, context);
-  }
-
-  weaken(synapseId: number, factor: number = 0.5): void {
-    this.logger.debug(`Weakening synapse ${synapseId} by factor ${factor}`);
-    weaken(this.repo, synapseId, {
-      initialWeight: this.config.initialWeight,
-      learningRate: this.config.learningRate,
-      pruneThreshold: this.config.pruneThreshold,
-    }, factor);
-  }
-
-  find(
-    source: NodeRef,
-    target: NodeRef,
-    synapseType: SynapseType,
-  ): SynapseRecord | undefined {
-    return this.repo.findBySourceTarget(
-      source.type, source.id, target.type, target.id, synapseType,
-    );
-  }
-
-  activate(
-    startNode: NodeRef,
-    maxDepth?: number,
-    minWeight?: number,
-  ): ActivationResult[] {
-    return spreadingActivation(
-      this.repo,
-      startNode,
-      maxDepth ?? this.config.maxDepth,
-      minWeight ?? this.config.minActivationWeight,
-    );
-  }
-
-  findPath(from: NodeRef, to: NodeRef, maxDepth?: number): SynapsePath | null {
-    return findPath(this.repo, from, to, maxDepth ?? this.config.maxDepth + 2);
-  }
-
-  runDecay(): { decayed: number; pruned: number } {
-    this.logger.info('Running synapse decay cycle');
-    const result = decayAll(this.repo, {
-      decayHalfLifeDays: this.config.decayHalfLifeDays,
-      decayAfterDays: this.config.decayAfterDays,
-      pruneThreshold: this.config.pruneThreshold,
-    });
-    this.logger.info(`Decay complete: ${result.decayed} decayed, ${result.pruned} pruned`);
-    return result;
-  }
-
-  getErrorContext(errorId: number): {
-    solutions: ActivationResult[];
-    relatedErrors: ActivationResult[];
-    relevantModules: ActivationResult[];
-    preventionRules: ActivationResult[];
-    insights: ActivationResult[];
-  } {
-    const all = this.activate({ type: 'error', id: errorId });
-    return {
-      solutions: all.filter(a => a.node.type === 'solution'),
-      relatedErrors: all.filter(a => a.node.type === 'error'),
-      relevantModules: all.filter(a => a.node.type === 'code_module'),
-      preventionRules: all.filter(a => a.node.type === 'rule'),
-      insights: all.filter(a => a.node.type === 'insight'),
-    };
-  }
-
-  getStrongestSynapses(limit: number = 20): SynapseRecord[] {
-    return this.repo.topByWeight(limit);
-  }
-
-  getDiverseSynapses(perType: number = 25): SynapseRecord[] {
-    return this.repo.topDiverse(perType);
-  }
-
-  getNetworkStats(): NetworkStats {
-    return {
-      totalNodes: this.repo.countNodes(),
-      totalSynapses: this.repo.totalCount(),
-      avgWeight: this.repo.avgWeight(),
-      nodesByType: {} as Record<NodeType, number>,
-      synapsesByType: this.repo.countByType() as Record<SynapseType, number>,
-    };
-  }
-}