claude-brain 0.30.2 → 0.30.3

package/src/code-intelligence/linker.ts

@@ -1,178 +1,178 @@
-/**
- * MemoryCodeLinker — Phase 29: Code-Anchored Memory
- *
- * Links stored observations to code files automatically using three strategies:
- * 1. Explicit file paths mentioned in content
- * 2. Recently edited files (from activity_log)
- * 3. Symbol name matching (from code_symbols table)
- *
- * All linkage is fire-and-forget — failures are non-fatal.
- */
-
-import type { Database } from 'bun:sqlite'
-import type { Logger } from 'pino'
-
-/** Regex to extract file paths from memory content */
-const FILE_PATH_REGEX = /(?:^|\s)((?:src|lib|app|pages|components|utils|hooks|server|api|config|middleware|routes|models|services|types|scripts|tests|test)\/[\w\-./]+\.\w+)/g
-
-/** Regex to extract camelCase/PascalCase/snake_case identifiers >4 chars */
-const SYMBOL_REGEX = /\b([a-z][a-zA-Z0-9]{3,}|[A-Z][a-zA-Z0-9]{3,}|[a-z]+(?:_[a-z]+){1,})\b/g
-
-/** Max symbol candidates to query against code_symbols */
-const MAX_SYMBOL_CANDIDATES = 20
-
-export class MemoryCodeLinker {
-  constructor(
-    private memoryDb: Database,
-    private codeDb: Database | null,
-    private logger: Logger
-  ) {
-    this.logger = logger.child({ component: 'code-linker' })
-  }
-
-  /**
-   * Link an observation to relevant code files.
-   * Called after storing an observation — non-blocking, fire-and-forget.
-   * Returns the file paths that were linked.
-   */
-  async linkObservation(observationId: string, content: string, project: string): Promise<string[]> {
-    const filePaths = new Set<string>()
-    const symbols = new Set<string>()
-
-    // Strategy 1: Explicit file paths in content
-    try {
-      const explicitPaths = this.extractFilePaths(content)
-      for (const p of explicitPaths) filePaths.add(p)
-    } catch (err) {
-      this.logger.debug({ err }, 'Strategy 1 (explicit paths) failed')
-    }
-
-    // Strategy 2: Recently edited files
-    try {
-      const recentFiles = this.getRecentlyEditedFiles(project)
-      for (const p of recentFiles) filePaths.add(p)
-    } catch (err) {
-      this.logger.debug({ err }, 'Strategy 2 (recent files) failed')
-    }
-
-    // Strategy 3: Symbol name matching (only when codeDb available)
-    if (this.codeDb) {
-      try {
-        const symbolMatches = this.matchSymbols(content, project)
-        for (const match of symbolMatches) {
-          filePaths.add(match.filePath)
-          symbols.add(match.symbol)
-        }
-      } catch (err) {
-        this.logger.debug({ err }, 'Strategy 3 (symbol matching) failed')
-      }
-    }
-
-    if (filePaths.size === 0 && symbols.size === 0) {
-      return []
-    }
-
-    // Update the observation with linked paths and symbols
-    const pathsArray = [...filePaths]
-    const symbolsArray = [...symbols]
-
-    try {
-      this.memoryDb.prepare(
-        `UPDATE observations SET file_paths = ?, symbols = ?, updated_at = ? WHERE id = ?`
-      ).run(
-        JSON.stringify(pathsArray),
-        JSON.stringify(symbolsArray),
-        new Date().toISOString(),
-        observationId
-      )
-
-      this.logger.debug(
-        { observationId, paths: pathsArray.length, symbols: symbolsArray.length },
-        'Observation linked to code'
-      )
-    } catch (err) {
-      this.logger.debug({ err, observationId }, 'Failed to update observation with code links')
-    }
-
-    return pathsArray
-  }
-
-  /**
-   * Strategy 1: Extract explicit file paths from content.
-   */
-  private extractFilePaths(content: string): string[] {
-    const paths: string[] = []
-    let match: RegExpExecArray | null
-
-    // Reset regex state
-    FILE_PATH_REGEX.lastIndex = 0
-    while ((match = FILE_PATH_REGEX.exec(content)) !== null) {
-      paths.push(match[1])
-    }
-
-    return [...new Set(paths)]
-  }
-
-  /**
-   * Strategy 2: Get recently edited files from activity_log.
-   * Gracefully degrades if the table doesn't exist or has a different schema.
-   */
-  private getRecentlyEditedFiles(project: string): string[] {
-    try {
-      const rows = this.memoryDb.prepare(`
-        SELECT DISTINCT json_extract(metadata, '$.file_path') as file_path
-        FROM activity_log
-        WHERE project = ?
-          AND tool_name IN ('Write', 'Edit')
-          AND json_extract(metadata, '$.file_path') IS NOT NULL
-        ORDER BY created_at DESC
-        LIMIT 5
-      `).all(project) as { file_path: string }[]
-
-      return rows.map(r => r.file_path).filter(Boolean)
-    } catch {
-      // activity_log table may not exist — graceful degradation
-      return []
-    }
-  }
-
-  /**
-   * Strategy 3: Match potential symbol names from content against code_symbols.
-   */
-  private matchSymbols(content: string, project: string): { symbol: string; filePath: string }[] {
-    if (!this.codeDb) return []
-
-    // Extract candidate symbols from content
-    const candidates = new Set<string>()
-    let match: RegExpExecArray | null
-
-    SYMBOL_REGEX.lastIndex = 0
-    while ((match = SYMBOL_REGEX.exec(content)) !== null) {
-      if (candidates.size >= MAX_SYMBOL_CANDIDATES) break
-      candidates.add(match[1])
-    }
-
-    if (candidates.size === 0) return []
-
-    // Query code_symbols for matches
-    const results: { symbol: string; filePath: string }[] = []
-    const placeholders = [...candidates].map(() => '?').join(', ')
-
-    try {
-      const rows = this.codeDb.prepare(`
-        SELECT DISTINCT symbol_name, file_path
-        FROM code_symbols
-        WHERE project = ? AND symbol_name IN (${placeholders})
-        LIMIT 20
-      `).all(project, ...candidates) as { symbol_name: string; file_path: string }[]
-
-      for (const row of rows) {
-        results.push({ symbol: row.symbol_name, filePath: row.file_path })
-      }
-    } catch (err) {
-      this.logger.debug({ err }, 'Symbol matching query failed')
-    }
-
-    return results
-  }
-}
+/**
+ * MemoryCodeLinker — Phase 29: Code-Anchored Memory
+ *
+ * Links stored observations to code files automatically using three strategies:
+ * 1. Explicit file paths mentioned in content
+ * 2. Recently edited files (from activity_log)
+ * 3. Symbol name matching (from code_symbols table)
+ *
+ * All linkage is fire-and-forget — failures are non-fatal.
+ */
+
+import type { Database } from 'bun:sqlite'
+import type { Logger } from 'pino'
+
+/** Regex to extract file paths from memory content */
+const FILE_PATH_REGEX = /(?:^|\s)((?:src|lib|app|pages|components|utils|hooks|server|api|config|middleware|routes|models|services|types|scripts|tests|test)\/[\w\-./]+\.\w+)/g
+
+/** Regex to extract camelCase/PascalCase/snake_case identifiers >4 chars */
+const SYMBOL_REGEX = /\b([a-z][a-zA-Z0-9]{3,}|[A-Z][a-zA-Z0-9]{3,}|[a-z]+(?:_[a-z]+){1,})\b/g
+
+/** Max symbol candidates to query against code_symbols */
+const MAX_SYMBOL_CANDIDATES = 20
+
+export class MemoryCodeLinker {
+  constructor(
+    private memoryDb: Database,
+    private codeDb: Database | null,
+    private logger: Logger
+  ) {
+    this.logger = logger.child({ component: 'code-linker' })
+  }
+
+  /**
+   * Link an observation to relevant code files.
+   * Called after storing an observation — non-blocking, fire-and-forget.
+   * Returns the file paths that were linked.
+   */
+  async linkObservation(observationId: string, content: string, project: string): Promise<string[]> {
+    const filePaths = new Set<string>()
+    const symbols = new Set<string>()
+
+    // Strategy 1: Explicit file paths in content
+    try {
+      const explicitPaths = this.extractFilePaths(content)
+      for (const p of explicitPaths) filePaths.add(p)
+    } catch (err) {
+      this.logger.debug({ err }, 'Strategy 1 (explicit paths) failed')
+    }
+
+    // Strategy 2: Recently edited files
+    try {
+      const recentFiles = this.getRecentlyEditedFiles(project)
+      for (const p of recentFiles) filePaths.add(p)
+    } catch (err) {
+      this.logger.debug({ err }, 'Strategy 2 (recent files) failed')
+    }
+
+    // Strategy 3: Symbol name matching (only when codeDb available)
+    if (this.codeDb) {
+      try {
+        const symbolMatches = this.matchSymbols(content, project)
+        for (const match of symbolMatches) {
+          filePaths.add(match.filePath)
+          symbols.add(match.symbol)
+        }
+      } catch (err) {
+        this.logger.debug({ err }, 'Strategy 3 (symbol matching) failed')
+      }
+    }
+
+    if (filePaths.size === 0 && symbols.size === 0) {
+      return []
+    }
+
+    // Update the observation with linked paths and symbols
+    const pathsArray = [...filePaths]
+    const symbolsArray = [...symbols]
+
+    try {
+      this.memoryDb.prepare(
+        `UPDATE observations SET file_paths = ?, symbols = ?, updated_at = ? WHERE id = ?`
+      ).run(
+        JSON.stringify(pathsArray),
+        JSON.stringify(symbolsArray),
+        new Date().toISOString(),
+        observationId
+      )
+
+      this.logger.debug(
+        { observationId, paths: pathsArray.length, symbols: symbolsArray.length },
+        'Observation linked to code'
+      )
+    } catch (err) {
+      this.logger.debug({ err, observationId }, 'Failed to update observation with code links')
+    }
+
+    return pathsArray
+  }
+
+  /**
+   * Strategy 1: Extract explicit file paths from content.
+   */
+  private extractFilePaths(content: string): string[] {
+    const paths: string[] = []
+    let match: RegExpExecArray | null
+
+    // Reset regex state
+    FILE_PATH_REGEX.lastIndex = 0
+    while ((match = FILE_PATH_REGEX.exec(content)) !== null) {
+      paths.push(match[1])
+    }
+
+    return [...new Set(paths)]
+  }
+
+  /**
+   * Strategy 2: Get recently edited files from activity_log.
+   * Gracefully degrades if the table doesn't exist or has a different schema.
+   */
+  private getRecentlyEditedFiles(project: string): string[] {
+    try {
+      const rows = this.memoryDb.prepare(`
+        SELECT DISTINCT json_extract(metadata, '$.file_path') as file_path
+        FROM activity_log
+        WHERE project = ?
+          AND tool_name IN ('Write', 'Edit')
+          AND json_extract(metadata, '$.file_path') IS NOT NULL
+        ORDER BY created_at DESC
+        LIMIT 5
+      `).all(project) as { file_path: string }[]
+
+      return rows.map(r => r.file_path).filter(Boolean)
+    } catch {
+      // activity_log table may not exist — graceful degradation
+      return []
+    }
+  }
+
+  /**
+   * Strategy 3: Match potential symbol names from content against code_symbols.
+   */
+  private matchSymbols(content: string, project: string): { symbol: string; filePath: string }[] {
+    if (!this.codeDb) return []
+
+    // Extract candidate symbols from content
+    const candidates = new Set<string>()
+    let match: RegExpExecArray | null
+
+    SYMBOL_REGEX.lastIndex = 0
+    while ((match = SYMBOL_REGEX.exec(content)) !== null) {
+      if (candidates.size >= MAX_SYMBOL_CANDIDATES) break
+      candidates.add(match[1])
+    }
+
+    if (candidates.size === 0) return []
+
+    // Query code_symbols for matches
+    const results: { symbol: string; filePath: string }[] = []
+    const placeholders = [...candidates].map(() => '?').join(', ')
+
+    try {
+      const rows = this.codeDb.prepare(`
+        SELECT DISTINCT symbol_name, file_path
+        FROM code_symbols
+        WHERE project = ? AND symbol_name IN (${placeholders})
+        LIMIT 20
+      `).all(project, ...candidates) as { symbol_name: string; file_path: string }[]
+
+      for (const row of rows) {
+        results.push({ symbol: row.symbol_name, filePath: row.file_path })
+      }
+    } catch (err) {
+      this.logger.debug({ err }, 'Symbol matching query failed')
+    }
+
+    return results
+  }
+}