@timmeck/brain 1.8.5 → 2.0.0

package/src/services/error.service.ts

@@ -1,266 +0,0 @@
-import type { ErrorRecord } from '../types/error.types.js';
-import type { ErrorRepository } from '../db/repositories/error.repository.js';
-import type { ProjectRepository } from '../db/repositories/project.repository.js';
-import type { SynapseManager } from '../synapses/synapse-manager.js';
-import type { MatchingConfig } from '../types/config.types.js';
-import type { EmbeddingEngine } from '../embeddings/engine.js';
-import { parseError } from '../parsing/error-parser.js';
-import { generateFingerprint } from '../matching/fingerprint.js';
-import { matchError, type MatchResult } from '../matching/error-matcher.js';
-import { getEventBus } from '../utils/events.js';
-import { getLogger } from '../utils/logger.js';
-
-export interface ReportErrorInput {
-  project: string;
-  errorOutput: string;
-  filePath?: string;
-  terminalId?: number;
-  taskContext?: string;
-  workingDirectory?: string;
-  command?: string;
-}
-
-export interface ErrorQueryInput {
-  projectId?: number;
-  resolved?: boolean;
-  search?: string;
-  limit?: number;
-}
-
-export class ErrorService {
-  private logger = getLogger();
-  private eventBus = getEventBus();
-  private matchingConfig: MatchingConfig | null = null;
-  private embeddingEngine: EmbeddingEngine | null = null;
-
-  constructor(
-    private errorRepo: ErrorRepository,
-    private projectRepo: ProjectRepository,
-    private synapseManager: SynapseManager,
-    matchingConfig?: MatchingConfig,
-  ) {
-    this.matchingConfig = matchingConfig ?? null;
-  }
-
-  setEmbeddingEngine(engine: EmbeddingEngine): void {
-    this.embeddingEngine = engine;
-  }
-
-  report(input: ReportErrorInput): { errorId: number; isNew: boolean; matches: MatchResult[]; crossProjectMatches?: MatchResult[] } {
-    // 1. Ensure project exists
-    let project = this.projectRepo.findByName(input.project);
-    if (!project) {
-      const id = this.projectRepo.create({ name: input.project, path: null, language: null, framework: null });
-      project = this.projectRepo.getById(id)!;
-    }
-
-    // 2. Build context from available information
-    const context = this.buildContext(input);
-
-    // 3. Parse the error
-    const parsed = parseError(input.errorOutput);
-    if (!parsed) {
-      this.logger.warn('Could not parse error output');
-      const errorId = this.errorRepo.create({
-        project_id: project.id,
-        terminal_id: input.terminalId ?? null,
-        fingerprint: '',
-        type: 'UnknownError',
-        message: input.errorOutput.split('\n')[0] ?? input.errorOutput,
-        raw_output: input.errorOutput,
-        context,
-        file_path: input.filePath ?? null,
-        line_number: null,
-        column_number: null,
-      });
-      return { errorId, isNew: true, matches: [] };
-    }
-
-    // 4. Generate fingerprint
-    const fingerprint = generateFingerprint(parsed.errorType, parsed.message, parsed.frames);
-
-    // 5. Check for existing error with same fingerprint
-    const existing = this.errorRepo.findByFingerprint(fingerprint);
-    if (existing.length > 0) {
-      const err = existing[0]!;
-      this.errorRepo.incrementOccurrence(err.id);
-      // Update context if previously null
-      if (!err.context && context) {
-        this.errorRepo.update(err.id, { context });
-      }
-      this.logger.info(`Known error (id=${err.id}), occurrence incremented`);
-
-      // Strengthen synapse
-      this.synapseManager.strengthen(
-        { type: 'error', id: err.id },
-        { type: 'project', id: project.id },
-        'co_occurs',
-      );
-
-      return { errorId: err.id, isNew: false, matches: [] };
-    }
-
-    // 6. Create new error record
-    const errorId = this.errorRepo.create({
-      project_id: project.id,
-      terminal_id: input.terminalId ?? null,
-      fingerprint,
-      type: parsed.errorType,
-      message: parsed.message,
-      raw_output: input.errorOutput,
-      context,
-      file_path: parsed.sourceFile ?? input.filePath ?? null,
-      line_number: parsed.sourceLine ?? null,
-      column_number: null,
-    });
-
-    // 7. Create synapse: error ↔ project
-    this.synapseManager.strengthen(
-      { type: 'error', id: errorId },
-      { type: 'project', id: project.id },
-      'co_occurs',
-    );
-
-    // 8. Find similar errors
-    const candidates = this.errorRepo.findByProject(project.id)
-      .filter(e => e.id !== errorId);
-    const newError = this.errorRepo.getById(errorId)!;
-    const matches = matchError(newError, candidates);
-
-    // 9. Create similarity synapses for strong matches
-    for (const match of matches.filter(m => m.isStrong)) {
-      this.synapseManager.strengthen(
-        { type: 'error', id: errorId },
-        { type: 'error', id: match.errorId },
-        'similar_to',
-      );
-    }
-
-    // 10. Error Chain Detection: link to recent unresolved errors in same project
-    this.detectErrorChain(errorId, project.id);
-
-    // 11. Cross-Project Transfer Learning
-    let crossProjectMatches: MatchResult[] = [];
-    if (this.matchingConfig?.crossProjectMatching) {
-      crossProjectMatches = this.findCrossProjectMatches(newError, project.id);
-      for (const match of crossProjectMatches.filter(m => m.isStrong)) {
-        this.synapseManager.strengthen(
-          { type: 'error', id: errorId },
-          { type: 'error', id: match.errorId },
-          'cross_project',
-        );
-      }
-    }
-
-    this.eventBus.emit('error:reported', { errorId, projectId: project.id, fingerprint });
-    this.logger.info(`New error reported (id=${errorId}, type=${parsed.errorType})`);
-
-    return { errorId, isNew: true, matches, crossProjectMatches };
-  }
-
-  query(input: ErrorQueryInput): ErrorRecord[] {
-    if (input.search && input.search.trim()) {
-      return this.errorRepo.search(input.search.trim());
-    }
-    if (input.resolved === false) {
-      return this.errorRepo.findUnresolved(input.projectId);
-    }
-    if (input.projectId) {
-      return this.errorRepo.findByProject(input.projectId);
-    }
-    // Default: return recent errors (most recent first)
-    return this.errorRepo.findAll(input.limit ?? 100);
-  }
-
-  matchSimilar(errorId: number): MatchResult[] {
-    const error = this.errorRepo.getById(errorId);
-    if (!error) return [];
-
-    const candidates = this.errorRepo.findByProject(error.project_id)
-      .filter(e => e.id !== errorId);
-
-    // Hybrid search: include vector scores if embedding engine is available
-    const vectorScores = this.embeddingEngine?.isReady()
-      ? this.embeddingEngine.computeErrorVectorScores(errorId, error.project_id)
-      : undefined;
-
-    return matchError(error, candidates, vectorScores);
-  }
-
-  resolve(errorId: number, solutionId?: number): void {
-    this.errorRepo.update(errorId, {
-      resolved: 1,
-      resolved_at: new Date().toISOString(),
-    });
-
-    if (solutionId) {
-      this.eventBus.emit('error:resolved', { errorId, solutionId });
-    }
-  }
-
-  getById(id: number): ErrorRecord | undefined {
-    return this.errorRepo.getById(id);
-  }
-
-  countSince(since: string, projectId?: number): number {
-    return this.errorRepo.countSince(since, projectId);
-  }
-
-  getErrorChain(errorId: number): { parents: ErrorRecord[]; children: ErrorRecord[] } {
-    return {
-      parents: this.errorRepo.findChainParents(errorId),
-      children: this.errorRepo.findChainChildren(errorId),
-    };
-  }
-
-  private findCrossProjectMatches(error: ErrorRecord, currentProjectId: number): MatchResult[] {
-    const allProjects = this.projectRepo.getAll();
-    const otherProjects = allProjects.filter(p => p.id !== currentProjectId);
-    const weight = this.matchingConfig?.crossProjectWeight ?? 0.7;
-
-    const allMatches: MatchResult[] = [];
-    for (const project of otherProjects) {
-      const candidates = this.errorRepo.findByProject(project.id)
-        .filter(e => e.resolved === 1); // Only look at resolved errors from other projects
-      const matches = matchError(error, candidates);
-      // Apply cross-project weight discount
-      for (const match of matches) {
-        match.score *= weight;
-        match.isStrong = match.score >= 0.90;
-        allMatches.push(match);
-      }
-    }
-
-    return allMatches.sort((a, b) => b.score - a.score).slice(0, 5);
-  }
-
-  private detectErrorChain(newErrorId: number, projectId: number): void {
-    // Look for recent unresolved errors in the same project (last 10 minutes)
-    const tenMinutesAgo = new Date(Date.now() - 10 * 60 * 1000).toISOString();
-    const recentErrors = this.errorRepo.findRecentByProject(projectId, tenMinutesAgo, 5);
-
-    for (const recent of recentErrors) {
-      if (recent.id === newErrorId) continue;
-      if (recent.resolved === 0) {
-        // This new error appeared while trying to fix a recent error → chain
-        this.errorRepo.createChain(recent.id, newErrorId, 'caused_by_fix');
-        this.synapseManager.strengthen(
-          { type: 'error', id: recent.id },
-          { type: 'error', id: newErrorId },
-          'causes',
-        );
-        this.logger.info(`Error chain: #${recent.id} → #${newErrorId} (caused_by_fix)`);
-        break; // Link to most recent parent only
-      }
-    }
-  }
-
-  private buildContext(input: ReportErrorInput): string | null {
-    const parts: string[] = [];
-    if (input.taskContext) parts.push(`task: ${input.taskContext}`);
-    if (input.command) parts.push(`command: ${input.command}`);
-    if (input.workingDirectory) parts.push(`cwd: ${input.workingDirectory}`);
-    if (input.filePath) parts.push(`file: ${input.filePath}`);
-    return parts.length > 0 ? parts.join(' | ') : null;
-  }
-}

