claude-brain 0.15.2 → 0.17.0

package/src/cli/commands/hooks.ts

@@ -1,213 +1,213 @@
-/**
- * Phase 17: CLI Hooks Command
- * Manages passive learning hooks (install/uninstall/status/enable/disable)
- */
-
-import {
-  renderLogo, theme, heading, successText, warningText, errorText, dimText,
-  box, summaryPanel, withSpinner,
-} from '@/cli/ui/index.js'
-import { installHooks, uninstallHooks, isHooksInstalled, getHookScriptPath } from '@/hooks/installer'
-import { readQueue } from '@/hooks/queue'
-
-export async function runHooks() {
-  const subcommand = process.argv[3] || 'status'
-
-  switch (subcommand) {
-    case 'install':
-      await handleInstall()
-      break
-    case 'uninstall':
-      await handleUninstall()
-      break
-    case 'status':
-      await handleStatus()
-      break
-    case 'enable':
-      await handleToggle(true)
-      break
-    case 'disable':
-      await handleToggle(false)
-      break
-    default:
-      console.log()
-      console.log(errorText(`Unknown hooks subcommand: ${subcommand}`))
-      printHooksHelp()
-      process.exit(1)
-  }
-}
-
-async function handleInstall() {
-  console.log()
-  console.log(renderLogo())
-  console.log()
-  console.log(heading('Install Passive Learning Hooks'))
-  console.log()
-
-  try {
-    let result: { installed: boolean; message: string } | undefined
-    await withSpinner('Installing hooks into Claude Code', async () => {
-      result = installHooks()
-    })
-
-    console.log()
-    if (result?.installed) {
-      console.log(box([
-        successText(result.message),
-        '',
-        dimText('Hooks will fire on every tool call in Claude Code.'),
-        dimText('Knowledge is captured and sent to the brain server.'),
-        dimText('Session summaries are auto-stored when conversations end.'),
-        '',
-        `${theme.dim('Hook script:')} ${getHookScriptPath()}`,
-        `${theme.dim('Settings:')}    ~/.claude/settings.json`,
-        '',
-        dimText('Hooks are enabled by default. To disable:'),
-        `  ${theme.bold('export CLAUDE_BRAIN_HOOKS_ENABLED=false')}`,
-      ].join('\n'), 'Hooks Installed'))
-    }
-  } catch (err) {
-    console.log()
-    console.log(box(
-      errorText(`Failed to install hooks: ${err instanceof Error ? err.message : String(err)}`),
-      'Error'
-    ))
-    process.exit(1)
-  }
-  console.log()
-}
-
-async function handleUninstall() {
-  console.log()
-  console.log(renderLogo())
-  console.log()
-  console.log(heading('Uninstall Passive Learning Hooks'))
-  console.log()
-
-  try {
-    let result: { uninstalled: boolean; message: string } | undefined
-    await withSpinner('Removing hooks from Claude Code', async () => {
-      result = uninstallHooks()
-    })
-
-    console.log()
-    if (result?.uninstalled) {
-      console.log(box(
-        successText(result.message),
-        'Hooks Removed'
-      ))
-    }
-  } catch (err) {
-    console.log()
-    console.log(box(
-      errorText(`Failed to uninstall hooks: ${err instanceof Error ? err.message : String(err)}`),
-      'Error'
-    ))
-    process.exit(1)
-  }
-  console.log()
-}
-
-async function handleStatus() {
-  console.log()
-  console.log(renderLogo())
-  console.log()
-  console.log(heading('Hook Status'))
-  console.log()
-
-  const installed = isHooksInstalled()
-  const queueItems = readQueue()
-  const envEnabled = process.env.CLAUDE_BRAIN_HOOKS_ENABLED !== 'false'
-
-  const items = [
-    { label: 'Installed', value: installed ? 'Yes' : 'No', status: installed ? 'success' as const : 'warning' as const },
-    { label: 'Env enabled', value: envEnabled ? 'Yes' : 'No', status: envEnabled ? 'success' as const : 'info' as const },
-    { label: 'Queue items', value: String(queueItems.length), status: queueItems.length > 0 ? 'warning' as const : 'info' as const },
-    { label: 'Hook script', value: getHookScriptPath(), status: 'info' as const },
-  ]
-
-  console.log(summaryPanel('Passive Learning Hooks', items))
-
-  // Try to fetch live stats from the server
-  try {
-    const port = parseInt(process.env.CLAUDE_BRAIN_PORT || '3000', 10)
-    const res = await fetch(`http://localhost:${port}/api/hooks/status`, {
-      signal: AbortSignal.timeout(2000),
-    })
-
-    if (res.ok) {
-      const data = await res.json() as any
-      if (data.success && data.data) {
-        console.log()
-        const serverItems = [
-          { label: 'Total captured', value: String(data.data.totalCaptured || 0), status: 'info' as const },
-          { label: 'Total skipped', value: String(data.data.totalSkipped || 0), status: 'info' as const },
-          { label: 'Total merged', value: String(data.data.totalMerged || 0), status: 'info' as const },
-          { label: 'Active sessions', value: String(data.data.activeSessions || 0), status: 'info' as const },
-          { label: 'Last capture', value: data.data.lastCaptureAt || 'Never', status: 'info' as const },
-        ]
-        console.log(summaryPanel('Server Stats', serverItems))
-      }
-    }
-  } catch {
-    console.log()
-    console.log(dimText('  (Server not running — no live stats available)'))
-  }
-
-  console.log()
-}
-
-async function handleToggle(enable: boolean) {
-  console.log()
-  console.log(renderLogo())
-  console.log()
-
-  const action = enable ? 'Enabling' : 'Disabling'
-  console.log(heading(`${action} Passive Learning`))
-  console.log()
-
-  // Toggle via env hint (actual config toggle would need config file editing)
-  if (enable) {
-    console.log(box([
-      successText('Hooks are enabled by default since v0.10.0.'),
-      '',
-      dimText('If previously disabled, remove the env variable:'),
-      `  ${theme.bold('unset CLAUDE_BRAIN_HOOKS_ENABLED')}`,
-      '',
-      dimText('Hooks capture Edit/Write/Bash events automatically.'),
-      dimText('Session summaries are stored when conversations end.'),
-    ].join('\n'), 'Enable Hooks'))
-  } else {
-    console.log(box([
-      warningText('To disable hooks, set the environment variable:'),
-      '',
-      `  ${theme.bold('export CLAUDE_BRAIN_HOOKS_ENABLED=false')}`,
-      '',
-      dimText('This stops hook processing without uninstalling.'),
-    ].join('\n'), 'Disable Hooks'))
-  }
-  console.log()
-}
-
-function printHooksHelp() {
-  console.log()
-  const commands = [
-    ['install', 'Install hooks into Claude Code settings'],
-    ['uninstall', 'Remove hooks from Claude Code settings'],
-    ['status', 'Show hook installation and capture stats'],
-    ['enable', 'Enable passive learning (show instructions)'],
-    ['disable', 'Disable passive learning (show instructions)'],
-  ]
-
-  const cmdLines = commands
-    .map(([cmd, desc]) => `  ${theme.primary(cmd!.padEnd(14))} ${dimText(desc!)}`)
-    .join('\n')
-
-  console.log(box([
-    theme.bold('Usage:') + ' ' + dimText('claude-brain hooks [subcommand]'),
-    '',
-    theme.bold('Subcommands:'),
-    cmdLines,
-  ].join('\n'), 'Hooks Help'))
-  console.log()
-}
+/**
+ * Phase 17: CLI Hooks Command
+ * Manages passive learning hooks (install/uninstall/status/enable/disable)
+ */
+
+import {
+  renderLogo, theme, heading, successText, warningText, errorText, dimText,
+  box, summaryPanel, withSpinner,
+} from '@/cli/ui/index.js'
+import { installHooks, uninstallHooks, isHooksInstalled, getHookScriptPath } from '@/hooks/installer'
+import { readQueue } from '@/hooks/queue'
+
+export async function runHooks() {
+  const subcommand = process.argv[3] || 'status'
+
+  switch (subcommand) {
+    case 'install':
+      await handleInstall()
+      break
+    case 'uninstall':
+      await handleUninstall()
+      break
+    case 'status':
+      await handleStatus()
+      break
+    case 'enable':
+      await handleToggle(true)
+      break
+    case 'disable':
+      await handleToggle(false)
+      break
+    default:
+      console.log()
+      console.log(errorText(`Unknown hooks subcommand: ${subcommand}`))
+      printHooksHelp()
+      process.exit(1)
+  }
+}
+
+async function handleInstall() {
+  console.log()
+  console.log(renderLogo())
+  console.log()
+  console.log(heading('Install Passive Learning Hooks'))
+  console.log()
+
+  try {
+    let result: { installed: boolean; message: string } | undefined
+    await withSpinner('Installing hooks into Claude Code', async () => {
+      result = installHooks()
+    })
+
+    console.log()
+    if (result?.installed) {
+      console.log(box([
+        successText(result.message),
+        '',
+        dimText('Hooks will fire on every tool call in Claude Code.'),
+        dimText('Knowledge is captured and sent to the brain server.'),
+        dimText('Session summaries are auto-stored when conversations end.'),
+        '',
+        `${theme.dim('Hook script:')} ${getHookScriptPath()}`,
+        `${theme.dim('Settings:')}    ~/.claude/settings.json`,
+        '',
+        dimText('Hooks are enabled by default. To disable:'),
+        `  ${theme.bold('export CLAUDE_BRAIN_HOOKS_ENABLED=false')}`,
+      ].join('\n'), 'Hooks Installed'))
+    }
+  } catch (err) {
+    console.log()
+    console.log(box(
+      errorText(`Failed to install hooks: ${err instanceof Error ? err.message : String(err)}`),
+      'Error'
+    ))
+    process.exit(1)
+  }
+  console.log()
+}
+
+async function handleUninstall() {
+  console.log()
+  console.log(renderLogo())
+  console.log()
+  console.log(heading('Uninstall Passive Learning Hooks'))
+  console.log()
+
+  try {
+    let result: { uninstalled: boolean; message: string } | undefined
+    await withSpinner('Removing hooks from Claude Code', async () => {
+      result = uninstallHooks()
+    })
+
+    console.log()
+    if (result?.uninstalled) {
+      console.log(box(
+        successText(result.message),
+        'Hooks Removed'
+      ))
+    }
+  } catch (err) {
+    console.log()
+    console.log(box(
+      errorText(`Failed to uninstall hooks: ${err instanceof Error ? err.message : String(err)}`),
+      'Error'
+    ))
+    process.exit(1)
+  }
+  console.log()
+}
+
+async function handleStatus() {
+  console.log()
+  console.log(renderLogo())
+  console.log()
+  console.log(heading('Hook Status'))
+  console.log()
+
+  const installed = isHooksInstalled()
+  const queueItems = readQueue()
+  const envEnabled = process.env.CLAUDE_BRAIN_HOOKS_ENABLED !== 'false'
+
+  const items = [
+    { label: 'Installed', value: installed ? 'Yes' : 'No', status: installed ? 'success' as const : 'warning' as const },
+    { label: 'Env enabled', value: envEnabled ? 'Yes' : 'No', status: envEnabled ? 'success' as const : 'info' as const },
+    { label: 'Queue items', value: String(queueItems.length), status: queueItems.length > 0 ? 'warning' as const : 'info' as const },
+    { label: 'Hook script', value: getHookScriptPath(), status: 'info' as const },
+  ]
+
+  console.log(summaryPanel('Passive Learning Hooks', items))
+
+  // Try to fetch live stats from the server
+  try {
+    const port = parseInt(process.env.CLAUDE_BRAIN_PORT || '3000', 10)
+    const res = await fetch(`http://localhost:${port}/api/hooks/status`, {
+      signal: AbortSignal.timeout(2000),
+    })
+
+    if (res.ok) {
+      const data = await res.json() as any
+      if (data.success && data.data) {
+        console.log()
+        const serverItems = [
+          { label: 'Total captured', value: String(data.data.totalCaptured || 0), status: 'info' as const },
+          { label: 'Total skipped', value: String(data.data.totalSkipped || 0), status: 'info' as const },
+          { label: 'Total merged', value: String(data.data.totalMerged || 0), status: 'info' as const },
+          { label: 'Active sessions', value: String(data.data.activeSessions || 0), status: 'info' as const },
+          { label: 'Last capture', value: data.data.lastCaptureAt || 'Never', status: 'info' as const },
+        ]
+        console.log(summaryPanel('Server Stats', serverItems))
+      }
+    }
+  } catch {
+    console.log()
+    console.log(dimText('  (Server not running — no live stats available)'))
+  }
+
+  console.log()
+}
+
+async function handleToggle(enable: boolean) {
+  console.log()
+  console.log(renderLogo())
+  console.log()
+
+  const action = enable ? 'Enabling' : 'Disabling'
+  console.log(heading(`${action} Passive Learning`))
+  console.log()
+
+  // Toggle via env hint (actual config toggle would need config file editing)
+  if (enable) {
+    console.log(box([
+      successText('Hooks are enabled by default since v0.10.0.'),
+      '',
+      dimText('If previously disabled, remove the env variable:'),
+      `  ${theme.bold('unset CLAUDE_BRAIN_HOOKS_ENABLED')}`,
+      '',
+      dimText('Hooks capture Edit/Write/Bash events automatically.'),
+      dimText('Session summaries are stored when conversations end.'),
+    ].join('\n'), 'Enable Hooks'))
+  } else {
+    console.log(box([
+      warningText('To disable hooks, set the environment variable:'),
+      '',
+      `  ${theme.bold('export CLAUDE_BRAIN_HOOKS_ENABLED=false')}`,
+      '',
+      dimText('This stops hook processing without uninstalling.'),
+    ].join('\n'), 'Disable Hooks'))
+  }
+  console.log()
+}
+
+function printHooksHelp() {
+  console.log()
+  const commands = [
+    ['install', 'Install hooks into Claude Code settings'],
+    ['uninstall', 'Remove hooks from Claude Code settings'],
+    ['status', 'Show hook installation and capture stats'],
+    ['enable', 'Enable passive learning (show instructions)'],
+    ['disable', 'Disable passive learning (show instructions)'],
+  ]
+
+  const cmdLines = commands
+    .map(([cmd, desc]) => `  ${theme.primary(cmd!.padEnd(14))} ${dimText(desc!)}`)
+    .join('\n')
+
+  console.log(box([
+    theme.bold('Usage:') + ' ' + dimText('claude-brain hooks [subcommand]'),
+    '',
+    theme.bold('Subcommands:'),
+    cmdLines,
+  ].join('\n'), 'Hooks Help'))
+  console.log()
+}

