@timmeck/brain 1.2.0 → 1.8.1

package/dist/types/config.types.d.ts

@@ -19,6 +19,8 @@ export interface MatchingConfig {
     fingerprintFields: string[];
     similarityThreshold: number;
     maxResults: number;
+    crossProjectMatching: boolean;
+    crossProjectWeight: number;
 }
 export interface CodeConfig {
     supportedLanguages: string[];
@@ -55,10 +57,29 @@ export interface RetentionConfig {
     solutionDays: number;
     insightDays: number;
 }
+export interface ApiConfig {
+    port: number;
+    enabled: boolean;
+    apiKey?: string;
+}
+export interface McpHttpConfig {
+    port: number;
+    enabled: boolean;
+}
+export interface EmbeddingsConfig {
+    enabled: boolean;
+    modelName: string;
+    cacheDir: string;
+    sweepIntervalMs: number;
+    batchSize: number;
+}
 export interface BrainConfig {
     dataDir: string;
     dbPath: string;
     ipc: IpcConfig;
+    api: ApiConfig;
+    mcpHttp: McpHttpConfig;
+    embeddings: EmbeddingsConfig;
     learning: LearningConfig;
     terminal: TerminalConfig;
     matching: MatchingConfig;

package/dist/types/synapse.types.d.ts

@@ -1,5 +1,5 @@
 export type NodeType = 'error' | 'solution' | 'code_module' | 'rule' | 'antipattern' | 'project' | 'insight';
-export type SynapseType = 'solves' | 'causes' | 'similar_to' | 'uses_module' | 'derived_from' | 'co_occurs' | 'prevents' | 'improves' | 'generalizes' | 'cross_project';
+export type SynapseType = 'solves' | 'causes' | 'similar_to' | 'uses_module' | 'depends_on' | 'derived_from' | 'co_occurs' | 'prevents' | 'improves' | 'generalizes' | 'cross_project';
 export interface SynapseRecord {
     id: number;
     source_type: NodeType;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@timmeck/brain",
-  "version": "1.2.0",
-  "description": "Adaptive error memory and code intelligence system with Hebbian synapse network for Claude Code",
+  "version": "1.8.1",
+  "description": "Adaptive error memory and code intelligence system with Hebbian synapse network, hybrid search, and REST API",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -19,7 +19,11 @@
     "claude-code",
     "hebbian-learning",
     "synapse-network",
-    "adaptive-learning"
+    "adaptive-learning",
+    "vector-search",
+    "embeddings",
+    "rest-api",
+    "developer-tools"
   ],
   "author": "Tim Mecklenburg",
   "license": "MIT",
@@ -28,6 +32,7 @@
     "url": "https://github.com/timmeck/brain"
   },
   "dependencies": {
+    "@huggingface/transformers": "^3.8.1",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "better-sqlite3": "^11.7.0",
     "chalk": "^5.6.2",

package/src/api/server.ts

@@ -0,0 +1,395 @@
+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

@@ -30,6 +30,7 @@ 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';
@@ -42,9 +43,19 @@ import { ResearchEngine } from './research/research-engine.js';
 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;
@@ -89,7 +100,7 @@ export class BrainCore {
 
     // 7. Services
     const services: Services = {
-      error: new ErrorService(errorRepo, projectRepo, synapseManager),
+      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),
@@ -102,9 +113,20 @@ export class BrainCore {
         ruleRepo, antipatternRepo, insightRepo,
         synapseManager,
       ),
+      git: new GitService(this.db!, synapseManager),
     };
 
-    // 8. Learning Engine
+    // 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,
@@ -112,7 +134,7 @@ export class BrainCore {
     this.learningEngine.start();
     logger.info(`Learning engine started (interval: ${config.learning.intervalMs}ms)`);
 
-    // 9. Research Engine
+    // 10. Research Engine
     this.researchEngine = new ResearchEngine(
       config.research, errorRepo, solutionRepo, projectRepo,
       codeModuleRepo, synapseRepo, insightRepo, synapseManager,
@@ -123,24 +145,42 @@ export class BrainCore {
     // Expose learning engine to IPC
     services.learning = this.learningEngine;
 
-    // 10. IPC Server
+    // 11. IPC Server
     const router = new IpcRouter(services);
     this.ipcServer = new IpcServer(router, config.ipc.pipeName);
     this.ipcServer.start();
 
-    // 11. Terminal cleanup timer
+    // 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);
 
-    // 12. Event listeners (synapse wiring)
+    // 13. Event listeners (synapse wiring)
     this.setupEventListeners(services, synapseManager);
 
-    // 13. PID file
+    // 14. PID file
     const pidPath = path.join(path.dirname(config.dbPath), 'brain.pid');
     fs.writeFileSync(pidPath, String(process.pid));
 
-    // 14. Graceful shutdown
+    // 15. Graceful shutdown
     process.on('SIGINT', () => this.stop());
     process.on('SIGTERM', () => this.stop());
 
@@ -157,7 +197,10 @@ export class BrainCore {
     }
 
     this.researchEngine?.stop();
+    this.embeddingEngine?.stop();
     this.learningEngine?.stop();
+    this.mcpHttpServer?.stop();
+    this.apiServer?.stop();
     this.ipcServer?.stop();
     this.db?.close();
 

package/src/cli/commands/dashboard.ts

@@ -9,6 +9,8 @@ export function dashboardCommand(): Command {
     .description('Generate and open the Brain dashboard with live data')
     .option('-o, --output <path>', 'Output HTML file path')
     .option('--no-open', 'Generate without opening in browser')
+    .option('-l, --live', 'Start live dashboard server with SSE updates')
+    .option('-p, --port <number>', 'Port for live dashboard', '7420')
     .action(async (opts) => {
       await withIpc(async (client) => {
         console.log(`${icons.chart}  ${c.info('Fetching data from Brain...')}`);
@@ -69,8 +71,43 @@ export function dashboardCommand(): Command {
           ? resolve(opts.output)
           : resolve(import.meta.dirname, '../../../dashboard.html');
 
-        writeFileSync(outPath, html, 'utf-8');
+        // Inject live SSE connection for --live mode
+        let finalHtml = html;
+        if (opts.live) {
+          const apiPort = opts.port || '7777';
+          const sseScript = `
+<script>
+(function(){
+  const evtSource = new EventSource('http://localhost:${apiPort}/api/v1/events');
+  evtSource.onmessage = function(e) {
+    try {
+      const data = JSON.parse(e.data);
+      if (data.type === 'stats_update') {
+        document.querySelectorAll('.stat-card').forEach(card => {
+          const label = card.querySelector('.stat-label')?.textContent?.toLowerCase();
+          const num = card.querySelector('.stat-number');
+          if (label && num && data.stats[label] !== undefined) {
+            num.textContent = Number(data.stats[label]).toLocaleString();
+          }
+        });
+      }
+      if (data.type === 'event') {
+        const dot = document.querySelector('.activity-dot');
+        if (dot) { dot.style.background = '#ff5577'; setTimeout(() => dot.style.background = '', 500); }
+      }
+    } catch {}
+  };
+  evtSource.onerror = function() { setTimeout(() => location.reload(), 5000); };
+})();
+</script>`;
+          finalHtml = html.replace('</body>', sseScript + '</body>');
+        }
+
+        writeFileSync(outPath, finalHtml, 'utf-8');
         console.log(`${icons.ok}  ${c.success('Dashboard written to')} ${c.dim(outPath)}`);
+        if (opts.live) {
+          console.log(`  ${c.info('Live mode:')} Connected to Brain daemon SSE on port ${opts.port || 7777}`);
+        }
         console.log(`  ${c.label('Modules:')} ${c.value(data.stats.modules)}  ${c.label('Synapses:')} ${c.value(data.stats.synapses)}  ${c.label('Insights:')} ${c.value(data.stats.insights)}`);
 
         if (opts.open !== false) {