claude-brain 0.15.2 → 0.17.0

package/src/routing/types.ts

@@ -1,94 +1,94 @@
-/**
- * Routing Types
- * Phase 19: Normalized result types for the brain() router
- *
- * Eliminates scattered `r.decision?.decision || r.content?.slice(0, 300)`
- * by normalizing all search results to a flat structure.
- */
-
-export interface NormalizedResult {
-  id: string
-  content: string
-  score: number
-  source: 'decision' | 'pattern' | 'correction' | 'memory' | 'graph' | 'episode' | 'cross-project'
-  project?: string
-  date?: string
-  metadata?: Record<string, unknown>
-}
-
-/**
- * Normalize raw searchRaw() results into flat NormalizedResult[]
- * Handles the nested { memory: { id }, decision: { id } } structure
- */
-/**
- * Ensure a value is a string — prevents [object Object] in template literals
- */
-function ensureString(val: unknown): string {
-  if (typeof val === 'string') return val
-  if (val === null || val === undefined) return ''
-  if (typeof val === 'object') return JSON.stringify(val)
-  return String(val)
-}
-
-export function normalizeSearchResults(rawResults: any[]): NormalizedResult[] {
-  return rawResults.map(r => {
-    const id = r.memory?.id || r.decision?.id || r.id || ''
-    const project = r.memory?.project || r.decision?.project || r.metadata?.project || ''
-    const date = r.memory?.createdAt || r.decision?.createdAt || r.metadata?.created_at || ''
-
-    // Prefer decision content, fall back to memory content
-    let content: string
-    if (r.decision?.decision) {
-      content = ensureString(r.decision.decision)
-      if (r.decision.reasoning) {
-        content = `**${content}**\n${ensureString(r.decision.reasoning)}`
-      }
-    } else if (r.memory?.content) {
-      content = ensureString(r.memory.content)
-    } else if (r.content) {
-      content = ensureString(r.content)
-    } else {
-      content = ''
-    }
-
-    return {
-      id,
-      content,
-      score: r.similarity || r.score || 0,
-      source: r.decision ? 'decision' as const : 'memory' as const,
-      project: typeof project === 'string' ? project : String(project),
-      date: date instanceof Date ? date.toISOString() : typeof date === 'string' ? date : '',
-      metadata: r.metadata || (r.decision ? { ...r.decision } : r.memory?.metadata) || {}
-    }
-  })
-}
-
-/**
- * Normalize pattern search results
- */
-export function normalizePatternResults(results: any[]): NormalizedResult[] {
-  return results.map(p => ({
-    id: p.id || '',
-    content: ensureString(p.metadata?.description || p.description || p.content || ''),
-    score: p.similarity || p.score || 0,
-    source: 'pattern' as const,
-    project: ensureString(p.metadata?.project || p.project || ''),
-    date: ensureString(p.metadata?.created_at || ''),
-    metadata: p.metadata || {}
-  }))
-}
-
-/**
- * Normalize correction search results
- */
-export function normalizeCorrectionResults(results: any[]): NormalizedResult[] {
-  return results.map(c => ({
-    id: c.id || '',
-    content: `Original: ${ensureString(c.metadata?.original || c.original || '')}\nFix: ${ensureString(c.metadata?.correction || c.correction || c.content || '')}`,
-    score: c.similarity || c.score || 0,
-    source: 'correction' as const,
-    project: ensureString(c.metadata?.project || c.project || ''),
-    date: ensureString(c.metadata?.created_at || ''),
-    metadata: c.metadata || {}
-  }))
-}
+/**
+ * Routing Types
+ * Phase 19: Normalized result types for the brain() router
+ *
+ * Eliminates scattered `r.decision?.decision || r.content?.slice(0, 300)`
+ * by normalizing all search results to a flat structure.
+ */
+
+export interface NormalizedResult {
+  id: string
+  content: string
+  score: number
+  source: 'decision' | 'pattern' | 'correction' | 'memory' | 'graph' | 'episode' | 'cross-project'
+  project?: string
+  date?: string
+  metadata?: Record<string, unknown>
+}
+
+/**
+ * Normalize raw searchRaw() results into flat NormalizedResult[]
+ * Handles the nested { memory: { id }, decision: { id } } structure
+ */
+/**
+ * Ensure a value is a string — prevents [object Object] in template literals
+ */
+function ensureString(val: unknown): string {
+  if (typeof val === 'string') return val
+  if (val === null || val === undefined) return ''
+  if (typeof val === 'object') return JSON.stringify(val)
+  return String(val)
+}
+
+export function normalizeSearchResults(rawResults: any[]): NormalizedResult[] {
+  return rawResults.map(r => {
+    const id = r.memory?.id || r.decision?.id || r.id || ''
+    const project = r.memory?.project || r.decision?.project || r.metadata?.project || ''
+    const date = r.memory?.createdAt || r.decision?.createdAt || r.metadata?.created_at || ''
+
+    // Prefer decision content, fall back to memory content
+    let content: string
+    if (r.decision?.decision) {
+      content = ensureString(r.decision.decision)
+      if (r.decision.reasoning) {
+        content = `**${content}**\n${ensureString(r.decision.reasoning)}`
+      }
+    } else if (r.memory?.content) {
+      content = ensureString(r.memory.content)
+    } else if (r.content) {
+      content = ensureString(r.content)
+    } else {
+      content = ''
+    }
+
+    return {
+      id,
+      content,
+      score: r.similarity || r.score || 0,
+      source: r.decision ? 'decision' as const : 'memory' as const,
+      project: typeof project === 'string' ? project : String(project),
+      date: date instanceof Date ? date.toISOString() : typeof date === 'string' ? date : '',
+      metadata: r.metadata || (r.decision ? { ...r.decision } : r.memory?.metadata) || {}
+    }
+  })
+}
+
+/**
+ * Normalize pattern search results
+ */
+export function normalizePatternResults(results: any[]): NormalizedResult[] {
+  return results.map(p => ({
+    id: p.id || '',
+    content: ensureString(p.metadata?.description || p.description || p.content || ''),
+    score: p.similarity || p.score || 0,
+    source: 'pattern' as const,
+    project: ensureString(p.metadata?.project || p.project || ''),
+    date: ensureString(p.metadata?.created_at || ''),
+    metadata: p.metadata || {}
+  }))
+}
+
+/**
+ * Normalize correction search results
+ */
+export function normalizeCorrectionResults(results: any[]): NormalizedResult[] {
+  return results.map(c => ({
+    id: c.id || '',
+    content: `Original: ${ensureString(c.metadata?.original || c.original || '')}\nFix: ${ensureString(c.metadata?.correction || c.correction || c.content || '')}`,
+    score: c.similarity || c.score || 0,
+    source: 'correction' as const,
+    project: ensureString(c.metadata?.project || c.project || ''),
+    date: ensureString(c.metadata?.created_at || ''),
+    metadata: c.metadata || {}
+  }))
+}

