@timmeck/brain 1.8.1 → 1.8.3

package/src/cli/commands/start.ts

@@ -1,62 +1,62 @@
-import { Command } from 'commander';
-import { spawn } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-import { getDataDir } from '../../utils/paths.js';
-import { c, icons } from '../colors.js';
-import { checkForUpdate } from '../update-check.js';
-
-export function startCommand(): Command {
-  return new Command('start')
-    .description('Start the Brain daemon')
-    .option('-f, --foreground', 'Run in foreground (no detach)')
-    .option('-c, --config <path>', 'Config file path')
-    .action((opts) => {
-      const pidPath = path.join(getDataDir(), 'brain.pid');
-
-      // Check if already running
-      if (fs.existsSync(pidPath)) {
-        const pid = parseInt(fs.readFileSync(pidPath, 'utf8').trim(), 10);
-        try {
-          process.kill(pid, 0); // Check if process exists
-          console.log(`${icons.brain}  Brain daemon is ${c.green('already running')} ${c.dim(`(PID: ${pid})`)}`);
-          return;
-        } catch {
-          // PID file stale, remove it
-          fs.unlinkSync(pidPath);
-        }
-      }
-
-      if (opts.foreground) {
-        // Run in foreground — import dynamically to avoid loading everything at CLI parse time
-        import('../../brain.js').then(({ BrainCore }) => {
-          const core = new BrainCore();
-          core.start(opts.config);
-        });
-        return;
-      }
-
-      // Spawn detached daemon
-      const args = ['daemon'];
-      if (opts.config) args.push('-c', opts.config);
-
-      const entryPoint = path.resolve(import.meta.dirname, '../../index.js');
-      const child = spawn(process.execPath, [entryPoint, ...args], {
-        detached: true,
-        stdio: 'ignore',
-      });
-      child.unref();
-
-      console.log(`${icons.brain}  ${c.info('Brain daemon starting')} ${c.dim(`(PID: ${child.pid})`)}`);
-
-      // Wait briefly for PID file to appear
-      setTimeout(async () => {
-        if (fs.existsSync(pidPath)) {
-          console.log(`${icons.ok}  ${c.success('Brain daemon started successfully.')}`);
-        } else {
-          console.log(`${icons.clock}  ${c.warn('Brain daemon may still be starting.')} Check: ${c.cyan('brain status')}`);
-        }
-        await checkForUpdate();
-      }, 1000);
-    });
-}
+import { Command } from 'commander';
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getDataDir } from '../../utils/paths.js';
+import { c, icons } from '../colors.js';
+import { checkForUpdate } from '../update-check.js';
+
+export function startCommand(): Command {
+  return new Command('start')
+    .description('Start the Brain daemon')
+    .option('-f, --foreground', 'Run in foreground (no detach)')
+    .option('-c, --config <path>', 'Config file path')
+    .action((opts) => {
+      const pidPath = path.join(getDataDir(), 'brain.pid');
+
+      // Check if already running
+      if (fs.existsSync(pidPath)) {
+        const pid = parseInt(fs.readFileSync(pidPath, 'utf8').trim(), 10);
+        try {
+          process.kill(pid, 0); // Check if process exists
+          console.log(`${icons.brain}  Brain daemon is ${c.green('already running')} ${c.dim(`(PID: ${pid})`)}`);
+          return;
+        } catch {
+          // PID file stale, remove it
+          fs.unlinkSync(pidPath);
+        }
+      }
+
+      if (opts.foreground) {
+        // Run in foreground — import dynamically to avoid loading everything at CLI parse time
+        import('../../brain.js').then(({ BrainCore }) => {
+          const core = new BrainCore();
+          core.start(opts.config);
+        });
+        return;
+      }
+
+      // Spawn detached daemon
+      const args = ['daemon'];
+      if (opts.config) args.push('-c', opts.config);
+
+      const entryPoint = path.resolve(import.meta.dirname, '../../index.js');
+      const child = spawn(process.execPath, [entryPoint, ...args], {
+        detached: true,
+        stdio: 'ignore',
+      });
+      child.unref();
+
+      console.log(`${icons.brain}  ${c.info('Brain daemon starting')} ${c.dim(`(PID: ${child.pid})`)}`);
+
+      // Wait briefly for PID file to appear
+      setTimeout(async () => {
+        if (fs.existsSync(pidPath)) {
+          console.log(`${icons.ok}  ${c.success('Brain daemon started successfully.')}`);
+        } else {
+          console.log(`${icons.clock}  ${c.warn('Brain daemon may still be starting.')} Check: ${c.cyan('brain status')}`);
+        }
+        await checkForUpdate();
+      }, 1000);
+    });
+}

