@timmeck/brain 1.0.0 → 1.1.0

package/src/learning/decay.ts

@@ -1,46 +1,46 @@
-import type { SolutionRepository } from '../db/repositories/solution.repository.js';
-import { wilsonScore } from './confidence-scorer.js';
-
-/**
- * Update confidence scores for all solutions based on their attempt history.
- */
-export function updateSolutionConfidences(solutionRepo: SolutionRepository): number {
-  const solutions = solutionRepo.getAll();
-  let updated = 0;
-
-  for (const sol of solutions) {
-    const total = sol.success_count + sol.fail_count;
-    if (total === 0) continue;
-
-    const newConfidence = wilsonScore(sol.success_count, total);
-    if (Math.abs(newConfidence - sol.confidence) > 0.001) {
-      solutionRepo.update(sol.id, { confidence: newConfidence });
-      updated++;
-    }
-  }
-
-  return updated;
-}
-
-/**
- * Compute relevance decay factor for a timestamp.
- */
-export function relevanceDecay(timestamp: string, halfLifeDays: number): number {
-  const ageDays = (Date.now() - new Date(timestamp).getTime()) / (1000 * 60 * 60 * 24);
-  return Math.pow(0.5, ageDays / halfLifeDays);
-}
-
-/**
- * Determine if a rule should be pruned based on its performance.
- */
-export function shouldPruneRule(
-  confidence: number,
-  rejectionCount: number,
-  totalUsage: number,
-  pruneThreshold: number,
-  maxRejectionRate: number,
-): boolean {
-  if (confidence < pruneThreshold) return true;
-  if (totalUsage > 0 && rejectionCount / totalUsage > maxRejectionRate) return true;
-  return false;
-}
+import type { SolutionRepository } from '../db/repositories/solution.repository.js';
+import { wilsonScore } from './confidence-scorer.js';
+
+/**
+ * Update confidence scores for all solutions based on their attempt history.
+ */
+export function updateSolutionConfidences(solutionRepo: SolutionRepository): number {
+  const solutions = solutionRepo.getAll();
+  let updated = 0;
+
+  for (const sol of solutions) {
+    const total = sol.success_count + sol.fail_count;
+    if (total === 0) continue;
+
+    const newConfidence = wilsonScore(sol.success_count, total);
+    if (Math.abs(newConfidence - sol.confidence) > 0.001) {
+      solutionRepo.update(sol.id, { confidence: newConfidence });
+      updated++;
+    }
+  }
+
+  return updated;
+}
+
+/**
+ * Compute relevance decay factor for a timestamp.
+ */
+export function relevanceDecay(timestamp: string, halfLifeDays: number): number {
+  const ageDays = (Date.now() - new Date(timestamp).getTime()) / (1000 * 60 * 60 * 24);
+  return Math.pow(0.5, ageDays / halfLifeDays);
+}
+
+/**
+ * Determine if a rule should be pruned based on its performance.
+ */
+export function shouldPruneRule(
+  confidence: number,
+  rejectionCount: number,
+  totalUsage: number,
+  pruneThreshold: number,
+  maxRejectionRate: number,
+): boolean {
+  if (confidence < pruneThreshold) return true;
+  if (totalUsage > 0 && rejectionCount / totalUsage > maxRejectionRate) return true;
+  return false;
+}

package/src/learning/learning-engine.ts

