claude-brain 0.30.2 → 0.30.3

package/src/config/schema.ts

@@ -1,415 +1,446 @@
-import { z } from 'zod'
-import pkg from '../../package.json'
-
-/** 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({} as any),
-
-  /** 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({} as any),
-
-  /** 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({} as any),
-
-  /** 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({} as any),
-
-  /** 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({} as any),
-
-  /** 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({} as any)
-})
-
-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({} as any),
-
-  /** 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({} as any),
-
-  /** 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({} as any),
-
-  /** 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),
-    /** Interval in minutes between automatic archival sweeps (0 = disabled) */
-    archiveIntervalMinutes: z.number().int().min(0).default(60),
-    /** 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({} as any)
-  }).default({} as any)
-})
-
-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({} as any),
-
-  /** 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({} as any),
-
-  /** 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({} as any),
-
-  /** 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({} as any)
-})
-
-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({} as any),
-
-  /** 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({} as any),
-
-  /** 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({} as any),
-
-  /** 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({} as any),
-
-  /** 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({} as any)
-})
-
-export type AdvancedIntelligenceConfig = z.infer<typeof AdvancedIntelligenceConfigSchema>
-
-/** Main configuration schema for Claude Brain */
-export const ConfigSchema = z.object({
-  /** Absolute path to the Obsidian vault (auto-detected if empty) */
-  vaultPath: z.string().default(''),
-
-  /** 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(pkg.version),
-
-  /** Logging level */
-  logLevel: LogLevelSchema.default('warn'),
-
-  /** 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'),
-
-  /** Hybrid retrieval configuration */
-  retrieval: RetrievalConfigSchema.default({} as any),
-
-  /** Knowledge graph and episodic memory configuration */
-  knowledge: KnowledgeConfigSchema.default({} as any),
-
-  /** Advanced intelligence configuration (Phase 15) */
-  advancedIntelligence: AdvancedIntelligenceConfigSchema.default({} as any),
-
-  /** 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({} as any),
-
-  /** Phase 18: Knowledge packs configuration */
-  packs: PacksConfigSchema.default({} as any),
-
-  /** Phase 22: Intelligence features (opt-in) */
-  intelligence: z.object({
-    /** Enable consolidated intelligence features */
-    enabled: z.boolean().default(false)
-  }).default({} as any),
-
-  /** Phase 26: ChromaDB configuration (now optional, SQLite FTS5 is primary) */
-  chromadb: z.object({
-    /** Enable ChromaDB vector storage backend */
-    enabled: z.boolean().default(false)
-  }).default({} as any),
-
-  /** Phase 28: Code intelligence configuration */
-  codeIntelligence: z.object({
-    /** Enable code intelligence (project indexing and file maps) */
-    enabled: z.boolean().default(true),
-  }).default({} as any),
-
-  /** Phase 31: Auto-update configuration */
-  autoUpdate: z.object({
-    /** Enable automatic update checks */
-    enabled: z.boolean().default(true),
-    /** Hours between update checks */
-    checkIntervalHours: z.number().int().min(1).max(168).default(24),
-    /** Automatically restart server after update */
-    autoRestart: z.boolean().default(true),
-  }).default({} as any),
-
-  /** SLM Upgrade: Local model inference configuration */
-  slm: z.object({
-    /** Master switch for local model inference */
-    enabled: z.boolean().default(false),
-    /** Directory containing ONNX model files */
-    modelsDir: z.string().default('~/.claude-brain/models'),
-    /** Hugging Face repo for downloading pre-trained models */
-    hfRepo: z.string().default('demgun101/claude-brain-models'),
-    /** Minimum model confidence to use model prediction (below → regex fallback) */
-    confidenceThreshold: z.number().min(0).max(1).default(0.7),
-    /** Per-task mode: 'model' uses model only, 'regex' uses regex only, 'both' runs both and logs comparison */
-    tasks: z.object({
-      intent: z.enum(['model', 'regex', 'both']).default('regex'),
-      entity: z.enum(['model', 'regex', 'both']).default('regex'),
-      query: z.enum(['model', 'regex', 'both']).default('regex'),
-      knowledge: z.enum(['model', 'regex', 'both']).default('regex'),
-      compress: z.enum(['model', 'api', 'both']).default('api'),
-      pattern: z.enum(['model', 'regex', 'both']).default('regex'),
-    }).default({} as any),
-    /** Phase 6B: Automated retraining configuration */
-    retrain: z.object({
-      /** Minimum new feedback entries before triggering retrain */
-      minFeedbackCount: z.number().int().min(1).default(100),
-      /** Maximum disagreement rate threshold to trigger retrain */
-      maxDisagreementRate: z.number().min(0).max(1).default(0.15),
-      /** Python executable path */
-      pythonPath: z.string().default('python3'),
-      /** Path to SLM training directory */
-      trainingDir: z.string().default('~/slm-training'),
-    }).default({} as any),
-  }).default({} as any),
-
-  /** Daemon process configuration */
-  daemon: z.object({
-    /** Minutes of inactivity before daemon self-terminates (0 = never) */
-    idleTimeoutMinutes: z.number().int().min(0).default(30),
-  }).default({} as any),
-
-  /** Phase 30: Optional LLM compression for observations */
-  compression: z.object({
-    /** Enable LLM-based compression of long observations */
-    enabled: z.boolean().default(false),
-    /** LLM provider for compression */
-    provider: z.enum(['claude', 'ollama']).default('claude'),
-    /** Model to use for compression */
-    model: z.string().default('claude-haiku-4-5-20251001'),
-    /** API key (falls back to ANTHROPIC_API_KEY env var) */
-    apiKey: z.string().optional(),
-    /** Minimum content length to trigger compression */
-    minContentLength: z.number().default(500),
-  }).default({} as any)
-})
-
-export type Config = z.infer<typeof ConfigSchema>
-
-/** Partial config for merging with defaults */
-export type PartialConfig = z.input<typeof ConfigSchema>
+import { z } from 'zod'
+import pkg from '../../package.json'
+
+/** 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({ weight: 0.7, limit: 20, minSimilarity: 0.3 }),
+
+  /** 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({ enabled: true, weight: 0.3, limit: 20 }),
+
+  /** 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({ method: 'rrf' as const, rrfK: 60 }),
+
+  /** 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({ enabled: false, model: 'cross-encoder/ms-marco-MiniLM-L-6-v2', topK: 10 }),
+
+  /** 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({ enabled: true, intentClassification: true, queryExpansion: true, temporalParsing: true }),
+
+  /** 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({ enabled: true, adaptiveThresholds: true, minFeedbackForAdaptation: 10 })
+})
+
+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({ minConfidence: 0.5, maxEntities: 50 }),
+
+  /** 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({ enabled: true, persistPath: './data/knowledge-graph.json', autoSaveInterval: 60, maxTraversalDepth: 5, alpha: 0.6 }),
+
+  /** 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({ enabled: true, sessionGapMinutes: 30, maxMessagesPerEpisode: 200, briefSummarySize: 2, detailedSummarySize: 8 }),
+
+  /** 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),
+    /** Interval in minutes between automatic archival sweeps (0 = disabled) */
+    archiveIntervalMinutes: z.number().int().min(0).default(60),
+    /** 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({ recency: 0.2, frequency: 0.2, references: 0.2, feedback: 0.2, uniqueness: 0.2 })
+  }).default({
+    enabled: true, mergeThreshold: 0.85, archiveThreshold: 0.2, archiveIntervalMinutes: 60,
+    weights: { recency: 0.2, frequency: 0.2, references: 0.2, feedback: 0.2, uniqueness: 0.2 }
+  })
+})
+
+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({ toolUse: true, fileEdits: true, bashCommands: true, userMessages: true }),
+
+  /** 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({
+    ignorePaths: [
+      'node_modules/**', '.env*', '*.key', '*.pem', '*.p12', '*.pfx',
+      '.git/**', 'dist/**', 'build/**', '*.secret', 'credentials*', '.aws/**', '.ssh/**'
+    ],
+    ignoreProjects: [],
+    minConfidence: 0.7
+  }),
+
+  /** 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({ enabled: true, idleTimeoutMinutes: 30, minEventsForSummary: 3 }),
+
+  /** 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({ skipThreshold: 0.95, mergeThreshold: 0.85 })
+})
+
+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({ enabled: true, defaultTimelineLimit: 50, defaultTrendPeriodDays: 90 }),
+
+  /** 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({ enabled: true, maxHops: 3, resultsPerHop: 5 }),
+
+  /** 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({ enabled: true, defaultRecommendationLimit: 10 }),
+
+  /** 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({ enabled: true, minProjects: 2 }),
+
+  /** 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({ enabled: true, maxSize: 500, ttlMs: 30 * 60 * 1000, similarityThreshold: 0.85 })
+})
+
+export type AdvancedIntelligenceConfig = z.infer<typeof AdvancedIntelligenceConfigSchema>
+
+// Pre-compute defaults for complex schemas (Zod v4 requires output-typed defaults)
+const retrievalDefaults = RetrievalConfigSchema.parse({})
+const knowledgeDefaults = KnowledgeConfigSchema.parse({})
+const advancedIntelligenceDefaults = AdvancedIntelligenceConfigSchema.parse({})
+const hooksDefaults = HooksConfigSchema.parse({})
+const packsDefaults = PacksConfigSchema.parse({})
+
+/** Main configuration schema for Claude Brain */
+export const ConfigSchema = z.object({
+  /** Absolute path to the Obsidian vault (auto-detected if empty) */
+  vaultPath: z.string().default(''),
+
+  /** 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(pkg.version),
+
+  /** Logging level */
+  logLevel: LogLevelSchema.default('warn'),
+
+  /** 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),
+
+  /** Additional allowed CORS origins */
+  corsOrigins: z.array(z.string()).default([]),
+
+  /** API key for HTTP endpoint authentication */
+  apiKey: z.string().optional(),
+
+  /** 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'),
+
+  /** Hybrid retrieval configuration */
+  retrieval: RetrievalConfigSchema.default(retrievalDefaults),
+
+  /** Knowledge graph and episodic memory configuration */
+  knowledge: KnowledgeConfigSchema.default(knowledgeDefaults),
+
+  /** Advanced intelligence configuration (Phase 15) */
+  advancedIntelligence: AdvancedIntelligenceConfigSchema.default(advancedIntelligenceDefaults),
+
+  /** 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(hooksDefaults),
+
+  /** Phase 18: Knowledge packs configuration */
+  packs: PacksConfigSchema.default(packsDefaults),
+
+  /** Phase 22: Intelligence features (opt-in) */
+  intelligence: z.object({
+    /** Enable consolidated intelligence features */
+    enabled: z.boolean().default(false)
+  }).default({ enabled: false }),
+
+  /** Phase 26: ChromaDB configuration (now optional, SQLite FTS5 is primary) */
+  chromadb: z.object({
+    /** Enable ChromaDB vector storage backend */
+    enabled: z.boolean().default(false)
+  }).default({ enabled: false }),
+
+  /** Phase 28: Code intelligence configuration */
+  codeIntelligence: z.object({
+    /** Enable code intelligence (project indexing and file maps) */
+    enabled: z.boolean().default(true),
+  }).default({ enabled: true }),
+
+  /** Phase 31: Auto-update configuration */
+  autoUpdate: z.object({
+    /** Enable automatic update checks */
+    enabled: z.boolean().default(true),
+    /** Hours between update checks */
+    checkIntervalHours: z.number().int().min(1).max(168).default(24),
+    /** Automatically restart server after update */
+    autoRestart: z.boolean().default(true),
+  }).default({ enabled: true, checkIntervalHours: 24, autoRestart: true }),
+
+  /** SLM Upgrade: Local model inference configuration */
+  slm: z.object({
+    /** Master switch for local model inference */
+    enabled: z.boolean().default(false),
+    /** Directory containing ONNX model files */
+    modelsDir: z.string().default('~/.claude-brain/models'),
+    /** Hugging Face repo for downloading pre-trained models */
+    hfRepo: z.string().default('demgun101/claude-brain-models'),
+    /** Minimum model confidence to use model prediction (below → regex fallback) */
+    confidenceThreshold: z.number().min(0).max(1).default(0.7),
+    /** Per-task mode: 'model' uses model only, 'regex' uses regex only, 'both' runs both and logs comparison */
+    tasks: z.object({
+      intent: z.enum(['model', 'regex', 'both']).default('regex'),
+      entity: z.enum(['model', 'regex', 'both']).default('regex'),
+      query: z.enum(['model', 'regex', 'both']).default('regex'),
+      knowledge: z.enum(['model', 'regex', 'both']).default('regex'),
+      compress: z.enum(['model', 'api', 'both']).default('api'),
+      pattern: z.enum(['model', 'regex', 'both']).default('regex'),
+    }).default({
+      intent: 'regex' as const, entity: 'regex' as const, query: 'regex' as const,
+      knowledge: 'regex' as const, compress: 'api' as const, pattern: 'regex' as const
+    }),
+    /** Phase 6B: Automated retraining configuration */
+    retrain: z.object({
+      /** Minimum new feedback entries before triggering retrain */
+      minFeedbackCount: z.number().int().min(1).default(100),
+      /** Maximum disagreement rate threshold to trigger retrain */
+      maxDisagreementRate: z.number().min(0).max(1).default(0.15),
+      /** Python executable path */
+      pythonPath: z.string().default('python3'),
+      /** Path to SLM training directory */
+      trainingDir: z.string().default('~/slm-training'),
+    }).default({ minFeedbackCount: 100, maxDisagreementRate: 0.15, pythonPath: 'python3', trainingDir: '~/slm-training' }),
+  }).default({
+    enabled: false, modelsDir: '~/.claude-brain/models', hfRepo: 'demgun101/claude-brain-models',
+    confidenceThreshold: 0.7,
+    tasks: { intent: 'regex' as const, entity: 'regex' as const, query: 'regex' as const, knowledge: 'regex' as const, compress: 'api' as const, pattern: 'regex' as const },
+    retrain: { minFeedbackCount: 100, maxDisagreementRate: 0.15, pythonPath: 'python3', trainingDir: '~/slm-training' }
+  }),
+
+  /** Daemon process configuration */
+  daemon: z.object({
+    /** Minutes of inactivity before daemon self-terminates (0 = never) */
+    idleTimeoutMinutes: z.number().int().min(0).default(30),
+  }).default({ idleTimeoutMinutes: 30 }),
+
+  /** Phase 30: Optional LLM compression for observations */
+  compression: z.object({
+    /** Enable LLM-based compression of long observations */
+    enabled: z.boolean().default(false),
+    /** LLM provider for compression */
+    provider: z.enum(['claude', 'ollama']).default('claude'),
+    /** Model to use for compression */
+    model: z.string().default('claude-haiku-4-5-20251001'),
+    /** API key (falls back to ANTHROPIC_API_KEY env var) */
+    apiKey: z.string().optional(),
+    /** Minimum content length to trigger compression */
+    minContentLength: z.number().default(500),
+  }).default({ enabled: false, provider: 'claude' as const, model: 'claude-haiku-4-5-20251001', minContentLength: 500 })
+})
+
+export type Config = z.infer<typeof ConfigSchema>
+
+/** Partial config for merging with defaults */
+export type PartialConfig = z.input<typeof ConfigSchema>