claude-brain 0.30.2 → 0.30.3

package/src/automation/repo-scanner.ts

@@ -1,205 +1,210 @@
-/**
- * Repo Scanner
- * Phase 22: Scans a repository to extract initial project context.
- * Used on first encounter or via `claude-brain init`.
- */
-
-import fs from 'fs/promises'
-import path from 'path'
-import { execSync } from 'child_process'
-
-export interface ProjectContext {
-  name: string
-  description: string
-  techStack: string[]
-  structure: string
-  recentActivity: string
-  projectInstructions?: string
-}
-
-/**
- * Scan a repository and extract project context.
- */
-export async function scanRepo(repoPath: string): Promise<ProjectContext> {
-  const name = path.basename(repoPath)
-
-  // Detect tech stack and name from manifest files
-  const manifest = await detectManifest(repoPath)
-  const projectName = manifest?.name || name
-  const techStack = manifest?.techStack || []
-
-  // Read README for description
-  const description = await readDescription(repoPath)
-
-  // Get directory structure
-  const structure = await getDirectoryTree(repoPath, 2)
-
-  // Get recent git activity
-  const recentActivity = getRecentGitActivity(repoPath)
-
-  // Read CLAUDE.md if present
-  const projectInstructions = await readClaudeMd(repoPath)
-
-  return {
-    name: projectName,
-    description,
-    techStack,
-    structure,
-    recentActivity,
-    projectInstructions
-  }
-}
-
-interface ManifestInfo {
-  name: string
-  techStack: string[]
-}
-
-async function detectManifest(repoPath: string): Promise<ManifestInfo | null> {
-  // Try package.json (Node.js)
-  try {
-    const content = await fs.readFile(path.join(repoPath, 'package.json'), 'utf-8')
-    const pkg = JSON.parse(content)
-    return {
-      name: (pkg.name || '').replace(/^@[^/]+\//, ''),
-      techStack: extractTechStack(pkg)
-    }
-  } catch { /* not a Node project */ }
-
-  // Try pyproject.toml (Python)
-  try {
-    const content = await fs.readFile(path.join(repoPath, 'pyproject.toml'), 'utf-8')
-    const nameMatch = content.match(/name\s*=\s*"([^"]+)"/)
-    const deps = content.match(/dependencies\s*=\s*\[([\s\S]*?)\]/)?.[1] || ''
-    const techStack = ['python']
-    if (deps.includes('django')) techStack.push('django')
-    if (deps.includes('fastapi')) techStack.push('fastapi')
-    if (deps.includes('flask')) techStack.push('flask')
-    if (deps.includes('pytest')) techStack.push('pytest')
-    return { name: nameMatch?.[1] || '', techStack }
-  } catch { /* not a Python project */ }
-
-  // Try Cargo.toml (Rust)
-  try {
-    const content = await fs.readFile(path.join(repoPath, 'Cargo.toml'), 'utf-8')
-    const nameMatch = content.match(/name\s*=\s*"([^"]+)"/)
-    return { name: nameMatch?.[1] || '', techStack: ['rust'] }
-  } catch { /* not a Rust project */ }
-
-  // Try go.mod (Go)
-  try {
-    const content = await fs.readFile(path.join(repoPath, 'go.mod'), 'utf-8')
-    const moduleMatch = content.match(/module\s+(\S+)/)
-    const moduleName = moduleMatch?.[1]?.split('/').pop() || ''
-    return { name: moduleName, techStack: ['go'] }
-  } catch { /* not a Go project */ }
-
-  return null
-}
-
-function extractTechStack(pkg: any): string[] {
-  const stack: string[] = []
-  const allDeps = { ...pkg.dependencies, ...pkg.devDependencies }
-
-  // Runtime
-  if (allDeps.typescript || allDeps['@types/node']) stack.push('typescript')
-  else stack.push('javascript')
-
-  // Frameworks
-  if (allDeps.react || allDeps['react-dom']) stack.push('react')
-  if (allDeps.next) stack.push('nextjs')
-  if (allDeps.vue) stack.push('vue')
-  if (allDeps.svelte) stack.push('svelte')
-  if (allDeps.express) stack.push('express')
-  if (allDeps.hono) stack.push('hono')
-  if (allDeps.fastify) stack.push('fastify')
-
-  // Tools
-  if (allDeps.bun || pkg.devDependencies?.['@types/bun']) stack.push('bun')
-  if (allDeps.vitest) stack.push('vitest')
-  if (allDeps.jest) stack.push('jest')
-  if (allDeps.tailwindcss) stack.push('tailwind')
-  if (allDeps.prisma || allDeps['@prisma/client']) stack.push('prisma')
-  if (allDeps.drizzle || allDeps['drizzle-orm']) stack.push('drizzle')
-
-  // AI/ML
-  if (allDeps['@modelcontextprotocol/sdk']) stack.push('mcp')
-  if (allDeps['@anthropic-ai/sdk']) stack.push('claude-api')
-  if (allDeps.openai) stack.push('openai')
-  if (allDeps.langchain) stack.push('langchain')
-
-  return stack
-}
-
-async function readDescription(repoPath: string): Promise<string> {
-  for (const readme of ['README.md', 'readme.md', 'Readme.md']) {
-    try {
-      const content = await fs.readFile(path.join(repoPath, readme), 'utf-8')
-      return content.slice(0, 500).trim()
-    } catch { /* no readme */ }
-  }
-  return ''
-}
-
-async function getDirectoryTree(repoPath: string, maxDepth: number): Promise<string> {
-  const IGNORED = new Set([
-    'node_modules', '.git', 'dist', 'build', '.next', '__pycache__',
-    '.venv', 'venv', '.mypy_cache', '.pytest_cache', 'target',
-    '.turbo', '.vercel', 'coverage', '.nyc_output'
-  ])
-
-  const lines: string[] = []
-
-  async function walk(dir: string, depth: number, prefix: string) {
-    if (depth > maxDepth) return
-
-    let entries: import("fs").Dirent[]
-    try {
-      entries = await fs.readdir(dir, { withFileTypes: true, encoding: 'utf-8' })
-    } catch {
-      return
-    }
-
-    const filtered = entries
-      .filter(e => !e.name.startsWith('.') || e.name === '.github')
-      .filter(e => !IGNORED.has(e.name))
-      .sort((a, b) => {
-        // Directories first
-        if (a.isDirectory() && !b.isDirectory()) return -1
-        if (!a.isDirectory() && b.isDirectory()) return 1
-        return a.name.localeCompare(b.name)
-      })
-
-    for (const entry of filtered.slice(0, 30)) { // Cap at 30 per level
-      const isDir = entry.isDirectory()
-      lines.push(`${prefix}${isDir ? entry.name + '/' : entry.name}`)
-      if (isDir) {
-        await walk(path.join(dir, entry.name), depth + 1, prefix + '  ')
-      }
-    }
-  }
-
-  await walk(repoPath, 0, '')
-  return lines.join('\n')
-}
-
-function getRecentGitActivity(repoPath: string): string {
-  try {
-    return execSync('git log --oneline -10', {
-      cwd: repoPath,
-      encoding: 'utf-8',
-      stdio: ['pipe', 'pipe', 'pipe']
-    }).trim()
-  } catch {
-    return ''
-  }
-}
-
-async function readClaudeMd(repoPath: string): Promise<string | undefined> {
-  try {
-    const content = await fs.readFile(path.join(repoPath, 'CLAUDE.md'), 'utf-8')
-    return content.trim()
-  } catch {
-    return undefined
-  }
-}
+/**
+ * Repo Scanner
+ * Phase 22: Scans a repository to extract initial project context.
+ * Used on first encounter or via `claude-brain init`.
+ */
+
+import fs from 'fs/promises'
+import path from 'path'
+import { spawnSync } from 'child_process'
+import { realpathSync } from 'node:fs'
+
+export interface ProjectContext {
+  name: string
+  description: string
+  techStack: string[]
+  structure: string
+  recentActivity: string
+  projectInstructions?: string
+}
+
+/**
+ * Scan a repository and extract project context.
+ */
+export async function scanRepo(repoPath: string): Promise<ProjectContext> {
+  const name = path.basename(repoPath)
+
+  // Detect tech stack and name from manifest files
+  const manifest = await detectManifest(repoPath)
+  const projectName = manifest?.name || name
+  const techStack = manifest?.techStack || []
+
+  // Read README for description
+  const description = await readDescription(repoPath)
+
+  // Get directory structure
+  const structure = await getDirectoryTree(repoPath, 2)
+
+  // Get recent git activity
+  const recentActivity = getRecentGitActivity(repoPath)
+
+  // Read CLAUDE.md if present
+  const projectInstructions = await readClaudeMd(repoPath)
+
+  return {
+    name: projectName,
+    description,
+    techStack,
+    structure,
+    recentActivity,
+    projectInstructions
+  }
+}
+
+interface ManifestInfo {
+  name: string
+  techStack: string[]
+}
+
+async function detectManifest(repoPath: string): Promise<ManifestInfo | null> {
+  // Try package.json (Node.js)
+  try {
+    const content = await fs.readFile(path.join(repoPath, 'package.json'), 'utf-8')
+    const pkg = JSON.parse(content)
+    return {
+      name: (pkg.name || '').replace(/^@[^/]+\//, ''),
+      techStack: extractTechStack(pkg)
+    }
+  } catch { /* not a Node project */ }
+
+  // Try pyproject.toml (Python)
+  try {
+    const content = await fs.readFile(path.join(repoPath, 'pyproject.toml'), 'utf-8')
+    const nameMatch = content.match(/name\s*=\s*"([^"]+)"/)
+    const deps = content.match(/dependencies\s*=\s*\[([\s\S]*?)\]/)?.[1] || ''
+    const techStack = ['python']
+    if (deps.includes('django')) techStack.push('django')
+    if (deps.includes('fastapi')) techStack.push('fastapi')
+    if (deps.includes('flask')) techStack.push('flask')
+    if (deps.includes('pytest')) techStack.push('pytest')
+    return { name: nameMatch?.[1] || '', techStack }
+  } catch { /* not a Python project */ }
+
+  // Try Cargo.toml (Rust)
+  try {
+    const content = await fs.readFile(path.join(repoPath, 'Cargo.toml'), 'utf-8')
+    const nameMatch = content.match(/name\s*=\s*"([^"]+)"/)
+    return { name: nameMatch?.[1] || '', techStack: ['rust'] }
+  } catch { /* not a Rust project */ }
+
+  // Try go.mod (Go)
+  try {
+    const content = await fs.readFile(path.join(repoPath, 'go.mod'), 'utf-8')
+    const moduleMatch = content.match(/module\s+(\S+)/)
+    const moduleName = moduleMatch?.[1]?.split('/').pop() || ''
+    return { name: moduleName, techStack: ['go'] }
+  } catch { /* not a Go project */ }
+
+  return null
+}
+
+function extractTechStack(pkg: Record<string, unknown>): string[] {
+  const stack: string[] = []
+  const allDeps: Record<string, unknown> = { ...(pkg.dependencies as Record<string, unknown>), ...(pkg.devDependencies as Record<string, unknown>) }
+
+  // Runtime
+  if (allDeps.typescript || allDeps['@types/node']) stack.push('typescript')
+  else stack.push('javascript')
+
+  // Frameworks
+  if (allDeps.react || allDeps['react-dom']) stack.push('react')
+  if (allDeps.next) stack.push('nextjs')
+  if (allDeps.vue) stack.push('vue')
+  if (allDeps.svelte) stack.push('svelte')
+  if (allDeps.express) stack.push('express')
+  if (allDeps.hono) stack.push('hono')
+  if (allDeps.fastify) stack.push('fastify')
+
+  // Tools
+  if (allDeps.bun || pkg.devDependencies?.['@types/bun']) stack.push('bun')
+  if (allDeps.vitest) stack.push('vitest')
+  if (allDeps.jest) stack.push('jest')
+  if (allDeps.tailwindcss) stack.push('tailwind')
+  if (allDeps.prisma || allDeps['@prisma/client']) stack.push('prisma')
+  if (allDeps.drizzle || allDeps['drizzle-orm']) stack.push('drizzle')
+
+  // AI/ML
+  if (allDeps['@modelcontextprotocol/sdk']) stack.push('mcp')
+  if (allDeps['@anthropic-ai/sdk']) stack.push('claude-api')
+  if (allDeps.openai) stack.push('openai')
+  if (allDeps.langchain) stack.push('langchain')
+
+  return stack
+}
+
+async function readDescription(repoPath: string): Promise<string> {
+  for (const readme of ['README.md', 'readme.md', 'Readme.md']) {
+    try {
+      const content = await fs.readFile(path.join(repoPath, readme), 'utf-8')
+      return content.slice(0, 500).trim()
+    } catch { /* no readme */ }
+  }
+  return ''
+}
+
+async function getDirectoryTree(repoPath: string, maxDepth: number): Promise<string> {
+  const IGNORED = new Set([
+    'node_modules', '.git', 'dist', 'build', '.next', '__pycache__',
+    '.venv', 'venv', '.mypy_cache', '.pytest_cache', 'target',
+    '.turbo', '.vercel', 'coverage', '.nyc_output'
+  ])
+
+  const lines: string[] = []
+
+  async function walk(dir: string, depth: number, prefix: string) {
+    if (depth > maxDepth) return
+
+    let entries: import("fs").Dirent[]
+    try {
+      entries = await fs.readdir(dir, { withFileTypes: true, encoding: 'utf-8' })
+    } catch {
+      return
+    }
+
+    const filtered = entries
+      .filter(e => !e.name.startsWith('.') || e.name === '.github')
+      .filter(e => !IGNORED.has(e.name))
+      .sort((a, b) => {
+        // Directories first
+        if (a.isDirectory() && !b.isDirectory()) return -1
+        if (!a.isDirectory() && b.isDirectory()) return 1
+        return a.name.localeCompare(b.name)
+      })
+
+    for (const entry of filtered.slice(0, 30)) { // Cap at 30 per level
+      const isDir = entry.isDirectory()
+      lines.push(`${prefix}${isDir ? entry.name + '/' : entry.name}`)
+      if (isDir) {
+        await walk(path.join(dir, entry.name), depth + 1, prefix + '  ')
+      }
+    }
+  }
+
+  await walk(repoPath, 0, '')
+  return lines.join('\n')
+}
+
+function getRecentGitActivity(repoPath: string): string {
+  try {
+    const resolvedPath = realpathSync(repoPath)
+    const result = spawnSync('git', ['log', '--oneline', '-10'], {
+      cwd: resolvedPath,
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 5000,
+    })
+    if (result.error || result.status !== 0) return ''
+    return result.stdout?.trim() || ''
+  } catch {
+    return ''
+  }
+}
+
+async function readClaudeMd(repoPath: string): Promise<string | undefined> {
+  try {
+    const content = await fs.readFile(path.join(repoPath, 'CLAUDE.md'), 'utf-8')
+    return content.trim()
+  } catch {
+    return undefined
+  }
+}