@@ -1,162 +1,162 @@
-import type { LearningConfig } from '../types/config.types.js';
-import type { ErrorRepository } from '../db/repositories/error.repository.js';
-import type { SolutionRepository } from '../db/repositories/solution.repository.js';
-import type { RuleRepository } from '../db/repositories/rule.repository.js';
-import type { AntipatternRepository } from '../db/repositories/antipattern.repository.js';
-import type { SynapseManager } from '../synapses/synapse-manager.js';
-import { extractPatterns } from './pattern-extractor.js';
-import { generateRules, persistRules } from './rule-generator.js';
-import { shouldPruneRule } from './decay.js';
-import { getLogger } from '../utils/logger.js';
-
-export interface LearningCycleResult {
-  newPatterns: number;
-  updatedRules: number;
-  prunedRules: number;
-  newAntipatterns: number;
-  duration: number;
-}
-
-export class LearningEngine {
-  private timer: ReturnType<typeof setInterval> | null = null;
-  private logger = getLogger();
-  private lastCycleAt: string | null = null;
-
-  constructor(
-    private config: LearningConfig,
-    private errorRepo: ErrorRepository,
-    private solutionRepo: SolutionRepository,
-    private ruleRepo: RuleRepository,
-    private antipatternRepo: AntipatternRepository,
-    private synapseManager: SynapseManager,
-  ) {}
-
-  start(): void {
-    this.logger.info(`Learning engine starting (interval: ${this.config.intervalMs}ms)`);
-    this.timer = setInterval(() => this.runCycle(), this.config.intervalMs);
-  }
-
-  stop(): void {
-    if (this.timer) {
-      clearInterval(this.timer);
-      this.timer = null;
-    }
-    this.logger.info('Learning engine stopped');
-  }
-
-  runCycle(): LearningCycleResult {
-    const start = Date.now();
-    this.logger.info('Learning cycle starting');
-
-    const result: LearningCycleResult = {
-      newPatterns: 0,
-      updatedRules: 0,
-      prunedRules: 0,
-      newAntipatterns: 0,
-      duration: 0,
-    };
-
-    // Phase 1: Collect recent errors
-    const since = this.lastCycleAt ?? new Date(Date.now() - this.config.intervalMs).toISOString();
-    const recentErrors = this.errorRepo.findUnresolved();
-
-    // Phase 2: Extract patterns
-    const patterns = extractPatterns(recentErrors, 0.7);
-    result.newPatterns = patterns.length;
-
-    // Phase 3: Enrich patterns with solution data
-    for (const pattern of patterns) {
-      let totalSuccess = 0;
-      let totalAttempts = 0;
-
-      for (const errorId of pattern.errorIds) {
-        const solutions = this.solutionRepo.findForError(errorId);
-        pattern.solutionIds.push(...solutions.map(s => s.id));
-
-        for (const sol of solutions) {
-          const rate = this.solutionRepo.successRate(sol.id);
-          totalSuccess += rate;
-          totalAttempts++;
-        }
-      }
-
-      pattern.successRate = totalAttempts > 0 ? totalSuccess / totalAttempts : 0;
-      pattern.confidence = Math.min(
-        0.95,
-        pattern.successRate * 0.6 + Math.min(1, pattern.occurrences / 10) * 0.4,
-      );
-    }
-
-    // Phase 4: Generate rules from patterns
-    const rules = generateRules(patterns, this.config);
-    result.updatedRules = persistRules(rules, this.ruleRepo);
-
-    // Phase 5: Prune weak rules
-    const activeRules = this.ruleRepo.findActive();
-    for (const rule of activeRules) {
-      if (shouldPruneRule(
-        rule.confidence,
-        0, // rejection count not tracked yet
-        rule.occurrences,
-        this.config.pruneThreshold,
-        this.config.maxRejectionRate,
-      )) {
-        this.ruleRepo.update(rule.id, { active: 0 });
-        result.prunedRules++;
-      }
-    }
-
-    // Phase 6: Detect antipatterns
-    result.newAntipatterns = this.detectAntipatterns();
-
-    // Phase 7: Run synapse decay
-    this.synapseManager.runDecay();
-
-    this.lastCycleAt = new Date().toISOString();
-    result.duration = Date.now() - start;
-    this.logger.info(`Learning cycle complete: ${result.newPatterns} patterns, ${result.updatedRules} rules, ${result.prunedRules} pruned, ${result.newAntipatterns} antipatterns (${result.duration}ms)`);
-
-    return result;
-  }
-
-  private detectAntipatterns(): number {
-    const unresolvedErrors = this.errorRepo.findUnresolved();
-    const recurring = unresolvedErrors.filter(e => e.occurrence_count >= this.config.minOccurrences);
-    let count = 0;
-
-    for (const error of recurring) {
-      const solutions = this.solutionRepo.findForError(error.id);
-      const allFailed = solutions.length > 0 && solutions.every(s => {
-        const rate = this.solutionRepo.successRate(s.id);
-        return rate < 0.3;
-      });
-
-      if (solutions.length >= 2 && allFailed) {
-        // Check if antipattern already exists
-        const existing = this.antipatternRepo.findByProject(error.project_id);
-        const alreadyDetected = existing.some(ap =>
-          ap.pattern.includes(error.type) && ap.description.includes(error.message.substring(0, 30))
-        );
-
-        if (!alreadyDetected) {
-          this.antipatternRepo.create({
-            pattern: `${error.type}.*${error.message.substring(0, 40).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`,
-            description: `Recurring error without solution: ${error.type}: ${error.message}`,
-            severity: solutions.length >= 4 ? 'critical' : 'warning',
-            suggestion: null,
-            occurrences: error.occurrence_count,
-            project_id: error.project_id,
-            global: 0,
-          });
-          count++;
-        }
-      }
-    }
-
-    return count;
-  }
-
-  getLastCycleAt(): string | null {
-    return this.lastCycleAt;
-  }
-}
+import type { LearningConfig } from '../types/config.types.js';
+import type { ErrorRepository } from '../db/repositories/error.repository.js';
+import type { SolutionRepository } from '../db/repositories/solution.repository.js';
+import type { RuleRepository } from '../db/repositories/rule.repository.js';
+import type { AntipatternRepository } from '../db/repositories/antipattern.repository.js';
+import type { SynapseManager } from '../synapses/synapse-manager.js';
+import { extractPatterns } from './pattern-extractor.js';
+import { generateRules, persistRules } from './rule-generator.js';
+import { shouldPruneRule } from './decay.js';
+import { getLogger } from '../utils/logger.js';
+
+export interface LearningCycleResult {
+  newPatterns: number;
+  updatedRules: number;
+  prunedRules: number;
+  newAntipatterns: number;
+  duration: number;
+}
+
+export class LearningEngine {
+  private timer: ReturnType<typeof setInterval> | null = null;
+  private logger = getLogger();
+  private lastCycleAt: string | null = null;
+
+  constructor(
+    private config: LearningConfig,
+    private errorRepo: ErrorRepository,
+    private solutionRepo: SolutionRepository,
+    private ruleRepo: RuleRepository,
+    private antipatternRepo: AntipatternRepository,
+    private synapseManager: SynapseManager,
+  ) {}
+
+  start(): void {
+    this.logger.info(`Learning engine starting (interval: ${this.config.intervalMs}ms)`);
+    this.timer = setInterval(() => this.runCycle(), this.config.intervalMs);
+  }
+
+  stop(): void {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.logger.info('Learning engine stopped');
+  }
+
+  runCycle(): LearningCycleResult {
+    const start = Date.now();
+    this.logger.info('Learning cycle starting');
+
+    const result: LearningCycleResult = {
+      newPatterns: 0,
+      updatedRules: 0,
+      prunedRules: 0,
+      newAntipatterns: 0,
+      duration: 0,
+    };
+
+    // Phase 1: Collect recent errors
+    const since = this.lastCycleAt ?? new Date(Date.now() - this.config.intervalMs).toISOString();
+    const recentErrors = this.errorRepo.findUnresolved();
+
+    // Phase 2: Extract patterns
+    const patterns = extractPatterns(recentErrors, 0.7);
+    result.newPatterns = patterns.length;
+
+    // Phase 3: Enrich patterns with solution data
+    for (const pattern of patterns) {
+      let totalSuccess = 0;
+      let totalAttempts = 0;
+
+      for (const errorId of pattern.errorIds) {
+        const solutions = this.solutionRepo.findForError(errorId);
+        pattern.solutionIds.push(...solutions.map(s => s.id));
+
+        for (const sol of solutions) {
+          const rate = this.solutionRepo.successRate(sol.id);
+          totalSuccess += rate;
+          totalAttempts++;
+        }
+      }
+
+      pattern.successRate = totalAttempts > 0 ? totalSuccess / totalAttempts : 0;
+      pattern.confidence = Math.min(
+        0.95,
+        pattern.successRate * 0.6 + Math.min(1, pattern.occurrences / 10) * 0.4,
+      );
+    }
+
+    // Phase 4: Generate rules from patterns
+    const rules = generateRules(patterns, this.config);
+    result.updatedRules = persistRules(rules, this.ruleRepo);
+
+    // Phase 5: Prune weak rules
+    const activeRules = this.ruleRepo.findActive();
+    for (const rule of activeRules) {
+      if (shouldPruneRule(
+        rule.confidence,
+        0, // rejection count not tracked yet
+        rule.occurrences,
+        this.config.pruneThreshold,
+        this.config.maxRejectionRate,
+      )) {
+        this.ruleRepo.update(rule.id, { active: 0 });
+        result.prunedRules++;
+      }
+    }
+
+    // Phase 6: Detect antipatterns
+    result.newAntipatterns = this.detectAntipatterns();
+
+    // Phase 7: Run synapse decay
+    this.synapseManager.runDecay();
+
+    this.lastCycleAt = new Date().toISOString();
+    result.duration = Date.now() - start;
+    this.logger.info(`Learning cycle complete: ${result.newPatterns} patterns, ${result.updatedRules} rules, ${result.prunedRules} pruned, ${result.newAntipatterns} antipatterns (${result.duration}ms)`);
+
+    return result;
+  }
+
+  private detectAntipatterns(): number {
+    const unresolvedErrors = this.errorRepo.findUnresolved();
+    const recurring = unresolvedErrors.filter(e => e.occurrence_count >= this.config.minOccurrences);
+    let count = 0;
+
+    for (const error of recurring) {
+      const solutions = this.solutionRepo.findForError(error.id);
+      const allFailed = solutions.length > 0 && solutions.every(s => {
+        const rate = this.solutionRepo.successRate(s.id);
+        return rate < 0.3;
+      });
+
+      if (solutions.length >= 2 && allFailed) {
+        // Check if antipattern already exists
+        const existing = this.antipatternRepo.findByProject(error.project_id);
+        const alreadyDetected = existing.some(ap =>
+          ap.pattern.includes(error.type) && ap.description.includes(error.message.substring(0, 30))
+        );
+
+        if (!alreadyDetected) {
+          this.antipatternRepo.create({
+            pattern: `${error.type}.*${error.message.substring(0, 40).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`,
+            description: `Recurring error without solution: ${error.type}: ${error.message}`,
+            severity: solutions.length >= 4 ? 'critical' : 'warning',
+            suggestion: null,
+            occurrences: error.occurrence_count,
+            project_id: error.project_id,
+            global: 0,
+          });
+          count++;
+        }
+      }
+    }
+
+    return count;
+  }
+
+  getLastCycleAt(): string | null {
+    return this.lastCycleAt;
+  }
+}

