claude-brain 0.15.2 → 0.16.0

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

@@ -1,103 +1,103 @@
-/**
- * Get Episode Handler
- * Retrieves an episode by ID or the active episode for a project
- */
-
-import type { Logger } from 'pino'
-import type { ToolResponse } from '@/tools/types'
-import { getEpisodeService, 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 { GetEpisodeSchema } from './schemas'
-
-export async function handleGetEpisode(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, GetEpisodeSchema)
-    const { episode_id, project_name } = input
-
-    logger.debug({ episodeId: episode_id, projectName: project_name }, 'Getting episode')
-
-    if (!isServicesInitialized()) {
-      throw new McpError(
-        ErrorCode.InternalError,
-        'Services not initialized. The server may still be starting up.'
-      )
-    }
-
-    const episodeService = getEpisodeService()
-    if (!episodeService) {
-      return ResponseFormatter.text(
-        '## Episodic Memory Not Available\n\n' +
-        'Episodic memory requires ChromaDB to track conversation sessions.\n\n' +
-        '**To enable:**\n' +
-        '- Start a ChromaDB server: `chroma run --path /path/to/data`\n' +
-        '- Set `CHROMA_URL=http://localhost:8000` in your environment\n' +
-        '- Set `knowledge.episodic.enabled=true` in config\n\n' +
-        '**Alternative tools that work without ChromaDB:**\n' +
-        '- `recall_similar` — search past decisions by semantic similarity\n' +
-        '- `get_patterns` — retrieve recognized patterns\n' +
-        '- `get_corrections` — retrieve lessons learned\n' +
-        '- `smart_context` — get full project context with memory recall'
-      )
-    }
-
-    if (episode_id) {
-      const episode = await episodeService.getEpisode(episode_id)
-      if (!episode) {
-        return ResponseFormatter.text(`Episode ${episode_id} not found.`)
-      }
-
-      return ResponseFormatter.json({
-        id: episode.id,
-        project: episode.project,
-        status: episode.status,
-        started_at: episode.started_at,
-        ended_at: episode.ended_at,
-        message_count: episode.message_count,
-        token_count: episode.token_count,
-        summary: episode.summary,
-        related_decisions: episode.related_decisions,
-        related_patterns: episode.related_patterns,
-        related_corrections: episode.related_corrections
-      }, 'Episode')
-    }
-
-    if (project_name) {
-      const active = episodeService.getActiveEpisode(project_name)
-      if (!active) {
-        return ResponseFormatter.text(`No active episode for project "${project_name}".`)
-      }
-
-      return ResponseFormatter.json({
-        id: active.id,
-        project: active.project,
-        status: active.status,
-        started_at: active.started_at,
-        message_count: active.message_count,
-        token_count: active.token_count,
-        related_decisions: active.related_decisions,
-        related_patterns: active.related_patterns,
-        related_corrections: active.related_corrections
-      }, 'Active Episode')
-    }
-
-    return ResponseFormatter.text('Provide either episode_id or project_name to get an episode.')
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'get_episode', args })
-
-    if (error instanceof McpError) {
-      throw error
-    }
-
-    throw new McpError(
-      ErrorCode.InternalError,
-      `Failed to get episode: ${error instanceof Error ? error.message : 'Unknown error'}`
-    )
-  }
-}
+/**
+ * Get Episode Handler
+ * Retrieves an episode by ID or the active episode for a project
+ */
+
+import type { Logger } from 'pino'
+import type { ToolResponse } from '@/tools/types'
+import { getEpisodeService, 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 { GetEpisodeSchema } from './schemas'
+
+export async function handleGetEpisode(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, GetEpisodeSchema)
+    const { episode_id, project_name } = input
+
+    logger.debug({ episodeId: episode_id, projectName: project_name }, 'Getting episode')
+
+    if (!isServicesInitialized()) {
+      throw new McpError(
+        ErrorCode.InternalError,
+        'Services not initialized. The server may still be starting up.'
+      )
+    }
+
+    const episodeService = getEpisodeService()
+    if (!episodeService) {
+      return ResponseFormatter.text(
+        '## Episodic Memory Not Available\n\n' +
+        'Episodic memory requires ChromaDB to track conversation sessions.\n\n' +
+        '**To enable:**\n' +
+        '- Start a ChromaDB server: `chroma run --path /path/to/data`\n' +
+        '- Set `CHROMA_URL=http://localhost:8000` in your environment\n' +
+        '- Set `knowledge.episodic.enabled=true` in config\n\n' +
+        '**Alternative tools that work without ChromaDB:**\n' +
+        '- `recall_similar` — search past decisions by semantic similarity\n' +
+        '- `get_patterns` — retrieve recognized patterns\n' +
+        '- `get_corrections` — retrieve lessons learned\n' +
+        '- `smart_context` — get full project context with memory recall'
+      )
+    }
+
+    if (episode_id) {
+      const episode = await episodeService.getEpisode(episode_id)
+      if (!episode) {
+        return ResponseFormatter.text(`Episode ${episode_id} not found.`)
+      }
+
+      return ResponseFormatter.json({
+        id: episode.id,
+        project: episode.project,
+        status: episode.status,
+        started_at: episode.started_at,
+        ended_at: episode.ended_at,
+        message_count: episode.message_count,
+        token_count: episode.token_count,
+        summary: episode.summary,
+        related_decisions: episode.related_decisions,
+        related_patterns: episode.related_patterns,
+        related_corrections: episode.related_corrections
+      }, 'Episode')
+    }
+
+    if (project_name) {
+      const active = episodeService.getActiveEpisode(project_name)
+      if (!active) {
+        return ResponseFormatter.text(`No active episode for project "${project_name}".`)
+      }
+
+      return ResponseFormatter.json({
+        id: active.id,
+        project: active.project,
+        status: active.status,
+        started_at: active.started_at,
+        message_count: active.message_count,
+        token_count: active.token_count,
+        related_decisions: active.related_decisions,
+        related_patterns: active.related_patterns,
+        related_corrections: active.related_corrections
+      }, 'Active Episode')
+    }
+
+    return ResponseFormatter.text('Provide either episode_id or project_name to get an episode.')
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'get_episode', args })
+
+    if (error instanceof McpError) {
+      throw error
+    }
+
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Failed to get episode: ${error instanceof Error ? error.message : 'Unknown error'}`
+    )
+  }
+}

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

@@ -1,158 +1,158 @@
-/**
- * Get Patterns Handler
- * Retrieves recognized patterns from ChromaDB semantic memory
- */
-
-import type { Logger } from 'pino'
-import type { GetPatternsInput, ToolResponse } from '@/tools/types'
-import { getMemoryService, getVaultService, isServicesInitialized } 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'
-
-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()
-    const vault = getVaultService()
-
-    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, getVaultService, isServicesInitialized } 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'
+
+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()
+    const vault = getVaultService()
+
+    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
+  }
+}

package/src/server/handlers/tools/get-phase12-status.ts

@@ -1,63 +1,63 @@
-/**
- * Get Phase 12 Status Handler
- * Shows status of intelligent automation features
- */
-
-import type { Logger } from 'pino'
-import type { ToolResponse } from '@/tools/types'
-import { getPhase12Service, isServicesInitialized } from '@/server/services'
-import { ResponseFormatter } from '@/server/utils/response-formatter'
-import { ErrorHandler } from '@/server/utils/error-handler'
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js'
-
-export async function handleGetPhase12Status(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    if (!isServicesInitialized()) {
-      throw new McpError(
-        ErrorCode.InternalError,
-        'Services not initialized'
-      )
-    }
-
-    const phase12 = getPhase12Service()
-
-    // Get status report
-    const report = phase12.getStatusReport()
-
-    // Add feature status
-    const parts: string[] = []
-    parts.push(report)
-    parts.push('\n---\n')
-    parts.push('## Available Phase 12 Tools\n')
-    parts.push('| Tool | Description |')
-    parts.push('|------|-------------|')
-    parts.push('| `smart_context` | Get context + auto-recall relevant memories |')
-    parts.push('| `auto_remember` | Auto-detect and save decisions from text |')
-    parts.push('| `get_phase12_status` | This status report |')
-    parts.push('\n')
-    parts.push('## How Automation Works\n')
-    parts.push('1. **Proactive Recall**: Questions trigger automatic memory search')
-    parts.push('2. **Decision Detection**: Phrases like "I recommend X because Y" are detected')
-    parts.push('3. **Auto-Save**: Decisions with >70% confidence are saved automatically')
-    parts.push('4. **Pattern Learning**: Your decision patterns are analyzed over time')
-
-    logger.info('Phase 12 status retrieved')
-
-    return ResponseFormatter.text(parts.join('\n'))
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'get_phase12_status', args })
-
-    if (error instanceof McpError) {
-      throw error
-    }
-
-    throw new McpError(
-      ErrorCode.InternalError,
-      `Failed to get Phase 12 status: ${error instanceof Error ? error.message : 'Unknown error'}`
-    )
-  }
-}
+/**
+ * Get Phase 12 Status Handler
+ * Shows status of intelligent automation features
+ */
+
+import type { Logger } from 'pino'
+import type { ToolResponse } from '@/tools/types'
+import { getPhase12Service, isServicesInitialized } from '@/server/services'
+import { ResponseFormatter } from '@/server/utils/response-formatter'
+import { ErrorHandler } from '@/server/utils/error-handler'
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js'
+
+export async function handleGetPhase12Status(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    if (!isServicesInitialized()) {
+      throw new McpError(
+        ErrorCode.InternalError,
+        'Services not initialized'
+      )
+    }
+
+    const phase12 = getPhase12Service()
+
+    // Get status report
+    const report = phase12.getStatusReport()
+
+    // Add feature status
+    const parts: string[] = []
+    parts.push(report)
+    parts.push('\n---\n')
+    parts.push('## Available Phase 12 Tools\n')
+    parts.push('| Tool | Description |')
+    parts.push('|------|-------------|')
+    parts.push('| `smart_context` | Get context + auto-recall relevant memories |')
+    parts.push('| `auto_remember` | Auto-detect and save decisions from text |')
+    parts.push('| `get_phase12_status` | This status report |')
+    parts.push('\n')
+    parts.push('## How Automation Works\n')
+    parts.push('1. **Proactive Recall**: Questions trigger automatic memory search')
+    parts.push('2. **Decision Detection**: Phrases like "I recommend X because Y" are detected')
+    parts.push('3. **Auto-Save**: Decisions with >70% confidence are saved automatically')
+    parts.push('4. **Pattern Learning**: Your decision patterns are analyzed over time')
+
+    logger.info('Phase 12 status retrieved')
+
+    return ResponseFormatter.text(parts.join('\n'))
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'get_phase12_status', args })
+
+    if (error instanceof McpError) {
+      throw error
+    }
+
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Failed to get Phase 12 status: ${error instanceof Error ? error.message : 'Unknown error'}`
+    )
+  }
+}