Function manualRemoveNpmPackage

src/utils/nativeInstaller/installer.ts:1514–1624

(
  packageName: string,
)

}

async function manualRemoveNpmPackage(
  packageName: string,
): Promise<{ success: boolean; error?: string; warning?: string }> {
  try {
    // Get npm global prefix
    const prefixResult = await execFileNoThrowWithCwd('npm', [
      'config',
      'get',
      'prefix',
    ])
    if (prefixResult.code !== 0 || !prefixResult.stdout) {
      return {
        success: false,
        error: 'Failed to get npm global prefix',
      }
    }

    const globalPrefix = prefixResult.stdout.trim()
    let manuallyRemoved = false

    // Helper to try removing a file. unlink alone is sufficient — it throws
    // ENOENT if the file is missing, which the catch handles identically.
    // A stat() pre-check would add a syscall and a TOCTOU window where
    // concurrent cleanup causes a false-negative return.
    async function tryRemove(filePath: string, description: string) {
      try {
        await unlink(filePath)
        logForDebugging(`Manually removed ${description}: ${filePath}`)
        return true
      } catch {
        return false
      }
    }

    if (getPlatform().startsWith('win32')) {
      // Windows - only remove executables, not the package directory.
      // Remove current product binaries first, then legacy ones for migration.
      const binaryName = getBinaryName(getPlatform())
      const ncodeBaseName = binaryName.replace(/\.exe$/, '')
      const binCmd = join(globalPrefix, `${ncodeBaseName}.cmd`)
      const binPs1 = join(globalPrefix, `${ncodeBaseName}.ps1`)
      const binExe = join(globalPrefix, ncodeBaseName)

      if (await tryRemove(binCmd, 'bin script')) {
        manuallyRemoved = true
      }

      if (await tryRemove(binPs1, 'PowerShell script')) {
        manuallyRemoved = true
      }

      if (await tryRemove(binExe, 'bin executable')) {
        manuallyRemoved = true
      }

      // Legacy cleanup: old product binary names from pre-launch internal builds.
      const legacyBinCmd = join(globalPrefix, 'claude.cmd')
      const legacyBinPs1 = join(globalPrefix, 'claude.ps1')