claude-brain 0.30.2 → 0.30.3

package/src/cli/commands/init.ts

@@ -1,123 +1,123 @@
-/**
- * Init Command
- * Phase 22: Scans a repository and stores initial project context.
- *
- * Usage: claude-brain init [path] [--force]
- */
-
-import path from 'path'
-import { parseArgs } from 'citty'
-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()
-
-  const args = parseArgs(process.argv.slice(3), {
-    path: { type: 'positional', required: false, description: 'Path to project directory' },
-    force: { type: 'boolean', default: false, description: 'Force re-scan even without project markers' },
-  })
-  const force = args.force
-  const repoPath = path.resolve(args.path || 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 { parseArgs } from 'citty'
+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()
+
+  const args = parseArgs(process.argv.slice(3), {
+    path: { type: 'positional', required: false, description: 'Path to project directory' },
+    force: { type: 'boolean', default: false, description: 'Force re-scan even without project markers' },
+  })
+  const force = args.force
+  const repoPath = path.resolve(args.path || 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()
+}

package/src/cli/commands/install-mcp.ts

@@ -1,111 +1,122 @@
-import { execSync } from 'node:child_process'
-import {
-  renderLogo, theme, heading, successText, warningText, errorText, dimText,
-  box, withSpinner,
-} from '@/cli/ui/index.js'
-
-function isGloballyInstalled(): boolean {
-  const cmd = process.platform === 'win32' ? 'where claude-brain' : 'which claude-brain'
-  try {
-    const result = execSync(cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] })
-    return result.trim().length > 0
-  } catch {
-    return false
-  }
-}
-
-function isMcpAlreadyConfigured(): boolean {
-  try {
-    const result = execSync('claude mcp list', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] })
-    return result.includes('claude-brain')
-  } catch {
-    return false
-  }
-}
-
-export async function runInstall() {
-  console.log()
-  console.log(renderLogo())
-  console.log()
-  console.log(heading('MCP Installation'))
-  console.log()
-
-  const installed = isGloballyInstalled()
-
-  if (installed) {
-    console.log(successText('claude-brain is globally installed'))
-    console.log()
-
-    if (isMcpAlreadyConfigured()) {
-      // Ensure user scope — remove local/project scope if present, then register at user scope
-      for (const scope of ['local', 'project']) {
-        try {
-          execSync(`claude mcp remove claude-brain -s ${scope}`, {
-            encoding: 'utf-8',
-            stdio: ['pipe', 'pipe', 'pipe']
-          })
-        } catch {
-          // OK — may not exist at this scope
-        }
-      }
-      try {
-        execSync('claude mcp add claude-brain -s user -- claude-brain serve', {
-          encoding: 'utf-8',
-          stdio: ['pipe', 'pipe', 'pipe']
-        })
-      } catch {
-        // OK — may already be registered at user scope
-      }
-      console.log(box(successText('MCP registered at user scope. Claude Brain is available in all projects.'), 'Success'))
-    } else {
-      try {
-        await withSpinner('Registering with Claude Code', async () => {
-          execSync('claude mcp add claude-brain -s user -- claude-brain serve', {
-            encoding: 'utf-8',
-            stdio: ['pipe', 'pipe', 'pipe']
-          })
-        })
-        console.log()
-        console.log(box(successText('Claude Brain registered as MCP server in Claude Code.'), 'Success'))
-      } catch (err) {
-        const errorMsg = err instanceof Error ? err.message : String(err)
-        if (errorMsg.includes('already') || errorMsg.includes('exists')) {
-          console.log()
-          console.log(box(successText('Already MCP configured. Claude Brain is registered as an MCP server.'), 'Success'))
-        } else {
-          console.log()
-          console.log(box([
-            errorText('Failed to register automatically.'),
-            '',
-            dimText('Run manually:'),
-            `  ${theme.bold('claude mcp add claude-brain -s user -- claude-brain serve')}`,
-          ].join('\n'), 'Error'))
-        }
-      }
-    }
-  } else {
-    console.log(warningText('claude-brain is not globally installed'))
-    console.log()
-
-    console.log(box([
-      `${theme.primary('Option 1:')} Install globally, then register`,
-      `  ${theme.bold('bun install -g claude-brain')}`,
-      `  ${theme.bold('claude mcp add claude-brain -s user -- claude-brain serve')}`,
-      '',
-      `${theme.primary('Option 2:')} Use bunx ${dimText('(zero-install)')}`,
-      `  ${theme.bold('claude mcp add claude-brain -s user -- bunx claude-brain@latest')}`,
-      '',
-      `${theme.primary('Option 3:')} Add to Claude Code config manually`,
-      dimText('  Add to your Claude Code MCP settings:'),
-      `  ${theme.dim('{')}`,
-      `    ${theme.dim('"mcpServers": {')}`,
-      `      ${theme.dim('"claude-brain": {')}`,
-      `        ${theme.dim('"command": "bunx",')}`,
-      `        ${theme.dim('"args": ["claude-brain@latest"]')}`,
-      `      ${theme.dim('}')}`,
-      `    ${theme.dim('}')}`,
-      `  ${theme.dim('}')}`,
-    ].join('\n'), 'Install Options'))
-  }
-  console.log()
-}
+import { spawnSync } from 'node:child_process'
+import {
+  renderLogo, theme, heading, successText, warningText, errorText, dimText,
+  box, withSpinner,
+} from '@/cli/ui/index.js'
+
+function isGloballyInstalled(): boolean {
+  const cmd = process.platform === 'win32' ? 'where' : 'which'
+  try {
+    const result = spawnSync(cmd, ['claude-brain'], {
+      encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 5000,
+    })
+    if (result.error || result.status !== 0) return false
+    return (result.stdout?.trim() || '').length > 0
+  } catch {
+    return false
+  }
+}
+
+function isMcpAlreadyConfigured(): boolean {
+  try {
+    const result = spawnSync('claude', ['mcp', 'list'], {
+      encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10_000,
+    })
+    if (result.error || result.status !== 0) return false
+    return (result.stdout || '').includes('claude-brain')
+  } catch {
+    return false
+  }
+}
+
+export async function runInstall() {
+  console.log()
+  console.log(renderLogo())
+  console.log()
+  console.log(heading('MCP Installation'))
+  console.log()
+
+  const installed = isGloballyInstalled()
+
+  if (installed) {
+    console.log(successText('claude-brain is globally installed'))
+    console.log()
+
+    if (isMcpAlreadyConfigured()) {
+      // Ensure user scope — remove local/project scope if present, then register at user scope
+      for (const scope of ['local', 'project']) {
+        spawnSync('claude', ['mcp', 'remove', 'claude-brain', '-s', scope], {
+          encoding: 'utf-8',
+          stdio: ['pipe', 'pipe', 'pipe'],
+          timeout: 10_000,
+        })
+        // OK — may not exist at this scope
+      }
+      spawnSync('claude', ['mcp', 'add', 'claude-brain', '-s', 'user', '--', 'claude-brain', 'serve'], {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+        timeout: 10_000,
+      })
+      // OK — may already be registered at user scope
+      console.log(box(successText('MCP registered at user scope. Claude Brain is available in all projects.'), 'Success'))
+    } else {
+      try {
+        await withSpinner('Registering with Claude Code', async () => {
+          const result = spawnSync('claude', ['mcp', 'add', 'claude-brain', '-s', 'user', '--', 'claude-brain', 'serve'], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 10_000,
+          })
+          if (result.error || result.status !== 0) {
+            const msg = result.stderr || ''
+            if (msg.includes('already') || msg.includes('exists')) {
+              // Already registered — not an error
+              return
+            }
+            throw new Error(msg || 'Registration failed')
+          }
+        })
+        console.log()
+        console.log(box(successText('Claude Brain registered as MCP server in Claude Code.'), 'Success'))
+      } catch (err) {
+        const errorMsg = err instanceof Error ? err.message : String(err)
+        if (errorMsg.includes('already') || errorMsg.includes('exists')) {
+          console.log()
+          console.log(box(successText('Already MCP configured. Claude Brain is registered as an MCP server.'), 'Success'))
+        } else {
+          console.log()
+          console.log(box([
+            errorText('Failed to register automatically.'),
+            '',
+            dimText('Run manually:'),
+            `  ${theme.bold('claude mcp add claude-brain -s user -- claude-brain serve')}`,
+          ].join('\n'), 'Error'))
+        }
+      }
+    }
+  } else {
+    console.log(warningText('claude-brain is not globally installed'))
+    console.log()
+
+    console.log(box([
+      `${theme.primary('Option 1:')} Install globally, then register`,
+      `  ${theme.bold('bun install -g claude-brain')}`,
+      `  ${theme.bold('claude mcp add claude-brain -s user -- claude-brain serve')}`,
+      '',
+      `${theme.primary('Option 2:')} Use bunx ${dimText('(zero-install)')}`,
+      `  ${theme.bold('claude mcp add claude-brain -s user -- bunx claude-brain@latest')}`,
+      '',
+      `${theme.primary('Option 3:')} Add to Claude Code config manually`,
+      dimText('  Add to your Claude Code MCP settings:'),
+      `  ${theme.dim('{')}`,
+      `    ${theme.dim('"mcpServers": {')}`,
+      `      ${theme.dim('"claude-brain": {')}`,
+      `        ${theme.dim('"command": "bunx",')}`,
+      `        ${theme.dim('"args": ["claude-brain@latest"]')}`,
+      `      ${theme.dim('}')}`,
+      `    ${theme.dim('}')}`,
+      `  ${theme.dim('}')}`,
+    ].join('\n'), 'Install Options'))
+  }
+  console.log()
+}