claude-brain 0.15.2 → 0.16.0

package/src/server/handlers/tools/list-episodes.ts

@@ -1,90 +1,90 @@
-/**
- * List Episodes Handler
- * Lists recent episodes, optionally filtered by 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 { ListEpisodesSchema } from './schemas'
-
-export async function handleListEpisodes(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, ListEpisodesSchema)
-    const { project_name, limit, status } = input
-
-    logger.debug({ projectName: project_name, limit, status }, 'Listing episodes')
-
-    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'
-      )
-    }
-
-    const episodes = await episodeService.getRecentEpisodes(project_name, limit)
-
-    // Filter by status if specified
-    const filtered = status
-      ? episodes.filter(ep => ep.status === status)
-      : episodes
-
-    const formatted = filtered.map(ep => ({
-      id: ep.id,
-      project: ep.project,
-      status: ep.status,
-      started_at: ep.started_at,
-      ended_at: ep.ended_at,
-      message_count: ep.message_count,
-      token_count: ep.token_count,
-      summary_brief: ep.summary?.brief,
-      key_topics: ep.summary?.key_topics,
-      related_decisions_count: ep.related_decisions.length,
-      related_patterns_count: ep.related_patterns.length
-    }))
-
-    logger.info({ count: formatted.length }, 'Episodes listed')
-
-    return ResponseFormatter.json({
-      episodes: formatted,
-      total: formatted.length,
-      project: project_name || 'all'
-    }, 'Episodes')
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'list_episodes', args })
-
-    if (error instanceof McpError) {
-      throw error
-    }
-
-    throw new McpError(
-      ErrorCode.InternalError,
-      `Failed to list episodes: ${error instanceof Error ? error.message : 'Unknown error'}`
-    )
-  }
-}
+/**
+ * List Episodes Handler
+ * Lists recent episodes, optionally filtered by 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 { ListEpisodesSchema } from './schemas'
+
+export async function handleListEpisodes(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, ListEpisodesSchema)
+    const { project_name, limit, status } = input
+
+    logger.debug({ projectName: project_name, limit, status }, 'Listing episodes')
+
+    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'
+      )
+    }
+
+    const episodes = await episodeService.getRecentEpisodes(project_name, limit)
+
+    // Filter by status if specified
+    const filtered = status
+      ? episodes.filter(ep => ep.status === status)
+      : episodes
+
+    const formatted = filtered.map(ep => ({
+      id: ep.id,
+      project: ep.project,
+      status: ep.status,
+      started_at: ep.started_at,
+      ended_at: ep.ended_at,
+      message_count: ep.message_count,
+      token_count: ep.token_count,
+      summary_brief: ep.summary?.brief,
+      key_topics: ep.summary?.key_topics,
+      related_decisions_count: ep.related_decisions.length,
+      related_patterns_count: ep.related_patterns.length
+    }))
+
+    logger.info({ count: formatted.length }, 'Episodes listed')
+
+    return ResponseFormatter.json({
+      episodes: formatted,
+      total: formatted.length,
+      project: project_name || 'all'
+    }, 'Episodes')
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'list_episodes', args })
+
+    if (error instanceof McpError) {
+      throw error
+    }
+
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Failed to list episodes: ${error instanceof Error ? error.message : 'Unknown error'}`
+    )
+  }
+}

package/src/server/handlers/tools/list-projects.ts

@@ -1,125 +1,125 @@
-/**
- * List Projects Handler
- * Lists all available projects in the Obsidian vault
- */
-
-import type { Logger } from 'pino'
-import type { ToolResponse } from '@/tools/types'
-import { getVaultService } 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 { ListProjectsSchema } from './schemas'
-
-export async function handleListProjects(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, ListProjectsSchema)
-    const { status_filter } = input
-
-    logger.debug({ status_filter }, 'Listing projects')
-
-    const vault = getVaultService()
-
-    const projectDirs = await vault.listProjects()
-
-    if (projectDirs.length === 0) {
-      return ResponseFormatter.text(
-        `No projects found in your vault.\n\n` +
-        `To create a project, add a directory under:\n` +
-        `${vault.paths.projects}/your-project-name/\n\n` +
-        `Each project should have:\n` +
-        `- context.md (project overview)\n` +
-        `- progress.md (current status)\n` +
-        `- decisions.md (decision log)\n` +
-        `- standards.md (coding standards)`
-      )
-    }
-
-    const projects = []
-
-    for (const dir of projectDirs) {
-      try {
-        const metadata = await vault.getProjectMetadata(dir)
-
-        if (status_filter !== 'all' && metadata.status !== status_filter) {
-          continue
-        }
-
-        projects.push({
-          name: dir,
-          status: metadata.status,
-          techStack: metadata.techStack,
-          created: undefined,
-          updated: undefined,
-          tags: [],
-          currentPhase: metadata.currentPhase,
-          completionPercentage: metadata.completionPercentage
-        })
-
-      } catch (error) {
-        logger.warn({ project: dir }, 'Skipping project with invalid context')
-      }
-    }
-
-    if (projects.length === 0) {
-      return ResponseFormatter.text(
-        `No projects found with status: ${status_filter}\n\n` +
-        `Try changing the status_filter or use "all" to see all projects.`
-      )
-    }
-
-    projects.sort((a, b) => {
-      const dateA = new Date(a.updated || 0)
-      const dateB = new Date(b.updated || 0)
-      return dateB.getTime() - dateA.getTime()
-    })
-
-    let output = `# Available Projects (${projects.length})\n\n`
-
-    for (const project of projects) {
-      output += `## ${project.name}\n\n`
-      output += `**Status:** ${project.status}\n`
-      output += `**Phase:** ${project.currentPhase}\n`
-      output += `**Completion:** ${project.completionPercentage}%\n`
-
-      if (project.techStack && project.techStack.length > 0) {
-        output += `**Tech Stack:** ${project.techStack.join(', ')}\n`
-      }
-
-      if (project.tags && project.tags.length > 0) {
-        output += `**Tags:** ${project.tags.join(', ')}\n`
-      }
-
-      if (project.updated) {
-        output += `**Last Updated:** ${project.updated}\n`
-      }
-
-      output += '\n'
-    }
-
-    output += `---\n\n`
-    output += `💡 **Next Steps:**\n`
-    output += `- Use \`get_project_context\` with any project name to get full context\n`
-    output += `- Use \`get_code_standards\` to see coding standards for a project\n`
-
-    logger.info({ count: projects.length }, 'Projects listed')
-
-    return ResponseFormatter.text(output)
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'list_projects', args })
-
-    if (error instanceof McpError) {
-      throw error
-    }
-
-    throw new McpError(
-      ErrorCode.InternalError,
-      `Failed to list projects: ${error instanceof Error ? error.message : 'Unknown error'}`
-    )
-  }
-}
+/**
+ * List Projects Handler
+ * Lists all available projects in the Obsidian vault
+ */
+
+import type { Logger } from 'pino'
+import type { ToolResponse } from '@/tools/types'
+import { getVaultService } 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 { ListProjectsSchema } from './schemas'
+
+export async function handleListProjects(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, ListProjectsSchema)
+    const { status_filter } = input
+
+    logger.debug({ status_filter }, 'Listing projects')
+
+    const vault = getVaultService()
+
+    const projectDirs = await vault.listProjects()
+
+    if (projectDirs.length === 0) {
+      return ResponseFormatter.text(
+        `No projects found in your vault.\n\n` +
+        `To create a project, add a directory under:\n` +
+        `${vault.paths.projects}/your-project-name/\n\n` +
+        `Each project should have:\n` +
+        `- context.md (project overview)\n` +
+        `- progress.md (current status)\n` +
+        `- decisions.md (decision log)\n` +
+        `- standards.md (coding standards)`
+      )
+    }
+
+    const projects = []
+
+    for (const dir of projectDirs) {
+      try {
+        const metadata = await vault.getProjectMetadata(dir)
+
+        if (status_filter !== 'all' && metadata.status !== status_filter) {
+          continue
+        }
+
+        projects.push({
+          name: dir,
+          status: metadata.status,
+          techStack: metadata.techStack,
+          created: undefined,
+          updated: undefined,
+          tags: [],
+          currentPhase: metadata.currentPhase,
+          completionPercentage: metadata.completionPercentage
+        })
+
+      } catch (error) {
+        logger.warn({ project: dir }, 'Skipping project with invalid context')
+      }
+    }
+
+    if (projects.length === 0) {
+      return ResponseFormatter.text(
+        `No projects found with status: ${status_filter}\n\n` +
+        `Try changing the status_filter or use "all" to see all projects.`
+      )
+    }
+
+    projects.sort((a, b) => {
+      const dateA = new Date(a.updated || 0)
+      const dateB = new Date(b.updated || 0)
+      return dateB.getTime() - dateA.getTime()
+    })
+
+    let output = `# Available Projects (${projects.length})\n\n`
+
+    for (const project of projects) {
+      output += `## ${project.name}\n\n`
+      output += `**Status:** ${project.status}\n`
+      output += `**Phase:** ${project.currentPhase}\n`
+      output += `**Completion:** ${project.completionPercentage}%\n`
+
+      if (project.techStack && project.techStack.length > 0) {
+        output += `**Tech Stack:** ${project.techStack.join(', ')}\n`
+      }
+
+      if (project.tags && project.tags.length > 0) {
+        output += `**Tags:** ${project.tags.join(', ')}\n`
+      }
+
+      if (project.updated) {
+        output += `**Last Updated:** ${project.updated}\n`
+      }
+
+      output += '\n'
+    }
+
+    output += `---\n\n`
+    output += `💡 **Next Steps:**\n`
+    output += `- Use \`get_project_context\` with any project name to get full context\n`
+    output += `- Use \`get_code_standards\` to see coding standards for a project\n`
+
+    logger.info({ count: projects.length }, 'Projects listed')
+
+    return ResponseFormatter.text(output)
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'list_projects', args })
+
+    if (error instanceof McpError) {
+      throw error
+    }
+
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Failed to list projects: ${error instanceof Error ? error.message : 'Unknown error'}`
+    )
+  }
+}

package/src/server/handlers/tools/rate-memory.ts

@@ -1,101 +1,101 @@
-/**
- * Rate Memory Handler
- * Collects feedback on retrieved memories for adaptive learning
- */
-
-import type { Logger } from 'pino'
-import type { ToolResponse } from '@/tools/types'
-import { getRetrievalService, 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 { RateMemorySchema } from './schemas'
-
-export async function handleRateMemory(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, RateMemorySchema)
-    const { memory_id, rating, query, was_used, feedback_text, project_name } = input
-
-    logger.debug({
-      memoryId: memory_id,
-      rating,
-      queryLength: query.length,
-      wasUsed: was_used
-    }, 'Rating memory')
-
-    if (!isServicesInitialized()) {
-      throw new McpError(
-        ErrorCode.InternalError,
-        'Services not initialized. The server may still be starting up.'
-      )
-    }
-
-    const retrieval = getRetrievalService()
-
-    // Check if feedback is enabled
-    if (!retrieval) {
-      return ResponseFormatter.text(
-        '## Memory Feedback Not Available\n\n' +
-        'Memory rating requires the retrieval feedback system, which depends on ChromaDB.\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 `RETRIEVAL_FEEDBACK_ENABLED=true` or `retrieval.feedback.enabled=true` in config\n\n' +
-        '**Note:** Your rating was not lost — the memory system will still function without feedback. ' +
-        'Feedback helps improve retrieval quality over time by learning which memories are most useful.'
-      )
-    }
-
-    // Store the feedback
-    const feedbackId = await retrieval.storeFeedback({
-      memory_id,
-      rating,
-      query,
-      was_used,
-      feedback_text,
-      project_name
-    })
-
-    // Get rating description
-    const ratingDescriptions: Record<number, string> = {
-      1: 'not helpful',
-      2: 'slightly helpful',
-      3: 'moderately helpful',
-      4: 'helpful',
-      5: 'very helpful'
-    }
-
-    logger.info({
-      feedbackId,
-      memoryId: memory_id,
-      rating
-    }, 'Memory feedback stored')
-
-    return ResponseFormatter.success(
-      `Feedback recorded: Memory ${memory_id} rated as ${rating}/5 (${ratingDescriptions[rating]})`,
-      {
-        feedbackId,
-        memoryId: memory_id,
-        rating,
-        wasUsed: was_used,
-        project: project_name || 'none'
-      }
-    )
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'rate_memory', args })
-
-    if (error instanceof McpError) {
-      throw error
-    }
-
-    throw new McpError(
-      ErrorCode.InternalError,
-      `Failed to rate memory: ${error instanceof Error ? error.message : 'Unknown error'}`
-    )
-  }
-}
+/**
+ * Rate Memory Handler
+ * Collects feedback on retrieved memories for adaptive learning
+ */
+
+import type { Logger } from 'pino'
+import type { ToolResponse } from '@/tools/types'
+import { getRetrievalService, 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 { RateMemorySchema } from './schemas'
+
+export async function handleRateMemory(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, RateMemorySchema)
+    const { memory_id, rating, query, was_used, feedback_text, project_name } = input
+
+    logger.debug({
+      memoryId: memory_id,
+      rating,
+      queryLength: query.length,
+      wasUsed: was_used
+    }, 'Rating memory')
+
+    if (!isServicesInitialized()) {
+      throw new McpError(
+        ErrorCode.InternalError,
+        'Services not initialized. The server may still be starting up.'
+      )
+    }
+
+    const retrieval = getRetrievalService()
+
+    // Check if feedback is enabled
+    if (!retrieval) {
+      return ResponseFormatter.text(
+        '## Memory Feedback Not Available\n\n' +
+        'Memory rating requires the retrieval feedback system, which depends on ChromaDB.\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 `RETRIEVAL_FEEDBACK_ENABLED=true` or `retrieval.feedback.enabled=true` in config\n\n' +
+        '**Note:** Your rating was not lost — the memory system will still function without feedback. ' +
+        'Feedback helps improve retrieval quality over time by learning which memories are most useful.'
+      )
+    }
+
+    // Store the feedback
+    const feedbackId = await retrieval.storeFeedback({
+      memory_id,
+      rating,
+      query,
+      was_used,
+      feedback_text,
+      project_name
+    })
+
+    // Get rating description
+    const ratingDescriptions: Record<number, string> = {
+      1: 'not helpful',
+      2: 'slightly helpful',
+      3: 'moderately helpful',
+      4: 'helpful',
+      5: 'very helpful'
+    }
+
+    logger.info({
+      feedbackId,
+      memoryId: memory_id,
+      rating
+    }, 'Memory feedback stored')
+
+    return ResponseFormatter.success(
+      `Feedback recorded: Memory ${memory_id} rated as ${rating}/5 (${ratingDescriptions[rating]})`,
+      {
+        feedbackId,
+        memoryId: memory_id,
+        rating,
+        wasUsed: was_used,
+        project: project_name || 'none'
+      }
+    )
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'rate_memory', args })
+
+    if (error instanceof McpError) {
+      throw error
+    }
+
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Failed to rate memory: ${error instanceof Error ? error.message : 'Unknown error'}`
+    )
+  }
+}