@timmeck/brain 1.8.1 → 1.8.3

package/src/cli/commands/doctor.ts

@@ -1,118 +1,124 @@
-import { Command } from 'commander';
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { getDataDir } from '../../utils/paths.js';
-import { IpcClient } from '../../ipc/client.js';
-import { getPipeName } from '../../utils/paths.js';
-import { c, icons, header, divider } from '../colors.js';
-
-function pass(label: string, detail?: string): void {
-  const extra = detail ? ` ${c.dim(detail)}` : '';
-  console.log(`  ${c.green(icons.check)}  ${label}${extra}`);
-}
-
-function fail(label: string, detail?: string): void {
-  const extra = detail ? ` ${c.dim(detail)}` : '';
-  console.log(`  ${c.red(icons.cross)}  ${label}${extra}`);
-}
-
-export function doctorCommand(): Command {
-  return new Command('doctor')
-    .description('Check Brain health: daemon, DB, MCP, hooks')
-    .action(async () => {
-      console.log(header('Brain Doctor', icons.brain));
-      console.log();
-
-      let allGood = true;
-
-      // 1. Daemon running?
-      const pidPath = path.join(getDataDir(), 'brain.pid');
-      let daemonRunning = false;
-      if (fs.existsSync(pidPath)) {
-        const pid = parseInt(fs.readFileSync(pidPath, 'utf8').trim(), 10);
-        try {
-          process.kill(pid, 0);
-          daemonRunning = true;
-          pass('Daemon running', `PID ${pid}`);
-        } catch {
-          fail('Daemon not running', 'stale PID file');
-          allGood = false;
-        }
-      } else {
-        fail('Daemon not running', 'no PID file');
-        allGood = false;
-      }
-
-      // 2. DB reachable? (only if daemon running)
-      if (daemonRunning) {
-        const client = new IpcClient(getPipeName(), 3000);
-        try {
-          await client.connect();
-          await client.request('analytics.summary', {});
-          pass('Database reachable');
-        } catch {
-          fail('Database not reachable');
-          allGood = false;
-        } finally {
-          client.disconnect();
-        }
-      } else {
-        fail('Database not reachable', 'daemon not running');
-        allGood = false;
-      }
-
-      // 3. MCP configured?
-      const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
-      let mcpConfigured = false;
-      try {
-        const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
-        if (settings.mcpServers?.brain || settings.mcpServers?.['brain-mcp']) {
-          mcpConfigured = true;
-          pass('MCP server configured');
-        } else {
-          fail('MCP server not configured', `edit ${settingsPath}`);
-          allGood = false;
-        }
-      } catch {
-        fail('MCP server not configured', 'settings.json not found');
-        allGood = false;
-      }
-
-      // 4. Hook active?
-      try {
-        const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
-        const hooks = settings.hooks;
-        const hasPostToolUse = hooks?.PostToolUse?.some(
-          (h: { command?: string }) => h.command?.includes('brain') || h.command?.includes('post-tool-use'),
-        );
-        if (hasPostToolUse) {
-          pass('Auto-detect hook active');
-        } else {
-          fail('Auto-detect hook not configured', 'errors won\'t be tracked automatically');
-          allGood = false;
-        }
-      } catch {
-        fail('Auto-detect hook not configured');
-        allGood = false;
-      }
-
-      // 5. DB file size
-      const dbPath = path.join(getDataDir(), 'brain.db');
-      try {
-        const stat = fs.statSync(dbPath);
-        pass('Database file', `${(stat.size / 1024 / 1024).toFixed(1)} MB at ${dbPath}`);
-      } catch {
-        fail('Database file not found');
-        allGood = false;
-      }
-
-      console.log();
-      if (allGood) {
-        console.log(`  ${icons.ok}  ${c.success('All checks passed!')}`);
-      } else {
-        console.log(`  ${icons.warn}  ${c.warn('Some checks failed.')} Run ${c.cyan('brain start')} and check your MCP config.`);
-      }
-      console.log(`\n${divider()}`);
-    });
-}
+import { Command } from 'commander';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { getDataDir } from '../../utils/paths.js';
+import { IpcClient } from '../../ipc/client.js';
+import { getPipeName } from '../../utils/paths.js';
+import { c, icons, header, divider } from '../colors.js';
+
+function pass(label: string, detail?: string): void {
+  const extra = detail ? ` ${c.dim(detail)}` : '';
+  console.log(`  ${c.green(icons.check)}  ${label}${extra}`);
+}
+
+function fail(label: string, detail?: string): void {
+  const extra = detail ? ` ${c.dim(detail)}` : '';
+  console.log(`  ${c.red(icons.cross)}  ${label}${extra}`);
+}
+
+export function doctorCommand(): Command {
+  return new Command('doctor')
+    .description('Check Brain health: daemon, DB, MCP, hooks')
+    .action(async () => {
+      console.log(header('Brain Doctor', icons.brain));
+      console.log();
+
+      let allGood = true;
+
+      // 1. Daemon running?
+      const pidPath = path.join(getDataDir(), 'brain.pid');
+      let daemonRunning = false;
+      if (fs.existsSync(pidPath)) {
+        const pid = parseInt(fs.readFileSync(pidPath, 'utf8').trim(), 10);
+        try {
+          process.kill(pid, 0);
+          daemonRunning = true;
+          pass('Daemon running', `PID ${pid}`);
+        } catch {
+          fail('Daemon not running', 'stale PID file');
+          allGood = false;
+        }
+      } else {
+        fail('Daemon not running', 'no PID file');
+        allGood = false;
+      }
+
+      // 2. DB reachable? (only if daemon running)
+      if (daemonRunning) {
+        const client = new IpcClient(getPipeName(), 3000);
+        try {
+          await client.connect();
+          await client.request('analytics.summary', {});
+          pass('Database reachable');
+        } catch {
+          fail('Database not reachable');
+          allGood = false;
+        } finally {
+          client.disconnect();
+        }
+      } else {
+        fail('Database not reachable', 'daemon not running');
+        allGood = false;
+      }
+
+      // 3. MCP configured?
+      const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
+      let mcpConfigured = false;
+      try {
+        const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+        if (settings.mcpServers?.brain || settings.mcpServers?.['brain-mcp']) {
+          mcpConfigured = true;
+          pass('MCP server configured');
+        } else {
+          fail('MCP server not configured', `edit ${settingsPath}`);
+          allGood = false;
+        }
+      } catch {
+        fail('MCP server not configured', 'settings.json not found');
+        allGood = false;
+      }
+
+      // 4. Hook active?
+      try {
+        const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+        const hooks = settings.hooks;
+        const hasPostToolUse = hooks?.PostToolUse?.some(
+          (h: { command?: string; hooks?: Array<{ command?: string }> }) => {
+            // Support both flat format (h.command) and nested format (h.hooks[].command)
+            if (h.command?.includes('brain') || h.command?.includes('post-tool-use')) return true;
+            return h.hooks?.some(
+              (inner) => inner.command?.includes('brain') || inner.command?.includes('post-tool-use'),
+            );
+          },
+        );
+        if (hasPostToolUse) {
+          pass('Auto-detect hook active');
+        } else {
+          fail('Auto-detect hook not configured', 'errors won\'t be tracked automatically');
+          allGood = false;
+        }
+      } catch {
+        fail('Auto-detect hook not configured');
+        allGood = false;
+      }
+
+      // 5. DB file size
+      const dbPath = path.join(getDataDir(), 'brain.db');
+      try {
+        const stat = fs.statSync(dbPath);
+        pass('Database file', `${(stat.size / 1024 / 1024).toFixed(1)} MB at ${dbPath}`);
+      } catch {
+        fail('Database file not found');
+        allGood = false;
+      }
+
+      console.log();
+      if (allGood) {
+        console.log(`  ${icons.ok}  ${c.success('All checks passed!')}`);
+      } else {
+        console.log(`  ${icons.warn}  ${c.warn('Some checks failed.')} Run ${c.cyan('brain start')} and check your MCP config.`);
+      }
+      console.log(`\n${divider()}`);
+    });
+}