package/src/cli/commands/status.ts

@@ -1,75 +1,75 @@
-import { Command } from 'commander';
-import fs from 'node:fs';
-import path from 'node:path';
-import { getDataDir } from '../../utils/paths.js';
-import { withIpc } from '../ipc-helper.js';
-import { c, icons, header, keyValue, divider } from '../colors.js';
-import { checkForUpdate, getCurrentVersion } from '../update-check.js';
-
-export function statusCommand(): Command {
-  return new Command('status')
-    .description('Show Brain daemon status')
-    .action(async () => {
-      const pidPath = path.join(getDataDir(), 'brain.pid');
-
-      if (!fs.existsSync(pidPath)) {
-        console.log(`${icons.brain}  Brain Daemon: ${c.red.bold('NOT RUNNING')}`);
-        return;
-      }
-
-      const pid = parseInt(fs.readFileSync(pidPath, 'utf8').trim(), 10);
-      let running = false;
-      try {
-        process.kill(pid, 0);
-        running = true;
-      } catch { /* not running */ }
-
-      if (!running) {
-        console.log(`${icons.brain}  Brain Daemon: ${c.red.bold('NOT RUNNING')} ${c.dim('(stale PID file)')}`);
-        return;
-      }
-
-      console.log(header(`Brain Status v${getCurrentVersion()}`, icons.brain));
-      console.log(`  ${c.green(`${icons.dot} RUNNING`)} ${c.dim(`(PID ${pid})`)}`);
-
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      await withIpc(async (client) => {
-        // 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('synapse.stats', {});
-
-        const dbPath = path.join(getDataDir(), 'brain.db');
-        let dbSize = '?';
-        try {
-          const stat = fs.statSync(dbPath);
-          dbSize = `${(stat.size / 1024 / 1024).toFixed(1)} MB`;
-        } catch { /* ignore */ }
-
-        console.log(keyValue('Database', `${dbPath} (${dbSize})`));
-        console.log();
-
-        console.log(`  ${icons.error}  ${c.purple.bold('Error Brain')}`);
-        console.log(`     ${c.label('Errors:')}     ${c.value(summary.errors?.total ?? 0)} total, ${c.red(summary.errors?.unresolved ?? 0)} unresolved, ${c.dim(`${summary.errors?.last7d ?? 0} last 7d`)}`);
-        console.log(`     ${c.label('Solutions:')}  ${c.value(summary.solutions?.total ?? 0)}`);
-        console.log(`     ${c.label('Rules:')}      ${c.green(summary.rules?.active ?? 0)} active`);
-        console.log(`     ${c.label('Anti-Pat.:')} ${c.value(summary.antipatterns?.total ?? 0)}`);
-        console.log();
-
-        console.log(`  ${icons.module}  ${c.blue.bold('Code Brain')}`);
-        console.log(`     ${c.label('Modules:')}    ${c.value(summary.modules?.total ?? 0)} registered`);
-        console.log();
-
-        console.log(`  ${icons.synapse}  ${c.cyan.bold('Synapse Network')}`);
-        console.log(`     ${c.label('Synapses:')}   ${c.value(network.totalSynapses ?? 0)}`);
-        console.log(`     ${c.label('Avg weight:')} ${c.value((network.avgWeight ?? 0).toFixed(2))}`);
-        console.log();
-
-        console.log(`  ${icons.insight}  ${c.orange.bold('Research Brain')}`);
-        console.log(`     ${c.label('Insights:')}   ${c.value(summary.insights?.active ?? 0)} active`);
-
-        await checkForUpdate();
-        console.log(`\n${divider()}`);
-      });
-    });
-}
+import { Command } from 'commander';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getDataDir } from '../../utils/paths.js';
+import { withIpc } from '../ipc-helper.js';
+import { c, icons, header, keyValue, divider } from '../colors.js';
+import { checkForUpdate, getCurrentVersion } from '../update-check.js';
+
+export function statusCommand(): Command {
+  return new Command('status')
+    .description('Show Brain daemon status')
+    .action(async () => {
+      const pidPath = path.join(getDataDir(), 'brain.pid');
+
+      if (!fs.existsSync(pidPath)) {
+        console.log(`${icons.brain}  Brain Daemon: ${c.red.bold('NOT RUNNING')}`);
+        return;
+      }
+
+      const pid = parseInt(fs.readFileSync(pidPath, 'utf8').trim(), 10);
+      let running = false;
+      try {
+        process.kill(pid, 0);
+        running = true;
+      } catch { /* not running */ }
+
+      if (!running) {
+        console.log(`${icons.brain}  Brain Daemon: ${c.red.bold('NOT RUNNING')} ${c.dim('(stale PID file)')}`);
+        return;
+      }
+
+      console.log(header(`Brain Status v${getCurrentVersion()}`, icons.brain));
+      console.log(`  ${c.green(`${icons.dot} RUNNING`)} ${c.dim(`(PID ${pid})`)}`);
+
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      await withIpc(async (client) => {
+        // 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('synapse.stats', {});
+
+        const dbPath = path.join(getDataDir(), 'brain.db');
+        let dbSize = '?';
+        try {
+          const stat = fs.statSync(dbPath);
+          dbSize = `${(stat.size / 1024 / 1024).toFixed(1)} MB`;
+        } catch { /* ignore */ }
+
+        console.log(keyValue('Database', `${dbPath} (${dbSize})`));
+        console.log();
+
+        console.log(`  ${icons.error}  ${c.purple.bold('Error Brain')}`);
+        console.log(`     ${c.label('Errors:')}     ${c.value(summary.errors?.total ?? 0)} total, ${c.red(summary.errors?.unresolved ?? 0)} unresolved, ${c.dim(`${summary.errors?.last7d ?? 0} last 7d`)}`);
+        console.log(`     ${c.label('Solutions:')}  ${c.value(summary.solutions?.total ?? 0)}`);
+        console.log(`     ${c.label('Rules:')}      ${c.green(summary.rules?.active ?? 0)} active`);
+        console.log(`     ${c.label('Anti-Pat.:')} ${c.value(summary.antipatterns?.total ?? 0)}`);
+        console.log();
+
+        console.log(`  ${icons.module}  ${c.blue.bold('Code Brain')}`);
+        console.log(`     ${c.label('Modules:')}    ${c.value(summary.modules?.total ?? 0)} registered`);
+        console.log();
+
+        console.log(`  ${icons.synapse}  ${c.cyan.bold('Synapse Network')}`);
+        console.log(`     ${c.label('Synapses:')}   ${c.value(network.totalSynapses ?? 0)}`);
+        console.log(`     ${c.label('Avg weight:')} ${c.value((network.avgWeight ?? 0).toFixed(2))}`);
+        console.log();
+
+        console.log(`  ${icons.insight}  ${c.orange.bold('Research Brain')}`);
+        console.log(`     ${c.label('Insights:')}   ${c.value(summary.insights?.active ?? 0)} active`);
+
+        await checkForUpdate();
+        console.log(`\n${divider()}`);
+      });
+    });
+}

