claude-brain 0.15.2 → 0.17.0

package/src/server/handlers/tools/get-project-context.ts

@@ -1,75 +1,75 @@
-/**
- * Get Project Context Handler
- * Retrieves complete project context including standards, progress, and memories
- */
-
-import type { Logger } from 'pino'
-import type { ToolResponse } from '@/tools/types'
-import { getContextService } from '@/server/services'
-import { ToolValidator } from '@/server/utils/validators'
-import { ResponseFormatter } from '@/server/utils/response-formatter'
-import { ErrorHandler } from '@/server/utils/error-handler'
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js'
-import { GetProjectContextSchema } from './schemas'
-
-export async function handleGetProjectContext(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, GetProjectContextSchema)
-    const { project_name, include_memories, memory_limit } = input
-
-    logger.debug({
-      project_name,
-      include_memories,
-      memory_limit
-    }, 'Getting project context')
-
-    const contextService = getContextService()
-
-    const context = await contextService.getContext(project_name, {
-      includeMemories: include_memories,
-      includeProgress: true,
-      includeStandards: true,
-      maxTokens: 8000,
-      relevanceThreshold: 0.6
-    })
-
-    if (context.memories.length > memory_limit) {
-      context.memories = context.memories.slice(0, memory_limit)
-    }
-
-    const formatted = contextService.formatter.format(context)
-
-    logger.info(
-      {
-        projectName: project_name,
-        tokenCount: context.metadata.tokenCount,
-        memories: context.memories.length
-      },
-      'Context retrieved successfully'
-    )
-
-    return ResponseFormatter.text(formatted)
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'get_project_context', args })
-
-    if (error instanceof McpError) {
-      throw error
-    }
-
-    if (error instanceof Error && (error.message.includes('ENOENT') || error.message.includes('not found'))) {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        `Project "${(args as any).project_name}" not found. Available projects can be listed using list_projects tool.`
-      )
-    }
-
-    throw new McpError(
-      ErrorCode.InternalError,
-      `Failed to get project context: ${error instanceof Error ? error.message : 'Unknown error'}`
-    )
-  }
-}
+/**
+ * Get Project Context Handler
+ * Retrieves complete project context including standards, progress, and memories
+ */
+
+import type { Logger } from 'pino'
+import type { ToolResponse } from '@/tools/types'
+import { getContextService } from '@/server/services'
+import { ToolValidator } from '@/server/utils/validators'
+import { ResponseFormatter } from '@/server/utils/response-formatter'
+import { ErrorHandler } from '@/server/utils/error-handler'
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js'
+import { GetProjectContextSchema } from './schemas'
+
+export async function handleGetProjectContext(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, GetProjectContextSchema)
+    const { project_name, include_memories, memory_limit } = input
+
+    logger.debug({
+      project_name,
+      include_memories,
+      memory_limit
+    }, 'Getting project context')
+
+    const contextService = getContextService()
+
+    const context = await contextService.getContext(project_name, {
+      includeMemories: include_memories,
+      includeProgress: true,
+      includeStandards: true,
+      maxTokens: 8000,
+      relevanceThreshold: 0.6
+    })
+
+    if (context.memories.length > memory_limit) {
+      context.memories = context.memories.slice(0, memory_limit)
+    }
+
+    const formatted = contextService.formatter.format(context)
+
+    logger.info(
+      {
+        projectName: project_name,
+        tokenCount: context.metadata.tokenCount,
+        memories: context.memories.length
+      },
+      'Context retrieved successfully'
+    )
+
+    return ResponseFormatter.text(formatted)
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'get_project_context', args })
+
+    if (error instanceof McpError) {
+      throw error
+    }
+
+    if (error instanceof Error && (error.message.includes('ENOENT') || error.message.includes('not found'))) {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        `Project "${(args as any).project_name}" not found. Available projects can be listed using list_projects tool.`
+      )
+    }
+
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Failed to get project context: ${error instanceof Error ? error.message : 'Unknown error'}`
+    )
+  }
+}

package/src/server/handlers/tools/get-recommendations.ts

@@ -1,145 +1,145 @@
-/**
- * Get Recommendations Handler
- * Provides recommendations based on project history, patterns, and corrections
- */
-
-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 { GetRecommendationsSchema } from './schemas'
-import { Recommender } from '@/intelligence/prediction/recommender'
-
-export async function handleGetRecommendations(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, GetRecommendationsSchema)
-    const { query, project_name, limit } = input
-
-    const memory = getMemoryService()
-
-    if (!memory.isChromaDBEnabled()) {
-      // SQLite fallback: combine searchRaw + searchPatterns + searchCorrections
-      const [rawResults, patternResults, correctionResults] = await Promise.all([
-        memory.searchRaw(query, { project: project_name, limit: limit || 5, minSimilarity: 0.2 }),
-        memory.searchPatterns(query, { project: project_name, limit: limit || 5, minSimilarity: 0.2 }),
-        memory.searchCorrections(query, { project: project_name, limit: limit || 5, minSimilarity: 0.2 })
-      ])
-
-      // Combine and format as recommendations
-      const recommendations: Array<{ type: string; source: string; content: string; reasoning: string; confidence: number }> = []
-
-      // Corrections get highest priority (lessons learned)
-      for (const c of correctionResults) {
-        recommendations.push({
-          type: 'correction',
-          source: 'Past Correction',
-          content: `Original: ${c.metadata?.original || ''}\nCorrection: ${c.metadata?.correction || c.content || ''}`,
-          reasoning: c.metadata?.reasoning || 'Based on previous lesson learned',
-          confidence: c.similarity || c.metadata?.confidence || 0.5
-        })
-      }
-
-      // Patterns
-      for (const p of patternResults) {
-        recommendations.push({
-          type: p.metadata?.pattern_type || 'pattern',
-          source: `Pattern (${p.metadata?.pattern_type || 'general'})`,
-          content: p.metadata?.description || p.content || '',
-          reasoning: p.metadata?.context || 'Based on recognized pattern',
-          confidence: p.similarity || p.metadata?.confidence || 0.5
-        })
-      }
-
-      // Decisions
-      for (const r of rawResults) {
-        recommendations.push({
-          type: 'decision',
-          source: 'Past Decision',
-          content: r.decision?.decision || r.memory?.content?.slice(0, 300) || '',
-          reasoning: r.decision?.reasoning || 'Based on similar past decision',
-          confidence: r.similarity || 0.5
-        })
-      }
-
-      // Sort by confidence, deduplicate, and limit
-      const seen = new Set<string>()
-      const deduped = recommendations.filter(r => {
-        const key = r.content.slice(0, 50)
-        if (seen.has(key)) return false
-        seen.add(key)
-        return true
-      })
-      .sort((a, b) => b.confidence - a.confidence)
-      .slice(0, limit || 5)
-
-      if (deduped.length === 0) {
-        return ResponseFormatter.text(`No recommendations found for: "${query}"`)
-      }
-
-      const parts: string[] = []
-      parts.push(`## Recommendations (SQLite)`)
-      parts.push(`**Query:** ${query}`)
-      if (project_name) parts.push(`**Project:** ${project_name}`)
-      parts.push(`**Found:** ${deduped.length}`)
-      parts.push('')
-
-      for (const rec of deduped) {
-        const confidence = Math.round(rec.confidence * 100)
-        const icon = rec.type === 'correction' ? '⚠️' : rec.type === 'best-practice' ? '✅' : rec.type === 'pattern' ? '🔄' : '📋'
-        parts.push(`### ${icon} ${rec.source} (${confidence}% confidence)`)
-        parts.push(rec.content.slice(0, 300))
-        parts.push(`*${rec.reasoning}*`)
-        parts.push('')
-      }
-
-      const statsLine = formatMemoryStats({ recalled: deduped.length })
-      return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), deduped.length) + '\n\n' + statsLine)
-    }
-
-    const recommender = new Recommender(
-      logger,
-      memory.chroma.collections,
-      memory.chroma.embeddings
-    )
-
-    const result = await recommender.getRecommendations(query, {
-      project: project_name,
-      limit
-    })
-
-    if (result.recommendations.length === 0) {
-      return ResponseFormatter.text(`No recommendations found for: "${query}"`)
-    }
-
-    const parts: string[] = []
-    parts.push(`## Recommendations`)
-    parts.push(`**Query:** ${query}`)
-    if (project_name) parts.push(`**Project:** ${project_name}`)
-    parts.push(`**Found:** ${result.recommendations.length} (from ${result.totalConsidered} considered)`)
-    parts.push('')
-
-    for (const rec of result.recommendations) {
-      const confidence = Math.round(rec.confidence * 100)
-      const icon = rec.type === 'correction' ? '⚠️' : rec.type === 'best-practice' ? '✅' : rec.type === 'pattern' ? '🔄' : '📋'
-      parts.push(`### ${icon} ${rec.source} (${confidence}% confidence)`)
-      parts.push(rec.content.slice(0, 300))
-      parts.push(`*${rec.reasoning}*`)
-      parts.push('')
-    }
-
-    const statsLine = formatMemoryStats({ recalled: result.recommendations.length })
-    return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), result.recommendations.length) + '\n\n' + statsLine)
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'get_recommendations' })
-    if (error instanceof McpError) throw error
-    throw new McpError(ErrorCode.InternalError, `Recommendations failed: ${error instanceof Error ? error.message : 'Unknown error'}`)
-  }
-}
+/**
+ * Get Recommendations Handler
+ * Provides recommendations based on project history, patterns, and corrections
+ */
+
+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 { GetRecommendationsSchema } from './schemas'
+import { Recommender } from '@/intelligence/prediction/recommender'
+
+export async function handleGetRecommendations(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, GetRecommendationsSchema)
+    const { query, project_name, limit } = input
+
+    const memory = getMemoryService()
+
+    if (!memory.isChromaDBEnabled()) {
+      // SQLite fallback: combine searchRaw + searchPatterns + searchCorrections
+      const [rawResults, patternResults, correctionResults] = await Promise.all([
+        memory.searchRaw(query, { project: project_name, limit: limit || 5, minSimilarity: 0.2 }),
+        memory.searchPatterns(query, { project: project_name, limit: limit || 5, minSimilarity: 0.2 }),
+        memory.searchCorrections(query, { project: project_name, limit: limit || 5, minSimilarity: 0.2 })
+      ])
+
+      // Combine and format as recommendations
+      const recommendations: Array<{ type: string; source: string; content: string; reasoning: string; confidence: number }> = []
+
+      // Corrections get highest priority (lessons learned)
+      for (const c of correctionResults) {
+        recommendations.push({
+          type: 'correction',
+          source: 'Past Correction',
+          content: `Original: ${c.metadata?.original || ''}\nCorrection: ${c.metadata?.correction || c.content || ''}`,
+          reasoning: c.metadata?.reasoning || 'Based on previous lesson learned',
+          confidence: c.similarity || c.metadata?.confidence || 0.5
+        })
+      }
+
+      // Patterns
+      for (const p of patternResults) {
+        recommendations.push({
+          type: p.metadata?.pattern_type || 'pattern',
+          source: `Pattern (${p.metadata?.pattern_type || 'general'})`,
+          content: p.metadata?.description || p.content || '',
+          reasoning: p.metadata?.context || 'Based on recognized pattern',
+          confidence: p.similarity || p.metadata?.confidence || 0.5
+        })
+      }
+
+      // Decisions
+      for (const r of rawResults) {
+        recommendations.push({
+          type: 'decision',
+          source: 'Past Decision',
+          content: r.decision?.decision || r.memory?.content?.slice(0, 300) || '',
+          reasoning: r.decision?.reasoning || 'Based on similar past decision',
+          confidence: r.similarity || 0.5
+        })
+      }
+
+      // Sort by confidence, deduplicate, and limit
+      const seen = new Set<string>()
+      const deduped = recommendations.filter(r => {
+        const key = r.content.slice(0, 50)
+        if (seen.has(key)) return false
+        seen.add(key)
+        return true
+      })
+      .sort((a, b) => b.confidence - a.confidence)
+      .slice(0, limit || 5)
+
+      if (deduped.length === 0) {
+        return ResponseFormatter.text(`No recommendations found for: "${query}"`)
+      }
+
+      const parts: string[] = []
+      parts.push(`## Recommendations (SQLite)`)
+      parts.push(`**Query:** ${query}`)
+      if (project_name) parts.push(`**Project:** ${project_name}`)
+      parts.push(`**Found:** ${deduped.length}`)
+      parts.push('')
+
+      for (const rec of deduped) {
+        const confidence = Math.round(rec.confidence * 100)
+        const icon = rec.type === 'correction' ? '⚠️' : rec.type === 'best-practice' ? '✅' : rec.type === 'pattern' ? '🔄' : '📋'
+        parts.push(`### ${icon} ${rec.source} (${confidence}% confidence)`)
+        parts.push(rec.content.slice(0, 300))
+        parts.push(`*${rec.reasoning}*`)
+        parts.push('')
+      }
+
+      const statsLine = formatMemoryStats({ recalled: deduped.length })
+      return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), deduped.length) + '\n\n' + statsLine)
+    }
+
+    const recommender = new Recommender(
+      logger,
+      memory.chroma.collections,
+      memory.chroma.embeddings
+    )
+
+    const result = await recommender.getRecommendations(query, {
+      project: project_name,
+      limit
+    })
+
+    if (result.recommendations.length === 0) {
+      return ResponseFormatter.text(`No recommendations found for: "${query}"`)
+    }
+
+    const parts: string[] = []
+    parts.push(`## Recommendations`)
+    parts.push(`**Query:** ${query}`)
+    if (project_name) parts.push(`**Project:** ${project_name}`)
+    parts.push(`**Found:** ${result.recommendations.length} (from ${result.totalConsidered} considered)`)
+    parts.push('')
+
+    for (const rec of result.recommendations) {
+      const confidence = Math.round(rec.confidence * 100)
+      const icon = rec.type === 'correction' ? '⚠️' : rec.type === 'best-practice' ? '✅' : rec.type === 'pattern' ? '🔄' : '📋'
+      parts.push(`### ${icon} ${rec.source} (${confidence}% confidence)`)
+      parts.push(rec.content.slice(0, 300))
+      parts.push(`*${rec.reasoning}*`)
+      parts.push('')
+    }
+
+    const statsLine = formatMemoryStats({ recalled: result.recommendations.length })
+    return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), result.recommendations.length) + '\n\n' + statsLine)
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'get_recommendations' })
+    if (error instanceof McpError) throw error
+    throw new McpError(ErrorCode.InternalError, `Recommendations failed: ${error instanceof Error ? error.message : 'Unknown error'}`)
+  }
+}

