@timmeck/brain 1.0.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,8 @@
+import winston from 'winston';
+export declare function createLogger(opts?: {
+    level?: string;
+    file?: string;
+    maxSize?: number;
+    maxFiles?: number;
+}): winston.Logger;
+export declare function getLogger(): winston.Logger;

package/dist/utils/logger.js

@@ -0,0 +1,39 @@
+import winston from 'winston';
+import path from 'node:path';
+import { getDataDir } from './paths.js';
+const { combine, timestamp, printf, colorize } = winston.format;
+const logFormat = printf(({ level, message, timestamp, ...meta }) => {
+    const metaStr = Object.keys(meta).length ? ` ${JSON.stringify(meta)}` : '';
+    return `${timestamp} [${level}]${metaStr} ${message}`;
+});
+let loggerInstance = null;
+export function createLogger(opts) {
+    if (loggerInstance)
+        return loggerInstance;
+    const level = opts?.level ?? process.env['BRAIN_LOG_LEVEL'] ?? 'info';
+    const logFile = opts?.file ?? path.join(getDataDir(), 'brain.log');
+    const maxSize = opts?.maxSize ?? 10 * 1024 * 1024; // 10MB
+    const maxFiles = opts?.maxFiles ?? 3;
+    const transports = [
+        new winston.transports.File({
+            filename: logFile,
+            maxsize: maxSize,
+            maxFiles,
+            format: combine(timestamp(), logFormat),
+        }),
+    ];
+    if (process.env['NODE_ENV'] !== 'production') {
+        transports.push(new winston.transports.Console({
+            format: combine(colorize(), timestamp(), logFormat),
+        }));
+    }
+    loggerInstance = winston.createLogger({ level, transports });
+    return loggerInstance;
+}
+export function getLogger() {
+    if (!loggerInstance) {
+        return createLogger();
+    }
+    return loggerInstance;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;AAEhE,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE;IAClE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,OAAO,GAAG,SAAS,KAAK,KAAK,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;AACxD,CAAC,CAAC,CAAC;AAEH,IAAI,cAAc,GAA0B,IAAI,CAAC;AAEjD,MAAM,UAAU,YAAY,CAAC,IAA6E;IACxG,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAAC;IACtE,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,WAAW,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO;IAC1D,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC;IAErC,MAAM,UAAU,GAAwB;QACtC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAC1B,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,OAAO;YAChB,QAAQ;YACR,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,CAAC;SACxC,CAAC;KACH,CAAC;IAEF,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY,EAAE,CAAC;QAC7C,UAAU,CAAC,IAAI,CACb,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC;SACpD,CAAC,CACH,CAAC;IACJ,CAAC;IAED,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7D,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,YAAY,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizePath(filePath: string): string;
+export declare function getDataDir(): string;
+export declare function getPipeName(name?: string): string;

package/dist/utils/paths.js

@@ -0,0 +1,18 @@
+import path from 'node:path';
+import os from 'node:os';
+export function normalizePath(filePath) {
+    return filePath.replace(/\\/g, '/');
+}
+export function getDataDir() {
+    const envDir = process.env['BRAIN_DATA_DIR'];
+    if (envDir)
+        return path.resolve(envDir);
+    return path.join(os.homedir(), '.brain');
+}
+export function getPipeName(name = 'brain') {
+    if (process.platform === 'win32') {
+        return `\\\\.\\pipe\\${name}`;
+    }
+    return path.join(os.tmpdir(), `${name}.sock`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,OAAO;IAChD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,gBAAgB,IAAI,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@timmeck/brain",
+  "version": "1.0.0",
+  "description": "Adaptive error memory and code intelligence system with Hebbian synapse network for Claude Code",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "brain": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest"
+  },
+  "keywords": [
+    "error-memory",
+    "code-intelligence",
+    "mcp",
+    "claude-code",
+    "hebbian-learning",
+    "synapse-network",
+    "adaptive-learning"
+  ],
+  "author": "Tim Mecklenburg",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/timmeck/brain"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.7.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "commander": "^13.0.0",
+    "winston": "^3.17.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "@types/better-sqlite3": "^7.6.12",
+    "tsx": "^4.19.0",
+    "vitest": "^3.0.0"
+  }
+}

package/src/brain.ts

@@ -0,0 +1,220 @@
+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';
+
+// 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';
+
+export class BrainCore {
+  private db: Database.Database | null = null;
+  private ipcServer: IpcServer | 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),
+      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,
+      ),
+    };
+
+    // 8. 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)`);
+
+    // 9. 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)`);
+
+    // 10. IPC Server
+    const router = new IpcRouter(services);
+    this.ipcServer = new IpcServer(router, config.ipc.pipeName);
+    this.ipcServer.start();
+
+    // 11. Terminal cleanup timer
+    this.cleanupTimer = setInterval(() => {
+      services.terminal.cleanup();
+    }, 60_000);
+
+    // 12. Event listeners (synapse wiring)
+    this.setupEventListeners(services, synapseManager);
+
+    // 13. PID file
+    const pidPath = path.join(path.dirname(config.dbPath), 'brain.pid');
+    fs.writeFileSync(pidPath, String(process.pid));
+
+    // 14. 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.learningEngine?.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})`);
+    });
+  }
+}