claude-brain 0.30.2 → 0.30.3

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

@@ -1,152 +1,152 @@
-/**
- * Get Corrections Handler
- * Retrieves corrections and lessons learned from ChromaDB semantic memory
- */
-
-import type { Logger } from 'pino'
-import type { GetCorrectionsInput, ToolResponse } from '@/tools/types'
-import { getMemoryService, isServicesInitialized } from '@/server/services'
-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'
-
-export async function handleGetCorrections(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = args as GetCorrectionsInput
-    const {
-      project_name,
-      limit = 10,
-      query
-    } = input
-
-    logger.debug(
-      { project_name, limit, has_query: !!query },
-      'Getting corrections'
-    )
-
-    if (!isServicesInitialized()) {
-      throw new McpError(
-        ErrorCode.InternalError,
-        'Memory service not initialized. The server may still be starting up.'
-      )
-    }
-
-    const memory = getMemoryService()
-
-    let results: any[]
-
-    if (query) {
-      results = await memory.searchCorrections(query, {
-        project: project_name,
-        limit,
-        minSimilarity: 0.5
-      })
-    } else {
-      results = await memory.getCorrections(project_name, {
-        limit
-      })
-    }
-
-    if (results.length === 0) {
-      const message = project_name
-        ? `No corrections found for project "${project_name}".`
-        : 'No corrections found.'
-
-      logger.warn({ project_name }, 'No corrections found')
-
-      return ResponseFormatter.text(
-        `No corrections found.\n\n${message}\n\nTips:\n` +
-        `- Use \`record_correction\` to document mistakes and lessons learned\n` +
-        `- Review past corrections to avoid repeating mistakes\n` +
-        `- Check project documentation for best practices\n`
-      )
-    }
-
-    logger.info(
-      { project_name, count: results.length },
-      'Corrections retrieved successfully'
-    )
-
-    const projectInfo = project_name ? ` for **${project_name}**` : ''
-
-    let response = `Found **${results.length} correction(s)${projectInfo}:\n\n`
-
-    results.forEach((correction: any, index: number) => {
-      const num = index + 1
-      const metadata = correction.metadata
-
-      response += `## ${num}. What went wrong\n\n`
-      response += `**ID:** ${correction.id}\n`
-      response += `**Confidence:** ${metadata.confidence.toFixed(2)}\n`
-      response += `**Project:** ${metadata.project}\n\n`
-      response += `**Original:** ${metadata.original}\n\n`
-      response += `**Correction:** ${metadata.correction}\n\n`
-
-      if (metadata.reasoning) {
-        response += `**Reasoning:** ${metadata.reasoning}\n\n`
-      }
-
-      if (metadata.context) {
-        response += `**Context:** ${metadata.context}\n\n`
-      }
-
-      response += `**Recorded:** ${new Date(metadata.created_at).toLocaleDateString()}\n\n`
-
-      if (index < results.length) {
-        response += `---\n\n`
-      }
-    })
-
-    if (results.length === 0) {
-      response += `No corrections documented yet.\n\n` +
-        `Use \`record_correction\` to document mistakes and lessons learned.\n`
-    }
-
-    response += `\n**Next Steps:**\n`
-    response += `- Learn from these corrections to avoid mistakes\n`
-    response += `- Document new lessons as you discover them\n`
-
-    // Add memory indicator to show Claude Brain helped
-    const statsLine = formatMemoryStats({ corrections: results.length })
-    return ResponseFormatter.text(withMemoryIndicator(response, results.length) + '\n\n' + statsLine)
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'get_corrections', args })
-
-    // Provide detailed error messages based on error type
-    if (error instanceof Error) {
-      if (error.message.includes('ChromaDB') || error.message.includes('collection')) {
-        throw new McpError(
-          ErrorCode.InternalError,
-          `ChromaDB correction retrieval failed: ${error.message}\n\n` +
-          `This may be caused by:\n` +
-          `- ChromaDB not running (check if ChromaDB server is started)\n` +
-          `- Collections not initialized (try restarting the MCP server)\n` +
-          `- Connection issues (verify ChromaDB configuration)\n\n` +
-          `Error details: ${error.stack || error.message}`
-        )
-      }
-      if (error.message.includes('not initialized')) {
-        throw new McpError(
-          ErrorCode.InternalError,
-          `Memory service not initialized properly.\n\n` +
-          `The server may still be starting up. Please wait a moment and try again.\n` +
-          `If the issue persists, restart the MCP server.`
-        )
-      }
-      if (error.message.includes('requires ChromaDB')) {
-        throw new McpError(
-          ErrorCode.InternalError,
-          `Correction retrieval requires ChromaDB backend.\n\n` +
-          `ChromaDB may not be enabled or may have failed to initialize.\n` +
-          `Check your configuration and ensure ChromaDB is running.`
-        )
-      }
-    }
-
-    throw error
-  }
-}
+/**
+ * Get Corrections Handler
+ * Retrieves corrections and lessons learned from ChromaDB semantic memory
+ */
+
+import type { Logger } from 'pino'
+import type { GetCorrectionsInput, ToolResponse } from '@/tools/types'
+import { getMemoryService, isServicesInitialized } from '@/server/services'
+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'
+
+export async function handleGetCorrections(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = args as GetCorrectionsInput
+    const {
+      project_name,
+      limit = 10,
+      query
+    } = input
+
+    logger.debug(
+      { project_name, limit, has_query: !!query },
+      'Getting corrections'
+    )
+
+    if (!isServicesInitialized()) {
+      throw new McpError(
+        ErrorCode.InternalError,
+        'Memory service not initialized. The server may still be starting up.'
+      )
+    }
+
+    const memory = getMemoryService()
+
+    let results: Record<string, unknown>[]
+
+    if (query) {
+      results = await memory.searchCorrections(query, {
+        project: project_name,
+        limit,
+        minSimilarity: 0.5
+      })
+    } else {
+      results = await memory.getCorrections(project_name, {
+        limit
+      })
+    }
+
+    if (results.length === 0) {
+      const message = project_name
+        ? `No corrections found for project "${project_name}".`
+        : 'No corrections found.'
+
+      logger.warn({ project_name }, 'No corrections found')
+
+      return ResponseFormatter.text(
+        `No corrections found.\n\n${message}\n\nTips:\n` +
+        `- Use \`record_correction\` to document mistakes and lessons learned\n` +
+        `- Review past corrections to avoid repeating mistakes\n` +
+        `- Check project documentation for best practices\n`
+      )
+    }
+
+    logger.info(
+      { project_name, count: results.length },
+      'Corrections retrieved successfully'
+    )
+
+    const projectInfo = project_name ? ` for **${project_name}**` : ''
+
+    let response = `Found **${results.length} correction(s)${projectInfo}:\n\n`
+
+    results.forEach((correction: Record<string, unknown>, index: number) => {
+      const num = index + 1
+      const metadata = (correction.metadata || {}) as Record<string, unknown>
+
+      response += `## ${num}. What went wrong\n\n`
+      response += `**ID:** ${correction.id}\n`
+      response += `**Confidence:** ${Number(metadata.confidence || 0).toFixed(2)}\n`
+      response += `**Project:** ${metadata.project}\n\n`
+      response += `**Original:** ${metadata.original}\n\n`
+      response += `**Correction:** ${metadata.correction}\n\n`
+
+      if (metadata.reasoning) {
+        response += `**Reasoning:** ${metadata.reasoning}\n\n`
+      }
+
+      if (metadata.context) {
+        response += `**Context:** ${metadata.context}\n\n`
+      }
+
+      response += `**Recorded:** ${new Date(metadata.created_at as string).toLocaleDateString()}\n\n`
+
+      if (index < results.length) {
+        response += `---\n\n`
+      }
+    })
+
+    if (results.length === 0) {
+      response += `No corrections documented yet.\n\n` +
+        `Use \`record_correction\` to document mistakes and lessons learned.\n`
+    }
+
+    response += `\n**Next Steps:**\n`
+    response += `- Learn from these corrections to avoid mistakes\n`
+    response += `- Document new lessons as you discover them\n`
+
+    // Add memory indicator to show Claude Brain helped
+    const statsLine = formatMemoryStats({ corrections: results.length })
+    return ResponseFormatter.text(withMemoryIndicator(response, results.length) + '\n\n' + statsLine)
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'get_corrections', args })
+
+    // Provide detailed error messages based on error type
+    if (error instanceof Error) {
+      if (error.message.includes('ChromaDB') || error.message.includes('collection')) {
+        throw new McpError(
+          ErrorCode.InternalError,
+          `ChromaDB correction retrieval failed: ${error.message}\n\n` +
+          `This may be caused by:\n` +
+          `- ChromaDB not running (check if ChromaDB server is started)\n` +
+          `- Collections not initialized (try restarting the MCP server)\n` +
+          `- Connection issues (verify ChromaDB configuration)\n\n` +
+          `Error details: ${error.stack || error.message}`
+        )
+      }
+      if (error.message.includes('not initialized')) {
+        throw new McpError(
+          ErrorCode.InternalError,
+          `Memory service not initialized properly.\n\n` +
+          `The server may still be starting up. Please wait a moment and try again.\n` +
+          `If the issue persists, restart the MCP server.`
+        )
+      }
+      if (error.message.includes('requires ChromaDB')) {
+        throw new McpError(
+          ErrorCode.InternalError,
+          `Correction retrieval requires ChromaDB backend.\n\n` +
+          `ChromaDB may not be enabled or may have failed to initialize.\n` +
+          `Check your configuration and ensure ChromaDB is running.`
+        )
+      }
+    }
+
+    throw error
+  }
+}

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