package/src/scripts/health-check.ts

@@ -1,118 +1,118 @@
-#!/usr/bin/env bun
-
-import { existsSync, statSync, accessSync, constants } from 'node:fs'
-import { resolve } from 'node:path'
-import { loadConfig } from '@/config'
-
-interface HealthCheck {
-  name: string
-  status: 'pass' | 'fail' | 'warn'
-  message: string
-}
-
-const checks: HealthCheck[] = []
-
-function addCheck(name: string, status: HealthCheck['status'], message: string) {
-  checks.push({ name, status, message })
-}
-
-async function checkConfig(): Promise<void> {
-  try {
-    const config = await loadConfig()
-    addCheck('Configuration', 'pass', 'Loaded and validated')
-  } catch (error) {
-    addCheck('Configuration', 'fail', error instanceof Error ? error.message : 'Failed to load')
-  }
-}
-
-function checkDirectory(name: string, path: string): void {
-  const dirPath = resolve(process.cwd(), path)
-  if (existsSync(dirPath)) {
-    try {
-      accessSync(dirPath, constants.R_OK | constants.W_OK)
-      addCheck(name, 'pass', `${path}/ exists and is writable`)
-    } catch {
-      addCheck(name, 'fail', `${path}/ exists but is not writable`)
-    }
-  } else {
-    addCheck(name, 'warn', `${path}/ does not exist`)
-  }
-}
-
-async function checkVaultPath(): Promise<void> {
-  try {
-    const config = await loadConfig()
-    if (!config.vaultPath || config.vaultPath === '/path/to/your/obsidian/vault') {
-      addCheck('Vault Path', 'warn', 'Not configured')
-      return
-    }
-
-    if (existsSync(config.vaultPath)) {
-      const stats = statSync(config.vaultPath)
-      if (stats.isDirectory()) {
-        addCheck('Vault Path', 'pass', `Exists: ${config.vaultPath}`)
-      } else {
-        addCheck('Vault Path', 'fail', 'Path exists but is not a directory')
-      }
-    } else {
-      addCheck('Vault Path', 'fail', `Does not exist: ${config.vaultPath}`)
-    }
-  } catch {
-    addCheck('Vault Path', 'warn', 'Could not verify (config error)')
-  }
-}
-
-function checkDependencies(): void {
-  const pkgPath = resolve(process.cwd(), 'package.json')
-  if (!existsSync(pkgPath)) {
-    addCheck('Dependencies', 'fail', 'package.json not found')
-    return
-  }
-
-  const nodeModulesPath = resolve(process.cwd(), 'node_modules')
-  if (!existsSync(nodeModulesPath)) {
-    addCheck('Dependencies', 'fail', 'node_modules not found - run bun install')
-    return
-  }
-
-  const requiredDeps = ['hono', '@modelcontextprotocol/sdk', 'zod', 'pino']
-  const missingDeps = requiredDeps.filter(dep =>
-    !existsSync(resolve(nodeModulesPath, dep))
-  )
-
-  if (missingDeps.length > 0) {
-    addCheck('Dependencies', 'fail', `Missing: ${missingDeps.join(', ')}`)
-  } else {
-    addCheck('Dependencies', 'pass', 'All required dependencies installed')
-  }
-}
-
-async function main() {
-  console.log('\n🏥 Claude Brain Health Check\n')
-  console.log('═'.repeat(50))
-
-  await checkConfig()
-  checkDirectory('Data Directory', 'data')
-  checkDirectory('Logs Directory', 'logs')
-  await checkVaultPath()
-  checkDependencies()
-
-  console.log('')
-  for (const check of checks) {
-    const symbol = check.status === 'pass' ? '✓' : check.status === 'warn' ? '⚠' : '✗'
-    const color = check.status === 'pass' ? '\x1b[32m' : check.status === 'warn' ? '\x1b[33m' : '\x1b[31m'
-    console.log(`${color}${symbol}\x1b[0m ${check.name}: ${check.message}`)
-  }
-
-  console.log('\n' + '═'.repeat(50))
-
-  const failures = checks.filter(c => c.status === 'fail').length
-  const warnings = checks.filter(c => c.status === 'warn').length
-  const passes = checks.filter(c => c.status === 'pass').length
-
-  console.log(`\nResults: ${passes} passed, ${warnings} warnings, ${failures} failed\n`)
-
-  process.exit(failures > 0 ? 1 : 0)
-}
-
-main()
+#!/usr/bin/env bun
+
+import { existsSync, statSync, accessSync, constants } from 'node:fs'
+import { resolve } from 'node:path'
+import { loadConfig } from '@/config'
+
+interface HealthCheck {
+  name: string
+  status: 'pass' | 'fail' | 'warn'
+  message: string
+}
+
+const checks: HealthCheck[] = []
+
+function addCheck(name: string, status: HealthCheck['status'], message: string) {
+  checks.push({ name, status, message })
+}
+
+async function checkConfig(): Promise<void> {
+  try {
+    const config = await loadConfig()
+    addCheck('Configuration', 'pass', 'Loaded and validated')
+  } catch (error) {
+    addCheck('Configuration', 'fail', error instanceof Error ? error.message : 'Failed to load')
+  }
+}
+
+function checkDirectory(name: string, path: string): void {
+  const dirPath = resolve(process.cwd(), path)
+  if (existsSync(dirPath)) {
+    try {
+      accessSync(dirPath, constants.R_OK | constants.W_OK)
+      addCheck(name, 'pass', `${path}/ exists and is writable`)
+    } catch {
+      addCheck(name, 'fail', `${path}/ exists but is not writable`)
+    }
+  } else {
+    addCheck(name, 'warn', `${path}/ does not exist`)
+  }
+}
+
+async function checkVaultPath(): Promise<void> {
+  try {
+    const config = await loadConfig()
+    if (!config.vaultPath || config.vaultPath === '/path/to/your/obsidian/vault') {
+      addCheck('Vault Path', 'warn', 'Not configured')
+      return
+    }
+
+    if (existsSync(config.vaultPath)) {
+      const stats = statSync(config.vaultPath)
+      if (stats.isDirectory()) {
+        addCheck('Vault Path', 'pass', `Exists: ${config.vaultPath}`)
+      } else {
+        addCheck('Vault Path', 'fail', 'Path exists but is not a directory')
+      }
+    } else {
+      addCheck('Vault Path', 'fail', `Does not exist: ${config.vaultPath}`)
+    }
+  } catch {
+    addCheck('Vault Path', 'warn', 'Could not verify (config error)')
+  }
+}
+
+function checkDependencies(): void {
+  const pkgPath = resolve(process.cwd(), 'package.json')
+  if (!existsSync(pkgPath)) {
+    addCheck('Dependencies', 'fail', 'package.json not found')
+    return
+  }
+
+  const nodeModulesPath = resolve(process.cwd(), 'node_modules')
+  if (!existsSync(nodeModulesPath)) {
+    addCheck('Dependencies', 'fail', 'node_modules not found - run bun install')
+    return
+  }
+
+  const requiredDeps = ['hono', '@modelcontextprotocol/sdk', 'zod', 'pino']
+  const missingDeps = requiredDeps.filter(dep =>
+    !existsSync(resolve(nodeModulesPath, dep))
+  )
+
+  if (missingDeps.length > 0) {
+    addCheck('Dependencies', 'fail', `Missing: ${missingDeps.join(', ')}`)
+  } else {
+    addCheck('Dependencies', 'pass', 'All required dependencies installed')
+  }
+}
+
+async function main() {
+  console.log('\n🏥 Claude Brain Health Check\n')
+  console.log('═'.repeat(50))
+
+  await checkConfig()
+  checkDirectory('Data Directory', 'data')
+  checkDirectory('Logs Directory', 'logs')
+  await checkVaultPath()
+  checkDependencies()
+
+  console.log('')
+  for (const check of checks) {
+    const symbol = check.status === 'pass' ? '✓' : check.status === 'warn' ? '⚠' : '✗'
+    const color = check.status === 'pass' ? '\x1b[32m' : check.status === 'warn' ? '\x1b[33m' : '\x1b[31m'
+    console.log(`${color}${symbol}\x1b[0m ${check.name}: ${check.message}`)
+  }
+
+  console.log('\n' + '═'.repeat(50))
+
+  const failures = checks.filter(c => c.status === 'fail').length
+  const warnings = checks.filter(c => c.status === 'warn').length
+  const passes = checks.filter(c => c.status === 'pass').length
+
+  console.log(`\nResults: ${passes} passed, ${warnings} warnings, ${failures} failed\n`)
+
+  process.exit(failures > 0 ? 1 : 0)
+}
+
+main()

