claude-brain 0.22.3 → 0.22.4

package/VERSION

@@ -1 +1 @@
-0.22.3
+0.22.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-brain",
-  "version": "0.22.3",
+  "version": "0.22.4",
   "description": "Local development assistant bridging Obsidian vaults with Claude Code via MCP",
   "type": "module",
   "main": "src/index.ts",

package/src/routing/response-filter.ts

@@ -15,6 +15,7 @@ export interface FilterableResult {
 }
 
 export interface FilteredResult {
+  id?: string
   content: string
   score: number
   source: string
@@ -74,8 +75,9 @@ export class ResponseFilter {
     // 5. Limit to 5 results
     filtered = filtered.slice(0, 5)
 
-    // 6. Add one-line relevance explanation per result
+    // 6. Add one-line relevance explanation per result (preserve id from metadata)
     return filtered.map(r => ({
+      id: (r.metadata as any)?.id || (r.metadata as any)?.decision_id,
       content: r.content,
       score: r.score,
       source: r.source,

package/src/routing/router.ts

@@ -39,6 +39,7 @@ const UPDATE_MIN_SIMILARITY = 0.3
 export interface BrainInput {
   message: string
   project?: string
+  action?: 'auto' | 'store' | 'recall' | 'update' | 'delete'
 }
 
 /** Recently stored decision for recency fast path (Bug 4 fix) */
@@ -84,17 +85,44 @@ export class BrainRouter {
   }
 
   async route(input: BrainInput): Promise<BrainResponse> {
-    const { message, project: inputProject } = input
+    const { message, project: inputProject, action } = input
 
-    // Classify intent
-    const classification = this.classifier.classify(message)
-    this.logger.debug({ intent: classification.primary, confidence: classification.confidence }, 'Intent classified')
-
-    // Extract entities
+    // Extract entities (needed for all paths)
     const entities = await this.entityExtractor.extract(message, inputProject)
     const project = entities.project || inputProject
     this.logger.debug({ project, technologies: entities.technologies }, 'Entities extracted')
 
+    // P1: Explicit action override — bypass intent classifier entirely
+    if (action && action !== 'auto') {
+      this.logger.debug({ action }, 'Using explicit action override')
+      try {
+        switch (action) {
+          case 'store':
+            return this.handleStoreThis(message, project, entities)
+          case 'recall':
+            return this.handleContextNeeded(message, project, entities)
+          case 'update':
+            return this.handleUpdateMemory(message, project, entities)
+          case 'delete':
+            return this.handleDeleteMemory(message, project, entities)
+          default:
+            break
+        }
+      } catch (error) {
+        this.logger.error({ error, action }, 'Router action override error')
+        return {
+          action: 'none',
+          summary: `Error processing ${action} request`,
+          content: `Failed to process: ${error instanceof Error ? error.message : 'Unknown error'}`,
+          relevantItems: 0
+        }
+      }
+    }
+
+    // Classify intent
+    const classification = this.classifier.classify(message)
+    this.logger.debug({ intent: classification.primary, confidence: classification.confidence }, 'Intent classified')
+
     // Route to handler
     try {
       switch (classification.primary) {
@@ -383,7 +411,20 @@ export class BrainRouter {
       })
     }
 
-    return this.responseFilter.synthesize(tiers, message, displayProject)
+    const response = this.responseFilter.synthesize(tiers, message, displayProject)
+
+    // P0: When no results found and message looks like a plain statement (not a question),
+    // add a hint that the user may have intended to store it
+    if (response.action === 'none' && response.relevantItems === 0) {
+      const isPlainStatement = message.length > 15 &&
+        !message.trim().endsWith('?') &&
+        message.split(/\s+/).length > 3
+      if (isPlainStatement) {
+        response.content += `\n\n**Tip:** If you meant to save this, try:\n- \`brain("Remember: ${message.slice(0, 60)}")\`\n- Or use \`action: "store"\` to force storage: \`brain({ message: "...", action: "store" })\``
+      }
+    }
+
+    return response
   }
 
   /**

package/src/server/handlers/tools/brain.ts

@@ -22,19 +22,20 @@ export async function handleBrain(
 ): Promise<ToolResponse> {
   try {
     const input = ToolValidator.validate(args, BrainSchema)
-    const { message, project } = input
+    const { message, project, action } = input
 
     logger.debug(
       {
         messageLength: message.length,
         project,
+        action,
         messagePreview: message.slice(0, 80)
       },
       'Brain tool called'
     )
 
     const router = getBrainRouter(logger)
-    const response = await router.route({ message, project })
+    const response = await router.route({ message, project, action })
 
     logger.info(
       {

package/src/server/handlers/tools/schemas.ts

@@ -137,7 +137,8 @@ export const GetPhase12StatusSchema = z.object({})
 
 export const BrainSchema = z.object({
   message: z.string().min(1, 'message is required'),
-  project: z.string().optional()
+  project: z.string().optional(),
+  action: z.enum(['auto', 'store', 'recall', 'update', 'delete']).optional()
 })
 
 // ============================================================================

package/src/server/http-api.ts

@@ -814,7 +814,7 @@ export class HttpApiServer {
           memoryService.recallSimilar(projectName || 'recent work', {
             project: projectName,
             limit: 5,
-            minSimilarity: 0.2,
+            minSimilarity: 0.65,
           }),
           memoryService.getPatterns(projectName, { limit: 5 }),
         ])

package/src/server/utils/memory-indicator.ts

@@ -16,13 +16,14 @@ const ANSI = {
 
 /**
  * Memory indicator banner shown when Claude Brain provides helpful data
+ * Note: No ANSI codes — MCP tool responses should be plain text/markdown
  */
-export const MEMORY_HELPED_BANNER = `${ANSI.brightRed}${ANSI.bold}🧠 MEMORY ASSISTED${ANSI.reset}`
+export const MEMORY_HELPED_BANNER = '🧠 MEMORY ASSISTED'
 
 /**
  * Alternative shorter indicator
  */
-export const MEMORY_HELPED_SHORT = `${ANSI.brightRed}[memory-assisted]${ANSI.reset}`
+export const MEMORY_HELPED_SHORT = '[memory-assisted]'
 
 /**
  * Wrap content with the memory helped indicator
@@ -63,7 +64,7 @@ export function formatMemoryStats(stats: {
 
   if (parts.length === 0) return ''
 
-  return `${ANSI.red}📊 Retrieved: ${parts.join(', ')}${ANSI.reset}`
+  return `📊 Retrieved: ${parts.join(', ')}`
 }
 
 /**

package/src/tools/schemas.ts

@@ -601,6 +601,11 @@ export const TOOLS = {
         project: {
           type: 'string',
           description: 'Project name (IMPORTANT: pass this to scope memories correctly, e.g. "my-app"). Auto-detected from message if omitted, defaults to "general".'
+        },
+        action: {
+          type: 'string',
+          enum: ['auto', 'store', 'recall', 'update', 'delete'],
+          description: 'Force a specific action instead of auto-detecting intent. "store" = always save, "recall" = always search, "update" = modify last stored, "delete" = remove. Default: auto (use intent classifier).'
         }
       },
       required: ['message']