claude-brain 0.15.2 → 0.17.0

package/scripts/postinstall.mjs

@@ -1,341 +1,341 @@
-#!/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.
- */
-
-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/ ──────────────────────
-
-function setupHomeDirectory() {
-  if (existsSync(join(HOME, 'data'))) {
-    log('Home directory already initialized')
-    return true
-  }
-
-  log(`Setting up ${HOME}/...`)
-
-  const dirs = [
-    join(HOME, 'data'),
-    join(HOME, 'data', 'chroma'),
-    join(HOME, 'logs'),
-    join(HOME, 'vault'),
-    join(HOME, 'vault', 'Projects'),
-    join(HOME, 'vault', 'Global'),
-    join(HOME, 'hooks'),
-  ]
-
-  for (const dir of dirs) {
-    mkdirSync(dir, { recursive: true })
-  }
-
-  // Write default .env if not present
-  const envPath = join(HOME, '.env')
-  if (!existsSync(envPath)) {
-    writeFileSync(envPath, `# Claude Brain Configuration
-# Generated by postinstall
-VAULT_PATH=${join(HOME, 'vault')}
-LOG_LEVEL=info
-NODE_ENV=production
-
-# ChromaDB Configuration
-CHROMA_MODE=client-server
-CHROMA_HOST=localhost
-CHROMA_PORT=8000
-CHROMA_EMBEDDING_PROVIDER=transformers
-`, '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')
-  }
-
-  log('Home directory initialized')
-  return true
-}
-
-// ── Step 2: Install ChromaDB via pip ─────────────────────
-
-function installChromaDB() {
-  // Check if already installed
-  try {
-    execSync('chroma --version', { stdio: 'pipe', timeout: 5000 })
-    log('ChromaDB already installed')
-    return true
-  } catch {}
-
-  // Check for Python
-  let pythonCmd = null
-  for (const cmd of ['python3', 'python']) {
-    try {
-      const ver = execSync(`${cmd} --version`, { encoding: 'utf-8', stdio: 'pipe', timeout: 5000 })
-      if (ver.includes('3.')) {
-        pythonCmd = cmd
-        break
-      }
-    } catch {}
-  }
-
-  if (!pythonCmd) {
-    log('Python 3 not found — skipping ChromaDB install (SQLite fallback will be used)')
-    return false
-  }
-
-  log('Installing ChromaDB...')
-
-  const pipCommands = pythonCmd === 'python3'
-    ? ['pip3 install chromadb', 'python3 -m pip install chromadb']
-    : ['pip install chromadb', 'python -m pip install chromadb']
-
-  for (const cmd of pipCommands) {
-    try {
-      execSync(cmd, { stdio: 'pipe', timeout: 300_000 })
-      log('ChromaDB installed')
-      return true
-    } catch {}
-  }
-
-  log('ChromaDB install failed — SQLite fallback will be used')
-  return false
-}
-
-// ── Step 3: Register MCP server ──────────────────────────
-
-function registerMcpServer() {
-  // Check if claude CLI exists
-  try {
-    execSync('claude --version', { stdio: 'pipe', timeout: 5000 })
-  } catch {
-    log('Claude CLI not found — skipping MCP registration')
-    log('  Run manually: claude mcp add claude-brain -- claude-brain serve')
-    return false
-  }
-
-  // Check if already configured
-  try {
-    const result = execSync('claude mcp list', { encoding: 'utf-8', stdio: 'pipe', timeout: 10000 })
-    if (result.includes('claude-brain')) {
-      log('MCP server already registered')
-      return true
-    }
-  } catch {}
-
-  // Register
-  try {
-    execSync('claude mcp add claude-brain -- claude-brain serve', {
-      stdio: 'pipe',
-      timeout: 15000,
-    })
-    log('Registered as MCP server in Claude Code')
-    return true
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err)
-    if (msg.includes('already') || msg.includes('exists')) {
-      log('MCP server already registered')
-      return true
-    }
-    log('MCP registration failed — run manually: claude mcp add claude-brain -- claude-brain serve')
-    return false
-  }
-}
-
-// ── Step 4: Install hooks ────────────────────────────────
-
-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))) {
-    log('Hooks already installed')
-    return true
-  }
-
-  // Build hook command
-  const scriptPath = join(HOME, 'hooks', 'brain-hook.ts')
-  function buildCmd(event) {
-    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') }],
-  })
-
-  // 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 installed')
-  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
-}
-
-// ── Main ─────────────────────────────────────────────────
-
-async function main() {
-  const skipReason = shouldSkip()
-  if (skipReason) {
-    log(`Skipping postinstall (${skipReason})`)
-    return
-  }
-
-  log('Running postinstall setup...')
-  console.error('')
-
-  const results = {
-    home: false,
-    chromadb: false,
-    mcp: false,
-    hooks: false,
-    claudemd: false,
-  }
-
-  try { results.home = setupHomeDirectory() } catch (e) { log(`Home setup failed: ${e.message}`) }
-  try { results.chromadb = installChromaDB() } catch (e) { log(`ChromaDB install failed: ${e.message}`) }
-  try { results.mcp = registerMcpServer() } catch (e) { log(`MCP registration failed: ${e.message}`) }
-  try { results.hooks = installHooks() } catch (e) { log(`Hook install failed: ${e.message}`) }
-  try { results.claudemd = installClaudeMd() } catch (e) { log(`CLAUDE.md install failed: ${e.message}`) }
-
-  console.error('')
-  log('Setup complete! Restart Claude Code to activate.')
-}
-
-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.
+ */
+
+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/ ──────────────────────
+
+function setupHomeDirectory() {
+  if (existsSync(join(HOME, 'data'))) {
+    log('Home directory already initialized')
+    return true
+  }
+
+  log(`Setting up ${HOME}/...`)
+
+  const dirs = [
+    join(HOME, 'data'),
+    join(HOME, 'data', 'chroma'),
+    join(HOME, 'logs'),
+    join(HOME, 'vault'),
+    join(HOME, 'vault', 'Projects'),
+    join(HOME, 'vault', 'Global'),
+    join(HOME, 'hooks'),
+  ]
+
+  for (const dir of dirs) {
+    mkdirSync(dir, { recursive: true })
+  }
+
+  // Write default .env if not present
+  const envPath = join(HOME, '.env')
+  if (!existsSync(envPath)) {
+    writeFileSync(envPath, `# Claude Brain Configuration
+# Generated by postinstall
+VAULT_PATH=${join(HOME, 'vault')}
+LOG_LEVEL=info
+NODE_ENV=production
+
+# ChromaDB Configuration
+CHROMA_MODE=client-server
+CHROMA_HOST=localhost
+CHROMA_PORT=8000
+CHROMA_EMBEDDING_PROVIDER=transformers
+`, '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')
+  }
+
+  log('Home directory initialized')
+  return true
+}
+
+// ── Step 2: Install ChromaDB via pip ─────────────────────
+
+function installChromaDB() {
+  // Check if already installed
+  try {
+    execSync('chroma --version', { stdio: 'pipe', timeout: 5000 })
+    log('ChromaDB already installed')
+    return true
+  } catch {}
+
+  // Check for Python
+  let pythonCmd = null
+  for (const cmd of ['python3', 'python']) {
+    try {
+      const ver = execSync(`${cmd} --version`, { encoding: 'utf-8', stdio: 'pipe', timeout: 5000 })
+      if (ver.includes('3.')) {
+        pythonCmd = cmd
+        break
+      }
+    } catch {}
+  }
+
+  if (!pythonCmd) {
+    log('Python 3 not found — skipping ChromaDB install (SQLite fallback will be used)')
+    return false
+  }
+
+  log('Installing ChromaDB...')
+
+  const pipCommands = pythonCmd === 'python3'
+    ? ['pip3 install chromadb', 'python3 -m pip install chromadb']
+    : ['pip install chromadb', 'python -m pip install chromadb']
+
+  for (const cmd of pipCommands) {
+    try {
+      execSync(cmd, { stdio: 'pipe', timeout: 300_000 })
+      log('ChromaDB installed')
+      return true
+    } catch {}
+  }
+
+  log('ChromaDB install failed — SQLite fallback will be used')
+  return false
+}
+
+// ── Step 3: Register MCP server ──────────────────────────
+
+function registerMcpServer() {
+  // Check if claude CLI exists
+  try {
+    execSync('claude --version', { stdio: 'pipe', timeout: 5000 })
+  } catch {
+    log('Claude CLI not found — skipping MCP registration')
+    log('  Run manually: claude mcp add claude-brain -- claude-brain serve')
+    return false
+  }
+
+  // Check if already configured
+  try {
+    const result = execSync('claude mcp list', { encoding: 'utf-8', stdio: 'pipe', timeout: 10000 })
+    if (result.includes('claude-brain')) {
+      log('MCP server already registered')
+      return true
+    }
+  } catch {}
+
+  // Register
+  try {
+    execSync('claude mcp add claude-brain -- claude-brain serve', {
+      stdio: 'pipe',
+      timeout: 15000,
+    })
+    log('Registered as MCP server in Claude Code')
+    return true
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    if (msg.includes('already') || msg.includes('exists')) {
+      log('MCP server already registered')
+      return true
+    }
+    log('MCP registration failed — run manually: claude mcp add claude-brain -- claude-brain serve')
+    return false
+  }
+}
+
+// ── Step 4: Install hooks ────────────────────────────────
+
+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))) {
+    log('Hooks already installed')
+    return true
+  }
+
+  // Build hook command
+  const scriptPath = join(HOME, 'hooks', 'brain-hook.ts')
+  function buildCmd(event) {
+    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') }],
+  })
+
+  // 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 installed')
+  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
+}
+
+// ── Main ─────────────────────────────────────────────────
+
+async function main() {
+  const skipReason = shouldSkip()
+  if (skipReason) {
+    log(`Skipping postinstall (${skipReason})`)
+    return
+  }
+
+  log('Running postinstall setup...')
+  console.error('')
+
+  const results = {
+    home: false,
+    chromadb: false,
+    mcp: false,
+    hooks: false,
+    claudemd: false,
+  }
+
+  try { results.home = setupHomeDirectory() } catch (e) { log(`Home setup failed: ${e.message}`) }
+  try { results.chromadb = installChromaDB() } catch (e) { log(`ChromaDB install failed: ${e.message}`) }
+  try { results.mcp = registerMcpServer() } catch (e) { log(`MCP registration failed: ${e.message}`) }
+  try { results.hooks = installHooks() } catch (e) { log(`Hook install failed: ${e.message}`) }
+  try { results.claudemd = installClaudeMd() } catch (e) { log(`CLAUDE.md install failed: ${e.message}`) }
+
+  console.error('')
+  log('Setup complete! Restart Claude Code to activate.')
+}
+
+main().catch(err => {
+  log(`Postinstall error: ${err.message}`)
+}).finally(() => {
+  process.exit(0)
+})