claude-brain 0.30.2 → 0.30.3

package/src/hooks/context-hook.ts

@@ -1,245 +1,260 @@
-#!/usr/bin/env bun
-/**
- * Phase 26+: Context Injection Hook
- * Runs on UserPromptSubmit and SessionStart to inject relevant memories
- * into Claude's context via additionalContext.
- *
- * SessionStart also injects the static Claude Code Mastery guidelines
- * (claude-code-mastery.md) to optimize Claude's behavior every session.
- *
- * CRITICAL CONSTRAINTS:
- * - Must complete in <3s (blocks user prompt processing)
- * - No heavy imports — just fetch + JSON parse + fs.readFileSync
- * - All errors silently caught with process.exit(0)
- * - Outputs JSON to stdout: { hookSpecificOutput: { additionalContext: "..." } }
- */
-
-import { readFileSync, existsSync } from 'node:fs'
-import { join, dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-interface HookStdin {
-  session_id: string
-  hook_event_name: string
-  prompt?: string
-  cwd?: string
-  source?: string
-}
-
-/** Cache the mastery doc in memory after first read */
-let masteryCache: string | null = null
-
-/** Read the static Claude Code Mastery guidelines from disk (once, then cached) */
-function loadMasteryDoc(): string {
-  if (masteryCache !== null) return masteryCache
-
-  // Resolve relative to this script's location (works both in src/ and installed ~/.claude-brain/hooks/)
-  const scriptDir = (import.meta as any).dir ?? dirname(fileURLToPath(import.meta.url))
-  const masteryPath = join(scriptDir, 'claude-code-mastery.md')
-
-  try {
-    if (existsSync(masteryPath)) {
-      masteryCache = readFileSync(masteryPath, 'utf-8').trim()
-    } else {
-      masteryCache = ''
-    }
-  } catch {
-    masteryCache = ''
-  }
-
-  return masteryCache
-}
-
-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
-  }
-
-  // BUG-006: Read port from --port arg (cross-platform). Env var fallback removed — breaks Windows cmd.exe.
-  const portIdx = process.argv.indexOf('--port')
-  const portArg = portIdx >= 0 ? process.argv[portIdx + 1] : undefined
-  const port = parseInt(portArg || '3000', 10)
-  const baseUrl = `http://localhost:${port}`
-
-  let brainContext = ''
-  let codeMapText = ''
-  let fileMemoryText = ''
-
-  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 contextPromise = fetch(`${baseUrl}/api/hooks/context-query?${params}`, {
-        signal: AbortSignal.timeout(2000),
-      }).catch(() => null)
-
-      // Phase 29: Detect file paths in the user's prompt and fetch linked memories
-      const projectName = input.cwd ? input.cwd.split(/[/\\]/).filter(Boolean).pop() : ''
-      const filePaths = extractFilePathsFromPrompt(input.prompt)
-      const fileMemoryPromises = filePaths.slice(0, 3).map(fp =>
-        fetch(`${baseUrl}/api/memory/for-file?file=${encodeURIComponent(fp)}&project=${encodeURIComponent(projectName || '')}`, {
-          signal: AbortSignal.timeout(1000),
-        }).then(r => r.ok ? r.json() : null).catch(() => null)
-      )
-
-      const [contextRes, ...fileMemories] = await Promise.all([contextPromise, ...fileMemoryPromises])
-
-      if (contextRes?.ok) {
-        const data = await contextRes.json() as { success: boolean; context: string }
-        brainContext = data.context || ''
-      }
-
-      // Phase 29: Aggregate file memory summaries
-      const relevant = fileMemories.filter((m: any) => m?.data?.summary)
-      if (relevant.length > 0) {
-        fileMemoryText = relevant.map((m: any) => m.data.summary).join('\n\n')
-      }
-    } 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)
-
-      // Extract project name from cwd for code map
-      const projectName = input.cwd ? input.cwd.split(/[/\\]/).filter(Boolean).pop() : undefined
-
-      // Fetch brain context AND code map in parallel
-      const [contextRes, codeMapRes] = await Promise.all([
-        fetch(`${baseUrl}/api/hooks/context-query?${params}`, { signal: AbortSignal.timeout(2000) }).catch(() => null),
-        projectName
-          ? fetch(`${baseUrl}/api/code/file-map?project=${encodeURIComponent(projectName)}`, { signal: AbortSignal.timeout(2000) }).catch(() => null)
-          : Promise.resolve(null),
-      ])
-
-      // Process brain context (existing logic)
-      if (contextRes?.ok) {
-        const data = await contextRes.json() as { success: boolean; context: string }
-        brainContext = data.context || ''
-      }
-
-      // Process code map (Phase 28)
-      if (codeMapRes?.ok) {
-        try {
-          const data = await codeMapRes.json() as { success: boolean; data?: { map?: string } }
-          if (data.success && data.data?.map) {
-            codeMapText = data.data.map
-          }
-        } catch {
-          // Silently ignore malformed code map response
-        }
-      }
-    }
-  } catch {
-    // Server unreachable or timeout — continue with static content only for SessionStart
-    if (event !== 'SessionStart') {
-      process.exit(0)
-      return
-    }
-  }
-
-  // Build final injection content
-  const parts: string[] = []
-
-  // SessionStart: prepend static Claude Code Mastery guidelines
-  if (event === 'SessionStart') {
-    const mastery = loadMasteryDoc()
-    if (mastery) {
-      parts.push(`[Claude Code Mastery]\n${mastery}`)
-    }
-  }
-
-  // Append dynamic brain memories (both events)
-  if (brainContext.trim()) {
-    parts.push(`[Brain Memory]\n${brainContext}`)
-  }
-
-  // Phase 29: Append file-linked memories (UserPromptSubmit only)
-  if (fileMemoryText.trim()) {
-    parts.push(`[File Memories]\n${fileMemoryText}`)
-  }
-
-  // Append code map (SessionStart only, Phase 28)
-  if (codeMapText.trim()) {
-    parts.push(`[Code Map]\nProject file index (use Read directly, skip Glob):\n${codeMapText}`)
-  }
-
-  // Output combined context
-  if (parts.length > 0) {
-    const output = {
-      hookSpecificOutput: {
-        hookEventName: event,
-        additionalContext: parts.join('\n\n'),
-      },
-    }
-    process.stdout.write(JSON.stringify(output))
-  }
-
-  process.exit(0)
-}
-
-/** Phase 29: Extract file paths from user prompt text */
-function extractFilePathsFromPrompt(prompt: string): string[] {
-  const pathPattern = /(?:^|\s)((?:src|lib|app|pages|components|utils|hooks|server|api|config|middleware|routes|models|services|types|scripts|tests|test)\/[\w\-./]+\.\w+)/g
-  const matches = [...prompt.matchAll(pathPattern)]
-  return [...new Set(matches.map(m => m[1]))]
-}
-
-/** 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 }
+#!/usr/bin/env bun
+/**
+ * Phase 26+: Context Injection Hook
+ * Runs on UserPromptSubmit and SessionStart to inject relevant memories
+ * into Claude's context via additionalContext.
+ *
+ * SessionStart also injects the static Claude Code Mastery guidelines
+ * (claude-code-mastery.md) to optimize Claude's behavior every session.
+ *
+ * CRITICAL CONSTRAINTS:
+ * - Must complete in <3s (blocks user prompt processing)
+ * - No heavy imports — just fetch + JSON parse + fs.readFileSync
+ * - All errors silently caught with process.exit(0)
+ * - Outputs JSON to stdout: { hookSpecificOutput: { additionalContext: "..." } }
+ */
+
+import { readFileSync, existsSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+interface HookStdin {
+  session_id: string
+  hook_event_name: string
+  prompt?: string
+  cwd?: string
+  source?: string
+}
+
+/** Cache the mastery doc in memory after first read */
+let masteryCache: string | null = null
+
+/** Read the static Claude Code Mastery guidelines from disk (once, then cached) */
+function loadMasteryDoc(): string {
+  if (masteryCache !== null) return masteryCache
+
+  // Resolve relative to this script's location (works both in src/ and installed ~/.claude-brain/hooks/)
+  const scriptDir = (import.meta as any).dir ?? dirname(fileURLToPath(import.meta.url))
+  const masteryPath = join(scriptDir, 'claude-code-mastery.md')
+
+  try {
+    if (existsSync(masteryPath)) {
+      masteryCache = readFileSync(masteryPath, 'utf-8').trim()
+    } else {
+      masteryCache = ''
+    }
+  } catch {
+    masteryCache = ''
+  }
+
+  return masteryCache
+}
+
+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
+  }
+
+  // BUG-006: Read port from --port arg (cross-platform). Env var fallback removed — breaks Windows cmd.exe.
+  const portIdx = process.argv.indexOf('--port')
+  const portArg = portIdx >= 0 ? process.argv[portIdx + 1] : undefined
+  const port = parseInt(portArg || '3000', 10)
+  const baseUrl = `http://localhost:${port}`
+
+  let brainContext = ''
+  let codeMapText = ''
+  let fileMemoryText = ''
+
+  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 contextPromise = fetch(`${baseUrl}/api/hooks/context-query?${params}`, {
+        signal: AbortSignal.timeout(2000),
+      }).catch((error) => {
+        process.stderr.write(`[context-hook] Context query failed: ${error?.message || error}\n`)
+        return null
+      })
+
+      // Phase 29: Detect file paths in the user's prompt and fetch linked memories
+      const projectName = input.cwd ? input.cwd.split(/[/\\]/).filter(Boolean).pop() : ''
+      const filePaths = extractFilePathsFromPrompt(input.prompt)
+      const fileMemoryPromises = filePaths.slice(0, 3).map(fp =>
+        fetch(`${baseUrl}/api/memory/for-file?file=${encodeURIComponent(fp)}&project=${encodeURIComponent(projectName || '')}`, {
+          signal: AbortSignal.timeout(1000),
+        }).then(r => r.ok ? r.json() : null).catch((error) => {
+          process.stderr.write(`[context-hook] File memory fetch failed: ${error?.message || error}\n`)
+          return null
+        })
+      )
+
+      const [contextRes, ...fileMemories] = await Promise.all([contextPromise, ...fileMemoryPromises])
+
+      if (contextRes?.ok) {
+        const data = await contextRes.json() as { success: boolean; context: string }
+        brainContext = data.context || ''
+      }
+
+      // Phase 29: Aggregate file memory summaries
+      const relevant = fileMemories.filter((m: Record<string, unknown>) => (m?.data as Record<string, unknown>)?.summary)
+      if (relevant.length > 0) {
+        fileMemoryText = relevant.map((m: Record<string, unknown>) => ((m.data as Record<string, unknown>)?.summary as string) || '').join('\n\n')
+      }
+    } 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)
+
+      // Extract project name from cwd for code map
+      const projectName = input.cwd ? input.cwd.split(/[/\\]/).filter(Boolean).pop() : undefined
+
+      // Fetch brain context AND code map in parallel
+      const [contextRes, codeMapRes] = await Promise.all([
+        fetch(`${baseUrl}/api/hooks/context-query?${params}`, { signal: AbortSignal.timeout(2000) }).catch((error) => {
+          process.stderr.write(`[context-hook] Session-start context query failed: ${error?.message || error}\n`)
+          return null
+        }),
+        projectName
+          ? fetch(`${baseUrl}/api/code/file-map?project=${encodeURIComponent(projectName)}`, { signal: AbortSignal.timeout(2000) }).catch((error) => {
+              process.stderr.write(`[context-hook] Code map fetch failed: ${error?.message || error}\n`)
+              return null
+            })
+          : Promise.resolve(null),
+      ])
+
+      // Process brain context (existing logic)
+      if (contextRes?.ok) {
+        const data = await contextRes.json() as { success: boolean; context: string }
+        brainContext = data.context || ''
+      }
+
+      // Process code map (Phase 28)
+      if (codeMapRes?.ok) {
+        try {
+          const data = await codeMapRes.json() as { success: boolean; data?: { map?: string } }
+          if (data.success && data.data?.map) {
+            codeMapText = data.data.map
+          }
+        } catch {
+          // Silently ignore malformed code map response
+        }
+      }
+    }
+  } catch {
+    // Server unreachable or timeout — continue with static content only for SessionStart
+    if (event !== 'SessionStart') {
+      process.exit(0)
+      return
+    }
+  }
+
+  // Build final injection content
+  const parts: string[] = []
+
+  // SessionStart: prepend static Claude Code Mastery guidelines
+  if (event === 'SessionStart') {
+    const mastery = loadMasteryDoc()
+    if (mastery) {
+      parts.push(`[Claude Code Mastery]\n${mastery}`)
+    }
+  }
+
+  // Append dynamic brain memories (both events)
+  if (brainContext.trim()) {
+    parts.push(`[Brain Memory]\n${brainContext}`)
+  }
+
+  // Phase 29: Append file-linked memories (UserPromptSubmit only)
+  if (fileMemoryText.trim()) {
+    parts.push(`[File Memories]\n${fileMemoryText}`)
+  }
+
+  // Append code map (SessionStart only, Phase 28)
+  if (codeMapText.trim()) {
+    parts.push(`[Code Map]\nProject file index (use Read directly, skip Glob):\n${codeMapText}`)
+  }
+
+  // Output combined context
+  if (parts.length > 0) {
+    const output = {
+      hookSpecificOutput: {
+        hookEventName: event,
+        additionalContext: parts.join('\n\n'),
+      },
+    }
+    process.stdout.write(JSON.stringify(output))
+  }
+
+  process.exit(0)
+}
+
+/** Phase 29: Extract file paths from user prompt text */
+function extractFilePathsFromPrompt(prompt: string): string[] {
+  const pathPattern = /(?:^|\s)((?:src|lib|app|pages|components|utils|hooks|server|api|config|middleware|routes|models|services|types|scripts|tests|test)\/[\w\-./]+\.\w+)/g
+  const matches = [...prompt.matchAll(pathPattern)]
+  return [...new Set(matches.map(m => m[1]))]
+}
+
+/** 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((error) => {
+    process.stderr.write(`[context-hook] Fatal error: ${error?.message || error}\n`)
+    process.exit(1)
+  })
+}
+
+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' }
+    }
+  }
+}