claude-brain 0.30.2 → 0.31.1

package/scripts/postinstall.mjs

@@ -1,531 +1,531 @@
-#!/usr/bin/env node
-
-/**
- * Postinstall script for claude-brain.
- * Runs automatically after `npm install -g claude-brain` or `bun install -g claude-brain`.
- * Pure Node.js — no TypeScript, no path aliases, no Bun APIs.
- * Always exits 0 so it never blocks the install.
- *
- * Phase 30: Zero-config — does EVERYTHING automatically:
- * 1. Create data directory: ~/.claude-brain/data/
- * 2. Create default config if none exists: ~/.claude-brain/config.yml
- * 3. Copy hook files to ~/.claude-brain/hooks/
- * 4. Register hooks in ~/.claude/settings.json (if Claude Code installed)
- * 5. Print success message with next steps
- *
- * No interactive prompts. No setup wizard. Sensible defaults.
- */
-
-import { mkdirSync, writeFileSync, readFileSync, existsSync, renameSync } from 'node:fs'
-import { join, dirname } from 'node:path'
-import { homedir } from 'node:os'
-import { execSync } from 'node:child_process'
-import { fileURLToPath } from 'node:url'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-
-const PREFIX = '[claude-brain]'
-const HOME = join(homedir(), '.claude-brain')
-const CLAUDE_DIR = join(homedir(), '.claude')
-const CLAUDE_SETTINGS = join(CLAUDE_DIR, 'settings.json')
-const CLAUDE_MD_PATH = join(CLAUDE_DIR, 'CLAUDE.md')
-const HOOK_MARKER = 'claude-brain-hook'
-
-function log(msg) {
-  console.error(`${PREFIX} ${msg}`)
-}
-
-// ── Step 0: Skip if not a global install ─────────────────
-
-function shouldSkip() {
-  // CI environments
-  if (process.env.CI === 'true' || process.env.CI === '1') {
-    return 'CI environment detected'
-  }
-
-  // If we're inside a node_modules directory, it's a local install
-  const scriptDir = dirname(__filename)
-  if (scriptDir.includes('node_modules') && !scriptDir.includes('global')) {
-    // Check if this is actually a global install by looking deeper
-    // bun global installs go to ~/.bun/install/global/node_modules
-    // npm global installs go to /usr/local/lib/node_modules or ~/.npm-global
-    const isGlobalPath =
-      scriptDir.includes('.bun/install/global') ||
-      scriptDir.includes('/usr/local/lib/node_modules') ||
-      scriptDir.includes('/usr/lib/node_modules') ||
-      scriptDir.includes('npm-global') ||
-      scriptDir.includes('AppData/Roaming/npm')
-
-    if (!isGlobalPath) {
-      return 'local install (not global)'
-    }
-  }
-
-  return null
-}
-
-// ── Step 1: Create ~/.claude-brain/ data directory ───────
-
-function setupHomeDirectory() {
-  const isAlreadySetup = existsSync(join(HOME, 'data'))
-
-  const dirs = [
-    join(HOME, 'data'),
-    join(HOME, 'logs'),
-    join(HOME, 'vault'),
-    join(HOME, 'vault', 'Projects'),
-    join(HOME, 'vault', 'Global'),
-    join(HOME, 'hooks'),
-    join(HOME, 'models'),
-  ]
-
-  for (const dir of dirs) {
-    mkdirSync(dir, { recursive: true })
-  }
-
-  // Write default .env if not present (for backward compat)
-  const envPath = join(HOME, '.env')
-  if (!existsSync(envPath)) {
-    writeFileSync(envPath, `# Claude Brain Configuration
-# Generated by postinstall
-VAULT_PATH=${join(HOME, 'vault')}
-LOG_LEVEL=warn
-NODE_ENV=production
-`, 'utf-8')
-  }
-
-  // Write default global standards
-  const standardsPath = join(HOME, 'vault', 'Global', 'standards.md')
-  if (!existsSync(standardsPath)) {
-    writeFileSync(standardsPath, `---
-type: global-standards
-last_updated: ${new Date().toISOString().split('T')[0]}
----
-
-# Global Coding Standards
-
-## General
-- Write clear, readable code
-- Prefer explicit over implicit
-- Keep functions focused and small
-
-## TypeScript
-- Use strict mode
-- Prefer const over let
-- Add JSDoc comments for public APIs
-`, 'utf-8')
-  }
-
-  if (isAlreadySetup) {
-    log('Data directory already exists')
-  } else {
-    log('Data directory created')
-  }
-
-  return true
-}
-
-// ── Step 2: Create default config.yml ────────────────────
-
-function createDefaultConfig() {
-  const configPath = join(HOME, 'config.yml')
-  if (existsSync(configPath)) {
-    log('Config already exists')
-    return true
-  }
-
-  const config = `# Claude Brain Configuration
-# Auto-generated on install — edit as needed
-# Docs: https://github.com/your-org/claude-brain
-
-storage:
-  dataDir: ~/.claude-brain/data
-
-# ChromaDB is optional. SQLite FTS5 is the default search backend.
-# Enable for semantic/vector search (requires: pip install chromadb)
-chromadb:
-  enabled: false
-
-# Code intelligence indexes your project files for smarter context
-codeIntelligence:
-  enabled: true
-  autoIndexOnSessionStart: true
-
-# SLM: Local model inference (replaces regex classifiers)
-# Models are optional — install with: claude-brain models download
-slm:
-  enabled: false
-  modelsDir: ~/.claude-brain/models
-  confidenceThreshold: 0.7
-  tasks:
-    intent: regex
-    entity: regex
-    query: regex
-    knowledge: regex
-    compress: api
-    pattern: regex
-
-logLevel: warn
-`
-
-  writeFileSync(configPath, config, 'utf-8')
-  log('Created default config.yml')
-  return true
-}
-
-// ── Step 2b: Upgrade existing config.yml (add missing sections) ──
-
-function upgradeExistingConfig() {
-  const configPath = join(HOME, 'config.yml')
-  if (!existsSync(configPath)) {
-    return false
-  }
-
-  let content
-  try {
-    content = readFileSync(configPath, 'utf-8')
-  } catch {
-    return false
-  }
-
-  // Don't touch if user already has an slm: section
-  if (/^slm:/m.test(content)) {
-    log('Config already has SLM section')
-    return true
-  }
-
-  const slmSection = `
-# SLM: Local model inference (replaces regex classifiers)
-# Models are optional — install with: claude-brain models download
-slm:
-  enabled: false
-  modelsDir: ~/.claude-brain/models
-  confidenceThreshold: 0.7
-  tasks:
-    intent: regex
-    entity: regex
-    query: regex
-    knowledge: regex
-    compress: api
-    pattern: regex
-`
-
-  writeFileSync(configPath, content.trimEnd() + '\n' + slmSection, 'utf-8')
-  log('Upgraded config.yml with SLM section')
-  return true
-}
-
-// ── Step 3: Copy hook files ──────────────────────────────
-
-/** Files to copy from package src/hooks/ to ~/.claude-brain/hooks/ */
-const HOOK_FILES = [
-  'brain-hook.ts',
-  'context-hook.ts',
-  'interceptor-hook.ts',
-  'capture.ts',
-  'queue.ts',
-  'types.ts',
-  'passive-classifier.ts',
-  'claude-code-mastery.md',
-]
-
-function copyHookFiles() {
-  const destDir = join(HOME, 'hooks')
-  mkdirSync(destDir, { recursive: true })
-
-  // Source: package root / src/hooks/
-  const srcDir = join(__dirname, '..', 'src', 'hooks')
-
-  let copied = 0
-  for (const file of HOOK_FILES) {
-    const src = join(srcDir, file)
-    if (existsSync(src)) {
-      writeFileSync(join(destDir, file), readFileSync(src, 'utf-8'), 'utf-8')
-      copied++
-    }
-  }
-  log(`Copied ${copied}/${HOOK_FILES.length} hook files`)
-  return copied > 0
-}
-
-// ── Step 4: Register hooks in ~/.claude/settings.json ────
-
-function installHooks() {
-  // Read existing settings
-  let settings = {}
-  if (existsSync(CLAUDE_SETTINGS)) {
-    try {
-      settings = JSON.parse(readFileSync(CLAUDE_SETTINGS, 'utf-8'))
-    } catch {}
-  }
-
-  // Check if already installed
-  function hasOurHooks(entries) {
-    if (!Array.isArray(entries)) return false
-    return entries.some(entry =>
-      entry && Array.isArray(entry.hooks) &&
-      entry.hooks.some(h => typeof h.command === 'string' && h.command.includes(HOOK_MARKER))
-    )
-  }
-
-  if (settings.hooks &&
-      hasOurHooks(settings.hooks.PostToolUse) &&
-      hasOurHooks(settings.hooks.Stop) &&
-      hasOurHooks(settings.hooks.UserPromptSubmit) &&
-      hasOurHooks(settings.hooks.SessionStart) &&
-      hasOurHooks(settings.hooks.PreToolUse)) {
-    log('Hooks already installed')
-    return true
-  }
-
-  // Build hook command
-  const brainScriptPath = join(HOME, 'hooks', 'brain-hook.ts')
-  const contextScriptPath = join(HOME, 'hooks', 'context-hook.ts')
-  const interceptorScriptPath = join(HOME, 'hooks', 'interceptor-hook.ts')
-  const port = process.env.CLAUDE_BRAIN_PORT || process.env.PORT || '3000'
-  function buildCmd(event, scriptPath) {
-    return `bun "${scriptPath}" --event ${event} --port ${port} # ${HOOK_MARKER}`
-  }
-
-  if (!settings.hooks) settings.hooks = {}
-
-  // 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) }],
-    })
-  }
-
-  // PreToolUse — code intelligence interceptor for Glob and Grep
-  if (!hasOurHooks(settings.hooks.PreToolUse)) {
-    if (!settings.hooks.PreToolUse) settings.hooks.PreToolUse = []
-    settings.hooks.PreToolUse.push({
-      matcher: 'Glob',
-      hooks: [{ type: 'command', command: buildCmd('PreToolUse', interceptorScriptPath) }],
-    })
-    settings.hooks.PreToolUse.push({
-      matcher: 'Grep',
-      hooks: [{ type: 'command', command: buildCmd('PreToolUse', interceptorScriptPath) }],
-    })
-  }
-
-  // Write atomically
-  if (!existsSync(CLAUDE_DIR)) {
-    mkdirSync(CLAUDE_DIR, { recursive: true })
-  }
-  const tmpPath = CLAUDE_SETTINGS + '.tmp'
-  writeFileSync(tmpPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8')
-  renameSync(tmpPath, CLAUDE_SETTINGS)
-
-  log('Hooks registered in Claude Code')
-  return true
-}
-
-// ── Step 5: Install CLAUDE.md ────────────────────────────
-
-function installClaudeMd() {
-  // Find the assets/CLAUDE.md relative to this script
-  // scripts/postinstall.mjs → assets/CLAUDE.md
-  const assetsPath = join(__dirname, '..', 'assets', 'CLAUDE.md')
-
-  if (!existsSync(assetsPath)) {
-    log('CLAUDE.md asset not found — skipping')
-    return false
-  }
-
-  // Only install if no CLAUDE.md exists yet (don't overwrite user customizations)
-  if (existsSync(CLAUDE_MD_PATH)) {
-    // Check if it already mentions claude-brain
-    const existing = readFileSync(CLAUDE_MD_PATH, 'utf-8')
-    if (existing.includes('brain') || existing.includes('Brain')) {
-      log('CLAUDE.md already configured')
-      return true
-    }
-    // Append our section
-    const addition = readFileSync(assetsPath, 'utf-8')
-    writeFileSync(CLAUDE_MD_PATH, existing.trimEnd() + '\n\n' + addition, 'utf-8')
-    log('Appended brain instructions to existing CLAUDE.md')
-    return true
-  }
-
-  // Create new
-  if (!existsSync(CLAUDE_DIR)) {
-    mkdirSync(CLAUDE_DIR, { recursive: true })
-  }
-  const content = readFileSync(assetsPath, 'utf-8')
-  writeFileSync(CLAUDE_MD_PATH, content, 'utf-8')
-  log('Installed CLAUDE.md')
-  return true
-}
-
-// ── Step 6: Install auto-start in shell profile ──────────
-
-const AUTO_START_MARKER = '# >>> claude-brain auto-start >>>'
-const AUTO_END_MARKER = '# <<< claude-brain auto-start <<<'
-
-function getShellProfile() {
-  const home = homedir()
-  const os = process.platform
-
-  if (os === 'win32') {
-    const userProfile = process.env.USERPROFILE
-    if (userProfile) {
-      return join(userProfile, 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1')
-    }
-    return null
-  }
-
-  // macOS defaults to zsh, Linux to bash
-  return os === 'darwin' ? join(home, '.zshrc') : join(home, '.bashrc')
-}
-
-function buildAutoStartSnippet(profilePath) {
-  if (profilePath && profilePath.endsWith('.ps1')) {
-    return [
-      AUTO_START_MARKER,
-      'if (Get-Command claude-brain -ErrorAction SilentlyContinue) {',
-      '  $listening = Get-NetTCPConnection -LocalPort 3000 -ErrorAction SilentlyContinue',
-      '  if (-not $listening) {',
-      '    Start-Process -NoNewWindow -FilePath "claude-brain" -ArgumentList "serve","--http-only" -WindowStyle Hidden',
-      '  }',
-      '}',
-      AUTO_END_MARKER,
-    ].join('\n')
-  }
-  return [
-    AUTO_START_MARKER,
-    '# Auto-start claude-brain HTTP server if not already running',
-    '(command -v claude-brain >/dev/null 2>&1 && ! lsof -ti :3000 >/dev/null 2>&1) && {',
-    '  nohup claude-brain serve --http-only >/dev/null 2>&1 &',
-    '  disown 2>/dev/null',
-    '}',
-    AUTO_END_MARKER,
-  ].join('\n')
-}
-
-function installShellAutoStart() {
-  const profilePath = getShellProfile()
-  if (!profilePath) {
-    log('No supported shell profile found, skipping auto-start')
-    return false
-  }
-
-  // Check if already installed
-  if (existsSync(profilePath)) {
-    const content = readFileSync(profilePath, 'utf-8')
-    if (content.includes(AUTO_START_MARKER)) {
-      log('Auto-start already installed')
-      return true
-    }
-  }
-
-  // Ensure parent directory exists
-  const dir = join(profilePath, '..')
-  mkdirSync(dir, { recursive: true })
-
-  const existing = existsSync(profilePath) ? readFileSync(profilePath, 'utf-8') : ''
-  const separator = existing.length > 0 && !existing.endsWith('\n') ? '\n\n' : '\n'
-  const snippet = buildAutoStartSnippet(profilePath)
-  writeFileSync(profilePath, existing + separator + snippet + '\n', 'utf-8')
-
-  log(`Auto-start installed in ${profilePath}`)
-  return true
-}
-
-// ── Main ─────────────────────────────────────────────────
-
-async function main() {
-  const skipReason = shouldSkip()
-  if (skipReason) {
-    log(`Skipping postinstall (${skipReason})`)
-    return
-  }
-
-  log('Running zero-config setup...')
-  console.error('')
-
-  const results = {
-    home: false,
-    config: false,
-    hooks: false,
-    hookFiles: false,
-    claudemd: false,
-    autostart: false,
-  }
-
-  // Step 1: Create data directory
-  try { results.home = setupHomeDirectory() } catch (e) { log(`Home setup failed: ${e.message}`) }
-
-  // Step 2: Create default config.yml
-  try { results.config = createDefaultConfig() } catch (e) { log(`Config creation failed: ${e.message}`) }
-
-  // Step 2b: Upgrade existing config.yml with new sections (e.g. SLM)
-  try { upgradeExistingConfig() } catch (e) { log(`Config upgrade failed: ${e.message}`) }
-
-  // Step 3: Copy hook files
-  try { results.hookFiles = copyHookFiles() } catch (e) { log(`Hook file copy failed: ${e.message}`) }
-
-  // Step 4: Register hooks in Claude Code settings
-  try { results.hooks = installHooks() } catch (e) { log(`Hook registration failed: ${e.message}`) }
-
-  // Step 5: Install CLAUDE.md
-  try { results.claudemd = installClaudeMd() } catch (e) { log(`CLAUDE.md install failed: ${e.message}`) }
-
-  // Step 6: Install auto-start in shell profile
-  try { results.autostart = installShellAutoStart() } catch (e) { log(`Auto-start install failed: ${e.message}`) }
-
-  // Print success summary
-  console.error('')
-  console.error(`${PREFIX} ────────────────────────────────────────`)
-  console.error(`${PREFIX}`)
-  console.error(`${PREFIX}  Claude Brain installed successfully!`)
-  console.error(`${PREFIX}`)
-  console.error(`${PREFIX}  Server will auto-start on next terminal session.`)
-  console.error(`${PREFIX}  Auto-updates check every 24h in the background.`)
-  console.error(`${PREFIX}`)
-  console.error(`${PREFIX}  Data:   ${HOME}/data/`)
-  console.error(`${PREFIX}  Config: ${HOME}/config.yml`)
-  console.error(`${PREFIX}  Hooks:  ${HOME}/hooks/`)
-  console.error(`${PREFIX}`)
-  console.error(`${PREFIX}  No setup wizard needed — everything works out of the box.`)
-  console.error(`${PREFIX}  ChromaDB is optional (disabled by default, SQLite FTS5 is used).`)
-  console.error(`${PREFIX}  To disable auto-start: claude-brain autostart uninstall`)
-  console.error(`${PREFIX} ────────────────────────────────────────`)
-  console.error('')
-}
-
-main().catch(err => {
-  log(`Postinstall error: ${err.message}`)
-}).finally(() => {
-  process.exit(0)
-})
+#!/usr/bin/env node
+
+/**
+ * Postinstall script for claude-brain.
+ * Runs automatically after `npm install -g claude-brain` or `bun install -g claude-brain`.
+ * Pure Node.js — no TypeScript, no path aliases, no Bun APIs.
+ * Always exits 0 so it never blocks the install.
+ *
+ * Phase 30: Zero-config — does EVERYTHING automatically:
+ * 1. Create data directory: ~/.claude-brain/data/
+ * 2. Create default config if none exists: ~/.claude-brain/config.yml
+ * 3. Copy hook files to ~/.claude-brain/hooks/
+ * 4. Register hooks in ~/.claude/settings.json (if Claude Code installed)
+ * 5. Print success message with next steps
+ *
+ * No interactive prompts. No setup wizard. Sensible defaults.
+ */
+
+import { mkdirSync, writeFileSync, readFileSync, existsSync, renameSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { homedir } from 'node:os'
+import { execSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const PREFIX = '[claude-brain]'
+const HOME = join(homedir(), '.claude-brain')
+const CLAUDE_DIR = join(homedir(), '.claude')
+const CLAUDE_SETTINGS = join(CLAUDE_DIR, 'settings.json')
+const CLAUDE_MD_PATH = join(CLAUDE_DIR, 'CLAUDE.md')
+const HOOK_MARKER = 'claude-brain-hook'
+
+function log(msg) {
+  console.error(`${PREFIX} ${msg}`)
+}
+
+// ── Step 0: Skip if not a global install ─────────────────
+
+function shouldSkip() {
+  // CI environments
+  if (process.env.CI === 'true' || process.env.CI === '1') {
+    return 'CI environment detected'
+  }
+
+  // If we're inside a node_modules directory, it's a local install
+  const scriptDir = dirname(__filename)
+  if (scriptDir.includes('node_modules') && !scriptDir.includes('global')) {
+    // Check if this is actually a global install by looking deeper
+    // bun global installs go to ~/.bun/install/global/node_modules
+    // npm global installs go to /usr/local/lib/node_modules or ~/.npm-global
+    const isGlobalPath =
+      scriptDir.includes('.bun/install/global') ||
+      scriptDir.includes('/usr/local/lib/node_modules') ||
+      scriptDir.includes('/usr/lib/node_modules') ||
+      scriptDir.includes('npm-global') ||
+      scriptDir.includes('AppData/Roaming/npm')
+
+    if (!isGlobalPath) {
+      return 'local install (not global)'
+    }
+  }
+
+  return null
+}
+
+// ── Step 1: Create ~/.claude-brain/ data directory ───────
+
+function setupHomeDirectory() {
+  const isAlreadySetup = existsSync(join(HOME, 'data'))
+
+  const dirs = [
+    join(HOME, 'data'),
+    join(HOME, 'logs'),
+    join(HOME, 'vault'),
+    join(HOME, 'vault', 'Projects'),
+    join(HOME, 'vault', 'Global'),
+    join(HOME, 'hooks'),
+    join(HOME, 'models'),
+  ]
+
+  for (const dir of dirs) {
+    mkdirSync(dir, { recursive: true })
+  }
+
+  // Write default .env if not present (for backward compat)
+  const envPath = join(HOME, '.env')
+  if (!existsSync(envPath)) {
+    writeFileSync(envPath, `# Claude Brain Configuration
+# Generated by postinstall
+VAULT_PATH=${join(HOME, 'vault')}
+LOG_LEVEL=warn
+NODE_ENV=production
+`, 'utf-8')
+  }
+
+  // Write default global standards
+  const standardsPath = join(HOME, 'vault', 'Global', 'standards.md')
+  if (!existsSync(standardsPath)) {
+    writeFileSync(standardsPath, `---
+type: global-standards
+last_updated: ${new Date().toISOString().split('T')[0]}
+---
+
+# Global Coding Standards
+
+## General
+- Write clear, readable code
+- Prefer explicit over implicit
+- Keep functions focused and small
+
+## TypeScript
+- Use strict mode
+- Prefer const over let
+- Add JSDoc comments for public APIs
+`, 'utf-8')
+  }
+
+  if (isAlreadySetup) {
+    log('Data directory already exists')
+  } else {
+    log('Data directory created')
+  }
+
+  return true
+}
+
+// ── Step 2: Create default config.yml ────────────────────
+
+function createDefaultConfig() {
+  const configPath = join(HOME, 'config.yml')
+  if (existsSync(configPath)) {
+    log('Config already exists')
+    return true
+  }
+
+  const config = `# Claude Brain Configuration
+# Auto-generated on install — edit as needed
+# Docs: https://github.com/your-org/claude-brain
+
+storage:
+  dataDir: ~/.claude-brain/data
+
+# ChromaDB is optional. SQLite FTS5 is the default search backend.
+# Enable for semantic/vector search (requires: pip install chromadb)
+chromadb:
+  enabled: false
+
+# Code intelligence indexes your project files for smarter context
+codeIntelligence:
+  enabled: true
+  autoIndexOnSessionStart: true
+
+# SLM: Local model inference (replaces regex classifiers)
+# Models are optional — install with: claude-brain models download
+slm:
+  enabled: false
+  modelsDir: ~/.claude-brain/models
+  confidenceThreshold: 0.7
+  tasks:
+    intent: regex
+    entity: regex
+    query: regex
+    knowledge: regex
+    compress: api
+    pattern: regex
+
+logLevel: warn
+`
+
+  writeFileSync(configPath, config, 'utf-8')
+  log('Created default config.yml')
+  return true
+}
+
+// ── Step 2b: Upgrade existing config.yml (add missing sections) ──
+
+function upgradeExistingConfig() {
+  const configPath = join(HOME, 'config.yml')
+  if (!existsSync(configPath)) {
+    return false
+  }
+
+  let content
+  try {
+    content = readFileSync(configPath, 'utf-8')
+  } catch {
+    return false
+  }
+
+  // Don't touch if user already has an slm: section
+  if (/^slm:/m.test(content)) {
+    log('Config already has SLM section')
+    return true
+  }
+
+  const slmSection = `
+# SLM: Local model inference (replaces regex classifiers)
+# Models are optional — install with: claude-brain models download
+slm:
+  enabled: false
+  modelsDir: ~/.claude-brain/models
+  confidenceThreshold: 0.7
+  tasks:
+    intent: regex
+    entity: regex
+    query: regex
+    knowledge: regex
+    compress: api
+    pattern: regex
+`
+
+  writeFileSync(configPath, content.trimEnd() + '\n' + slmSection, 'utf-8')
+  log('Upgraded config.yml with SLM section')
+  return true
+}
+
+// ── Step 3: Copy hook files ──────────────────────────────
+
+/** Files to copy from package src/hooks/ to ~/.claude-brain/hooks/ */
+const HOOK_FILES = [
+  'brain-hook.ts',
+  'context-hook.ts',
+  'interceptor-hook.ts',
+  'capture.ts',
+  'queue.ts',
+  'types.ts',
+  'passive-classifier.ts',
+  'claude-code-mastery.md',
+]
+
+function copyHookFiles() {
+  const destDir = join(HOME, 'hooks')
+  mkdirSync(destDir, { recursive: true })
+
+  // Source: package root / src/hooks/
+  const srcDir = join(__dirname, '..', 'src', 'hooks')
+
+  let copied = 0
+  for (const file of HOOK_FILES) {
+    const src = join(srcDir, file)
+    if (existsSync(src)) {
+      writeFileSync(join(destDir, file), readFileSync(src, 'utf-8'), 'utf-8')
+      copied++
+    }
+  }
+  log(`Copied ${copied}/${HOOK_FILES.length} hook files`)
+  return copied > 0
+}
+
+// ── Step 4: Register hooks in ~/.claude/settings.json ────
+
+function installHooks() {
+  // Read existing settings
+  let settings = {}
+  if (existsSync(CLAUDE_SETTINGS)) {
+    try {
+      settings = JSON.parse(readFileSync(CLAUDE_SETTINGS, 'utf-8'))
+    } catch {}
+  }
+
+  // Check if already installed
+  function hasOurHooks(entries) {
+    if (!Array.isArray(entries)) return false
+    return entries.some(entry =>
+      entry && Array.isArray(entry.hooks) &&
+      entry.hooks.some(h => typeof h.command === 'string' && h.command.includes(HOOK_MARKER))
+    )
+  }
+
+  if (settings.hooks &&
+      hasOurHooks(settings.hooks.PostToolUse) &&
+      hasOurHooks(settings.hooks.Stop) &&
+      hasOurHooks(settings.hooks.UserPromptSubmit) &&
+      hasOurHooks(settings.hooks.SessionStart) &&
+      hasOurHooks(settings.hooks.PreToolUse)) {
+    log('Hooks already installed')
+    return true
+  }
+
+  // Build hook command
+  const brainScriptPath = join(HOME, 'hooks', 'brain-hook.ts')
+  const contextScriptPath = join(HOME, 'hooks', 'context-hook.ts')
+  const interceptorScriptPath = join(HOME, 'hooks', 'interceptor-hook.ts')
+  const port = process.env.CLAUDE_BRAIN_PORT || process.env.PORT || '3000'
+  function buildCmd(event, scriptPath) {
+    return `bun "${scriptPath}" --event ${event} --port ${port} # ${HOOK_MARKER}`
+  }
+
+  if (!settings.hooks) settings.hooks = {}
+
+  // 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) }],
+    })
+  }
+
+  // PreToolUse — code intelligence interceptor for Glob and Grep
+  if (!hasOurHooks(settings.hooks.PreToolUse)) {
+    if (!settings.hooks.PreToolUse) settings.hooks.PreToolUse = []
+    settings.hooks.PreToolUse.push({
+      matcher: 'Glob',
+      hooks: [{ type: 'command', command: buildCmd('PreToolUse', interceptorScriptPath) }],
+    })
+    settings.hooks.PreToolUse.push({
+      matcher: 'Grep',
+      hooks: [{ type: 'command', command: buildCmd('PreToolUse', interceptorScriptPath) }],
+    })
+  }
+
+  // Write atomically
+  if (!existsSync(CLAUDE_DIR)) {
+    mkdirSync(CLAUDE_DIR, { recursive: true })
+  }
+  const tmpPath = CLAUDE_SETTINGS + '.tmp'
+  writeFileSync(tmpPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8')
+  renameSync(tmpPath, CLAUDE_SETTINGS)
+
+  log('Hooks registered in Claude Code')
+  return true
+}
+
+// ── Step 5: Install CLAUDE.md ────────────────────────────
+
+function installClaudeMd() {
+  // Find the assets/CLAUDE.md relative to this script
+  // scripts/postinstall.mjs → assets/CLAUDE.md
+  const assetsPath = join(__dirname, '..', 'assets', 'CLAUDE.md')
+
+  if (!existsSync(assetsPath)) {
+    log('CLAUDE.md asset not found — skipping')
+    return false
+  }
+
+  // Only install if no CLAUDE.md exists yet (don't overwrite user customizations)
+  if (existsSync(CLAUDE_MD_PATH)) {
+    // Check if it already mentions claude-brain
+    const existing = readFileSync(CLAUDE_MD_PATH, 'utf-8')
+    if (existing.includes('brain') || existing.includes('Brain')) {
+      log('CLAUDE.md already configured')
+      return true
+    }
+    // Append our section
+    const addition = readFileSync(assetsPath, 'utf-8')
+    writeFileSync(CLAUDE_MD_PATH, existing.trimEnd() + '\n\n' + addition, 'utf-8')
+    log('Appended brain instructions to existing CLAUDE.md')
+    return true
+  }
+
+  // Create new
+  if (!existsSync(CLAUDE_DIR)) {
+    mkdirSync(CLAUDE_DIR, { recursive: true })
+  }
+  const content = readFileSync(assetsPath, 'utf-8')
+  writeFileSync(CLAUDE_MD_PATH, content, 'utf-8')
+  log('Installed CLAUDE.md')
+  return true
+}
+
+// ── Step 6: Install auto-start in shell profile ──────────
+
+const AUTO_START_MARKER = '# >>> claude-brain auto-start >>>'
+const AUTO_END_MARKER = '# <<< claude-brain auto-start <<<'
+
+function getShellProfile() {
+  const home = homedir()
+  const os = process.platform
+
+  if (os === 'win32') {
+    const userProfile = process.env.USERPROFILE
+    if (userProfile) {
+      return join(userProfile, 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1')
+    }
+    return null
+  }
+
+  // macOS defaults to zsh, Linux to bash
+  return os === 'darwin' ? join(home, '.zshrc') : join(home, '.bashrc')
+}
+
+function buildAutoStartSnippet(profilePath) {
+  if (profilePath && profilePath.endsWith('.ps1')) {
+    return [
+      AUTO_START_MARKER,
+      'if (Get-Command claude-brain -ErrorAction SilentlyContinue) {',
+      '  $listening = Get-NetTCPConnection -LocalPort 3000 -ErrorAction SilentlyContinue',
+      '  if (-not $listening) {',
+      '    Start-Process -NoNewWindow -FilePath "claude-brain" -ArgumentList "serve","--http-only" -WindowStyle Hidden',
+      '  }',
+      '}',
+      AUTO_END_MARKER,
+    ].join('\n')
+  }
+  return [
+    AUTO_START_MARKER,
+    '# Auto-start claude-brain HTTP server if not already running',
+    '(command -v claude-brain >/dev/null 2>&1 && ! lsof -ti :3000 >/dev/null 2>&1) && {',
+    '  nohup claude-brain serve --http-only >/dev/null 2>&1 &',
+    '  disown 2>/dev/null',
+    '}',
+    AUTO_END_MARKER,
+  ].join('\n')
+}
+
+function installShellAutoStart() {
+  const profilePath = getShellProfile()
+  if (!profilePath) {
+    log('No supported shell profile found, skipping auto-start')
+    return false
+  }
+
+  // Check if already installed
+  if (existsSync(profilePath)) {
+    const content = readFileSync(profilePath, 'utf-8')
+    if (content.includes(AUTO_START_MARKER)) {
+      log('Auto-start already installed')
+      return true
+    }
+  }
+
+  // Ensure parent directory exists
+  const dir = join(profilePath, '..')
+  mkdirSync(dir, { recursive: true })
+
+  const existing = existsSync(profilePath) ? readFileSync(profilePath, 'utf-8') : ''
+  const separator = existing.length > 0 && !existing.endsWith('\n') ? '\n\n' : '\n'
+  const snippet = buildAutoStartSnippet(profilePath)
+  writeFileSync(profilePath, existing + separator + snippet + '\n', 'utf-8')
+
+  log(`Auto-start installed in ${profilePath}`)
+  return true
+}
+
+// ── Main ─────────────────────────────────────────────────
+
+async function main() {
+  const skipReason = shouldSkip()
+  if (skipReason) {
+    log(`Skipping postinstall (${skipReason})`)
+    return
+  }
+
+  log('Running zero-config setup...')
+  console.error('')
+
+  const results = {
+    home: false,
+    config: false,
+    hooks: false,
+    hookFiles: false,
+    claudemd: false,
+    autostart: false,
+  }
+
+  // Step 1: Create data directory
+  try { results.home = setupHomeDirectory() } catch (e) { log(`Home setup failed: ${e.message}`) }
+
+  // Step 2: Create default config.yml
+  try { results.config = createDefaultConfig() } catch (e) { log(`Config creation failed: ${e.message}`) }
+
+  // Step 2b: Upgrade existing config.yml with new sections (e.g. SLM)
+  try { upgradeExistingConfig() } catch (e) { log(`Config upgrade failed: ${e.message}`) }
+
+  // Step 3: Copy hook files
+  try { results.hookFiles = copyHookFiles() } catch (e) { log(`Hook file copy failed: ${e.message}`) }
+
+  // Step 4: Register hooks in Claude Code settings
+  try { results.hooks = installHooks() } catch (e) { log(`Hook registration failed: ${e.message}`) }
+
+  // Step 5: Install CLAUDE.md
+  try { results.claudemd = installClaudeMd() } catch (e) { log(`CLAUDE.md install failed: ${e.message}`) }
+
+  // Step 6: Install auto-start in shell profile
+  try { results.autostart = installShellAutoStart() } catch (e) { log(`Auto-start install failed: ${e.message}`) }
+
+  // Print success summary
+  console.error('')
+  console.error(`${PREFIX} ────────────────────────────────────────`)
+  console.error(`${PREFIX}`)
+  console.error(`${PREFIX}  Claude Brain installed successfully!`)
+  console.error(`${PREFIX}`)
+  console.error(`${PREFIX}  Server will auto-start on next terminal session.`)
+  console.error(`${PREFIX}  Auto-updates check every 24h in the background.`)
+  console.error(`${PREFIX}`)
+  console.error(`${PREFIX}  Data:   ${HOME}/data/`)
+  console.error(`${PREFIX}  Config: ${HOME}/config.yml`)
+  console.error(`${PREFIX}  Hooks:  ${HOME}/hooks/`)
+  console.error(`${PREFIX}`)
+  console.error(`${PREFIX}  No setup wizard needed — everything works out of the box.`)
+  console.error(`${PREFIX}  ChromaDB is optional (disabled by default, SQLite FTS5 is used).`)
+  console.error(`${PREFIX}  To disable auto-start: claude-brain autostart uninstall`)
+  console.error(`${PREFIX} ────────────────────────────────────────`)
+  console.error('')
+}
+
+main().catch(err => {
+  log(`Postinstall error: ${err.message}`)
+}).finally(() => {
+  process.exit(0)
+})