@timmeck/brain 1.8.5 → 2.0.0

package/src/ipc/client.ts

@@ -1,118 +0,0 @@
-import net from 'node:net';
-import { randomUUID } from 'node:crypto';
-import type { IpcMessage } from '../types/ipc.types.js';
-import { encodeMessage, MessageDecoder } from './protocol.js';
-import { getPipeName } from '../utils/paths.js';
-
-interface PendingRequest {
-  resolve: (result: unknown) => void;
-  reject: (err: Error) => void;
-  timer: ReturnType<typeof setTimeout>;
-}
-
-export class IpcClient {
-  private socket: net.Socket | null = null;
-  private decoder = new MessageDecoder();
-  private pending = new Map<string, PendingRequest>();
-  private onNotification?: (msg: IpcMessage) => void;
-
-  constructor(
-    private pipeName: string = getPipeName(),
-    private timeout: number = 5000,
-  ) {}
-
-  connect(): Promise<void> {
-    return new Promise((resolve, reject) => {
-      this.socket = net.createConnection(this.pipeName, () => {
-        resolve();
-      });
-
-      this.socket.on('data', (chunk) => {
-        const messages = this.decoder.feed(chunk);
-        for (const msg of messages) {
-          this.handleMessage(msg);
-        }
-      });
-
-      this.socket.on('error', (err) => {
-        reject(err);
-        // Reject all pending requests
-        for (const [id, req] of this.pending) {
-          clearTimeout(req.timer);
-          req.reject(new Error(`Connection error: ${err.message}`));
-          this.pending.delete(id);
-        }
-      });
-
-      this.socket.on('close', () => {
-        for (const [id, req] of this.pending) {
-          clearTimeout(req.timer);
-          req.reject(new Error('Connection closed'));
-          this.pending.delete(id);
-        }
-        this.socket = null;
-      });
-    });
-  }
-
-  request(method: string, params?: unknown): Promise<unknown> {
-    return new Promise((resolve, reject) => {
-      if (!this.socket || this.socket.destroyed) {
-        return reject(new Error('Not connected'));
-      }
-
-      const id = randomUUID();
-      const timer = setTimeout(() => {
-        this.pending.delete(id);
-        reject(new Error(`Request timeout: ${method} (${this.timeout}ms)`));
-      }, this.timeout);
-
-      this.pending.set(id, { resolve, reject, timer });
-
-      const msg: IpcMessage = {
-        id,
-        type: 'request',
-        method,
-        params,
-      };
-      this.socket.write(encodeMessage(msg));
-    });
-  }
-
-  setNotificationHandler(handler: (msg: IpcMessage) => void): void {
-    this.onNotification = handler;
-  }
-
-  disconnect(): void {
-    for (const [id, req] of this.pending) {
-      clearTimeout(req.timer);
-      req.reject(new Error('Client disconnecting'));
-      this.pending.delete(id);
-    }
-    this.socket?.destroy();
-    this.socket = null;
-    this.decoder.reset();
-  }
-
-  get connected(): boolean {
-    return this.socket !== null && !this.socket.destroyed;
-  }
-
-  private handleMessage(msg: IpcMessage): void {
-    if (msg.type === 'response') {
-      const req = this.pending.get(msg.id);
-      if (!req) return;
-
-      clearTimeout(req.timer);
-      this.pending.delete(msg.id);
-
-      if (msg.error) {
-        req.reject(new Error(msg.error.message));
-      } else {
-        req.resolve(msg.result);
-      }
-    } else if (msg.type === 'notification') {
-      this.onNotification?.(msg);
-    }
-  }
-}

package/src/ipc/protocol.ts

