claude-brain 0.14.2 → 0.14.4

package/src/server/handlers/tools/find-cross-project-patterns.ts

@@ -1,168 +1,168 @@
-/**
- * Find Cross-Project Patterns Handler
- * Finds patterns that appear across multiple projects
- */
-
-import type { Logger } from 'pino'
-import type { ToolResponse } from '@/tools/types'
-import { getMemoryService } from '@/server/services'
-import { ToolValidator } from '@/server/utils/validators'
-import { ResponseFormatter } from '@/server/utils/response-formatter'
-import { withMemoryIndicator, formatMemoryStats } from '@/server/utils/memory-indicator'
-import { ErrorHandler } from '@/server/utils/error-handler'
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js'
-import { FindCrossProjectPatternsSchema } from './schemas'
-import { PatternGeneralizer } from '@/intelligence/cross-project/generalizer'
-
-export async function handleFindCrossProjectPatterns(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, FindCrossProjectPatternsSchema)
-    const { min_projects, limit, query } = input
-
-    const memory = getMemoryService()
-
-    if (!memory.isChromaDBEnabled()) {
-      // SQLite fallback: fetch all decisions, group by project, find shared terms
-      const decisions = await memory.fetchAllDecisions()
-
-      if (decisions.length === 0) {
-        return ResponseFormatter.text('No cross-project patterns found (no decisions in database).')
-      }
-
-      // Group by project
-      const byProject: Record<string, any[]> = {}
-      for (const d of decisions) {
-        const proj = d.project || 'unknown'
-        if (!byProject[proj]) byProject[proj] = []
-        byProject[proj].push(d)
-      }
-
-      const projectNames = Object.keys(byProject)
-      const minProj = min_projects || 2
-
-      if (projectNames.length < minProj) {
-        return ResponseFormatter.text(
-          `Only ${projectNames.length} project(s) found (${projectNames.join(', ')}). Need at least ${minProj} for cross-project analysis.`
-        )
-      }
-
-      // Extract significant terms per project
-      const stopWords = new Set(['the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could', 'should', 'to', 'of', 'in', 'for', 'on', 'with', 'at', 'by', 'from', 'as', 'and', 'but', 'or', 'not', 'so', 'if', 'when', 'where', 'how', 'what', 'which', 'who', 'this', 'that', 'use', 'using', 'used', 'decision', 'context', 'reasoning'])
-      const termProjects: Record<string, { projects: Set<string>; examples: Array<{ project: string; content: string }> }> = {}
-
-      for (const [proj, decs] of Object.entries(byProject)) {
-        const projectTerms = new Set<string>()
-        for (const d of decs) {
-          const text = `${d.decision || ''} ${d.context || ''}`.toLowerCase()
-          const words = text.match(/\b[a-z][a-z-]{2,}\b/g) || []
-          for (const word of words) {
-            if (stopWords.has(word)) continue
-            if (!projectTerms.has(word)) {
-              projectTerms.add(word)
-              if (!termProjects[word]) termProjects[word] = { projects: new Set(), examples: [] }
-              termProjects[word].projects.add(proj)
-              if (termProjects[word].examples.length < 3) {
-                termProjects[word].examples.push({ project: proj, content: d.decision?.slice(0, 100) || d.content?.slice(0, 100) || '' })
-              }
-            }
-          }
-        }
-      }
-
-      // Filter terms that appear in >= minProj projects
-      const crossPatterns = Object.entries(termProjects)
-        .filter(([, v]) => v.projects.size >= minProj)
-        .map(([term, v]) => ({
-          description: term,
-          projects: Array.from(v.projects),
-          occurrences: v.projects.size,
-          confidence: v.projects.size / projectNames.length,
-          examples: v.examples
-        }))
-        .sort((a, b) => b.occurrences - a.occurrences)
-        .slice(0, limit || 20)
-
-      if (crossPatterns.length === 0) {
-        return ResponseFormatter.text(
-          `No cross-project patterns found (analyzed ${decisions.length} decisions across ${projectNames.length} projects).`
-        )
-      }
-
-      const parts: string[] = []
-      parts.push(`## Cross-Project Patterns (SQLite)`)
-      parts.push(`**Projects analyzed:** ${projectNames.join(', ')}`)
-      parts.push(`**Decisions analyzed:** ${decisions.length}`)
-      parts.push(`**Shared terms found:** ${crossPatterns.length}`)
-      parts.push('')
-
-      for (const pattern of crossPatterns) {
-        const confidence = Math.round(pattern.confidence * 100)
-        parts.push(`### ${pattern.description} (${confidence}% confidence)`)
-        parts.push(`**Projects:** ${pattern.projects.join(', ')}`)
-        parts.push(`**Occurrences:** ${pattern.occurrences} projects`)
-        if (pattern.examples.length > 0) {
-          parts.push('**Examples:**')
-          for (const ex of pattern.examples.slice(0, 3)) {
-            parts.push(`- [${ex.project}] ${ex.content}`)
-          }
-        }
-        parts.push('')
-      }
-
-      parts.push('*Note: SQLite mode uses term-frequency analysis. Enable ChromaDB for semantic pattern generalization.*')
-
-      const statsLine = formatMemoryStats({ patterns: crossPatterns.length })
-      return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), crossPatterns.length) + '\n\n' + statsLine)
-    }
-
-    const generalizer = new PatternGeneralizer(
-      logger,
-      memory.chroma.collections,
-      memory.chroma.embeddings
-    )
-
-    const result = await generalizer.findCrossProjectPatterns({
-      minProjects: min_projects,
-      limit,
-      query
-    })
-
-    if (result.patterns.length === 0) {
-      return ResponseFormatter.text(
-        `No cross-project patterns found (analyzed ${result.totalDecisionsAnalyzed} decisions across ${result.projectsAnalyzed.length} projects).`
-      )
-    }
-
-    const parts: string[] = []
-    parts.push(`## Cross-Project Patterns`)
-    parts.push(`**Projects analyzed:** ${result.projectsAnalyzed.join(', ')}`)
-    parts.push(`**Decisions analyzed:** ${result.totalDecisionsAnalyzed}`)
-    parts.push(`**Patterns found:** ${result.patterns.length}`)
-    parts.push('')
-
-    for (const pattern of result.patterns) {
-      const confidence = Math.round(pattern.confidence * 100)
-      parts.push(`### ${pattern.description} (${confidence}% confidence)`)
-      parts.push(`**Projects:** ${pattern.projects.join(', ')}`)
-      parts.push(`**Occurrences:** ${pattern.occurrences}`)
-      if (pattern.examples.length > 0) {
-        parts.push('**Examples:**')
-        for (const ex of pattern.examples.slice(0, 3)) {
-          parts.push(`- [${ex.project}] ${ex.content}`)
-        }
-      }
-      parts.push('')
-    }
-
-    const statsLine = formatMemoryStats({ patterns: result.patterns.length })
-    return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), result.patterns.length) + '\n\n' + statsLine)
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'find_cross_project_patterns' })
-    if (error instanceof McpError) throw error
-    throw new McpError(ErrorCode.InternalError, `Cross-project patterns failed: ${error instanceof Error ? error.message : 'Unknown error'}`)
-  }
-}
+/**
+ * Find Cross-Project Patterns Handler
+ * Finds patterns that appear across multiple projects
+ */
+
+import type { Logger } from 'pino'
+import type { ToolResponse } from '@/tools/types'
+import { getMemoryService } from '@/server/services'
+import { ToolValidator } from '@/server/utils/validators'
+import { ResponseFormatter } from '@/server/utils/response-formatter'
+import { withMemoryIndicator, formatMemoryStats } from '@/server/utils/memory-indicator'
+import { ErrorHandler } from '@/server/utils/error-handler'
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js'
+import { FindCrossProjectPatternsSchema } from './schemas'
+import { PatternGeneralizer } from '@/intelligence/cross-project/generalizer'
+
+export async function handleFindCrossProjectPatterns(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, FindCrossProjectPatternsSchema)
+    const { min_projects, limit, query } = input
+
+    const memory = getMemoryService()
+
+    if (!memory.isChromaDBEnabled()) {
+      // SQLite fallback: fetch all decisions, group by project, find shared terms
+      const decisions = await memory.fetchAllDecisions()
+
+      if (decisions.length === 0) {
+        return ResponseFormatter.text('No cross-project patterns found (no decisions in database).')
+      }
+
+      // Group by project
+      const byProject: Record<string, any[]> = {}
+      for (const d of decisions) {
+        const proj = d.project || 'unknown'
+        if (!byProject[proj]) byProject[proj] = []
+        byProject[proj].push(d)
+      }
+
+      const projectNames = Object.keys(byProject)
+      const minProj = min_projects || 2
+
+      if (projectNames.length < minProj) {
+        return ResponseFormatter.text(
+          `Only ${projectNames.length} project(s) found (${projectNames.join(', ')}). Need at least ${minProj} for cross-project analysis.`
+        )
+      }
+
+      // Extract significant terms per project
+      const stopWords = new Set(['the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could', 'should', 'to', 'of', 'in', 'for', 'on', 'with', 'at', 'by', 'from', 'as', 'and', 'but', 'or', 'not', 'so', 'if', 'when', 'where', 'how', 'what', 'which', 'who', 'this', 'that', 'use', 'using', 'used', 'decision', 'context', 'reasoning'])
+      const termProjects: Record<string, { projects: Set<string>; examples: Array<{ project: string; content: string }> }> = {}
+
+      for (const [proj, decs] of Object.entries(byProject)) {
+        const projectTerms = new Set<string>()
+        for (const d of decs) {
+          const text = `${d.decision || ''} ${d.context || ''}`.toLowerCase()
+          const words = text.match(/\b[a-z][a-z-]{2,}\b/g) || []
+          for (const word of words) {
+            if (stopWords.has(word)) continue
+            if (!projectTerms.has(word)) {
+              projectTerms.add(word)
+              if (!termProjects[word]) termProjects[word] = { projects: new Set(), examples: [] }
+              termProjects[word].projects.add(proj)
+              if (termProjects[word].examples.length < 3) {
+                termProjects[word].examples.push({ project: proj, content: d.decision?.slice(0, 100) || d.content?.slice(0, 100) || '' })
+              }
+            }
+          }
+        }
+      }
+
+      // Filter terms that appear in >= minProj projects
+      const crossPatterns = Object.entries(termProjects)
+        .filter(([, v]) => v.projects.size >= minProj)
+        .map(([term, v]) => ({
+          description: term,
+          projects: Array.from(v.projects),
+          occurrences: v.projects.size,
+          confidence: v.projects.size / projectNames.length,
+          examples: v.examples
+        }))
+        .sort((a, b) => b.occurrences - a.occurrences)
+        .slice(0, limit || 20)
+
+      if (crossPatterns.length === 0) {
+        return ResponseFormatter.text(
+          `No cross-project patterns found (analyzed ${decisions.length} decisions across ${projectNames.length} projects).`
+        )
+      }
+
+      const parts: string[] = []
+      parts.push(`## Cross-Project Patterns (SQLite)`)
+      parts.push(`**Projects analyzed:** ${projectNames.join(', ')}`)
+      parts.push(`**Decisions analyzed:** ${decisions.length}`)
+      parts.push(`**Shared terms found:** ${crossPatterns.length}`)
+      parts.push('')
+
+      for (const pattern of crossPatterns) {
+        const confidence = Math.round(pattern.confidence * 100)
+        parts.push(`### ${pattern.description} (${confidence}% confidence)`)
+        parts.push(`**Projects:** ${pattern.projects.join(', ')}`)
+        parts.push(`**Occurrences:** ${pattern.occurrences} projects`)
+        if (pattern.examples.length > 0) {
+          parts.push('**Examples:**')
+          for (const ex of pattern.examples.slice(0, 3)) {
+            parts.push(`- [${ex.project}] ${ex.content}`)
+          }
+        }
+        parts.push('')
+      }
+
+      parts.push('*Note: SQLite mode uses term-frequency analysis. Enable ChromaDB for semantic pattern generalization.*')
+
+      const statsLine = formatMemoryStats({ patterns: crossPatterns.length })
+      return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), crossPatterns.length) + '\n\n' + statsLine)
+    }
+
+    const generalizer = new PatternGeneralizer(
+      logger,
+      memory.chroma.collections,
+      memory.chroma.embeddings
+    )
+
+    const result = await generalizer.findCrossProjectPatterns({
+      minProjects: min_projects,
+      limit,
+      query
+    })
+
+    if (result.patterns.length === 0) {
+      return ResponseFormatter.text(
+        `No cross-project patterns found (analyzed ${result.totalDecisionsAnalyzed} decisions across ${result.projectsAnalyzed.length} projects).`
+      )
+    }
+
+    const parts: string[] = []
+    parts.push(`## Cross-Project Patterns`)
+    parts.push(`**Projects analyzed:** ${result.projectsAnalyzed.join(', ')}`)
+    parts.push(`**Decisions analyzed:** ${result.totalDecisionsAnalyzed}`)
+    parts.push(`**Patterns found:** ${result.patterns.length}`)
+    parts.push('')
+
+    for (const pattern of result.patterns) {
+      const confidence = Math.round(pattern.confidence * 100)
+      parts.push(`### ${pattern.description} (${confidence}% confidence)`)
+      parts.push(`**Projects:** ${pattern.projects.join(', ')}`)
+      parts.push(`**Occurrences:** ${pattern.occurrences}`)
+      if (pattern.examples.length > 0) {
+        parts.push('**Examples:**')
+        for (const ex of pattern.examples.slice(0, 3)) {
+          parts.push(`- [${ex.project}] ${ex.content}`)
+        }
+      }
+      parts.push('')
+    }
+
+    const statsLine = formatMemoryStats({ patterns: result.patterns.length })
+    return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), result.patterns.length) + '\n\n' + statsLine)
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'find_cross_project_patterns' })
+    if (error instanceof McpError) throw error
+    throw new McpError(ErrorCode.InternalError, `Cross-project patterns failed: ${error instanceof Error ? error.message : 'Unknown error'}`)
+  }
+}