claude-brain 0.17.10 → 0.17.12

package/VERSION

@@ -1 +1 @@
-0.17.10
+0.17.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-brain",
-  "version": "0.17.10",
+  "version": "0.17.12",
   "description": "Local development assistant bridging Obsidian vaults with Claude Code via MCP",
   "type": "module",
   "main": "src/index.ts",
@@ -53,9 +53,8 @@
   },
   "devDependencies": {
     "@types/bun": "latest",
-    "@types/node": "^20",
-    "@types/prompts": "2.4.9",
-    "daisyui": "^5.5.14"
+    "@types/node": "25.2.2",
+    "@types/prompts": "2.4.9"
   },
   "peerDependencies": {
     "typescript": "^5"
@@ -66,8 +65,8 @@
     "@xenova/transformers": "2.17.2",
     "chalk": "5.6.2",
     "chromadb": "3.2.2",
-    "chromadb-default-embed": "2.14.0",
     "chrono-node": "2.9.0",
+    "citty": "0.2.0",
     "compromise": "^14.10.0",
     "dotenv": "^17.2.3",
     "gray-matter": "^4.0.3",

package/scripts/postinstall.mjs

@@ -260,32 +260,59 @@ function installHooks() {
     )
   }
 
-  if (settings.hooks && (hasOurHooks(settings.hooks.PostToolUse) || hasOurHooks(settings.hooks.Stop))) {
+  if (settings.hooks &&
+      hasOurHooks(settings.hooks.PostToolUse) &&
+      hasOurHooks(settings.hooks.Stop) &&
+      hasOurHooks(settings.hooks.UserPromptSubmit) &&
+      hasOurHooks(settings.hooks.SessionStart)) {
     log('Hooks already installed')
     return true
   }
 
   // Build hook command
-  const scriptPath = join(HOME, 'hooks', 'brain-hook.ts')
-  function buildCmd(event) {
+  const brainScriptPath = join(HOME, 'hooks', 'brain-hook.ts')
+  const contextScriptPath = join(HOME, 'hooks', 'context-hook.ts')
+  function buildCmd(event, scriptPath) {
     return `bun "${scriptPath}" --event ${event} # ${HOOK_MARKER}`
   }
 
   if (!settings.hooks) settings.hooks = {}
 
-  // PostToolUse
-  if (!settings.hooks.PostToolUse) settings.hooks.PostToolUse = []
-  settings.hooks.PostToolUse.push({
-    matcher: '',
-    hooks: [{ type: 'command', command: buildCmd('PostToolUse') }],
-  })
-
-  // Stop
-  if (!settings.hooks.Stop) settings.hooks.Stop = []
-  settings.hooks.Stop.push({
-    matcher: '',
-    hooks: [{ type: 'command', command: buildCmd('Stop') }],
-  })
+  // PostToolUse — captures tool events
+  if (!hasOurHooks(settings.hooks.PostToolUse)) {
+    if (!settings.hooks.PostToolUse) settings.hooks.PostToolUse = []
+    settings.hooks.PostToolUse.push({
+      matcher: '',
+      hooks: [{ type: 'command', command: buildCmd('PostToolUse', brainScriptPath) }],
+    })
+  }
+
+  // Stop — triggers session-end summary
+  if (!hasOurHooks(settings.hooks.Stop)) {
+    if (!settings.hooks.Stop) settings.hooks.Stop = []
+    settings.hooks.Stop.push({
+      matcher: '',
+      hooks: [{ type: 'command', command: buildCmd('Stop', brainScriptPath) }],
+    })
+  }
+
+  // UserPromptSubmit — injects relevant memories into every prompt
+  if (!hasOurHooks(settings.hooks.UserPromptSubmit)) {
+    if (!settings.hooks.UserPromptSubmit) settings.hooks.UserPromptSubmit = []
+    settings.hooks.UserPromptSubmit.push({
+      matcher: '',
+      hooks: [{ type: 'command', command: buildCmd('UserPromptSubmit', contextScriptPath) }],
+    })
+  }
+
+  // SessionStart — injects project context on session start/resume
+  if (!hasOurHooks(settings.hooks.SessionStart)) {
+    if (!settings.hooks.SessionStart) settings.hooks.SessionStart = []
+    settings.hooks.SessionStart.push({
+      matcher: 'startup,resume,compact',
+      hooks: [{ type: 'command', command: buildCmd('SessionStart', contextScriptPath) }],
+    })
+  }
 
   // Write atomically
   if (!existsSync(CLAUDE_DIR)) {

package/src/automation/decision-detector.ts

@@ -81,7 +81,7 @@ export class DecisionDetector {
   /**
    * Detect decision from text
    */
-  detectDecision(text: string, project?: string): DetectedDecision | null {
+  detectDecision(text: string, _project?: string): DetectedDecision | null {
     const textLower = text.toLowerCase()
 
     // Check for decision phrases
@@ -133,7 +133,7 @@ export class DecisionDetector {
 
     // Find sentence with decision phrase
     for (let i = 0; i < sentences.length; i++) {
-      const sentence = sentences[i].toLowerCase()
+      const sentence = (sentences[i] ?? "").toLowerCase()
 
       if (this.DECISION_PHRASES.some(p => sentence.includes(p))) {
         // Context is likely in previous sentences

package/src/automation/proactive-recall.ts

@@ -148,7 +148,7 @@ export class ProactiveRecallEngine {
     // Also extract potential compound terms
     const compounds: string[] = []
     for (let i = 0; i < words.length - 1; i++) {
-      if (words[i].length > 3 && words[i + 1].length > 3) {
+      if (words[i]!.length > 3 && words[i + 1]!.length > 3) {
         compounds.push(`${words[i]} ${words[i + 1]}`)
       }
     }
@@ -256,7 +256,7 @@ export class ProactiveRecallEngine {
   /**
    * Calculate relevance score
    */
-  private calculateRelevance(query: string, memories: MemorySearchResult[]): number {
+  private calculateRelevance(_query: string, memories: MemorySearchResult[]): number {
     if (memories.length === 0) return 0
 
     // Average similarity score

package/src/automation/project-detector.ts

@@ -112,7 +112,7 @@ export class ProjectDetector {
 
       const nameMatch = pyprojectContent.match(/name\s*=\s*"([^"]+)"/)
       if (nameMatch) {
-        return nameMatch[1]
+        return nameMatch[1] ?? null
       }
     } catch {
       // No pyproject.toml
@@ -125,7 +125,7 @@ export class ProjectDetector {
 
       const nameMatch = cargoContent.match(/name\s*=\s*"([^"]+)"/)
       if (nameMatch) {
-        return nameMatch[1]
+        return nameMatch[1] ?? null
       }
     } catch {
       // No Cargo.toml
@@ -139,7 +139,7 @@ export class ProjectDetector {
       // Extract repo name from URL
       const urlMatch = gitConfig.match(/url\s*=\s*.+\/([^/\n]+?)(?:\.git)?[\s\n]/)
       if (urlMatch) {
-        return urlMatch[1].trim()
+        return urlMatch[1]?.trim() ?? null
       }
     } catch {
       // No .git/config
@@ -243,24 +243,24 @@ export class ProjectDetector {
     }
 
     for (let j = 0; j <= a.length; j++) {
-      matrix[0][j] = j
+      matrix[0]![j] = j
     }
 
     for (let i = 1; i <= b.length; i++) {
       for (let j = 1; j <= a.length; j++) {
         if (b.charAt(i - 1) === a.charAt(j - 1)) {
-          matrix[i][j] = matrix[i - 1][j - 1]
+          matrix[i]![j] = matrix[i - 1]![j - 1]!
         } else {
-          matrix[i][j] = Math.min(
-            matrix[i - 1][j - 1] + 1,
-            matrix[i][j - 1] + 1,
-            matrix[i - 1][j] + 1
+          matrix[i]![j] = Math.min(
+            matrix[i - 1]![j - 1]! + 1,
+            matrix[i]![j - 1]! + 1,
+            matrix[i - 1]![j]! + 1
           )
         }
       }
     }
 
-    return matrix[b.length][a.length]
+    return matrix[b.length]![a.length]!
   }
 
   /**

package/src/automation/repo-scanner.ts

@@ -153,9 +153,9 @@ async function getDirectoryTree(repoPath: string, maxDepth: number): Promise<str
   async function walk(dir: string, depth: number, prefix: string) {
     if (depth > maxDepth) return
 
-    let entries: Awaited<ReturnType<typeof fs.readdir>>
+    let entries: import("fs").Dirent[]
     try {
-      entries = await fs.readdir(dir, { withFileTypes: true })
+      entries = await fs.readdir(dir, { withFileTypes: true, encoding: 'utf-8' })
     } catch {
       return
     }

package/src/cli/bin.ts

@@ -3,6 +3,7 @@
 import { readFileSync } from 'node:fs'
 import { resolve, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
+import { parseArgs } from 'citty'
 import { renderLogo, theme, dimText, box, errorText } from '@/cli/ui/index.js'
 
 const __filename = fileURLToPath(import.meta.url)
@@ -77,7 +78,23 @@ function printHelp() {
 }
 
 async function main() {
-  const command = process.argv[2] || 'serve'
+  const args = parseArgs(process.argv.slice(2), {
+    command: { type: 'positional', required: false, description: 'Command to run' },
+    version: { type: 'boolean', alias: ['v'], description: 'Show version' },
+    help: { type: 'boolean', alias: ['h'], description: 'Show help' },
+  })
+
+  if (args.version) {
+    console.log(getVersion())
+    return
+  }
+
+  if (args.help) {
+    printHelp()
+    return
+  }
+
+  const command: string = args.command ?? 'serve'
 
   switch (command) {
     case 'start': {
@@ -179,16 +196,12 @@ async function main() {
       break
     }
 
-    case 'version':
-    case '-v':
-    case '--version': {
+    case 'version': {
       console.log(getVersion())
       break
     }
 
-    case 'help':
-    case '-h':
-    case '--help': {
+    case 'help': {
       printHelp()
       break
     }

package/src/cli/commands/chroma.ts

@@ -6,6 +6,7 @@
 import { spawn, execSync } from 'node:child_process'
 import { existsSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs'
 import { join } from 'node:path'
+import { parseArgs } from 'citty'
 import { getHomePaths } from '@/config/home'
 import {
   theme, heading, successText, errorText, warningText, dimText,
@@ -544,7 +545,10 @@ export async function ensureChromaRunning(options?: { silent?: boolean }): Promi
 // ── Entry Point ───────────────────────────────────────────
 
 export async function runChroma(): Promise<void> {
-  const subcommand = process.argv[3] || 'help'
+  const args = parseArgs(process.argv.slice(3), {
+    subcommand: { type: 'positional', required: false, description: 'start|stop|status|install|help' },
+  })
+  const subcommand: string = args.subcommand ?? 'help'
 
   switch (subcommand) {
     case 'start':

package/src/cli/commands/git-hook.ts

@@ -3,6 +3,7 @@
  * Manages git post-commit hook installation (install/uninstall/status)
  */
 
+import { parseArgs } from 'citty'
 import {
   renderLogo, theme, heading, successText, warningText, errorText, dimText,
   box, summaryPanel, withSpinner,
@@ -12,17 +13,22 @@ import {
 } from '@/hooks/git-hook-installer'
 
 export async function runGitHook() {
-  const subcommand = process.argv[3] || 'status'
+  const args = parseArgs(process.argv.slice(3), {
+    subcommand: { type: 'positional', required: false, description: 'install|uninstall|status' },
+    path: { type: 'positional', required: false, description: 'Repository path' },
+    all: { type: 'string', required: false, description: 'Install in all repos under directory' },
+  })
+  const subcommand: string = args.subcommand ?? 'status'
 
   switch (subcommand) {
     case 'install':
-      await handleInstall()
+      await handleInstall(args.all, args.path)
       break
     case 'uninstall':
-      await handleUninstall()
+      await handleUninstall(args.path)
       break
     case 'status':
-      handleStatus()
+      handleStatus(args.path)
       break
     default:
       console.log()
@@ -32,21 +38,15 @@ export async function runGitHook() {
   }
 }
 
-async function handleInstall() {
+async function handleInstall(allDir?: string, repoPath?: string) {
   console.log()
   console.log(renderLogo())
   console.log()
   console.log(heading('Install Git Hook'))
   console.log()
 
-  // Check for --all <dir> flag
-  const allIdx = process.argv.indexOf('--all')
-  if (allIdx >= 0) {
-    const dir = process.argv[allIdx + 1]
-    if (!dir) {
-      console.log(errorText('--all requires a directory path'))
-      process.exit(1)
-    }
+  if (allDir) {
+    const dir = allDir
 
     let results: { installed: number; skipped: number; errors: number } | undefined
     await withSpinner(`Installing git hooks in all repos under ${dir}`, async () => {
@@ -65,9 +65,6 @@ async function handleInstall() {
     return
   }
 
-  // Single repo install (current directory or specified path)
-  const repoPath = process.argv[4] || undefined
-
   try {
     let result: { installed: boolean; message: string; hookPath: string } | undefined
     await withSpinner('Installing post-commit hook', async () => {
@@ -99,15 +96,13 @@ async function handleInstall() {
   console.log()
 }
 
-async function handleUninstall() {
+async function handleUninstall(repoPath?: string) {
   console.log()
   console.log(renderLogo())
   console.log()
   console.log(heading('Uninstall Git Hook'))
   console.log()
 
-  const repoPath = process.argv[4] || undefined
-
   try {
     let result: { uninstalled: boolean; message: string } | undefined
     await withSpinner('Removing post-commit hook', async () => {
@@ -129,14 +124,13 @@ async function handleUninstall() {
   console.log()
 }
 
-function handleStatus() {
+function handleStatus(repoPath?: string) {
   console.log()
   console.log(renderLogo())
   console.log()
   console.log(heading('Git Hook Status'))
   console.log()
 
-  const repoPath = process.argv[4] || undefined
   const installed = isGitHookInstalled(repoPath)
 
   const items = [

package/src/cli/commands/hooks.ts

@@ -3,6 +3,7 @@
  * Manages passive learning hooks (install/uninstall/status/enable/disable)
  */
 
+import { parseArgs } from 'citty'
 import {
   renderLogo, theme, heading, successText, warningText, errorText, dimText,
   box, summaryPanel, withSpinner,
@@ -11,7 +12,10 @@ import { installHooks, uninstallHooks, isHooksInstalled, getHookScriptPath } fro
 import { readQueue } from '@/hooks/queue'
 
 export async function runHooks() {
-  const subcommand = process.argv[3] || 'status'
+  const args = parseArgs(process.argv.slice(3), {
+    subcommand: { type: 'positional', required: false, description: 'install|uninstall|status|enable|disable' },
+  })
+  const subcommand: string = args.subcommand ?? 'status'
 
   switch (subcommand) {
     case 'install':

package/src/cli/commands/init.ts

@@ -6,6 +6,7 @@
  */
 
 import path from 'path'
+import { parseArgs } from 'citty'
 import {
   renderLogo, theme, heading, successText, warningText, dimText,
   box, withSpinner,
@@ -19,12 +20,12 @@ export async function runInit() {
   console.log(heading('Initialize Project'))
   console.log()
 
-  // Parse arguments
-  const args = process.argv.slice(3)
-  const force = args.includes('--force')
-  const repoPath = path.resolve(
-    args.find(a => !a.startsWith('--')) || process.cwd()
-  )
+  const args = parseArgs(process.argv.slice(3), {
+    path: { type: 'positional', required: false, description: 'Path to project directory' },
+    force: { type: 'boolean', default: false, description: 'Force re-scan even without project markers' },
+  })
+  const force = args.force
+  const repoPath = path.resolve(args.path || process.cwd())
 
   console.log(`  ${theme.bold('Path:')} ${dimText(repoPath)}`)
   if (force) {

package/src/cli/commands/pack.ts

@@ -3,11 +3,11 @@
  * Manages knowledge packs (list/status/reload)
  */
 
+import { parseArgs } from 'citty'
 import {
   renderLogo, theme, heading, successText, warningText, errorText, dimText,
   box, summaryPanel, withSpinner,
 } from '@/cli/ui/index.js'
-import { readFileSync } from 'node:fs'
 import { resolve, dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { PackManager } from '@/packs/manager'
@@ -49,17 +49,22 @@ function createPackManager(): PackManager {
 }
 
 export async function runPack() {
-  const subcommand = process.argv[3] || 'list'
+  const args = parseArgs(process.argv.slice(3), {
+    subcommand: { type: 'positional', required: false, description: 'list|status|reload' },
+    project: { type: 'positional', required: false, description: 'Project name' },
+  })
+
+  const subcommand: string = args.subcommand ?? 'list'
 
   switch (subcommand) {
     case 'list':
       await handleList()
       break
     case 'status':
-      await handleStatus()
+      await handleStatus(args.project)
       break
     case 'reload':
-      await handleReload()
+      await handleReload(args.project)
       break
     default:
       console.log()
@@ -102,14 +107,13 @@ async function handleList() {
   console.log()
 }
 
-async function handleStatus() {
+async function handleStatus(project?: string) {
   console.log()
   console.log(renderLogo())
   console.log()
   console.log(heading('Pack Status'))
   console.log()
 
-  const project = process.argv[4]
   if (!project) {
     console.log(warningText('  Usage: claude-brain pack status <project-name>'))
     console.log(dimText('  Example: claude-brain pack status my-app'))
@@ -139,14 +143,13 @@ async function handleStatus() {
   console.log()
 }
 
-async function handleReload() {
+async function handleReload(project?: string) {
   console.log()
   console.log(renderLogo())
   console.log()
   console.log(heading('Reload Knowledge Packs'))
   console.log()
 
-  const project = process.argv[4]
   if (!project) {
     console.log(warningText('  Usage: claude-brain pack reload <project-name>'))
     console.log(dimText('  This clears the manifest so packs are re-loaded on next init_project'))

package/src/cli/commands/refresh.ts

@@ -176,8 +176,8 @@ export async function runRefresh() {
       killByPattern('chroma run')
     }
 
-    // Kill by port (HTTP API 3333, ChromaDB 8000)
-    killByPort(3333)
+    // Kill by port (HTTP API 3000, ChromaDB 8000)
+    killByPort(3000)
     killByPort(8000)
 
     // Clean up stale PID file

package/src/cli/commands/serve.ts

@@ -38,7 +38,7 @@ export async function runServe() {
   const logger = createLogger(config.logLevel, config.logFilePath)
   const mainLogger = createComponentLogger(logger, 'main')
 
-  const errorHandler = new GlobalErrorHandler(logger)
+  new GlobalErrorHandler(logger)
   const cleanup = new CleanupManager(logger)
 
   mainLogger.info({

package/src/cli/commands/start.ts

@@ -7,13 +7,17 @@
  *   claude-brain start --chroma-only  Start only ChromaDB server
  */
 
+import { parseArgs } from 'citty'
 import {
   heading, successText, warningText, dimText,
 } from '@/cli/ui/index.js'
 import { ensureChromaRunning } from '@/cli/commands/chroma'
 
 export async function runStart(): Promise<void> {
-  const chromaOnly = process.argv.includes('--chroma-only')
+  const args = parseArgs(process.argv.slice(3), {
+    'chroma-only': { type: 'boolean', default: false, description: 'Start only ChromaDB server' },
+  })
+  const chromaOnly = args['chroma-only']
 
   if (chromaOnly) {
     console.log()

package/src/cli/commands/update.ts

@@ -44,7 +44,7 @@ export async function runUpdate() {
   const currentVersion = getInstalledVersion()
   console.log(`  ${theme.bold('Installed:')} ${dimText('v' + currentVersion)}`)
 
-  const latestVersion = await withSpinner('Checking for updates', () => getLatestVersion())
+  const latestVersion = await withSpinner('Checking for updates', async () => getLatestVersion())
 
   if (latestVersion) {
     console.log(`  ${theme.bold('Latest:')}    ${dimText('v' + latestVersion)}`)
@@ -54,7 +54,7 @@ export async function runUpdate() {
   // Step 1: Update package if newer version available
   if (latestVersion && latestVersion !== currentVersion) {
     try {
-      await withSpinner(`Updating claude-brain to v${latestVersion}`, () => {
+      await withSpinner(`Updating claude-brain to v${latestVersion}`, async () => {
         execSync('bun update -g claude-brain', {
           encoding: 'utf-8',
           stdio: ['pipe', 'pipe', 'pipe'],

package/src/cli/migrate-chroma.ts

@@ -16,7 +16,7 @@ for (const arg of args) {
   if (arg === '--validate-after') options.validateAfter = true
   if (arg === '--verbose') options.verbose = true
   const batchMatch = arg.match(/--batch-size=(\d+)/)
-  if (batchMatch) options.batchSize = parseInt(batchMatch[1])
+  if (batchMatch) options.batchSize = parseInt(batchMatch[1]!)
 }
 
 // Create dedicated migration logger

package/src/config/defaults.ts

@@ -1,9 +1,11 @@
+import pkg from '../../package.json'
 import type { PartialConfig } from './schema'
 
 /** Default configuration values for Claude Brain */
 export const defaultConfig: PartialConfig = {
+  vaultPath: '',
   serverName: 'claude-brain',
-  serverVersion: '0.17.10',
+  serverVersion: pkg.version,
   logLevel: 'info',
   logFilePath: './logs/claude-brain.log',
   dbPath: './data/memory.db',

package/src/config/index.ts

@@ -1,7 +1,5 @@
 export { ConfigSchema, LogLevelSchema, type Config, type LogLevel, type PartialConfig } from './schema'
 export { defaultConfig } from './defaults'
 export { loadConfig, validateConfig, getConfigFilePath } from './loader'
-export { ConfigWatcher, createConfigWatcher, type ConfigWatcherEvents } from './watcher'
 export { ConfigValidator, type ValidationResult, type ValidationError, type ValidationWarning } from './validator'
-export { ConfigMigration } from './migration'
 export { getClaudeBrainHome, resolveHomePath, isHomeInitialized, getHomePaths } from './home'