claude-brain 0.30.2 → 0.30.3

package/src/cli/auto-start.ts

@@ -1,266 +1,266 @@
-/**
- * Auto-start integration for claude-brain server.
- * Installs/uninstalls a shell profile snippet so the server
- * auto-starts on every new terminal session.
- *
- * Pure Node.js — no Bun-specific APIs.
- */
-
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs'
-import { join, dirname } from 'node:path'
-import { homedir, platform } from 'node:os'
-
-const START_MARKER = '# >>> claude-brain auto-start >>>'
-const END_MARKER = '# <<< claude-brain auto-start <<<'
-
-const PREFIX = '[claude-brain]'
-
-function log(msg: string) {
-  console.error(`${PREFIX} ${msg}`)
-}
-
-export interface AutoStartResult {
-  success: boolean
-  message: string
-  profilePath: string
-}
-
-/**
- * Build the Unix/macOS/Linux shell snippet.
- * Uses `lsof` to check if the port is already in use before starting.
- */
-function buildUnixSnippet(port: number): string {
-  return [
-    START_MARKER,
-    '# Auto-start claude-brain HTTP server if not already running',
-    `(command -v claude-brain >/dev/null 2>&1 && ! lsof -ti :${port} >/dev/null 2>&1) && {`,
-    '  nohup claude-brain serve --http-only >/dev/null 2>&1 &',
-    '  disown 2>/dev/null',
-    '}',
-    END_MARKER,
-  ].join('\n')
-}
-
-/**
- * Build the Fish shell snippet.
- * Fish uses different syntax than bash/zsh.
- */
-function buildFishSnippet(port: number): string {
-  return [
-    START_MARKER,
-    '# Auto-start claude-brain HTTP server if not already running',
-    `if command -v claude-brain >/dev/null 2>&1; and not lsof -ti :${port} >/dev/null 2>&1`,
-    '  nohup claude-brain serve --http-only >/dev/null 2>&1 &',
-    'end',
-    END_MARKER,
-  ].join('\n')
-}
-
-/**
- * Build the PowerShell snippet for Windows.
- */
-function buildPowerShellSnippet(port: number): string {
-  return [
-    START_MARKER,
-    'if (Get-Command claude-brain -ErrorAction SilentlyContinue) {',
-    `  $port = ${port}`,
-    '  $listening = Get-NetTCPConnection -LocalPort $port -ErrorAction SilentlyContinue',
-    '  if (-not $listening) {',
-    '    Start-Process -NoNewWindow -FilePath "claude-brain" -ArgumentList "serve","--http-only" -WindowStyle Hidden',
-    '  }',
-    '}',
-    END_MARKER,
-  ].join('\n')
-}
-
-/**
- * Detect available shell profile files based on platform.
- * Returns paths that exist or are the primary target for the detected shell.
- */
-export function getShellProfiles(): string[] {
-  const home = homedir()
-  const os = platform()
-  const profiles: string[] = []
-
-  if (os === 'win32') {
-    // PowerShell profile
-    const psProfile = process.env.USERPROFILE
-      ? join(
-          process.env.USERPROFILE,
-          'Documents',
-          'PowerShell',
-          'Microsoft.PowerShell_profile.ps1'
-        )
-      : null
-    // Also check WindowsPowerShell variant
-    const psProfileLegacy = process.env.USERPROFILE
-      ? join(
-          process.env.USERPROFILE,
-          'Documents',
-          'WindowsPowerShell',
-          'Microsoft.PowerShell_profile.ps1'
-        )
-      : null
-
-    if (psProfile) profiles.push(psProfile)
-    if (psProfileLegacy && psProfileLegacy !== psProfile) profiles.push(psProfileLegacy)
-    return profiles
-  }
-
-  // Unix/macOS/Linux
-  if (os === 'darwin') {
-    // macOS defaults to zsh
-    profiles.push(join(home, '.zshrc'))
-    profiles.push(join(home, '.zprofile'))
-  } else {
-    // Linux defaults to bash
-    profiles.push(join(home, '.bashrc'))
-    profiles.push(join(home, '.bash_profile'))
-  }
-
-  // Fish (cross-platform Unix)
-  const fishConfig = join(home, '.config', 'fish', 'config.fish')
-  if (existsSync(fishConfig)) {
-    profiles.push(fishConfig)
-  }
-
-  return profiles
-}
-
-/**
- * Check if the auto-start snippet is already in any profile file.
- */
-function profileContainsSnippet(profilePath: string): boolean {
-  if (!existsSync(profilePath)) return false
-  const content = readFileSync(profilePath, 'utf-8')
-  return content.includes(START_MARKER)
-}
-
-/**
- * Get the appropriate snippet for a given profile path.
- */
-function getSnippetForProfile(profilePath: string, port: number): string {
-  if (profilePath.endsWith('.ps1')) {
-    return buildPowerShellSnippet(port)
-  }
-  if (profilePath.includes('fish')) {
-    return buildFishSnippet(port)
-  }
-  return buildUnixSnippet(port)
-}
-
-/**
- * Install auto-start snippet into the primary shell profile.
- * Idempotent — skips if already installed.
- */
-export function installAutoStart(port: number = 3000): AutoStartResult {
-  const profiles = getShellProfiles()
-
-  if (profiles.length === 0) {
-    return {
-      success: false,
-      message: 'No supported shell profile found',
-      profilePath: '',
-    }
-  }
-
-  // Use the first (primary) profile
-  const profilePath = profiles[0]
-
-  // Already installed?
-  if (profileContainsSnippet(profilePath)) {
-    log(`Auto-start already installed in ${profilePath}`)
-    return {
-      success: true,
-      message: 'Auto-start already installed',
-      profilePath,
-    }
-  }
-
-  // Ensure parent directory exists
-  const dir = dirname(profilePath)
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true })
-  }
-
-  // Read existing content or start fresh
-  const existing = existsSync(profilePath) ? readFileSync(profilePath, 'utf-8') : ''
-
-  // Append snippet with a blank line separator
-  const separator = existing.length > 0 && !existing.endsWith('\n') ? '\n\n' : '\n'
-  const snippet = getSnippetForProfile(profilePath, port)
-  writeFileSync(profilePath, existing + separator + snippet + '\n', 'utf-8')
-
-  log(`Auto-start installed in ${profilePath}`)
-  return {
-    success: true,
-    message: `Auto-start installed in ${profilePath}`,
-    profilePath,
-  }
-}
-
-/**
- * Remove auto-start snippet from all known shell profiles.
- * Removes everything between and including the marker comments.
- */
-export function uninstallAutoStart(): AutoStartResult {
-  const profiles = getShellProfiles()
-  let removedFrom = ''
-
-  for (const profilePath of profiles) {
-    if (!existsSync(profilePath)) continue
-
-    const content = readFileSync(profilePath, 'utf-8')
-    if (!content.includes(START_MARKER)) continue
-
-    // Remove the snippet block (markers + everything between)
-    const startIdx = content.indexOf(START_MARKER)
-    const endIdx = content.indexOf(END_MARKER)
-
-    if (startIdx === -1 || endIdx === -1) continue
-
-    const endOfMarker = endIdx + END_MARKER.length
-    // Also remove trailing newline after end marker
-    const endWithNewline =
-      endOfMarker < content.length && content[endOfMarker] === '\n'
-        ? endOfMarker + 1
-        : endOfMarker
-
-    // Remove leading blank line if the snippet was appended with separator
-    let start = startIdx
-    if (start > 0 && content[start - 1] === '\n') {
-      start--
-      if (start > 0 && content[start - 1] === '\n') {
-        start--
-      }
-    }
-
-    const cleaned = content.slice(0, start) + content.slice(endWithNewline)
-    writeFileSync(profilePath, cleaned, 'utf-8')
-    removedFrom = profilePath
-    log(`Auto-start removed from ${profilePath}`)
-  }
-
-  if (!removedFrom) {
-    log('Auto-start was not installed in any profile')
-    return {
-      success: true,
-      message: 'Auto-start was not installed in any profile',
-      profilePath: '',
-    }
-  }
-
-  return {
-    success: true,
-    message: `Auto-start removed from ${removedFrom}`,
-    profilePath: removedFrom,
-  }
-}
-
-/**
- * Check if auto-start is installed in any known shell profile.
- */
-export function isAutoStartInstalled(): boolean {
-  const profiles = getShellProfiles()
-  return profiles.some((p) => profileContainsSnippet(p))
-}
+/**
+ * Auto-start integration for claude-brain server.
+ * Installs/uninstalls a shell profile snippet so the server
+ * auto-starts on every new terminal session.
+ *
+ * Pure Node.js — no Bun-specific APIs.
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { homedir, platform } from 'node:os'
+
+const START_MARKER = '# >>> claude-brain auto-start >>>'
+const END_MARKER = '# <<< claude-brain auto-start <<<'
+
+const PREFIX = '[claude-brain]'
+
+function log(msg: string) {
+  console.error(`${PREFIX} ${msg}`)
+}
+
+export interface AutoStartResult {
+  success: boolean
+  message: string
+  profilePath: string
+}
+
+/**
+ * Build the Unix/macOS/Linux shell snippet.
+ * Uses `lsof` to check if the port is already in use before starting.
+ */
+function buildUnixSnippet(port: number): string {
+  return [
+    START_MARKER,
+    '# Auto-start claude-brain HTTP server if not already running',
+    `(command -v claude-brain >/dev/null 2>&1 && ! lsof -ti :${port} >/dev/null 2>&1) && {`,
+    '  nohup claude-brain serve --http-only >/dev/null 2>&1 &',
+    '  disown 2>/dev/null',
+    '}',
+    END_MARKER,
+  ].join('\n')
+}
+
+/**
+ * Build the Fish shell snippet.
+ * Fish uses different syntax than bash/zsh.
+ */
+function buildFishSnippet(port: number): string {
+  return [
+    START_MARKER,
+    '# Auto-start claude-brain HTTP server if not already running',
+    `if command -v claude-brain >/dev/null 2>&1; and not lsof -ti :${port} >/dev/null 2>&1`,
+    '  nohup claude-brain serve --http-only >/dev/null 2>&1 &',
+    'end',
+    END_MARKER,
+  ].join('\n')
+}
+
+/**
+ * Build the PowerShell snippet for Windows.
+ */
+function buildPowerShellSnippet(port: number): string {
+  return [
+    START_MARKER,
+    'if (Get-Command claude-brain -ErrorAction SilentlyContinue) {',
+    `  $port = ${port}`,
+    '  $listening = Get-NetTCPConnection -LocalPort $port -ErrorAction SilentlyContinue',
+    '  if (-not $listening) {',
+    '    Start-Process -NoNewWindow -FilePath "claude-brain" -ArgumentList "serve","--http-only" -WindowStyle Hidden',
+    '  }',
+    '}',
+    END_MARKER,
+  ].join('\n')
+}
+
+/**
+ * Detect available shell profile files based on platform.
+ * Returns paths that exist or are the primary target for the detected shell.
+ */
+export function getShellProfiles(): string[] {
+  const home = homedir()
+  const os = platform()
+  const profiles: string[] = []
+
+  if (os === 'win32') {
+    // PowerShell profile
+    const psProfile = process.env.USERPROFILE
+      ? join(
+          process.env.USERPROFILE,
+          'Documents',
+          'PowerShell',
+          'Microsoft.PowerShell_profile.ps1'
+        )
+      : null
+    // Also check WindowsPowerShell variant
+    const psProfileLegacy = process.env.USERPROFILE
+      ? join(
+          process.env.USERPROFILE,
+          'Documents',
+          'WindowsPowerShell',
+          'Microsoft.PowerShell_profile.ps1'
+        )
+      : null
+
+    if (psProfile) profiles.push(psProfile)
+    if (psProfileLegacy && psProfileLegacy !== psProfile) profiles.push(psProfileLegacy)
+    return profiles
+  }
+
+  // Unix/macOS/Linux
+  if (os === 'darwin') {
+    // macOS defaults to zsh
+    profiles.push(join(home, '.zshrc'))
+    profiles.push(join(home, '.zprofile'))
+  } else {
+    // Linux defaults to bash
+    profiles.push(join(home, '.bashrc'))
+    profiles.push(join(home, '.bash_profile'))
+  }
+
+  // Fish (cross-platform Unix)
+  const fishConfig = join(home, '.config', 'fish', 'config.fish')
+  if (existsSync(fishConfig)) {
+    profiles.push(fishConfig)
+  }
+
+  return profiles
+}
+
+/**
+ * Check if the auto-start snippet is already in any profile file.
+ */
+function profileContainsSnippet(profilePath: string): boolean {
+  if (!existsSync(profilePath)) return false
+  const content = readFileSync(profilePath, 'utf-8')
+  return content.includes(START_MARKER)
+}
+
+/**
+ * Get the appropriate snippet for a given profile path.
+ */
+function getSnippetForProfile(profilePath: string, port: number): string {
+  if (profilePath.endsWith('.ps1')) {
+    return buildPowerShellSnippet(port)
+  }
+  if (profilePath.includes('fish')) {
+    return buildFishSnippet(port)
+  }
+  return buildUnixSnippet(port)
+}
+
+/**
+ * Install auto-start snippet into the primary shell profile.
+ * Idempotent — skips if already installed.
+ */
+export function installAutoStart(port: number = 3000): AutoStartResult {
+  const profiles = getShellProfiles()
+
+  if (profiles.length === 0) {
+    return {
+      success: false,
+      message: 'No supported shell profile found',
+      profilePath: '',
+    }
+  }
+
+  // Use the first (primary) profile
+  const profilePath = profiles[0]
+
+  // Already installed?
+  if (profileContainsSnippet(profilePath)) {
+    log(`Auto-start already installed in ${profilePath}`)
+    return {
+      success: true,
+      message: 'Auto-start already installed',
+      profilePath,
+    }
+  }
+
+  // Ensure parent directory exists
+  const dir = dirname(profilePath)
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true })
+  }
+
+  // Read existing content or start fresh
+  const existing = existsSync(profilePath) ? readFileSync(profilePath, 'utf-8') : ''
+
+  // Append snippet with a blank line separator
+  const separator = existing.length > 0 && !existing.endsWith('\n') ? '\n\n' : '\n'
+  const snippet = getSnippetForProfile(profilePath, port)
+  writeFileSync(profilePath, existing + separator + snippet + '\n', 'utf-8')
+
+  log(`Auto-start installed in ${profilePath}`)
+  return {
+    success: true,
+    message: `Auto-start installed in ${profilePath}`,
+    profilePath,
+  }
+}
+
+/**
+ * Remove auto-start snippet from all known shell profiles.
+ * Removes everything between and including the marker comments.
+ */
+export function uninstallAutoStart(): AutoStartResult {
+  const profiles = getShellProfiles()
+  let removedFrom = ''
+
+  for (const profilePath of profiles) {
+    if (!existsSync(profilePath)) continue
+
+    const content = readFileSync(profilePath, 'utf-8')
+    if (!content.includes(START_MARKER)) continue
+
+    // Remove the snippet block (markers + everything between)
+    const startIdx = content.indexOf(START_MARKER)
+    const endIdx = content.indexOf(END_MARKER)
+
+    if (startIdx === -1 || endIdx === -1) continue
+
+    const endOfMarker = endIdx + END_MARKER.length
+    // Also remove trailing newline after end marker
+    const endWithNewline =
+      endOfMarker < content.length && content[endOfMarker] === '\n'
+        ? endOfMarker + 1
+        : endOfMarker
+
+    // Remove leading blank line if the snippet was appended with separator
+    let start = startIdx
+    if (start > 0 && content[start - 1] === '\n') {
+      start--
+      if (start > 0 && content[start - 1] === '\n') {
+        start--
+      }
+    }
+
+    const cleaned = content.slice(0, start) + content.slice(endWithNewline)
+    writeFileSync(profilePath, cleaned, 'utf-8')
+    removedFrom = profilePath
+    log(`Auto-start removed from ${profilePath}`)
+  }
+
+  if (!removedFrom) {
+    log('Auto-start was not installed in any profile')
+    return {
+      success: true,
+      message: 'Auto-start was not installed in any profile',
+      profilePath: '',
+    }
+  }
+
+  return {
+    success: true,
+    message: `Auto-start removed from ${removedFrom}`,
+    profilePath: removedFrom,
+  }
+}
+
+/**
+ * Check if auto-start is installed in any known shell profile.
+ */
+export function isAutoStartInstalled(): boolean {
+  const profiles = getShellProfiles()
+  return profiles.some((p) => profileContainsSnippet(p))
+}