@timmeck/brain 1.8.1 → 1.8.3

package/src/ipc/client.ts

@@ -1,118 +1,118 @@
-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);
-    }
-  }
-}
+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 +1,35 @@
-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);
-  }
-}
+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 +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();
+      }],
+    ]);
+  }
+}