@timmeck/brain 1.0.0 → 1.1.0

package/src/db/repositories/terminal.repository.ts

@@ -1,101 +1,101 @@
-import type Database from 'better-sqlite3';
-import type { Statement } from 'better-sqlite3';
-
-export interface TerminalRecord {
-  id: number;
-  uuid: string;
-  project_id: number | null;
-  pid: number | null;
-  shell: string | null;
-  cwd: string | null;
-  connected_at: string;
-  last_seen: string;
-  disconnected_at: string | null;
-}
-
-type CreateTerminalData = Omit<TerminalRecord, 'id' | 'connected_at' | 'last_seen' | 'disconnected_at'>;
-type UpdateTerminalData = Partial<Omit<TerminalRecord, 'id' | 'connected_at'>>;
-
-export class TerminalRepository {
-  private stmts: Record<string, Statement>;
-
-  constructor(private db: Database.Database) {
-    this.stmts = {
-      create: this.db.prepare(`
-        INSERT INTO terminals (uuid, project_id, pid, shell, cwd)
-        VALUES (@uuid, @project_id, @pid, @shell, @cwd)
-      `),
-      getById: this.db.prepare(`
-        SELECT * FROM terminals WHERE id = ?
-      `),
-      update: this.db.prepare(`
-        UPDATE terminals
-        SET project_id = COALESCE(@project_id, project_id),
-            pid = COALESCE(@pid, pid),
-            shell = COALESCE(@shell, shell),
-            cwd = COALESCE(@cwd, cwd),
-            last_seen = COALESCE(@last_seen, last_seen),
-            disconnected_at = COALESCE(@disconnected_at, disconnected_at)
-        WHERE id = @id
-      `),
-      delete: this.db.prepare(`
-        DELETE FROM terminals WHERE id = ?
-      `),
-      findByUuid: this.db.prepare(`
-        SELECT * FROM terminals WHERE uuid = ?
-      `),
-      findConnected: this.db.prepare(`
-        SELECT * FROM terminals WHERE disconnected_at IS NULL ORDER BY connected_at DESC
-      `),
-      cleanupStale: this.db.prepare(`
-        UPDATE terminals
-        SET disconnected_at = datetime('now')
-        WHERE disconnected_at IS NULL AND last_seen < ?
-      `),
-    };
-  }
-
-  create(data: CreateTerminalData): number {
-    const result = this.stmts.create.run({
-      uuid: data.uuid,
-      project_id: data.project_id ?? null,
-      pid: data.pid ?? null,
-      shell: data.shell ?? null,
-      cwd: data.cwd ?? null,
-    });
-    return result.lastInsertRowid as number;
-  }
-
-  getById(id: number): TerminalRecord | undefined {
-    return this.stmts.getById.get(id) as TerminalRecord | undefined;
-  }
-
-  update(id: number, data: UpdateTerminalData): void {
-    this.stmts.update.run({
-      id,
-      project_id: data.project_id ?? null,
-      pid: data.pid ?? null,
-      shell: data.shell ?? null,
-      cwd: data.cwd ?? null,
-      last_seen: data.last_seen ?? null,
-      disconnected_at: data.disconnected_at ?? null,
-    });
-  }
-
-  delete(id: number): void {
-    this.stmts.delete.run(id);
-  }
-
-  findByUuid(uuid: string): TerminalRecord | undefined {
-    return this.stmts.findByUuid.get(uuid) as TerminalRecord | undefined;
-  }
-
-  findConnected(): TerminalRecord[] {
-    return this.stmts.findConnected.all() as TerminalRecord[];
-  }
-
-  cleanupStale(olderThan: string): number {
-    const result = this.stmts.cleanupStale.run(olderThan);
-    return result.changes;
-  }
-}
+import type Database from 'better-sqlite3';
+import type { Statement } from 'better-sqlite3';
+
+export interface TerminalRecord {
+  id: number;
+  uuid: string;
+  project_id: number | null;
+  pid: number | null;
+  shell: string | null;
+  cwd: string | null;
+  connected_at: string;
+  last_seen: string;
+  disconnected_at: string | null;
+}
+
+type CreateTerminalData = Omit<TerminalRecord, 'id' | 'connected_at' | 'last_seen' | 'disconnected_at'>;
+type UpdateTerminalData = Partial<Omit<TerminalRecord, 'id' | 'connected_at'>>;
+
+export class TerminalRepository {
+  private stmts: Record<string, Statement>;
+
+  constructor(private db: Database.Database) {
+    this.stmts = {
+      create: this.db.prepare(`
+        INSERT INTO terminals (uuid, project_id, pid, shell, cwd)
+        VALUES (@uuid, @project_id, @pid, @shell, @cwd)
+      `),
+      getById: this.db.prepare(`
+        SELECT * FROM terminals WHERE id = ?
+      `),
+      update: this.db.prepare(`
+        UPDATE terminals
+        SET project_id = COALESCE(@project_id, project_id),
+            pid = COALESCE(@pid, pid),
+            shell = COALESCE(@shell, shell),
+            cwd = COALESCE(@cwd, cwd),
+            last_seen = COALESCE(@last_seen, last_seen),
+            disconnected_at = COALESCE(@disconnected_at, disconnected_at)
+        WHERE id = @id
+      `),
+      delete: this.db.prepare(`
+        DELETE FROM terminals WHERE id = ?
+      `),
+      findByUuid: this.db.prepare(`
+        SELECT * FROM terminals WHERE uuid = ?
+      `),
+      findConnected: this.db.prepare(`
+        SELECT * FROM terminals WHERE disconnected_at IS NULL ORDER BY connected_at DESC
+      `),
+      cleanupStale: this.db.prepare(`
+        UPDATE terminals
+        SET disconnected_at = datetime('now')
+        WHERE disconnected_at IS NULL AND last_seen < ?
+      `),
+    };
+  }
+
+  create(data: CreateTerminalData): number {
+    const result = this.stmts.create.run({
+      uuid: data.uuid,
+      project_id: data.project_id ?? null,
+      pid: data.pid ?? null,
+      shell: data.shell ?? null,
+      cwd: data.cwd ?? null,
+    });
+    return result.lastInsertRowid as number;
+  }
+
+  getById(id: number): TerminalRecord | undefined {
+    return this.stmts.getById.get(id) as TerminalRecord | undefined;
+  }
+
+  update(id: number, data: UpdateTerminalData): void {
+    this.stmts.update.run({
+      id,
+      project_id: data.project_id ?? null,
+      pid: data.pid ?? null,
+      shell: data.shell ?? null,
+      cwd: data.cwd ?? null,
+      last_seen: data.last_seen ?? null,
+      disconnected_at: data.disconnected_at ?? null,
+    });
+  }
+
+  delete(id: number): void {
+    this.stmts.delete.run(id);
+  }
+
+  findByUuid(uuid: string): TerminalRecord | undefined {
+    return this.stmts.findByUuid.get(uuid) as TerminalRecord | undefined;
+  }
+
+  findConnected(): TerminalRecord[] {
+    return this.stmts.findConnected.all() as TerminalRecord[];
+  }
+
+  cleanupStale(olderThan: string): number {
+    const result = this.stmts.cleanupStale.run(olderThan);
+    return result.changes;
+  }
+}

