@timmeck/brain 1.8.5 → 2.0.0

package/src/api/server.ts

@@ -1,395 +0,0 @@
-import http from 'node:http';
-import { getLogger } from '../utils/logger.js';
-import { getEventBus } from '../utils/events.js';
-import type { IpcRouter } from '../ipc/router.js';
-
-export interface ApiServerOptions {
-  port: number;
-  router: IpcRouter;
-  apiKey?: string;
-}
-
-interface RouteDefinition {
-  method: string;
-  pattern: RegExp;
-  ipcMethod: string;
-  extractParams: (match: RegExpMatchArray, query: URLSearchParams, body?: unknown) => unknown;
-}
-
-export class ApiServer {
-  private server: http.Server | null = null;
-  private logger = getLogger();
-  private routes: RouteDefinition[];
-  private sseClients: Set<http.ServerResponse> = new Set();
-  private statsTimer: ReturnType<typeof setInterval> | null = null;
-
-  constructor(private options: ApiServerOptions) {
-    this.routes = this.buildRoutes();
-  }
-
-  start(): void {
-    const { port, apiKey } = this.options;
-
-    this.server = http.createServer((req, res) => {
-      res.setHeader('Access-Control-Allow-Origin', '*');
-      res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
-      res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-API-Key');
-
-      if (req.method === 'OPTIONS') {
-        res.writeHead(204);
-        res.end();
-        return;
-      }
-
-      if (apiKey) {
-        const provided = (req.headers['x-api-key'] as string) ??
-          req.headers.authorization?.replace('Bearer ', '');
-        if (provided !== apiKey) {
-          this.json(res, 401, { error: 'Unauthorized', message: 'Invalid or missing API key' });
-          return;
-        }
-      }
-
-      this.handleRequest(req, res).catch((err) => {
-        this.logger.error('API error:', err);
-        this.json(res, 500, {
-          error: 'Internal Server Error',
-          message: err instanceof Error ? err.message : String(err),
-        });
-      });
-    });
-
-    this.server.listen(port, () => {
-      this.logger.info(`REST API server started on http://localhost:${port}`);
-    });
-
-    this.setupSSE();
-  }
-
-  stop(): void {
-    if (this.statsTimer) {
-      clearInterval(this.statsTimer);
-      this.statsTimer = null;
-    }
-    for (const client of this.sseClients) {
-      try { client.end(); } catch { /* ignore */ }
-    }
-    this.sseClients.clear();
-    this.server?.close();
-    this.server = null;
-    this.logger.info('REST API server stopped');
-  }
-
-  private async handleRequest(req: http.IncomingMessage, res: http.ServerResponse): Promise<void> {
-    const url = new URL(req.url ?? '/', 'http://localhost');
-    const pathname = url.pathname;
-    const method = req.method ?? 'GET';
-    const query = url.searchParams;
-
-    // Health check
-    if (pathname === '/api/v1/health') {
-      this.json(res, 200, { status: 'ok', timestamp: new Date().toISOString() });
-      return;
-    }
-
-    // SSE event stream (for live dashboard)
-    if (pathname === '/api/v1/events' && method === 'GET') {
-      res.writeHead(200, {
-        'Content-Type': 'text/event-stream',
-        'Cache-Control': 'no-cache',
-        'Connection': 'keep-alive',
-      });
-      res.write('data: {"type":"connected"}\n\n');
-      this.sseClients.add(res);
-      req.on('close', () => this.sseClients.delete(res));
-      return;
-    }
-
-    // List all available methods
-    if (pathname === '/api/v1/methods' && method === 'GET') {
-      const methods = this.options.router.listMethods();
-      this.json(res, 200, {
-        methods,
-        rpcEndpoint: '/api/v1/rpc',
-        usage: 'POST /api/v1/rpc with body { "method": "<method>", "params": {...} }',
-      });
-      return;
-    }
-
-    // Generic RPC endpoint — the universal gateway
-    if (pathname === '/api/v1/rpc' && method === 'POST') {
-      const body = await this.readBody(req);
-      if (!body) {
-        this.json(res, 400, { error: 'Bad Request', message: 'Empty request body' });
-        return;
-      }
-
-      const parsed = JSON.parse(body);
-
-      // Batch RPC support
-      if (Array.isArray(parsed)) {
-        const results = parsed.map((call: { method: string; params?: unknown; id?: string | number }) => {
-          try {
-            const result = this.options.router.handle(call.method, call.params ?? {});
-            return { id: call.id, result };
-          } catch (err) {
-            return { id: call.id, error: err instanceof Error ? err.message : String(err) };
-          }
-        });
-        this.json(res, 200, results);
-        return;
-      }
-
-      if (!parsed.method) {
-        this.json(res, 400, { error: 'Bad Request', message: 'Missing "method" field' });
-        return;
-      }
-
-      try {
-        const result = this.options.router.handle(parsed.method, parsed.params ?? {});
-        this.json(res, 200, { result });
-      } catch (err) {
-        this.json(res, 400, { error: err instanceof Error ? err.message : String(err) });
-      }
-      return;
-    }
-
-    // RESTful routes
-    let body: unknown = undefined;
-    if (method === 'POST' || method === 'PUT') {
-      try {
-        const raw = await this.readBody(req);
-        body = raw ? JSON.parse(raw) : {};
-      } catch {
-        this.json(res, 400, { error: 'Bad Request', message: 'Invalid JSON body' });
-        return;
-      }
-    }
-
-    for (const route of this.routes) {
-      if (route.method !== method) continue;
-      const match = pathname.match(route.pattern);
-      if (!match) continue;
-
-      try {
-        const params = route.extractParams(match, query, body);
-        const result = this.options.router.handle(route.ipcMethod, params);
-        this.json(res, method === 'POST' ? 201 : 200, { result });
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        const status = msg.startsWith('Unknown method') ? 404 : 400;
-        this.json(res, status, { error: msg });
-      }
-      return;
-    }
-
-    this.json(res, 404, { error: 'Not Found', message: `No route for ${method} ${pathname}` });
-  }
-
-  private buildRoutes(): RouteDefinition[] {
-    return [
-      // ─── Errors ────────────────────────────────────────────
-      { method: 'POST', pattern: /^\/api\/v1\/errors$/, ipcMethod: 'error.report',
-        extractParams: (_m, _q, body) => body },
-      { method: 'GET', pattern: /^\/api\/v1\/errors$/, ipcMethod: 'error.query',
-        extractParams: (_m, q) => ({
-          search: q.get('search') ?? '',
-          projectId: q.get('projectId') ? Number(q.get('projectId')) : undefined,
-        }) },
-      { method: 'GET', pattern: /^\/api\/v1\/errors\/(\d+)$/, ipcMethod: 'error.get',
-        extractParams: (m) => ({ id: Number(m[1]) }) },
-      { method: 'GET', pattern: /^\/api\/v1\/errors\/(\d+)\/match$/, ipcMethod: 'error.match',
-        extractParams: (m) => ({ errorId: Number(m[1]) }) },
-      { method: 'GET', pattern: /^\/api\/v1\/errors\/(\d+)\/chain$/, ipcMethod: 'error.chain',
-        extractParams: (m) => ({ errorId: Number(m[1]) }) },
-      { method: 'POST', pattern: /^\/api\/v1\/errors\/(\d+)\/resolve$/, ipcMethod: 'error.resolve',
-        extractParams: (m, _q, body) => ({ errorId: Number(m[1]), ...(body as object) }) },
-
-      // ─── Solutions ─────────────────────────────────────────
-      { method: 'POST', pattern: /^\/api\/v1\/solutions$/, ipcMethod: 'solution.report',
-        extractParams: (_m, _q, body) => body },
-      { method: 'GET', pattern: /^\/api\/v1\/solutions$/, ipcMethod: 'solution.query',
-        extractParams: (_m, q) => ({
-          errorId: q.get('errorId') ? Number(q.get('errorId')) : undefined,
-        }) },
-      { method: 'POST', pattern: /^\/api\/v1\/solutions\/rate$/, ipcMethod: 'solution.rate',
-        extractParams: (_m, _q, body) => body },
-      { method: 'GET', pattern: /^\/api\/v1\/solutions\/efficiency$/, ipcMethod: 'solution.efficiency',
-        extractParams: () => ({}) },
-
-      // ─── Projects ──────────────────────────────────────────
-      { method: 'GET', pattern: /^\/api\/v1\/projects$/, ipcMethod: 'project.list',
-        extractParams: () => ({}) },
-
-      // ─── Code ──────────────────────────────────────────────
-      { method: 'POST', pattern: /^\/api\/v1\/code\/analyze$/, ipcMethod: 'code.analyze',
-        extractParams: (_m, _q, body) => body },
-      { method: 'POST', pattern: /^\/api\/v1\/code\/find$/, ipcMethod: 'code.find',
-        extractParams: (_m, _q, body) => body },
-      { method: 'POST', pattern: /^\/api\/v1\/code\/similarity$/, ipcMethod: 'code.similarity',
-        extractParams: (_m, _q, body) => body },
-      { method: 'GET', pattern: /^\/api\/v1\/code\/modules$/, ipcMethod: 'code.modules',
-        extractParams: (_m, q) => ({
-          projectId: q.get('projectId') ? Number(q.get('projectId')) : undefined,
-          language: q.get('language') ?? undefined,
-          limit: q.get('limit') ? Number(q.get('limit')) : undefined,
-        }) },
-      { method: 'GET', pattern: /^\/api\/v1\/code\/(\d+)$/, ipcMethod: 'code.get',
-        extractParams: (m) => ({ id: Number(m[1]) }) },
-
-      // ─── Prevention ────────────────────────────────────────
-      { method: 'POST', pattern: /^\/api\/v1\/prevention\/check$/, ipcMethod: 'prevention.check',
-        extractParams: (_m, _q, body) => body },
-      { method: 'POST', pattern: /^\/api\/v1\/prevention\/antipatterns$/, ipcMethod: 'prevention.antipatterns',
-        extractParams: (_m, _q, body) => body },
-      { method: 'POST', pattern: /^\/api\/v1\/prevention\/code$/, ipcMethod: 'prevention.checkCode',
-        extractParams: (_m, _q, body) => body },
-
-      // ─── Synapses ─────────────────────────────────────────
-      { method: 'GET', pattern: /^\/api\/v1\/synapses\/context\/(\d+)$/, ipcMethod: 'synapse.context',
-        extractParams: (m) => ({ errorId: Number(m[1]) }) },
-      { method: 'POST', pattern: /^\/api\/v1\/synapses\/path$/, ipcMethod: 'synapse.path',
-        extractParams: (_m, _q, body) => body },
-      { method: 'POST', pattern: /^\/api\/v1\/synapses\/related$/, ipcMethod: 'synapse.related',
-        extractParams: (_m, _q, body) => body },
-      { method: 'GET', pattern: /^\/api\/v1\/synapses\/stats$/, ipcMethod: 'synapse.stats',
-        extractParams: () => ({}) },
-
-      // ─── Research ──────────────────────────────────────────
-      { method: 'GET', pattern: /^\/api\/v1\/research\/insights$/, ipcMethod: 'research.insights',
-        extractParams: (_m, q) => ({
-          type: q.get('type') ?? undefined,
-          limit: q.get('limit') ? Number(q.get('limit')) : 20,
-          activeOnly: q.get('activeOnly') !== 'false',
-        }) },
-      { method: 'POST', pattern: /^\/api\/v1\/research\/insights\/(\d+)\/rate$/, ipcMethod: 'insight.rate',
-        extractParams: (m, _q, body) => ({ id: Number(m[1]), ...(body as object) }) },
-      { method: 'GET', pattern: /^\/api\/v1\/research\/suggest$/, ipcMethod: 'research.suggest',
-        extractParams: (_m, q) => ({
-          context: q.get('context') ?? '',
-          limit: 10,
-          activeOnly: true,
-        }) },
-      { method: 'GET', pattern: /^\/api\/v1\/research\/trends$/, ipcMethod: 'research.trends',
-        extractParams: (_m, q) => ({
-          projectId: q.get('projectId') ? Number(q.get('projectId')) : undefined,
-          windowDays: q.get('windowDays') ? Number(q.get('windowDays')) : undefined,
-        }) },
-
-      // ─── Notifications ────────────────────────────────────
-      { method: 'GET', pattern: /^\/api\/v1\/notifications$/, ipcMethod: 'notification.list',
-        extractParams: (_m, q) => ({
-          projectId: q.get('projectId') ? Number(q.get('projectId')) : undefined,
-        }) },
-      { method: 'POST', pattern: /^\/api\/v1\/notifications\/(\d+)\/ack$/, ipcMethod: 'notification.ack',
-        extractParams: (m) => ({ id: Number(m[1]) }) },
-
-      // ─── Analytics ─────────────────────────────────────────
-      { method: 'GET', pattern: /^\/api\/v1\/analytics\/summary$/, ipcMethod: 'analytics.summary',
-        extractParams: (_m, q) => ({
-          projectId: q.get('projectId') ? Number(q.get('projectId')) : undefined,
-        }) },
-      { method: 'GET', pattern: /^\/api\/v1\/analytics\/network$/, ipcMethod: 'analytics.network',
-        extractParams: (_m, q) => ({
-          limit: q.get('limit') ? Number(q.get('limit')) : undefined,
-        }) },
-      { method: 'GET', pattern: /^\/api\/v1\/analytics\/health$/, ipcMethod: 'analytics.health',
-        extractParams: (_m, q) => ({
-          projectId: q.get('projectId') ? Number(q.get('projectId')) : undefined,
-        }) },
-      { method: 'GET', pattern: /^\/api\/v1\/analytics\/timeline$/, ipcMethod: 'analytics.timeline',
-        extractParams: (_m, q) => ({
-          projectId: q.get('projectId') ? Number(q.get('projectId')) : undefined,
-          days: q.get('days') ? Number(q.get('days')) : undefined,
-        }) },
-      { method: 'GET', pattern: /^\/api\/v1\/analytics\/explain\/(\d+)$/, ipcMethod: 'analytics.explain',
-        extractParams: (m) => ({ errorId: Number(m[1]) }) },
-
-      // ─── Git ───────────────────────────────────────────────
-      { method: 'GET', pattern: /^\/api\/v1\/git\/context$/, ipcMethod: 'git.context',
-        extractParams: (_m, q) => ({ cwd: q.get('cwd') ?? undefined }) },
-      { method: 'POST', pattern: /^\/api\/v1\/git\/link-error$/, ipcMethod: 'git.linkError',
-        extractParams: (_m, _q, body) => body },
-      { method: 'GET', pattern: /^\/api\/v1\/git\/errors\/(\d+)\/commits$/, ipcMethod: 'git.errorCommits',
-        extractParams: (m) => ({ errorId: Number(m[1]) }) },
-      { method: 'GET', pattern: /^\/api\/v1\/git\/commits\/([a-f0-9]+)\/errors$/, ipcMethod: 'git.commitErrors',
-        extractParams: (m) => ({ commitHash: m[1] }) },
-      { method: 'GET', pattern: /^\/api\/v1\/git\/diff$/, ipcMethod: 'git.diff',
-        extractParams: (_m, q) => ({ cwd: q.get('cwd') ?? undefined }) },
-
-      // ─── Terminal ──────────────────────────────────────────
-      { method: 'POST', pattern: /^\/api\/v1\/terminal\/register$/, ipcMethod: 'terminal.register',
-        extractParams: (_m, _q, body) => body },
-      { method: 'POST', pattern: /^\/api\/v1\/terminal\/heartbeat$/, ipcMethod: 'terminal.heartbeat',
-        extractParams: (_m, _q, body) => body },
-      { method: 'POST', pattern: /^\/api\/v1\/terminal\/disconnect$/, ipcMethod: 'terminal.disconnect',
-        extractParams: (_m, _q, body) => body },
-
-      // ─── Learning ──────────────────────────────────────────
-      { method: 'POST', pattern: /^\/api\/v1\/learning\/run$/, ipcMethod: 'learning.run',
-        extractParams: () => ({}) },
-    ];
-  }
-
-  private json(res: http.ServerResponse, status: number, data: unknown): void {
-    res.writeHead(status, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify(data));
-  }
-
-  private readBody(req: http.IncomingMessage): Promise<string> {
-    return new Promise((resolve, reject) => {
-      const chunks: Buffer[] = [];
-      req.on('data', (chunk: Buffer) => chunks.push(chunk));
-      req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
-      req.on('error', reject);
-    });
-  }
-
-  private setupSSE(): void {
-    const bus = getEventBus();
-    const eventNames = [
-      'error:reported', 'error:resolved', 'solution:applied',
-      'solution:created', 'module:registered', 'module:updated',
-      'synapse:created', 'synapse:strengthened',
-      'insight:created', 'rule:learned',
-    ] as const;
-
-    for (const eventName of eventNames) {
-      bus.on(eventName, (data: unknown) => {
-        this.broadcastSSE({ type: 'event', event: eventName, data });
-      });
-    }
-
-    // Periodic stats broadcast every 30s
-    this.statsTimer = setInterval(() => {
-      if (this.sseClients.size > 0) {
-        try {
-          // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          const summary = this.options.router.handle('analytics.summary', {}) as any;
-          // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          const network = this.options.router.handle('synapse.stats', {}) as any;
-          const stats = {
-            modules: summary?.modules?.total ?? 0,
-            synapses: network?.totalSynapses ?? 0,
-            errors: summary?.errors?.total ?? 0,
-            solutions: summary?.solutions?.total ?? 0,
-            rules: summary?.rules?.active ?? 0,
-            insights: summary?.insights?.total ?? 0,
-          };
-          this.broadcastSSE({ type: 'stats_update', stats });
-        } catch { /* ignore stats errors */ }
-      }
-    }, 30_000);
-  }
-
-  private broadcastSSE(data: unknown): void {
-    const msg = `data: ${JSON.stringify(data)}\n\n`;
-    for (const client of this.sseClients) {
-      try {
-        client.write(msg);
-      } catch {
-        this.sseClients.delete(client);
-      }
-    }
-  }
-}