package/src/learning/pattern-extractor.ts

@@ -1,90 +1,90 @@
-import type { ErrorRecord } from '../types/error.types.js';
-import { tokenize } from '../matching/tokenizer.js';
-import { cosineSimilarity } from '../matching/similarity.js';
-
-export interface ErrorPattern {
-  errorType: string;
-  messageTemplate: string;
-  messageRegex: string;
-  filePattern: string | null;
-  occurrences: number;
-  errorIds: number[];
-  solutionIds: number[];
-  confidence: number;
-  successRate: number;
-}
-
-interface Centroid {
-  errorType: string;
-  tokens: string[];
-  errorIds: number[];
-  filePattern: string | null;
-}
-
-/**
- * Extract patterns from error records using centroid-based clustering.
- */
-export function extractPatterns(
-  errors: ErrorRecord[],
-  similarityThreshold: number = 0.7,
-): ErrorPattern[] {
-  const centroids: Centroid[] = [];
-
-  for (const error of errors) {
-    const tokens = tokenize(`${error.type} ${error.message}`);
-    let merged = false;
-
-    for (const centroid of centroids) {
-      if (centroid.errorType !== error.type) continue;
-
-      const sim = cosineSimilarity(centroid.tokens, tokens);
-      if (sim >= similarityThreshold) {
-        // Merge into existing centroid (running average)
-        const allTokens = [...centroid.tokens, ...tokens];
-        centroid.tokens = [...new Set(allTokens)];
-        centroid.errorIds.push(error.id);
-        if (!centroid.filePattern && error.file_path) {
-          centroid.filePattern = extractFilePattern(error.file_path);
-        }
-        merged = true;
-        break;
-      }
-    }
-
-    if (!merged) {
-      centroids.push({
-        errorType: error.type,
-        tokens,
-        errorIds: [error.id],
-        filePattern: error.file_path ? extractFilePattern(error.file_path) : null,
-      });
-    }
-  }
-
-  return centroids
-    .filter(c => c.errorIds.length >= 2)
-    .map(c => ({
-      errorType: c.errorType,
-      messageTemplate: c.tokens.join(' '),
-      messageRegex: buildRegex(c.tokens),
-      filePattern: c.filePattern,
-      occurrences: c.errorIds.length,
-      errorIds: c.errorIds,
-      solutionIds: [],
-      confidence: 0,
-      successRate: 0,
-    }));
-}
-
-function extractFilePattern(filePath: string): string {
-  // Extract the meaningful part: last directory + extension
-  const parts = filePath.replace(/\\/g, '/').split('/');
-  const fileName = parts[parts.length - 1] ?? '';
-  const ext = fileName.split('.').pop() ?? '';
-  return ext ? `*.${ext}` : '*';
-}
-
-function buildRegex(tokens: string[]): string {
-  const escaped = tokens.map(t => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
-  return escaped.join('.*');
-}
+import type { ErrorRecord } from '../types/error.types.js';
+import { tokenize } from '../matching/tokenizer.js';
+import { cosineSimilarity } from '../matching/similarity.js';
+
+export interface ErrorPattern {
+  errorType: string;
+  messageTemplate: string;
+  messageRegex: string;
+  filePattern: string | null;
+  occurrences: number;
+  errorIds: number[];
+  solutionIds: number[];
+  confidence: number;
+  successRate: number;
+}
+
+interface Centroid {
+  errorType: string;
+  tokens: string[];
+  errorIds: number[];
+  filePattern: string | null;
+}
+
+/**
+ * Extract patterns from error records using centroid-based clustering.
+ */
+export function extractPatterns(
+  errors: ErrorRecord[],
+  similarityThreshold: number = 0.7,
+): ErrorPattern[] {
+  const centroids: Centroid[] = [];
+
+  for (const error of errors) {
+    const tokens = tokenize(`${error.type} ${error.message}`);
+    let merged = false;
+
+    for (const centroid of centroids) {
+      if (centroid.errorType !== error.type) continue;
+
+      const sim = cosineSimilarity(centroid.tokens, tokens);
+      if (sim >= similarityThreshold) {
+        // Merge into existing centroid (running average)
+        const allTokens = [...centroid.tokens, ...tokens];
+        centroid.tokens = [...new Set(allTokens)];
+        centroid.errorIds.push(error.id);
+        if (!centroid.filePattern && error.file_path) {
+          centroid.filePattern = extractFilePattern(error.file_path);
+        }
+        merged = true;
+        break;
+      }
+    }
+
+    if (!merged) {
+      centroids.push({
+        errorType: error.type,
+        tokens,
+        errorIds: [error.id],
+        filePattern: error.file_path ? extractFilePattern(error.file_path) : null,
+      });
+    }
+  }
+
+  return centroids
+    .filter(c => c.errorIds.length >= 2)
+    .map(c => ({
+      errorType: c.errorType,
+      messageTemplate: c.tokens.join(' '),
+      messageRegex: buildRegex(c.tokens),
+      filePattern: c.filePattern,
+      occurrences: c.errorIds.length,
+      errorIds: c.errorIds,
+      solutionIds: [],
+      confidence: 0,
+      successRate: 0,
+    }));
+}
+
+function extractFilePattern(filePath: string): string {
+  // Extract the meaningful part: last directory + extension
+  const parts = filePath.replace(/\\/g, '/').split('/');
+  const fileName = parts[parts.length - 1] ?? '';
+  const ext = fileName.split('.').pop() ?? '';
+  return ext ? `*.${ext}` : '*';
+}
+
+function buildRegex(tokens: string[]): string {
+  const escaped = tokens.map(t => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+  return escaped.join('.*');
+}