package/src/services/git.service.ts

@@ -1,132 +0,0 @@
-import { execSync } from 'node:child_process';
-import type Database from 'better-sqlite3';
-import type { SynapseManager } from '../synapses/synapse-manager.js';
-import { getLogger } from '../utils/logger.js';
-
-export interface GitCommitInfo {
-  hash: string;
-  message: string;
-  author: string;
-  timestamp: string;
-  filesChanged: number;
-  insertions: number;
-  deletions: number;
-}
-
-export class GitService {
-  private logger = getLogger();
-
-  constructor(
-    private db: Database.Database,
-    private synapseManager: SynapseManager,
-  ) {}
-
-  /**
-   * Get current git info for context enrichment
-   */
-  getGitContext(cwd?: string): { branch: string | null; diff: string | null; lastCommit: string | null } {
-    try {
-      const opts = cwd ? { cwd, timeout: 5000 } : { timeout: 5000 };
-      const branch = execSync('git rev-parse --abbrev-ref HEAD', { ...opts, encoding: 'utf8' }).trim();
-      const diff = execSync('git diff --stat HEAD', { ...opts, encoding: 'utf8' }).trim();
-      const lastCommit = execSync('git log -1 --pretty=format:"%H %s"', { ...opts, encoding: 'utf8' }).trim();
-      return { branch, diff: diff || null, lastCommit };
-    } catch {
-      return { branch: null, diff: null, lastCommit: null };
-    }
-  }
-
-  /**
-   * Store a git commit and link it to an error
-   */
-  linkErrorToCommit(errorId: number, projectId: number, commitHash: string, relationship: string = 'introduced_by'): void {
-    try {
-      // Store commit info
-      const commitInfo = this.getCommitInfo(commitHash);
-      if (commitInfo) {
-        this.db.prepare(`
-          INSERT OR IGNORE INTO git_commits (project_id, commit_hash, message, author, timestamp, files_changed, insertions, deletions)
-          VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-        `).run(projectId, commitInfo.hash, commitInfo.message, commitInfo.author, commitInfo.timestamp,
-          commitInfo.filesChanged, commitInfo.insertions, commitInfo.deletions);
-      }
-
-      // Link error to commit
-      this.db.prepare(`
-        INSERT OR IGNORE INTO error_commits (error_id, commit_hash, relationship)
-        VALUES (?, ?, ?)
-      `).run(errorId, commitHash, relationship);
-
-      this.logger.info(`Linked error #${errorId} to commit ${commitHash.slice(0, 8)} (${relationship})`);
-    } catch (err) {
-      this.logger.warn(`Failed to link error to commit: ${err}`);
-    }
-  }
-
-  /**
-   * Find which commit introduced an error
-   */
-  findIntroducingCommit(errorId: number): Array<{ commitHash: string; message: string; relationship: string }> {
-    const rows = this.db.prepare(`
-      SELECT ec.commit_hash, ec.relationship, gc.message
-      FROM error_commits ec
-      LEFT JOIN git_commits gc ON ec.commit_hash = gc.commit_hash
-      WHERE ec.error_id = ?
-      ORDER BY ec.created_at DESC
-    `).all(errorId) as Array<{ commit_hash: string; message: string | null; relationship: string }>;
-
-    return rows.map(r => ({
-      commitHash: r.commit_hash,
-      message: r.message ?? 'unknown',
-      relationship: r.relationship,
-    }));
-  }
-
-  /**
-   * Find errors introduced by a specific commit
-   */
-  findErrorsByCommit(commitHash: string): Array<{ errorId: number; relationship: string }> {
-    const rows = this.db.prepare(`
-      SELECT error_id, relationship FROM error_commits WHERE commit_hash = ?
-    `).all(commitHash) as Array<{ error_id: number; relationship: string }>;
-
-    return rows.map(r => ({ errorId: r.error_id, relationship: r.relationship }));
-  }
-
-  /**
-   * Capture current git diff for error context
-   */
-  captureDiff(cwd?: string): string | null {
-    try {
-      const opts = cwd ? { cwd, timeout: 5000, encoding: 'utf8' as const } : { timeout: 5000, encoding: 'utf8' as const };
-      const diff = execSync('git diff HEAD --no-color', opts).trim();
-      // Truncate to avoid huge diffs
-      return diff.length > 5000 ? diff.slice(0, 5000) + '\n... (truncated)' : diff || null;
-    } catch {
-      return null;
-    }
-  }
-
-  private getCommitInfo(hash: string, cwd?: string): GitCommitInfo | null {
-    try {
-      const opts = cwd ? { cwd, timeout: 5000, encoding: 'utf8' as const } : { timeout: 5000, encoding: 'utf8' as const };
-      const info = execSync(`git log -1 --pretty=format:"%H|||%s|||%an|||%aI" ${hash}`, opts).trim();
-      const [commitHash, message, author, timestamp] = info.split('|||');
-
-      const stat = execSync(`git diff --stat ${hash}~1..${hash}`, opts).trim();
-      const statMatch = stat.match(/(\d+) files? changed(?:, (\d+) insertions?\(\+\))?(?:, (\d+) deletions?\(-\))?/);
-
-      return {
-        hash: commitHash ?? hash,
-        message: message ?? '',
-        author: author ?? '',
-        timestamp: timestamp ?? new Date().toISOString(),
-        filesChanged: parseInt(statMatch?.[1] ?? '0', 10),
-        insertions: parseInt(statMatch?.[2] ?? '0', 10),
-        deletions: parseInt(statMatch?.[3] ?? '0', 10),
-      };
-    } catch {
-      return null;
-    }
-  }
-}

