@timmeck/brain 1.0.0

package/src/synapses/pathfinder.ts

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

package/src/synapses/synapse-manager.ts

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

package/src/types/code.types.ts

@@ -0,0 +1,52 @@
+export interface CodeModuleRecord {
+  id: number;
+  project_id: number;
+  name: string;
+  file_path: string;
+  language: string;
+  fingerprint: string;
+  description: string | null;
+  source_hash: string;
+  lines_of_code: number;
+  complexity: number | null;
+  reusability_score: number;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface ModuleUsage {
+  id: number;
+  module_id: number;
+  used_in_project_id: number;
+  used_in_file: string;
+  usage_type: string;
+  first_used: string;
+  last_used: string;
+}
+
+export interface ModuleSimilarity {
+  id: number;
+  module_a_id: number;
+  module_b_id: number;
+  similarity_score: number;
+  computed_at: string;
+}
+
+export interface CodeUnit {
+  name: string;
+  filePath: string;
+  language: string;
+  source: string;
+  exports: ExportInfo[];
+}
+
+export interface ExportInfo {
+  name: string;
+  type: 'function' | 'class' | 'constant' | 'type' | 'interface' | 'variable';
+}
+
+export interface ReusabilitySignal {
+  name: string;
+  score: number;
+  reason: string;
+}

package/src/types/config.types.ts

@@ -0,0 +1,79 @@
+export interface IpcConfig {
+  pipeName: string;
+  timeout: number;
+}
+
+export interface LearningConfig {
+  intervalMs: number;
+  minOccurrences: number;
+  minSuccessRate: number;
+  minConfidence: number;
+  pruneThreshold: number;
+  maxRejectionRate: number;
+  decayHalfLifeDays: number;
+}
+
+export interface TerminalConfig {
+  staleTimeout: number;
+  maxConnected: number;
+}
+
+export interface MatchingConfig {
+  fingerprintFields: string[];
+  similarityThreshold: number;
+  maxResults: number;
+}
+
+export interface CodeConfig {
+  supportedLanguages: string[];
+  maxModuleSize: number;
+  similarityThreshold: number;
+}
+
+export interface SynapsesConfig {
+  initialWeight: number;
+  learningRate: number;
+  decayHalfLifeDays: number;
+  pruneThreshold: number;
+  decayAfterDays: number;
+  maxDepth: number;
+  minActivationWeight: number;
+}
+
+export interface ResearchConfig {
+  intervalMs: number;
+  initialDelayMs: number;
+  minDataPoints: number;
+  trendWindowDays: number;
+  gapMinOccurrences: number;
+  synergyMinWeight: number;
+  templateMinAdaptations: number;
+  insightExpiryDays: number;
+}
+
+export interface LogConfig {
+  level: string;
+  file: string;
+  maxSize: number;
+  maxFiles: number;
+}
+
+export interface RetentionConfig {
+  errorDays: number;
+  solutionDays: number;
+  insightDays: number;
+}
+
+export interface BrainConfig {
+  dataDir: string;
+  dbPath: string;
+  ipc: IpcConfig;
+  learning: LearningConfig;
+  terminal: TerminalConfig;
+  matching: MatchingConfig;
+  code: CodeConfig;
+  synapses: SynapsesConfig;
+  research: ResearchConfig;
+  log: LogConfig;
+  retention: RetentionConfig;
+}

package/src/types/error.types.ts

@@ -0,0 +1,67 @@
+export interface ErrorRecord {
+  id: number;
+  project_id: number;
+  terminal_id: number | null;
+  fingerprint: string;
+  type: string;
+  message: string;
+  raw_output: string;
+  context: string | null;
+  file_path: string | null;
+  line_number: number | null;
+  column_number: number | null;
+  occurrence_count: number;
+  first_seen: string;
+  last_seen: string;
+  resolved: number;
+  resolved_at: string | null;
+}
+
+export interface StackFrame {
+  file: string;
+  line: number;
+  column: number | null;
+  function_name: string | null;
+  source: string | null;
+}
+
+export interface ParsedError {
+  type: string;
+  message: string;
+  fingerprint: string;
+  stackFrames: StackFrame[];
+  filePath: string | null;
+  lineNumber: number | null;
+  columnNumber: number | null;
+  context: string | null;
+}
+
+export interface ErrorParser {
+  name: string;
+  canParse(raw: string): boolean;
+  parse(raw: string): ParsedError | null;
+}
+
+export interface MatchSignal {
+  field: string;
+  similarity: number;
+  weight: number;
+}
+
+export interface MatchResult {
+  errorId: number;
+  score: number;
+  signals: MatchSignal[];
+}
+
+export interface ErrorSolutionPair {
+  error: ErrorRecord;
+  solutionIds: number[];
+}
+
+export interface Pattern {
+  type: string;
+  message: string;
+  count: number;
+  lastSeen: string;
+}

package/src/types/ipc.types.ts

@@ -0,0 +1,8 @@
+export interface IpcMessage {
+  id: string;
+  type: 'request' | 'response' | 'notification';
+  method?: string;
+  params?: unknown;
+  result?: unknown;
+  error?: { code: number; message: string };
+}

package/src/types/mcp.types.ts

@@ -0,0 +1,53 @@
+export interface HookInput {
+  tool: string;
+  arguments: Record<string, unknown>;
+}
+
+export interface ReportErrorParams {
+  project: string;
+  error_output: string;
+  file_path?: string;
+  terminal_id?: string;
+}
+
+export interface GetSolutionsParams {
+  error_output?: string;
+  error_id?: number;
+  project?: string;
+}
+
+export interface ApplySolutionParams {
+  error_id: number;
+  solution_id: number;
+  terminal_id?: string;
+}
+
+export interface RegisterModuleParams {
+  project: string;
+  name: string;
+  file_path: string;
+  language: string;
+  source: string;
+  description?: string;
+}
+
+export interface SearchModulesParams {
+  query: string;
+  language?: string;
+  project?: string;
+  limit?: number;
+}
+
+export interface GetInsightsParams {
+  project?: string;
+  type?: string;
+  active_only?: boolean;
+  limit?: number;
+}
+
+export interface GetNetworkParams {
+  node_type: string;
+  node_id: number;
+  depth?: number;
+  min_weight?: number;
+}

package/src/types/research.types.ts

@@ -0,0 +1,28 @@
+export type InsightType = 'pattern' | 'correlation' | 'suggestion' | 'warning' | 'optimization' | 'trend' | 'gap' | 'synergy' | 'template_candidate' | 'project_suggestion';
+
+export interface InsightRecord {
+  id: number;
+  type: InsightType;
+  title: string;
+  description: string;
+  evidence: string;
+  priority: number;
+  project_id: number | null;
+  active: number;
+  expires_at: string | null;
+  created_at: string;
+}
+
+export interface ResearchCycleResult {
+  insightsGenerated: number;
+  patternsFound: number;
+  correlationsFound: number;
+  duration: number;
+}
+
+export interface ProjectTemplateSuggestion {
+  name: string;
+  description: string;
+  basedOn: string[];
+  confidence: number;
+}

package/src/types/solution.types.ts

@@ -0,0 +1,30 @@
+export interface SolutionRecord {
+  id: number;
+  description: string;
+  commands: string | null;
+  code_change: string | null;
+  source: string;
+  confidence: number;
+  success_count: number;
+  fail_count: number;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface ErrorSolution {
+  id: number;
+  error_id: number;
+  solution_id: number;
+  applied_at: string | null;
+  success: number | null;
+}
+
+export interface SolutionAttempt {
+  id: number;
+  error_solution_id: number;
+  terminal_id: number | null;
+  attempted_at: string;
+  success: number;
+  output: string | null;
+  duration_ms: number | null;
+}

package/src/types/synapse.types.ts

@@ -0,0 +1,49 @@
+export type NodeType = 'error' | 'solution' | 'code_module' | 'rule' | 'antipattern' | 'project' | 'insight';
+
+export type SynapseType =
+  | 'solves'
+  | 'causes'
+  | 'similar_to'
+  | 'uses_module'
+  | 'derived_from'
+  | 'co_occurs'
+  | 'prevents'
+  | 'improves'
+  | 'generalizes'
+  | 'cross_project';
+
+export interface SynapseRecord {
+  id: number;
+  source_type: NodeType;
+  source_id: number;
+  target_type: NodeType;
+  target_id: number;
+  synapse_type: SynapseType;
+  weight: number;
+  activation_count: number;
+  last_activated_at: string;
+  metadata: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface ActivationResult {
+  nodeType: NodeType;
+  nodeId: number;
+  activationStrength: number;
+  path: SynapsePath;
+}
+
+export interface SynapsePath {
+  nodes: Array<{ type: NodeType; id: number }>;
+  totalWeight: number;
+  hops: number;
+}
+
+export interface NetworkStats {
+  totalNodes: number;
+  totalSynapses: number;
+  avgWeight: number;
+  nodesByType: Record<NodeType, number>;
+  synapsesByType: Record<SynapseType, number>;
+}

package/src/utils/events.ts

@@ -0,0 +1,45 @@
+import { EventEmitter } from 'node:events';
+
+export interface BrainEvents {
+  'error:reported': { errorId: number; projectId: number; fingerprint: string };
+  'error:resolved': { errorId: number; solutionId: number };
+  'solution:applied': { errorId: number; solutionId: number; success: boolean };
+  'solution:created': { solutionId: number };
+  'module:registered': { moduleId: number; projectId: number };
+  'module:updated': { moduleId: number };
+  'synapse:created': { synapseId: number; sourceType: string; targetType: string };
+  'synapse:strengthened': { synapseId: number; newWeight: number };
+  'insight:created': { insightId: number; type: string };
+  'rule:learned': { ruleId: number; pattern: string };
+  'terminal:connected': { terminalId: number; uuid: string };
+  'terminal:disconnected': { terminalId: number };
+}
+
+export type BrainEventName = keyof BrainEvents;
+
+export class TypedEventBus extends EventEmitter {
+  emit<K extends BrainEventName>(event: K, data: BrainEvents[K]): boolean {
+    return super.emit(event, data);
+  }
+
+  on<K extends BrainEventName>(event: K, listener: (data: BrainEvents[K]) => void): this {
+    return super.on(event, listener);
+  }
+
+  once<K extends BrainEventName>(event: K, listener: (data: BrainEvents[K]) => void): this {
+    return super.once(event, listener);
+  }
+
+  off<K extends BrainEventName>(event: K, listener: (data: BrainEvents[K]) => void): this {
+    return super.off(event, listener);
+  }
+}
+
+let busInstance: TypedEventBus | null = null;
+
+export function getEventBus(): TypedEventBus {
+  if (!busInstance) {
+    busInstance = new TypedEventBus();
+  }
+  return busInstance;
+}

package/src/utils/hash.ts

@@ -0,0 +1,5 @@
+import { createHash } from 'node:crypto';
+
+export function sha256(input: string): string {
+  return createHash('sha256').update(input).digest('hex');
+}

package/src/utils/logger.ts

@@ -0,0 +1,48 @@
+import winston from 'winston';
+import path from 'node:path';
+import { getDataDir } from './paths.js';
+
+const { combine, timestamp, printf, colorize } = winston.format;
+
+const logFormat = printf(({ level, message, timestamp, ...meta }) => {
+  const metaStr = Object.keys(meta).length ? ` ${JSON.stringify(meta)}` : '';
+  return `${timestamp} [${level}]${metaStr} ${message}`;
+});
+
+let loggerInstance: winston.Logger | null = null;
+
+export function createLogger(opts?: { level?: string; file?: string; maxSize?: number; maxFiles?: number }): winston.Logger {
+  if (loggerInstance) return loggerInstance;
+
+  const level = opts?.level ?? process.env['BRAIN_LOG_LEVEL'] ?? 'info';
+  const logFile = opts?.file ?? path.join(getDataDir(), 'brain.log');
+  const maxSize = opts?.maxSize ?? 10 * 1024 * 1024; // 10MB
+  const maxFiles = opts?.maxFiles ?? 3;
+
+  const transports: winston.transport[] = [
+    new winston.transports.File({
+      filename: logFile,
+      maxsize: maxSize,
+      maxFiles,
+      format: combine(timestamp(), logFormat),
+    }),
+  ];
+
+  if (process.env['NODE_ENV'] !== 'production') {
+    transports.push(
+      new winston.transports.Console({
+        format: combine(colorize(), timestamp(), logFormat),
+      })
+    );
+  }
+
+  loggerInstance = winston.createLogger({ level, transports });
+  return loggerInstance;
+}
+
+export function getLogger(): winston.Logger {
+  if (!loggerInstance) {
+    return createLogger();
+  }
+  return loggerInstance;
+}

package/src/utils/paths.ts

@@ -0,0 +1,19 @@
+import path from 'node:path';
+import os from 'node:os';
+
+export function normalizePath(filePath: string): string {
+  return filePath.replace(/\\/g, '/');
+}
+
+export function getDataDir(): string {
+  const envDir = process.env['BRAIN_DATA_DIR'];
+  if (envDir) return path.resolve(envDir);
+  return path.join(os.homedir(), '.brain');
+}
+
+export function getPipeName(name: string = 'brain'): string {
+  if (process.platform === 'win32') {
+    return `\\\\.\\pipe\\${name}`;
+  }
+  return path.join(os.tmpdir(), `${name}.sock`);
+}