@@ -1,35 +0,0 @@
-import { Buffer } from 'node:buffer';
-import type { IpcMessage } from '../types/ipc.types.js';
-
-export function encodeMessage(msg: IpcMessage): Buffer {
-  const json = JSON.stringify(msg);
-  const payload = Buffer.from(json, 'utf8');
-  const frame = Buffer.alloc(4 + payload.length);
-  frame.writeUInt32BE(payload.length, 0);
-  payload.copy(frame, 4);
-  return frame;
-}
-
-export class MessageDecoder {
-  private buffer = Buffer.alloc(0);
-
-  feed(chunk: Buffer): IpcMessage[] {
-    this.buffer = Buffer.concat([this.buffer, chunk]);
-    const messages: IpcMessage[] = [];
-
-    while (this.buffer.length >= 4) {
-      const length = this.buffer.readUInt32BE(0);
-      if (this.buffer.length < 4 + length) break;
-
-      const json = this.buffer.subarray(4, 4 + length).toString('utf8');
-      this.buffer = this.buffer.subarray(4 + length);
-      messages.push(JSON.parse(json) as IpcMessage);
-    }
-
-    return messages;
-  }
-
-  reset(): void {
-    this.buffer = Buffer.alloc(0);
-  }
-}

package/src/ipc/router.ts