package/src/services/notification.service.ts

@@ -1,41 +0,0 @@
-import type { NotificationRepository, NotificationRecord } from '../db/repositories/notification.repository.js';
-import { getLogger } from '../utils/logger.js';
-
-export interface CreateNotificationInput {
-  type: string;
-  title: string;
-  message: string;
-  priority?: number;
-  projectId?: number;
-}
-
-export class NotificationService {
-  private logger = getLogger();
-
-  constructor(private notificationRepo: NotificationRepository) {}
-
-  create(input: CreateNotificationInput): number {
-    const id = this.notificationRepo.create({
-      type: input.type,
-      title: input.title,
-      message: input.message,
-      priority: input.priority ?? 0,
-      project_id: input.projectId ?? null,
-    });
-
-    this.logger.info(`Notification created (id=${id}, type=${input.type})`);
-    return id;
-  }
-
-  list(projectId?: number): NotificationRecord[] {
-    return this.notificationRepo.findUnacknowledged(projectId);
-  }
-
-  acknowledge(id: number): void {
-    this.notificationRepo.acknowledge(id);
-  }
-
-  getById(id: number): NotificationRecord | undefined {
-    return this.notificationRepo.getById(id);
-  }
-}

package/src/services/prevention.service.ts

@@ -1,159 +0,0 @@
-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 { getLogger } from '../utils/logger.js';
-
-export interface RuleCheckResult {
-  matched: boolean;
-  ruleId: number;
-  action: string;
-  description: string | null;
-  confidence: number;
-}
-
-export interface AntipatternCheckResult {
-  matched: boolean;
-  antipatternId: number;
-  pattern: string;
-  description: string;
-  severity: string;
-  suggestion: string | null;
-}
-
-export class PreventionService {
-  private logger = getLogger();
-
-  constructor(
-    private ruleRepo: RuleRepository,
-    private antipatternRepo: AntipatternRepository,
-    private synapseManager: SynapseManager,
-  ) {}
-
-  checkRules(errorType: string, message: string, projectId?: number): RuleCheckResult[] {
-    const rules = this.ruleRepo.findActive(projectId);
-    const results: RuleCheckResult[] = [];
-
-    for (const rule of rules) {
-      try {
-        const pattern = new RegExp(rule.pattern, 'i');
-        const input = `${errorType}: ${message}`;
-
-        if (pattern.test(input)) {
-          results.push({
-            matched: true,
-            ruleId: rule.id,
-            action: rule.action,
-            description: rule.description,
-            confidence: rule.confidence,
-          });
-
-          this.logger.debug(`Rule ${rule.id} matched: ${rule.pattern}`);
-        }
-      } catch {
-        // Invalid regex in rule pattern, skip
-        this.logger.warn(`Invalid regex in rule ${rule.id}: ${rule.pattern}`);
-      }
-    }
-
-    return results.sort((a, b) => b.confidence - a.confidence);
-  }
-
-  checkAntipatterns(errorType: string, message: string, projectId?: number): AntipatternCheckResult[] {
-    const antipatterns = projectId
-      ? [...this.antipatternRepo.findByProject(projectId), ...this.antipatternRepo.findGlobal()]
-      : this.antipatternRepo.findGlobal();
-
-    const results: AntipatternCheckResult[] = [];
-    const input = `${errorType}: ${message}`;
-
-    for (const ap of antipatterns) {
-      try {
-        const pattern = new RegExp(ap.pattern, 'i');
-        if (pattern.test(input)) {
-          results.push({
-            matched: true,
-            antipatternId: ap.id,
-            pattern: ap.pattern,
-            description: ap.description,
-            severity: ap.severity,
-            suggestion: ap.suggestion,
-          });
-        }
-      } catch {
-        this.logger.warn(`Invalid regex in antipattern ${ap.id}: ${ap.pattern}`);
-      }
-    }
-
-    return results;
-  }
-
-  createRule(data: {
-    pattern: string;
-    action: string;
-    description?: string;
-    confidence?: number;
-    projectId?: number;
-  }): number {
-    return this.ruleRepo.create({
-      pattern: data.pattern,
-      action: data.action,
-      description: data.description ?? null,
-      confidence: data.confidence ?? 0.5,
-      occurrences: 0,
-      active: 1,
-      project_id: data.projectId ?? null,
-    });
-  }
-
-  checkCodeForPatterns(source: string, filePath?: string): { warnings: Array<{ message: string; severity: string; ruleId?: number }> } {
-    const warnings: Array<{ message: string; severity: string; ruleId?: number }> = [];
-
-    // Check antipatterns against the code itself
-    const globalAntipatterns = this.antipatternRepo.findGlobal();
-    for (const ap of globalAntipatterns) {
-      try {
-        const pattern = new RegExp(ap.pattern, 'i');
-        if (pattern.test(source)) {
-          warnings.push({
-            message: `Code matches known error pattern: ${ap.description}${ap.suggestion ? `. Suggestion: ${ap.suggestion}` : ''}`,
-            severity: ap.severity,
-            ruleId: undefined,
-          });
-        }
-      } catch {
-        // Invalid regex, skip
-      }
-    }
-
-    // Check active rules
-    const rules = this.ruleRepo.findActive();
-    for (const rule of rules) {
-      try {
-        const pattern = new RegExp(rule.pattern, 'i');
-        if (pattern.test(source)) {
-          warnings.push({
-            message: `Code matches learned rule: ${rule.description ?? rule.pattern}. Action: ${rule.action}`,
-            severity: 'warning',
-            ruleId: rule.id,
-          });
-        }
-      } catch {
-        // Invalid regex, skip
-      }
-    }
-
-    return { warnings: warnings.slice(0, 5) };
-  }
-
-  reportPrevention(ruleId: number, errorId: number): void {
-    const rule = this.ruleRepo.getById(ruleId);
-    if (rule) {
-      this.ruleRepo.update(ruleId, { occurrences: rule.occurrences + 1 });
-      this.synapseManager.strengthen(
-        { type: 'rule', id: ruleId },
-        { type: 'error', id: errorId },
-        'prevents',
-      );
-    }
-  }
-}

