claude-brain 0.30.2 → 0.30.3

package/src/config/loader.ts

@@ -1,192 +1,192 @@
-import { existsSync, readFileSync } from 'node:fs'
-import { resolve } from 'node:path'
-import { ConfigSchema, type Config } from './schema'
-import { defaultConfig } from './defaults'
-import { getClaudeBrainHome, resolveHomePath } from './home'
-
-/** Parse a .env file without dotenv (avoids stdout pollution from dotenv v17) */
-function loadEnvFile(filePath: string): void {
-  if (!existsSync(filePath)) return
-  const content = readFileSync(filePath, 'utf-8')
-  for (const line of content.split('\n')) {
-    const trimmed = line.trim()
-    if (!trimmed || trimmed.startsWith('#')) continue
-    const eqIdx = trimmed.indexOf('=')
-    if (eqIdx === -1) continue
-    const key = trimmed.slice(0, eqIdx).trim()
-    const val = trimmed.slice(eqIdx + 1).trim()
-    // Don't override existing env vars
-    if (!(key in process.env)) {
-      process.env[key] = val
-    }
-  }
-}
-
-const CONFIG_FILE_NAME = '.claudebrainrc.json'
-
-/** Load configuration from a JSON file if it exists */
-function loadFromFile(basePath: string): Partial<Config> {
-  // Check basePath first, then Claude Brain home
-  for (const dir of [basePath, getClaudeBrainHome()]) {
-    const configPath = resolve(dir, CONFIG_FILE_NAME)
-    if (!existsSync(configPath)) {
-      continue
-    }
-
-    try {
-      const content = readFileSync(configPath, 'utf-8')
-      return JSON.parse(content) as Partial<Config>
-    } catch (error) {
-      console.warn(`Warning: Failed to parse config file at ${configPath}:`, error)
-      return {}
-    }
-  }
-
-  return {}
-}
-
-/** Load configuration from environment variables */
-function loadFromEnv(): Partial<Config> {
-  // Skip .env loading if SKIP_DOTENV is set (for MCP servers where env is provided externally)
-  if (!process.env.SKIP_DOTENV) {
-    // Use custom parser instead of dotenv v17 (which prints to stdout and breaks MCP stdio)
-    loadEnvFile(resolve(getClaudeBrainHome(), '.env'))
-  }
-
-  const config: Partial<Config> = {}
-
-  if (process.env.VAULT_PATH) {
-    config.vaultPath = process.env.VAULT_PATH
-  }
-  if (process.env.MCP_SERVER_NAME) {
-    config.serverName = process.env.MCP_SERVER_NAME
-  }
-  if (process.env.MCP_SERVER_VERSION) {
-    config.serverVersion = process.env.MCP_SERVER_VERSION
-  }
-  if (process.env.LOG_LEVEL) {
-    config.logLevel = process.env.LOG_LEVEL as Config['logLevel']
-  }
-  if (process.env.LOG_FILE_PATH) {
-    config.logFilePath = process.env.LOG_FILE_PATH
-  }
-  if (process.env.DB_PATH) {
-    config.dbPath = process.env.DB_PATH
-  }
-  if (process.env.PORT) {
-    config.port = parseInt(process.env.PORT, 10)
-  }
-  if (process.env.ENABLE_FILE_WATCH) {
-    config.enableFileWatch = process.env.ENABLE_FILE_WATCH === 'true'
-  }
-  if (process.env.CACHE_SIZE) {
-    config.cacheSize = parseInt(process.env.CACHE_SIZE, 10)
-  }
-  if (process.env.NODE_ENV) {
-    config.nodeEnv = process.env.NODE_ENV as Config['nodeEnv']
-  }
-
-  // Retrieval configuration
-  const retrieval = (config as Record<string, any>)
-  if (process.env.RETRIEVAL_ENABLED) {
-    retrieval.retrieval = retrieval.retrieval || {}
-    retrieval.retrieval.enabled = process.env.RETRIEVAL_ENABLED === 'true'
-  }
-  if (process.env.RETRIEVAL_DENSE_WEIGHT) {
-    retrieval.retrieval = retrieval.retrieval || {}
-    retrieval.retrieval.dense = retrieval.retrieval.dense || {}
-    retrieval.retrieval.dense.weight = parseFloat(process.env.RETRIEVAL_DENSE_WEIGHT)
-  }
-  if (process.env.RETRIEVAL_SPARSE_ENABLED) {
-    retrieval.retrieval = retrieval.retrieval || {}
-    retrieval.retrieval.sparse = retrieval.retrieval.sparse || {}
-    retrieval.retrieval.sparse.enabled = process.env.RETRIEVAL_SPARSE_ENABLED === 'true'
-  }
-  if (process.env.RETRIEVAL_SPARSE_WEIGHT) {
-    retrieval.retrieval = retrieval.retrieval || {}
-    retrieval.retrieval.sparse = retrieval.retrieval.sparse || {}
-    retrieval.retrieval.sparse.weight = parseFloat(process.env.RETRIEVAL_SPARSE_WEIGHT)
-  }
-  if (process.env.RETRIEVAL_FUSION_METHOD) {
-    retrieval.retrieval = retrieval.retrieval || {}
-    retrieval.retrieval.fusion = retrieval.retrieval.fusion || {}
-    retrieval.retrieval.fusion.method = process.env.RETRIEVAL_FUSION_METHOD as 'rrf' | 'linear' | 'max'
-  }
-  if (process.env.RETRIEVAL_RRF_K) {
-    retrieval.retrieval = retrieval.retrieval || {}
-    retrieval.retrieval.fusion = retrieval.retrieval.fusion || {}
-    retrieval.retrieval.fusion.rrfK = parseInt(process.env.RETRIEVAL_RRF_K, 10)
-  }
-  if (process.env.RETRIEVAL_RERANKER_ENABLED) {
-    retrieval.retrieval = retrieval.retrieval || {}
-    retrieval.retrieval.reranker = retrieval.retrieval.reranker || {}
-    retrieval.retrieval.reranker.enabled = process.env.RETRIEVAL_RERANKER_ENABLED === 'true'
-  }
-  if (process.env.RETRIEVAL_RERANKER_MODEL) {
-    retrieval.retrieval = retrieval.retrieval || {}
-    retrieval.retrieval.reranker = retrieval.retrieval.reranker || {}
-    retrieval.retrieval.reranker.model = process.env.RETRIEVAL_RERANKER_MODEL
-  }
-  if (process.env.RETRIEVAL_FEEDBACK_ENABLED) {
-    retrieval.retrieval = retrieval.retrieval || {}
-    retrieval.retrieval.feedback = retrieval.retrieval.feedback || {}
-    retrieval.retrieval.feedback.enabled = process.env.RETRIEVAL_FEEDBACK_ENABLED === 'true'
-  }
-
-  return config
-}
-
-/** Merge multiple partial configs, later values override earlier */
-function mergeConfigs(...configs: Partial<Config>[]): Partial<Config> {
-  return configs.reduce<Partial<Config>>((acc, config) => {
-    return { ...acc, ...Object.fromEntries(Object.entries(config).filter(([_, v]) => v !== undefined)) }
-  }, {})
-}
-
-/** Load and validate configuration from all sources */
-export async function loadConfig(basePath: string = process.cwd()): Promise<Config> {
-  const fileConfig = loadFromFile(basePath)
-  const envConfig = loadFromEnv()
-
-  const merged = mergeConfigs(defaultConfig as Partial<Config>, fileConfig, envConfig)
-
-  const result = ConfigSchema.safeParse(merged)
-
-  if (!result.success) {
-    const errors = result.error.issues
-      .map(e => `  - ${e.path.join('.')}: ${e.message}`)
-      .join('\n')
-    throw new Error(`Configuration validation failed:\n${errors}`)
-  }
-
-  // Resolve relative paths against Claude Brain home
-  const data = result.data
-  data.logFilePath = resolveHomePath(data.logFilePath)
-  data.dbPath = resolveHomePath(data.dbPath)
-
-  // Always resolve knowledge graph path to absolute
-  // Zod .default({}) on nested objects means graph/persistPath may not exist
-  if (!data.knowledge) data.knowledge = {} as any
-  if (!data.knowledge.graph) data.knowledge.graph = {} as any
-  data.knowledge.graph.persistPath = resolveHomePath(
-    data.knowledge.graph.persistPath || './data/knowledge-graph.json'
-  )
-
-  // Phase 30: Auto-detect vaultPath if not configured
-  if (!data.vaultPath) {
-    const { getHomePaths } = await import('./home')
-    data.vaultPath = getHomePaths().vault
-  }
-
-  return data
-}
-
-/** Validate a partial configuration object */
-export function validateConfig(config: unknown): config is Config {
-  return ConfigSchema.safeParse(config).success
-}
-
-/** Get the path to the config file */
-export function getConfigFilePath(basePath: string = process.cwd()): string {
-  return resolve(basePath, CONFIG_FILE_NAME)
-}
+import { existsSync, readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { ConfigSchema, type Config } from './schema'
+import { defaultConfig } from './defaults'
+import { getClaudeBrainHome, resolveHomePath } from './home'
+
+/** Parse a .env file without dotenv (avoids stdout pollution from dotenv v17) */
+function loadEnvFile(filePath: string): void {
+  if (!existsSync(filePath)) return
+  const content = readFileSync(filePath, 'utf-8')
+  for (const line of content.split('\n')) {
+    const trimmed = line.trim()
+    if (!trimmed || trimmed.startsWith('#')) continue
+    const eqIdx = trimmed.indexOf('=')
+    if (eqIdx === -1) continue
+    const key = trimmed.slice(0, eqIdx).trim()
+    const val = trimmed.slice(eqIdx + 1).trim()
+    // Don't override existing env vars
+    if (!(key in process.env)) {
+      process.env[key] = val
+    }
+  }
+}
+
+const CONFIG_FILE_NAME = '.claudebrainrc.json'
+
+/** Load configuration from a JSON file if it exists */
+function loadFromFile(basePath: string): Partial<Config> {
+  // Check basePath first, then Claude Brain home
+  for (const dir of [basePath, getClaudeBrainHome()]) {
+    const configPath = resolve(dir, CONFIG_FILE_NAME)
+    if (!existsSync(configPath)) {
+      continue
+    }
+
+    try {
+      const content = readFileSync(configPath, 'utf-8')
+      return JSON.parse(content) as Partial<Config>
+    } catch (error) {
+      console.warn(`Warning: Failed to parse config file at ${configPath}:`, error)
+      return {}
+    }
+  }
+
+  return {}
+}
+
+/** Load configuration from environment variables */
+function loadFromEnv(): Partial<Config> {
+  // Skip .env loading if SKIP_DOTENV is set (for MCP servers where env is provided externally)
+  if (!process.env.SKIP_DOTENV) {
+    // Use custom parser instead of dotenv v17 (which prints to stdout and breaks MCP stdio)
+    loadEnvFile(resolve(getClaudeBrainHome(), '.env'))
+  }
+
+  const config: Partial<Config> = {}
+
+  if (process.env.VAULT_PATH) {
+    config.vaultPath = process.env.VAULT_PATH
+  }
+  if (process.env.MCP_SERVER_NAME) {
+    config.serverName = process.env.MCP_SERVER_NAME
+  }
+  if (process.env.MCP_SERVER_VERSION) {
+    config.serverVersion = process.env.MCP_SERVER_VERSION
+  }
+  if (process.env.LOG_LEVEL) {
+    config.logLevel = process.env.LOG_LEVEL as Config['logLevel']
+  }
+  if (process.env.LOG_FILE_PATH) {
+    config.logFilePath = process.env.LOG_FILE_PATH
+  }
+  if (process.env.DB_PATH) {
+    config.dbPath = process.env.DB_PATH
+  }
+  if (process.env.PORT) {
+    config.port = parseInt(process.env.PORT, 10)
+  }
+  if (process.env.ENABLE_FILE_WATCH) {
+    config.enableFileWatch = process.env.ENABLE_FILE_WATCH === 'true'
+  }
+  if (process.env.CACHE_SIZE) {
+    config.cacheSize = parseInt(process.env.CACHE_SIZE, 10)
+  }
+  if (process.env.NODE_ENV) {
+    config.nodeEnv = process.env.NODE_ENV as Config['nodeEnv']
+  }
+
+  // Retrieval configuration
+  const retrieval = (config as Record<string, any>)
+  if (process.env.RETRIEVAL_ENABLED) {
+    retrieval.retrieval = retrieval.retrieval || {}
+    retrieval.retrieval.enabled = process.env.RETRIEVAL_ENABLED === 'true'
+  }
+  if (process.env.RETRIEVAL_DENSE_WEIGHT) {
+    retrieval.retrieval = retrieval.retrieval || {}
+    retrieval.retrieval.dense = retrieval.retrieval.dense || {}
+    retrieval.retrieval.dense.weight = parseFloat(process.env.RETRIEVAL_DENSE_WEIGHT)
+  }
+  if (process.env.RETRIEVAL_SPARSE_ENABLED) {
+    retrieval.retrieval = retrieval.retrieval || {}
+    retrieval.retrieval.sparse = retrieval.retrieval.sparse || {}
+    retrieval.retrieval.sparse.enabled = process.env.RETRIEVAL_SPARSE_ENABLED === 'true'
+  }
+  if (process.env.RETRIEVAL_SPARSE_WEIGHT) {
+    retrieval.retrieval = retrieval.retrieval || {}
+    retrieval.retrieval.sparse = retrieval.retrieval.sparse || {}
+    retrieval.retrieval.sparse.weight = parseFloat(process.env.RETRIEVAL_SPARSE_WEIGHT)
+  }
+  if (process.env.RETRIEVAL_FUSION_METHOD) {
+    retrieval.retrieval = retrieval.retrieval || {}
+    retrieval.retrieval.fusion = retrieval.retrieval.fusion || {}
+    retrieval.retrieval.fusion.method = process.env.RETRIEVAL_FUSION_METHOD as 'rrf' | 'linear' | 'max'
+  }
+  if (process.env.RETRIEVAL_RRF_K) {
+    retrieval.retrieval = retrieval.retrieval || {}
+    retrieval.retrieval.fusion = retrieval.retrieval.fusion || {}
+    retrieval.retrieval.fusion.rrfK = parseInt(process.env.RETRIEVAL_RRF_K, 10)
+  }
+  if (process.env.RETRIEVAL_RERANKER_ENABLED) {
+    retrieval.retrieval = retrieval.retrieval || {}
+    retrieval.retrieval.reranker = retrieval.retrieval.reranker || {}
+    retrieval.retrieval.reranker.enabled = process.env.RETRIEVAL_RERANKER_ENABLED === 'true'
+  }
+  if (process.env.RETRIEVAL_RERANKER_MODEL) {
+    retrieval.retrieval = retrieval.retrieval || {}
+    retrieval.retrieval.reranker = retrieval.retrieval.reranker || {}
+    retrieval.retrieval.reranker.model = process.env.RETRIEVAL_RERANKER_MODEL
+  }
+  if (process.env.RETRIEVAL_FEEDBACK_ENABLED) {
+    retrieval.retrieval = retrieval.retrieval || {}
+    retrieval.retrieval.feedback = retrieval.retrieval.feedback || {}
+    retrieval.retrieval.feedback.enabled = process.env.RETRIEVAL_FEEDBACK_ENABLED === 'true'
+  }
+
+  return config
+}
+
+/** Merge multiple partial configs, later values override earlier */
+function mergeConfigs(...configs: Partial<Config>[]): Partial<Config> {
+  return configs.reduce<Partial<Config>>((acc, config) => {
+    return { ...acc, ...Object.fromEntries(Object.entries(config).filter(([_, v]) => v !== undefined)) }
+  }, {})
+}
+
+/** Load and validate configuration from all sources */
+export async function loadConfig(basePath: string = process.cwd()): Promise<Config> {
+  const fileConfig = loadFromFile(basePath)
+  const envConfig = loadFromEnv()
+
+  const merged = mergeConfigs(defaultConfig as Partial<Config>, fileConfig, envConfig)
+
+  const result = ConfigSchema.safeParse(merged)
+
+  if (!result.success) {
+    const errors = result.error.issues
+      .map(e => `  - ${e.path.join('.')}: ${e.message}`)
+      .join('\n')
+    throw new Error(`Configuration validation failed:\n${errors}`)
+  }
+
+  // Resolve relative paths against Claude Brain home
+  const data = result.data
+  data.logFilePath = resolveHomePath(data.logFilePath)
+  data.dbPath = resolveHomePath(data.dbPath)
+
+  // Always resolve knowledge graph path to absolute
+  // Zod .default({}) on nested objects means graph/persistPath may not exist
+  if (!data.knowledge) data.knowledge = {} as Record<string, never>
+  if (!data.knowledge.graph) data.knowledge.graph = {} as Record<string, never>
+  data.knowledge.graph.persistPath = resolveHomePath(
+    data.knowledge.graph.persistPath || './data/knowledge-graph.json'
+  )
+
+  // Phase 30: Auto-detect vaultPath if not configured
+  if (!data.vaultPath) {
+    const { getHomePaths } = await import('./home')
+    data.vaultPath = getHomePaths().vault
+  }
+
+  return data
+}
+
+/** Validate a partial configuration object */
+export function validateConfig(config: unknown): config is Config {
+  return ConfigSchema.safeParse(config).success
+}
+
+/** Get the path to the config file */
+export function getConfigFilePath(basePath: string = process.cwd()): string {
+  return resolve(basePath, CONFIG_FILE_NAME)
+}