package/src/cli/auto-setup.ts

@@ -1,75 +1,75 @@
-import { mkdirSync, writeFileSync, existsSync } from 'node:fs'
-import { join } from 'node:path'
-import { isHomeInitialized, getHomePaths } from '@/config/home'
-
-function getDefaultEnv(vaultPath: string): string {
-  return `# Claude Brain Configuration
-# Generated by auto-setup on first run
-VAULT_PATH=${vaultPath}
-LOG_LEVEL=warn
-NODE_ENV=production
-`
-}
-
-const DEFAULT_GLOBAL_STANDARDS = `---
-type: global-standards
-last_updated: ${new Date().toISOString().split('T')[0]}
----
-
-# Global Coding Standards
-
-## General
-- Write clear, readable code
-- Prefer explicit over implicit
-- Keep functions focused and small
-
-## TypeScript
-- Use strict mode
-- Prefer const over let
-- Add JSDoc comments for public APIs
-`
-
-/**
- * Ensures the Claude Brain home directory exists with required structure.
- * Called before server start. No-op if already initialized.
- * All output goes to stderr (stdout reserved for MCP JSON-RPC).
- */
-export function ensureHomeDirectory(): void {
-  if (isHomeInitialized()) {
-    return
-  }
-
-  const paths = getHomePaths()
-
-  console.error(`[claude-brain] First run detected, initializing ${paths.root}`)
-
-  // Create directory structure
-  const dirs = [
-    paths.data,
-    paths.chroma,
-    paths.logs,
-    paths.vault,
-    paths.vaultProjects,
-    paths.vaultGlobal,
-    paths.models,
-  ]
-
-  for (const dir of dirs) {
-    mkdirSync(dir, { recursive: true })
-  }
-
-  // Write default .env if not present
-  if (!existsSync(paths.env)) {
-    writeFileSync(paths.env, getDefaultEnv(paths.vault), 'utf-8')
-    console.error('[claude-brain] Created default .env')
-  }
-
-  // Write default global standards if not present
-  const globalStandardsPath = join(paths.vaultGlobal, 'standards.md')
-  if (!existsSync(globalStandardsPath)) {
-    writeFileSync(globalStandardsPath, DEFAULT_GLOBAL_STANDARDS, 'utf-8')
-    console.error('[claude-brain] Created default global standards')
-  }
-
-  console.error('[claude-brain] Home directory initialized')
-}
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { isHomeInitialized, getHomePaths } from '@/config/home'
+
+function getDefaultEnv(vaultPath: string): string {
+  return `# Claude Brain Configuration
+# Generated by auto-setup on first run
+VAULT_PATH=${vaultPath}
+LOG_LEVEL=warn
+NODE_ENV=production
+`
+}
+
+const DEFAULT_GLOBAL_STANDARDS = `---
+type: global-standards
+last_updated: ${new Date().toISOString().split('T')[0]}
+---
+
+# Global Coding Standards
+
+## General
+- Write clear, readable code
+- Prefer explicit over implicit
+- Keep functions focused and small
+
+## TypeScript
+- Use strict mode
+- Prefer const over let
+- Add JSDoc comments for public APIs
+`
+
+/**
+ * Ensures the Claude Brain home directory exists with required structure.
+ * Called before server start. No-op if already initialized.
+ * All output goes to stderr (stdout reserved for MCP JSON-RPC).
+ */
+export function ensureHomeDirectory(): void {
+  if (isHomeInitialized()) {
+    return
+  }
+
+  const paths = getHomePaths()
+
+  console.error(`[claude-brain] First run detected, initializing ${paths.root}`)
+
+  // Create directory structure
+  const dirs = [
+    paths.data,
+    paths.chroma,
+    paths.logs,
+    paths.vault,
+    paths.vaultProjects,
+    paths.vaultGlobal,
+    paths.models,
+  ]
+
+  for (const dir of dirs) {
+    mkdirSync(dir, { recursive: true })
+  }
+
+  // Write default .env if not present
+  if (!existsSync(paths.env)) {
+    writeFileSync(paths.env, getDefaultEnv(paths.vault), 'utf-8')
+    console.error('[claude-brain] Created default .env')
+  }
+
+  // Write default global standards if not present
+  const globalStandardsPath = join(paths.vaultGlobal, 'standards.md')
+  if (!existsSync(globalStandardsPath)) {
+    writeFileSync(globalStandardsPath, DEFAULT_GLOBAL_STANDARDS, 'utf-8')
+    console.error('[claude-brain] Created default global standards')
+  }
+
+  console.error('[claude-brain] Home directory initialized')
+}