claude-brain 0.15.2 → 0.17.0

package/src/setup/wizard.ts

@@ -1,461 +1,461 @@
-import prompts from 'prompts'
-import fs from 'fs/promises'
-import { existsSync } from 'fs'
-import { execSync } from 'child_process'
-import path from 'path'
-import os from 'os'
-import { fileURLToPath } from 'url'
-import type { Logger } from 'pino'
-import { getHomePaths } from '@/config/home'
-import {
-  theme, heading, successText, errorText, warningText, dimText,
-  box, stepIndicator, summaryPanel,
-  withSpinner, transition,
-} from '@/cli/ui/index.js'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = path.dirname(__filename)
-// Package root is two levels up from src/setup/
-const PACKAGE_ROOT = path.resolve(__dirname, '..', '..')
-
-export interface SetupAnswers {
-  vaultPath: string
-  logLevel: string
-  enableFileWatch: boolean
-  enableChromaDB: boolean
-  createSampleProject: boolean
-  installClaudeMd: boolean
-}
-
-export class SetupWizard {
-  private logger: Logger
-
-  constructor(logger: Logger) {
-    this.logger = logger.child({ component: 'setup-wizard' })
-  }
-
-  async run(): Promise<SetupAnswers> {
-    // Step 1: Detect Vaults
-    console.log(stepIndicator(1, 6, 'Detecting Obsidian Vaults'))
-    await transition()
-
-    const suggestedPaths = await withSpinner('Scanning for Obsidian vaults', () =>
-      this.detectVaultLocations()
-    )
-
-    if (suggestedPaths.length > 0) {
-      console.log(successText(`Found ${suggestedPaths.length} vault${suggestedPaths.length > 1 ? 's' : ''}`))
-    } else {
-      console.log(warningText('No vaults auto-detected — enter path manually'))
-    }
-    console.log()
-
-    // Step 2: Vault Configuration
-    console.log(stepIndicator(2, 6, 'Vault Configuration'))
-    await transition()
-
-    const vaultAnswers = await prompts([
-      {
-        type: 'select',
-        name: 'vaultPathChoice',
-        message: 'Where is your Obsidian vault?',
-        choices: [
-          ...suggestedPaths.map(p => ({ title: p, value: p })),
-          { title: 'Enter custom path', value: 'custom' }
-        ],
-        initial: 0
-      },
-      {
-        type: (prev) => prev === 'custom' ? 'text' : null,
-        name: 'vaultPath',
-        message: 'Enter vault path:',
-        validate: async (value: string) => {
-          try {
-            const stat = await fs.stat(value)
-            return stat.isDirectory() || 'Path must be a directory'
-          } catch {
-            return 'Path does not exist'
-          }
-        }
-      },
-    ])
-
-    if (!vaultAnswers.vaultPathChoice) {
-      console.log('\n' + errorText('Setup cancelled.'))
-      process.exit(0)
-    }
-
-    const finalVaultPath = vaultAnswers.vaultPath || vaultAnswers.vaultPathChoice
-
-    // Step 3: Logging
-    console.log(stepIndicator(3, 6, 'Logging Configuration'))
-    await transition()
-
-    const loggingAnswers = await prompts({
-      type: 'select',
-      name: 'logLevel',
-      message: 'Select log level:',
-      choices: [
-        { title: 'Error (production)', value: 'error' },
-        { title: 'Warn (recommended)', value: 'warn' },
-        { title: 'Info', value: 'info' },
-        { title: 'Debug (verbose)', value: 'debug' }
-      ],
-      initial: 1
-    })
-
-    // Step 4: Features
-    console.log(stepIndicator(4, 6, 'Feature Selection'))
-    await transition()
-
-    const featureAnswers = await prompts([
-      {
-        type: 'confirm',
-        name: 'enableFileWatch',
-        message: 'Enable automatic file watching?',
-        initial: true
-      },
-      {
-        type: 'confirm',
-        name: 'createSampleProject',
-        message: 'Create a sample project to test with?',
-        initial: true
-      },
-      {
-        type: 'confirm',
-        name: 'installClaudeMd',
-        message: 'Install CLAUDE.md protocol file to ~/.claude/CLAUDE.md?',
-        initial: true
-      }
-    ])
-
-    // Step 5: ChromaDB
-    console.log(stepIndicator(5, 6, 'ChromaDB (Vector Database)'))
-    await transition()
-
-    console.log(dimText('ChromaDB enables semantic search, knowledge graph,'))
-    console.log(dimText('and advanced intelligence features. Requires Python 3.'))
-    console.log()
-
-    const chromaInstalled = this.isChromaInstalled()
-    if (chromaInstalled) {
-      console.log(successText('ChromaDB CLI detected'))
-    } else {
-      console.log(warningText('ChromaDB CLI not found — you can install it later'))
-    }
-    console.log()
-
-    const chromaAnswers = await prompts({
-      type: 'confirm',
-      name: 'enableChromaDB',
-      message: chromaInstalled
-        ? 'Enable ChromaDB for advanced features?'
-        : 'Enable ChromaDB? (install later: pip install chromadb)',
-      initial: chromaInstalled
-    })
-
-    // Step 6: Review
-    console.log(stepIndicator(6, 6, 'Review Configuration'))
-    await transition()
-
-    const answers: SetupAnswers = {
-      vaultPath: finalVaultPath,
-      logLevel: loggingAnswers.logLevel ?? 'warn',
-      enableFileWatch: featureAnswers.enableFileWatch ?? true,
-      enableChromaDB: chromaAnswers.enableChromaDB ?? false,
-      createSampleProject: featureAnswers.createSampleProject ?? true,
-      installClaudeMd: featureAnswers.installClaudeMd ?? true,
-    }
-
-    console.log(summaryPanel('Configuration Summary', [
-      { label: 'Vault Path', value: answers.vaultPath, status: 'success' },
-      { label: 'Log Level', value: answers.logLevel, status: 'info' },
-      { label: 'File Watching', value: answers.enableFileWatch ? 'Enabled' : 'Disabled', status: answers.enableFileWatch ? 'success' : 'warning' },
-      { label: 'ChromaDB', value: answers.enableChromaDB ? 'Enabled' : 'Disabled', status: answers.enableChromaDB ? 'success' : 'warning' },
-      { label: 'Sample Project', value: answers.createSampleProject ? 'Yes' : 'No', status: 'info' },
-      { label: 'Install CLAUDE.md', value: answers.installClaudeMd ? 'Yes' : 'No', status: 'info' },
-    ]))
-    console.log()
-
-    const { confirm } = await prompts({
-      type: 'confirm',
-      name: 'confirm',
-      message: 'Apply this configuration?',
-      initial: true
-    })
-
-    if (!confirm) {
-      console.log('\n' + errorText('Setup cancelled.'))
-      process.exit(0)
-    }
-
-    return answers
-  }
-
-  private async detectVaultLocations(): Promise<string[]> {
-    const locations: string[] = []
-    const home = os.homedir()
-    const homePaths = getHomePaths()
-
-    const commonPaths = [
-      homePaths.vault,
-      path.join(home, 'Documents', 'Obsidian'),
-      path.join(home, 'Obsidian'),
-      path.join(home, 'vault'),
-      path.join(home, 'Documents', 'vault'),
-      path.join(home, 'iCloud', 'Obsidian'),
-      path.join(home, 'Library', 'Mobile Documents', 'iCloud~md~obsidian', 'Documents')
-    ]
-
-    for (const loc of commonPaths) {
-      try {
-        const stat = await fs.stat(loc)
-        if (stat.isDirectory()) {
-          locations.push(loc)
-        }
-      } catch {
-      }
-    }
-
-    return locations
-  }
-
-  private isChromaInstalled(): boolean {
-    try {
-      execSync('chroma --version', { stdio: 'pipe', timeout: 5000 })
-      return true
-    } catch {
-      return false
-    }
-  }
-
-  async applyConfiguration(answers: SetupAnswers): Promise<void> {
-    console.log('\n' + heading('Applying configuration...') + '\n')
-
-    const homePaths = getHomePaths()
-
-    const chromaEnvLines = answers.enableChromaDB
-      ? [
-          '',
-          '# ChromaDB Configuration',
-          'CHROMA_MODE=client-server',
-          'CHROMA_HOST=localhost',
-          'CHROMA_PORT=8000',
-          'CHROMA_EMBEDDING_PROVIDER=transformers',
-        ].join('\n')
-      : ''
-
-    const envContent = `# Claude Brain Configuration
-VAULT_PATH=${answers.vaultPath}
-LOG_LEVEL=${answers.logLevel}
-ENABLE_FILE_WATCH=${answers.enableFileWatch}
-DB_PATH=./data/memory.db
-LOG_FILE_PATH=./logs/claude-brain.log
-SERVER_NAME=claude-brain
-${chromaEnvLines}
-`
-
-    await withSpinner('Writing .env configuration', async () => {
-      await fs.writeFile(homePaths.env, envContent, 'utf-8')
-    })
-
-    await withSpinner('Creating data and log directories', async () => {
-      await fs.mkdir(homePaths.data, { recursive: true })
-      await fs.mkdir(homePaths.chroma, { recursive: true })
-      await fs.mkdir(homePaths.logs, { recursive: true })
-    })
-
-    if (answers.createSampleProject) {
-      await withSpinner('Creating sample project in vault', async () => {
-        await this.createSampleProject(answers.vaultPath)
-      })
-    }
-
-    if (answers.installClaudeMd) {
-      const shouldInstall = await this.confirmClaudeMdInstall()
-      if (shouldInstall) {
-        await withSpinner('Installing CLAUDE.md', async () => {
-          await this.copyClaudeMd()
-        })
-      }
-    }
-
-    const nextSteps: string[] = [
-      heading('Setup complete!'),
-      '',
-      dimText('Next steps:'),
-      `  ${theme.primary('1.')} ${theme.bold('claude-brain install')}`,
-      `     ${dimText('Register as MCP server')}`,
-    ]
-
-    if (answers.enableChromaDB) {
-      nextSteps.push(
-        `  ${theme.primary('2.')} ${theme.bold('claude-brain chroma install')}`,
-        `     ${dimText('Install ChromaDB (if not already installed)')}`,
-        `  ${theme.primary('3.')} ${theme.bold('claude-brain chroma start')}`,
-        `     ${dimText('Start the ChromaDB server')}`,
-        `  ${theme.primary('4.')} ${theme.bold('claude-brain health')}`,
-        `     ${dimText('Verify everything works')}`,
-      )
-    } else {
-      nextSteps.push(
-        `  ${theme.primary('2.')} ${theme.bold('claude-brain health')}`,
-        `     ${dimText('Verify everything works')}`,
-        '',
-        dimText('Optional: Enable ChromaDB later for advanced features:'),
-        `  ${dimText('claude-brain chroma install && claude-brain chroma start')}`,
-      )
-    }
-
-    console.log()
-    console.log(box(nextSteps.join('\n'), 'Done'))
-    console.log()
-  }
-
-  private async confirmClaudeMdInstall(): Promise<boolean> {
-    const sourcePath = path.join(PACKAGE_ROOT, 'assets', 'CLAUDE.md')
-    const destPath = path.join(os.homedir(), '.claude', 'CLAUDE.md')
-
-    if (!existsSync(sourcePath)) {
-      console.log(warningText('CLAUDE.md asset not found, skipping'))
-      return false
-    }
-
-    if (existsSync(destPath)) {
-      const { overwrite } = await prompts({
-        type: 'confirm',
-        name: 'overwrite',
-        message: '~/.claude/CLAUDE.md already exists. Overwrite?',
-        initial: false,
-      })
-      if (!overwrite) {
-        console.log(dimText('  Skipped CLAUDE.md installation'))
-        return false
-      }
-    }
-
-    return true
-  }
-
-  private async copyClaudeMd(): Promise<void> {
-    const sourcePath = path.join(PACKAGE_ROOT, 'assets', 'CLAUDE.md')
-    const claudeDir = path.join(os.homedir(), '.claude')
-    const destPath = path.join(claudeDir, 'CLAUDE.md')
-    await fs.mkdir(claudeDir, { recursive: true })
-    await fs.copyFile(sourcePath, destPath)
-  }
-
-  private async createSampleProject(vaultPath: string): Promise<void> {
-    const projectPath = path.join(vaultPath, 'Projects', 'sample-project')
-
-    await fs.mkdir(projectPath, { recursive: true })
-
-    await fs.writeFile(
-      path.join(projectPath, 'context.md'),
-      `---
-type: project-context
-project: sample-project
-status: active
-created: ${new Date().toISOString().split('T')[0]}
-updated: ${new Date().toISOString().split('T')[0]}
-tech_stack:
-  - TypeScript
-  - Node.js
-tags:
-  - sample
----
-
-# Sample Project
-
-## Overview
-This is a sample project created by Claude Brain setup wizard.
-
-## Tech Stack
-- TypeScript
-- Node.js
-- Bun
-
-## Goals
-- Test Claude Brain integration
-- Learn the workflow
-`,
-      'utf-8'
-    )
-
-    await fs.writeFile(
-      path.join(projectPath, 'progress.md'),
-      `---
-type: progress-tracker
-project: sample-project
-status: in-progress
-current_phase: setup
-completion_percentage: 0
----
-
-# Progress
-
-## Next Steps
-- [ ] Configure Claude Brain
-- [ ] Test MCP integration
-- [ ] Try all tools
-`,
-      'utf-8'
-    )
-
-    await fs.writeFile(
-      path.join(projectPath, 'decisions.md'),
-      `---
-type: decision-log
-project: sample-project
-decision_count: 0
----
-
-# Decision Log
-
-This file will track important decisions for the project.
-`,
-      'utf-8'
-    )
-
-    await fs.writeFile(
-      path.join(projectPath, 'standards.md'),
-      `---
-type: coding-standards
-project: sample-project
----
-
-# Coding Standards
-
-## TypeScript
-- Use strict mode
-- Prefer const over let
-`,
-      'utf-8'
-    )
-
-    const globalPath = path.join(vaultPath, 'Global')
-    await fs.mkdir(globalPath, { recursive: true })
-
-    const globalStandardsPath = path.join(globalPath, 'standards.md')
-    try {
-      await fs.access(globalStandardsPath)
-    } catch {
-      await fs.writeFile(
-        globalStandardsPath,
-        `---
-type: global-standards
-last_updated: ${new Date().toISOString().split('T')[0]}
----
-
-# Global Coding Standards
-
-## TypeScript
-- Use strict mode
-- Prefer const over let
-- Add JSDoc comments for public APIs
-`,
-        'utf-8'
-      )
-    }
-  }
-}
+import prompts from 'prompts'
+import fs from 'fs/promises'
+import { existsSync } from 'fs'
+import { execSync } from 'child_process'
+import path from 'path'
+import os from 'os'
+import { fileURLToPath } from 'url'
+import type { Logger } from 'pino'
+import { getHomePaths } from '@/config/home'
+import {
+  theme, heading, successText, errorText, warningText, dimText,
+  box, stepIndicator, summaryPanel,
+  withSpinner, transition,
+} from '@/cli/ui/index.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+// Package root is two levels up from src/setup/
+const PACKAGE_ROOT = path.resolve(__dirname, '..', '..')
+
+export interface SetupAnswers {
+  vaultPath: string
+  logLevel: string
+  enableFileWatch: boolean
+  enableChromaDB: boolean
+  createSampleProject: boolean
+  installClaudeMd: boolean
+}
+
+export class SetupWizard {
+  private logger: Logger
+
+  constructor(logger: Logger) {
+    this.logger = logger.child({ component: 'setup-wizard' })
+  }
+
+  async run(): Promise<SetupAnswers> {
+    // Step 1: Detect Vaults
+    console.log(stepIndicator(1, 6, 'Detecting Obsidian Vaults'))
+    await transition()
+
+    const suggestedPaths = await withSpinner('Scanning for Obsidian vaults', () =>
+      this.detectVaultLocations()
+    )
+
+    if (suggestedPaths.length > 0) {
+      console.log(successText(`Found ${suggestedPaths.length} vault${suggestedPaths.length > 1 ? 's' : ''}`))
+    } else {
+      console.log(warningText('No vaults auto-detected — enter path manually'))
+    }
+    console.log()
+
+    // Step 2: Vault Configuration
+    console.log(stepIndicator(2, 6, 'Vault Configuration'))
+    await transition()
+
+    const vaultAnswers = await prompts([
+      {
+        type: 'select',
+        name: 'vaultPathChoice',
+        message: 'Where is your Obsidian vault?',
+        choices: [
+          ...suggestedPaths.map(p => ({ title: p, value: p })),
+          { title: 'Enter custom path', value: 'custom' }
+        ],
+        initial: 0
+      },
+      {
+        type: (prev) => prev === 'custom' ? 'text' : null,
+        name: 'vaultPath',
+        message: 'Enter vault path:',
+        validate: async (value: string) => {
+          try {
+            const stat = await fs.stat(value)
+            return stat.isDirectory() || 'Path must be a directory'
+          } catch {
+            return 'Path does not exist'
+          }
+        }
+      },
+    ])
+
+    if (!vaultAnswers.vaultPathChoice) {
+      console.log('\n' + errorText('Setup cancelled.'))
+      process.exit(0)
+    }
+
+    const finalVaultPath = vaultAnswers.vaultPath || vaultAnswers.vaultPathChoice
+
+    // Step 3: Logging
+    console.log(stepIndicator(3, 6, 'Logging Configuration'))
+    await transition()
+
+    const loggingAnswers = await prompts({
+      type: 'select',
+      name: 'logLevel',
+      message: 'Select log level:',
+      choices: [
+        { title: 'Error (production)', value: 'error' },
+        { title: 'Warn (recommended)', value: 'warn' },
+        { title: 'Info', value: 'info' },
+        { title: 'Debug (verbose)', value: 'debug' }
+      ],
+      initial: 1
+    })
+
+    // Step 4: Features
+    console.log(stepIndicator(4, 6, 'Feature Selection'))
+    await transition()
+
+    const featureAnswers = await prompts([
+      {
+        type: 'confirm',
+        name: 'enableFileWatch',
+        message: 'Enable automatic file watching?',
+        initial: true
+      },
+      {
+        type: 'confirm',
+        name: 'createSampleProject',
+        message: 'Create a sample project to test with?',
+        initial: true
+      },
+      {
+        type: 'confirm',
+        name: 'installClaudeMd',
+        message: 'Install CLAUDE.md protocol file to ~/.claude/CLAUDE.md?',
+        initial: true
+      }
+    ])
+
+    // Step 5: ChromaDB
+    console.log(stepIndicator(5, 6, 'ChromaDB (Vector Database)'))
+    await transition()
+
+    console.log(dimText('ChromaDB enables semantic search, knowledge graph,'))
+    console.log(dimText('and advanced intelligence features. Requires Python 3.'))
+    console.log()
+
+    const chromaInstalled = this.isChromaInstalled()
+    if (chromaInstalled) {
+      console.log(successText('ChromaDB CLI detected'))
+    } else {
+      console.log(warningText('ChromaDB CLI not found — you can install it later'))
+    }
+    console.log()
+
+    const chromaAnswers = await prompts({
+      type: 'confirm',
+      name: 'enableChromaDB',
+      message: chromaInstalled
+        ? 'Enable ChromaDB for advanced features?'
+        : 'Enable ChromaDB? (install later: pip install chromadb)',
+      initial: chromaInstalled
+    })
+
+    // Step 6: Review
+    console.log(stepIndicator(6, 6, 'Review Configuration'))
+    await transition()
+
+    const answers: SetupAnswers = {
+      vaultPath: finalVaultPath,
+      logLevel: loggingAnswers.logLevel ?? 'warn',
+      enableFileWatch: featureAnswers.enableFileWatch ?? true,
+      enableChromaDB: chromaAnswers.enableChromaDB ?? false,
+      createSampleProject: featureAnswers.createSampleProject ?? true,
+      installClaudeMd: featureAnswers.installClaudeMd ?? true,
+    }
+
+    console.log(summaryPanel('Configuration Summary', [
+      { label: 'Vault Path', value: answers.vaultPath, status: 'success' },
+      { label: 'Log Level', value: answers.logLevel, status: 'info' },
+      { label: 'File Watching', value: answers.enableFileWatch ? 'Enabled' : 'Disabled', status: answers.enableFileWatch ? 'success' : 'warning' },
+      { label: 'ChromaDB', value: answers.enableChromaDB ? 'Enabled' : 'Disabled', status: answers.enableChromaDB ? 'success' : 'warning' },
+      { label: 'Sample Project', value: answers.createSampleProject ? 'Yes' : 'No', status: 'info' },
+      { label: 'Install CLAUDE.md', value: answers.installClaudeMd ? 'Yes' : 'No', status: 'info' },
+    ]))
+    console.log()
+
+    const { confirm } = await prompts({
+      type: 'confirm',
+      name: 'confirm',
+      message: 'Apply this configuration?',
+      initial: true
+    })
+
+    if (!confirm) {
+      console.log('\n' + errorText('Setup cancelled.'))
+      process.exit(0)
+    }
+
+    return answers
+  }
+
+  private async detectVaultLocations(): Promise<string[]> {
+    const locations: string[] = []
+    const home = os.homedir()
+    const homePaths = getHomePaths()
+
+    const commonPaths = [
+      homePaths.vault,
+      path.join(home, 'Documents', 'Obsidian'),
+      path.join(home, 'Obsidian'),
+      path.join(home, 'vault'),
+      path.join(home, 'Documents', 'vault'),
+      path.join(home, 'iCloud', 'Obsidian'),
+      path.join(home, 'Library', 'Mobile Documents', 'iCloud~md~obsidian', 'Documents')
+    ]
+
+    for (const loc of commonPaths) {
+      try {
+        const stat = await fs.stat(loc)
+        if (stat.isDirectory()) {
+          locations.push(loc)
+        }
+      } catch {
+      }
+    }
+
+    return locations
+  }
+
+  private isChromaInstalled(): boolean {
+    try {
+      execSync('chroma --version', { stdio: 'pipe', timeout: 5000 })
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  async applyConfiguration(answers: SetupAnswers): Promise<void> {
+    console.log('\n' + heading('Applying configuration...') + '\n')
+
+    const homePaths = getHomePaths()
+
+    const chromaEnvLines = answers.enableChromaDB
+      ? [
+          '',
+          '# ChromaDB Configuration',
+          'CHROMA_MODE=client-server',
+          'CHROMA_HOST=localhost',
+          'CHROMA_PORT=8000',
+          'CHROMA_EMBEDDING_PROVIDER=transformers',
+        ].join('\n')
+      : ''
+
+    const envContent = `# Claude Brain Configuration
+VAULT_PATH=${answers.vaultPath}
+LOG_LEVEL=${answers.logLevel}
+ENABLE_FILE_WATCH=${answers.enableFileWatch}
+DB_PATH=./data/memory.db
+LOG_FILE_PATH=./logs/claude-brain.log
+SERVER_NAME=claude-brain
+${chromaEnvLines}
+`
+
+    await withSpinner('Writing .env configuration', async () => {
+      await fs.writeFile(homePaths.env, envContent, 'utf-8')
+    })
+
+    await withSpinner('Creating data and log directories', async () => {
+      await fs.mkdir(homePaths.data, { recursive: true })
+      await fs.mkdir(homePaths.chroma, { recursive: true })
+      await fs.mkdir(homePaths.logs, { recursive: true })
+    })
+
+    if (answers.createSampleProject) {
+      await withSpinner('Creating sample project in vault', async () => {
+        await this.createSampleProject(answers.vaultPath)
+      })
+    }
+
+    if (answers.installClaudeMd) {
+      const shouldInstall = await this.confirmClaudeMdInstall()
+      if (shouldInstall) {
+        await withSpinner('Installing CLAUDE.md', async () => {
+          await this.copyClaudeMd()
+        })
+      }
+    }
+
+    const nextSteps: string[] = [
+      heading('Setup complete!'),
+      '',
+      dimText('Next steps:'),
+      `  ${theme.primary('1.')} ${theme.bold('claude-brain install')}`,
+      `     ${dimText('Register as MCP server')}`,
+    ]
+
+    if (answers.enableChromaDB) {
+      nextSteps.push(
+        `  ${theme.primary('2.')} ${theme.bold('claude-brain chroma install')}`,
+        `     ${dimText('Install ChromaDB (if not already installed)')}`,
+        `  ${theme.primary('3.')} ${theme.bold('claude-brain chroma start')}`,
+        `     ${dimText('Start the ChromaDB server')}`,
+        `  ${theme.primary('4.')} ${theme.bold('claude-brain health')}`,
+        `     ${dimText('Verify everything works')}`,
+      )
+    } else {
+      nextSteps.push(
+        `  ${theme.primary('2.')} ${theme.bold('claude-brain health')}`,
+        `     ${dimText('Verify everything works')}`,
+        '',
+        dimText('Optional: Enable ChromaDB later for advanced features:'),
+        `  ${dimText('claude-brain chroma install && claude-brain chroma start')}`,
+      )
+    }
+
+    console.log()
+    console.log(box(nextSteps.join('\n'), 'Done'))
+    console.log()
+  }
+
+  private async confirmClaudeMdInstall(): Promise<boolean> {
+    const sourcePath = path.join(PACKAGE_ROOT, 'assets', 'CLAUDE.md')
+    const destPath = path.join(os.homedir(), '.claude', 'CLAUDE.md')
+
+    if (!existsSync(sourcePath)) {
+      console.log(warningText('CLAUDE.md asset not found, skipping'))
+      return false
+    }
+
+    if (existsSync(destPath)) {
+      const { overwrite } = await prompts({
+        type: 'confirm',
+        name: 'overwrite',
+        message: '~/.claude/CLAUDE.md already exists. Overwrite?',
+        initial: false,
+      })
+      if (!overwrite) {
+        console.log(dimText('  Skipped CLAUDE.md installation'))
+        return false
+      }
+    }
+
+    return true
+  }
+
+  private async copyClaudeMd(): Promise<void> {
+    const sourcePath = path.join(PACKAGE_ROOT, 'assets', 'CLAUDE.md')
+    const claudeDir = path.join(os.homedir(), '.claude')
+    const destPath = path.join(claudeDir, 'CLAUDE.md')
+    await fs.mkdir(claudeDir, { recursive: true })
+    await fs.copyFile(sourcePath, destPath)
+  }
+
+  private async createSampleProject(vaultPath: string): Promise<void> {
+    const projectPath = path.join(vaultPath, 'Projects', 'sample-project')
+
+    await fs.mkdir(projectPath, { recursive: true })
+
+    await fs.writeFile(
+      path.join(projectPath, 'context.md'),
+      `---
+type: project-context
+project: sample-project
+status: active
+created: ${new Date().toISOString().split('T')[0]}
+updated: ${new Date().toISOString().split('T')[0]}
+tech_stack:
+  - TypeScript
+  - Node.js
+tags:
+  - sample
+---
+
+# Sample Project
+
+## Overview
+This is a sample project created by Claude Brain setup wizard.
+
+## Tech Stack
+- TypeScript
+- Node.js
+- Bun
+
+## Goals
+- Test Claude Brain integration
+- Learn the workflow
+`,
+      'utf-8'
+    )
+
+    await fs.writeFile(
+      path.join(projectPath, 'progress.md'),
+      `---
+type: progress-tracker
+project: sample-project
+status: in-progress
+current_phase: setup
+completion_percentage: 0
+---
+
+# Progress
+
+## Next Steps
+- [ ] Configure Claude Brain
+- [ ] Test MCP integration
+- [ ] Try all tools
+`,
+      'utf-8'
+    )
+
+    await fs.writeFile(
+      path.join(projectPath, 'decisions.md'),
+      `---
+type: decision-log
+project: sample-project
+decision_count: 0
+---
+
+# Decision Log
+
+This file will track important decisions for the project.
+`,
+      'utf-8'
+    )
+
+    await fs.writeFile(
+      path.join(projectPath, 'standards.md'),
+      `---
+type: coding-standards
+project: sample-project
+---
+
+# Coding Standards
+
+## TypeScript
+- Use strict mode
+- Prefer const over let
+`,
+      'utf-8'
+    )
+
+    const globalPath = path.join(vaultPath, 'Global')
+    await fs.mkdir(globalPath, { recursive: true })
+
+    const globalStandardsPath = path.join(globalPath, 'standards.md')
+    try {
+      await fs.access(globalStandardsPath)
+    } catch {
+      await fs.writeFile(
+        globalStandardsPath,
+        `---
+type: global-standards
+last_updated: ${new Date().toISOString().split('T')[0]}
+---
+
+# Global Coding Standards
+
+## TypeScript
+- Use strict mode
+- Prefer const over let
+- Add JSDoc comments for public APIs
+`,
+        'utf-8'
+      )
+    }
+  }
+}