@@ -1,156 +1,156 @@
-/**
- * Get Patterns Handler
- * Retrieves recognized patterns from ChromaDB semantic memory
- */
-
-import type { Logger } from 'pino'
-import type { GetPatternsInput, ToolResponse } from '@/tools/types'
-import { getMemoryService, isServicesInitialized } from '@/server/services'
-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'
-
-export async function handleGetPatterns(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = args as GetPatternsInput
-    const {
-      project_name,
-      pattern_type,
-      limit = 10,
-      query
-    } = input
-
-    logger.debug(
-      { project_name, pattern_type, limit, has_query: !!query },
-      'Getting patterns'
-    )
-
-    if (!isServicesInitialized()) {
-      throw new McpError(
-        ErrorCode.InternalError,
-        'Memory service not initialized. The server may still be starting up.'
-      )
-    }
-
-    const memory = getMemoryService()
-
-    let results: any[]
-
-    if (query) {
-      results = await memory.searchPatterns(query, {
-        project: project_name,
-        limit,
-        minSimilarity: 0.5
-      })
-    } else {
-      results = await memory.getPatterns(project_name, {
-        limit,
-        pattern_type
-      })
-    }
-
-    if (results.length === 0) {
-      const message = pattern_type
-        ? `No patterns of type "${pattern_type}" found${project_name ? ` for project "${project_name}"` : ''}.`
-        : `No patterns found${project_name ? ` for project "${project_name}"` : ''}.`
-
-      logger.warn({ project_name, pattern_type }, 'No patterns found')
-
-      return ResponseFormatter.text(
-        `No patterns found.\n\n${message}\n\nTips:\n` +
-        `- Use \`recognize_pattern\` to document patterns you discover\n` +
-        `- Review project documentation for documented solutions\n` +
-        `- Check project standards for best practices\n`
-      )
-    }
-
-    logger.info(
-      { project_name, pattern_type, count: results.length },
-      'Patterns retrieved successfully'
-    )
-
-    const projectInfo = project_name ? ` for **${project_name}**` : ''
-    const typeInfo = pattern_type ? ` of type **${pattern_type}**` : ''
-
-    let response = `Found **${results.length} pattern(s)${projectInfo}${typeInfo}:\n\n`
-
-    results.forEach((pattern: any, index: number) => {
-      const num = index + 1
-      const metadata = pattern.metadata
-
-      response += `## ${num}. ${metadata.pattern_type}\n\n`
-      response += `**ID:** ${pattern.id}\n`
-      response += `**Confidence:** ${metadata.confidence.toFixed(2)}\n`
-      response += `**Project:** ${metadata.project}\n\n`
-      response += `**Description:** ${pattern.metadata.description}\n\n`
-
-      if (pattern.metadata.example) {
-        response += `**Example:**\n\`\`\`\n${pattern.metadata.example}\n\`\`\`\n\n`
-      }
-
-      if (pattern.metadata.context) {
-        response += `**Context:** ${pattern.metadata.context}\n\n`
-      }
-
-      response += `**First Seen:** ${new Date(metadata.first_seen).toLocaleDateString()}\n`
-      response += `**Last Seen:** ${new Date(metadata.last_seen).toLocaleDateString()}\n\n`
-      response += `**Occurrences:** ${metadata.occurrences}\n\n`
-
-      if (index < results.length) {
-        response += `---\n\n`
-      }
-    })
-
-    if (results.length === 0) {
-      response += `No patterns documented yet.\n\n` +
-        `Use \`recognize_pattern\` to document patterns as you discover them.\n`
-    }
-
-    response += `\n**Next Steps:**\n`
-    response += `- Apply these patterns to your current work\n`
-    response += `- Recognize new patterns as you discover solutions\n`
-
-    // Add memory indicator to show Claude Brain helped
-    const statsLine = formatMemoryStats({ patterns: results.length })
-    return ResponseFormatter.text(withMemoryIndicator(response, results.length) + '\n\n' + statsLine)
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'get_patterns', args })
-
-    // Provide detailed error messages based on error type
-    if (error instanceof Error) {
-      if (error.message.includes('ChromaDB') || error.message.includes('collection')) {
-        throw new McpError(
-          ErrorCode.InternalError,
-          `ChromaDB pattern retrieval failed: ${error.message}\n\n` +
-          `This may be caused by:\n` +
-          `- ChromaDB not running (check if ChromaDB server is started)\n` +
-          `- Collections not initialized (try restarting the MCP server)\n` +
-          `- Connection issues (verify ChromaDB configuration)\n\n` +
-          `Error details: ${error.stack || error.message}`
-        )
-      }
-      if (error.message.includes('not initialized')) {
-        throw new McpError(
-          ErrorCode.InternalError,
-          `Memory service not initialized properly.\n\n` +
-          `The server may still be starting up. Please wait a moment and try again.\n` +
-          `If the issue persists, restart the MCP server.`
-        )
-      }
-      if (error.message.includes('requires ChromaDB')) {
-        throw new McpError(
-          ErrorCode.InternalError,
-          `Pattern retrieval requires ChromaDB backend.\n\n` +
-          `ChromaDB may not be enabled or may have failed to initialize.\n` +
-          `Check your configuration and ensure ChromaDB is running.`
-        )
-      }
-    }
-
-    throw error
-  }
-}
+/**
+ * Get Patterns Handler
+ * Retrieves recognized patterns from ChromaDB semantic memory
+ */
+
+import type { Logger } from 'pino'
+import type { GetPatternsInput, ToolResponse } from '@/tools/types'
+import { getMemoryService, isServicesInitialized } from '@/server/services'
+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'
+
+export async function handleGetPatterns(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = args as GetPatternsInput
+    const {
+      project_name,
+      pattern_type,
+      limit = 10,
+      query
+    } = input
+
+    logger.debug(
+      { project_name, pattern_type, limit, has_query: !!query },
+      'Getting patterns'
+    )
+
+    if (!isServicesInitialized()) {
+      throw new McpError(
+        ErrorCode.InternalError,
+        'Memory service not initialized. The server may still be starting up.'
+      )
+    }
+
+    const memory = getMemoryService()
+
+    let results: Record<string, unknown>[]
+
+    if (query) {
+      results = await memory.searchPatterns(query, {
+        project: project_name,
+        limit,
+        minSimilarity: 0.5
+      })
+    } else {
+      results = await memory.getPatterns(project_name, {
+        limit,
+        pattern_type
+      })
+    }
+
+    if (results.length === 0) {
+      const message = pattern_type
+        ? `No patterns of type "${pattern_type}" found${project_name ? ` for project "${project_name}"` : ''}.`
+        : `No patterns found${project_name ? ` for project "${project_name}"` : ''}.`
+
+      logger.warn({ project_name, pattern_type }, 'No patterns found')
+
+      return ResponseFormatter.text(
+        `No patterns found.\n\n${message}\n\nTips:\n` +
+        `- Use \`recognize_pattern\` to document patterns you discover\n` +
+        `- Review project documentation for documented solutions\n` +
+        `- Check project standards for best practices\n`
+      )
+    }
+
+    logger.info(
+      { project_name, pattern_type, count: results.length },
+      'Patterns retrieved successfully'
+    )
+
+    const projectInfo = project_name ? ` for **${project_name}**` : ''
+    const typeInfo = pattern_type ? ` of type **${pattern_type}**` : ''
+
+    let response = `Found **${results.length} pattern(s)${projectInfo}${typeInfo}:\n\n`
+
+    results.forEach((pattern: Record<string, unknown>, index: number) => {
+      const num = index + 1
+      const metadata = (pattern.metadata || {}) as Record<string, unknown>
+
+      response += `## ${num}. ${metadata.pattern_type}\n\n`
+      response += `**ID:** ${pattern.id}\n`
+      response += `**Confidence:** ${Number(metadata.confidence || 0).toFixed(2)}\n`
+      response += `**Project:** ${metadata.project}\n\n`
+      response += `**Description:** ${metadata.description}\n\n`
+
+      if (metadata.example) {
+        response += `**Example:**\n\`\`\`\n${metadata.example}\n\`\`\`\n\n`
+      }
+
+      if (metadata.context) {
+        response += `**Context:** ${metadata.context}\n\n`
+      }
+
+      response += `**First Seen:** ${new Date(metadata.first_seen as string).toLocaleDateString()}\n`
+      response += `**Last Seen:** ${new Date(metadata.last_seen as string).toLocaleDateString()}\n\n`
+      response += `**Occurrences:** ${metadata.occurrences}\n\n`
+
+      if (index < results.length) {
+        response += `---\n\n`
+      }
+    })
+
+    if (results.length === 0) {
+      response += `No patterns documented yet.\n\n` +
+        `Use \`recognize_pattern\` to document patterns as you discover them.\n`
+    }
+
+    response += `\n**Next Steps:**\n`
+    response += `- Apply these patterns to your current work\n`
+    response += `- Recognize new patterns as you discover solutions\n`
+
+    // Add memory indicator to show Claude Brain helped
+    const statsLine = formatMemoryStats({ patterns: results.length })
+    return ResponseFormatter.text(withMemoryIndicator(response, results.length) + '\n\n' + statsLine)
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'get_patterns', args })
+
+    // Provide detailed error messages based on error type
+    if (error instanceof Error) {
+      if (error.message.includes('ChromaDB') || error.message.includes('collection')) {
+        throw new McpError(
+          ErrorCode.InternalError,
+          `ChromaDB pattern retrieval failed: ${error.message}\n\n` +
+          `This may be caused by:\n` +
+          `- ChromaDB not running (check if ChromaDB server is started)\n` +
+          `- Collections not initialized (try restarting the MCP server)\n` +
+          `- Connection issues (verify ChromaDB configuration)\n\n` +
+          `Error details: ${error.stack || error.message}`
+        )
+      }
+      if (error.message.includes('not initialized')) {
+        throw new McpError(
+          ErrorCode.InternalError,
+          `Memory service not initialized properly.\n\n` +
+          `The server may still be starting up. Please wait a moment and try again.\n` +
+          `If the issue persists, restart the MCP server.`
+        )
+      }
+      if (error.message.includes('requires ChromaDB')) {
+        throw new McpError(
+          ErrorCode.InternalError,
+          `Pattern retrieval requires ChromaDB backend.\n\n` +
+          `ChromaDB may not be enabled or may have failed to initialize.\n` +
+          `Check your configuration and ensure ChromaDB is running.`
+        )
+      }
+    }
+
+    throw error
+  }
+}