package/src/cli/commands/explain.ts

@@ -1,83 +1,83 @@
-import { Command } from 'commander';
-import { withIpc } from '../ipc-helper.js';
-import { c, icons } from '../colors.js';
-
-export function explainCommand(): Command {
-  return new Command('explain')
-    .description('Show everything Brain knows about an error')
-    .argument('<errorId>', 'Error ID to explain')
-    .action(async (errorId) => {
-      const id = parseInt(errorId, 10);
-      if (isNaN(id)) {
-        console.error(`${icons.error} Invalid error ID: ${errorId}`);
-        process.exit(1);
-      }
-
-      await withIpc(async (client) => {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const result: any = await client.request('analytics.explain', { errorId: id });
-
-        if (!result.error) {
-          console.error(`${icons.error} Error #${id} not found.`);
-          return;
-        }
-
-        const err = result.error;
-        console.log();
-        console.log(`${icons.brain}  ${c.heading(`Error #${err.id} — ${err.type}`)}`);
-        console.log(`${c.dim('─'.repeat(60))}`);
-        console.log(`  ${c.label('Message:')}   ${err.message}`);
-        console.log(`  ${c.label('File:')}      ${err.file_path ?? 'unknown'}`);
-        console.log(`  ${c.label('Context:')}   ${err.context ?? 'none'}`);
-        console.log(`  ${c.label('Seen:')}      ${err.occurrence_count}x (first: ${err.first_seen}, last: ${err.last_seen})`);
-        console.log(`  ${c.label('Resolved:')}  ${err.resolved ? c.success('Yes') : c.error('No')}`);
-        console.log(`  ${c.label('Synapses:')}  ${result.synapseConnections} connections`);
-
-        // Error Chain
-        if (result.chain.parents.length > 0 || result.chain.children.length > 0) {
-          console.log();
-          console.log(`  ${c.heading('Error Chain:')}`);
-          for (const p of result.chain.parents) {
-            console.log(`    ${c.dim('↑')} Caused by: #${p.id} ${p.type}: ${p.message.slice(0, 60)}`);
-          }
-          console.log(`    ${c.info('→')} #${err.id} ${err.type}`);
-          for (const ch of result.chain.children) {
-            console.log(`    ${c.dim('↓')} Led to: #${ch.id} ${ch.type}: ${ch.message.slice(0, 60)}`);
-          }
-        }
-
-        // Solutions
-        if (result.solutions.length > 0) {
-          console.log();
-          console.log(`  ${c.heading('Solutions:')}`);
-          for (const s of result.solutions) {
-            const rate = `${Math.round(s.successRate * 100)}%`;
-            console.log(`    ${icons.ok} #${s.id}: ${s.description.slice(0, 80)} (success: ${rate}, confidence: ${s.confidence.toFixed(2)})`);
-          }
-        } else {
-          console.log();
-          console.log(`  ${c.dim('No solutions found.')}`);
-        }
-
-        // Related Errors
-        if (result.relatedErrors.length > 0) {
-          console.log();
-          console.log(`  ${c.heading('Related Errors:')}`);
-          for (const r of result.relatedErrors.slice(0, 5)) {
-            console.log(`    ${c.dim('~')} #${r.id} ${r.type}: ${r.message.slice(0, 60)} (${Math.round(r.similarity * 100)}%)`);
-          }
-        }
-
-        // Rules
-        if (result.rules.length > 0) {
-          console.log();
-          console.log(`  ${c.heading('Applicable Rules:')}`);
-          for (const r of result.rules) {
-            console.log(`    ${icons.gear} #${r.id}: ${r.action} (confidence: ${r.confidence.toFixed(2)})`);
-          }
-        }
-
-        console.log();
-      });
-    });
-}
+import { Command } from 'commander';
+import { withIpc } from '../ipc-helper.js';
+import { c, icons } from '../colors.js';
+
+export function explainCommand(): Command {
+  return new Command('explain')
+    .description('Show everything Brain knows about an error')
+    .argument('<errorId>', 'Error ID to explain')
+    .action(async (errorId) => {
+      const id = parseInt(errorId, 10);
+      if (isNaN(id)) {
+        console.error(`${icons.error} Invalid error ID: ${errorId}`);
+        process.exit(1);
+      }
+
+      await withIpc(async (client) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const result: any = await client.request('analytics.explain', { errorId: id });
+
+        if (!result.error) {
+          console.error(`${icons.error} Error #${id} not found.`);
+          return;
+        }
+
+        const err = result.error;
+        console.log();
+        console.log(`${icons.brain}  ${c.heading(`Error #${err.id} — ${err.type}`)}`);
+        console.log(`${c.dim('─'.repeat(60))}`);
+        console.log(`  ${c.label('Message:')}   ${err.message}`);
+        console.log(`  ${c.label('File:')}      ${err.file_path ?? 'unknown'}`);
+        console.log(`  ${c.label('Context:')}   ${err.context ?? 'none'}`);
+        console.log(`  ${c.label('Seen:')}      ${err.occurrence_count}x (first: ${err.first_seen}, last: ${err.last_seen})`);
+        console.log(`  ${c.label('Resolved:')}  ${err.resolved ? c.success('Yes') : c.error('No')}`);
+        console.log(`  ${c.label('Synapses:')}  ${result.synapseConnections} connections`);
+
+        // Error Chain
+        if (result.chain.parents.length > 0 || result.chain.children.length > 0) {
+          console.log();
+          console.log(`  ${c.heading('Error Chain:')}`);
+          for (const p of result.chain.parents) {
+            console.log(`    ${c.dim('↑')} Caused by: #${p.id} ${p.type}: ${p.message.slice(0, 60)}`);
+          }
+          console.log(`    ${c.info('→')} #${err.id} ${err.type}`);
+          for (const ch of result.chain.children) {
+            console.log(`    ${c.dim('↓')} Led to: #${ch.id} ${ch.type}: ${ch.message.slice(0, 60)}`);
+          }
+        }
+
+        // Solutions
+        if (result.solutions.length > 0) {
+          console.log();
+          console.log(`  ${c.heading('Solutions:')}`);
+          for (const s of result.solutions) {
+            const rate = `${Math.round(s.successRate * 100)}%`;
+            console.log(`    ${icons.ok} #${s.id}: ${s.description.slice(0, 80)} (success: ${rate}, confidence: ${s.confidence.toFixed(2)})`);
+          }
+        } else {
+          console.log();
+          console.log(`  ${c.dim('No solutions found.')}`);
+        }
+
+        // Related Errors
+        if (result.relatedErrors.length > 0) {
+          console.log();
+          console.log(`  ${c.heading('Related Errors:')}`);
+          for (const r of result.relatedErrors.slice(0, 5)) {
+            console.log(`    ${c.dim('~')} #${r.id} ${r.type}: ${r.message.slice(0, 60)} (${Math.round(r.similarity * 100)}%)`);
+          }
+        }
+
+        // Rules
+        if (result.rules.length > 0) {
+          console.log();
+          console.log(`  ${c.heading('Applicable Rules:')}`);
+          for (const r of result.rules) {
+            console.log(`    ${icons.gear} #${r.id}: ${r.action} (confidence: ${r.confidence.toFixed(2)})`);
+          }
+        }
+
+        console.log();
+      });
+    });
+}

package/src/cli/commands/export.ts

@@ -1,31 +1,31 @@
-import { Command } from 'commander';
-import { withIpc } from '../ipc-helper.js';
-import { c, icons } from '../colors.js';
-
-export function exportCommand(): Command {
-  return new Command('export')
-    .description('Export Brain data')
-    .option('--format <fmt>', 'Output format: json (default)', 'json')
-    .action(async () => {
-      await withIpc(async (client) => {
-        process.stderr.write(`${icons.gear}  ${c.info('Exporting Brain data...')}\n`);
-
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const summary: any = await client.request('analytics.summary', {});
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const network: any = await client.request('analytics.network', { limit: 100 });
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const insights: any = await client.request('research.insights', { activeOnly: true, limit: 100 });
-
-        const data = {
-          exportedAt: new Date().toISOString(),
-          summary,
-          network,
-          insights,
-        };
-
-        console.log(JSON.stringify(data, null, 2));
-        process.stderr.write(`${icons.ok}  ${c.success('Export complete.')}\n`);
-      });
-    });
-}
+import { Command } from 'commander';
+import { withIpc } from '../ipc-helper.js';
+import { c, icons } from '../colors.js';
+
+export function exportCommand(): Command {
+  return new Command('export')
+    .description('Export Brain data')
+    .option('--format <fmt>', 'Output format: json (default)', 'json')
+    .action(async () => {
+      await withIpc(async (client) => {
+        process.stderr.write(`${icons.gear}  ${c.info('Exporting Brain data...')}\n`);
+
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const summary: any = await client.request('analytics.summary', {});
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const network: any = await client.request('analytics.network', { limit: 100 });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const insights: any = await client.request('research.insights', { activeOnly: true, limit: 100 });
+
+        const data = {
+          exportedAt: new Date().toISOString(),
+          summary,
+          network,
+          insights,
+        };
+
+        console.log(JSON.stringify(data, null, 2));
+        process.stderr.write(`${icons.ok}  ${c.success('Export complete.')}\n`);
+      });
+    });
+}