@timmeck/brain 1.9.0 → 2.0.0

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>,
-    };
-  }
-}

package/src/types/code.types.ts

@@ -1,52 +0,0 @@
-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

@@ -1,103 +0,0 @@
-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;
-  crossProjectMatching: boolean;
-  crossProjectWeight: 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 ApiConfig {
-  port: number;
-  enabled: boolean;
-  apiKey?: string;
-}
-
-export interface McpHttpConfig {
-  port: number;
-  enabled: boolean;
-}
-
-export interface EmbeddingsConfig {
-  enabled: boolean;
-  modelName: string;
-  cacheDir: string;
-  sweepIntervalMs: number;
-  batchSize: number;
-}
-
-export interface BrainConfig {
-  dataDir: string;
-  dbPath: string;
-  ipc: IpcConfig;
-  api: ApiConfig;
-  mcpHttp: McpHttpConfig;
-  embeddings: EmbeddingsConfig;
-  learning: LearningConfig;
-  terminal: TerminalConfig;
-  matching: MatchingConfig;
-  code: CodeConfig;
-  synapses: SynapsesConfig;
-  research: ResearchConfig;
-  log: LogConfig;
-  retention: RetentionConfig;
-}

package/src/types/error.types.ts

@@ -1,67 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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

@@ -1,53 +0,0 @@
-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

@@ -1,28 +0,0 @@
-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

@@ -1,30 +0,0 @@
-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

@@ -1,50 +0,0 @@
-export type NodeType = 'error' | 'solution' | 'code_module' | 'rule' | 'antipattern' | 'project' | 'insight';
-
-export type SynapseType =
-  | 'solves'
-  | 'causes'
-  | 'similar_to'
-  | 'uses_module'
-  | 'depends_on'
-  | '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>;
-}