claude-brain 0.15.2 → 0.17.0

package/src/config/schema.ts

@@ -1,360 +1,360 @@
-import { z } from 'zod'
-
-/** Log level options for the application */
-export const LogLevelSchema = z.enum(['debug', 'info', 'warn', 'error'])
-export type LogLevel = z.infer<typeof LogLevelSchema>
-
-/** Retrieval configuration for hybrid search */
-export const RetrievalConfigSchema = z.object({
-  /** Enable hybrid retrieval pipeline (opt-in) */
-  enabled: z.boolean().default(false),
-
-  /** Dense (semantic) search configuration */
-  dense: z.object({
-    /** Weight for dense search in fusion (0-1) */
-    weight: z.number().min(0).max(1).default(0.7),
-    /** Maximum number of results from dense search */
-    limit: z.number().int().min(1).max(100).default(20),
-    /** Minimum similarity threshold (0-1) */
-    minSimilarity: z.number().min(0).max(1).default(0.3)
-  }).default({}),
-
-  /** Sparse (BM25) search configuration */
-  sparse: z.object({
-    /** Enable sparse search */
-    enabled: z.boolean().default(true),
-    /** Weight for sparse search in fusion (0-1) */
-    weight: z.number().min(0).max(1).default(0.3),
-    /** Maximum number of results from sparse search */
-    limit: z.number().int().min(1).max(100).default(20)
-  }).default({}),
-
-  /** Fusion configuration for combining results */
-  fusion: z.object({
-    /** Fusion method */
-    method: z.enum(['rrf', 'linear', 'max']).default('rrf'),
-    /** RRF k parameter (default 60 per original paper) */
-    rrfK: z.number().int().min(1).default(60)
-  }).default({}),
-
-  /** Cross-encoder reranking configuration */
-  reranker: z.object({
-    /** Enable cross-encoder reranking */
-    enabled: z.boolean().default(false),
-    /** Model to use for reranking */
-    model: z.string().default('cross-encoder/ms-marco-MiniLM-L-6-v2'),
-    /** Number of results to rerank */
-    topK: z.number().int().min(1).max(100).default(10)
-  }).default({}),
-
-  /** Query understanding configuration */
-  queryUnderstanding: z.object({
-    /** Enable query understanding */
-    enabled: z.boolean().default(true),
-    /** Enable intent classification */
-    intentClassification: z.boolean().default(true),
-    /** Enable query expansion */
-    queryExpansion: z.boolean().default(true),
-    /** Enable temporal parsing */
-    temporalParsing: z.boolean().default(true)
-  }).default({}),
-
-  /** Feedback collection configuration */
-  feedback: z.object({
-    /** Enable feedback collection */
-    enabled: z.boolean().default(true),
-    /** Enable adaptive threshold learning */
-    adaptiveThresholds: z.boolean().default(true),
-    /** Minimum feedback count before adaptation */
-    minFeedbackForAdaptation: z.number().int().min(1).default(10)
-  }).default({})
-})
-
-export type RetrievalConfig = z.infer<typeof RetrievalConfigSchema>
-
-/** Knowledge graph and episodic memory configuration */
-export const KnowledgeConfigSchema = z.object({
-  /** Entity extraction settings */
-  extraction: z.object({
-    /** Minimum confidence for extracted entities */
-    minConfidence: z.number().min(0).max(1).default(0.5),
-    /** Maximum entities to extract per text */
-    maxEntities: z.number().int().min(1).max(200).default(50)
-  }).default({}),
-
-  /** Knowledge graph settings */
-  graph: z.object({
-    /** Enable knowledge graph auto-population */
-    enabled: z.boolean().default(true),
-    /** Path for graph persistence */
-    persistPath: z.string().default('./data/knowledge-graph.json'),
-    /** Auto-save interval in seconds */
-    autoSaveInterval: z.number().int().min(10).default(60),
-    /** Maximum graph traversal depth */
-    maxTraversalDepth: z.number().int().min(1).max(10).default(5),
-    /** Alpha for combined scoring (vector vs graph proximity) */
-    alpha: z.number().min(0).max(1).default(0.6)
-  }).default({}),
-
-  /** Episodic memory settings */
-  episodic: z.object({
-    /** Enable episodic memory */
-    enabled: z.boolean().default(true),
-    /** Time gap in minutes to detect new session */
-    sessionGapMinutes: z.number().int().min(1).default(30),
-    /** Maximum messages per episode before auto-splitting */
-    maxMessagesPerEpisode: z.number().int().min(10).default(200),
-    /** Number of top sentences for brief summary */
-    briefSummarySize: z.number().int().min(1).max(10).default(2),
-    /** Number of top sentences for detailed summary */
-    detailedSummarySize: z.number().int().min(1).max(20).default(8)
-  }).default({}),
-
-  /** Memory consolidation settings */
-  consolidation: z.object({
-    /** Enable memory consolidation */
-    enabled: z.boolean().default(true),
-    /** Similarity threshold for merge candidates */
-    mergeThreshold: z.number().min(0).max(1).default(0.85),
-    /** Importance score threshold for archival */
-    archiveThreshold: z.number().min(0).max(1).default(0.2),
-    /** Importance scoring weights */
-    weights: z.object({
-      recency: z.number().min(0).max(1).default(0.2),
-      frequency: z.number().min(0).max(1).default(0.2),
-      references: z.number().min(0).max(1).default(0.2),
-      feedback: z.number().min(0).max(1).default(0.2),
-      uniqueness: z.number().min(0).max(1).default(0.2)
-    }).default({})
-  }).default({})
-})
-
-export type KnowledgeConfig = z.infer<typeof KnowledgeConfigSchema>
-
-/** Phase 17+20: Passive Learning via Hooks configuration */
-export const HooksConfigSchema = z.object({
-  /** Master switch for hooks passive learning (Phase 20: enabled by default) */
-  enabled: z.boolean().default(true),
-
-  /** What to capture from tool calls */
-  capture: z.object({
-    /** Capture knowledge from tool use (Edit/Write) */
-    toolUse: z.boolean().default(true),
-    /** Capture knowledge from file edits */
-    fileEdits: z.boolean().default(true),
-    /** Capture knowledge from bash commands */
-    bashCommands: z.boolean().default(true),
-    /** Capture knowledge from user messages */
-    userMessages: z.boolean().default(true)
-  }).default({}),
-
-  /** Privacy filters */
-  privacy: z.object({
-    /** File paths to ignore (glob patterns) — Phase 20: sensible defaults */
-    ignorePaths: z.array(z.string()).default([
-      'node_modules/**',
-      '.env*',
-      '*.key',
-      '*.pem',
-      '*.p12',
-      '*.pfx',
-      '.git/**',
-      'dist/**',
-      'build/**',
-      '*.secret',
-      'credentials*',
-      '.aws/**',
-      '.ssh/**'
-    ]),
-    /** Projects to ignore */
-    ignoreProjects: z.array(z.string()).default([]),
-    /** Minimum confidence to store captured knowledge */
-    minConfidence: z.number().min(0).max(1).default(0.7)
-  }).default({}),
-
-  /** Session tracking settings */
-  sessions: z.object({
-    /** Enable session tracking */
-    enabled: z.boolean().default(true),
-    /** Idle timeout in minutes before summarizing */
-    idleTimeoutMinutes: z.number().int().min(1).default(30),
-    /** Minimum events required before generating summary */
-    minEventsForSummary: z.number().int().min(1).default(3)
-  }).default({}),
-
-  /** Deduplication thresholds */
-  deduplication: z.object({
-    /** Similarity above this skips storage (exact duplicate) */
-    skipThreshold: z.number().min(0).max(1).default(0.95),
-    /** Similarity above this merges instead of creating new */
-    mergeThreshold: z.number().min(0).max(1).default(0.85)
-  }).default({})
-})
-
-export type HooksConfig = z.infer<typeof HooksConfigSchema>
-
-/** Phase 18: Knowledge Packs configuration */
-export const PacksConfigSchema = z.object({
-  /** Master switch for knowledge packs */
-  enabled: z.boolean().default(true),
-
-  /** Directory name for pack files (relative to package root) */
-  packsDir: z.string().default('packs'),
-
-  /** Always load core/ packs regardless of tech stack */
-  alwaysLoadCore: z.boolean().default(true),
-
-  /** Always load meta/ packs regardless of tech stack */
-  alwaysLoadMeta: z.boolean().default(true),
-
-  /** Confidence multiplier for community (pack) entries (dampens scores) */
-  communityConfidenceMultiplier: z.number().min(0).max(1).default(0.8),
-
-  /** Search result boost for personal (user-created) entries */
-  personalBoost: z.number().min(1).max(2).default(1.2),
-
-  /** Search result boost for project-specific entries */
-  projectBoost: z.number().min(1).max(2).default(1.15)
-})
-
-export type PacksConfig = z.infer<typeof PacksConfigSchema>
-
-/** Phase 15: Advanced Intelligence configuration */
-export const AdvancedIntelligenceConfigSchema = z.object({
-  /** Enable advanced intelligence features (Phase 15) */
-  enabled: z.boolean().default(true),
-
-  /** Temporal intelligence settings */
-  temporal: z.object({
-    /** Enable temporal query processing */
-    enabled: z.boolean().default(true),
-    /** Default timeline limit */
-    defaultTimelineLimit: z.number().int().min(1).max(500).default(50),
-    /** Default trend analysis period in days */
-    defaultTrendPeriodDays: z.number().int().min(1).max(3650).default(90)
-  }).default({}),
-
-  /** Multi-hop reasoning settings */
-  reasoning: z.object({
-    /** Enable multi-hop reasoning */
-    enabled: z.boolean().default(true),
-    /** Maximum retrieval hops */
-    maxHops: z.number().int().min(1).max(10).default(3),
-    /** Results per hop */
-    resultsPerHop: z.number().int().min(1).max(50).default(5)
-  }).default({}),
-
-  /** Predictive intelligence settings */
-  prediction: z.object({
-    /** Enable predictive features */
-    enabled: z.boolean().default(true),
-    /** Default recommendation limit */
-    defaultRecommendationLimit: z.number().int().min(1).max(50).default(10)
-  }).default({}),
-
-  /** Cross-project intelligence settings */
-  crossProject: z.object({
-    /** Enable cross-project analysis */
-    enabled: z.boolean().default(true),
-    /** Minimum projects for pattern detection */
-    minProjects: z.number().int().min(2).max(50).default(2)
-  }).default({}),
-
-  /** Semantic caching settings */
-  cache: z.object({
-    /** Enable semantic caching */
-    enabled: z.boolean().default(true),
-    /** Maximum cache entries */
-    maxSize: z.number().int().min(10).max(10000).default(500),
-    /** Cache TTL in milliseconds */
-    ttlMs: z.number().int().min(60000).default(30 * 60 * 1000),
-    /** Semantic similarity threshold for cache hits */
-    similarityThreshold: z.number().min(0.5).max(1).default(0.85)
-  }).default({})
-})
-
-export type AdvancedIntelligenceConfig = z.infer<typeof AdvancedIntelligenceConfigSchema>
-
-/** Main configuration schema for Claude Brain */
-export const ConfigSchema = z.object({
-  /** Absolute path to the Obsidian vault */
-  vaultPath: z.string().min(1, 'Vault path is required'),
-
-  /** MCP server identifier */
-  serverName: z.string().default('claude-brain'),
-
-  /** Server version in semver format */
-  serverVersion: z.string().regex(/^\d+\.\d+\.\d+$/, 'Version must be semver format').default('0.15.1'),
-
-  /** Logging level */
-  logLevel: LogLevelSchema.default('info'),
-
-  /** Path to log file */
-  logFilePath: z.string().default('./logs/claude-brain.log'),
-
-  /** Path to vector database */
-  dbPath: z.string().default('./data/memory.db'),
-
-  /** Port for future HTTP interface */
-  port: z.number().int().min(1).max(65535).default(3000),
-
-  /** Enable file watching for vault changes */
-  enableFileWatch: z.boolean().default(true),
-
-  /** Cache size in MB for context cache */
-  cacheSize: z.number().int().min(1).default(100),
-
-  /** Node environment */
-  nodeEnv: z.enum(['development', 'production', 'test']).default('development'),
-
-  /** ChromaDB configuration */
-  chroma: z.object({
-    /** Enable ChromaDB vector database */
-    enabled: z.boolean().default(true),
-    /** ChromaDB mode */
-    mode: z.enum(['persistent', 'client-server', 'ephemeral', 'cloud']).default('persistent'),
-    /** Path for persistent storage */
-    path: z.string().default('./data/chroma'),
-    /** Host for client-server or cloud mode */
-    host: z.string().optional(),
-    /** Port for client-server mode */
-    port: z.number().optional(),
-    /** Embedding provider */
-    embeddingProvider: z.enum(['default', 'transformers', 'openai']).default('default'),
-    /** Chroma Cloud or secured instance authentication token */
-    chromaAuthToken: z.string().optional(),
-    /** Chroma Cloud tenant name */
-    chromaTenant: z.string().optional(),
-    /** Chroma Cloud database name */
-    chromaDatabase: z.string().optional()
-  }).default({}),
-
-  /** Hybrid retrieval configuration */
-  retrieval: RetrievalConfigSchema.default({}),
-
-  /** Knowledge graph and episodic memory configuration */
-  knowledge: KnowledgeConfigSchema.default({}),
-
-  /** Advanced intelligence configuration (Phase 15) */
-  advancedIntelligence: AdvancedIntelligenceConfigSchema.default({}),
-
-  /** Phase 16: Unified tool mode — expose only brain() instead of all 25 tools */
-  unifiedToolMode: z.boolean().default(true),
-
-  /** Phase 17: Passive learning hooks configuration */
-  hooks: HooksConfigSchema.default({}),
-
-  /** Phase 18: Knowledge packs configuration */
-  packs: PacksConfigSchema.default({}),
-
-  /** Phase 22: Intelligence features (opt-in) */
-  intelligence: z.object({
-    /** Enable consolidated intelligence features */
-    enabled: z.boolean().default(false)
-  }).default({})
-})
-
-export type Config = z.infer<typeof ConfigSchema>
-
-/** Partial config for merging with defaults */
-export type PartialConfig = z.input<typeof ConfigSchema>
+import { z } from 'zod'
+
+/** Log level options for the application */
+export const LogLevelSchema = z.enum(['debug', 'info', 'warn', 'error'])
+export type LogLevel = z.infer<typeof LogLevelSchema>
+
+/** Retrieval configuration for hybrid search */
+export const RetrievalConfigSchema = z.object({
+  /** Enable hybrid retrieval pipeline (opt-in) */
+  enabled: z.boolean().default(false),
+
+  /** Dense (semantic) search configuration */
+  dense: z.object({
+    /** Weight for dense search in fusion (0-1) */
+    weight: z.number().min(0).max(1).default(0.7),
+    /** Maximum number of results from dense search */
+    limit: z.number().int().min(1).max(100).default(20),
+    /** Minimum similarity threshold (0-1) */
+    minSimilarity: z.number().min(0).max(1).default(0.3)
+  }).default({}),
+
+  /** Sparse (BM25) search configuration */
+  sparse: z.object({
+    /** Enable sparse search */
+    enabled: z.boolean().default(true),
+    /** Weight for sparse search in fusion (0-1) */
+    weight: z.number().min(0).max(1).default(0.3),
+    /** Maximum number of results from sparse search */
+    limit: z.number().int().min(1).max(100).default(20)
+  }).default({}),
+
+  /** Fusion configuration for combining results */
+  fusion: z.object({
+    /** Fusion method */
+    method: z.enum(['rrf', 'linear', 'max']).default('rrf'),
+    /** RRF k parameter (default 60 per original paper) */
+    rrfK: z.number().int().min(1).default(60)
+  }).default({}),
+
+  /** Cross-encoder reranking configuration */
+  reranker: z.object({
+    /** Enable cross-encoder reranking */
+    enabled: z.boolean().default(false),
+    /** Model to use for reranking */
+    model: z.string().default('cross-encoder/ms-marco-MiniLM-L-6-v2'),
+    /** Number of results to rerank */
+    topK: z.number().int().min(1).max(100).default(10)
+  }).default({}),
+
+  /** Query understanding configuration */
+  queryUnderstanding: z.object({
+    /** Enable query understanding */
+    enabled: z.boolean().default(true),
+    /** Enable intent classification */
+    intentClassification: z.boolean().default(true),
+    /** Enable query expansion */
+    queryExpansion: z.boolean().default(true),
+    /** Enable temporal parsing */
+    temporalParsing: z.boolean().default(true)
+  }).default({}),
+
+  /** Feedback collection configuration */
+  feedback: z.object({
+    /** Enable feedback collection */
+    enabled: z.boolean().default(true),
+    /** Enable adaptive threshold learning */
+    adaptiveThresholds: z.boolean().default(true),
+    /** Minimum feedback count before adaptation */
+    minFeedbackForAdaptation: z.number().int().min(1).default(10)
+  }).default({})
+})
+
+export type RetrievalConfig = z.infer<typeof RetrievalConfigSchema>
+
+/** Knowledge graph and episodic memory configuration */
+export const KnowledgeConfigSchema = z.object({
+  /** Entity extraction settings */
+  extraction: z.object({
+    /** Minimum confidence for extracted entities */
+    minConfidence: z.number().min(0).max(1).default(0.5),
+    /** Maximum entities to extract per text */
+    maxEntities: z.number().int().min(1).max(200).default(50)
+  }).default({}),
+
+  /** Knowledge graph settings */
+  graph: z.object({
+    /** Enable knowledge graph auto-population */
+    enabled: z.boolean().default(true),
+    /** Path for graph persistence */
+    persistPath: z.string().default('./data/knowledge-graph.json'),
+    /** Auto-save interval in seconds */
+    autoSaveInterval: z.number().int().min(10).default(60),
+    /** Maximum graph traversal depth */
+    maxTraversalDepth: z.number().int().min(1).max(10).default(5),
+    /** Alpha for combined scoring (vector vs graph proximity) */
+    alpha: z.number().min(0).max(1).default(0.6)
+  }).default({}),
+
+  /** Episodic memory settings */
+  episodic: z.object({
+    /** Enable episodic memory */
+    enabled: z.boolean().default(true),
+    /** Time gap in minutes to detect new session */
+    sessionGapMinutes: z.number().int().min(1).default(30),
+    /** Maximum messages per episode before auto-splitting */
+    maxMessagesPerEpisode: z.number().int().min(10).default(200),
+    /** Number of top sentences for brief summary */
+    briefSummarySize: z.number().int().min(1).max(10).default(2),
+    /** Number of top sentences for detailed summary */
+    detailedSummarySize: z.number().int().min(1).max(20).default(8)
+  }).default({}),
+
+  /** Memory consolidation settings */
+  consolidation: z.object({
+    /** Enable memory consolidation */
+    enabled: z.boolean().default(true),
+    /** Similarity threshold for merge candidates */
+    mergeThreshold: z.number().min(0).max(1).default(0.85),
+    /** Importance score threshold for archival */
+    archiveThreshold: z.number().min(0).max(1).default(0.2),
+    /** Importance scoring weights */
+    weights: z.object({
+      recency: z.number().min(0).max(1).default(0.2),
+      frequency: z.number().min(0).max(1).default(0.2),
+      references: z.number().min(0).max(1).default(0.2),
+      feedback: z.number().min(0).max(1).default(0.2),
+      uniqueness: z.number().min(0).max(1).default(0.2)
+    }).default({})
+  }).default({})
+})
+
+export type KnowledgeConfig = z.infer<typeof KnowledgeConfigSchema>
+
+/** Phase 17+20: Passive Learning via Hooks configuration */
+export const HooksConfigSchema = z.object({
+  /** Master switch for hooks passive learning (Phase 20: enabled by default) */
+  enabled: z.boolean().default(true),
+
+  /** What to capture from tool calls */
+  capture: z.object({
+    /** Capture knowledge from tool use (Edit/Write) */
+    toolUse: z.boolean().default(true),
+    /** Capture knowledge from file edits */
+    fileEdits: z.boolean().default(true),
+    /** Capture knowledge from bash commands */
+    bashCommands: z.boolean().default(true),
+    /** Capture knowledge from user messages */
+    userMessages: z.boolean().default(true)
+  }).default({}),
+
+  /** Privacy filters */
+  privacy: z.object({
+    /** File paths to ignore (glob patterns) — Phase 20: sensible defaults */
+    ignorePaths: z.array(z.string()).default([
+      'node_modules/**',
+      '.env*',
+      '*.key',
+      '*.pem',
+      '*.p12',
+      '*.pfx',
+      '.git/**',
+      'dist/**',
+      'build/**',
+      '*.secret',
+      'credentials*',
+      '.aws/**',
+      '.ssh/**'
+    ]),
+    /** Projects to ignore */
+    ignoreProjects: z.array(z.string()).default([]),
+    /** Minimum confidence to store captured knowledge */
+    minConfidence: z.number().min(0).max(1).default(0.7)
+  }).default({}),
+
+  /** Session tracking settings */
+  sessions: z.object({
+    /** Enable session tracking */
+    enabled: z.boolean().default(true),
+    /** Idle timeout in minutes before summarizing */
+    idleTimeoutMinutes: z.number().int().min(1).default(30),
+    /** Minimum events required before generating summary */
+    minEventsForSummary: z.number().int().min(1).default(3)
+  }).default({}),
+
+  /** Deduplication thresholds */
+  deduplication: z.object({
+    /** Similarity above this skips storage (exact duplicate) */
+    skipThreshold: z.number().min(0).max(1).default(0.95),
+    /** Similarity above this merges instead of creating new */
+    mergeThreshold: z.number().min(0).max(1).default(0.85)
+  }).default({})
+})
+
+export type HooksConfig = z.infer<typeof HooksConfigSchema>
+
+/** Phase 18: Knowledge Packs configuration */
+export const PacksConfigSchema = z.object({
+  /** Master switch for knowledge packs */
+  enabled: z.boolean().default(true),
+
+  /** Directory name for pack files (relative to package root) */
+  packsDir: z.string().default('packs'),
+
+  /** Always load core/ packs regardless of tech stack */
+  alwaysLoadCore: z.boolean().default(true),
+
+  /** Always load meta/ packs regardless of tech stack */
+  alwaysLoadMeta: z.boolean().default(true),
+
+  /** Confidence multiplier for community (pack) entries (dampens scores) */
+  communityConfidenceMultiplier: z.number().min(0).max(1).default(0.8),
+
+  /** Search result boost for personal (user-created) entries */
+  personalBoost: z.number().min(1).max(2).default(1.2),
+
+  /** Search result boost for project-specific entries */
+  projectBoost: z.number().min(1).max(2).default(1.15)
+})
+
+export type PacksConfig = z.infer<typeof PacksConfigSchema>
+
+/** Phase 15: Advanced Intelligence configuration */
+export const AdvancedIntelligenceConfigSchema = z.object({
+  /** Enable advanced intelligence features (Phase 15) */
+  enabled: z.boolean().default(true),
+
+  /** Temporal intelligence settings */
+  temporal: z.object({
+    /** Enable temporal query processing */
+    enabled: z.boolean().default(true),
+    /** Default timeline limit */
+    defaultTimelineLimit: z.number().int().min(1).max(500).default(50),
+    /** Default trend analysis period in days */
+    defaultTrendPeriodDays: z.number().int().min(1).max(3650).default(90)
+  }).default({}),
+
+  /** Multi-hop reasoning settings */
+  reasoning: z.object({
+    /** Enable multi-hop reasoning */
+    enabled: z.boolean().default(true),
+    /** Maximum retrieval hops */
+    maxHops: z.number().int().min(1).max(10).default(3),
+    /** Results per hop */
+    resultsPerHop: z.number().int().min(1).max(50).default(5)
+  }).default({}),
+
+  /** Predictive intelligence settings */
+  prediction: z.object({
+    /** Enable predictive features */
+    enabled: z.boolean().default(true),
+    /** Default recommendation limit */
+    defaultRecommendationLimit: z.number().int().min(1).max(50).default(10)
+  }).default({}),
+
+  /** Cross-project intelligence settings */
+  crossProject: z.object({
+    /** Enable cross-project analysis */
+    enabled: z.boolean().default(true),
+    /** Minimum projects for pattern detection */
+    minProjects: z.number().int().min(2).max(50).default(2)
+  }).default({}),
+
+  /** Semantic caching settings */
+  cache: z.object({
+    /** Enable semantic caching */
+    enabled: z.boolean().default(true),
+    /** Maximum cache entries */
+    maxSize: z.number().int().min(10).max(10000).default(500),
+    /** Cache TTL in milliseconds */
+    ttlMs: z.number().int().min(60000).default(30 * 60 * 1000),
+    /** Semantic similarity threshold for cache hits */
+    similarityThreshold: z.number().min(0.5).max(1).default(0.85)
+  }).default({})
+})
+
+export type AdvancedIntelligenceConfig = z.infer<typeof AdvancedIntelligenceConfigSchema>
+
+/** Main configuration schema for Claude Brain */
+export const ConfigSchema = z.object({
+  /** Absolute path to the Obsidian vault */
+  vaultPath: z.string().min(1, 'Vault path is required'),
+
+  /** MCP server identifier */
+  serverName: z.string().default('claude-brain'),
+
+  /** Server version in semver format */
+  serverVersion: z.string().regex(/^\d+\.\d+\.\d+$/, 'Version must be semver format').default('0.17.0'),
+
+  /** Logging level */
+  logLevel: LogLevelSchema.default('info'),
+
+  /** Path to log file */
+  logFilePath: z.string().default('./logs/claude-brain.log'),
+
+  /** Path to vector database */
+  dbPath: z.string().default('./data/memory.db'),
+
+  /** Port for future HTTP interface */
+  port: z.number().int().min(1).max(65535).default(3000),
+
+  /** Enable file watching for vault changes */
+  enableFileWatch: z.boolean().default(true),
+
+  /** Cache size in MB for context cache */
+  cacheSize: z.number().int().min(1).default(100),
+
+  /** Node environment */
+  nodeEnv: z.enum(['development', 'production', 'test']).default('development'),
+
+  /** ChromaDB configuration */
+  chroma: z.object({
+    /** Enable ChromaDB vector database */
+    enabled: z.boolean().default(true),
+    /** ChromaDB mode */
+    mode: z.enum(['persistent', 'client-server', 'ephemeral', 'cloud']).default('persistent'),
+    /** Path for persistent storage */
+    path: z.string().default('./data/chroma'),
+    /** Host for client-server or cloud mode */
+    host: z.string().optional(),
+    /** Port for client-server mode */
+    port: z.number().optional(),
+    /** Embedding provider */
+    embeddingProvider: z.enum(['default', 'transformers', 'openai']).default('default'),
+    /** Chroma Cloud or secured instance authentication token */
+    chromaAuthToken: z.string().optional(),
+    /** Chroma Cloud tenant name */
+    chromaTenant: z.string().optional(),
+    /** Chroma Cloud database name */
+    chromaDatabase: z.string().optional()
+  }).default({}),
+
+  /** Hybrid retrieval configuration */
+  retrieval: RetrievalConfigSchema.default({}),
+
+  /** Knowledge graph and episodic memory configuration */
+  knowledge: KnowledgeConfigSchema.default({}),
+
+  /** Advanced intelligence configuration (Phase 15) */
+  advancedIntelligence: AdvancedIntelligenceConfigSchema.default({}),
+
+  /** Phase 16: Unified tool mode — expose only brain() instead of all 25 tools */
+  unifiedToolMode: z.boolean().default(true),
+
+  /** Phase 17: Passive learning hooks configuration */
+  hooks: HooksConfigSchema.default({}),
+
+  /** Phase 18: Knowledge packs configuration */
+  packs: PacksConfigSchema.default({}),
+
+  /** Phase 22: Intelligence features (opt-in) */
+  intelligence: z.object({
+    /** Enable consolidated intelligence features */
+    enabled: z.boolean().default(false)
+  }).default({})
+})
+
+export type Config = z.infer<typeof ConfigSchema>
+
+/** Partial config for merging with defaults */
+export type PartialConfig = z.input<typeof ConfigSchema>