package/src/hooks/post-tool-use.ts

@@ -1,90 +1,90 @@
-#!/usr/bin/env node
-
-// PostToolUse hook for Bash tool — auto-detects errors and reports to Brain
-// Configured in .claude/settings.json:
-// { "hooks": { "PostToolUse": [{ "matcher": { "tool_name": "Bash" }, "command": "node <brain-dist>/hooks/post-tool-use.js" }] } }
-
-import { IpcClient } from '../ipc/client.js';
-import { getPipeName } from '../utils/paths.js';
-
-interface HookInput {
-  tool_name: string;
-  tool_input: { command?: string };
-  tool_output: string;
-  exit_code?: number;
-}
-
-const ERROR_PATTERNS = [
-  /Error:/i,
-  /error\[E\d+\]/,
-  /Traceback \(most recent call last\)/,
-  /FATAL|PANIC/i,
-  /npm ERR!/,
-  /SyntaxError|TypeError|ReferenceError|RangeError/,
-  /ENOENT|EACCES|ECONNREFUSED|ETIMEDOUT/,
-  /ModuleNotFoundError|ImportError/,
-  /failed to compile/i,
-  /BUILD FAILED/i,
-  /Cannot find module/,
-  /command not found/,
-  /Permission denied/,
-];
-
-function isError(input: HookInput): boolean {
-  if (input.exit_code !== undefined && input.exit_code !== 0) return true;
-  return ERROR_PATTERNS.some(p => p.test(input.tool_output));
-}
-
-function readStdin(): Promise<string> {
-  return new Promise((resolve) => {
-    let data = '';
-    process.stdin.setEncoding('utf8');
-    process.stdin.on('data', (chunk) => { data += chunk; });
-    process.stdin.on('end', () => resolve(data));
-  });
-}
-
-async function main(): Promise<void> {
-  const raw = await readStdin();
-  if (!raw.trim()) return;
-
-  let input: HookInput;
-  try {
-    input = JSON.parse(raw);
-  } catch {
-    return;
-  }
-
-  if (!isError(input)) return;
-
-  const client = new IpcClient(getPipeName(), 3000);
-  try {
-    await client.connect();
-
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const result: any = await client.request('error.report', {
-      project: 'auto-detected',
-      errorOutput: input.tool_output,
-    });
-
-    if (result.matches?.length > 0) {
-      const best = result.matches[0];
-      process.stderr.write(`Brain: Similar error found (#${best.errorId}, ${Math.round(best.score * 100)}% match)\n`);
-    }
-
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const antipatterns: any = await client.request('prevention.antipatterns', {
-      errorType: '',
-      message: input.tool_output,
-    });
-    if (antipatterns?.length > 0 && antipatterns[0].matched) {
-      process.stderr.write(`Brain WARNING: Known anti-pattern: ${antipatterns[0].description}\n`);
-    }
-  } catch {
-    // Hook must never block workflow
-  } finally {
-    client.disconnect();
-  }
-}
-
-main();
+#!/usr/bin/env node
+
+// PostToolUse hook for Bash tool — auto-detects errors and reports to Brain
+// Configured in .claude/settings.json:
+// { "hooks": { "PostToolUse": [{ "matcher": { "tool_name": "Bash" }, "command": "node <brain-dist>/hooks/post-tool-use.js" }] } }
+
+import { IpcClient } from '../ipc/client.js';
+import { getPipeName } from '../utils/paths.js';
+
+interface HookInput {
+  tool_name: string;
+  tool_input: { command?: string };
+  tool_output: string;
+  exit_code?: number;
+}
+
+const ERROR_PATTERNS = [
+  /Error:/i,
+  /error\[E\d+\]/,
+  /Traceback \(most recent call last\)/,
+  /FATAL|PANIC/i,
+  /npm ERR!/,
+  /SyntaxError|TypeError|ReferenceError|RangeError/,
+  /ENOENT|EACCES|ECONNREFUSED|ETIMEDOUT/,
+  /ModuleNotFoundError|ImportError/,
+  /failed to compile/i,
+  /BUILD FAILED/i,
+  /Cannot find module/,
+  /command not found/,
+  /Permission denied/,
+];
+
+function isError(input: HookInput): boolean {
+  if (input.exit_code !== undefined && input.exit_code !== 0) return true;
+  return ERROR_PATTERNS.some(p => p.test(input.tool_output));
+}
+
+function readStdin(): Promise<string> {
+  return new Promise((resolve) => {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', () => resolve(data));
+  });
+}
+
+async function main(): Promise<void> {
+  const raw = await readStdin();
+  if (!raw.trim()) return;
+
+  let input: HookInput;
+  try {
+    input = JSON.parse(raw);
+  } catch {
+    return;
+  }
+
+  if (!isError(input)) return;
+
+  const client = new IpcClient(getPipeName(), 3000);
+  try {
+    await client.connect();
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const result: any = await client.request('error.report', {
+      project: 'auto-detected',
+      errorOutput: input.tool_output,
+    });
+
+    if (result.matches?.length > 0) {
+      const best = result.matches[0];
+      process.stderr.write(`Brain: Similar error found (#${best.errorId}, ${Math.round(best.score * 100)}% match)\n`);
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const antipatterns: any = await client.request('prevention.antipatterns', {
+      errorType: '',
+      message: input.tool_output,
+    });
+    if (antipatterns?.length > 0 && antipatterns[0].matched) {
+      process.stderr.write(`Brain WARNING: Known anti-pattern: ${antipatterns[0].description}\n`);
+    }
+  } catch {
+    // Hook must never block workflow
+  } finally {
+    client.disconnect();
+  }
+}
+
+main();

package/src/hooks/post-write.ts

@@ -1,117 +1,117 @@
-#!/usr/bin/env node
-
-// PostToolUse hook for Write/Edit tool — auto-analyzes code for reusability
-// Configured in .claude/settings.json:
-// { "hooks": { "PostToolUse": [{ "matcher": { "tool_name": "Write" }, "command": "node <brain-dist>/hooks/post-write.js" }] } }
-
-import { IpcClient } from '../ipc/client.js';
-import { getPipeName } from '../utils/paths.js';
-
-interface HookInput {
-  tool_name: string;
-  tool_input: { file_path?: string; content?: string };
-  tool_output: string;
-}
-
-const SOURCE_EXTENSIONS = new Set([
-  '.ts', '.tsx', '.js', '.jsx', '.py', '.rs', '.go',
-  '.java', '.c', '.cpp', '.h', '.hpp', '.rb', '.sh',
-]);
-
-const IGNORE_PATHS = [
-  'node_modules', 'dist', '.git', '__pycache__',
-  'vendor', 'build', '.next', 'coverage',
-];
-
-function isSourceFile(filePath: string): boolean {
-  const ext = filePath.slice(filePath.lastIndexOf('.'));
-  if (!SOURCE_EXTENSIONS.has(ext)) return false;
-  return !IGNORE_PATHS.some(p => filePath.includes(p));
-}
-
-function detectProject(filePath: string): string {
-  const normalized = filePath.replace(/\\/g, '/');
-  // Extract project name from path — look for common project root indicators
-  const parts = normalized.split('/');
-  // Find the directory just above src/, lib/, app/ etc., or use the parent of the file
-  for (let i = parts.length - 1; i >= 0; i--) {
-    if (['src', 'lib', 'app', 'components', 'pages', 'tests', 'test'].includes(parts[i]) && i > 0) {
-      return parts[i - 1];
-    }
-  }
-  // Fallback: use the directory two levels up from the file, or immediate parent
-  return parts[Math.max(parts.length - 3, 0)] || 'default';
-}
-
-function detectLanguage(filePath: string): string {
-  const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
-  const map: Record<string, string> = {
-    ts: 'typescript', tsx: 'typescript', js: 'javascript', jsx: 'javascript',
-    py: 'python', rs: 'rust', go: 'go', java: 'java',
-    c: 'c', cpp: 'cpp', h: 'c', hpp: 'cpp',
-    rb: 'ruby', sh: 'shell',
-  };
-  return map[ext] ?? ext;
-}
-
-function readStdin(): Promise<string> {
-  return new Promise((resolve) => {
-    let data = '';
-    process.stdin.setEncoding('utf8');
-    process.stdin.on('data', (chunk) => { data += chunk; });
-    process.stdin.on('end', () => resolve(data));
-  });
-}
-
-async function main(): Promise<void> {
-  const raw = await readStdin();
-  if (!raw.trim()) return;
-
-  let input: HookInput;
-  try {
-    input = JSON.parse(raw);
-  } catch {
-    return;
-  }
-
-  const filePath = input.tool_input?.file_path;
-  if (!filePath || !isSourceFile(filePath)) return;
-
-  const client = new IpcClient(getPipeName(), 3000);
-  try {
-    await client.connect();
-
-    // Check for similar existing code
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const similarities: any = await client.request('code.similarity', {
-      source: input.tool_input.content ?? '',
-      language: detectLanguage(filePath),
-    });
-
-    if (similarities?.length > 0) {
-      const best = similarities[0];
-      if (best.score > 0.8) {
-        process.stderr.write(`Brain: Very similar code exists (module #${best.moduleId}, ${Math.round(best.score * 100)}% match). Consider reusing.\n`);
-      }
-    }
-
-    // Auto-register the written file into Brain
-    const fileName = filePath.replace(/\\/g, '/').split('/').pop() ?? 'unknown';
-    const projectName = detectProject(filePath);
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const result: any = await client.request('code.analyze', {
-      project: projectName,
-      name: fileName,
-      filePath,
-      language: detectLanguage(filePath),
-      source: input.tool_input.content ?? '',
-    });
-    process.stderr.write(`Brain: Registered ${fileName} (score: ${result.reusabilityScore?.toFixed(2) ?? '?'}, ${result.isNew ? 'new' : 'updated'})\n`);
-  } catch {
-    // Hook must never block workflow
-  } finally {
-    client.disconnect();
-  }
-}
-
-main();
+#!/usr/bin/env node
+
+// PostToolUse hook for Write/Edit tool — auto-analyzes code for reusability
+// Configured in .claude/settings.json:
+// { "hooks": { "PostToolUse": [{ "matcher": { "tool_name": "Write" }, "command": "node <brain-dist>/hooks/post-write.js" }] } }
+
+import { IpcClient } from '../ipc/client.js';
+import { getPipeName } from '../utils/paths.js';
+
+interface HookInput {
+  tool_name: string;
+  tool_input: { file_path?: string; content?: string };
+  tool_output: string;
+}
+
+const SOURCE_EXTENSIONS = new Set([
+  '.ts', '.tsx', '.js', '.jsx', '.py', '.rs', '.go',
+  '.java', '.c', '.cpp', '.h', '.hpp', '.rb', '.sh',
+]);
+
+const IGNORE_PATHS = [
+  'node_modules', 'dist', '.git', '__pycache__',
+  'vendor', 'build', '.next', 'coverage',
+];
+
+function isSourceFile(filePath: string): boolean {
+  const ext = filePath.slice(filePath.lastIndexOf('.'));
+  if (!SOURCE_EXTENSIONS.has(ext)) return false;
+  return !IGNORE_PATHS.some(p => filePath.includes(p));
+}
+
+function detectProject(filePath: string): string {
+  const normalized = filePath.replace(/\\/g, '/');
+  // Extract project name from path — look for common project root indicators
+  const parts = normalized.split('/');
+  // Find the directory just above src/, lib/, app/ etc., or use the parent of the file
+  for (let i = parts.length - 1; i >= 0; i--) {
+    if (['src', 'lib', 'app', 'components', 'pages', 'tests', 'test'].includes(parts[i]) && i > 0) {
+      return parts[i - 1];
+    }
+  }
+  // Fallback: use the directory two levels up from the file, or immediate parent
+  return parts[Math.max(parts.length - 3, 0)] || 'default';
+}
+
+function detectLanguage(filePath: string): string {
+  const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
+  const map: Record<string, string> = {
+    ts: 'typescript', tsx: 'typescript', js: 'javascript', jsx: 'javascript',
+    py: 'python', rs: 'rust', go: 'go', java: 'java',
+    c: 'c', cpp: 'cpp', h: 'c', hpp: 'cpp',
+    rb: 'ruby', sh: 'shell',
+  };
+  return map[ext] ?? ext;
+}
+
+function readStdin(): Promise<string> {
+  return new Promise((resolve) => {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', () => resolve(data));
+  });
+}
+
+async function main(): Promise<void> {
+  const raw = await readStdin();
+  if (!raw.trim()) return;
+
+  let input: HookInput;
+  try {
+    input = JSON.parse(raw);
+  } catch {
+    return;
+  }
+
+  const filePath = input.tool_input?.file_path;
+  if (!filePath || !isSourceFile(filePath)) return;
+
+  const client = new IpcClient(getPipeName(), 3000);
+  try {
+    await client.connect();
+
+    // Check for similar existing code
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const similarities: any = await client.request('code.similarity', {
+      source: input.tool_input.content ?? '',
+      language: detectLanguage(filePath),
+    });
+
+    if (similarities?.length > 0) {
+      const best = similarities[0];
+      if (best.score > 0.8) {
+        process.stderr.write(`Brain: Very similar code exists (module #${best.moduleId}, ${Math.round(best.score * 100)}% match). Consider reusing.\n`);
+      }
+    }
+
+    // Auto-register the written file into Brain
+    const fileName = filePath.replace(/\\/g, '/').split('/').pop() ?? 'unknown';
+    const projectName = detectProject(filePath);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const result: any = await client.request('code.analyze', {
+      project: projectName,
+      name: fileName,
+      filePath,
+      language: detectLanguage(filePath),
+      source: input.tool_input.content ?? '',
+    });
+    process.stderr.write(`Brain: Registered ${fileName} (score: ${result.reusabilityScore?.toFixed(2) ?? '?'}, ${result.isNew ? 'new' : 'updated'})\n`);
+  } catch {
+    // Hook must never block workflow
+  } finally {
+    client.disconnect();
+  }
+}
+
+main();

package/src/index.ts

@@ -11,6 +11,8 @@ import { networkCommand } from './cli/commands/network.js';
 import { exportCommand } from './cli/commands/export.js';
 import { importCommand } from './cli/commands/import.js';
 import { dashboardCommand } from './cli/commands/dashboard.js';
+import { learnCommand } from './cli/commands/learn.js';
+import { configCommand } from './cli/commands/config.js';
 
 const program = new Command();
 
@@ -29,6 +31,8 @@ program.addCommand(networkCommand());
 program.addCommand(exportCommand());
 program.addCommand(importCommand());
 program.addCommand(dashboardCommand());
+program.addCommand(learnCommand());
+program.addCommand(configCommand());
 
 // Hidden command: run MCP server (called by Claude Code)
 program