claude-brain 0.30.2 → 0.30.3

package/src/cli/commands/refresh.ts

@@ -1,339 +1,344 @@
-/**
- * claude-brain refresh — One-command update & restart.
- * Kill all instances → install latest → setup ChromaDB/MCP/hooks → verify.
- * Cross-platform: macOS/Linux and Windows.
- */
-
-import { execSync } from 'node:child_process'
-import { existsSync, readFileSync, unlinkSync } from 'node:fs'
-import fs from 'fs/promises'
-import path from 'path'
-import os from 'os'
-import { fileURLToPath } from 'url'
-import { getHomePaths } from '@/config/home'
-import { ensureHomeDirectory } from '@/cli/auto-setup'
-import { ensureChromaRunning } from '@/cli/commands/chroma'
-import { installHooks, isHooksInstalled } from '@/hooks/installer'
-import {
-  renderLogo, theme, heading, successText, errorText, warningText, dimText,
-  box, withSpinner,
-} from '@/cli/ui/index.js'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = path.dirname(__filename)
-const PACKAGE_ROOT = path.resolve(__dirname, '..', '..', '..')
-
-const isWindows = process.platform === 'win32'
-
-function getInstalledVersion(): string {
-  try {
-    const pkg = JSON.parse(readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf-8'))
-    return pkg.version || 'unknown'
-  } catch {
-    return 'unknown'
-  }
-}
-
-function getLatestVersion(): string | null {
-  try {
-    const result = execSync('npm view claude-brain version', {
-      encoding: 'utf-8',
-      stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 15_000,
-    })
-    return result.trim()
-  } catch {
-    return null
-  }
-}
-
-/** Kill processes matching a pattern, excluding our own PID. */
-function killByPattern(pattern: string): boolean {
-  const myPid = process.pid
-  try {
-    if (isWindows) {
-      // Get matching PIDs, filter out ourselves, then kill
-      const result = execSync(
-        `wmic process where "commandline like '%${pattern}%' and processid != ${myPid}" get processid /format:list`,
-        { encoding: 'utf-8', stdio: 'pipe', timeout: 5000 }
-      )
-      const pids = result.match(/ProcessId=(\d+)/g)?.map(m => m.split('=')[1]) || []
-      for (const pid of pids) {
-        try { execSync(`taskkill /F /PID ${pid}`, { stdio: 'pipe', timeout: 5000 }) } catch {}
-      }
-      return pids.length > 0
-    } else {
-      // Get matching PIDs via pgrep, exclude our own, then kill each
-      const result = execSync(`pgrep -f "${pattern}"`, {
-        encoding: 'utf-8', stdio: 'pipe', timeout: 5000,
-      })
-      const pids = result.trim().split('\n').filter(p => p && Number(p) !== myPid)
-      for (const pid of pids) {
-        try { process.kill(Number(pid), 'SIGKILL') } catch {}
-      }
-      return pids.length > 0
-    }
-  } catch {
-    return false
-  }
-}
-
-/** Kill any process listening on a given port, excluding our own PID. */
-function killByPort(port: number): boolean {
-  const myPid = process.pid
-  try {
-    if (isWindows) {
-      const result = execSync(`netstat -ano | findstr :${port} | findstr LISTENING`, {
-        encoding: 'utf-8', stdio: 'pipe', timeout: 5000,
-      })
-      const pids = new Set(
-        result.split('\n')
-          .map(line => line.trim().split(/\s+/).pop())
-          .filter(p => p && Number(p) !== myPid)
-      )
-      for (const pid of pids) {
-        try { execSync(`taskkill /F /PID ${pid}`, { stdio: 'pipe', timeout: 5000 }) } catch {}
-      }
-      return pids.size > 0
-    } else {
-      const raw = execSync(`lsof -ti :${port}`, {
-        encoding: 'utf-8', stdio: 'pipe', timeout: 5000,
-      }).trim()
-      if (raw) {
-        const pids = raw.split('\n').filter(p => p && Number(p) !== myPid)
-        for (const pid of pids) {
-          try { process.kill(Number(pid), 'SIGKILL') } catch {}
-        }
-        return pids.length > 0
-      }
-    }
-  } catch {}
-  return false
-}
-
-function sleep(ms: number): Promise<void> {
-  return new Promise(resolve => setTimeout(resolve, ms))
-}
-
-function cleanupLocalMcpScopes(): void {
-  try {
-    execSync('claude mcp remove claude-brain -s local', {
-      encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10_000,
-    })
-  } catch {}
-  try {
-    execSync('claude mcp remove claude-brain -s project', {
-      encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10_000,
-    })
-  } catch {}
-}
-
-function isMcpConfigured(): boolean {
-  try {
-    const result = execSync('claude mcp list', {
-      encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10_000,
-    })
-    return result.includes('claude-brain')
-  } catch {
-    return false
-  }
-}
-
-function registerMcp(): boolean {
-  try {
-    execSync('claude mcp add claude-brain -s user -- claude-brain serve', {
-      encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10_000,
-    })
-    return true
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err)
-    // Already registered is fine
-    return msg.includes('already') || msg.includes('exists')
-  }
-}
-
-function isChromaReachable(): boolean {
-  for (const apiVersion of ['v2', 'v1']) {
-    try {
-      execSync(`curl -sf http://localhost:8000/api/${apiVersion}/heartbeat`, {
-        stdio: 'pipe', timeout: 3000,
-      })
-      return true
-    } catch {}
-  }
-  return false
-}
-
-// ── Main ──────────────────────────────────────────────────
-
-export async function runRefresh() {
-  console.log()
-  console.log(renderLogo())
-  console.log()
-  console.log(heading('Refresh — Kill, Update, Setup'))
-  console.log()
-
-  const versionBefore = getInstalledVersion()
-  const results: Array<[string, 'ok' | 'warn' | 'fail', string]> = []
-
-  // ── Step 1: Kill all running instances ──────────────────
-
-  await withSpinner('Stopping all claude-brain processes', async () => {
-    // Kill claude-brain processes
-    killByPattern('claude-brain')
-
-    // Kill ChromaDB
-    if (isWindows) {
-      killByPattern('chroma.exe')
-    } else {
-      killByPattern('chroma run')
-    }
-
-    // Kill by port (HTTP API 3000, ChromaDB 8000)
-    killByPort(3000)
-    killByPort(8000)
-
-    // Clean up stale PID file
-    const pidPath = path.join(getHomePaths().data, 'chroma.pid')
-    if (existsSync(pidPath)) {
-      try { unlinkSync(pidPath) } catch {}
-    }
-
-    // Let ports release
-    await sleep(2000)
-  })
-  results.push(['Kill processes', 'ok', 'All instances stopped'])
-  console.log(successText('  All instances stopped'))
-  console.log()
-
-  // ── Step 2: Install latest version ──────────────────────
-
-  const latestVersion = await withSpinner('Checking npm for latest version', async () => getLatestVersion())
-
-  if (latestVersion) {
-    console.log(dimText(`  Installed: v${versionBefore}  →  Latest: v${latestVersion}`))
-  }
-
-  if (latestVersion && latestVersion !== versionBefore) {
-    try {
-      await withSpinner(`Installing claude-brain@${latestVersion}`, async () => {
-        try {
-          execSync('bun install -g claude-brain@latest', {
-            encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 120_000,
-          })
-        } catch {
-          // Fallback to npm
-          execSync('npm install -g claude-brain@latest', {
-            encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 120_000,
-          })
-        }
-      })
-      results.push(['Update', 'ok', `v${versionBefore} → v${latestVersion}`])
-      console.log(successText(`  Updated: v${versionBefore} → v${latestVersion}`))
-    } catch {
-      results.push(['Update', 'fail', 'Install failed — try manually: bun install -g claude-brain@latest'])
-      console.log(warningText('  Update failed. Try manually: bun install -g claude-brain@latest'))
-    }
-  } else {
-    results.push(['Update', 'ok', `v${versionBefore} is latest`])
-    console.log(successText(`  Already on latest (v${versionBefore})`))
-  }
-  console.log()
-
-  // ── Step 3: Full setup ──────────────────────────────────
-
-  // 3a. Home directory
-  await withSpinner('Ensuring home directory', async () => {
-    ensureHomeDirectory()
-  })
-  results.push(['Home dir', 'ok', '~/.claude-brain/'])
-  console.log(successText('  Home directory ready'))
-
-  // 3b. ChromaDB
-  const chromaOk = await withSpinner('Starting ChromaDB', async () => {
-    return ensureChromaRunning({ silent: true })
-  })
-  if (chromaOk) {
-    results.push(['ChromaDB', 'ok', 'Running on port 8000'])
-    console.log(successText('  ChromaDB running'))
-  } else {
-    results.push(['ChromaDB', 'warn', 'Not available — install with: claude-brain chroma install'])
-    console.log(warningText('  ChromaDB not available (install with: claude-brain chroma install)'))
-  }
-
-  // 3c. Hooks
-  await withSpinner('Installing hooks', async () => {
-    installHooks()
-  })
-  const hooksOk = isHooksInstalled()
-  if (hooksOk) {
-    results.push(['Hooks', 'ok', 'Installed in ~/.claude/settings.json'])
-    console.log(successText('  Hooks installed'))
-  } else {
-    results.push(['Hooks', 'warn', 'Hook installation issue'])
-    console.log(warningText('  Hooks may not be fully installed'))
-  }
-
-  // 3d. CLAUDE.md
-  const assetsPath = path.join(PACKAGE_ROOT, 'assets', 'CLAUDE.md')
-  const claudeDir = path.join(os.homedir(), '.claude')
-  const destPath = path.join(claudeDir, 'CLAUDE.md')
-
-  if (existsSync(assetsPath)) {
-    await withSpinner('Updating CLAUDE.md', async () => {
-      await fs.mkdir(claudeDir, { recursive: true })
-      await fs.copyFile(assetsPath, destPath)
-    })
-    results.push(['CLAUDE.md', 'ok', '~/.claude/CLAUDE.md'])
-    console.log(successText('  CLAUDE.md updated'))
-  } else {
-    results.push(['CLAUDE.md', 'warn', 'Asset not found in package'])
-    console.log(warningText('  CLAUDE.md asset not found, skipping'))
-  }
-
-  // 3e. MCP registration
-  const mcpOk = await withSpinner('Ensuring MCP at user scope', async () => {
-    cleanupLocalMcpScopes()
-    if (!isMcpConfigured()) {
-      return registerMcp()
-    }
-    return true
-  })
-  if (mcpOk) {
-    results.push(['MCP', 'ok', 'Registered in Claude Code'])
-    console.log(successText('  MCP server registered'))
-  } else {
-    results.push(['MCP', 'warn', 'Run manually: claude-brain install'])
-    console.log(warningText('  MCP registration failed — run: claude-brain install'))
-  }
-
-  console.log()
-
-  // ── Step 4: Verify & report ─────────────────────────────
-
-  const chromaVerified = isChromaReachable()
-  if (!chromaVerified && chromaOk) {
-    // Update result if it was ok but now unreachable
-    const idx = results.findIndex(r => r[0] === 'ChromaDB')
-    if (idx >= 0) results[idx] = ['ChromaDB', 'warn', 'Started but not responding yet']
-  }
-
-  // Build summary
-  const statusIcon = (s: 'ok' | 'warn' | 'fail') =>
-    s === 'ok' ? successText('✓') : s === 'warn' ? warningText('⚠') : errorText('✗')
-
-  const summaryLines = results.map(
-    ([label, status, detail]) => `  ${statusIcon(status)} ${theme.bold(label!.padEnd(12))} ${dimText(detail!)}`
-  )
-
-  const allOk = results.every(r => r[1] === 'ok')
-
-  console.log(box([
-    heading(allOk ? 'Refresh complete!' : 'Refresh complete (with warnings)'),
-    '',
-    ...summaryLines,
-    '',
-    dimText('Verify: claude-brain health'),
-  ].join('\n'), allOk ? 'Done' : 'Done'))
-  console.log()
-}
+/**
+ * claude-brain refresh — One-command update & restart.
+ * Kill all instances → install latest → setup ChromaDB/MCP/hooks → verify.
+ * Cross-platform: macOS/Linux and Windows.
+ */
+
+import { spawnSync } from 'node:child_process'
+import { existsSync, readFileSync, unlinkSync } from 'node:fs'
+import fs from 'fs/promises'
+import path from 'path'
+import os from 'os'
+import { fileURLToPath } from 'url'
+import { getHomePaths } from '@/config/home'
+import { ensureHomeDirectory } from '@/cli/auto-setup'
+import { ensureChromaRunning } from '@/cli/commands/chroma'
+import { installHooks, isHooksInstalled } from '@/hooks/installer'
+import {
+  renderLogo, theme, heading, successText, errorText, warningText, dimText,
+  box, withSpinner,
+} from '@/cli/ui/index.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+const PACKAGE_ROOT = path.resolve(__dirname, '..', '..', '..')
+
+const isWindows = process.platform === 'win32'
+
+function getInstalledVersion(): string {
+  try {
+    const pkg = JSON.parse(readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf-8'))
+    return pkg.version || 'unknown'
+  } catch {
+    return 'unknown'
+  }
+}
+
+function getLatestVersion(): string | null {
+  try {
+    const result = spawnSync('npm', ['view', 'claude-brain', 'version'], {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 15_000,
+    })
+    if (result.error || result.status !== 0) return null
+    return result.stdout?.trim() || null
+  } catch {
+    return null
+  }
+}
+
+/** Kill processes matching a pattern, excluding our own PID. */
+function killByPattern(pattern: string): boolean {
+  const myPid = process.pid
+  try {
+    if (isWindows) {
+      // Get matching PIDs, filter out ourselves, then kill
+      const result = spawnSync('wmic', [
+        'process', 'where',
+        `commandline like '%${pattern}%' and processid != ${myPid}`,
+        'get', 'processid', '/format:list',
+      ], { encoding: 'utf-8', stdio: 'pipe', timeout: 5000 })
+      const output = result.stdout || ''
+      const pids = output.match(/ProcessId=(\d+)/g)?.map(m => m.split('=')[1]) || []
+      for (const pid of pids) {
+        try { spawnSync('taskkill', ['/F', '/PID', pid!], { stdio: 'pipe', timeout: 5000 }) } catch {}
+      }
+      return pids.length > 0
+    } else {
+      // Get matching PIDs via pgrep, exclude our own, then kill each
+      const result = spawnSync('pgrep', ['-f', pattern], {
+        encoding: 'utf-8', stdio: 'pipe', timeout: 5000,
+      })
+      const output = result.stdout?.trim() || ''
+      const pids = output.split('\n').filter(p => p && Number(p) !== myPid)
+      for (const pid of pids) {
+        try { process.kill(Number(pid), 'SIGKILL') } catch {}
+      }
+      return pids.length > 0
+    }
+  } catch {
+    return false
+  }
+}
+
+/** Kill any process listening on a given port, excluding our own PID. */
+function killByPort(port: number): boolean {
+  const myPid = process.pid
+  try {
+    if (isWindows) {
+      const result = spawnSync('cmd', ['/c', `netstat -ano | findstr :${port} | findstr LISTENING`], {
+        encoding: 'utf-8', stdio: 'pipe', timeout: 5000,
+      })
+      const output = result.stdout || ''
+      const pids = new Set(
+        output.split('\n')
+          .map(line => line.trim().split(/\s+/).pop())
+          .filter(p => p && Number(p) !== myPid)
+      )
+      for (const pid of pids) {
+        try { spawnSync('taskkill', ['/F', '/PID', pid!], { stdio: 'pipe', timeout: 5000 }) } catch {}
+      }
+      return pids.size > 0
+    } else {
+      const result = spawnSync('lsof', ['-ti', `:${port}`], {
+        encoding: 'utf-8', stdio: 'pipe', timeout: 5000,
+      })
+      const raw = result.stdout?.trim() || ''
+      if (raw) {
+        const pids = raw.split('\n').filter(p => p && Number(p) !== myPid)
+        for (const pid of pids) {
+          try { process.kill(Number(pid), 'SIGKILL') } catch {}
+        }
+        return pids.length > 0
+      }
+    }
+  } catch {}
+  return false
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise(resolve => setTimeout(resolve, ms))
+}
+
+function cleanupLocalMcpScopes(): void {
+  spawnSync('claude', ['mcp', 'remove', 'claude-brain', '-s', 'local'], {
+    encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10_000,
+  })
+  spawnSync('claude', ['mcp', 'remove', 'claude-brain', '-s', 'project'], {
+    encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10_000,
+  })
+}
+
+function isMcpConfigured(): boolean {
+  try {
+    const result = spawnSync('claude', ['mcp', 'list'], {
+      encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10_000,
+    })
+    if (result.error || result.status !== 0) return false
+    return (result.stdout || '').includes('claude-brain')
+  } catch {
+    return false
+  }
+}
+
+function registerMcp(): boolean {
+  try {
+    const result = spawnSync('claude', ['mcp', 'add', 'claude-brain', '-s', 'user', '--', 'claude-brain', 'serve'], {
+      encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10_000,
+    })
+    if (!result.error && result.status === 0) return true
+    const msg = result.stderr || ''
+    // Already registered is fine
+    return msg.includes('already') || msg.includes('exists')
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    return msg.includes('already') || msg.includes('exists')
+  }
+}
+
+function isChromaReachable(): boolean {
+  for (const apiVersion of ['v2', 'v1']) {
+    const result = spawnSync('curl', ['-sf', `http://localhost:8000/api/${apiVersion}/heartbeat`], {
+      stdio: 'pipe', timeout: 3000,
+    })
+    if (!result.error && result.status === 0) return true
+  }
+  return false
+}
+
+// ── Main ──────────────────────────────────────────────────
+
+export async function runRefresh() {
+  console.log()
+  console.log(renderLogo())
+  console.log()
+  console.log(heading('Refresh — Kill, Update, Setup'))
+  console.log()
+
+  const versionBefore = getInstalledVersion()
+  const results: Array<[string, 'ok' | 'warn' | 'fail', string]> = []
+
+  // ── Step 1: Kill all running instances ──────────────────
+
+  await withSpinner('Stopping all claude-brain processes', async () => {
+    // Kill claude-brain processes
+    killByPattern('claude-brain')
+
+    // Kill ChromaDB
+    if (isWindows) {
+      killByPattern('chroma.exe')
+    } else {
+      killByPattern('chroma run')
+    }
+
+    // Kill by port (HTTP API 3000, ChromaDB 8000)
+    killByPort(3000)
+    killByPort(8000)
+
+    // Clean up stale PID file
+    const pidPath = path.join(getHomePaths().data, 'chroma.pid')
+    if (existsSync(pidPath)) {
+      try { unlinkSync(pidPath) } catch {}
+    }
+
+    // Let ports release
+    await sleep(2000)
+  })
+  results.push(['Kill processes', 'ok', 'All instances stopped'])
+  console.log(successText('  All instances stopped'))
+  console.log()
+
+  // ── Step 2: Install latest version ──────────────────────
+
+  const latestVersion = await withSpinner('Checking npm for latest version', async () => getLatestVersion())
+
+  if (latestVersion) {
+    console.log(dimText(`  Installed: v${versionBefore}  →  Latest: v${latestVersion}`))
+  }
+
+  if (latestVersion && latestVersion !== versionBefore) {
+    try {
+      await withSpinner(`Installing claude-brain@${latestVersion}`, async () => {
+        const bunResult = spawnSync('bun', ['install', '-g', 'claude-brain@latest'], {
+          encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 120_000,
+        })
+        if (bunResult.error || bunResult.status !== 0) {
+          // Fallback to npm
+          const npmResult = spawnSync('npm', ['install', '-g', 'claude-brain@latest'], {
+            encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 120_000,
+          })
+          if (npmResult.error || npmResult.status !== 0) {
+            throw new Error(npmResult.stderr || 'Install failed')
+          }
+        }
+      })
+      results.push(['Update', 'ok', `v${versionBefore} → v${latestVersion}`])
+      console.log(successText(`  Updated: v${versionBefore} → v${latestVersion}`))
+    } catch {
+      results.push(['Update', 'fail', 'Install failed — try manually: bun install -g claude-brain@latest'])
+      console.log(warningText('  Update failed. Try manually: bun install -g claude-brain@latest'))
+    }
+  } else {
+    results.push(['Update', 'ok', `v${versionBefore} is latest`])
+    console.log(successText(`  Already on latest (v${versionBefore})`))
+  }
+  console.log()
+
+  // ── Step 3: Full setup ──────────────────────────────────
+
+  // 3a. Home directory
+  await withSpinner('Ensuring home directory', async () => {
+    ensureHomeDirectory()
+  })
+  results.push(['Home dir', 'ok', '~/.claude-brain/'])
+  console.log(successText('  Home directory ready'))
+
+  // 3b. ChromaDB
+  const chromaOk = await withSpinner('Starting ChromaDB', async () => {
+    return ensureChromaRunning({ silent: true })
+  })
+  if (chromaOk) {
+    results.push(['ChromaDB', 'ok', 'Running on port 8000'])
+    console.log(successText('  ChromaDB running'))
+  } else {
+    results.push(['ChromaDB', 'warn', 'Not available — install with: claude-brain chroma install'])
+    console.log(warningText('  ChromaDB not available (install with: claude-brain chroma install)'))
+  }
+
+  // 3c. Hooks
+  await withSpinner('Installing hooks', async () => {
+    installHooks()
+  })
+  const hooksOk = isHooksInstalled()
+  if (hooksOk) {
+    results.push(['Hooks', 'ok', 'Installed in ~/.claude/settings.json'])
+    console.log(successText('  Hooks installed'))
+  } else {
+    results.push(['Hooks', 'warn', 'Hook installation issue'])
+    console.log(warningText('  Hooks may not be fully installed'))
+  }
+
+  // 3d. CLAUDE.md
+  const assetsPath = path.join(PACKAGE_ROOT, 'assets', 'CLAUDE.md')
+  const claudeDir = path.join(os.homedir(), '.claude')
+  const destPath = path.join(claudeDir, 'CLAUDE.md')
+
+  if (existsSync(assetsPath)) {
+    await withSpinner('Updating CLAUDE.md', async () => {
+      await fs.mkdir(claudeDir, { recursive: true })
+      await fs.copyFile(assetsPath, destPath)
+    })
+    results.push(['CLAUDE.md', 'ok', '~/.claude/CLAUDE.md'])
+    console.log(successText('  CLAUDE.md updated'))
+  } else {
+    results.push(['CLAUDE.md', 'warn', 'Asset not found in package'])
+    console.log(warningText('  CLAUDE.md asset not found, skipping'))
+  }
+
+  // 3e. MCP registration
+  const mcpOk = await withSpinner('Ensuring MCP at user scope', async () => {
+    cleanupLocalMcpScopes()
+    if (!isMcpConfigured()) {
+      return registerMcp()
+    }
+    return true
+  })
+  if (mcpOk) {
+    results.push(['MCP', 'ok', 'Registered in Claude Code'])
+    console.log(successText('  MCP server registered'))
+  } else {
+    results.push(['MCP', 'warn', 'Run manually: claude-brain install'])
+    console.log(warningText('  MCP registration failed — run: claude-brain install'))
+  }
+
+  console.log()
+
+  // ── Step 4: Verify & report ─────────────────────────────
+
+  const chromaVerified = isChromaReachable()
+  if (!chromaVerified && chromaOk) {
+    // Update result if it was ok but now unreachable
+    const idx = results.findIndex(r => r[0] === 'ChromaDB')
+    if (idx >= 0) results[idx] = ['ChromaDB', 'warn', 'Started but not responding yet']
+  }
+
+  // Build summary
+  const statusIcon = (s: 'ok' | 'warn' | 'fail') =>
+    s === 'ok' ? successText('✓') : s === 'warn' ? warningText('⚠') : errorText('✗')
+
+  const summaryLines = results.map(
+    ([label, status, detail]) => `  ${statusIcon(status)} ${theme.bold(label!.padEnd(12))} ${dimText(detail!)}`
+  )
+
+  const allOk = results.every(r => r[1] === 'ok')
+
+  console.log(box([
+    heading(allOk ? 'Refresh complete!' : 'Refresh complete (with warnings)'),
+    '',
+    ...summaryLines,
+    '',
+    dimText('Verify: claude-brain health'),
+  ].join('\n'), allOk ? 'Done' : 'Done'))
+  console.log()
+}