claude-brain 0.15.2 → 0.17.0

package/src/hooks/context-hook.ts

@@ -0,0 +1,137 @@
+#!/usr/bin/env bun
+/**
+ * Phase 26: Context Injection Hook
+ * Runs on UserPromptSubmit and SessionStart to inject relevant memories
+ * into Claude's context via additionalContext.
+ *
+ * CRITICAL CONSTRAINTS:
+ * - Must complete in <3s (blocks user prompt processing)
+ * - No heavy imports — just fetch + JSON parse
+ * - All errors silently caught with process.exit(0)
+ * - Outputs JSON to stdout: { hookSpecificOutput: { additionalContext: "..." } }
+ */
+
+interface HookStdin {
+  session_id: string
+  hook_event_name: string
+  prompt?: string
+  cwd?: string
+  source?: string
+}
+
+async function main(): Promise<void> {
+  // Parse --event arg
+  const eventIdx = process.argv.indexOf('--event')
+  const eventName = eventIdx >= 0 ? process.argv[eventIdx + 1] : undefined
+
+  // Read stdin JSON from Claude Code
+  let rawInput: string
+  try {
+    rawInput = await readStdin()
+  } catch {
+    process.exit(0)
+    return
+  }
+
+  if (!rawInput.trim()) {
+    process.exit(0)
+    return
+  }
+
+  let input: HookStdin
+  try {
+    input = JSON.parse(rawInput)
+  } catch {
+    process.exit(0)
+    return
+  }
+
+  const event = eventName || input.hook_event_name
+
+  // Skip if hooks explicitly disabled
+  if (process.env.CLAUDE_BRAIN_HOOKS_ENABLED === 'false') {
+    process.exit(0)
+    return
+  }
+
+  const port = parseInt(process.env.CLAUDE_BRAIN_PORT || '3000', 10)
+  const baseUrl = `http://localhost:${port}`
+
+  let context = ''
+
+  try {
+    if (event === 'UserPromptSubmit' && input.prompt) {
+      // Query for memories relevant to the user's prompt
+      const params = new URLSearchParams({
+        query: input.prompt.slice(0, 500), // Limit query length
+        limit: '5',
+      })
+      if (input.cwd) params.set('cwd', input.cwd)
+
+      const res = await fetch(`${baseUrl}/api/hooks/context-query?${params}`, {
+        signal: AbortSignal.timeout(2000),
+      })
+
+      if (res.ok) {
+        const data = await res.json() as { success: boolean; context: string }
+        context = data.context || ''
+      }
+    } else if (event === 'SessionStart') {
+      // Load broader project context on session start
+      const params = new URLSearchParams({ type: 'session-start' })
+      if (input.cwd) params.set('cwd', input.cwd)
+
+      const res = await fetch(`${baseUrl}/api/hooks/context-query?${params}`, {
+        signal: AbortSignal.timeout(2000),
+      })
+
+      if (res.ok) {
+        const data = await res.json() as { success: boolean; context: string }
+        context = data.context || ''
+      }
+    }
+  } catch {
+    // Server unreachable or timeout — exit silently
+    process.exit(0)
+    return
+  }
+
+  // Only output if we have context to inject
+  if (context.trim()) {
+    const output = {
+      hookSpecificOutput: {
+        hookEventName: event,
+        additionalContext: `[Brain Memory]\n${context}`,
+      },
+    }
+    process.stdout.write(JSON.stringify(output))
+  }
+
+  process.exit(0)
+}
+
+/** Read all of stdin as a string */
+function readStdin(): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const chunks: Buffer[] = []
+    const stdin = process.stdin
+
+    stdin.on('data', (chunk: Buffer) => chunks.push(chunk))
+    stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')))
+    stdin.on('error', reject)
+
+    // Timeout after 2 seconds
+    setTimeout(() => {
+      stdin.destroy()
+      resolve(Buffer.concat(chunks).toString('utf-8'))
+    }, 2000)
+  })
+}
+
+// Execute when run directly
+const isDirectRun = process.argv[1]?.includes('context-hook')
+if (isDirectRun) {
+  main().catch(() => process.exit(0))
+}
+
+export { main }

package/src/hooks/deduplicator.ts

