@timmeck/brain 1.8.0 → 1.8.2

package/src/ipc/router.ts

@@ -1,133 +1,133 @@
-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();
-      }],
-    ]);
-  }
-}
+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,110 +1,176 @@
-import net from 'node:net';
-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.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);
-      });
-    });
-
-    this.server.on('error', (err) => {
-      logger.error('IPC server error:', err);
-    });
-
-    this.server.listen(this.pipeName, () => {
-      logger.info(`IPC server 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');
-  }
-}
+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/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;
+}