package/src/brain.ts

@@ -1,266 +0,0 @@
-import path from 'node:path';
-import fs from 'node:fs';
-import type Database from 'better-sqlite3';
-import { loadConfig } from './config.js';
-import type { BrainConfig } from './types/config.types.js';
-import { createLogger, getLogger } from './utils/logger.js';
-import { getEventBus } from './utils/events.js';
-import { createConnection } from './db/connection.js';
-import { runMigrations } from './db/migrations/index.js';
-
-// Repositories
-import { ProjectRepository } from './db/repositories/project.repository.js';
-import { ErrorRepository } from './db/repositories/error.repository.js';
-import { SolutionRepository } from './db/repositories/solution.repository.js';
-import { RuleRepository } from './db/repositories/rule.repository.js';
-import { AntipatternRepository } from './db/repositories/antipattern.repository.js';
-import { TerminalRepository } from './db/repositories/terminal.repository.js';
-import { CodeModuleRepository } from './db/repositories/code-module.repository.js';
-import { SynapseRepository } from './db/repositories/synapse.repository.js';
-import { NotificationRepository } from './db/repositories/notification.repository.js';
-import { InsightRepository } from './db/repositories/insight.repository.js';
-
-// Services
-import { ErrorService } from './services/error.service.js';
-import { SolutionService } from './services/solution.service.js';
-import { TerminalService } from './services/terminal.service.js';
-import { PreventionService } from './services/prevention.service.js';
-import { CodeService } from './services/code.service.js';
-import { SynapseService } from './services/synapse.service.js';
-import { ResearchService } from './services/research.service.js';
-import { NotificationService } from './services/notification.service.js';
-import { AnalyticsService } from './services/analytics.service.js';
-import { GitService } from './services/git.service.js';
-
-// Synapses
-import { SynapseManager } from './synapses/synapse-manager.js';
-
-// Engines
-import { LearningEngine } from './learning/learning-engine.js';
-import { ResearchEngine } from './research/research-engine.js';
-
-// IPC
-import { IpcRouter, type Services } from './ipc/router.js';
-import { IpcServer } from './ipc/server.js';
-
-// API & MCP HTTP
-import { ApiServer } from './api/server.js';
-import { McpHttpServer } from './mcp/http-server.js';
-
-// Embeddings
-import { EmbeddingEngine } from './embeddings/engine.js';
-
-export class BrainCore {
-  private db: Database.Database | null = null;
-  private ipcServer: IpcServer | null = null;
-  private apiServer: ApiServer | null = null;
-  private mcpHttpServer: McpHttpServer | null = null;
-  private embeddingEngine: EmbeddingEngine | null = null;
-  private learningEngine: LearningEngine | null = null;
-  private researchEngine: ResearchEngine | null = null;
-  private cleanupTimer: ReturnType<typeof setInterval> | null = null;
-  private config: BrainConfig | null = null;
-
-  start(configPath?: string): void {
-    // 1. Config
-    this.config = loadConfig(configPath);
-    const config = this.config;
-
-    // 2. Ensure data dir
-    fs.mkdirSync(path.dirname(config.dbPath), { recursive: true });
-
-    // 3. Logger
-    createLogger({
-      level: config.log.level,
-      file: config.log.file,
-      maxSize: config.log.maxSize,
-      maxFiles: config.log.maxFiles,
-    });
-    const logger = getLogger();
-
-    // 4. Database
-    this.db = createConnection(config.dbPath);
-    runMigrations(this.db);
-    logger.info(`Database initialized: ${config.dbPath}`);
-
-    // 5. Repositories
-    const projectRepo = new ProjectRepository(this.db);
-    const errorRepo = new ErrorRepository(this.db);
-    const solutionRepo = new SolutionRepository(this.db);
-    const ruleRepo = new RuleRepository(this.db);
-    const antipatternRepo = new AntipatternRepository(this.db);
-    const terminalRepo = new TerminalRepository(this.db);
-    const codeModuleRepo = new CodeModuleRepository(this.db);
-    const synapseRepo = new SynapseRepository(this.db);
-    const notificationRepo = new NotificationRepository(this.db);
-    const insightRepo = new InsightRepository(this.db);
-
-    // 6. Synapse Manager
-    const synapseManager = new SynapseManager(synapseRepo, config.synapses);
-
-    // 7. Services
-    const services: Services = {
-      error: new ErrorService(errorRepo, projectRepo, synapseManager, config.matching),
-      solution: new SolutionService(solutionRepo, synapseManager),
-      terminal: new TerminalService(terminalRepo, config.terminal.staleTimeout),
-      prevention: new PreventionService(ruleRepo, antipatternRepo, synapseManager),
-      code: new CodeService(codeModuleRepo, projectRepo, synapseManager),
-      synapse: new SynapseService(synapseManager),
-      research: new ResearchService(insightRepo, errorRepo, synapseManager),
-      notification: new NotificationService(notificationRepo),
-      analytics: new AnalyticsService(
-        errorRepo, solutionRepo, codeModuleRepo,
-        ruleRepo, antipatternRepo, insightRepo,
-        synapseManager,
-      ),
-      git: new GitService(this.db!, synapseManager),
-    };
-
-    // 8. Embedding Engine (local vector search)
-    if (config.embeddings.enabled) {
-      this.embeddingEngine = new EmbeddingEngine(config.embeddings, this.db!);
-      this.embeddingEngine.start();
-      // Wire embedding engine into services for hybrid search
-      services.error.setEmbeddingEngine(this.embeddingEngine);
-      services.code.setEmbeddingEngine(this.embeddingEngine);
-      logger.info('Embedding engine started (model will load in background)');
-    }
-
-    // 9. Learning Engine
-    this.learningEngine = new LearningEngine(
-      config.learning, errorRepo, solutionRepo,
-      ruleRepo, antipatternRepo, synapseManager,
-    );
-    this.learningEngine.start();
-    logger.info(`Learning engine started (interval: ${config.learning.intervalMs}ms)`);
-
-    // 10. Research Engine
-    this.researchEngine = new ResearchEngine(
-      config.research, errorRepo, solutionRepo, projectRepo,
-      codeModuleRepo, synapseRepo, insightRepo, synapseManager,
-    );
-    this.researchEngine.start();
-    logger.info(`Research engine started (interval: ${config.research.intervalMs}ms)`);
-
-    // Expose learning engine to IPC
-    services.learning = this.learningEngine;
-
-    // 11. IPC Server
-    const router = new IpcRouter(services);
-    this.ipcServer = new IpcServer(router, config.ipc.pipeName);
-    this.ipcServer.start();
-
-    // 11a. REST API Server
-    if (config.api.enabled) {
-      this.apiServer = new ApiServer({
-        port: config.api.port,
-        router,
-        apiKey: config.api.apiKey,
-      });
-      this.apiServer.start();
-      logger.info(`REST API enabled on port ${config.api.port}`);
-    }
-
-    // 11b. MCP HTTP Server (SSE transport for Cursor, Windsurf, Cline, Continue)
-    if (config.mcpHttp.enabled) {
-      this.mcpHttpServer = new McpHttpServer(config.mcpHttp.port, router);
-      this.mcpHttpServer.start();
-      logger.info(`MCP HTTP (SSE) enabled on port ${config.mcpHttp.port}`);
-    }
-
-    // 12. Terminal cleanup timer
-    this.cleanupTimer = setInterval(() => {
-      services.terminal.cleanup();
-    }, 60_000);
-
-    // 13. Event listeners (synapse wiring)
-    this.setupEventListeners(services, synapseManager);
-
-    // 14. PID file
-    const pidPath = path.join(path.dirname(config.dbPath), 'brain.pid');
-    fs.writeFileSync(pidPath, String(process.pid));
-
-    // 15. Graceful shutdown
-    process.on('SIGINT', () => this.stop());
-    process.on('SIGTERM', () => this.stop());
-
-    logger.info(`Brain daemon started (PID: ${process.pid})`);
-  }
-
-  stop(): void {
-    const logger = getLogger();
-    logger.info('Shutting down...');
-
-    if (this.cleanupTimer) {
-      clearInterval(this.cleanupTimer);
-      this.cleanupTimer = null;
-    }
-
-    this.researchEngine?.stop();
-    this.embeddingEngine?.stop();
-    this.learningEngine?.stop();
-    this.mcpHttpServer?.stop();
-    this.apiServer?.stop();
-    this.ipcServer?.stop();
-    this.db?.close();
-
-    // Remove PID file
-    if (this.config) {
-      const pidPath = path.join(path.dirname(this.config.dbPath), 'brain.pid');
-      try { fs.unlinkSync(pidPath); } catch { /* ignore */ }
-    }
-
-    logger.info('Brain daemon stopped');
-    process.exit(0);
-  }
-
-  private setupEventListeners(services: Services, synapseManager: SynapseManager): void {
-    const bus = getEventBus();
-
-    // Error → Project synapse
-    bus.on('error:reported', ({ errorId, projectId }) => {
-      synapseManager.strengthen(
-        { type: 'error', id: errorId },
-        { type: 'project', id: projectId },
-        'co_occurs',
-      );
-    });
-
-    // Solution applied → strengthen or weaken
-    bus.on('solution:applied', ({ errorId, solutionId, success }) => {
-      if (success) {
-        synapseManager.strengthen(
-          { type: 'solution', id: solutionId },
-          { type: 'error', id: errorId },
-          'solves',
-        );
-      } else {
-        const synapse = synapseManager.find(
-          { type: 'solution', id: solutionId },
-          { type: 'error', id: errorId },
-          'solves',
-        );
-        if (synapse) synapseManager.weaken(synapse.id, 0.7);
-      }
-    });
-
-    // Module registered → link to project
-    bus.on('module:registered', ({ moduleId, projectId }) => {
-      synapseManager.strengthen(
-        { type: 'code_module', id: moduleId },
-        { type: 'project', id: projectId },
-        'co_occurs',
-      );
-    });
-
-    // Rule learned → log
-    bus.on('rule:learned', ({ ruleId, pattern }) => {
-      getLogger().info(`New rule #${ruleId} learned: ${pattern}`);
-    });
-
-    // Insight created → log
-    bus.on('insight:created', ({ insightId, type }) => {
-      getLogger().info(`New insight #${insightId} (${type})`);
-    });
-  }
-}