package/src/services/research.service.ts

@@ -1,98 +0,0 @@
-import type { InsightRecord } from '../types/research.types.js';
-import type { InsightRepository } from '../db/repositories/insight.repository.js';
-import type { ErrorRepository } from '../db/repositories/error.repository.js';
-import type { SynapseManager } from '../synapses/synapse-manager.js';
-import { getLogger } from '../utils/logger.js';
-
-export interface InsightQuery {
-  projectId?: number;
-  type?: string;
-  activeOnly?: boolean;
-  limit?: number;
-}
-
-export interface TrendResult {
-  errorType: string;
-  count: number;
-  direction: 'increasing' | 'decreasing' | 'stable';
-  period: string;
-}
-
-export class ResearchService {
-  private logger = getLogger();
-
-  constructor(
-    private insightRepo: InsightRepository,
-    private errorRepo: ErrorRepository,
-    private synapseManager: SynapseManager,
-  ) {}
-
-  getInsights(query: InsightQuery): InsightRecord[] {
-    if (query.type) {
-      return this.insightRepo.findByType(query.type);
-    }
-    if (query.activeOnly !== false) {
-      return this.insightRepo.findActive(query.projectId);
-    }
-    return this.insightRepo.findActive(query.projectId);
-  }
-
-  createInsight(data: {
-    type: string;
-    title: string;
-    description: string;
-    evidence?: string;
-    priority?: number;
-    projectId?: number;
-    expiresInDays?: number;
-  }): number {
-    const expiresAt = data.expiresInDays
-      ? new Date(Date.now() + data.expiresInDays * 86400000).toISOString()
-      : null;
-
-    const id = this.insightRepo.create({
-      type: data.type as InsightRecord['type'],
-      title: data.title,
-      description: data.description,
-      evidence: data.evidence ?? '[]',
-      priority: data.priority ?? 0,
-      project_id: data.projectId ?? null,
-      active: 1,
-      expires_at: expiresAt,
-    });
-
-    this.logger.info(`Insight created (id=${id}, type=${data.type})`);
-    return id;
-  }
-
-  getTrends(projectId?: number, windowDays: number = 7): TrendResult[] {
-    const now = new Date();
-    const currentStart = new Date(now.getTime() - windowDays * 86400000).toISOString();
-    const previousStart = new Date(now.getTime() - windowDays * 2 * 86400000).toISOString();
-
-    const currentCount = this.errorRepo.countSince(currentStart, projectId);
-    const previousCount = this.errorRepo.countSince(previousStart, projectId) - currentCount;
-
-    const direction = currentCount > previousCount * 1.2
-      ? 'increasing' as const
-      : currentCount < previousCount * 0.8
-        ? 'decreasing' as const
-        : 'stable' as const;
-
-    return [{
-      errorType: 'all',
-      count: currentCount,
-      direction,
-      period: `${windowDays}d`,
-    }];
-  }
-
-  expireOldInsights(): number {
-    return this.insightRepo.expire();
-  }
-
-  rateInsight(id: number, rating: number, comment?: string): boolean {
-    const clamped = Math.max(-1, Math.min(1, rating)); // -1 (bad), 0 (neutral), 1 (useful)
-    return this.insightRepo.rate(id, clamped, comment);
-  }
-}