claude-brain 0.15.2 → 0.16.0

package/src/server/handlers/tools/create-project.ts

@@ -1,135 +1,135 @@
-/**
- * Create Project Handler
- * Creates a new project in the vault with all necessary files
- */
-
-import type { Logger } from 'pino'
-import type { ToolResponse } from '@/tools/types'
-import { getVaultService, isServicesInitialized } 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 { CreateProjectSchema } from './schemas'
-
-export async function handleCreateProject(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, CreateProjectSchema)
-    const {
-      project_name,
-      description,
-      tech_stack,
-      status,
-      tags
-    } = input
-
-    // project_name is already validated by schema to be lowercase with hyphens
-    const normalizedName = project_name
-
-    logger.debug({
-      project_name: normalizedName,
-      description,
-      tech_stack,
-      status,
-      tags
-    }, 'Creating project')
-
-    if (!isServicesInitialized()) {
-      throw new McpError(
-        ErrorCode.InternalError,
-        'Services not initialized'
-      )
-    }
-
-    const vault = getVaultService()
-
-    // Check if project already exists
-    const existingProjects = await vault.listProjects()
-    if (existingProjects.includes(normalizedName)) {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        `Project "${normalizedName}" already exists. Use get_project_context to view it.`
-      )
-    }
-
-    // Create the project structure
-    await vault.createProject(normalizedName)
-
-    // Update context.md with provided metadata
-    const projectPaths = vault.getProjectPaths(normalizedName)
-
-    if (description || tech_stack.length > 0 || tags.length > 0 || status !== 'planning') {
-      await vault.writer.updateFrontmatter(projectPaths.context, {
-        description: description || '',
-        tech_stack: tech_stack,
-        tags: tags,
-        status: status
-      })
-
-      // Also update the content with description
-      if (description) {
-        const contextFile = await vault.reader.readMarkdownFile(projectPaths.context)
-        const updatedContent = contextFile.content.replace(
-          '<!-- Project description and goals -->',
-          description
-        )
-        await vault.writer.writeMarkdownFile(
-          projectPaths.context,
-          { ...contextFile.frontmatter, description, tech_stack, tags, status },
-          updatedContent,
-          { createBackup: false }
-        )
-      }
-    }
-
-    // Build response
-    const parts: string[] = []
-    parts.push(`## ✅ Project Created: ${normalizedName}\n`)
-    parts.push(`Your project has been set up in the Obsidian vault.\n`)
-    parts.push(`### Files Created:\n`)
-    parts.push(`- \`${normalizedName}/context.md\` - Project overview and architecture`)
-    parts.push(`- \`${normalizedName}/progress.md\` - Progress tracking`)
-    parts.push(`- \`${normalizedName}/decisions.md\` - Decision log`)
-    parts.push(`- \`${normalizedName}/standards.md\` - Coding standards\n`)
-
-    if (description) {
-      parts.push(`### Description:\n${description}\n`)
-    }
-
-    if (tech_stack.length > 0) {
-      parts.push(`### Tech Stack:\n${tech_stack.join(', ')}\n`)
-    }
-
-    if (tags.length > 0) {
-      parts.push(`### Tags:\n${tags.join(', ')}\n`)
-    }
-
-    parts.push(`### Next Steps:\n`)
-    parts.push(`1. Use \`get_project_context("${normalizedName}")\` to view the project`)
-    parts.push(`2. Edit the markdown files in your Obsidian vault to add details`)
-    parts.push(`3. Use \`remember_decision\` to store architectural decisions`)
-    parts.push(`4. Use \`update_progress\` to track your work`)
-
-    logger.info({
-      project_name: normalizedName,
-      status
-    }, 'Project created successfully')
-
-    return ResponseFormatter.text(parts.join('\n'))
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'create_project', args })
-
-    if (error instanceof McpError) {
-      throw error
-    }
-
-    throw new McpError(
-      ErrorCode.InternalError,
-      `Failed to create project: ${error instanceof Error ? error.message : 'Unknown error'}`
-    )
-  }
-}
+/**
+ * Create Project Handler
+ * Creates a new project in the vault with all necessary files
+ */
+
+import type { Logger } from 'pino'
+import type { ToolResponse } from '@/tools/types'
+import { getVaultService, isServicesInitialized } 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 { CreateProjectSchema } from './schemas'
+
+export async function handleCreateProject(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, CreateProjectSchema)
+    const {
+      project_name,
+      description,
+      tech_stack,
+      status,
+      tags
+    } = input
+
+    // project_name is already validated by schema to be lowercase with hyphens
+    const normalizedName = project_name
+
+    logger.debug({
+      project_name: normalizedName,
+      description,
+      tech_stack,
+      status,
+      tags
+    }, 'Creating project')
+
+    if (!isServicesInitialized()) {
+      throw new McpError(
+        ErrorCode.InternalError,
+        'Services not initialized'
+      )
+    }
+
+    const vault = getVaultService()
+
+    // Check if project already exists
+    const existingProjects = await vault.listProjects()
+    if (existingProjects.includes(normalizedName)) {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        `Project "${normalizedName}" already exists. Use get_project_context to view it.`
+      )
+    }
+
+    // Create the project structure
+    await vault.createProject(normalizedName)
+
+    // Update context.md with provided metadata
+    const projectPaths = vault.getProjectPaths(normalizedName)
+
+    if (description || tech_stack.length > 0 || tags.length > 0 || status !== 'planning') {
+      await vault.writer.updateFrontmatter(projectPaths.context, {
+        description: description || '',
+        tech_stack: tech_stack,
+        tags: tags,
+        status: status
+      })
+
+      // Also update the content with description
+      if (description) {
+        const contextFile = await vault.reader.readMarkdownFile(projectPaths.context)
+        const updatedContent = contextFile.content.replace(
+          '<!-- Project description and goals -->',
+          description
+        )
+        await vault.writer.writeMarkdownFile(
+          projectPaths.context,
+          { ...contextFile.frontmatter, description, tech_stack, tags, status },
+          updatedContent,
+          { createBackup: false }
+        )
+      }
+    }
+
+    // Build response
+    const parts: string[] = []
+    parts.push(`## ✅ Project Created: ${normalizedName}\n`)
+    parts.push(`Your project has been set up in the Obsidian vault.\n`)
+    parts.push(`### Files Created:\n`)
+    parts.push(`- \`${normalizedName}/context.md\` - Project overview and architecture`)
+    parts.push(`- \`${normalizedName}/progress.md\` - Progress tracking`)
+    parts.push(`- \`${normalizedName}/decisions.md\` - Decision log`)
+    parts.push(`- \`${normalizedName}/standards.md\` - Coding standards\n`)
+
+    if (description) {
+      parts.push(`### Description:\n${description}\n`)
+    }
+
+    if (tech_stack.length > 0) {
+      parts.push(`### Tech Stack:\n${tech_stack.join(', ')}\n`)
+    }
+
+    if (tags.length > 0) {
+      parts.push(`### Tags:\n${tags.join(', ')}\n`)
+    }
+
+    parts.push(`### Next Steps:\n`)
+    parts.push(`1. Use \`get_project_context("${normalizedName}")\` to view the project`)
+    parts.push(`2. Edit the markdown files in your Obsidian vault to add details`)
+    parts.push(`3. Use \`remember_decision\` to store architectural decisions`)
+    parts.push(`4. Use \`update_progress\` to track your work`)
+
+    logger.info({
+      project_name: normalizedName,
+      status
+    }, 'Project created successfully')
+
+    return ResponseFormatter.text(parts.join('\n'))
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'create_project', args })
+
+    if (error instanceof McpError) {
+      throw error
+    }
+
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Failed to create project: ${error instanceof Error ? error.message : 'Unknown error'}`
+    )
+  }
+}

package/src/server/handlers/tools/detect-trends.ts

@@ -1,144 +1,144 @@
-/**
- * Detect Trends Handler
- * Detects technology, pattern, and concern trends across decisions
- */
-
-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 { DetectTrendsSchema } from './schemas'
-import { TrendDetector } from '@/intelligence/temporal/trends'
-
-export async function handleDetectTrends(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, DetectTrendsSchema)
-    const { project_name, period_days, min_occurrences, limit } = input
-
-    const memory = getMemoryService()
-
-    if (!memory.isChromaDBEnabled()) {
-      // SQLite fallback: frequency-based trend analysis
-      const decisions = await memory.fetchAllDecisions(project_name)
-
-      if (decisions.length === 0) {
-        return ResponseFormatter.text('No decisions found for trend analysis.')
-      }
-
-      // Filter by period
-      const cutoffDate = new Date()
-      cutoffDate.setDate(cutoffDate.getDate() - (period_days || 90))
-      const filtered = decisions.filter(d => new Date(d.date) >= cutoffDate)
-
-      if (filtered.length === 0) {
-        return ResponseFormatter.text(`No decisions found in the last ${period_days || 90} days.`)
-      }
-
-      // Extract term frequencies from decision content
-      const stopWords = new Set(['the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could', 'should', 'may', 'might', 'can', 'shall', 'to', 'of', 'in', 'for', 'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during', 'before', 'after', 'above', 'below', 'between', 'out', 'off', 'over', 'under', 'again', 'further', 'then', 'once', 'and', 'but', 'or', 'nor', 'not', 'so', 'yet', 'both', 'either', 'neither', 'each', 'every', 'all', 'any', 'few', 'more', 'most', 'other', 'some', 'such', 'no', 'only', 'own', 'same', 'than', 'too', 'very', 'just', 'because', 'if', 'when', 'where', 'how', 'what', 'which', 'who', 'whom', 'this', 'that', 'these', 'those', 'i', 'me', 'my', 'we', 'our', 'you', 'your', 'he', 'him', 'his', 'she', 'her', 'it', 'its', 'they', 'them', 'their', 'use', 'using', 'used', 'decision', 'context', 'reasoning'])
-      const termCounts: Record<string, { count: number; projects: Set<string> }> = {}
-
-      for (const d of filtered) {
-        const text = `${d.decision || ''} ${d.context || ''} ${d.reasoning || ''}`.toLowerCase()
-        const words = text.match(/\b[a-z][a-z-]{2,}\b/g) || []
-        const seen = new Set<string>()
-        for (const word of words) {
-          if (stopWords.has(word) || seen.has(word)) continue
-          seen.add(word)
-          if (!termCounts[word]) termCounts[word] = { count: 0, projects: new Set() }
-          termCounts[word].count++
-          if (d.project) termCounts[word].projects.add(d.project)
-        }
-      }
-
-      const minOcc = min_occurrences || 2
-      const trends = Object.entries(termCounts)
-        .filter(([, v]) => v.count >= minOcc)
-        .map(([term, v]) => ({ term, occurrences: v.count, projects: Array.from(v.projects) }))
-        .sort((a, b) => b.occurrences - a.occurrences)
-        .slice(0, limit || 20)
-
-      const parts: string[] = []
-      parts.push(`## Trend Analysis (SQLite)`)
-      if (project_name) parts.push(`**Project:** ${project_name}`)
-      parts.push(`**Period:** Last ${period_days || 90} days`)
-      parts.push(`**Decisions analyzed:** ${filtered.length}`)
-      parts.push('')
-
-      if (trends.length > 0) {
-        parts.push('### Top Terms by Frequency')
-        for (const t of trends) {
-          parts.push(`- **${t.term}** (${t.occurrences}x, projects: ${t.projects.join(', ')})`)
-        }
-      } else {
-        parts.push('No significant trends found with current filters.')
-      }
-
-      parts.push('\n*Note: SQLite mode provides frequency-based analysis. Enable ChromaDB for momentum and rising/declining classification.*')
-
-      const statsLine = formatMemoryStats({ recalled: filtered.length })
-      return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), filtered.length) + '\n\n' + statsLine)
-    }
-
-    const detector = new TrendDetector(logger, memory.chroma.collections)
-
-    const analysis = await detector.detectTrends({
-      project: project_name,
-      periodDays: period_days,
-      minOccurrences: min_occurrences,
-      limit
-    })
-
-    if (analysis.totalDecisionsAnalyzed === 0) {
-      return ResponseFormatter.text('No decisions found for trend analysis.')
-    }
-
-    const parts: string[] = []
-    parts.push(`## Trend Analysis`)
-    if (project_name) parts.push(`**Project:** ${project_name}`)
-    parts.push(`**Period:** ${analysis.period}`)
-    parts.push(`**Decisions analyzed:** ${analysis.totalDecisionsAnalyzed}`)
-    parts.push('')
-
-    if (analysis.emergingTopics.length > 0) {
-      parts.push('### 📈 Emerging Topics')
-      for (const trend of analysis.emergingTopics.slice(0, 10)) {
-        const momentum = Math.round(trend.momentum * 100)
-        parts.push(`- **${trend.term}** (${trend.occurrences}x, +${momentum}% momentum, projects: ${trend.projects.join(', ')})`)
-      }
-      parts.push('')
-    }
-
-    if (analysis.decliningTopics.length > 0) {
-      parts.push('### 📉 Declining Topics')
-      for (const trend of analysis.decliningTopics.slice(0, 10)) {
-        const momentum = Math.round(trend.momentum * 100)
-        parts.push(`- **${trend.term}** (${trend.occurrences}x, ${momentum}% momentum)`)
-      }
-      parts.push('')
-    }
-
-    if (analysis.topTrends.length > 0) {
-      parts.push('### 🔥 Top Trends')
-      for (const trend of analysis.topTrends.slice(0, 10)) {
-        const icon = trend.trend === 'rising' ? '📈' : trend.trend === 'declining' ? '📉' : '➡️'
-        parts.push(`- ${icon} **${trend.term}** (${trend.occurrences}x, ${trend.trend})`)
-      }
-    }
-
-    const statsLine = formatMemoryStats({ recalled: analysis.totalDecisionsAnalyzed })
-    return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), analysis.totalDecisionsAnalyzed) + '\n\n' + statsLine)
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'detect_trends' })
-    if (error instanceof McpError) throw error
-    throw new McpError(ErrorCode.InternalError, `Trend detection failed: ${error instanceof Error ? error.message : 'Unknown error'}`)
-  }
-}
+/**
+ * Detect Trends Handler
+ * Detects technology, pattern, and concern trends across decisions
+ */
+
+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 { DetectTrendsSchema } from './schemas'
+import { TrendDetector } from '@/intelligence/temporal/trends'
+
+export async function handleDetectTrends(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, DetectTrendsSchema)
+    const { project_name, period_days, min_occurrences, limit } = input
+
+    const memory = getMemoryService()
+
+    if (!memory.isChromaDBEnabled()) {
+      // SQLite fallback: frequency-based trend analysis
+      const decisions = await memory.fetchAllDecisions(project_name)
+
+      if (decisions.length === 0) {
+        return ResponseFormatter.text('No decisions found for trend analysis.')
+      }
+
+      // Filter by period
+      const cutoffDate = new Date()
+      cutoffDate.setDate(cutoffDate.getDate() - (period_days || 90))
+      const filtered = decisions.filter(d => new Date(d.date) >= cutoffDate)
+
+      if (filtered.length === 0) {
+        return ResponseFormatter.text(`No decisions found in the last ${period_days || 90} days.`)
+      }
+
+      // Extract term frequencies from decision content
+      const stopWords = new Set(['the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could', 'should', 'may', 'might', 'can', 'shall', 'to', 'of', 'in', 'for', 'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during', 'before', 'after', 'above', 'below', 'between', 'out', 'off', 'over', 'under', 'again', 'further', 'then', 'once', 'and', 'but', 'or', 'nor', 'not', 'so', 'yet', 'both', 'either', 'neither', 'each', 'every', 'all', 'any', 'few', 'more', 'most', 'other', 'some', 'such', 'no', 'only', 'own', 'same', 'than', 'too', 'very', 'just', 'because', 'if', 'when', 'where', 'how', 'what', 'which', 'who', 'whom', 'this', 'that', 'these', 'those', 'i', 'me', 'my', 'we', 'our', 'you', 'your', 'he', 'him', 'his', 'she', 'her', 'it', 'its', 'they', 'them', 'their', 'use', 'using', 'used', 'decision', 'context', 'reasoning'])
+      const termCounts: Record<string, { count: number; projects: Set<string> }> = {}
+
+      for (const d of filtered) {
+        const text = `${d.decision || ''} ${d.context || ''} ${d.reasoning || ''}`.toLowerCase()
+        const words = text.match(/\b[a-z][a-z-]{2,}\b/g) || []
+        const seen = new Set<string>()
+        for (const word of words) {
+          if (stopWords.has(word) || seen.has(word)) continue
+          seen.add(word)
+          if (!termCounts[word]) termCounts[word] = { count: 0, projects: new Set() }
+          termCounts[word].count++
+          if (d.project) termCounts[word].projects.add(d.project)
+        }
+      }
+
+      const minOcc = min_occurrences || 2
+      const trends = Object.entries(termCounts)
+        .filter(([, v]) => v.count >= minOcc)
+        .map(([term, v]) => ({ term, occurrences: v.count, projects: Array.from(v.projects) }))
+        .sort((a, b) => b.occurrences - a.occurrences)
+        .slice(0, limit || 20)
+
+      const parts: string[] = []
+      parts.push(`## Trend Analysis (SQLite)`)
+      if (project_name) parts.push(`**Project:** ${project_name}`)
+      parts.push(`**Period:** Last ${period_days || 90} days`)
+      parts.push(`**Decisions analyzed:** ${filtered.length}`)
+      parts.push('')
+
+      if (trends.length > 0) {
+        parts.push('### Top Terms by Frequency')
+        for (const t of trends) {
+          parts.push(`- **${t.term}** (${t.occurrences}x, projects: ${t.projects.join(', ')})`)
+        }
+      } else {
+        parts.push('No significant trends found with current filters.')
+      }
+
+      parts.push('\n*Note: SQLite mode provides frequency-based analysis. Enable ChromaDB for momentum and rising/declining classification.*')
+
+      const statsLine = formatMemoryStats({ recalled: filtered.length })
+      return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), filtered.length) + '\n\n' + statsLine)
+    }
+
+    const detector = new TrendDetector(logger, memory.chroma.collections)
+
+    const analysis = await detector.detectTrends({
+      project: project_name,
+      periodDays: period_days,
+      minOccurrences: min_occurrences,
+      limit
+    })
+
+    if (analysis.totalDecisionsAnalyzed === 0) {
+      return ResponseFormatter.text('No decisions found for trend analysis.')
+    }
+
+    const parts: string[] = []
+    parts.push(`## Trend Analysis`)
+    if (project_name) parts.push(`**Project:** ${project_name}`)
+    parts.push(`**Period:** ${analysis.period}`)
+    parts.push(`**Decisions analyzed:** ${analysis.totalDecisionsAnalyzed}`)
+    parts.push('')
+
+    if (analysis.emergingTopics.length > 0) {
+      parts.push('### 📈 Emerging Topics')
+      for (const trend of analysis.emergingTopics.slice(0, 10)) {
+        const momentum = Math.round(trend.momentum * 100)
+        parts.push(`- **${trend.term}** (${trend.occurrences}x, +${momentum}% momentum, projects: ${trend.projects.join(', ')})`)
+      }
+      parts.push('')
+    }
+
+    if (analysis.decliningTopics.length > 0) {
+      parts.push('### 📉 Declining Topics')
+      for (const trend of analysis.decliningTopics.slice(0, 10)) {
+        const momentum = Math.round(trend.momentum * 100)
+        parts.push(`- **${trend.term}** (${trend.occurrences}x, ${momentum}% momentum)`)
+      }
+      parts.push('')
+    }
+
+    if (analysis.topTrends.length > 0) {
+      parts.push('### 🔥 Top Trends')
+      for (const trend of analysis.topTrends.slice(0, 10)) {
+        const icon = trend.trend === 'rising' ? '📈' : trend.trend === 'declining' ? '📉' : '➡️'
+        parts.push(`- ${icon} **${trend.term}** (${trend.occurrences}x, ${trend.trend})`)
+      }
+    }
+
+    const statsLine = formatMemoryStats({ recalled: analysis.totalDecisionsAnalyzed })
+    return ResponseFormatter.text(withMemoryIndicator(parts.join('\n'), analysis.totalDecisionsAnalyzed) + '\n\n' + statsLine)
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'detect_trends' })
+    if (error instanceof McpError) throw error
+    throw new McpError(ErrorCode.InternalError, `Trend detection failed: ${error instanceof Error ? error.message : 'Unknown error'}`)
+  }
+}