claude-brain 0.3.0

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

@@ -0,0 +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'}`
+    )
+  }
+}

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

@@ -0,0 +1,65 @@
+/**
+ * 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 '@/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()
+    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

@@ -0,0 +1,33 @@
+/**
+ * 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 15 - Advanced Intelligence & Temporal Reasoning
+export { handleGetDecisionTimeline } from './get-decision-timeline'
+export { handleAnalyzeDecisionEvolution } from './analyze-decision-evolution'
+export { handleDetectTrends } from './detect-trends'
+export { handleWhatIfAnalysis } from './what-if-analysis'
+export { handleGetRecommendations } from './get-recommendations'
+export { handleFindCrossProjectPatterns } from './find-cross-project-patterns'