claude-brain 0.30.2 → 0.30.3

package/src/hooks/git-capture.ts

@@ -1,109 +1,109 @@
-/**
- * Phase 21: Git Commit Capture
- * Receives commit data from the post-commit hook and sends it to brain.
- * Called as: claude-brain git-capture <project> <branch> <message> <files> <port>
- */
-
-import { appendToQueue } from './queue'
-import type { CapturedKnowledge } from './types'
-
-export async function handleGitCapture(): Promise<void> {
-  // Parse positional args: project, branch, message, files, port
-  const [, , , rawProject, branch, message, filesStr, portStr] = process.argv
-
-  if (!rawProject || !message) {
-    process.exit(0)
-    return
-  }
-
-  // Phase 23b: Resolve project name — strip scoped package prefix, validate
-  const project = resolveProjectName(rawProject)
-  const port = parseInt(portStr || process.env.CLAUDE_BRAIN_PORT || '3000', 10)
-  const files = filesStr ? filesStr.split(',').filter(Boolean) : []
-
-  // Build captured knowledge
-  const knowledge: CapturedKnowledge = {
-    type: 'progress',
-    confidence: 0.9,
-    content: `Git commit on ${branch || 'unknown'}: ${message.trim()}${files.length > 0 ? ` (files: ${files.join(', ')})` : ''}`,
-    project: project || undefined,
-    technologies: detectTechnologies(files),
-    metadata: {
-      source: 'git-hook',
-      branch: branch || 'unknown',
-      commit_message: message.trim(),
-      files,
-      file_count: files.length,
-    },
-    source: 'hook-passive',
-    timestamp: new Date().toISOString(),
-  }
-
-  // POST to HTTP API server
-  try {
-    const res = await fetch(`http://localhost:${port}/api/hooks/ingest`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        knowledge: [knowledge],
-        sessionId: `git-${project}-${Date.now()}`,
-      }),
-      signal: AbortSignal.timeout(3000),
-    })
-
-    if (!res.ok) {
-      appendToQueue([knowledge])
-    }
-  } catch {
-    // Server unreachable — queue for later
-    appendToQueue([knowledge])
-  }
-
-  process.exit(0)
-}
-
-/**
- * Phase 23b: Resolve project name from raw input.
- * Strips npm scoped prefixes (@scope/name → name) and normalizes.
- */
-function resolveProjectName(raw: string): string {
-  let name = raw.trim()
-  // Strip npm scoped prefix: @scope/name → name
-  if (name.startsWith('@') && name.includes('/')) {
-    name = name.split(/[/\\]/).pop() || name
-  }
-  return name || raw
-}
-
-/**
- * Detect technologies from file extensions.
- */
-function detectTechnologies(files: string[]): string[] {
-  const techMap: Record<string, string> = {
-    '.ts': 'typescript',
-    '.tsx': 'react',
-    '.js': 'javascript',
-    '.jsx': 'react',
-    '.py': 'python',
-    '.rs': 'rust',
-    '.go': 'go',
-    '.rb': 'ruby',
-    '.java': 'java',
-    '.swift': 'swift',
-    '.kt': 'kotlin',
-    '.vue': 'vue',
-    '.svelte': 'svelte',
-    '.css': 'css',
-    '.scss': 'scss',
-    '.sql': 'sql',
-  }
-
-  const techs = new Set<string>()
-  for (const file of files) {
-    const ext = '.' + file.split('.').pop()
-    if (techMap[ext]) {
-      techs.add(techMap[ext])
-    }
-  }
-  return [...techs]
-}
+/**
+ * Phase 21: Git Commit Capture
+ * Receives commit data from the post-commit hook and sends it to brain.
+ * Called as: claude-brain git-capture <project> <branch> <message> <files> <port>
+ */
+
+import { appendToQueue } from './queue'
+import type { CapturedKnowledge } from './types'
+
+export async function handleGitCapture(): Promise<void> {
+  // Parse positional args: project, branch, message, files, port
+  const [, , , rawProject, branch, message, filesStr, portStr] = process.argv
+
+  if (!rawProject || !message) {
+    process.exit(0)
+    return
+  }
+
+  // Phase 23b: Resolve project name — strip scoped package prefix, validate
+  const project = resolveProjectName(rawProject)
+  const port = parseInt(portStr || process.env.CLAUDE_BRAIN_PORT || '3000', 10)
+  const files = filesStr ? filesStr.split(',').filter(Boolean) : []
+
+  // Build captured knowledge
+  const knowledge: CapturedKnowledge = {
+    type: 'progress',
+    confidence: 0.9,
+    content: `Git commit on ${branch || 'unknown'}: ${message.trim()}${files.length > 0 ? ` (files: ${files.join(', ')})` : ''}`,
+    project: project || undefined,
+    technologies: detectTechnologies(files),
+    metadata: {
+      source: 'git-hook',
+      branch: branch || 'unknown',
+      commit_message: message.trim(),
+      files,
+      file_count: files.length,
+    },
+    source: 'hook-passive',
+    timestamp: new Date().toISOString(),
+  }
+
+  // POST to HTTP API server
+  try {
+    const res = await fetch(`http://localhost:${port}/api/hooks/ingest`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        knowledge: [knowledge],
+        sessionId: `git-${project}-${Date.now()}`,
+      }),
+      signal: AbortSignal.timeout(3000),
+    })
+
+    if (!res.ok) {
+      appendToQueue([knowledge])
+    }
+  } catch {
+    // Server unreachable — queue for later
+    appendToQueue([knowledge])
+  }
+
+  process.exit(0)
+}
+
+/**
+ * Phase 23b: Resolve project name from raw input.
+ * Strips npm scoped prefixes (@scope/name → name) and normalizes.
+ */
+function resolveProjectName(raw: string): string {
+  let name = raw.trim()
+  // Strip npm scoped prefix: @scope/name → name
+  if (name.startsWith('@') && name.includes('/')) {
+    name = name.split(/[/\\]/).pop() || name
+  }
+  return name || raw
+}
+
+/**
+ * Detect technologies from file extensions.
+ */
+function detectTechnologies(files: string[]): string[] {
+  const techMap: Record<string, string> = {
+    '.ts': 'typescript',
+    '.tsx': 'react',
+    '.js': 'javascript',
+    '.jsx': 'react',
+    '.py': 'python',
+    '.rs': 'rust',
+    '.go': 'go',
+    '.rb': 'ruby',
+    '.java': 'java',
+    '.swift': 'swift',
+    '.kt': 'kotlin',
+    '.vue': 'vue',
+    '.svelte': 'svelte',
+    '.css': 'css',
+    '.scss': 'scss',
+    '.sql': 'sql',
+  }
+
+  const techs = new Set<string>()
+  for (const file of files) {
+    const ext = '.' + file.split('.').pop()
+    if (techMap[ext]) {
+      techs.add(techMap[ext])
+    }
+  }
+  return [...techs]
+}