@@ -1,133 +0,0 @@
-import { getLogger } from '../utils/logger.js';
-
-const logger = getLogger();
-import type { ErrorService } from '../services/error.service.js';
-import type { SolutionService } from '../services/solution.service.js';
-import type { TerminalService } from '../services/terminal.service.js';
-import type { PreventionService } from '../services/prevention.service.js';
-import type { CodeService } from '../services/code.service.js';
-import type { SynapseService } from '../services/synapse.service.js';
-import type { ResearchService } from '../services/research.service.js';
-import type { NotificationService } from '../services/notification.service.js';
-import type { AnalyticsService } from '../services/analytics.service.js';
-import type { GitService } from '../services/git.service.js';
-import type { LearningEngine, LearningCycleResult } from '../learning/learning-engine.js';
-
-export interface Services {
-  error: ErrorService;
-  solution: SolutionService;
-  terminal: TerminalService;
-  prevention: PreventionService;
-  code: CodeService;
-  synapse: SynapseService;
-  research: ResearchService;
-  notification: NotificationService;
-  analytics: AnalyticsService;
-  git: GitService;
-  learning?: LearningEngine;
-}
-
-type MethodHandler = (params: unknown) => unknown;
-
-export class IpcRouter {
-  private methods: Map<string, MethodHandler>;
-
-  constructor(private services: Services) {
-    this.methods = this.buildMethodMap();
-  }
-
-  handle(method: string, params: unknown): unknown {
-    const handler = this.methods.get(method);
-    if (!handler) {
-      throw new Error(`Unknown method: ${method}`);
-    }
-
-    logger.debug(`IPC: ${method}`, { params });
-    const result = handler(params);
-    logger.debug(`IPC: ${method} → done`);
-    return result;
-  }
-
-  listMethods(): string[] {
-    return [...this.methods.keys()];
-  }
-
-  private buildMethodMap(): Map<string, MethodHandler> {
-    const s = this.services;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const p = (params: unknown) => params as any;
-
-    return new Map<string, MethodHandler>([
-      // Terminal Lifecycle
-      ['terminal.register',       (params) => s.terminal.register(p(params))],
-      ['terminal.heartbeat',      (params) => s.terminal.heartbeat(p(params).uuid)],
-      ['terminal.disconnect',     (params) => s.terminal.disconnect(p(params).uuid)],
-
-      // Error Brain
-      ['error.report',            (params) => s.error.report(p(params))],
-      ['error.query',             (params) => s.error.query(p(params))],
-      ['error.match',             (params) => s.error.matchSimilar(p(params).error_id ?? p(params).errorId)],
-      ['error.resolve',           (params) => s.error.resolve(p(params).error_id ?? p(params).errorId, p(params).solution_id ?? p(params).solutionId)],
-      ['error.get',               (params) => s.error.getById(p(params).id)],
-      ['error.chain',             (params) => s.error.getErrorChain(p(params).error_id ?? p(params).errorId ?? p(params).id)],
-
-      // Solutions
-      ['solution.report',         (params) => s.solution.report(p(params))],
-      ['solution.query',          (params) => s.solution.findForError(p(params).error_id ?? p(params).errorId)],
-      ['solution.rate',           (params) => s.solution.rateOutcome(p(params))],
-      ['solution.attempt',        (params) => s.solution.rateOutcome({ ...p(params), success: false })],
-      ['solution.efficiency',     () => s.solution.analyzeEfficiency()],
-
-      // Projects
-      ['project.list',            () => s.code.listProjects()],
-
-      // Code Brain
-      ['code.analyze',            (params) => s.code.analyzeAndRegister(p(params))],
-      ['code.find',               (params) => s.code.findReusable(p(params))],
-      ['code.similarity',         (params) => s.code.checkSimilarity(p(params).source, p(params).language)],
-      ['code.modules',            (params) => s.code.listModules(p(params)?.projectId, p(params)?.language, p(params)?.limit)],
-      ['code.get',                (params) => s.code.getById(p(params).id)],
-
-      // Prevention
-      ['prevention.check',        (params) => s.prevention.checkRules(p(params).errorType, p(params).message, p(params).projectId)],
-      ['prevention.antipatterns',  (params) => s.prevention.checkAntipatterns(p(params).errorType ?? '', p(params).message ?? p(params).error_output ?? '', p(params).projectId)],
-      ['prevention.checkCode',    (params) => s.prevention.checkCodeForPatterns(p(params).source, p(params).filePath)],
-
-      // Synapses
-      ['synapse.context',         (params) => s.synapse.getErrorContext(p(params).errorId ?? p(params).error_id ?? p(params).node_id)],
-      ['synapse.path',            (params) => s.synapse.findPath(p(params).from_type ?? p(params).fromType, p(params).from_id ?? p(params).fromId, p(params).to_type ?? p(params).toType, p(params).to_id ?? p(params).toId)],
-      ['synapse.related',         (params) => s.synapse.getRelated(p(params))],
-      ['synapse.stats',           () => s.synapse.getNetworkStats()],
-
-      // Research / Insights
-      ['research.insights',       (params) => s.research.getInsights(p(params))],
-      ['insight.rate',            (params) => s.research.rateInsight(p(params).id, p(params).rating, p(params).comment)],
-      ['research.suggest',        (params) => s.research.getInsights({ limit: 10, activeOnly: true, ...p(params) })],
-      ['research.trends',         (params) => s.research.getTrends(p(params)?.projectId, p(params)?.windowDays)],
-
-      // Notifications
-      ['notification.list',       (params) => s.notification.list(p(params)?.projectId)],
-      ['notification.ack',        (params) => s.notification.acknowledge(p(params).id)],
-
-      // Analytics
-      ['analytics.summary',       (params) => s.analytics.getSummary(p(params)?.projectId)],
-      ['analytics.network',       (params) => s.analytics.getNetworkOverview(p(params)?.limit)],
-      ['analytics.health',        (params) => s.analytics.computeHealthScore(p(params)?.projectId)],
-      ['analytics.timeline',      (params) => s.analytics.getTimeSeries(p(params)?.projectId, p(params)?.days)],
-      ['analytics.explain',       (params) => s.analytics.explainError(p(params).errorId ?? p(params).error_id)],
-
-      // Git
-      ['git.context',             (params) => s.git.getGitContext(p(params)?.cwd)],
-      ['git.linkError',           (params) => s.git.linkErrorToCommit(p(params).errorId, p(params).projectId, p(params).commitHash, p(params).relationship)],
-      ['git.errorCommits',        (params) => s.git.findIntroducingCommit(p(params).errorId ?? p(params).error_id)],
-      ['git.commitErrors',        (params) => s.git.findErrorsByCommit(p(params).commitHash ?? p(params).commit_hash)],
-      ['git.diff',                (params) => s.git.captureDiff(p(params)?.cwd)],
-
-      // Learning
-      ['learning.run',            () => {
-        if (!s.learning) throw new Error('Learning engine not available');
-        return s.learning.runCycle();
-      }],
-    ]);
-  }
-}

package/src/ipc/server.ts