@@ -1,72 +1,72 @@
-/**
- * Phase 17: Smart Deduplicator
- * Three-tier dedup before storage:
- *   >0.95 similarity → skip (exact duplicate)
- *   0.85–0.95 similarity → merge (update existing)
- *   <0.85 similarity → store_new
- */
-
-import type { MemoryManager } from '@/memory'
-import type { CapturedKnowledge, StoreAction } from './types'
-import type { HooksConfig } from '@/config/schema'
-
-export class SmartDeduplicator {
-  private skipThreshold: number
-  private mergeThreshold: number
-
-  constructor(config?: HooksConfig['deduplication']) {
-    this.skipThreshold = config?.skipThreshold ?? 0.95
-    this.mergeThreshold = config?.mergeThreshold ?? 0.85
-  }
-
-  /**
-   * Check captured knowledge against existing memory
-   * and decide: store_new, merge, or skip
-   */
-  async beforeStore(
-    knowledge: CapturedKnowledge,
-    memoryManager: MemoryManager
-  ): Promise<StoreAction> {
-    try {
-      const results = await memoryManager.searchRaw(knowledge.content, {
-        project: knowledge.project,
-        limit: 3,
-        minSimilarity: this.mergeThreshold,
-      })
-
-      if (!results || results.length === 0) {
-        return { action: 'store_new' }
-      }
-
-      const topResult = results[0]
-      const similarity = topResult.similarity ?? 0
-
-      if (similarity >= this.skipThreshold) {
-        return {
-          action: 'skip',
-          reason: `Duplicate (similarity: ${similarity.toFixed(3)})`,
-        }
-      }
-
-      if (similarity >= this.mergeThreshold) {
-        const existingId = topResult.memory?.id || topResult.id
-        const existingContent = topResult.memory?.content ||
-          topResult.decision?.decision ||
-          ''
-        const datestamp = new Date().toISOString().split('T')[0]
-        const mergedContent = `${existingContent}\n[Updated ${datestamp}]: ${knowledge.content}`
-
-        return {
-          action: 'merge',
-          existingId,
-          mergedContent,
-        }
-      }
-
-      return { action: 'store_new' }
-    } catch {
-      // If search fails, store as new to avoid data loss
-      return { action: 'store_new' }
-    }
-  }
-}
+/**
+ * Phase 17: Smart Deduplicator
+ * Three-tier dedup before storage:
+ *   >0.95 similarity → skip (exact duplicate)
+ *   0.85–0.95 similarity → merge (update existing)
+ *   <0.85 similarity → store_new
+ */
+
+import type { MemoryManager } from '@/memory'
+import type { CapturedKnowledge, StoreAction } from './types'
+import type { HooksConfig } from '@/config/schema'
+
+export class SmartDeduplicator {
+  private skipThreshold: number
+  private mergeThreshold: number
+
+  constructor(config?: HooksConfig['deduplication']) {
+    this.skipThreshold = config?.skipThreshold ?? 0.95
+    this.mergeThreshold = config?.mergeThreshold ?? 0.85
+  }
+
+  /**
+   * Check captured knowledge against existing memory
+   * and decide: store_new, merge, or skip
+   */
+  async beforeStore(
+    knowledge: CapturedKnowledge,
+    memoryManager: MemoryManager
+  ): Promise<StoreAction> {
+    try {
+      const results = await memoryManager.searchRaw(knowledge.content, {
+        project: knowledge.project,
+        limit: 3,
+        minSimilarity: this.mergeThreshold,
+      })
+
+      if (!results || results.length === 0) {
+        return { action: 'store_new' }
+      }
+
+      const topResult = results[0]
+      const similarity = topResult.similarity ?? 0
+
+      if (similarity >= this.skipThreshold) {
+        return {
+          action: 'skip',
+          reason: `Duplicate (similarity: ${similarity.toFixed(3)})`,
+        }
+      }
+
+      if (similarity >= this.mergeThreshold) {
+        const existingId = topResult.memory?.id || topResult.id
+        const existingContent = topResult.memory?.content ||
+          topResult.decision?.decision ||
+          ''
+        const datestamp = new Date().toISOString().split('T')[0]
+        const mergedContent = `${existingContent}\n[Updated ${datestamp}]: ${knowledge.content}`
+
+        return {
+          action: 'merge',
+          existingId,
+          mergedContent,
+        }
+      }
+
+      return { action: 'store_new' }
+    } catch {
+      // If search fails, store as new to avoid data loss
+      return { action: 'store_new' }
+    }
+  }
+}

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]
+}