claude-brain 0.30.2 → 0.30.3

package/src/server/handlers/tools/smart-context.ts

@@ -1,146 +1,146 @@
-/**
- * Smart Context Handler
- * Gets project context + proactive memory recall based on current task
- */
-
-import type { Logger } from 'pino'
-import type { ToolResponse } from '@/tools/types'
-import { getContextService, getPhase12Service, getMemoryService, 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'
-import { SmartContextSchema } from './schemas'
-
-export async function handleSmartContext(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, SmartContextSchema)
-    const { project_name, current_task, min_similarity } = input
-
-    logger.debug({
-      project_name,
-      current_task: current_task.slice(0, 50),
-      min_similarity
-    }, 'Smart context request')
-
-    if (!isServicesInitialized()) {
-      throw new McpError(
-        ErrorCode.InternalError,
-        'Services not initialized'
-      )
-    }
-
-    const contextService = getContextService()
-    const phase12 = getPhase12Service()
-
-    // Set current project in Phase 12 (use project name directly since we're getting it from user)
-    // The autoContext will be updated when context is loaded below
-
-    // Get base project context
-    const context = await contextService.getContext(project_name, {
-      includeMemories: false, // We'll use Phase 12 for smarter recall
-      includeProgress: true,
-      includeStandards: true,
-      maxTokens: 6000,
-      relevanceThreshold: 0.5
-    })
-
-    // Process with Phase 12 for proactive recall
-    const phase12Result = await phase12.processMessage(current_task, project_name)
-
-    // If Phase12's gated recall found nothing, do direct search (like recall_similar)
-    if (!phase12Result.recalledMemories || phase12Result.recalledMemories.memories.length === 0) {
-      try {
-        const memory = getMemoryService()
-        const directRecall = await memory.searchRaw(current_task, {
-          project: project_name,
-          limit: 5,
-          minSimilarity: min_similarity || 0.3
-        })
-        if (directRecall.length > 0) {
-          phase12Result.recalledMemories = {
-            query: current_task,
-            memories: directRecall,
-            relevanceScore: directRecall.reduce((sum: number, m: any) => sum + (m.similarity || 0), 0) / directRecall.length,
-            triggeredBy: ['direct-search-fallback']
-          }
-        }
-      } catch (e) {
-        logger.debug({ error: e }, 'Direct recall fallback failed, continuing without')
-      }
-    }
-
-    // Format base context
-    const formattedContext = contextService.formatter.format(context)
-
-    // Build response
-    const parts: string[] = []
-    parts.push(formattedContext)
-    parts.push('\n---\n')
-    parts.push('## 🧠 Intelligent Context (Phase 12)\n')
-
-    // Add proactive recall results
-    if (phase12Result.recalledMemories && phase12Result.recalledMemories.memories.length > 0) {
-      parts.push('### Relevant Past Decisions\n')
-      parts.push(`*Automatically recalled for: "${current_task.slice(0, 50)}${current_task.length > 50 ? '...' : ''}"*\n`)
-
-      for (const memory of phase12Result.recalledMemories.memories) {
-        const similarity = Math.round(memory.similarity * 100)
-        parts.push(`\n**[${similarity}% match]** ${memory.decision?.decision || memory.memory.content.slice(0, 100)}`)
-        if (memory.decision?.reasoning) {
-          parts.push(`\n- *Reasoning:* ${memory.decision.reasoning}`)
-        }
-        if (memory.decision?.context) {
-          parts.push(`\n- *Context:* ${memory.decision.context}`)
-        }
-      }
-      parts.push('\n')
-    } else {
-      parts.push('*No relevant past decisions found for this task.*\n')
-      parts.push('*Tip: As you make decisions, use `remember_decision` or `auto_remember` to build up your knowledge base.*\n')
-    }
-
-    // Add extracted knowledge if any
-    if (phase12Result.extractedKnowledge && phase12Result.extractedKnowledge.length > 0) {
-      parts.push('\n### Extracted Knowledge\n')
-      for (const k of phase12Result.extractedKnowledge) {
-        parts.push(`- **${k.type}:** ${k.content.slice(0, 100)}`)
-      }
-    }
-
-    const recalledCount = phase12Result.recalledMemories?.memories.length || 0
-    const knowledgeCount = phase12Result.extractedKnowledge?.length || 0
-
-    logger.info({
-      project_name,
-      recalledCount,
-      knowledgeCount
-    }, 'Smart context retrieved')
-
-    const content = parts.join('\n')
-
-    // Add memory indicator if we found helpful memories
-    if (recalledCount > 0) {
-      const statsLine = formatMemoryStats({ recalled: recalledCount })
-      return ResponseFormatter.text(withMemoryIndicator(content, recalledCount) + '\n\n' + statsLine)
-    }
-
-    return ResponseFormatter.text(content)
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'smart_context', args })
-
-    if (error instanceof McpError) {
-      throw error
-    }
-
-    throw new McpError(
-      ErrorCode.InternalError,
-      `Smart context failed: ${error instanceof Error ? error.message : 'Unknown error'}`
-    )
-  }
-}
+/**
+ * Smart Context Handler
+ * Gets project context + proactive memory recall based on current task
+ */
+
+import type { Logger } from 'pino'
+import type { ToolResponse } from '@/tools/types'
+import { getContextService, getPhase12Service, getMemoryService, 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'
+import { SmartContextSchema } from './schemas'
+
+export async function handleSmartContext(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, SmartContextSchema)
+    const { project_name, current_task, min_similarity } = input
+
+    logger.debug({
+      project_name,
+      current_task: current_task.slice(0, 50),
+      min_similarity
+    }, 'Smart context request')
+
+    if (!isServicesInitialized()) {
+      throw new McpError(
+        ErrorCode.InternalError,
+        'Services not initialized'
+      )
+    }
+
+    const contextService = getContextService()
+    const phase12 = getPhase12Service()
+
+    // Set current project in Phase 12 (use project name directly since we're getting it from user)
+    // The autoContext will be updated when context is loaded below
+
+    // Get base project context
+    const context = await contextService.getContext(project_name, {
+      includeMemories: false, // We'll use Phase 12 for smarter recall
+      includeProgress: true,
+      includeStandards: true,
+      maxTokens: 6000,
+      relevanceThreshold: 0.5
+    })
+
+    // Process with Phase 12 for proactive recall
+    const phase12Result = await phase12.processMessage(current_task, project_name)
+
+    // If Phase12's gated recall found nothing, do direct search (like recall_similar)
+    if (!phase12Result.recalledMemories || phase12Result.recalledMemories.memories.length === 0) {
+      try {
+        const memory = getMemoryService()
+        const directRecall = await memory.searchRaw(current_task, {
+          project: project_name,
+          limit: 5,
+          minSimilarity: min_similarity || 0.3
+        })
+        if (directRecall.length > 0) {
+          phase12Result.recalledMemories = {
+            query: current_task,
+            memories: directRecall,
+            relevanceScore: directRecall.reduce((sum: number, m: Record<string, unknown>) => sum + ((m.similarity as number) || 0), 0) / directRecall.length,
+            triggeredBy: ['direct-search-fallback']
+          }
+        }
+      } catch (e) {
+        logger.debug({ error: e }, 'Direct recall fallback failed, continuing without')
+      }
+    }
+
+    // Format base context
+    const formattedContext = contextService.formatter.format(context)
+
+    // Build response
+    const parts: string[] = []
+    parts.push(formattedContext)
+    parts.push('\n---\n')
+    parts.push('## 🧠 Intelligent Context (Phase 12)\n')
+
+    // Add proactive recall results
+    if (phase12Result.recalledMemories && phase12Result.recalledMemories.memories.length > 0) {
+      parts.push('### Relevant Past Decisions\n')
+      parts.push(`*Automatically recalled for: "${current_task.slice(0, 50)}${current_task.length > 50 ? '...' : ''}"*\n`)
+
+      for (const memory of phase12Result.recalledMemories.memories) {
+        const similarity = Math.round(memory.similarity * 100)
+        parts.push(`\n**[${similarity}% match]** ${memory.decision?.decision || memory.memory.content.slice(0, 100)}`)
+        if (memory.decision?.reasoning) {
+          parts.push(`\n- *Reasoning:* ${memory.decision.reasoning}`)
+        }
+        if (memory.decision?.context) {
+          parts.push(`\n- *Context:* ${memory.decision.context}`)
+        }
+      }
+      parts.push('\n')
+    } else {
+      parts.push('*No relevant past decisions found for this task.*\n')
+      parts.push('*Tip: As you make decisions, use `remember_decision` or `auto_remember` to build up your knowledge base.*\n')
+    }
+
+    // Add extracted knowledge if any
+    if (phase12Result.extractedKnowledge && phase12Result.extractedKnowledge.length > 0) {
+      parts.push('\n### Extracted Knowledge\n')
+      for (const k of phase12Result.extractedKnowledge) {
+        parts.push(`- **${k.type}:** ${k.content.slice(0, 100)}`)
+      }
+    }
+
+    const recalledCount = phase12Result.recalledMemories?.memories.length || 0
+    const knowledgeCount = phase12Result.extractedKnowledge?.length || 0
+
+    logger.info({
+      project_name,
+      recalledCount,
+      knowledgeCount
+    }, 'Smart context retrieved')
+
+    const content = parts.join('\n')
+
+    // Add memory indicator if we found helpful memories
+    if (recalledCount > 0) {
+      const statsLine = formatMemoryStats({ recalled: recalledCount })
+      return ResponseFormatter.text(withMemoryIndicator(content, recalledCount) + '\n\n' + statsLine)
+    }
+
+    return ResponseFormatter.text(content)
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'smart_context', args })
+
+    if (error instanceof McpError) {
+      throw error
+    }
+
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Smart context failed: ${error instanceof Error ? error.message : 'Unknown error'}`
+    )
+  }
+}

package/src/server/handlers/tools/update-progress.ts

@@ -1,131 +1,131 @@
-/**
- * Update Progress Handler
- * Updates project progress tracking with completed tasks and next steps
- */
-
-import type { Logger } from 'pino'
-import type { ToolResponse } from '@/tools/types'
-import { getVaultService, getContextService } 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 { UpdateProgressSchema } from './schemas'
-
-export async function handleUpdateProgress(
-  args: unknown,
-  logger: Logger
-): Promise<ToolResponse> {
-  try {
-    const input = ToolValidator.validate(args, UpdateProgressSchema)
-    const { project_name, completed_task, next_steps, notes } = input
-
-    logger.debug({
-      project_name,
-      completed_task,
-      next_steps,
-      hasNotes: !!notes
-    }, 'Updating progress')
-
-    const vault = getVaultService()
-    const context = getContextService()
-
-    const projectPaths = vault.getProjectPaths(project_name)
-
-    try {
-      await vault.reader.readMarkdownFile(projectPaths.progress)
-    } catch {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        `Project "${project_name}" not found. Progress file does not exist. Use list_projects to see available projects.`
-      )
-    }
-
-    const taskId = generateTaskId(completed_task)
-
-    // Step 1: Append completed task to progress file
-    await context.progress.addCompletedTask(project_name, {
-      id: taskId,
-      title: completed_task,
-      status: 'done',
-      completedAt: new Date()
-    })
-
-    // Step 2: Read file bypassing cache, update next steps, write content
-    const progressFile = await vault.reader.readMarkdownFile(projectPaths.progress, false)
-    const updatedContent = updateNextStepsSection(progressFile.content, next_steps)
-
-    await vault.writer.writeMarkdownFile(
-      projectPaths.progress,
-      progressFile.frontmatter,
-      updatedContent,
-      { createBackup: true }
-    )
-
-    // Step 3: Notes appended if present
-    if (notes) {
-      const notesEntry = `\n## Notes (${new Date().toLocaleDateString()})\n${notes}\n`
-      await vault.writer.appendContent(projectPaths.progress, notesEntry)
-    }
-
-    // Step 4: Calculate and update frontmatter LAST (so nothing overwrites it)
-    const progressState = await context.progress.getProgress(project_name)
-    const totalTasks = progressState.completedTasks.length + progressState.currentTasks.length
-    const completionPercentage = totalTasks > 0
-      ? Math.round((progressState.completedTasks.length / totalTasks) * 100)
-      : 0
-
-    await context.progress.updateProgress(project_name, {
-      completionPercentage,
-      currentPhase: completionPercentage >= 100 ? 'complete' : 'active'
-    })
-
-    // Step 5: Invalidate cache so subsequent reads get fresh data
-    vault.reader.invalidateCache(projectPaths.progress)
-    context.invalidateContext(project_name)
-
-    logger.info({ projectName: project_name, taskId }, 'Progress updated successfully')
-
-    return ResponseFormatter.text(
-      `✅ Progress updated for ${project_name}\n\n` +
-      `**Completed:** ${completed_task}\n` +
-      `**Next Steps:** ${next_steps}\n` +
-      (notes ? `**Notes:** ${notes}\n` : '') +
-      `\nThe progress has been saved to your vault and context cache has been refreshed.`
-    )
-
-  } catch (error) {
-    ErrorHandler.logError(logger, error, { tool: 'update_progress', args })
-
-    if (error instanceof McpError) {
-      throw error
-    }
-
-    throw new McpError(
-      ErrorCode.InternalError,
-      `Failed to update progress: ${error instanceof Error ? error.message : 'Unknown error'}`
-    )
-  }
-}
-
-function generateTaskId(title: string): string {
-  return title
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-+|-+$/g, '')
-    .slice(0, 50)
-}
-
-function updateNextStepsSection(content: string, nextSteps: string): string {
-  const nextStepsRegex = /##\s+Next Steps\s+(.+?)(?=\n##|$)/s
-  const match = nextStepsRegex.exec(content)
-
-  if (match) {
-    return content.replace(
-      nextStepsRegex,
-      `## Next Steps\n\n- ${nextSteps}\n`
-    )
-  } else {
-    return content + `\n\n## Next Steps\n\n- ${nextSteps}\n`
-  }
-}
+/**
+ * Update Progress Handler
+ * Updates project progress tracking with completed tasks and next steps
+ */
+
+import type { Logger } from 'pino'
+import type { ToolResponse } from '@/tools/types'
+import { getVaultService, getContextService } 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 { UpdateProgressSchema } from './schemas'
+
+export async function handleUpdateProgress(
+  args: unknown,
+  logger: Logger
+): Promise<ToolResponse> {
+  try {
+    const input = ToolValidator.validate(args, UpdateProgressSchema)
+    const { project_name, completed_task, next_steps, notes } = input
+
+    logger.debug({
+      project_name,
+      completed_task,
+      next_steps,
+      hasNotes: !!notes
+    }, 'Updating progress')
+
+    const vault = getVaultService()
+    const context = getContextService()
+
+    const projectPaths = vault.getProjectPaths(project_name)
+
+    try {
+      await vault.reader.readMarkdownFile(projectPaths.progress)
+    } catch {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        `Project "${project_name}" not found. Progress file does not exist. Use list_projects to see available projects.`
+      )
+    }
+
+    const taskId = generateTaskId(completed_task)
+
+    // Step 1: Append completed task to progress file
+    await context.progress.addCompletedTask(project_name, {
+      id: taskId,
+      title: completed_task,
+      status: 'done',
+      completedAt: new Date()
+    })
+
+    // Step 2: Read file bypassing cache, update next steps, write content
+    const progressFile = await vault.reader.readMarkdownFile(projectPaths.progress, false)
+    const updatedContent = updateNextStepsSection(progressFile.content, next_steps)
+
+    await vault.writer.writeMarkdownFile(
+      projectPaths.progress,
+      progressFile.frontmatter,
+      updatedContent,
+      { createBackup: true }
+    )
+
+    // Step 3: Notes appended if present
+    if (notes) {
+      const notesEntry = `\n## Notes (${new Date().toLocaleDateString()})\n${notes}\n`
+      await vault.writer.appendContent(projectPaths.progress, notesEntry)
+    }
+
+    // Step 4: Calculate and update frontmatter LAST (so nothing overwrites it)
+    const progressState = await context.progress.getProgress(project_name)
+    const totalTasks = progressState.completedTasks.length + progressState.currentTasks.length
+    const completionPercentage = totalTasks > 0
+      ? Math.round((progressState.completedTasks.length / totalTasks) * 100)
+      : 0
+
+    await context.progress.updateProgress(project_name, {
+      completionPercentage,
+      currentPhase: completionPercentage >= 100 ? 'complete' : 'active'
+    })
+
+    // Step 5: Invalidate cache so subsequent reads get fresh data
+    vault.reader.invalidateCache(projectPaths.progress)
+    context.invalidateContext(project_name)
+
+    logger.info({ projectName: project_name, taskId }, 'Progress updated successfully')
+
+    return ResponseFormatter.text(
+      `✅ Progress updated for ${project_name}\n\n` +
+      `**Completed:** ${completed_task}\n` +
+      `**Next Steps:** ${next_steps}\n` +
+      (notes ? `**Notes:** ${notes}\n` : '') +
+      `\nThe progress has been saved to your vault and context cache has been refreshed.`
+    )
+
+  } catch (error) {
+    ErrorHandler.logError(logger, error, { tool: 'update_progress', args })
+
+    if (error instanceof McpError) {
+      throw error
+    }
+
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Failed to update progress: ${error instanceof Error ? error.message : 'Unknown error'}`
+    )
+  }
+}
+
+function generateTaskId(title: string): string {
+  return title
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 50)
+}
+
+function updateNextStepsSection(content: string, nextSteps: string): string {
+  const nextStepsRegex = /##\s+Next Steps\s+(.+?)(?=\n##|$)/s
+  const match = nextStepsRegex.exec(content)
+
+  if (match) {
+    return content.replace(
+      nextStepsRegex,
+      `## Next Steps\n\n- ${nextSteps}\n`
+    )
+  } else {
+    return content + `\n\n## Next Steps\n\n- ${nextSteps}\n`
+  }
+}