package/src/cli/commands/stop.ts

@@ -1,34 +1,34 @@
-import { Command } from 'commander';
-import fs from 'node:fs';
-import path from 'node:path';
-import { getDataDir } from '../../utils/paths.js';
-import { c, icons } from '../colors.js';
-
-export function stopCommand(): Command {
-  return new Command('stop')
-    .description('Stop the Brain daemon')
-    .action(() => {
-      const pidPath = path.join(getDataDir(), 'brain.pid');
-
-      if (!fs.existsSync(pidPath)) {
-        console.log(`${icons.brain}  ${c.dim('Brain daemon is not running (no PID file found).')}`);
-        return;
-      }
-
-      const pid = parseInt(fs.readFileSync(pidPath, 'utf8').trim(), 10);
-
-      try {
-        process.kill(pid, 'SIGTERM');
-        console.log(`${icons.brain}  ${c.success('Brain daemon stopped')} ${c.dim(`(PID: ${pid})`)}`);
-      } catch (err) {
-        if ((err as NodeJS.ErrnoException).code === 'ESRCH') {
-          console.log(`${icons.brain}  ${c.dim('Brain daemon was not running (stale PID file removed).')}`);
-        } else {
-          console.error(`${icons.error}  ${c.error(`Failed to stop daemon: ${err}`)}`);
-        }
-      }
-
-      // Clean up PID file
-      try { fs.unlinkSync(pidPath); } catch { /* ignore */ }
-    });
-}
+import { Command } from 'commander';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getDataDir } from '../../utils/paths.js';
+import { c, icons } from '../colors.js';
+
+export function stopCommand(): Command {
+  return new Command('stop')
+    .description('Stop the Brain daemon')
+    .action(() => {
+      const pidPath = path.join(getDataDir(), 'brain.pid');
+
+      if (!fs.existsSync(pidPath)) {
+        console.log(`${icons.brain}  ${c.dim('Brain daemon is not running (no PID file found).')}`);
+        return;
+      }
+
+      const pid = parseInt(fs.readFileSync(pidPath, 'utf8').trim(), 10);
+
+      try {
+        process.kill(pid, 'SIGTERM');
+        console.log(`${icons.brain}  ${c.success('Brain daemon stopped')} ${c.dim(`(PID: ${pid})`)}`);
+      } catch (err) {
+        if ((err as NodeJS.ErrnoException).code === 'ESRCH') {
+          console.log(`${icons.brain}  ${c.dim('Brain daemon was not running (stale PID file removed).')}`);
+        } else {
+          console.error(`${icons.error}  ${c.error(`Failed to stop daemon: ${err}`)}`);
+        }
+      }
+
+      // Clean up PID file
+      try { fs.unlinkSync(pidPath); } catch { /* ignore */ }
+    });
+}