package/src/server/handlers/tools/index.ts

@@ -1,31 +1,31 @@
-/**
- * Tool Handlers Exports
- */
-
-export { handleGetProjectContext } from './get-project-context'
-export { handleUpdateProgress } from './update-progress'
-export { handleRememberDecision } from './remember-decision'
-export { handleRecallSimilar } from './recall-similar'
-export { handleGetCodeStandards } from './get-code-standards'
-export { handleListProjects } from './list-projects'
-
-// Phase 12 Tools
-export { handleSmartContext } from './smart-context'
-export { handleAutoRemember } from './auto-remember'
-export { handleGetPhase12Status } from './get-phase12-status'
-
-// Pattern & Correction Tools
-export { handleRecognizePattern } from './recognize-pattern'
-export { handleRecordCorrection } from './record-correction'
-export { handleGetPatterns } from './get-patterns'
-export { handleGetCorrections } from './get-corrections'
-
-// Project Management
-export { handleCreateProject } from './create-project'
-export { handleInitProject } from './init-project'
-
-// Phase 19: Removed 9 redundant tool exports.
-// rate_memory, search_knowledge_graph, get_episode, list_episodes,
-// get_decision_timeline, analyze_decision_evolution, detect_trends,
-// what_if_analysis, get_recommendations, find_cross_project_patterns
-// are now absorbed into brain(). Handler files kept for reference.
+/**
+ * Tool Handlers Exports
+ */
+
+export { handleGetProjectContext } from './get-project-context'
+export { handleUpdateProgress } from './update-progress'
+export { handleRememberDecision } from './remember-decision'
+export { handleRecallSimilar } from './recall-similar'
+export { handleGetCodeStandards } from './get-code-standards'
+export { handleListProjects } from './list-projects'
+
+// Phase 12 Tools
+export { handleSmartContext } from './smart-context'
+export { handleAutoRemember } from './auto-remember'
+export { handleGetPhase12Status } from './get-phase12-status'
+
+// Pattern & Correction Tools
+export { handleRecognizePattern } from './recognize-pattern'
+export { handleRecordCorrection } from './record-correction'
+export { handleGetPatterns } from './get-patterns'
+export { handleGetCorrections } from './get-corrections'
+
+// Project Management
+export { handleCreateProject } from './create-project'
+export { handleInitProject } from './init-project'
+
+// Phase 19: Removed 9 redundant tool exports.
+// rate_memory, search_knowledge_graph, get_episode, list_episodes,
+// get_decision_timeline, analyze_decision_evolution, detect_trends,
+// what_if_analysis, get_recommendations, find_cross_project_patterns
+// are now absorbed into brain(). Handler files kept for reference.