package/src/cli/commands/init.ts

@@ -1,122 +1,122 @@
-/**
- * Init Command
- * Phase 22: Scans a repository and stores initial project context.
- *
- * Usage: claude-brain init [path] [--force]
- */
-
-import path from 'path'
-import {
-  renderLogo, theme, heading, successText, warningText, dimText,
-  box, withSpinner,
-} from '@/cli/ui/index.js'
-import { scanRepo } from '@/automation/repo-scanner'
-
-export async function runInit() {
-  console.log()
-  console.log(renderLogo())
-  console.log()
-  console.log(heading('Initialize Project'))
-  console.log()
-
-  // Parse arguments
-  const args = process.argv.slice(3)
-  const force = args.includes('--force')
-  const repoPath = path.resolve(
-    args.find(a => !a.startsWith('--')) || process.cwd()
-  )
-
-  console.log(`  ${theme.bold('Path:')} ${dimText(repoPath)}`)
-  if (force) {
-    console.log(`  ${theme.bold('Mode:')} ${dimText('Force re-scan')}`)
-  }
-  console.log()
-
-  // Phase 23b: Validate project directory
-  const { existsSync: dirExists } = await import('fs')
-  const homeDir = process.env.HOME || process.env.USERPROFILE || ''
-  if (repoPath === homeDir) {
-    console.log(warningText('  This is your home directory — not a project root.'))
-    console.log(dimText('  Run this inside a project directory, or pass a path: claude-brain init /path/to/project'))
-    console.log()
-    return
-  }
-
-  const hasGit = dirExists(path.join(repoPath, '.git'))
-  const hasPackageJson = dirExists(path.join(repoPath, 'package.json'))
-  const hasCargoToml = dirExists(path.join(repoPath, 'Cargo.toml'))
-  const hasPyproject = dirExists(path.join(repoPath, 'pyproject.toml'))
-  const hasGoMod = dirExists(path.join(repoPath, 'go.mod'))
-  const isProject = hasGit || hasPackageJson || hasCargoToml || hasPyproject || hasGoMod
-
-  if (!isProject && !force) {
-    console.log(warningText('  No project markers found (no .git, package.json, Cargo.toml, etc.)'))
-    console.log(dimText('  Use --force to scan anyway, or run inside a project directory.'))
-    console.log()
-    return
-  }
-
-  // Scan the repo
-  const context = await withSpinner('Scanning repository', () => scanRepo(repoPath))
-
-  if (!context.name) {
-    console.log(warningText('  Could not detect project name. Specify a path to a project root.'))
-    return
-  }
-
-  // Display results
-  console.log(successText(`  Project: ${context.name}`))
-
-  if (context.techStack.length > 0) {
-    console.log(`  ${theme.bold('Tech stack:')} ${dimText(context.techStack.join(', '))}`)
-  }
-
-  if (context.description) {
-    const desc = context.description.split('\n')[0]?.slice(0, 100) || ''
-    console.log(`  ${theme.bold('Description:')} ${dimText(desc)}`)
-  }
-
-  if (context.recentActivity) {
-    const commits = context.recentActivity.split('\n').length
-    console.log(`  ${theme.bold('Recent commits:')} ${dimText(String(commits))}`)
-  }
-
-  if (context.projectInstructions) {
-    console.log(`  ${theme.bold('CLAUDE.md:')} ${dimText('found')}`)
-  }
-
-  // Try to store context via brain
-  try {
-    const summary = [
-      `Project "${context.name}" initialized.`,
-      context.techStack.length > 0 ? `Tech stack: ${context.techStack.join(', ')}.` : '',
-      context.description ? `Description: ${context.description.split('\n')[0]?.slice(0, 200)}` : '',
-      context.structure ? `Structure:\n${context.structure.split('\n').slice(0, 15).join('\n')}` : '',
-      context.recentActivity ? `Recent git activity:\n${context.recentActivity}` : '',
-      context.projectInstructions ? `CLAUDE.md contents:\n${context.projectInstructions.slice(0, 500)}` : ''
-    ].filter(Boolean).join('\n\n')
-
-    // Write to a local init file so the MCP server can pick it up
-    const { existsSync, mkdirSync } = await import('fs')
-    const { writeFileSync } = await import('fs')
-    const dataDir = path.join(repoPath, '.claude-brain')
-    if (!existsSync(dataDir)) {
-      mkdirSync(dataDir, { recursive: true })
-    }
-    writeFileSync(path.join(dataDir, 'init-context.md'), summary)
-
-    console.log()
-    console.log(successText(`  Initial context saved to .claude-brain/init-context.md`))
-  } catch (error) {
-    console.log(warningText(`  Could not save context: ${error instanceof Error ? error.message : 'unknown error'}`))
-  }
-
-  console.log()
-  console.log(box([
-    heading('Project initialized!'),
-    '',
-    dimText('Brain will auto-load this context in future sessions.'),
-    dimText('Use brain tool to store additional decisions and patterns.'),
-  ].join('\n'), 'Done'))
-  console.log()
-}
+/**
+ * Init Command
+ * Phase 22: Scans a repository and stores initial project context.
+ *
+ * Usage: claude-brain init [path] [--force]
+ */
+
+import path from 'path'
+import {
+  renderLogo, theme, heading, successText, warningText, dimText,
+  box, withSpinner,
+} from '@/cli/ui/index.js'
+import { scanRepo } from '@/automation/repo-scanner'
+
+export async function runInit() {
+  console.log()
+  console.log(renderLogo())
+  console.log()
+  console.log(heading('Initialize Project'))
+  console.log()
+
+  // Parse arguments
+  const args = process.argv.slice(3)
+  const force = args.includes('--force')
+  const repoPath = path.resolve(
+    args.find(a => !a.startsWith('--')) || process.cwd()
+  )
+
+  console.log(`  ${theme.bold('Path:')} ${dimText(repoPath)}`)
+  if (force) {
+    console.log(`  ${theme.bold('Mode:')} ${dimText('Force re-scan')}`)
+  }
+  console.log()
+
+  // Phase 23b: Validate project directory
+  const { existsSync: dirExists } = await import('fs')
+  const homeDir = process.env.HOME || process.env.USERPROFILE || ''
+  if (repoPath === homeDir) {
+    console.log(warningText('  This is your home directory — not a project root.'))
+    console.log(dimText('  Run this inside a project directory, or pass a path: claude-brain init /path/to/project'))
+    console.log()
+    return
+  }
+
+  const hasGit = dirExists(path.join(repoPath, '.git'))
+  const hasPackageJson = dirExists(path.join(repoPath, 'package.json'))
+  const hasCargoToml = dirExists(path.join(repoPath, 'Cargo.toml'))
+  const hasPyproject = dirExists(path.join(repoPath, 'pyproject.toml'))
+  const hasGoMod = dirExists(path.join(repoPath, 'go.mod'))
+  const isProject = hasGit || hasPackageJson || hasCargoToml || hasPyproject || hasGoMod
+
+  if (!isProject && !force) {
+    console.log(warningText('  No project markers found (no .git, package.json, Cargo.toml, etc.)'))
+    console.log(dimText('  Use --force to scan anyway, or run inside a project directory.'))
+    console.log()
+    return
+  }
+
+  // Scan the repo
+  const context = await withSpinner('Scanning repository', () => scanRepo(repoPath))
+
+  if (!context.name) {
+    console.log(warningText('  Could not detect project name. Specify a path to a project root.'))
+    return
+  }
+
+  // Display results
+  console.log(successText(`  Project: ${context.name}`))
+
+  if (context.techStack.length > 0) {
+    console.log(`  ${theme.bold('Tech stack:')} ${dimText(context.techStack.join(', '))}`)
+  }
+
+  if (context.description) {
+    const desc = context.description.split('\n')[0]?.slice(0, 100) || ''
+    console.log(`  ${theme.bold('Description:')} ${dimText(desc)}`)
+  }
+
+  if (context.recentActivity) {
+    const commits = context.recentActivity.split('\n').length
+    console.log(`  ${theme.bold('Recent commits:')} ${dimText(String(commits))}`)
+  }
+
+  if (context.projectInstructions) {
+    console.log(`  ${theme.bold('CLAUDE.md:')} ${dimText('found')}`)
+  }
+
+  // Try to store context via brain
+  try {
+    const summary = [
+      `Project "${context.name}" initialized.`,
+      context.techStack.length > 0 ? `Tech stack: ${context.techStack.join(', ')}.` : '',
+      context.description ? `Description: ${context.description.split('\n')[0]?.slice(0, 200)}` : '',
+      context.structure ? `Structure:\n${context.structure.split('\n').slice(0, 15).join('\n')}` : '',
+      context.recentActivity ? `Recent git activity:\n${context.recentActivity}` : '',
+      context.projectInstructions ? `CLAUDE.md contents:\n${context.projectInstructions.slice(0, 500)}` : ''
+    ].filter(Boolean).join('\n\n')
+
+    // Write to a local init file so the MCP server can pick it up
+    const { existsSync, mkdirSync } = await import('fs')
+    const { writeFileSync } = await import('fs')
+    const dataDir = path.join(repoPath, '.claude-brain')
+    if (!existsSync(dataDir)) {
+      mkdirSync(dataDir, { recursive: true })
+    }
+    writeFileSync(path.join(dataDir, 'init-context.md'), summary)
+
+    console.log()
+    console.log(successText(`  Initial context saved to .claude-brain/init-context.md`))
+  } catch (error) {
+    console.log(warningText(`  Could not save context: ${error instanceof Error ? error.message : 'unknown error'}`))
+  }
+
+  console.log()
+  console.log(box([
+    heading('Project initialized!'),
+    '',
+    dimText('Brain will auto-load this context in future sessions.'),
+    dimText('Use brain tool to store additional decisions and patterns.'),
+  ].join('\n'), 'Done'))
+  console.log()
+}