@@ -1,176 +0,0 @@
-import net from 'node:net';
-import fs from 'node:fs';
-import { randomUUID } from 'node:crypto';
-import { getLogger } from '../utils/logger.js';
-
-const logger = getLogger();
-import type { IpcMessage } from '../types/ipc.types.js';
-import { encodeMessage, MessageDecoder } from './protocol.js';
-import type { IpcRouter } from './router.js';
-
-export class IpcServer {
-  private server: net.Server | null = null;
-  private clients = new Map<string, net.Socket>();
-
-  constructor(
-    private router: IpcRouter,
-    private pipeName: string,
-  ) {}
-
-  start(): void {
-    this.createServer();
-    this.listen();
-  }
-
-  private createServer(): void {
-    this.server = net.createServer((socket) => {
-      const clientId = randomUUID();
-      this.clients.set(clientId, socket);
-      const decoder = new MessageDecoder();
-
-      logger.info(`IPC client connected: ${clientId}`);
-
-      socket.on('data', (chunk) => {
-        const messages = decoder.feed(chunk);
-        for (const msg of messages) {
-          this.handleMessage(clientId, msg, socket);
-        }
-      });
-
-      socket.on('close', () => {
-        logger.info(`IPC client disconnected: ${clientId}`);
-        this.clients.delete(clientId);
-      });
-
-      socket.on('error', (err) => {
-        logger.error(`IPC client ${clientId} error:`, err);
-        this.clients.delete(clientId);
-      });
-    });
-  }
-
-  private listen(retried = false): void {
-    if (!this.server) return;
-
-    this.server.on('error', (err: NodeJS.ErrnoException) => {
-      if (err.code === 'EADDRINUSE' && !retried) {
-        logger.warn(`IPC pipe in use, attempting to recover stale pipe: ${this.pipeName}`);
-        this.recoverStalePipe();
-      } else {
-        logger.error('IPC server error:', err);
-      }
-    });
-
-    this.server.listen(this.pipeName, () => {
-      logger.info(`IPC server listening on ${this.pipeName}`);
-    });
-  }
-
-  /**
-   * On Windows, named pipes can remain after a crashed daemon.
-   * Try to connect as a client — if it fails, the pipe is stale and we can reclaim it.
-   * On Unix, simply unlink the socket file and retry.
-   */
-  private recoverStalePipe(): void {
-    const probe = net.createConnection(this.pipeName);
-
-    probe.on('connect', () => {
-      // Pipe is alive — another daemon is actually running
-      probe.destroy();
-      logger.error('IPC pipe is held by another running daemon. Stop it first with: brain stop');
-    });
-
-    probe.on('error', () => {
-      // Pipe is stale — no one is listening. Clean up and retry.
-      probe.destroy();
-      logger.info('Stale IPC pipe detected, reclaiming...');
-
-      // On Unix, unlink the socket file
-      if (process.platform !== 'win32') {
-        try { fs.unlinkSync(this.pipeName); } catch { /* ignore */ }
-      }
-
-      // Recreate server and retry (Windows auto-reclaims dead named pipes on re-listen)
-      this.createServer();
-      this.server!.on('error', (err) => {
-        logger.error('IPC server error after recovery:', err);
-      });
-      this.server!.listen(this.pipeName, () => {
-        logger.info(`IPC server recovered and listening on ${this.pipeName}`);
-      });
-    });
-
-    // Timeout: if probe hangs, treat pipe as stale
-    probe.setTimeout(2000, () => {
-      probe.destroy();
-      logger.warn('IPC pipe probe timed out, treating as stale');
-      if (process.platform !== 'win32') {
-        try { fs.unlinkSync(this.pipeName); } catch { /* ignore */ }
-      }
-      this.createServer();
-      this.server!.on('error', (err) => {
-        logger.error('IPC server error after timeout recovery:', err);
-      });
-      this.server!.listen(this.pipeName, () => {
-        logger.info(`IPC server recovered (timeout) and listening on ${this.pipeName}`);
-      });
-    });
-  }
-
-  private handleMessage(clientId: string, msg: IpcMessage, socket: net.Socket): void {
-    if (msg.type !== 'request' || !msg.method) return;
-
-    try {
-      const result = this.router.handle(msg.method, msg.params);
-      const response: IpcMessage = {
-        id: msg.id,
-        type: 'response',
-        result,
-      };
-      socket.write(encodeMessage(response));
-    } catch (err) {
-      const response: IpcMessage = {
-        id: msg.id,
-        type: 'response',
-        error: { code: -1, message: err instanceof Error ? err.message : String(err) },
-      };
-      socket.write(encodeMessage(response));
-    }
-  }
-
-  notify(clientId: string | null, notification: Omit<IpcMessage, 'id' | 'type'>): void {
-    const msg: IpcMessage = {
-      id: randomUUID(),
-      type: 'notification',
-      ...notification,
-    };
-    const encoded = encodeMessage(msg);
-
-    if (clientId) {
-      const socket = this.clients.get(clientId);
-      if (socket && !socket.destroyed) {
-        socket.write(encoded);
-      }
-    } else {
-      for (const socket of this.clients.values()) {
-        if (!socket.destroyed) {
-          socket.write(encoded);
-        }
-      }
-    }
-  }
-
-  getClientCount(): number {
-    return this.clients.size;
-  }
-
-  stop(): void {
-    for (const socket of this.clients.values()) {
-      socket.destroy();
-    }
-    this.clients.clear();
-    this.server?.close();
-    this.server = null;
-    logger.info('IPC server stopped');
-  }
-}