package/src/hooks/git-hook-installer.ts

@@ -1,207 +1,211 @@
-/**
- * Phase 21: Git Hook Installer
- * Installs/uninstalls a post-commit git hook that captures commit data into brain.
- */
-
-import {
-  readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync, unlinkSync, readdirSync
-} from 'node:fs'
-import { join, resolve } from 'node:path'
-import { execSync } from 'node:child_process'
-
-const HOOK_MARKER = '# claude-brain-git-hook'
-const HOOK_FILENAME = 'post-commit'
-
-/**
- * Build the hook script content that gets appended to .git/hooks/post-commit.
- * Runs in background (&) so it doesn't slow down git.
- */
-function buildHookScript(): string {
-  const lines = [
-    '',
-    HOOK_MARKER,
-    '# Capture commit data into Claude Brain (runs in background)',
-    '(',
-    '  BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)',
-    '  MESSAGE=$(git log -1 --pretty=%B 2>/dev/null)',
-    '  FILES=$(git diff-tree --no-commit-id --name-only -r HEAD 2>/dev/null | tr "\\n" "," | sed "s/,$//")',
-    '  REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)',
-    '  # Phase 23b: Smart project name detection (package.json > init-context > basename)',
-    '  if [ -f "$REPO_ROOT/package.json" ]; then',
-    '    PROJECT=$(grep -m1 \'"name"\' "$REPO_ROOT/package.json" 2>/dev/null | sed \'s/.*"name"[[:space:]]*:[[:space:]]*"\\([^"]*\\)".*/\\1/\' | sed \'s/@[^/]*\\///\')',
-    '  fi',
-    '  if [ -z "$PROJECT" ] && [ -f "$REPO_ROOT/.claude-brain/init-context.md" ]; then',
-    '    PROJECT=$(head -1 "$REPO_ROOT/.claude-brain/init-context.md" 2>/dev/null | sed \'s/^Project "\\([^"]*\\)".*/\\1/\')',
-    '  fi',
-    '  if [ -z "$PROJECT" ]; then',
-    '    PROJECT=$(basename "$REPO_ROOT")',
-    '  fi',
-    '  PORT=${CLAUDE_BRAIN_PORT:-3000}',
-    '  claude-brain git-capture "$PROJECT" "$BRANCH" "$MESSAGE" "$FILES" "$PORT" 2>/dev/null',
-    ') &',
-    `${HOOK_MARKER}-end`,
-    '',
-  ]
-  return lines.join('\n')
-}
-
-/**
- * Find the .git directory for a given path.
- * Returns null if not in a git repo.
- */
-function findGitDir(repoPath?: string): string | null {
-  const cwd = repoPath ? resolve(repoPath) : process.cwd()
-  try {
-    const gitDir = execSync('git rev-parse --git-dir', {
-      cwd,
-      encoding: 'utf-8',
-      stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim()
-    // git-dir can be relative; resolve against cwd
-    return resolve(cwd, gitDir)
-  } catch {
-    return null
-  }
-}
-
-/**
- * Install the post-commit hook into a git repository.
- * Appends to existing hook if one exists; creates new if not.
- */
-export function installGitHook(repoPath?: string): { installed: boolean; message: string; hookPath: string } {
-  const gitDir = findGitDir(repoPath)
-  if (!gitDir) {
-    return { installed: false, message: 'Not a git repository', hookPath: '' }
-  }
-
-  const hooksDir = join(gitDir, 'hooks')
-  const hookPath = join(hooksDir, HOOK_FILENAME)
-
-  // Already installed?
-  if (isGitHookInstalled(repoPath)) {
-    return { installed: true, message: 'Git hook already installed', hookPath }
-  }
-
-  // Ensure hooks dir exists
-  if (!existsSync(hooksDir)) {
-    mkdirSync(hooksDir, { recursive: true })
-  }
-
-  // Read existing hook or start fresh
-  let existing = ''
-  if (existsSync(hookPath)) {
-    existing = readFileSync(hookPath, 'utf-8')
-  } else {
-    existing = '#!/bin/sh\n'
-  }
-
-  // Append our section
-  const combined = existing.trimEnd() + '\n' + buildHookScript()
-  writeFileSync(hookPath, combined, 'utf-8')
-  chmodSync(hookPath, 0o755)
-
-  return { installed: true, message: 'Git hook installed successfully', hookPath }
-}
-
-/**
- * Uninstall the post-commit hook from a git repository.
- * Removes only our section, preserving the rest.
- */
-export function uninstallGitHook(repoPath?: string): { uninstalled: boolean; message: string } {
-  const gitDir = findGitDir(repoPath)
-  if (!gitDir) {
-    return { uninstalled: false, message: 'Not a git repository' }
-  }
-
-  const hookPath = join(gitDir, 'hooks', HOOK_FILENAME)
-
-  if (!existsSync(hookPath)) {
-    return { uninstalled: true, message: 'No post-commit hook found' }
-  }
-
-  const content = readFileSync(hookPath, 'utf-8')
-  if (!content.includes(HOOK_MARKER)) {
-    return { uninstalled: true, message: 'Claude Brain hook not found in post-commit' }
-  }
-
-  // Remove our section (from marker to end-marker)
-  const lines = content.split('\n')
-  const filtered: string[] = []
-  let inOurSection = false
-
-  for (const line of lines) {
-    if (line.trim() === HOOK_MARKER) {
-      inOurSection = true
-      continue
-    }
-    if (line.trim() === `${HOOK_MARKER}-end`) {
-      inOurSection = false
-      continue
-    }
-    if (!inOurSection) {
-      filtered.push(line)
-    }
-  }
-
-  const cleaned = filtered.join('\n').trimEnd() + '\n'
-
-  // If only shebang remains, remove the hook file entirely
-  if (cleaned.trim() === '#!/bin/sh' || cleaned.trim() === '#!/bin/bash' || cleaned.trim() === '') {
-    unlinkSync(hookPath)
-    return { uninstalled: true, message: 'Git hook removed (file deleted — was empty)' }
-  }
-
-  writeFileSync(hookPath, cleaned, 'utf-8')
-  return { uninstalled: true, message: 'Git hook removed successfully' }
-}
-
-/**
- * Check if our hook is installed in a git repository.
- */
-export function isGitHookInstalled(repoPath?: string): boolean {
-  const gitDir = findGitDir(repoPath)
-  if (!gitDir) return false
-
-  const hookPath = join(gitDir, 'hooks', HOOK_FILENAME)
-  if (!existsSync(hookPath)) return false
-
-  const content = readFileSync(hookPath, 'utf-8')
-  return content.includes(HOOK_MARKER)
-}
-
-/**
- * Scan a directory for git repos and install hooks in all of them.
- */
-export async function installGitHookAll(dir: string): Promise<{ installed: number; skipped: number; errors: number }> {
-  const results = { installed: 0, skipped: 0, errors: 0 }
-  const absDir = resolve(dir)
-
-  if (!existsSync(absDir)) {
-    return results
-  }
-
-  // Find directories with .git
-  const entries = readdirSync(absDir, { withFileTypes: true })
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || entry.name.startsWith('.')) continue
-
-    const candidatePath = join(absDir, entry.name)
-    const gitPath = join(candidatePath, '.git')
-
-    if (existsSync(gitPath)) {
-      try {
-        const result = installGitHook(candidatePath)
-        if (result.installed && result.message !== 'Git hook already installed') {
-          results.installed++
-        } else {
-          results.skipped++
-        }
-      } catch {
-        results.errors++
-      }
-    }
-  }
-
-  return results
-}
+/**
+ * Phase 21: Git Hook Installer
+ * Installs/uninstalls a post-commit git hook that captures commit data into brain.
+ */
+
+import {
+  readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync, unlinkSync, readdirSync
+} from 'node:fs'
+import { join, resolve } from 'node:path'
+import { spawnSync } from 'node:child_process'
+
+const HOOK_MARKER = '# claude-brain-git-hook'
+const HOOK_FILENAME = 'post-commit'
+
+/**
+ * Build the hook script content that gets appended to .git/hooks/post-commit.
+ * Runs in background (&) so it doesn't slow down git.
+ */
+function buildHookScript(): string {
+  const lines = [
+    '',
+    HOOK_MARKER,
+    '# Capture commit data into Claude Brain (runs in background)',
+    '(',
+    '  BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)',
+    '  MESSAGE=$(git log -1 --pretty=%B 2>/dev/null)',
+    '  FILES=$(git diff-tree --no-commit-id --name-only -r HEAD 2>/dev/null | tr "\\n" "," | sed "s/,$//")',
+    '  REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)',
+    '  # Phase 23b: Smart project name detection (package.json > init-context > basename)',
+    '  if [ -f "$REPO_ROOT/package.json" ]; then',
+    '    PROJECT=$(grep -m1 \'"name"\' "$REPO_ROOT/package.json" 2>/dev/null | sed \'s/.*"name"[[:space:]]*:[[:space:]]*"\\([^"]*\\)".*/\\1/\' | sed \'s/@[^/]*\\///\')',
+    '  fi',
+    '  if [ -z "$PROJECT" ] && [ -f "$REPO_ROOT/.claude-brain/init-context.md" ]; then',
+    '    PROJECT=$(head -1 "$REPO_ROOT/.claude-brain/init-context.md" 2>/dev/null | sed \'s/^Project "\\([^"]*\\)".*/\\1/\')',
+    '  fi',
+    '  if [ -z "$PROJECT" ]; then',
+    '    PROJECT=$(basename "$REPO_ROOT")',
+    '  fi',
+    '  PORT=${CLAUDE_BRAIN_PORT:-3000}',
+    '  claude-brain git-capture "$PROJECT" "$BRANCH" "$MESSAGE" "$FILES" "$PORT" 2>/dev/null',
+    ') &',
+    `${HOOK_MARKER}-end`,
+    '',
+  ]
+  return lines.join('\n')
+}
+
+/**
+ * Find the .git directory for a given path.
+ * Returns null if not in a git repo.
+ */
+function findGitDir(repoPath?: string): string | null {
+  const cwd = repoPath ? resolve(repoPath) : process.cwd()
+  try {
+    const result = spawnSync('git', ['rev-parse', '--git-dir'], {
+      cwd,
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 5000,
+    })
+    if (result.error || result.status !== 0) return null
+    const gitDir = result.stdout?.trim() || ''
+    if (!gitDir) return null
+    // git-dir can be relative; resolve against cwd
+    return resolve(cwd, gitDir)
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Install the post-commit hook into a git repository.
+ * Appends to existing hook if one exists; creates new if not.
+ */
+export function installGitHook(repoPath?: string): { installed: boolean; message: string; hookPath: string } {
+  const gitDir = findGitDir(repoPath)
+  if (!gitDir) {
+    return { installed: false, message: 'Not a git repository', hookPath: '' }
+  }
+
+  const hooksDir = join(gitDir, 'hooks')
+  const hookPath = join(hooksDir, HOOK_FILENAME)
+
+  // Already installed?
+  if (isGitHookInstalled(repoPath)) {
+    return { installed: true, message: 'Git hook already installed', hookPath }
+  }
+
+  // Ensure hooks dir exists
+  if (!existsSync(hooksDir)) {
+    mkdirSync(hooksDir, { recursive: true })
+  }
+
+  // Read existing hook or start fresh
+  let existing = ''
+  if (existsSync(hookPath)) {
+    existing = readFileSync(hookPath, 'utf-8')
+  } else {
+    existing = '#!/bin/sh\n'
+  }
+
+  // Append our section
+  const combined = existing.trimEnd() + '\n' + buildHookScript()
+  writeFileSync(hookPath, combined, 'utf-8')
+  chmodSync(hookPath, 0o755)
+
+  return { installed: true, message: 'Git hook installed successfully', hookPath }
+}
+
+/**
+ * Uninstall the post-commit hook from a git repository.
+ * Removes only our section, preserving the rest.
+ */
+export function uninstallGitHook(repoPath?: string): { uninstalled: boolean; message: string } {
+  const gitDir = findGitDir(repoPath)
+  if (!gitDir) {
+    return { uninstalled: false, message: 'Not a git repository' }
+  }
+
+  const hookPath = join(gitDir, 'hooks', HOOK_FILENAME)
+
+  if (!existsSync(hookPath)) {
+    return { uninstalled: true, message: 'No post-commit hook found' }
+  }
+
+  const content = readFileSync(hookPath, 'utf-8')
+  if (!content.includes(HOOK_MARKER)) {
+    return { uninstalled: true, message: 'Claude Brain hook not found in post-commit' }
+  }
+
+  // Remove our section (from marker to end-marker)
+  const lines = content.split('\n')
+  const filtered: string[] = []
+  let inOurSection = false
+
+  for (const line of lines) {
+    if (line.trim() === HOOK_MARKER) {
+      inOurSection = true
+      continue
+    }
+    if (line.trim() === `${HOOK_MARKER}-end`) {
+      inOurSection = false
+      continue
+    }
+    if (!inOurSection) {
+      filtered.push(line)
+    }
+  }
+
+  const cleaned = filtered.join('\n').trimEnd() + '\n'
+
+  // If only shebang remains, remove the hook file entirely
+  if (cleaned.trim() === '#!/bin/sh' || cleaned.trim() === '#!/bin/bash' || cleaned.trim() === '') {
+    unlinkSync(hookPath)
+    return { uninstalled: true, message: 'Git hook removed (file deleted — was empty)' }
+  }
+
+  writeFileSync(hookPath, cleaned, 'utf-8')
+  return { uninstalled: true, message: 'Git hook removed successfully' }
+}
+
+/**
+ * Check if our hook is installed in a git repository.
+ */
+export function isGitHookInstalled(repoPath?: string): boolean {
+  const gitDir = findGitDir(repoPath)
+  if (!gitDir) return false
+
+  const hookPath = join(gitDir, 'hooks', HOOK_FILENAME)
+  if (!existsSync(hookPath)) return false
+
+  const content = readFileSync(hookPath, 'utf-8')
+  return content.includes(HOOK_MARKER)
+}
+
+/**
+ * Scan a directory for git repos and install hooks in all of them.
+ */
+export async function installGitHookAll(dir: string): Promise<{ installed: number; skipped: number; errors: number }> {
+  const results = { installed: 0, skipped: 0, errors: 0 }
+  const absDir = resolve(dir)
+
+  if (!existsSync(absDir)) {
+    return results
+  }
+
+  // Find directories with .git
+  const entries = readdirSync(absDir, { withFileTypes: true })
+
+  for (const entry of entries) {
+    if (!entry.isDirectory() || entry.name.startsWith('.')) continue
+
+    const candidatePath = join(absDir, entry.name)
+    const gitPath = join(candidatePath, '.git')
+
+    if (existsSync(gitPath)) {
+      try {
+        const result = installGitHook(candidatePath)
+        if (result.installed && result.message !== 'Git hook already installed') {
+          results.installed++
+        } else {
+          results.skipped++
+        }
+      } catch {
+        results.errors++
+      }
+    }
+  }
+
+  return results
+}