claude-brain 0.15.2 → 0.16.0

package/src/server/providers/resources.ts

@@ -1,622 +1,622 @@
-/**
- * Resource Provider
- * Phase 6.5: Expose project context as resources
- */
-
-import type { Logger } from 'pino'
-import path from 'path'
-import {
-  getVaultService,
-  getContextService,
-  getMemoryService,
-  getEpisodeService,
-  getSessionTracker,
-  isServicesInitialized
-} from '@/server/services'
-import { isPhase12Available, getPhase12Instance } from '@/utils/phase12-helper'
-import type { ContextFormatter } from '@/context'
-
-interface DetectedProject {
-  name: string
-  path: string
-  confidence: number
-  indicators: string[]
-}
-
-interface ResourceItem {
-  uri: string
-  name: string
-  description: string
-  mimeType: string
-}
-
-export class ResourceProvider {
-  private logger: Logger
-
-  constructor(logger: Logger) {
-    this.logger = logger.child({ component: 'resource-provider' })
-  }
-
-  /**
-   * List all available resources
-   */
-  async listResources() {
-    const detectedProject = await this.detectCurrentProject()
-
-    const resources: ResourceItem[] = [
-      {
-        uri: 'brain://context/auto',
-        name: 'Auto Context',
-        description: 'Session context auto-loaded by brain',
-        mimeType: 'text/markdown'
-      },
-      {
-        uri: 'project://list',
-        name: 'All Projects',
-        description: 'List of all projects in vault',
-        mimeType: 'text/plain'
-      }
-    ]
-
-    if (detectedProject) {
-      resources.push(
-        {
-          uri: 'project://current/context',
-          name: 'Current Project Context',
-          description: `Context for ${detectedProject.name}`,
-          mimeType: 'text/markdown'
-        },
-        {
-          uri: 'project://current/decisions',
-          name: 'Recent Decisions',
-          description: `Recent decisions for ${detectedProject.name}`,
-          mimeType: 'text/markdown'
-        },
-        {
-          uri: 'project://current/standards',
-          name: 'Coding Standards',
-          description: `Standards for ${detectedProject.name}`,
-          mimeType: 'text/markdown'
-        },
-        {
-          uri: 'project://current/progress',
-          name: 'Current Progress',
-          description: `Progress tracker for ${detectedProject.name}`,
-          mimeType: 'text/markdown'
-        }
-      )
-    }
-
-    return { resources }
-  }
-
-  /**
-   * Read a specific resource
-   */
-  async readResource(uri: string) {
-    this.logger.info({ uri }, 'Reading resource')
-
-    if (uri.startsWith('brain://')) {
-      return await this.getBrainResource(uri)
-    }
-
-    if (uri === 'project://list') {
-      return await this.getProjectListResource()
-    }
-
-    if (uri.startsWith('project://current/')) {
-      const resourceType = uri.split('/').pop()
-      return await this.getCurrentProjectResource(resourceType!)
-    }
-
-    throw new Error(`Unknown resource URI: ${uri}`)
-  }
-
-  /**
-   * Get project list resource
-   */
-  private async getProjectListResource() {
-    if (!isServicesInitialized()) {
-      return {
-        contents: [
-          {
-            uri: 'project://list',
-            mimeType: 'text/plain',
-            text: 'Services not initialized'
-          }
-        ]
-      }
-    }
-
-    const vault = getVaultService()
-    const projects = await vault.reader.getProjectDirectories(vault.paths.projects)
-
-    let content = '# Available Projects\n\n'
-
-    for (const project of projects) {
-      try {
-        const projectPaths = vault.getProjectPaths(project)
-        const context = await vault.reader.readMarkdownFile(projectPaths.context)
-
-        content += `## ${project}\n`
-        content += `**Status:** ${context.frontmatter.status || 'unknown'}\n`
-
-        if (context.frontmatter.tech_stack) {
-          const techStack = Array.isArray(context.frontmatter.tech_stack)
-            ? context.frontmatter.tech_stack.join(', ')
-            : context.frontmatter.tech_stack
-          content += `**Tech Stack:** ${techStack}\n`
-        }
-
-        if (context.frontmatter.description) {
-          content += `**Description:** ${context.frontmatter.description}\n`
-        }
-
-        content += '\n'
-
-      } catch (error) {
-        content += `## ${project}\n*Context not available*\n\n`
-      }
-    }
-
-    if (projects.length === 0) {
-      content += '*No projects found in vault*\n'
-    }
-
-    return {
-      contents: [
-        {
-          uri: 'project://list',
-          mimeType: 'text/markdown',
-          text: content
-        }
-      ]
-    }
-  }
-
-  /**
-   * Get current project resource
-   */
-  private async getCurrentProjectResource(resourceType: string) {
-    const detectedProject = await this.detectCurrentProject()
-
-    if (!detectedProject) {
-      return {
-        contents: [
-          {
-            uri: `project://current/${resourceType}`,
-            mimeType: 'text/plain',
-            text: 'No project detected in current working directory'
-          }
-        ]
-      }
-    }
-
-    let content: string
-
-    try {
-      switch (resourceType) {
-        case 'context':
-          content = await this.getContextContent(detectedProject.name)
-          break
-        case 'decisions':
-          content = await this.getDecisionsContent(detectedProject.name)
-          break
-        case 'standards':
-          content = await this.getStandardsContent(detectedProject.name)
-          break
-        case 'progress':
-          content = await this.getProgressContent(detectedProject.name)
-          break
-        default:
-          throw new Error(`Unknown resource type: ${resourceType}`)
-      }
-
-    } catch (error) {
-      this.logger.error({ error, project: detectedProject.name, resourceType }, 'Failed to read resource')
-      content = `Error loading ${resourceType} for ${detectedProject.name}: ${error instanceof Error ? error.message : 'Unknown error'}`
-    }
-
-    return {
-      contents: [
-        {
-          uri: `project://current/${resourceType}`,
-          mimeType: 'text/markdown',
-          text: content
-        }
-      ]
-    }
-  }
-
-  /**
-   * Get context content
-   */
-  private async getContextContent(projectName: string): Promise<string> {
-    if (!isServicesInitialized()) {
-      return `# ${projectName}\n\nServices not initialized`
-    }
-
-    const contextService = getContextService()
-
-    const context = await contextService.getContext(projectName, {
-      includeMemories: true,
-      includeProgress: true,
-      includeStandards: true,
-      maxTokens: 3000
-    })
-
-    return contextService.formatter.format(context)
-  }
-
-  /**
-   * Get recent decisions
-   */
-  private async getDecisionsContent(projectName: string): Promise<string> {
-    if (!isServicesInitialized()) {
-      return `# Recent Decisions: ${projectName}\n\nServices not initialized`
-    }
-
-    const memory = getMemoryService()
-
-    // Search for decisions related to this project
-    const decisions = await memory.searchRaw(projectName, {
-      project: projectName,
-      limit: 5,
-      minSimilarity: 0.1
-    })
-
-    if (decisions.length === 0) {
-      return `# Recent Decisions: ${projectName}\n\nNo decisions recorded yet.\n\n*Use \`remember_decision\` to store important decisions.*`
-    }
-
-    let content = `# Recent Decisions: ${projectName}\n\n`
-
-    for (const [i, decision] of decisions.entries()) {
-      content += `## ${i + 1}. ${decision.decision || 'Untitled'}\n\n`
-
-      if (decision.context) {
-        content += `**Context:** ${decision.context}\n\n`
-      }
-
-      if (decision.reasoning) {
-        content += `**Reasoning:** ${decision.reasoning}\n\n`
-      }
-
-      if (decision.alternatives) {
-        content += `**Alternatives:** ${decision.alternatives}\n\n`
-      }
-
-      if (decision.timestamp) {
-        content += `*Recorded: ${new Date(decision.timestamp).toLocaleDateString()}*\n\n`
-      }
-
-      content += '---\n\n'
-    }
-
-    return content
-  }
-
-  /**
-   * Get coding standards
-   */
-  private async getStandardsContent(projectName: string): Promise<string> {
-    if (!isServicesInitialized()) {
-      return `# Coding Standards: ${projectName}\n\nServices not initialized`
-    }
-
-    const contextService = getContextService()
-
-    try {
-      const standards = await contextService.standards.getProjectStandards(projectName)
-
-      let content = `# Coding Standards: ${projectName}\n\n`
-
-      if (standards.languages && standards.languages.length > 0) {
-        for (const lang of standards.languages) {
-          content += `## ${lang.language}\n\n`
-
-          if (lang.version) {
-            content += `**Version:** ${lang.version}\n`
-          }
-
-          if (lang.style) {
-            content += `**Style:** ${lang.style}\n\n`
-          }
-
-          if (lang.conventions && lang.conventions.length > 0) {
-            content += '**Conventions:**\n'
-            for (const conv of lang.conventions) {
-              content += `- ${conv}\n`
-            }
-            content += '\n'
-          }
-        }
-      } else {
-        content += '*No specific language standards defined.*\n\n'
-      }
-
-      return content
-
-    } catch (error) {
-      return `# Coding Standards: ${projectName}\n\n*Standards not available. Check if standards.md exists.*`
-    }
-  }
-
-  /**
-   * Get progress content
-   */
-  private async getProgressContent(projectName: string): Promise<string> {
-    if (!isServicesInitialized()) {
-      return `# Progress: ${projectName}\n\nServices not initialized`
-    }
-
-    const vault = getVaultService()
-    const projectPaths = vault.getProjectPaths(projectName)
-
-    try {
-      const progress = await vault.reader.readMarkdownFile(projectPaths.progress)
-
-      let content = `# Progress: ${projectName}\n\n`
-
-      // Add frontmatter info
-      if (progress.frontmatter) {
-        if (progress.frontmatter.current_phase) {
-          content += `**Current Phase:** ${progress.frontmatter.current_phase}\n`
-        }
-        if (progress.frontmatter.completion_percentage !== undefined) {
-          content += `**Completion:** ${progress.frontmatter.completion_percentage}%\n`
-        }
-        if (progress.frontmatter.status) {
-          content += `**Status:** ${progress.frontmatter.status}\n`
-        }
-        content += '\n'
-      }
-
-      // Add content
-      if (progress.content) {
-        content += progress.content
-      }
-
-      return content
-
-    } catch (error) {
-      return `# Progress: ${projectName}\n\n*Progress file not found.*`
-    }
-  }
-
-  /**
-   * Handle brain:// resource URIs
-   */
-  private async getBrainResource(uri: string) {
-    if (uri === 'brain://context/auto') {
-      const content = await this.getAutoContextContent()
-      return {
-        contents: [
-          {
-            uri,
-            mimeType: 'text/markdown',
-            text: content
-          }
-        ]
-      }
-    }
-
-    throw new Error(`Unknown brain resource URI: ${uri}`)
-  }
-
-  /**
-   * Phase 21: Build aggregated auto-context payload
-   * Combines last session summary, recent decisions, corrections,
-   * cross-project knowledge, and current session info.
-   */
-  private async getAutoContextContent(): Promise<string> {
-    if (!isServicesInitialized()) {
-      return '# Auto Context\n\nServices not initialized.'
-    }
-
-    const sections: string[] = ['# Auto Context\n']
-    const detectedProject = await this.detectCurrentProject()
-    const projectName = detectedProject?.name
-
-    // 1. Last session summary
-    try {
-      const episodeService = getEpisodeService()
-      if (episodeService) {
-        const recentEpisodes = await episodeService.getRecentEpisodes(projectName, 1)
-        if (recentEpisodes.length > 0 && recentEpisodes[0].summary?.brief) {
-          const ep = recentEpisodes[0]
-          sections.push('## Last Session\n')
-          sections.push(ep.summary!.brief)
-          if (ep.summary!.key_topics.length > 0) {
-            sections.push(`\n**Topics:** ${ep.summary!.key_topics.join(', ')}`)
-          }
-          sections.push('')
-        }
-      }
-    } catch (err) {
-      this.logger.debug({ err }, 'Failed to get last session for auto-context')
-    }
-
-    // 2. Current session info
-    try {
-      const tracker = getSessionTracker()
-      if (tracker) {
-        const stats = tracker.getStats()
-        if (stats.activeSessions > 0) {
-          sections.push('## Current Session\n')
-          sections.push(`Active sessions: ${stats.activeSessions}, items tracked: ${stats.totalItems}`)
-          sections.push('')
-        }
-      }
-    } catch (err) {
-      this.logger.debug({ err }, 'Failed to get current session for auto-context')
-    }
-
-    // 3. Recent decisions
-    try {
-      const memory = getMemoryService()
-      const searchProject = projectName || 'general'
-      const decisions = await memory.searchRaw(searchProject, {
-        project: searchProject,
-        limit: 5,
-        minSimilarity: 0.1
-      })
-
-      if (decisions.length > 0) {
-        sections.push('## Recent Decisions\n')
-        for (const d of decisions) {
-          const title = d.decision || d.content || 'Untitled'
-          const truncated = title.length > 120 ? title.slice(0, 120) + '...' : title
-          sections.push(`- ${truncated}`)
-        }
-        sections.push('')
-      }
-    } catch (err) {
-      this.logger.debug({ err }, 'Failed to get decisions for auto-context')
-    }
-
-    // 4. Corrections (watch out for)
-    try {
-      const memory = getMemoryService()
-      if (typeof memory.getCorrections === 'function') {
-        const corrections = await memory.getCorrections(projectName || 'general', { limit: 3 })
-        if (corrections && corrections.length > 0) {
-          sections.push('## Watch Out For\n')
-          for (const c of corrections) {
-            const text = typeof c === 'string' ? c : (c.content || c.correction || JSON.stringify(c))
-            const truncated = text.length > 120 ? text.slice(0, 120) + '...' : text
-            sections.push(`- ${truncated}`)
-          }
-          sections.push('')
-        }
-      }
-    } catch (err) {
-      this.logger.debug({ err }, 'Failed to get corrections for auto-context')
-    }
-
-    // 5. Cross-project knowledge
-    if (projectName) {
-      try {
-        const vault = getVaultService()
-        const allProjects = await vault.reader.getProjectDirectories(vault.paths.projects)
-        const otherProjects = allProjects.filter(p => p !== projectName)
-
-        if (otherProjects.length > 0) {
-          const memory = getMemoryService()
-          if (memory.isChromaDBEnabled()) {
-            const { KnowledgeTransfer } = await import('@/intelligence/cross-project/transfer')
-            const transfer = new KnowledgeTransfer(
-              this.logger,
-              memory.chroma.collections,
-              memory.chroma.embeddings
-            )
-
-            const transferItems: string[] = []
-            // Check up to 3 other projects for transferable knowledge
-            for (const other of otherProjects.slice(0, 3)) {
-              try {
-                const result = await transfer.findTransferable(other, projectName, { limit: 2, minRelevance: 0.5 })
-                for (const item of result.items) {
-                  const truncated = item.content.length > 100 ? item.content.slice(0, 100) + '...' : item.content
-                  transferItems.push(`- [${item.type} from ${other}] ${truncated}`)
-                }
-              } catch {
-                // Skip failed transfers
-              }
-            }
-
-            if (transferItems.length > 0) {
-              sections.push('## From Other Projects\n')
-              sections.push(...transferItems)
-              sections.push('')
-            }
-          }
-        }
-      } catch (err) {
-        this.logger.debug({ err }, 'Failed to get cross-project knowledge for auto-context')
-      }
-    }
-
-    // If no sections beyond the header, try auto-scan for first-session value
-    if (sections.length <= 1) {
-      try {
-        const cwd = process.cwd()
-        const { scanRepo } = await import('@/automation/repo-scanner')
-        const repoContext = await scanRepo(cwd)
-        if (repoContext.name) {
-          sections.push('## Project Detected\n')
-          sections.push(`**Name:** ${repoContext.name}`)
-          if (repoContext.techStack.length > 0) {
-            sections.push(`**Tech stack:** ${repoContext.techStack.join(', ')}`)
-          }
-          if (repoContext.description) {
-            const desc = repoContext.description.split('\n')[0]?.slice(0, 200) || ''
-            sections.push(`**Description:** ${desc}`)
-          }
-          sections.push('')
-        }
-      } catch {
-        // Scan failed, continue with empty context
-      }
-    }
-
-    if (sections.length <= 1) {
-      return '# Auto Context\n\nNo context available yet. Use brain to store decisions, patterns, and corrections.'
-    }
-
-    return sections.join('\n')
-  }
-
-  /**
-   * 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 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
-    }
-  }
-}
+/**
+ * Resource Provider
+ * Phase 6.5: Expose project context as resources
+ */
+
+import type { Logger } from 'pino'
+import path from 'path'
+import {
+  getVaultService,
+  getContextService,
+  getMemoryService,
+  getEpisodeService,
+  getSessionTracker,
+  isServicesInitialized
+} from '@/server/services'
+import { isPhase12Available, getPhase12Instance } from '@/utils/phase12-helper'
+import type { ContextFormatter } from '@/context'
+
+interface DetectedProject {
+  name: string
+  path: string
+  confidence: number
+  indicators: string[]
+}
+
+interface ResourceItem {
+  uri: string
+  name: string
+  description: string
+  mimeType: string
+}
+
+export class ResourceProvider {
+  private logger: Logger
+
+  constructor(logger: Logger) {
+    this.logger = logger.child({ component: 'resource-provider' })
+  }
+
+  /**
+   * List all available resources
+   */
+  async listResources() {
+    const detectedProject = await this.detectCurrentProject()
+
+    const resources: ResourceItem[] = [
+      {
+        uri: 'brain://context/auto',
+        name: 'Auto Context',
+        description: 'Session context auto-loaded by brain',
+        mimeType: 'text/markdown'
+      },
+      {
+        uri: 'project://list',
+        name: 'All Projects',
+        description: 'List of all projects in vault',
+        mimeType: 'text/plain'
+      }
+    ]
+
+    if (detectedProject) {
+      resources.push(
+        {
+          uri: 'project://current/context',
+          name: 'Current Project Context',
+          description: `Context for ${detectedProject.name}`,
+          mimeType: 'text/markdown'
+        },
+        {
+          uri: 'project://current/decisions',
+          name: 'Recent Decisions',
+          description: `Recent decisions for ${detectedProject.name}`,
+          mimeType: 'text/markdown'
+        },
+        {
+          uri: 'project://current/standards',
+          name: 'Coding Standards',
+          description: `Standards for ${detectedProject.name}`,
+          mimeType: 'text/markdown'
+        },
+        {
+          uri: 'project://current/progress',
+          name: 'Current Progress',
+          description: `Progress tracker for ${detectedProject.name}`,
+          mimeType: 'text/markdown'
+        }
+      )
+    }
+
+    return { resources }
+  }
+
+  /**
+   * Read a specific resource
+   */
+  async readResource(uri: string) {
+    this.logger.info({ uri }, 'Reading resource')
+
+    if (uri.startsWith('brain://')) {
+      return await this.getBrainResource(uri)
+    }
+
+    if (uri === 'project://list') {
+      return await this.getProjectListResource()
+    }
+
+    if (uri.startsWith('project://current/')) {
+      const resourceType = uri.split('/').pop()
+      return await this.getCurrentProjectResource(resourceType!)
+    }
+
+    throw new Error(`Unknown resource URI: ${uri}`)
+  }
+
+  /**
+   * Get project list resource
+   */
+  private async getProjectListResource() {
+    if (!isServicesInitialized()) {
+      return {
+        contents: [
+          {
+            uri: 'project://list',
+            mimeType: 'text/plain',
+            text: 'Services not initialized'
+          }
+        ]
+      }
+    }
+
+    const vault = getVaultService()
+    const projects = await vault.reader.getProjectDirectories(vault.paths.projects)
+
+    let content = '# Available Projects\n\n'
+
+    for (const project of projects) {
+      try {
+        const projectPaths = vault.getProjectPaths(project)
+        const context = await vault.reader.readMarkdownFile(projectPaths.context)
+
+        content += `## ${project}\n`
+        content += `**Status:** ${context.frontmatter.status || 'unknown'}\n`
+
+        if (context.frontmatter.tech_stack) {
+          const techStack = Array.isArray(context.frontmatter.tech_stack)
+            ? context.frontmatter.tech_stack.join(', ')
+            : context.frontmatter.tech_stack
+          content += `**Tech Stack:** ${techStack}\n`
+        }
+
+        if (context.frontmatter.description) {
+          content += `**Description:** ${context.frontmatter.description}\n`
+        }
+
+        content += '\n'
+
+      } catch (error) {
+        content += `## ${project}\n*Context not available*\n\n`
+      }
+    }
+
+    if (projects.length === 0) {
+      content += '*No projects found in vault*\n'
+    }
+
+    return {
+      contents: [
+        {
+          uri: 'project://list',
+          mimeType: 'text/markdown',
+          text: content
+        }
+      ]
+    }
+  }
+
+  /**
+   * Get current project resource
+   */
+  private async getCurrentProjectResource(resourceType: string) {
+    const detectedProject = await this.detectCurrentProject()
+
+    if (!detectedProject) {
+      return {
+        contents: [
+          {
+            uri: `project://current/${resourceType}`,
+            mimeType: 'text/plain',
+            text: 'No project detected in current working directory'
+          }
+        ]
+      }
+    }
+
+    let content: string
+
+    try {
+      switch (resourceType) {
+        case 'context':
+          content = await this.getContextContent(detectedProject.name)
+          break
+        case 'decisions':
+          content = await this.getDecisionsContent(detectedProject.name)
+          break
+        case 'standards':
+          content = await this.getStandardsContent(detectedProject.name)
+          break
+        case 'progress':
+          content = await this.getProgressContent(detectedProject.name)
+          break
+        default:
+          throw new Error(`Unknown resource type: ${resourceType}`)
+      }
+
+    } catch (error) {
+      this.logger.error({ error, project: detectedProject.name, resourceType }, 'Failed to read resource')
+      content = `Error loading ${resourceType} for ${detectedProject.name}: ${error instanceof Error ? error.message : 'Unknown error'}`
+    }
+
+    return {
+      contents: [
+        {
+          uri: `project://current/${resourceType}`,
+          mimeType: 'text/markdown',
+          text: content
+        }
+      ]
+    }
+  }
+
+  /**
+   * Get context content
+   */
+  private async getContextContent(projectName: string): Promise<string> {
+    if (!isServicesInitialized()) {
+      return `# ${projectName}\n\nServices not initialized`
+    }
+
+    const contextService = getContextService()
+
+    const context = await contextService.getContext(projectName, {
+      includeMemories: true,
+      includeProgress: true,
+      includeStandards: true,
+      maxTokens: 3000
+    })
+
+    return contextService.formatter.format(context)
+  }
+
+  /**
+   * Get recent decisions
+   */
+  private async getDecisionsContent(projectName: string): Promise<string> {
+    if (!isServicesInitialized()) {
+      return `# Recent Decisions: ${projectName}\n\nServices not initialized`
+    }
+
+    const memory = getMemoryService()
+
+    // Search for decisions related to this project
+    const decisions = await memory.searchRaw(projectName, {
+      project: projectName,
+      limit: 5,
+      minSimilarity: 0.1
+    })
+
+    if (decisions.length === 0) {
+      return `# Recent Decisions: ${projectName}\n\nNo decisions recorded yet.\n\n*Use \`remember_decision\` to store important decisions.*`
+    }
+
+    let content = `# Recent Decisions: ${projectName}\n\n`
+
+    for (const [i, decision] of decisions.entries()) {
+      content += `## ${i + 1}. ${decision.decision || 'Untitled'}\n\n`
+
+      if (decision.context) {
+        content += `**Context:** ${decision.context}\n\n`
+      }
+
+      if (decision.reasoning) {
+        content += `**Reasoning:** ${decision.reasoning}\n\n`
+      }
+
+      if (decision.alternatives) {
+        content += `**Alternatives:** ${decision.alternatives}\n\n`
+      }
+
+      if (decision.timestamp) {
+        content += `*Recorded: ${new Date(decision.timestamp).toLocaleDateString()}*\n\n`
+      }
+
+      content += '---\n\n'
+    }
+
+    return content
+  }
+
+  /**
+   * Get coding standards
+   */
+  private async getStandardsContent(projectName: string): Promise<string> {
+    if (!isServicesInitialized()) {
+      return `# Coding Standards: ${projectName}\n\nServices not initialized`
+    }
+
+    const contextService = getContextService()
+
+    try {
+      const standards = await contextService.standards.getProjectStandards(projectName)
+
+      let content = `# Coding Standards: ${projectName}\n\n`
+
+      if (standards.languages && standards.languages.length > 0) {
+        for (const lang of standards.languages) {
+          content += `## ${lang.language}\n\n`
+
+          if (lang.version) {
+            content += `**Version:** ${lang.version}\n`
+          }
+
+          if (lang.style) {
+            content += `**Style:** ${lang.style}\n\n`
+          }
+
+          if (lang.conventions && lang.conventions.length > 0) {
+            content += '**Conventions:**\n'
+            for (const conv of lang.conventions) {
+              content += `- ${conv}\n`
+            }
+            content += '\n'
+          }
+        }
+      } else {
+        content += '*No specific language standards defined.*\n\n'
+      }
+
+      return content
+
+    } catch (error) {
+      return `# Coding Standards: ${projectName}\n\n*Standards not available. Check if standards.md exists.*`
+    }
+  }
+
+  /**
+   * Get progress content
+   */
+  private async getProgressContent(projectName: string): Promise<string> {
+    if (!isServicesInitialized()) {
+      return `# Progress: ${projectName}\n\nServices not initialized`
+    }
+
+    const vault = getVaultService()
+    const projectPaths = vault.getProjectPaths(projectName)
+
+    try {
+      const progress = await vault.reader.readMarkdownFile(projectPaths.progress)
+
+      let content = `# Progress: ${projectName}\n\n`
+
+      // Add frontmatter info
+      if (progress.frontmatter) {
+        if (progress.frontmatter.current_phase) {
+          content += `**Current Phase:** ${progress.frontmatter.current_phase}\n`
+        }
+        if (progress.frontmatter.completion_percentage !== undefined) {
+          content += `**Completion:** ${progress.frontmatter.completion_percentage}%\n`
+        }
+        if (progress.frontmatter.status) {
+          content += `**Status:** ${progress.frontmatter.status}\n`
+        }
+        content += '\n'
+      }
+
+      // Add content
+      if (progress.content) {
+        content += progress.content
+      }
+
+      return content
+
+    } catch (error) {
+      return `# Progress: ${projectName}\n\n*Progress file not found.*`
+    }
+  }
+
+  /**
+   * Handle brain:// resource URIs
+   */
+  private async getBrainResource(uri: string) {
+    if (uri === 'brain://context/auto') {
+      const content = await this.getAutoContextContent()
+      return {
+        contents: [
+          {
+            uri,
+            mimeType: 'text/markdown',
+            text: content
+          }
+        ]
+      }
+    }
+
+    throw new Error(`Unknown brain resource URI: ${uri}`)
+  }
+
+  /**
+   * Phase 21: Build aggregated auto-context payload
+   * Combines last session summary, recent decisions, corrections,
+   * cross-project knowledge, and current session info.
+   */
+  private async getAutoContextContent(): Promise<string> {
+    if (!isServicesInitialized()) {
+      return '# Auto Context\n\nServices not initialized.'
+    }
+
+    const sections: string[] = ['# Auto Context\n']
+    const detectedProject = await this.detectCurrentProject()
+    const projectName = detectedProject?.name
+
+    // 1. Last session summary
+    try {
+      const episodeService = getEpisodeService()
+      if (episodeService) {
+        const recentEpisodes = await episodeService.getRecentEpisodes(projectName, 1)
+        if (recentEpisodes.length > 0 && recentEpisodes[0].summary?.brief) {
+          const ep = recentEpisodes[0]
+          sections.push('## Last Session\n')
+          sections.push(ep.summary!.brief)
+          if (ep.summary!.key_topics.length > 0) {
+            sections.push(`\n**Topics:** ${ep.summary!.key_topics.join(', ')}`)
+          }
+          sections.push('')
+        }
+      }
+    } catch (err) {
+      this.logger.debug({ err }, 'Failed to get last session for auto-context')
+    }
+
+    // 2. Current session info
+    try {
+      const tracker = getSessionTracker()
+      if (tracker) {
+        const stats = tracker.getStats()
+        if (stats.activeSessions > 0) {
+          sections.push('## Current Session\n')
+          sections.push(`Active sessions: ${stats.activeSessions}, items tracked: ${stats.totalItems}`)
+          sections.push('')
+        }
+      }
+    } catch (err) {
+      this.logger.debug({ err }, 'Failed to get current session for auto-context')
+    }
+
+    // 3. Recent decisions
+    try {
+      const memory = getMemoryService()
+      const searchProject = projectName || 'general'
+      const decisions = await memory.searchRaw(searchProject, {
+        project: searchProject,
+        limit: 5,
+        minSimilarity: 0.1
+      })
+
+      if (decisions.length > 0) {
+        sections.push('## Recent Decisions\n')
+        for (const d of decisions) {
+          const title = d.decision || d.content || 'Untitled'
+          const truncated = title.length > 120 ? title.slice(0, 120) + '...' : title
+          sections.push(`- ${truncated}`)
+        }
+        sections.push('')
+      }
+    } catch (err) {
+      this.logger.debug({ err }, 'Failed to get decisions for auto-context')
+    }
+
+    // 4. Corrections (watch out for)
+    try {
+      const memory = getMemoryService()
+      if (typeof memory.getCorrections === 'function') {
+        const corrections = await memory.getCorrections(projectName || 'general', { limit: 3 })
+        if (corrections && corrections.length > 0) {
+          sections.push('## Watch Out For\n')
+          for (const c of corrections) {
+            const text = typeof c === 'string' ? c : (c.content || c.correction || JSON.stringify(c))
+            const truncated = text.length > 120 ? text.slice(0, 120) + '...' : text
+            sections.push(`- ${truncated}`)
+          }
+          sections.push('')
+        }
+      }
+    } catch (err) {
+      this.logger.debug({ err }, 'Failed to get corrections for auto-context')
+    }
+
+    // 5. Cross-project knowledge
+    if (projectName) {
+      try {
+        const vault = getVaultService()
+        const allProjects = await vault.reader.getProjectDirectories(vault.paths.projects)
+        const otherProjects = allProjects.filter(p => p !== projectName)
+
+        if (otherProjects.length > 0) {
+          const memory = getMemoryService()
+          if (memory.isChromaDBEnabled()) {
+            const { KnowledgeTransfer } = await import('@/intelligence/cross-project/transfer')
+            const transfer = new KnowledgeTransfer(
+              this.logger,
+              memory.chroma.collections,
+              memory.chroma.embeddings
+            )
+
+            const transferItems: string[] = []
+            // Check up to 3 other projects for transferable knowledge
+            for (const other of otherProjects.slice(0, 3)) {
+              try {
+                const result = await transfer.findTransferable(other, projectName, { limit: 2, minRelevance: 0.5 })
+                for (const item of result.items) {
+                  const truncated = item.content.length > 100 ? item.content.slice(0, 100) + '...' : item.content
+                  transferItems.push(`- [${item.type} from ${other}] ${truncated}`)
+                }
+              } catch {
+                // Skip failed transfers
+              }
+            }
+
+            if (transferItems.length > 0) {
+              sections.push('## From Other Projects\n')
+              sections.push(...transferItems)
+              sections.push('')
+            }
+          }
+        }
+      } catch (err) {
+        this.logger.debug({ err }, 'Failed to get cross-project knowledge for auto-context')
+      }
+    }
+
+    // If no sections beyond the header, try auto-scan for first-session value
+    if (sections.length <= 1) {
+      try {
+        const cwd = process.cwd()
+        const { scanRepo } = await import('@/automation/repo-scanner')
+        const repoContext = await scanRepo(cwd)
+        if (repoContext.name) {
+          sections.push('## Project Detected\n')
+          sections.push(`**Name:** ${repoContext.name}`)
+          if (repoContext.techStack.length > 0) {
+            sections.push(`**Tech stack:** ${repoContext.techStack.join(', ')}`)
+          }
+          if (repoContext.description) {
+            const desc = repoContext.description.split('\n')[0]?.slice(0, 200) || ''
+            sections.push(`**Description:** ${desc}`)
+          }
+          sections.push('')
+        }
+      } catch {
+        // Scan failed, continue with empty context
+      }
+    }
+
+    if (sections.length <= 1) {
+      return '# Auto Context\n\nNo context available yet. Use brain to store decisions, patterns, and corrections.'
+    }
+
+    return sections.join('\n')
+  }
+
+  /**
+   * 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 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
+    }
+  }
+}