package/src/learning/confidence-scorer.ts

@@ -1,80 +0,0 @@
-/**
- * Wilson Score Interval for low-sample-size confidence.
- * Prevents unrealistic 100% from single success/failure.
- */
-export function wilsonScore(successes: number, total: number, z: number = 1.96): number {
-  if (total === 0) return 0;
-
-  const p = successes / total;
-  const z2 = z * z;
-  const n = total;
-
-  const numerator = p + z2 / (2 * n);
-  const denominator = 1 + z2 / n;
-  const margin = z * Math.sqrt((p * (1 - p) + z2 / (4 * n)) / n) / denominator;
-
-  // Lower bound of Wilson interval = conservative estimate
-  return Math.max(0, numerator / denominator - margin);
-}
-
-/**
- * Time-decayed confidence: recent successes count more.
- */
-export function timeDecayedConfidence(
-  successes: number,
-  total: number,
-  lastUsedAt: string,
-  halfLifeDays: number,
-): number {
-  const base = wilsonScore(successes, total);
-  const ageDays = (Date.now() - new Date(lastUsedAt).getTime()) / (1000 * 60 * 60 * 24);
-  const decay = Math.pow(0.5, ageDays / halfLifeDays);
-  return base * decay;
-}
-
-/**
- * Combined confidence from success rate + usage frequency + recency.
- */
-export function computeConfidence(
-  successCount: number,
-  failCount: number,
-  lastUsedAt: string,
-  halfLifeDays: number = 30,
-): number {
-  const total = successCount + failCount;
-  if (total === 0) return 0;
-  return timeDecayedConfidence(successCount, total, lastUsedAt, halfLifeDays);
-}
-
-export interface AdaptiveThresholds {
-  minOccurrences: number;
-  minSuccessRate: number;
-  minConfidence: number;
-  pruneThreshold: number;
-}
-
-/**
- * Compute adaptive thresholds based on data volume.
- * Users with lots of data need stricter thresholds; users with little data need looser ones.
- */
-export function computeAdaptiveThresholds(
-  totalErrors: number,
-  totalSolutions: number,
-  baseConfig: { minOccurrences: number; minSuccessRate: number; minConfidence: number; pruneThreshold: number },
-): AdaptiveThresholds {
-  // Scale factor: 1.0 at 50 errors, increases with more data
-  const errorScale = Math.min(2.0, Math.max(0.5, totalErrors / 50));
-  const solutionScale = Math.min(2.0, Math.max(0.5, totalSolutions / 20));
-  const dataScale = (errorScale + solutionScale) / 2;
-
-  return {
-    // More data → require more occurrences before learning
-    minOccurrences: Math.max(2, Math.round(baseConfig.minOccurrences * dataScale)),
-    // More data → can afford higher success rate requirement
-    minSuccessRate: Math.min(0.95, baseConfig.minSuccessRate * (0.85 + dataScale * 0.15)),
-    // More data → higher confidence threshold
-    minConfidence: Math.min(0.90, baseConfig.minConfidence * (0.85 + dataScale * 0.15)),
-    // More data → stricter pruning
-    pruneThreshold: Math.max(0.10, baseConfig.pruneThreshold * (1.1 - dataScale * 0.1)),
-  };
-}

package/src/learning/decay.ts

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