claude-brain 0.14.2 → 0.14.4

package/src/server/handlers/tools/analyze-decision-evolution.ts

@@ -1,151 +1,151 @@
-/**
- * Analyze Decision Evolution Handler
- * Tracks how decisions on a topic have evolved over time
- */
-
-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 { AnalyzeDecisionEvolutionSchema } from './schemas'
-import { DecisionEvolutionTracker } from '@/intelligence/temporal/evolution'
-
-export async function handleAnalyzeDecisionEvolution(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, AnalyzeDecisionEvolutionSchema)
-    const { topic, project_name, limit } = input
-
-    const memory = getMemoryService()
-
-    if (!memory.isChromaDBEnabled()) {
-      // SQLite fallback: use searchRaw for semantic search + chronological analysis
-      const results = await memory.searchRaw(topic, {
-        project: project_name,
-        limit: limit || 20,
-        minSimilarity: 0.2
-      })
-
-      if (results.length === 0) {
-        return ResponseFormatter.text(`No decisions found for topic: "${topic}"`)
-      }
-
-      // Sort chronologically
-      const sorted = results
-        .map(r => ({
-          date: r.memory?.createdAt?.toISOString?.() || r.memory?.created_at || new Date().toISOString(),
-          decision: r.decision?.decision || r.memory?.content || '',
-          reasoning: r.decision?.reasoning || '',
-          similarity: r.similarity || 0
-        }))
-        .sort((a, b) => new Date(a.date).getTime() - new Date(b.date).getTime())
-
-      // Simple stability assessment based on content similarity between consecutive decisions
-      let totalSimilarity = 0
-      let comparisons = 0
-      const changes: Array<{ daysBetween: number; summary: string }> = []
-
-      for (let i = 1; i < sorted.length; i++) {
-        const prev = sorted[i - 1]
-        const curr = sorted[i]
-        const daysBetween = Math.round((new Date(curr.date).getTime() - new Date(prev.date).getTime()) / (1000 * 60 * 60 * 24))
-
-        // Simple Jaccard similarity between word sets
-        const prevWords = new Set(prev.decision.toLowerCase().split(/\s+/).filter(w => w.length > 3))
-        const currWords = new Set(curr.decision.toLowerCase().split(/\s+/).filter(w => w.length > 3))
-        const intersection = new Set([...prevWords].filter(w => currWords.has(w)))
-        const union = new Set([...prevWords, ...currWords])
-        const jaccard = union.size > 0 ? intersection.size / union.size : 0
-        totalSimilarity += jaccard
-        comparisons++
-
-        if (jaccard < 0.5) {
-          changes.push({
-            daysBetween,
-            summary: `Changed from "${prev.decision.slice(0, 60)}..." to "${curr.decision.slice(0, 60)}..."`
-          })
-        }
-      }
-
-      const avgSimilarity = comparisons > 0 ? totalSimilarity / comparisons : 1
-      const stability = avgSimilarity > 0.7 ? 'stable' : avgSimilarity > 0.4 ? 'evolving' : 'volatile'
-      const currentState = sorted[sorted.length - 1].decision
-
-      const parts: string[] = []
-      parts.push(`## Decision Evolution: "${topic}" (SQLite)`)
-      if (project_name) parts.push(`**Project:** ${project_name}`)
-      parts.push(`**Total decisions:** ${sorted.length}`)
-      parts.push(`**Stability:** ${stability}`)
-      parts.push(`**Current state:** ${currentState.slice(0, 200)}`)
-      parts.push('')
-
-      if (changes.length > 0) {
-        parts.push('### Changes Over Time')
-        for (const change of changes) {
-          parts.push(`- **${change.daysBetween} days apart:** ${change.summary}`)
-        }
-        parts.push('')
-      }
-
-      parts.push('### Timeline')
-      for (const entry of sorted.slice(0, 10)) {
-        const date = new Date(entry.date).toLocaleDateString()
-        parts.push(`- **${date}:** ${entry.decision.slice(0, 150)}`)
-      }
-
-      const statsLine = formatMemoryStats({ recalled: sorted.length })
-      return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), sorted.length) + '\n\n' + statsLine)
-    }
-
-    const tracker = new DecisionEvolutionTracker(
-      logger,
-      memory.chroma.collections,
-      memory.chroma.embeddings
-    )
-
-    const analysis = await tracker.analyzeEvolution(topic, {
-      project: project_name,
-      limit
-    })
-
-    if (analysis.totalDecisions === 0) {
-      return ResponseFormatter.text(`No decisions found for topic: "${topic}"`)
-    }
-
-    const parts: string[] = []
-    parts.push(`## Decision Evolution: "${topic}"`)
-    if (project_name) parts.push(`**Project:** ${project_name}`)
-    parts.push(`**Total decisions:** ${analysis.totalDecisions}`)
-    parts.push(`**Stability:** ${analysis.stability}`)
-    parts.push(`**Current state:** ${analysis.currentState.slice(0, 200)}`)
-    parts.push('')
-
-    if (analysis.changes.length > 0) {
-      parts.push('### Changes Over Time')
-      for (const change of analysis.changes) {
-        parts.push(`- **${change.daysBetween} days apart:** ${change.summary}`)
-      }
-      parts.push('')
-    }
-
-    parts.push('### Timeline')
-    for (const entry of analysis.timeline.slice(0, 10)) {
-      const date = new Date(entry.date).toLocaleDateString()
-      parts.push(`- **${date}:** ${entry.decision.slice(0, 150)}`)
-    }
-
-    const statsLine = formatMemoryStats({ recalled: analysis.totalDecisions })
-    return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), analysis.totalDecisions) + '\n\n' + statsLine)
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'analyze_decision_evolution' })
-    if (error instanceof McpError) throw error
-    throw new McpError(ErrorCode.InternalError, `Evolution analysis failed: ${error instanceof Error ? error.message : 'Unknown error'}`)
-  }
-}
+/**
+ * Analyze Decision Evolution Handler
+ * Tracks how decisions on a topic have evolved over time
+ */
+
+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 { AnalyzeDecisionEvolutionSchema } from './schemas'
+import { DecisionEvolutionTracker } from '@/intelligence/temporal/evolution'
+
+export async function handleAnalyzeDecisionEvolution(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, AnalyzeDecisionEvolutionSchema)
+    const { topic, project_name, limit } = input
+
+    const memory = getMemoryService()
+
+    if (!memory.isChromaDBEnabled()) {
+      // SQLite fallback: use searchRaw for semantic search + chronological analysis
+      const results = await memory.searchRaw(topic, {
+        project: project_name,
+        limit: limit || 20,
+        minSimilarity: 0.2
+      })
+
+      if (results.length === 0) {
+        return ResponseFormatter.text(`No decisions found for topic: "${topic}"`)
+      }
+
+      // Sort chronologically
+      const sorted = results
+        .map(r => ({
+          date: r.memory?.createdAt?.toISOString?.() || r.memory?.created_at || new Date().toISOString(),
+          decision: r.decision?.decision || r.memory?.content || '',
+          reasoning: r.decision?.reasoning || '',
+          similarity: r.similarity || 0
+        }))
+        .sort((a, b) => new Date(a.date).getTime() - new Date(b.date).getTime())
+
+      // Simple stability assessment based on content similarity between consecutive decisions
+      let totalSimilarity = 0
+      let comparisons = 0
+      const changes: Array<{ daysBetween: number; summary: string }> = []
+
+      for (let i = 1; i < sorted.length; i++) {
+        const prev = sorted[i - 1]
+        const curr = sorted[i]
+        const daysBetween = Math.round((new Date(curr.date).getTime() - new Date(prev.date).getTime()) / (1000 * 60 * 60 * 24))
+
+        // Simple Jaccard similarity between word sets
+        const prevWords = new Set(prev.decision.toLowerCase().split(/\s+/).filter(w => w.length > 3))
+        const currWords = new Set(curr.decision.toLowerCase().split(/\s+/).filter(w => w.length > 3))
+        const intersection = new Set([...prevWords].filter(w => currWords.has(w)))
+        const union = new Set([...prevWords, ...currWords])
+        const jaccard = union.size > 0 ? intersection.size / union.size : 0
+        totalSimilarity += jaccard
+        comparisons++
+
+        if (jaccard < 0.5) {
+          changes.push({
+            daysBetween,
+            summary: `Changed from "${prev.decision.slice(0, 60)}..." to "${curr.decision.slice(0, 60)}..."`
+          })
+        }
+      }
+
+      const avgSimilarity = comparisons > 0 ? totalSimilarity / comparisons : 1
+      const stability = avgSimilarity > 0.7 ? 'stable' : avgSimilarity > 0.4 ? 'evolving' : 'volatile'
+      const currentState = sorted[sorted.length - 1].decision
+
+      const parts: string[] = []
+      parts.push(`## Decision Evolution: "${topic}" (SQLite)`)
+      if (project_name) parts.push(`**Project:** ${project_name}`)
+      parts.push(`**Total decisions:** ${sorted.length}`)
+      parts.push(`**Stability:** ${stability}`)
+      parts.push(`**Current state:** ${currentState.slice(0, 200)}`)
+      parts.push('')
+
+      if (changes.length > 0) {
+        parts.push('### Changes Over Time')
+        for (const change of changes) {
+          parts.push(`- **${change.daysBetween} days apart:** ${change.summary}`)
+        }
+        parts.push('')
+      }
+
+      parts.push('### Timeline')
+      for (const entry of sorted.slice(0, 10)) {
+        const date = new Date(entry.date).toLocaleDateString()
+        parts.push(`- **${date}:** ${entry.decision.slice(0, 150)}`)
+      }
+
+      const statsLine = formatMemoryStats({ recalled: sorted.length })
+      return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), sorted.length) + '\n\n' + statsLine)
+    }
+
+    const tracker = new DecisionEvolutionTracker(
+      logger,
+      memory.chroma.collections,
+      memory.chroma.embeddings
+    )
+
+    const analysis = await tracker.analyzeEvolution(topic, {
+      project: project_name,
+      limit
+    })
+
+    if (analysis.totalDecisions === 0) {
+      return ResponseFormatter.text(`No decisions found for topic: "${topic}"`)
+    }
+
+    const parts: string[] = []
+    parts.push(`## Decision Evolution: "${topic}"`)
+    if (project_name) parts.push(`**Project:** ${project_name}`)
+    parts.push(`**Total decisions:** ${analysis.totalDecisions}`)
+    parts.push(`**Stability:** ${analysis.stability}`)
+    parts.push(`**Current state:** ${analysis.currentState.slice(0, 200)}`)
+    parts.push('')
+
+    if (analysis.changes.length > 0) {
+      parts.push('### Changes Over Time')
+      for (const change of analysis.changes) {
+        parts.push(`- **${change.daysBetween} days apart:** ${change.summary}`)
+      }
+      parts.push('')
+    }
+
+    parts.push('### Timeline')
+    for (const entry of analysis.timeline.slice(0, 10)) {
+      const date = new Date(entry.date).toLocaleDateString()
+      parts.push(`- **${date}:** ${entry.decision.slice(0, 150)}`)
+    }
+
+    const statsLine = formatMemoryStats({ recalled: analysis.totalDecisions })
+    return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), analysis.totalDecisions) + '\n\n' + statsLine)
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'analyze_decision_evolution' })
+    if (error instanceof McpError) throw error
+    throw new McpError(ErrorCode.InternalError, `Evolution analysis failed: ${error instanceof Error ? error.message : 'Unknown error'}`)
+  }
+}