package/src/scripts/setup.ts

@@ -1,122 +1,122 @@
-#!/usr/bin/env bun
-
-import { existsSync, mkdirSync, copyFileSync } from 'node:fs'
-import { resolve } from 'node:path'
-import { loadConfig, validateConfig } from '@/config'
-
-const REQUIRED_BUN_VERSION = '1.0.0'
-const REQUIRED_DIRS = ['data', 'logs']
-
-function log(message: string, type: 'info' | 'success' | 'warn' | 'error' = 'info') {
-  const symbols = { info: 'ℹ', success: '✓', warn: '⚠', error: '✗' }
-  console.log(`${symbols[type]} ${message}`)
-}
-
-function checkBunVersion(): boolean {
-  const version = Bun.version
-  const [major, minor, patch] = version.split('.').map(Number)
-  const [reqMajor, reqMinor, reqPatch] = REQUIRED_BUN_VERSION.split('.').map(Number)
-
-  if (major > reqMajor || (major === reqMajor && minor > reqMinor) ||
-      (major === reqMajor && minor === reqMinor && patch >= reqPatch)) {
-    log(`Bun version ${version} >= ${REQUIRED_BUN_VERSION}`, 'success')
-    return true
-  }
-
-  log(`Bun version ${version} < ${REQUIRED_BUN_VERSION} required`, 'error')
-  return false
-}
-
-function createDirectories(): boolean {
-  let success = true
-  for (const dir of REQUIRED_DIRS) {
-    const dirPath = resolve(process.cwd(), dir)
-    if (!existsSync(dirPath)) {
-      try {
-        mkdirSync(dirPath, { recursive: true })
-        log(`Created directory: ${dir}`, 'success')
-      } catch (error) {
-        log(`Failed to create directory: ${dir}`, 'error')
-        success = false
-      }
-    } else {
-      log(`Directory exists: ${dir}`, 'info')
-    }
-  }
-  return success
-}
-
-function checkEnvFile(): boolean {
-  const envPath = resolve(process.cwd(), '.env')
-  const examplePath = resolve(process.cwd(), '.env.example')
-
-  if (!existsSync(envPath) && existsSync(examplePath)) {
-    try {
-      copyFileSync(examplePath, envPath)
-      log('Created .env from .env.example - please update with your settings', 'warn')
-    } catch {
-      log('Failed to copy .env.example to .env', 'error')
-      return false
-    }
-  } else if (existsSync(envPath)) {
-    log('.env file exists', 'success')
-  } else {
-    log('No .env or .env.example found', 'warn')
-  }
-  return true
-}
-
-async function validateConfiguration(): Promise<boolean> {
-  try {
-    const config = await loadConfig()
-    log('Configuration validated successfully', 'success')
-
-    if (!config.vaultPath || config.vaultPath === '/path/to/your/obsidian/vault') {
-      log('VAULT_PATH not configured - update .env with your Obsidian vault path', 'warn')
-    } else if (!existsSync(config.vaultPath)) {
-      log(`Vault path does not exist: ${config.vaultPath}`, 'warn')
-    } else {
-      log(`Vault path exists: ${config.vaultPath}`, 'success')
-    }
-
-    return true
-  } catch (error) {
-    log(`Configuration error: ${error instanceof Error ? error.message : error}`, 'error')
-    return false
-  }
-}
-
-async function main() {
-  console.log('\n🧠 Claude Brain Setup\n')
-  console.log('═'.repeat(40))
-
-  let allPassed = true
-
-  // Check Bun version
-  console.log('\n📦 Checking Bun version...')
-  allPassed = checkBunVersion() && allPassed
-
-  // Create required directories
-  console.log('\n📁 Creating directories...')
-  allPassed = createDirectories() && allPassed
-
-  // Check/create .env file
-  console.log('\n⚙️  Checking environment...')
-  allPassed = checkEnvFile() && allPassed
-
-  // Validate configuration
-  console.log('\n🔍 Validating configuration...')
-  allPassed = await validateConfiguration() && allPassed
-
-  console.log('\n' + '═'.repeat(40))
-
-  if (allPassed) {
-    console.log('\n✅ Setup complete! Run `bun run dev` to start development.\n')
-    process.exit(0)
-  } else {
-    console.log('\n⚠️  Setup completed with warnings. Please review above messages.\n')
-    process.exit(1)
-  }
-}
-
-main()
+#!/usr/bin/env bun
+
+import { existsSync, mkdirSync, copyFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { loadConfig, validateConfig } from '@/config'
+
+const REQUIRED_BUN_VERSION = '1.0.0'
+const REQUIRED_DIRS = ['data', 'logs']
+
+function log(message: string, type: 'info' | 'success' | 'warn' | 'error' = 'info') {
+  const symbols = { info: 'ℹ', success: '✓', warn: '⚠', error: '✗' }
+  console.log(`${symbols[type]} ${message}`)
+}
+
+function checkBunVersion(): boolean {
+  const version = Bun.version
+  const [major, minor, patch] = version.split('.').map(Number)
+  const [reqMajor, reqMinor, reqPatch] = REQUIRED_BUN_VERSION.split('.').map(Number)
+
+  if (major > reqMajor || (major === reqMajor && minor > reqMinor) ||
+      (major === reqMajor && minor === reqMinor && patch >= reqPatch)) {
+    log(`Bun version ${version} >= ${REQUIRED_BUN_VERSION}`, 'success')
+    return true
+  }
+
+  log(`Bun version ${version} < ${REQUIRED_BUN_VERSION} required`, 'error')
+  return false
+}
+
+function createDirectories(): boolean {
+  let success = true
+  for (const dir of REQUIRED_DIRS) {
+    const dirPath = resolve(process.cwd(), dir)
+    if (!existsSync(dirPath)) {
+      try {
+        mkdirSync(dirPath, { recursive: true })
+        log(`Created directory: ${dir}`, 'success')
+      } catch (error) {
+        log(`Failed to create directory: ${dir}`, 'error')
+        success = false
+      }
+    } else {
+      log(`Directory exists: ${dir}`, 'info')
+    }
+  }
+  return success
+}
+
+function checkEnvFile(): boolean {
+  const envPath = resolve(process.cwd(), '.env')
+  const examplePath = resolve(process.cwd(), '.env.example')
+
+  if (!existsSync(envPath) && existsSync(examplePath)) {
+    try {
+      copyFileSync(examplePath, envPath)
+      log('Created .env from .env.example - please update with your settings', 'warn')
+    } catch {
+      log('Failed to copy .env.example to .env', 'error')
+      return false
+    }
+  } else if (existsSync(envPath)) {
+    log('.env file exists', 'success')
+  } else {
+    log('No .env or .env.example found', 'warn')
+  }
+  return true
+}
+
+async function validateConfiguration(): Promise<boolean> {
+  try {
+    const config = await loadConfig()
+    log('Configuration validated successfully', 'success')
+
+    if (!config.vaultPath || config.vaultPath === '/path/to/your/obsidian/vault') {
+      log('VAULT_PATH not configured - update .env with your Obsidian vault path', 'warn')
+    } else if (!existsSync(config.vaultPath)) {
+      log(`Vault path does not exist: ${config.vaultPath}`, 'warn')
+    } else {
+      log(`Vault path exists: ${config.vaultPath}`, 'success')
+    }
+
+    return true
+  } catch (error) {
+    log(`Configuration error: ${error instanceof Error ? error.message : error}`, 'error')
+    return false
+  }
+}
+
+async function main() {
+  console.log('\n🧠 Claude Brain Setup\n')
+  console.log('═'.repeat(40))
+
+  let allPassed = true
+
+  // Check Bun version
+  console.log('\n📦 Checking Bun version...')
+  allPassed = checkBunVersion() && allPassed
+
+  // Create required directories
+  console.log('\n📁 Creating directories...')
+  allPassed = createDirectories() && allPassed
+
+  // Check/create .env file
+  console.log('\n⚙️  Checking environment...')
+  allPassed = checkEnvFile() && allPassed
+
+  // Validate configuration
+  console.log('\n🔍 Validating configuration...')
+  allPassed = await validateConfiguration() && allPassed
+
+  console.log('\n' + '═'.repeat(40))
+
+  if (allPassed) {
+    console.log('\n✅ Setup complete! Run `bun run dev` to start development.\n')
+    process.exit(0)
+  } else {
+    console.log('\n⚠️  Setup completed with warnings. Please review above messages.\n')
+    process.exit(1)
+  }
+}
+
+main()