package/src/cli/ipc-helper.ts

@@ -1,22 +1,22 @@
-import { IpcClient } from '../ipc/client.js';
-import { getPipeName } from '../utils/paths.js';
-import { c, icons } from './colors.js';
-
-export async function withIpc<T>(fn: (client: IpcClient) => Promise<T>): Promise<T> {
-  const client = new IpcClient(getPipeName(), 5000);
-  try {
-    await client.connect();
-    return await fn(client);
-  } catch (err) {
-    if (err instanceof Error && err.message.includes('ENOENT')) {
-      console.error(`${icons.error}  ${c.error('Brain daemon is not running.')} Start it with: ${c.cyan('brain start')}`);
-    } else if (err instanceof Error && err.message.includes('ECONNREFUSED')) {
-      console.error(`${icons.error}  ${c.error('Brain daemon is not responding.')} Try: ${c.cyan('brain stop && brain start')}`);
-    } else {
-      console.error(`${icons.error}  ${c.error(err instanceof Error ? err.message : String(err))}`);
-    }
-    process.exit(1);
-  } finally {
-    client.disconnect();
-  }
-}
+import { IpcClient } from '../ipc/client.js';
+import { getPipeName } from '../utils/paths.js';
+import { c, icons } from './colors.js';
+
+export async function withIpc<T>(fn: (client: IpcClient) => Promise<T>): Promise<T> {
+  const client = new IpcClient(getPipeName(), 5000);
+  try {
+    await client.connect();
+    return await fn(client);
+  } catch (err) {
+    if (err instanceof Error && err.message.includes('ENOENT')) {
+      console.error(`${icons.error}  ${c.error('Brain daemon is not running.')} Start it with: ${c.cyan('brain start')}`);
+    } else if (err instanceof Error && err.message.includes('ECONNREFUSED')) {
+      console.error(`${icons.error}  ${c.error('Brain daemon is not responding.')} Try: ${c.cyan('brain stop && brain start')}`);
+    } else {
+      console.error(`${icons.error}  ${c.error(err instanceof Error ? err.message : String(err))}`);
+    }
+    process.exit(1);
+  } finally {
+    client.disconnect();
+  }
+}

