claude-brain 0.15.2 → 0.16.0

package/src/server/providers/prompts.ts

@@ -1,327 +1,327 @@
-/**
- * Prompt Provider
- * Phase 6.5: System prompts for proactive Claude behavior
- */
-
-import type { Logger } from 'pino'
-import path from 'path'
-import { getVaultService, getContextService, isServicesInitialized } from '@/server/services'
-import { isPhase12Available, getPhase12Instance } from '@/utils/phase12-helper'
-
-interface DetectedProject {
-  name: string
-  path: string
-  confidence: number
-  indicators: string[]
-}
-
-export class PromptProvider {
-  private logger: Logger
-
-  constructor(logger: Logger) {
-    this.logger = logger.child({ component: 'prompt-provider' })
-  }
-
-  /**
-   * Get all available prompts
-   */
-  async listPrompts() {
-    return {
-      prompts: [
-        {
-          name: 'claude-brain-behavior',
-          description: 'Instructions for using Claude Brain proactively',
-          arguments: []
-        },
-        {
-          name: 'current-project-context',
-          description: 'Auto-detected project context summary',
-          arguments: []
-        }
-      ]
-    }
-  }
-
-  /**
-   * Get specific prompt content
-   */
-  async getPrompt(name: string) {
-    switch (name) {
-      case 'claude-brain-behavior':
-        return await this.getBehaviorPrompt()
-      case 'current-project-context':
-        return await this.getProjectContextPrompt()
-      default:
-        throw new Error(`Unknown prompt: ${name}`)
-    }
-  }
-
-  /**
-   * Get behavior instructions prompt
-   */
-  private async getBehaviorPrompt() {
-    const detectedProject = await this.detectCurrentProject()
-
-    return {
-      messages: [
-        {
-          role: 'user',
-          content: {
-            type: 'text',
-            text: this.buildBehaviorPromptText(detectedProject)
-          }
-        }
-      ]
-    }
-  }
-
-  /**
-   * Build the behavior prompt text
-   */
-  private buildBehaviorPromptText(detectedProject: DetectedProject | null): string {
-    const phase12Status = isPhase12Available()
-      ? `
-**Phase 12 Advanced Features Available:**
-The system includes advanced automation that may auto-detect and save decisions.
-Continue being proactive - Phase 12 features complement your behavior.
-`
-      : ''
-
-    const projectContext = detectedProject
-      ? `
-**CURRENT PROJECT DETECTED: ${detectedProject.name}**
-- Confidence: ${Math.round(detectedProject.confidence * 100)}%
-- Detection method: ${detectedProject.indicators.join(', ')}
-
-When the user asks questions, assume they're asking about this project unless they specify otherwise.
-`
-      : 'No project currently detected in working directory.'
-
-    return `
-# Claude Brain Integration
-
-You are connected to Claude Brain, a persistent memory and context management system.
-
-## CRITICAL BEHAVIORS (Always Follow)
-
-### 1. Proactive Tool Usage
-When users ask questions about their projects, YOU SHOULD:
-- Use \`get_project_context\` when they mention a project name
-- Use \`recall_similar\` before answering architecture/design questions
-- Use \`remember_decision\` when making important recommendations
-- Use \`update_progress\` when they complete tasks
-
-DO NOT wait for explicit commands like "use the tool". Act proactively based on context.
-
-### 2. Decision Detection
-When you make recommendations that include:
-- "I recommend..."
-- "You should use..."
-- "The best approach is..."
-- Technical architecture choices
-
-YOU SHOULD automatically use \`remember_decision\` to store this for future reference.
-
-### 3. Context Awareness
-${projectContext}
-
-### 4. Memory-First Approach
-BEFORE answering architecture, design, or technical questions:
-1. Use \`recall_similar\` to check past decisions
-2. If relevant past context exists, reference it in your answer
-3. Build on past decisions rather than starting from scratch
-
-### 5. Available Tools
-
-**Context & Information:**
-- \`get_project_context\`: Get full project details, tech stack, progress, standards
-- \`list_projects\`: See all available projects
-- \`get_code_standards\`: Get coding standards for a project
-
-**Memory & Decisions:**
-- \`remember_decision\`: Store important decisions (use proactively!)
-- \`recall_similar\`: Search past decisions by semantic similarity
-
-**Progress Tracking:**
-- \`update_progress\`: Mark tasks complete and set next steps
-
-**Phase 12 Smart Tools:**
-- \`smart_context\`: Get context + proactive memory recall for current task
-- \`auto_remember\`: Auto-detect and save decisions from text
-- \`get_phase12_status\`: Check automation status
-
-## Example Behaviors
-
-**Good (Proactive):**
-\`\`\`
-User: "How should I handle authentication in my-app?"
-
-You (internally):
-1. Use recall_similar("authentication approaches")
-2. Use get_project_context("my-app") if needed
-
-You (response): "Based on our past Auth0 decision in your-other-app
-(which worked well), I recommend a similar approach for my-app..."
-\`\`\`
-
-**Bad (Waiting for Commands):**
-\`\`\`
-User: "How should I handle authentication in my-app?"
-You: "Would you like me to check past decisions first?"
-\`\`\`
-
-## Phase 12 Integration Notice
-${phase12Status}
-
-Remember: Be helpful and proactive. Users expect you to use these tools automatically based on context, not wait for explicit commands.
-`.trim()
-  }
-
-  /**
-   * Get current project context prompt
-   */
-  private async getProjectContextPrompt() {
-    const detectedProject = await this.detectCurrentProject()
-
-    if (!detectedProject) {
-      return {
-        messages: [
-          {
-            role: 'user',
-            content: {
-              type: 'text',
-              text: 'No project detected in current working directory.'
-            }
-          }
-        ]
-      }
-    }
-
-    try {
-      if (!isServicesInitialized()) {
-        return {
-          messages: [
-            {
-              role: 'user',
-              content: {
-                type: 'text',
-                text: `Project detected: ${detectedProject.name}, but services not initialized.`
-              }
-            }
-          ]
-        }
-      }
-
-      const contextService = getContextService()
-
-      // Get brief context summary
-      const context = await contextService.getContext(detectedProject.name, {
-        includeMemories: false, // Brief summary only
-        includeProgress: true,
-        includeStandards: false,
-        maxTokens: 1000
-      })
-
-      const techStack = context.project.techStack?.join(', ') || 'Not specified'
-      const currentPhase = context.progress?.currentPhase || 'Not specified'
-      const completion = context.progress?.completionPercentage || 0
-      const currentTasks = context.progress?.currentTasks?.slice(0, 3).map(t => `- ${t.title}`).join('\n') || 'No current tasks'
-
-      return {
-        messages: [
-          {
-            role: 'user',
-            content: {
-              type: 'text',
-              text: `
-# Current Project: ${detectedProject.name}
-
-## Quick Summary
-${context.project.description || 'No description available'}
-
-## Tech Stack
-${techStack}
-
-## Current Phase
-${currentPhase} (${completion}% complete)
-
-## Recent Activity
-${currentTasks}
-
-Use \`get_project_context\` for complete details including decisions, standards, and relevant memories.
-`.trim()
-            }
-          }
-        ]
-      }
-
-    } catch (error) {
-      this.logger.error({ error, project: detectedProject.name }, 'Failed to load project context')
-
-      return {
-        messages: [
-          {
-            role: 'user',
-            content: {
-              type: 'text',
-              text: `Project detected: ${detectedProject.name}, but context could not be loaded. Use \`get_project_context\` to access details.`
-            }
-          }
-        ]
-      }
-    }
-  }
-
-  /**
-   * Detect current project from working directory
-   */
-  private async detectCurrentProject(): Promise<DetectedProject | null> {
-    try {
-      const cwd = process.cwd()
-
-      // Check if Phase 12 is available with better detection
-      if (isPhase12Available()) {
-        const phase12 = getPhase12Instance()
-        if (phase12?.projectDetector?.detectProject) {
-          return await phase12.projectDetector.detectProject(cwd)
-        }
-      }
-
-      // Fallback: Simple detection
-      if (!isServicesInitialized()) {
-        return null
-      }
-
-      const vault = getVaultService()
-      const projects = await vault.reader.getProjectDirectories(vault.paths.projects)
-      const dirName = path.basename(cwd)
-
-      if (projects.includes(dirName)) {
-        return {
-          name: dirName,
-          path: cwd,
-          confidence: 1.0,
-          indicators: ['directory-match']
-        }
-      }
-
-      // Check if cwd contains a project folder name
-      for (const project of projects) {
-        if (cwd.toLowerCase().includes(project.toLowerCase())) {
-          return {
-            name: project,
-            path: cwd,
-            confidence: 0.7,
-            indicators: ['path-contains-project']
-          }
-        }
-      }
-
-      return null
-
-    } catch (error) {
-      this.logger.debug({ error }, 'Project detection failed')
-      return null
-    }
-  }
-}
+/**
+ * Prompt Provider
+ * Phase 6.5: System prompts for proactive Claude behavior
+ */
+
+import type { Logger } from 'pino'
+import path from 'path'
+import { getVaultService, getContextService, isServicesInitialized } from '@/server/services'
+import { isPhase12Available, getPhase12Instance } from '@/utils/phase12-helper'
+
+interface DetectedProject {
+  name: string
+  path: string
+  confidence: number
+  indicators: string[]
+}
+
+export class PromptProvider {
+  private logger: Logger
+
+  constructor(logger: Logger) {
+    this.logger = logger.child({ component: 'prompt-provider' })
+  }
+
+  /**
+   * Get all available prompts
+   */
+  async listPrompts() {
+    return {
+      prompts: [
+        {
+          name: 'claude-brain-behavior',
+          description: 'Instructions for using Claude Brain proactively',
+          arguments: []
+        },
+        {
+          name: 'current-project-context',
+          description: 'Auto-detected project context summary',
+          arguments: []
+        }
+      ]
+    }
+  }
+
+  /**
+   * Get specific prompt content
+   */
+  async getPrompt(name: string) {
+    switch (name) {
+      case 'claude-brain-behavior':
+        return await this.getBehaviorPrompt()
+      case 'current-project-context':
+        return await this.getProjectContextPrompt()
+      default:
+        throw new Error(`Unknown prompt: ${name}`)
+    }
+  }
+
+  /**
+   * Get behavior instructions prompt
+   */
+  private async getBehaviorPrompt() {
+    const detectedProject = await this.detectCurrentProject()
+
+    return {
+      messages: [
+        {
+          role: 'user',
+          content: {
+            type: 'text',
+            text: this.buildBehaviorPromptText(detectedProject)
+          }
+        }
+      ]
+    }
+  }
+
+  /**
+   * Build the behavior prompt text
+   */
+  private buildBehaviorPromptText(detectedProject: DetectedProject | null): string {
+    const phase12Status = isPhase12Available()
+      ? `
+**Phase 12 Advanced Features Available:**
+The system includes advanced automation that may auto-detect and save decisions.
+Continue being proactive - Phase 12 features complement your behavior.
+`
+      : ''
+
+    const projectContext = detectedProject
+      ? `
+**CURRENT PROJECT DETECTED: ${detectedProject.name}**
+- Confidence: ${Math.round(detectedProject.confidence * 100)}%
+- Detection method: ${detectedProject.indicators.join(', ')}
+
+When the user asks questions, assume they're asking about this project unless they specify otherwise.
+`
+      : 'No project currently detected in working directory.'
+
+    return `
+# Claude Brain Integration
+
+You are connected to Claude Brain, a persistent memory and context management system.
+
+## CRITICAL BEHAVIORS (Always Follow)
+
+### 1. Proactive Tool Usage
+When users ask questions about their projects, YOU SHOULD:
+- Use \`get_project_context\` when they mention a project name
+- Use \`recall_similar\` before answering architecture/design questions
+- Use \`remember_decision\` when making important recommendations
+- Use \`update_progress\` when they complete tasks
+
+DO NOT wait for explicit commands like "use the tool". Act proactively based on context.
+
+### 2. Decision Detection
+When you make recommendations that include:
+- "I recommend..."
+- "You should use..."
+- "The best approach is..."
+- Technical architecture choices
+
+YOU SHOULD automatically use \`remember_decision\` to store this for future reference.
+
+### 3. Context Awareness
+${projectContext}
+
+### 4. Memory-First Approach
+BEFORE answering architecture, design, or technical questions:
+1. Use \`recall_similar\` to check past decisions
+2. If relevant past context exists, reference it in your answer
+3. Build on past decisions rather than starting from scratch
+
+### 5. Available Tools
+
+**Context & Information:**
+- \`get_project_context\`: Get full project details, tech stack, progress, standards
+- \`list_projects\`: See all available projects
+- \`get_code_standards\`: Get coding standards for a project
+
+**Memory & Decisions:**
+- \`remember_decision\`: Store important decisions (use proactively!)
+- \`recall_similar\`: Search past decisions by semantic similarity
+
+**Progress Tracking:**
+- \`update_progress\`: Mark tasks complete and set next steps
+
+**Phase 12 Smart Tools:**
+- \`smart_context\`: Get context + proactive memory recall for current task
+- \`auto_remember\`: Auto-detect and save decisions from text
+- \`get_phase12_status\`: Check automation status
+
+## Example Behaviors
+
+**Good (Proactive):**
+\`\`\`
+User: "How should I handle authentication in my-app?"
+
+You (internally):
+1. Use recall_similar("authentication approaches")
+2. Use get_project_context("my-app") if needed
+
+You (response): "Based on our past Auth0 decision in your-other-app
+(which worked well), I recommend a similar approach for my-app..."
+\`\`\`
+
+**Bad (Waiting for Commands):**
+\`\`\`
+User: "How should I handle authentication in my-app?"
+You: "Would you like me to check past decisions first?"
+\`\`\`
+
+## Phase 12 Integration Notice
+${phase12Status}
+
+Remember: Be helpful and proactive. Users expect you to use these tools automatically based on context, not wait for explicit commands.
+`.trim()
+  }
+
+  /**
+   * Get current project context prompt
+   */
+  private async getProjectContextPrompt() {
+    const detectedProject = await this.detectCurrentProject()
+
+    if (!detectedProject) {
+      return {
+        messages: [
+          {
+            role: 'user',
+            content: {
+              type: 'text',
+              text: 'No project detected in current working directory.'
+            }
+          }
+        ]
+      }
+    }
+
+    try {
+      if (!isServicesInitialized()) {
+        return {
+          messages: [
+            {
+              role: 'user',
+              content: {
+                type: 'text',
+                text: `Project detected: ${detectedProject.name}, but services not initialized.`
+              }
+            }
+          ]
+        }
+      }
+
+      const contextService = getContextService()
+
+      // Get brief context summary
+      const context = await contextService.getContext(detectedProject.name, {
+        includeMemories: false, // Brief summary only
+        includeProgress: true,
+        includeStandards: false,
+        maxTokens: 1000
+      })
+
+      const techStack = context.project.techStack?.join(', ') || 'Not specified'
+      const currentPhase = context.progress?.currentPhase || 'Not specified'
+      const completion = context.progress?.completionPercentage || 0
+      const currentTasks = context.progress?.currentTasks?.slice(0, 3).map(t => `- ${t.title}`).join('\n') || 'No current tasks'
+
+      return {
+        messages: [
+          {
+            role: 'user',
+            content: {
+              type: 'text',
+              text: `
+# Current Project: ${detectedProject.name}
+
+## Quick Summary
+${context.project.description || 'No description available'}
+
+## Tech Stack
+${techStack}
+
+## Current Phase
+${currentPhase} (${completion}% complete)
+
+## Recent Activity
+${currentTasks}
+
+Use \`get_project_context\` for complete details including decisions, standards, and relevant memories.
+`.trim()
+            }
+          }
+        ]
+      }
+
+    } catch (error) {
+      this.logger.error({ error, project: detectedProject.name }, 'Failed to load project context')
+
+      return {
+        messages: [
+          {
+            role: 'user',
+            content: {
+              type: 'text',
+              text: `Project detected: ${detectedProject.name}, but context could not be loaded. Use \`get_project_context\` to access details.`
+            }
+          }
+        ]
+      }
+    }
+  }
+
+  /**
+   * Detect current project from working directory
+   */
+  private async detectCurrentProject(): Promise<DetectedProject | null> {
+    try {
+      const cwd = process.cwd()
+
+      // Check if Phase 12 is available with better detection
+      if (isPhase12Available()) {
+        const phase12 = getPhase12Instance()
+        if (phase12?.projectDetector?.detectProject) {
+          return await phase12.projectDetector.detectProject(cwd)
+        }
+      }
+
+      // Fallback: Simple detection
+      if (!isServicesInitialized()) {
+        return null
+      }
+
+      const vault = getVaultService()
+      const projects = await vault.reader.getProjectDirectories(vault.paths.projects)
+      const dirName = path.basename(cwd)
+
+      if (projects.includes(dirName)) {
+        return {
+          name: dirName,
+          path: cwd,
+          confidence: 1.0,
+          indicators: ['directory-match']
+        }
+      }
+
+      // Check if cwd contains a project folder name
+      for (const project of projects) {
+        if (cwd.toLowerCase().includes(project.toLowerCase())) {
+          return {
+            name: project,
+            path: cwd,
+            confidence: 0.7,
+            indicators: ['path-contains-project']
+          }
+        }
+      }
+
+      return null
+
+    } catch (error) {
+      this.logger.debug({ error }, 'Project detection failed')
+      return null
+    }
+  }
+}