@timmeck/brain 1.8.5 → 2.0.0

package/src/cli/colors.ts

@@ -1,116 +0,0 @@
-import chalk from 'chalk';
-
-// Brand colors matching the dashboard
-export const c = {
-  // Primary palette
-  blue: chalk.hex('#5b9cff'),
-  purple: chalk.hex('#b47aff'),
-  cyan: chalk.hex('#47e5ff'),
-  green: chalk.hex('#3dffa0'),
-  red: chalk.hex('#ff5577'),
-  orange: chalk.hex('#ffb347'),
-  dim: chalk.hex('#8b8fb0'),
-  dimmer: chalk.hex('#4a4d6e'),
-
-  // Semantic
-  label: chalk.hex('#8b8fb0'),
-  value: chalk.white.bold,
-  heading: chalk.hex('#5b9cff').bold,
-  success: chalk.hex('#3dffa0').bold,
-  error: chalk.hex('#ff5577').bold,
-  warn: chalk.hex('#ffb347').bold,
-  info: chalk.hex('#47e5ff'),
-};
-
-export const icons = {
-  brain: '🧠',
-  check: '✓',
-  cross: '✗',
-  arrow: '→',
-  dot: '●',
-  circle: '○',
-  bar: '█',
-  barLight: '░',
-  dash: '─',
-  pipe: '│',
-  corner: '└',
-  tee: '├',
-  star: '★',
-  bolt: '⚡',
-  search: '🔍',
-  gear: '⚙',
-  chart: '📊',
-  module: '📦',
-  synapse: '🔗',
-  insight: '💡',
-  warn: '⚠',
-  error: '❌',
-  ok: '✅',
-  clock: '⏱',
-};
-
-export function header(title: string, icon?: string): string {
-  const prefix = icon ? `${icon}  ` : '';
-  const line = c.dimmer(icons.dash.repeat(40));
-  return `\n${line}\n${prefix}${c.heading(title)}\n${line}`;
-}
-
-export function keyValue(key: string, value: string | number, indent = 2): string {
-  const pad = ' '.repeat(indent);
-  return `${pad}${c.label(key + ':')} ${c.value(String(value))}`;
-}
-
-export function statusBadge(status: string): string {
-  switch (status.toLowerCase()) {
-    case 'resolved':
-    case 'active':
-    case 'running':
-      return c.green(`[${status.toUpperCase()}]`);
-    case 'open':
-    case 'unresolved':
-      return c.red(`[${status.toUpperCase()}]`);
-    case 'warning':
-      return c.warn(`[${status.toUpperCase()}]`);
-    default:
-      return c.dim(`[${status.toUpperCase()}]`);
-  }
-}
-
-export function priorityBadge(priority: number | string): string {
-  const p = typeof priority === 'string' ? priority.toLowerCase() : '';
-  const n = typeof priority === 'number' ? priority : 0;
-  if (p === 'critical' || n >= 9) return c.red.bold(`[CRITICAL]`);
-  if (p === 'high' || n >= 7) return c.orange.bold(`[HIGH]`);
-  if (p === 'medium' || n >= 4) return c.blue(`[MEDIUM]`);
-  return c.dim(`[LOW]`);
-}
-
-export function progressBar(current: number, total: number, width = 20): string {
-  const pct = Math.min(1, current / Math.max(1, total));
-  const filled = Math.round(pct * width);
-  const empty = width - filled;
-  return c.cyan(icons.bar.repeat(filled)) + c.dimmer(icons.barLight.repeat(empty));
-}
-
-export function divider(width = 40): string {
-  return c.dimmer(icons.dash.repeat(width));
-}
-
-export function table(rows: string[][], colWidths?: number[]): string {
-  if (rows.length === 0) return '';
-  const widths = colWidths ?? rows[0].map((_, i) =>
-    Math.max(...rows.map(r => stripAnsi(r[i] ?? '').length))
-  );
-  return rows.map(row =>
-    row.map((cell, i) => {
-      const stripped = stripAnsi(cell);
-      const pad = Math.max(0, (widths[i] ?? stripped.length) - stripped.length);
-      return cell + ' '.repeat(pad);
-    }).join('  ')
-  ).join('\n');
-}
-
-function stripAnsi(str: string): string {
-  // eslint-disable-next-line no-control-regex
-  return str.replace(/\x1b\[[0-9;]*m/g, '');
-}

package/src/cli/commands/config.ts

@@ -1,169 +0,0 @@
-import { Command } from 'commander';
-import fs from 'node:fs';
-import path from 'node:path';
-import { getDataDir } from '../../utils/paths.js';
-import { c, icons, header, divider } from '../colors.js';
-
-function getConfigPath(): string {
-  return path.join(getDataDir(), 'config.json');
-}
-
-function readConfig(): Record<string, unknown> {
-  const configPath = getConfigPath();
-  if (fs.existsSync(configPath)) {
-    return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-  }
-  return {};
-}
-
-function writeConfig(config: Record<string, unknown>): void {
-  const configPath = getConfigPath();
-  fs.mkdirSync(path.dirname(configPath), { recursive: true });
-  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
-}
-
-function getNestedValue(obj: Record<string, unknown>, keyPath: string): unknown {
-  const parts = keyPath.split('.');
-  let current: unknown = obj;
-  for (const part of parts) {
-    if (current === null || current === undefined || typeof current !== 'object') return undefined;
-    current = (current as Record<string, unknown>)[part];
-  }
-  return current;
-}
-
-function setNestedValue(obj: Record<string, unknown>, keyPath: string, value: unknown): void {
-  const parts = keyPath.split('.');
-  let current: Record<string, unknown> = obj;
-  for (let i = 0; i < parts.length - 1; i++) {
-    const part = parts[i];
-    if (!current[part] || typeof current[part] !== 'object') {
-      current[part] = {};
-    }
-    current = current[part] as Record<string, unknown>;
-  }
-  current[parts[parts.length - 1]] = value;
-}
-
-function deleteNestedValue(obj: Record<string, unknown>, keyPath: string): boolean {
-  const parts = keyPath.split('.');
-  let current: Record<string, unknown> = obj;
-  for (let i = 0; i < parts.length - 1; i++) {
-    const part = parts[i];
-    if (!current[part] || typeof current[part] !== 'object') return false;
-    current = current[part] as Record<string, unknown>;
-  }
-  const last = parts[parts.length - 1];
-  if (last in current) {
-    delete current[last];
-    return true;
-  }
-  return false;
-}
-
-function parseValue(value: string): unknown {
-  if (value === 'true') return true;
-  if (value === 'false') return false;
-  if (value === 'null') return null;
-  const num = Number(value);
-  if (!isNaN(num) && value.trim() !== '') return num;
-  // Try JSON for arrays/objects
-  if ((value.startsWith('[') && value.endsWith(']')) || (value.startsWith('{') && value.endsWith('}'))) {
-    try { return JSON.parse(value); } catch { /* fall through */ }
-  }
-  return value;
-}
-
-function printObject(obj: unknown, indent = 0): void {
-  const pad = ' '.repeat(indent);
-  if (obj === null || obj === undefined) {
-    console.log(`${pad}${c.dim('(not set)')}`);
-    return;
-  }
-  if (typeof obj !== 'object') {
-    console.log(`${pad}${c.value(String(obj))}`);
-    return;
-  }
-  for (const [key, val] of Object.entries(obj as Record<string, unknown>)) {
-    if (val && typeof val === 'object' && !Array.isArray(val)) {
-      console.log(`${pad}${c.cyan(key + ':')}`);
-      printObject(val, indent + 2);
-    } else {
-      const display = Array.isArray(val) ? JSON.stringify(val) : String(val);
-      console.log(`${pad}${c.label(key + ':')} ${c.value(display)}`);
-    }
-  }
-}
-
-export function configCommand(): Command {
-  const cmd = new Command('config')
-    .description('View and modify Brain configuration');
-
-  cmd
-    .command('show')
-    .description('Show current configuration')
-    .argument('[key]', 'Specific config key (e.g., learning.intervalMs)')
-    .action((key?: string) => {
-      const config = readConfig();
-
-      if (key) {
-        const value = getNestedValue(config, key);
-        if (value === undefined) {
-          console.log(`${c.dim(`Key "${key}" is not set in config overrides.`)}`);
-        } else {
-          console.log(`${c.label(key + ':')} ${c.value(typeof value === 'object' ? JSON.stringify(value, null, 2) : String(value))}`);
-        }
-        return;
-      }
-
-      console.log(header('Brain Configuration', icons.gear));
-      console.log(`  ${c.label('Config file:')} ${c.dim(getConfigPath())}\n`);
-
-      if (Object.keys(config).length === 0) {
-        console.log(`  ${c.dim('No custom overrides. Using defaults.')}`);
-        console.log(`  ${c.dim('Set values with:')} ${c.cyan('brain config set <key> <value>')}`);
-      } else {
-        printObject(config, 2);
-      }
-      console.log(`\n${divider()}`);
-    });
-
-  cmd
-    .command('set')
-    .description('Set a configuration value')
-    .argument('<key>', 'Config key path (e.g., learning.intervalMs)')
-    .argument('<value>', 'Value to set')
-    .action((key: string, value: string) => {
-      const config = readConfig();
-      const parsed = parseValue(value);
-      setNestedValue(config, key, parsed);
-      writeConfig(config);
-
-      console.log(`${icons.ok}  ${c.label(key)} ${c.dim(icons.arrow)} ${c.value(String(parsed))}`);
-      console.log(`  ${c.dim('Restart the daemon for changes to take effect:')} ${c.cyan('brain stop && brain start')}`);
-    });
-
-  cmd
-    .command('delete')
-    .description('Remove a configuration override (revert to default)')
-    .argument('<key>', 'Config key path to remove')
-    .action((key: string) => {
-      const config = readConfig();
-      if (deleteNestedValue(config, key)) {
-        writeConfig(config);
-        console.log(`${icons.ok}  ${c.dim(`Removed "${key}" — will use default value.`)}`);
-        console.log(`  ${c.dim('Restart the daemon for changes to take effect:')} ${c.cyan('brain stop && brain start')}`);
-      } else {
-        console.log(`${c.dim(`Key "${key}" not found in config overrides.`)}`);
-      }
-    });
-
-  cmd
-    .command('path')
-    .description('Show the config file path')
-    .action(() => {
-      console.log(getConfigPath());
-    });
-
-  return cmd;
-}

package/src/cli/commands/doctor.ts

@@ -1,124 +0,0 @@
-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 +0,0 @@
-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 +0,0 @@
-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`);
-      });
-    });
-}