package/src/cli/update-check.ts

@@ -1,63 +1,63 @@
-import https from 'node:https';
-import { c, icons } from './colors.js';
-
-// Read current version from package.json at build time
-import { createRequire } from 'node:module';
-const require = createRequire(import.meta.url);
-const pkg = require('../../package.json');
-const CURRENT_VERSION: string = pkg.version;
-
-export function getCurrentVersion(): string {
-  return CURRENT_VERSION;
-}
-
-function fetchLatestVersion(): Promise<string | null> {
-  return new Promise((resolve) => {
-    const timeout = setTimeout(() => resolve(null), 3000);
-
-    const req = https.get(
-      'https://registry.npmjs.org/@timmeck/brain/latest',
-      { headers: { Accept: 'application/json' } },
-      (res) => {
-        let data = '';
-        res.on('data', (chunk) => { data += chunk; });
-        res.on('end', () => {
-          clearTimeout(timeout);
-          try {
-            const json = JSON.parse(data);
-            resolve(json.version ?? null);
-          } catch {
-            resolve(null);
-          }
-        });
-      },
-    );
-    req.on('error', () => {
-      clearTimeout(timeout);
-      resolve(null);
-    });
-  });
-}
-
-function isNewer(latest: string, current: string): boolean {
-  const l = latest.split('.').map(Number);
-  const c = current.split('.').map(Number);
-  for (let i = 0; i < 3; i++) {
-    if ((l[i] ?? 0) > (c[i] ?? 0)) return true;
-    if ((l[i] ?? 0) < (c[i] ?? 0)) return false;
-  }
-  return false;
-}
-
-export async function checkForUpdate(): Promise<void> {
-  try {
-    const latest = await fetchLatestVersion();
-    if (latest && isNewer(latest, CURRENT_VERSION)) {
-      console.log();
-      console.log(`  ${icons.star}  ${c.orange.bold(`Update available: v${CURRENT_VERSION} → v${latest}`)}`);
-      console.log(`     Run: ${c.cyan('npm update -g @timmeck/brain')}`);
-    }
-  } catch {
-    // silently ignore — update check is best-effort
-  }
-}
+import https from 'node:https';
+import { c, icons } from './colors.js';
+
+// Read current version from package.json at build time
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+const CURRENT_VERSION: string = pkg.version;
+
+export function getCurrentVersion(): string {
+  return CURRENT_VERSION;
+}
+
+function fetchLatestVersion(): Promise<string | null> {
+  return new Promise((resolve) => {
+    const timeout = setTimeout(() => resolve(null), 3000);
+
+    const req = https.get(
+      'https://registry.npmjs.org/@timmeck/brain/latest',
+      { headers: { Accept: 'application/json' } },
+      (res) => {
+        let data = '';
+        res.on('data', (chunk) => { data += chunk; });
+        res.on('end', () => {
+          clearTimeout(timeout);
+          try {
+            const json = JSON.parse(data);
+            resolve(json.version ?? null);
+          } catch {
+            resolve(null);
+          }
+        });
+      },
+    );
+    req.on('error', () => {
+      clearTimeout(timeout);
+      resolve(null);
+    });
+  });
+}
+
+function isNewer(latest: string, current: string): boolean {
+  const l = latest.split('.').map(Number);
+  const c = current.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((l[i] ?? 0) > (c[i] ?? 0)) return true;
+    if ((l[i] ?? 0) < (c[i] ?? 0)) return false;
+  }
+  return false;
+}
+
+export async function checkForUpdate(): Promise<void> {
+  try {
+    const latest = await fetchLatestVersion();
+    if (latest && isNewer(latest, CURRENT_VERSION)) {
+      console.log();
+      console.log(`  ${icons.star}  ${c.orange.bold(`Update available: v${CURRENT_VERSION} → v${latest}`)}`);
+      console.log(`     Run: ${c.cyan('npm update -g @timmeck/brain')}`);
+    }
+  } catch {
+    // silently ignore — update check is best-effort
+  }
+}