browser4-cli 0.1.32 → 4.12.0-rc.2

package/README.md

@@ -79,7 +79,7 @@ browser4-cli htmlsnapshot get text "#main-content"
 browser4-cli htmlsnapshot query --sql @query.sql
 browser4-cli htmlsnapshot grep -i "error"
 
-# AI-powered extraction and summarization (requires LLM key — see LLM Configuration above)
+# AI-powered extraction and summarization (requires LLM key — see LLM Configuration below)
 browser4-cli extract "product name, price, and rating as JSON"
 browser4-cli summarize "key points in 3 bullets"
 
@@ -234,11 +234,12 @@ All modes accept `--timeout <ms>` (default: 30000). Load states: `networkidle`,
 
 | Command | Description |
 |---|---|
-| `screenshot [ref]` | Take a screenshot. `--filename <path>`, `--full-page`. Optionally of a specific element. |
+| `screenshot [ref]` | Take a screenshot. `--filename <path>`, `--full-page`, `--viewport <n>`. Optionally of a specific element. |
 | `pdf` | Save page as PDF. `--filename <path>`. |
 
 ```bash
 browser4-cli screenshot --full-page --filename page.png
+browser4-cli screenshot --viewport 0 --filename top.png
 browser4-cli pdf --filename page.pdf
 ```
 
@@ -370,6 +371,30 @@ browser4-cli uninstall --dry-run
 browser4-cli uninstall -y
 ```
 
+### Skills
+
+Manage bundled skill files embedded in the browser4-cli binary. Skill files are AI agent
+instructions that always match the installed CLI version.
+
+| Command | Description |
+|---|---|
+| `skills` | List all bundled skill names. Same as `skills list`. |
+| `skills list` | List available bundled skills with file counts. |
+| `skills get <name>` | Output a skill's SKILL.md content. `--full` includes references and templates. `--all` outputs every skill. |
+| `skills path [name]` | Print the skills directory path. With a name, prints the path to that skill's subdirectory. |
+
+Skill files are unpacked to the versioned installation directory during `browser4-cli install`.
+Set `BROWSER4_SKILLS_DIR` to override the skills directory path.
+
+```bash
+browser4-cli skills                        # List bundled skills
+browser4-cli skills get browser4-cli       # Get the CLI skill's main content
+browser4-cli skills get browser4-cli --full # Include references and templates
+browser4-cli skills get --all              # Output every skill
+browser4-cli skills path                   # Print skills root directory
+browser4-cli skills path browser4-cli      # Print path to a specific skill
+```
+
 ### Other
 
 | Command | Description |
@@ -600,6 +625,29 @@ browser4-cli htmlsnapshot inspect ".s-result-item" --depth 6 --max 20
 
 ---
 
+### LLM Configuration
+
+AI-powered commands (`agent`, `extract`, `summarize`) and X-SQL `llm_*` functions
+require an LLM API key. Configure one provider via environment variables:
+
+| Provider | Environment Variables |
+|---|---|
+| DeepSeek | `DEEPSEEK_API_KEY` |
+| OpenRouter | `OPENROUTER_API_KEY`, `OPENROUTER_MODEL_NAME`, `OPENROUTER_BASE_URL` |
+| Volcengine (ByteDance) | `VOLCENGINE_API_KEY`, `VOLCENGINE_MODEL_NAME`, `VOLCENGINE_BASE_URL` |
+| OpenAI-compatible | `OPENAI_API_KEY`, `OPENAI_MODEL_NAME`, `OPENAI_BASE_URL` |
+| Aliyun Qwen (DashScope) | `OPENAI_API_KEY`, `OPENAI_MODEL_NAME`, `OPENAI_BASE_URL` |
+
+Example:
+
+```bash
+export DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
+```
+
+If no valid LLM key is configured, AI commands fail fast with a clear error at startup.
+
+---
+
 ### Agent
 
 The `agent` subcommands submit natural-language tasks that the Browser4 backend

package/package.json

@@ -1,17 +1,16 @@
 {
   "name": "browser4-cli",
-  "version": "0.1.32",
+  "version": "4.12.0-rc.2",
   "description": "Browser automation CLI for AI agents",
   "type": "module",
   "files": [
     "bin",
     "scripts",
-    "skill-data",
     "skills"
   ],
   "bin": {
-    "browser4-cli": "./bin/browser4-cli.js",
-    "browser4": "./bin/browser4-cli.js"
+    "browser4-cli": "bin/browser4-cli.js",
+    "browser4": "bin/browser4-cli.js"
   },
   "scripts": {
     "version:sync": "node ../bin/version.mjs cli sync",

package/scripts/install-browser4-cli.ps1

@@ -48,6 +48,10 @@
   By default the script looks for the platform binary in its own directory
   before downloading -- use this to force a fresh download.
 
+.PARAMETER Force
+  Force reinstallation even if the binary is already installed at the target path.
+  Overrides -SkipIfInstalled and bypasses locked-file workarounds.
+
 .PARAMETER Locate
   Print detection results (OS, architecture, script location, China locale)
   and exit without installing. Useful for diagnostics.
@@ -89,16 +93,17 @@
 
 [CmdletBinding()]
 param(
-  [string]$Version = "",
-  [string]$InstallDir = "",
-  [ValidateSet("", "github", "oss")]
-  [string]$Source = "",
-  [bool]$AddToPath = $true,
-  [switch]$Silent,
-  [switch]$DryRun,
-  [switch]$SkipIfInstalled,
-  [switch]$SkipLocal,
-  [switch]$Locate
+    [string]$Version = "",
+    [string]$InstallDir = "",
+    [ValidateSet("", "github", "oss")]
+    [string]$Source = "",
+    [bool]$AddToPath = $true,
+    [switch]$Silent,
+    [switch]$DryRun,
+    [switch]$SkipIfInstalled,
+    [switch]$SkipLocal,
+    [switch]$Force,
+    [switch]$Locate
 )
 
 $ErrorActionPreference = "Stop"
@@ -110,11 +115,11 @@ $ErrorActionPreference = "Stop"
 # $PSScriptRoot is the directory containing this script (PS 3+).
 # Falls back to $MyInvocation for edge cases (dot-sourced, PS 2).
 $ScriptDir = if ($PSScriptRoot) {
-  $PSScriptRoot
+    $PSScriptRoot
 } elseif ($MyInvocation -and $MyInvocation.MyCommand.Path) {
-  Split-Path -Parent $MyInvocation.MyCommand.Path
+    Split-Path -Parent $MyInvocation.MyCommand.Path
 } else {
-  $null
+    $null
 }
 
 <#
@@ -123,18 +128,18 @@ $ScriptDir = if ($PSScriptRoot) {
   Returns the full path if found, $null otherwise.
 #>
 function Find-LocalBinary {
-  param([string]$BinaryName)
+    param([string]$BinaryName)
 
-  if (-not $ScriptDir) { return $null }
+    if (-not $ScriptDir) { return $null }
 
-  $localPath = Join-Path $ScriptDir $BinaryName
-  if (Test-Path $localPath -PathType Leaf) {
-    $size = (Get-Item $localPath).Length
-    if ($size -gt 102400) {  # > 100 KB minimum
-      return $localPath
+    $localPath = Join-Path $ScriptDir $BinaryName
+    if (Test-Path $localPath -PathType Leaf) {
+        $size = (Get-Item $localPath).Length
+        if ($size -gt 102400) {  # > 100 KB minimum
+            return $localPath
+        }
     }
-  }
-  return $null
+    return $null
 }
 
 <#
@@ -143,16 +148,16 @@ function Find-LocalBinary {
   Returns $true if --version executes successfully, $false otherwise.
 #>
 function Test-LocalBinary {
-  param([string]$Path)
+    param([string]$Path)
 
-  if (-not $Path -or -not (Test-Path $Path)) { return $false }
+    if (-not $Path -or -not (Test-Path $Path)) { return $false }
 
-  try {
-    $null = & $Path --version 2>&1
-    return ($LASTEXITCODE -eq 0)
-  } catch {
-    return $false
-  }
+    try {
+        $null = & $Path --version 2>&1
+        return ($LASTEXITCODE -eq 0)
+    } catch {
+        return $false
+    }
 }
 
 # ----------------------------------------------
@@ -176,23 +181,23 @@ if ($PSVersionTable.PSVersion.Major -ge 6) {
 # ----------------------------------------------
 
 function Write-Summary {
-  param([string]$Message, [string]$Color = "White")
-  if (-not $Silent) { Write-Host $Message -ForegroundColor $Color }
+    param([string]$Message, [string]$Color = "White")
+    if (-not $Silent) { Write-Host $Message -ForegroundColor $Color }
 }
 
 function Write-Step {
-  param([string]$Message)
-  if (-not $Silent) { Write-Host "  >> $Message" -ForegroundColor Gray }
+    param([string]$Message)
+    if (-not $Silent) { Write-Host "  >> $Message" -ForegroundColor Gray }
 }
 
 function Write-Check {
-  param([string]$Message)
-  if (-not $Silent) { Write-Host "    [v] $Message" -ForegroundColor Green }
+    param([string]$Message)
+    if (-not $Silent) { Write-Host "    [v] $Message" -ForegroundColor Green }
 }
 
 function Write-WarnMsg {
-  param([string]$Message)
-  if (-not $Silent) { Write-Host "    [!] $Message" -ForegroundColor Yellow }
+    param([string]$Message)
+    if (-not $Silent) { Write-Host "    [!] $Message" -ForegroundColor Yellow }
 }
 
 # ----------------------------------------------
@@ -200,50 +205,50 @@ function Write-WarnMsg {
 # ----------------------------------------------
 
 function Get-PlatformKey {
-  $arch = if ([System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture -eq [System.Runtime.InteropServices.Architecture]::Arm64) { "arm64" } else { "x64" }
+    $arch = if ([System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture -eq [System.Runtime.InteropServices.Architecture]::Arm64) { "arm64" } else { "x64" }
 
-  if ($script:OSWin) {
-    return "win32-$arch"
-  }
-  elseif ($script:OSMac) {
-    return "darwin-$arch"
-  }
-  elseif ($script:OSLinux) {
-    # Detect musl
-    $isMusl = $false
-    try {
-      $lddOutput = ldd --version 2>&1
-      if ($lddOutput -match "musl") { $isMusl = $true }
-    } catch {
-      if ((Test-Path "/lib/ld-musl-x86_64.so.1") -or (Test-Path "/lib/ld-musl-aarch64.so.1")) {
-        $isMusl = $true
-      }
+    if ($script:OSWin) {
+        return "win32-$arch"
+    }
+    elseif ($script:OSMac) {
+        return "darwin-$arch"
+    }
+    elseif ($script:OSLinux) {
+        # Detect musl
+        $isMusl = $false
+        try {
+            $lddOutput = ldd --version 2>&1
+            if ($lddOutput -match "musl") { $isMusl = $true }
+        } catch {
+            if ((Test-Path "/lib/ld-musl-x86_64.so.1") -or (Test-Path "/lib/ld-musl-aarch64.so.1")) {
+                $isMusl = $true
+            }
+        }
+        $libc = if ($isMusl) { "musl" } else { "" }
+        if ($libc) { return "linux-$libc-$arch" } else { return "linux-$arch" }
+    }
+    else {
+        throw "Unsupported OS. Browser4 CLI supports Windows, macOS, and Linux."
     }
-    $libc = if ($isMusl) { "musl" } else { "" }
-    if ($libc) { return "linux-$libc-$arch" } else { return "linux-$arch" }
-  }
-  else {
-    throw "Unsupported OS. Browser4 CLI supports Windows, macOS, and Linux."
-  }
 }
 
 function Get-BinaryName {
-  param([string]$PlatformKey)
-  return "browser4-cli-$PlatformKey" + $(if ($PlatformKey.StartsWith("win32")) { ".exe" } else { "" })
+    param([string]$PlatformKey)
+    return "browser4-cli-$PlatformKey" + $(if ($PlatformKey.StartsWith("win32")) { ".exe" } else { "" })
 }
 
 function Get-DefaultInstallDir {
-  if ($script:OSWin) {
-    return Join-Path $env:LOCALAPPDATA "Programs\browser4-cli"
-  }
-  elseif ($script:OSLinux -or $script:OSMac) {
-    # Prefer ~/.local/bin for user installs
-    if (Test-Path "$env:HOME/.local/bin") {
-      return "$env:HOME/.local/bin"
+    if ($script:OSWin) {
+        return Join-Path $env:LOCALAPPDATA "Programs\browser4-cli"
     }
-    return "$env:HOME/.local/bin"
-  }
-  throw "Unsupported OS"
+    elseif ($script:OSLinux -or $script:OSMac) {
+        # Prefer ~/.local/bin for user installs
+        if (Test-Path "$env:HOME/.local/bin") {
+            return "$env:HOME/.local/bin"
+        }
+        return "$env:HOME/.local/bin"
+    }
+    throw "Unsupported OS"
 }
 
 # ----------------------------------------------
@@ -256,41 +261,41 @@ function Get-DefaultInstallDir {
   Uses only local env vars and .NET APIs -- no network calls.
 #>
 function Test-ChinaLocale {
-  # 1 -- Locale env vars
-  $lang = $env:LC_ALL, $env:LANG, $env:LC_CTYPE, $env:LC_MESSAGES | Where-Object { $_ } | Select-Object -First 1
-  if ($lang -and ($lang -match '^zh_CN' -or $lang -match '^zh-CN' -or $lang -match '^Chinese \(Simplified\)_China')) {
-    return $true
-  }
-
-  # 2 -- TZ env var
-  $tzEnv = $env:TZ
-  if ($tzEnv -and ($tzEnv -match '^Asia/(Shanghai|Chongqing|Urumqi|Harbin)$')) {
-    return $true
-  }
+    # 1 -- Locale env vars
+    $lang = $env:LC_ALL, $env:LANG, $env:LC_CTYPE, $env:LC_MESSAGES | Where-Object { $_ } | Select-Object -First 1
+    if ($lang -and ($lang -match '^zh_CN' -or $lang -match '^zh-CN' -or $lang -match '^Chinese \(Simplified\)_China')) {
+        return $true
+    }
 
-  # 3 -- .NET TimeZoneInfo (works on Windows and Unix PowerShell 7+)
-  try {
-    $tzId = [System.TimeZoneInfo]::Local.Id
-    if ($tzId -match '^Asia/(Shanghai|Chongqing|Urumqi|Harbin)$') {
-      return $true
+    # 2 -- TZ env var
+    $tzEnv = $env:TZ
+    if ($tzEnv -and ($tzEnv -match '^Asia/(Shanghai|Chongqing|Urumqi|Harbin)$')) {
+        return $true
     }
-  } catch {
-    # TimeZoneInfo not available (unlikely on PS 5.1+ but guard anyway)
-  }
 
-  # 4 -- /etc/timezone (PowerShell on Linux/macOS)
-  if (-not $script:OSWin -and (Test-Path '/etc/timezone')) {
+    # 3 -- .NET TimeZoneInfo (works on Windows and Unix PowerShell 7+)
     try {
-      $tz = Get-Content '/etc/timezone' -Raw -ErrorAction Stop
-      if ($tz -match '^Asia/(Shanghai|Chongqing|Urumqi|Harbin)$') {
-        return $true
-      }
+        $tzId = [System.TimeZoneInfo]::Local.Id
+        if ($tzId -match '^Asia/(Shanghai|Chongqing|Urumqi|Harbin)$') {
+            return $true
+        }
     } catch {
-      # Permission or read error -- skip
+        # TimeZoneInfo not available (unlikely on PS 5.1+ but guard anyway)
     }
-  }
 
-  return $false
+    # 4 -- /etc/timezone (PowerShell on Linux/macOS)
+    if (-not $script:OSWin -and (Test-Path '/etc/timezone')) {
+        try {
+            $tz = Get-Content '/etc/timezone' -Raw -ErrorAction Stop
+            if ($tz -match '^Asia/(Shanghai|Chongqing|Urumqi|Harbin)$') {
+                return $true
+            }
+        } catch {
+            # Permission or read error -- skip
+        }
+    }
+
+    return $false
 }
 
 # ----------------------------------------------
@@ -302,71 +307,71 @@ $OSS_BASE = "https://browser4.oss-cn-beijing.aliyuncs.com"
 $script:ChinaDetected = $false
 
 function Get-DownloadUrls {
-  param([string]$BinaryName, [string]$VersionTag)
+    param([string]$BinaryName, [string]$VersionTag)
 
-  $urls = @()
+    $urls = @()
 
-  $ghBase = "https://github.com/$GITHUB_REPO/releases/download"
-  if ($VersionTag) {
-    $ghUrl = "$ghBase/$VersionTag/$BinaryName"
-    $ossUrl = "$OSS_BASE/releases/download/$VersionTag/$BinaryName"
-  } else {
-    # Use 'latest' redirect for GitHub, 'latest' symlink for OSS
-    $ghUrl = "https://github.com/$GITHUB_REPO/releases/latest/download/$BinaryName"
-    $ossUrl = "$OSS_BASE/releases/download/latest/$BinaryName"
-  }
+    $ghBase = "https://github.com/$GITHUB_REPO/releases/download"
+    if ($VersionTag) {
+        $ghUrl = "$ghBase/$VersionTag/$BinaryName"
+        $ossUrl = "$OSS_BASE/releases/download/$VersionTag/$BinaryName"
+    } else {
+        # Use 'latest' redirect for GitHub, 'latest' symlink for OSS
+        $ghUrl = "https://github.com/$GITHUB_REPO/releases/latest/download/$BinaryName"
+        $ossUrl = "$OSS_BASE/releases/download/latest/$BinaryName"
+    }
 
-  if ($Source -eq "github") {
-    $urls += @{ Url = $ghUrl; Label = "GitHub Releases" }
-  } elseif ($Source -eq "oss") {
-    $urls += @{ Url = $ossUrl; Label = "Aliyun OSS" }
-  } else {
-    if ($script:ChinaDetected) {
-      $urls += @{ Url = $ossUrl; Label = "Aliyun OSS" }
-      $urls += @{ Url = $ghUrl; Label = "GitHub Releases" }
+    if ($Source -eq "github") {
+        $urls += @{ Url = $ghUrl; Label = "GitHub Releases" }
+    } elseif ($Source -eq "oss") {
+        $urls += @{ Url = $ossUrl; Label = "Aliyun OSS" }
     } else {
-      $urls += @{ Url = $ghUrl; Label = "GitHub Releases" }
-      $urls += @{ Url = $ossUrl; Label = "Aliyun OSS" }
+        if ($script:ChinaDetected) {
+            $urls += @{ Url = $ossUrl; Label = "Aliyun OSS" }
+            $urls += @{ Url = $ghUrl; Label = "GitHub Releases" }
+        } else {
+            $urls += @{ Url = $ghUrl; Label = "GitHub Releases" }
+            $urls += @{ Url = $ossUrl; Label = "Aliyun OSS" }
+        }
     }
-  }
 
-  return $urls
+    return $urls
 }
 
 function Invoke-Download {
-  param([string]$Url, [string]$OutFile, [string]$Label)
-
-  Write-Step "Trying $Label..."
-  Write-Step "URL: $Url"
-
-  if ($DryRun) {
-    Write-Check "[DRY-RUN] Would download to: $OutFile"
-    return $true
-  }
-
-  try {
-    $ProgressPreference = if ($Silent) { "SilentlyContinue" } else { "Continue" }
+    param([string]$Url, [string]$OutFile, [string]$Label)
 
-    # Use Invoke-WebRequest with progress bar
-    Invoke-WebRequest -Uri $Url -OutFile $OutFile -UseBasicParsing -ErrorAction Stop
+    Write-Step "Trying $Label..."
+    Write-Step "URL: $Url"
 
-    if (Test-Path $OutFile) {
-      $size = (Get-Item $OutFile).Length
-      if ($size -gt 102400) {  # > 100 KB minimum
-        Write-Check "Downloaded $( [math]::Round($size / 1MB, 1) ) MB"
+    if ($DryRun) {
+        Write-Check "[DRY-RUN] Would download to: $OutFile"
         return $true
-      } else {
-        Write-WarnMsg "Downloaded file too small ($size bytes) -- may be an error page"
-        Remove-Item $OutFile -Force -ErrorAction SilentlyContinue
+    }
+
+    try {
+        $ProgressPreference = if ($Silent) { "SilentlyContinue" } else { "Continue" }
+
+        # Use Invoke-WebRequest with progress bar
+        Invoke-WebRequest -Uri $Url -OutFile $OutFile -UseBasicParsing -ErrorAction Stop
+
+        if (Test-Path $OutFile) {
+            $size = (Get-Item $OutFile).Length
+            if ($size -gt 102400) {  # > 100 KB minimum
+                Write-Check "Downloaded $( [math]::Round($size / 1MB, 1) ) MB"
+                return $true
+            } else {
+                Write-WarnMsg "Downloaded file too small ($size bytes) -- may be an error page"
+                Remove-Item $OutFile -Force -ErrorAction SilentlyContinue
+                return $false
+            }
+        }
+        Write-WarnMsg "Download appeared to succeed but file not found"
+        return $false
+    } catch {
+        Write-WarnMsg "Failed: $($_.Exception.Message)"
         return $false
-      }
     }
-    Write-WarnMsg "Download appeared to succeed but file not found"
-    return $false
-  } catch {
-    Write-WarnMsg "Failed: $($_.Exception.Message)"
-    return $false
-  }
 }
 
 # ----------------------------------------------
@@ -374,129 +379,96 @@ function Invoke-Download {
 # ----------------------------------------------
 
 function New-PlatformLink {
-  param([string]$LinkPath, [string]$TargetName, [string]$DisplayName)
-
-  # Try symbolic link first (works on Unix; on Windows needs Admin or Developer Mode)
-  try {
-    New-Item -ItemType SymbolicLink -Path $LinkPath -Target $TargetName -Force -ErrorAction Stop | Out-Null
-    Write-Check "Created symlink: $DisplayName -> $TargetName"
-    return $true
-  } catch {
-    # Symbolic link failed -- try hard link on Windows
-  }
+    param([string]$LinkPath, [string]$TargetName, [string]$DisplayName)
 
-  # Try hard link (Windows, same volume)
-  if ($script:OSWin) {
+    # Try symbolic link first (works on Unix; on Windows needs Admin or Developer Mode)
     try {
-      $targetPath = Join-Path (Split-Path $LinkPath -Parent) $TargetName
-      New-Item -ItemType HardLink -Path $LinkPath -Target $targetPath -Force -ErrorAction Stop | Out-Null
-      Write-Check "Created hard link: $DisplayName -> $TargetName"
-      return $true
+        New-Item -ItemType SymbolicLink -Path $LinkPath -Target $TargetName -Force -ErrorAction Stop | Out-Null
+        Write-Check "Created symlink: $DisplayName -> $TargetName"
+        return $true
     } catch {
-      # Hard link also failed -- create a .cmd wrapper as last resort
+        # Symbolic link failed -- try hard link on Windows
     }
 
-    # Last resort: .cmd wrapper that forwards all arguments
-    try {
-      $wrapperContent = '@"%~dp0' + $TargetName + '" %*'
-      Set-Content -Path ($LinkPath -replace '\.exe$', '.cmd') -Value $wrapperContent -Force -ErrorAction Stop
-      Write-Check "Created wrapper: " + (Split-Path ($LinkPath -replace '\.exe$', '.cmd') -Leaf) + " -> $TargetName"
-      return $true
-    } catch {
-      Write-WarnMsg "Could not create link for $DisplayName (may need admin privileges)"
-      return $false
+    # Try hard link (Windows, same volume)
+    if ($script:OSWin) {
+        try {
+            $targetPath = Join-Path (Split-Path $LinkPath -Parent) $TargetName
+            New-Item -ItemType HardLink -Path $LinkPath -Target $targetPath -Force -ErrorAction Stop | Out-Null
+            Write-Check "Created hard link: $DisplayName -> $TargetName"
+            return $true
+        } catch {
+            # Hard link also failed -- create a .cmd wrapper as last resort
+        }
+
+        # Last resort: .cmd wrapper that forwards all arguments
+        try {
+            $wrapperContent = '@"%~dp0' + $TargetName + '" %*'
+            Set-Content -Path ($LinkPath -replace '\.exe$', '.cmd') -Value $wrapperContent -Force -ErrorAction Stop
+            Write-Check "Created wrapper: " + (Split-Path ($LinkPath -replace '\.exe$', '.cmd') -Leaf) + " -> $TargetName"
+            return $true
+        } catch {
+            Write-WarnMsg "Could not create link for $DisplayName (may need admin privileges)"
+            return $false
+        }
     }
-  }
 
-  Write-WarnMsg "Could not create link for $DisplayName"
-  return $false
+    Write-WarnMsg "Could not create link for $DisplayName"
+    return $false
 }
 
 function New-Symlinks {
-  param([string]$BinaryName, [string]$InstallDir, [string]$PlatformKey)
-
-  $ext = if ($PlatformKey.StartsWith("win32")) { ".exe" } else { "" }
+    param([string]$BinaryName, [string]$InstallDir, [string]$PlatformKey)
 
-  # 1) Always: browser4-cli -> browser4-cli-<platform>
-  $linkName = "browser4-cli$ext"
-  $linkPath = Join-Path $InstallDir $linkName
+    $ext = if ($PlatformKey.StartsWith("win32")) { ".exe" } else { "" }
 
-  if ($DryRun) {
-    Write-Step "[DRY-RUN] Would create link: $linkName -> $BinaryName"
-  } else {
-    New-PlatformLink -LinkPath $linkPath -TargetName $BinaryName -DisplayName $linkName
-  }
+    # 1) Always: browser4-cli -> browser4-cli-<platform>
+    $linkName = "browser4-cli$ext"
+    $linkPath = Join-Path $InstallDir $linkName
 
-  # 2) Only if no conflict: b4 -> browser4-cli-<platform>
-  $shortName = "b4$ext"
-  $shortPath = Join-Path $InstallDir $shortName
-
-  # Check if b4 is already on PATH (conflict with another tool)
-  $existingCmd = Get-Command b4 -ErrorAction SilentlyContinue
-  if ($existingCmd) {
-    Write-WarnMsg "Skipping short link '$shortName': 'b4' already found on PATH ($($existingCmd.Source))"
-    return
-  }
-
-  # Check if b4 already exists in the install directory
-  if (Test-Path $shortPath) {
-    Write-WarnMsg "Skipping short link '$shortName': already exists in $InstallDir"
-    return
-  }
-
-  # Also check b4.cmd if on Windows (wrapper fallback)
-  if ($script:OSWin) {
-    $shortCmdPath = Join-Path $InstallDir "b4.cmd"
-    if (Test-Path $shortCmdPath) {
-      Write-WarnMsg "Skipping short link '$shortName': 'b4.cmd' already exists in $InstallDir"
-      return
+    if ($DryRun) {
+        Write-Step "[DRY-RUN] Would create link: $linkName -> $BinaryName"
+    } else {
+        New-PlatformLink -LinkPath $linkPath -TargetName $BinaryName -DisplayName $linkName
     }
-  }
-
-  if ($DryRun) {
-    Write-Step "[DRY-RUN] Would create link: $shortName -> $BinaryName"
-  } else {
-    New-PlatformLink -LinkPath $shortPath -TargetName $BinaryName -DisplayName $shortName
-  }
-}
-
-# ----------------------------------------------
-# PATH management
-# ----------------------------------------------
-
-function Add-DirectoryToUserPath {
-  param([string]$Dir)
 
-  $dirResolved = (Resolve-Path $Dir -ErrorAction SilentlyContinue).Path
-  if (-not $dirResolved) { $dirResolved = $Dir }
+    # 2) Only if no conflict: b4 -> browser4-cli-<platform>
+    $shortName = "b4$ext"
+    $shortPath = Join-Path $InstallDir $shortName
 
-  # Read current user PATH
-  $currentUserPath = [System.Environment]::GetEnvironmentVariable("Path", [System.EnvironmentVariableTarget]::User)
-  $paths = if ($currentUserPath) { $currentUserPath -split ";" | Where-Object { $_ } } else { @() }
-
-  # Check if already present
-  $normalized = $paths | ForEach-Object { $rp = Resolve-Path $_ -ErrorAction SilentlyContinue; if ($rp) { $rp.Path } else { $_ } }
-  if ($normalized -contains $dirResolved) {
-    Write-Check "Already in user PATH: $Dir"
-    return
-  }
+    # Check if b4 is already on PATH (conflict with another tool)
+    $existingCmd = Get-Command b4 -ErrorAction SilentlyContinue
+    if ($existingCmd) {
+        Write-WarnMsg "Skipping short link '$shortName': 'b4' already found on PATH ($($existingCmd.Source))"
+        return
+    }
 
-  if ($DryRun) {
-    Write-Check "[DRY-RUN] Would add to user PATH: $Dir"
-    return
-  }
+    # Check if b4 already exists in the install directory
+    if (Test-Path $shortPath) {
+        Write-WarnMsg "Skipping short link '$shortName': already exists in $InstallDir"
+        return
+    }
 
-  $newPath = if ($currentUserPath) { "$currentUserPath;$Dir" } else { $Dir }
-  [System.Environment]::SetEnvironmentVariable("Path", $newPath, [System.EnvironmentVariableTarget]::User)
-  Write-Check "Added to user PATH: $Dir"
+    # Also check b4.cmd if on Windows (wrapper fallback)
+    if ($script:OSWin) {
+        $shortCmdPath = Join-Path $InstallDir "b4.cmd"
+        if (Test-Path $shortCmdPath) {
+            Write-WarnMsg "Skipping short link '$shortName': 'b4.cmd' already exists in $InstallDir"
+            return
+        }
+    }
 
-  # Also update current session
-  $env:Path = "$env:Path;$Dir"
+    if ($DryRun) {
+        Write-Step "[DRY-RUN] Would create link: $shortName -> $BinaryName"
+    } else {
+        New-PlatformLink -LinkPath $shortPath -TargetName $BinaryName -DisplayName $shortName
+    }
 }
 
 # ----------------------------------------------
 # Helper: replace a binary that may be locked (i.e. currently running)
 # ----------------------------------------------
+
 function Set-BinaryFile {
   param(
     [Parameter(Mandatory=$true)] [string]$TargetPath,
@@ -515,7 +487,7 @@ function Set-BinaryFile {
       Remove-Item $TargetPath -Force -ErrorAction Stop
     } catch {
       # The binary is locked (likely the currently-running process).
-      # On Windows we can rename a running executable — move the old binary
+      # On Windows we can rename a running executable -- move the old binary
       # out of the way, place the new one alongside, and clean up the old one
       # on the next install/upgrade.
       try {
@@ -523,7 +495,7 @@ function Set-BinaryFile {
         Write-WarnMsg "Existing binary is locked (it may be running)."
         Write-WarnMsg "The old copy will be cleaned up on the next install or upgrade."
       } catch {
-        throw "Cannot replace '$TargetPath' — it is locked and cannot be renamed. Close all browser4-cli processes and try again."
+        throw "Cannot replace '$TargetPath' -- it is locked and cannot be renamed. Close all browser4-cli processes and try again."
       }
     }
   }
@@ -535,133 +507,169 @@ function Set-BinaryFile {
     Copy-Item $SourcePath $TargetPath -Force -ErrorAction Stop
   }
 }
+
 # ----------------------------------------------
-# Main
+# PATH management
 # ----------------------------------------------
 
-function Main {
-  Write-Summary "==========================================" -Color Cyan
-  Write-Summary "    browser4-cli Installer" -Color Cyan
-  Write-Summary "==========================================" -Color Cyan
-  Write-Summary ""
+function Add-DirectoryToUserPath {
+    param([string]$Dir)
 
-  # Auto-detect China mainland locale when no explicit source is given
-  if (-not $Source) {
-    $script:ChinaDetected = Test-ChinaLocale
-    if ($script:ChinaDetected) {
-      Write-Step "China mainland locale detected: preferring Aliyun OSS mirror."
-    }
-  }
+    $dirResolved = (Resolve-Path $Dir -ErrorAction SilentlyContinue).Path
+    if (-not $dirResolved) { $dirResolved = $Dir }
 
-  # Detect platform
-  $platformKey = Get-PlatformKey
-  $binaryName = Get-BinaryName -PlatformKey $platformKey
+    # Read current user PATH
+    $currentUserPath = [System.Environment]::GetEnvironmentVariable("Path", [System.EnvironmentVariableTarget]::User)
+    $paths = if ($currentUserPath) { $currentUserPath -split ";" | Where-Object { $_ } } else { @() }
 
-  # -- Locate mode: print diagnostics and exit --
-  if ($Locate) {
-    Write-Summary "--- Locate / diagnostics ---" -Color Cyan
-    Write-Summary ""
-    Write-Step "Script dir:       $ScriptDir"
-    Write-Step "Platform key:     $platformKey"
-    Write-Step "Binary name:      $binaryName"
-    Write-Step "Default install:  $(Get-DefaultInstallDir)"
-    Write-Step "China locale:     $script:ChinaDetected"
-    Write-Step "Source override:  $(if ($Source) { $Source } else { 'auto' })"
-    Write-Step "OS:               $(if ($script:OSWin) { 'Windows' } elseif ($script:OSMac) { 'macOS' } elseif ($script:OSLinux) { 'Linux' } else { 'Unknown' })"
-
-    # Check for local binary
-    $localPath = Find-LocalBinary -BinaryName $binaryName
-    if ($localPath) {
-      $localOk = Test-LocalBinary -Path $localPath
-      Write-Step "Local binary:     $localPath $(if ($localOk) { '(valid)' } else { '(present but --version failed)' })"
-    } else {
-      Write-Step "Local binary:     not found alongside script"
+    # Check if already present
+    $normalized = $paths | ForEach-Object { $rp = Resolve-Path $_ -ErrorAction SilentlyContinue; if ($rp) { $rp.Path } else { $_ } }
+    if ($normalized -contains $dirResolved) {
+        Write-Check "Already in user PATH: $Dir"
+        return
     }
 
-    # Check for already-installed binary
-    $defaultDir = Get-DefaultInstallDir
-    $existingPath = Join-Path $defaultDir $binaryName
-    if (Test-Path $existingPath) {
-      Write-Step "Already installed: $existingPath"
-    } else {
-      Write-Step "Already installed: not found at $defaultDir"
+    if ($DryRun) {
+        Write-Check "[DRY-RUN] Would add to user PATH: $Dir"
+        return
     }
 
-    # Show download URLs that would be tried
-    $urls = Get-DownloadUrls -BinaryName $binaryName -VersionTag $Version
-    Write-Summary ""
-    Write-Step "Download order:"
-    foreach ($entry in $urls) {
-      Write-Step "  $($entry.Label): $($entry.Url)"
-    }
+    $newPath = if ($currentUserPath) { "$currentUserPath;$Dir" } else { $Dir }
+    [System.Environment]::SetEnvironmentVariable("Path", $newPath, [System.EnvironmentVariableTarget]::User)
+    Write-Check "Added to user PATH: $Dir"
 
-    Write-Summary ""
-    return
-  }
+    # Also update current session
+    $env:Path = "$env:Path;$Dir"
+}
 
-  Write-Step "Platform:  $platformKey"
-  Write-Step "Binary:    $binaryName"
+# ----------------------------------------------
+# Main
+# ----------------------------------------------
 
-  # Determine install directory
-  $installDir = if ($InstallDir) { $InstallDir } else { Get-DefaultInstallDir }
-  Write-Step "Install:   $installDir"
-  Write-Summary ""
+function Main {
+    Write-Summary "==========================================" -Color Cyan
+    Write-Summary "    browser4-cli Installer" -Color Cyan
+    Write-Summary "==========================================" -Color Cyan
+    Write-Summary ""
 
-  if (-not (Test-Path $installDir)) {
-    if (-not $DryRun) {
-      New-Item -ItemType Directory -Path $installDir -Force | Out-Null
+    # Auto-detect China mainland locale when no explicit source is given
+    if (-not $Source) {
+        $script:ChinaDetected = Test-ChinaLocale
+        if ($script:ChinaDetected) {
+            Write-Step "China mainland locale detected: preferring Aliyun OSS mirror."
+        }
     }
-    Write-Step "Created directory: $installDir"
-  }
 
-  $binaryPath = Join-Path $installDir $binaryName
-
-  # -- Local binary discovery (bundled/sideload) --
-  $useLocalBinary = $false
-  if (-not $SkipLocal) {
-    $localBinaryPath = Find-LocalBinary -BinaryName $binaryName
-    if ($localBinaryPath) {
-      Write-Step "Found local binary alongside script: $(Split-Path $localBinaryPath -Leaf)"
-      if (Test-LocalBinary -Path $localBinaryPath) {
-        Write-Check "Local binary verified (--version OK)"
-        $useLocalBinary = $true
-      } else {
-        Write-WarnMsg "Local binary found but --version check failed -- will download instead"
-      }
+    # Detect platform
+    $platformKey = Get-PlatformKey
+    $binaryName = Get-BinaryName -PlatformKey $platformKey
+
+    # -- Locate mode: print diagnostics and exit --
+    if ($Locate) {
+        Write-Summary "--- Locate / diagnostics ---" -Color Cyan
+        Write-Summary ""
+        Write-Step "Script dir:       $ScriptDir"
+        Write-Step "Platform key:     $platformKey"
+        Write-Step "Binary name:      $binaryName"
+        Write-Step "Default install:  $(Get-DefaultInstallDir)"
+        Write-Step "China locale:     $script:ChinaDetected"
+        Write-Step "Source override:  $(if ($Source) { $Source } else { 'auto' })"
+        Write-Step "OS:               $(if ($script:OSWin) { 'Windows' } elseif ($script:OSMac) { 'macOS' } elseif ($script:OSLinux) { 'Linux' } else { 'Unknown' })"
+
+        # Check for local binary
+        $localPath = Find-LocalBinary -BinaryName $binaryName
+        if ($localPath) {
+            $localOk = Test-LocalBinary -Path $localPath
+            Write-Step "Local binary:     $localPath $(if ($localOk) { '(valid)' } else { '(present but --version failed)' })"
+        } else {
+            Write-Step "Local binary:     not found alongside script"
+        }
+
+        # Check for already-installed binary
+        $defaultDir = Get-DefaultInstallDir
+        $existingPath = Join-Path $defaultDir $binaryName
+        if (Test-Path $existingPath) {
+            Write-Step "Already installed: $existingPath"
+        } else {
+            Write-Step "Already installed: not found at $defaultDir"
+        }
+
+        # Show download URLs that would be tried
+        $urls = Get-DownloadUrls -BinaryName $binaryName -VersionTag $Version
+        Write-Summary ""
+        Write-Step "Download order:"
+        foreach ($entry in $urls) {
+            Write-Step "  $($entry.Label): $($entry.Url)"
+        }
+
+        Write-Summary ""
+        return
     }
-  } elseif ($SkipLocal) {
-    Write-Step "Skipping local binary check (-SkipLocal)"
-  }
 
-  # Skip download only when --skip-if-installed is set and binary already exists
-  if ((Test-Path $binaryPath) -and (-not $Version) -and $SkipIfInstalled -and (-not $useLocalBinary)) {
-    Write-Check "Binary already installed: $binaryPath"
-  } elseif ($useLocalBinary) {
-    # Copy local binary to install dir
-    if (-not $DryRun) {
-      Set-BinaryFile -TargetPath $binaryPath -SourcePath $localBinaryPath
-    }
-    Write-Check "Installed (local): $binaryPath"
-  } else {
-    # Build download URLs
-    $urls = Get-DownloadUrls -BinaryName $binaryName -VersionTag $Version
-    if (-not $urls -or $urls.Count -eq 0) {
-      throw "No download URLs configured"
-    }
+    Write-Step "Platform:  $platformKey"
+    Write-Step "Binary:    $binaryName"
 
-    $downloaded = $false
-    $tempFile = [System.IO.Path]::GetTempFileName()
+    # Determine install directory
+    $installDir = if ($InstallDir) { $InstallDir } else { Get-DefaultInstallDir }
+    Write-Step "Install:   $installDir"
+    Write-Summary ""
 
-    foreach ($entry in $urls) {
-      if (Invoke-Download -Url $entry.Url -OutFile $tempFile -Label $entry.Label) {
-        $downloaded = $true
-        break
-      }
+    if (-not (Test-Path $installDir)) {
+        if (-not $DryRun) {
+            New-Item -ItemType Directory -Path $installDir -Force | Out-Null
+        }
+        Write-Step "Created directory: $installDir"
     }
 
-    if (-not $downloaded) {
-      if (Test-Path $tempFile) { Remove-Item $tempFile -Force }
-      throw @"
+    $binaryPath = Join-Path $installDir $binaryName
+
+    # -- Local binary discovery (bundled/sideload) --
+    $useLocalBinary = $false
+    if (-not $SkipLocal) {
+        $localBinaryPath = Find-LocalBinary -BinaryName $binaryName
+        if ($localBinaryPath) {
+            Write-Step "Found local binary alongside script: $(Split-Path $localBinaryPath -Leaf)"
+            if (Test-LocalBinary -Path $localBinaryPath) {
+                Write-Check "Local binary verified (--version OK)"
+                $useLocalBinary = $true
+            } else {
+                Write-WarnMsg "Local binary found but --version check failed -- will download instead"
+            }
+        }
+    } elseif ($SkipLocal) {
+        Write-Step "Skipping local binary check (-SkipLocal)"
+    }
+
+    # Skip download only when --skip-if-installed is set and binary already exists,
+    # unless --force overrides it.
+    if ((Test-Path $binaryPath) -and (-not $Version) -and $SkipIfInstalled -and (-not $Force) -and (-not $useLocalBinary)) {
+        Write-Check "Binary already installed: $binaryPath"
+    } elseif ($useLocalBinary) {
+        # Copy local binary to install dir
+        if (-not $DryRun) {
+            Set-BinaryFile -TargetPath $binaryPath -SourcePath $localBinaryPath
+        }
+        Write-Check "Installed (local): $binaryPath"
+    } else {
+        # Build download URLs
+        $urls = Get-DownloadUrls -BinaryName $binaryName -VersionTag $Version
+        if (-not $urls -or $urls.Count -eq 0) {
+            throw "No download URLs configured"
+        }
+
+        $downloaded = $false
+        $tempFile = [System.IO.Path]::GetTempFileName()
+
+        foreach ($entry in $urls) {
+            if (Invoke-Download -Url $entry.Url -OutFile $tempFile -Label $entry.Label) {
+                $downloaded = $true
+                break
+            }
+        }
+
+        if (-not $downloaded) {
+            if (Test-Path $tempFile) { Remove-Item $tempFile -Force }
+            throw @"
 Could not download browser4-cli binary.
 
 Tried:
@@ -673,70 +681,70 @@ Please check:
   - For GitHub rate limits, set GITHUB_TOKEN environment variable
   - If you have a local copy, place it alongside this script and re-run
 "@
-    }
+        }
 
-    # Move from temp to install dir
-    if (-not $DryRun) {
-      Set-BinaryFile -TargetPath $binaryPath -SourcePath $tempFile -Move
+        # Move from temp to install dir
+        if (-not $DryRun) {
+            Set-BinaryFile -TargetPath $binaryPath -SourcePath $tempFile -Move
+        }
+        Write-Check "Installed: $binaryPath"
     }
-    Write-Check "Installed: $binaryPath"
-  }
 
-  # On Unix, ensure executable bit
-  if (-not $script:OSWin) {
-    if (-not $DryRun) {
-      try { chmod +x $binaryPath 2>$null } catch { }
+    # On Unix, ensure executable bit
+    if (-not $script:OSWin) {
+        if (-not $DryRun) {
+            try { chmod +x $binaryPath 2>$null } catch { }
+        }
     }
-  }
 
-  # Create symlinks (browser4-cli -> platform binary, b4 if no conflict)
-  Write-Summary ""
-  New-Symlinks -BinaryName $binaryName -InstallDir $installDir -PlatformKey $platformKey
-
-  # Add to PATH
-  if ($AddToPath -and $script:OSWin) {
+    # Create symlinks (browser4-cli -> platform binary, b4 if no conflict)
     Write-Summary ""
-    Add-DirectoryToUserPath -Dir $installDir
-  } elseif ($AddToPath -and -not $script:OSWin) {
+    New-Symlinks -BinaryName $binaryName -InstallDir $installDir -PlatformKey $platformKey
+
+    # Add to PATH
+    if ($AddToPath -and $script:OSWin) {
+        Write-Summary ""
+        Add-DirectoryToUserPath -Dir $installDir
+    } elseif ($AddToPath -and -not $script:OSWin) {
+        Write-Summary ""
+        $shellRc = if (Test-Path "$env:HOME/.zshrc") { "$env:HOME/.zshrc" } elseif (Test-Path "$env:HOME/.bashrc") { "$env:HOME/.bashrc" } elseif (Test-Path "$env:HOME/.bash_profile") { "$env:HOME/.bash_profile" } else { "$env:HOME/.profile" }
+        $pathLine = "export PATH=""$installDir`:`$PATH"""
+        if (-not $DryRun) {
+            if (-not (Select-String -Path $shellRc -Pattern [regex]::Escape($installDir) -ErrorAction SilentlyContinue)) {
+                Add-Content -Path $shellRc -Value ""
+                Add-Content -Path $shellRc -Value "# browser4-cli"
+                Add-Content -Path $shellRc -Value $pathLine
+                Write-Check "Added to PATH in $shellRc"
+            } else {
+                Write-Check "PATH entry already in $shellRc"
+            }
+        } else {
+            Write-Check "[DRY-RUN] Would add to $shellRc"
+        }
+    }
+
+    # Verify
     Write-Summary ""
-    $shellRc = if (Test-Path "$env:HOME/.zshrc") { "$env:HOME/.zshrc" } elseif (Test-Path "$env:HOME/.bashrc") { "$env:HOME/.bashrc" } elseif (Test-Path "$env:HOME/.bash_profile") { "$env:HOME/.bash_profile" } else { "$env:HOME/.profile" }
-    $pathLine = "export PATH=""$installDir`:`$PATH"""
     if (-not $DryRun) {
-      if (-not (Select-String -Path $shellRc -Pattern [regex]::Escape($installDir) -ErrorAction SilentlyContinue)) {
-        Add-Content -Path $shellRc -Value ""
-        Add-Content -Path $shellRc -Value "# browser4-cli"
-        Add-Content -Path $shellRc -Value $pathLine
-        Write-Check "Added to PATH in $shellRc"
-      } else {
-        Write-Check "PATH entry already in $shellRc"
-      }
+        try {
+            $versionOutput = & $binaryPath --version 2>&1
+            Write-Summary "[v] browser4-cli installed successfully" -Color Green
+            Write-Summary "  Version: $versionOutput"
+        } catch {
+            Write-Summary "[v] Binary installed at: $binaryPath" -Color Green
+            Write-WarnMsg "Could not verify --version (this is normal on first install)"
+        }
     } else {
-      Write-Check "[DRY-RUN] Would add to $shellRc"
+        Write-Summary "[DRY-RUN] Installation plan complete" -Color Yellow
     }
-  }
 
-  # Verify
-  Write-Summary ""
-  if (-not $DryRun) {
-    try {
-      $versionOutput = & $binaryPath --version 2>&1
-      Write-Summary "[v] browser4-cli installed successfully" -Color Green
-      Write-Summary "  Version: $versionOutput"
-    } catch {
-      Write-Summary "[v] Binary installed at: $binaryPath" -Color Green
-      Write-WarnMsg "Could not verify --version (this is normal on first install)"
-    }
-  } else {
-    Write-Summary "[DRY-RUN] Installation plan complete" -Color Yellow
-  }
-
-  Write-Summary ""
-  Write-Summary "Run 'browser4-cli --help' to get started." -Color Cyan
+    Write-Summary ""
+    Write-Summary "Run 'browser4-cli --help' to get started." -Color Cyan
 
-  if ($script:OSWin) {
-    Write-Summary "If the command isn't found, restart your terminal or run:"
-    Write-Summary "  `$env:Path = [System.Environment]::GetEnvironmentVariable('Path','User') + ';' + [System.Environment]::GetEnvironmentVariable('Path','Machine')"
-  }
+    if ($script:OSWin) {
+        Write-Summary "If the command isn't found, restart your terminal or run:"
+        Write-Summary "  `$env:Path = [System.Environment]::GetEnvironmentVariable('Path','User') + ';' + [System.Environment]::GetEnvironmentVariable('Path','Machine')"
+    }
 }
 
 Main

package/scripts/publish-if-needed.js

@@ -59,7 +59,9 @@ function main() {
     return;
   }
 
-  runCommand('npm publish');
+  const isPrerelease = prePublishDecision.cliVersion.includes('-');
+  const tagFlag = isPrerelease ? '--tag next' : '';
+  runCommand(`npm publish ${tagFlag}`);
 }
 
 main();

package/scripts/tests/install-browser4-cli.tests.ps1

@@ -1,3 +1,16 @@
+#!/usr/bin/env pwsh
+
+# ═══════════════════════════════════════════════════════════════════
+# CROSS-PLATFORM: This script must run on Linux, macOS, and Windows.
+# - Use $IsWindows / $IsLinux / $IsMacOS for platform detection.
+# - Use "($IsWindows -or $env:OS -eq 'Windows_NT')" for PS 5.1 compat.
+# - Avoid Windows-only env vars ($env:TEMP) — use $env:TMPDIR fallback.
+# - Guard "chcp" and other Windows-only commands behind platform checks.
+# - Paths: use Join-Path / Split-Path; never bake \ or / as literal.
+# - [System.IO.Path]::IsPathRooted is platform-aware — C:\foo is NOT
+#   rooted on Linux; test with platform-appropriate absolute paths.
+# ═══════════════════════════════════════════════════════════════════
+
 <#
 .SYNOPSIS
   Tests for install-browser4-cli.ps1
@@ -30,7 +43,7 @@ function RunScript([string]$scriptArgs, [ref]$exitCode) {
     $tmpErr = [System.IO.Path]::GetTempFileName()
     $cmd = "& '$installScript' $scriptArgs 2>'$tmpErr'"
     $psi = New-Object System.Diagnostics.ProcessStartInfo
-    $psi.FileName = "powershell.exe"
+    $psi.FileName = if ($IsWindows -or ($env:OS -eq 'Windows_NT')) { "powershell.exe" } else { "pwsh" }
     $psi.Arguments = "-NoProfile -ExecutionPolicy Bypass -Command `"$cmd`""
     $psi.RedirectStandardOutput = $true
     $psi.UseShellExecute = $false
@@ -284,74 +297,6 @@ $sb = [ScriptBlock]::Create($scriptContent)
     Test "Test-LocalBinary returns false for null" {
         if (Test-LocalBinary -Path $null) { throw "Should be false" }
     }
-
-    # ── Set-BinaryFile (locked-binary-safe replacement) ──
-    Test "Set-BinaryFile creates new file (Copy)" {
-        $tmpDir = Join-Path $env:TEMP "b4-test-$(New-Guid)"
-        New-Item -ItemType Directory $tmpDir -Force | Out-Null
-        try {
-            $src = Join-Path $tmpDir "source.exe"
-            $dst = Join-Path $tmpDir "target.exe"
-            "new-content" | Out-File $src -Encoding ASCII
-            Set-BinaryFile -TargetPath $dst -SourcePath $src
-            if (-not (Test-Path $dst)) { throw "Target was not created" }
-            $actual = (Get-Content $dst -Raw).Trim()
-            if ($actual -ne "new-content") { throw "Wrong content: '$actual'" }
-            # Source still exists (Copy mode)
-            if (-not (Test-Path $src)) { throw "Source should still exist after copy" }
-        } finally {
-            Remove-Item $tmpDir -Recurse -Force -ErrorAction SilentlyContinue
-        }
-    }
-
-    Test "Set-BinaryFile creates new file (Move)" {
-        $tmpDir = Join-Path $env:TEMP "b4-test-$(New-Guid)"
-        New-Item -ItemType Directory $tmpDir -Force | Out-Null
-        try {
-            $src = Join-Path $tmpDir "source.exe"
-            $dst = Join-Path $tmpDir "target.exe"
-            "moved-content" | Out-File $src -Encoding ASCII
-            Set-BinaryFile -TargetPath $dst -SourcePath $src -Move
-            if (-not (Test-Path $dst)) { throw "Target was not created" }
-            $actual = (Get-Content $dst -Raw).Trim()
-            if ($actual -ne "moved-content") { throw "Wrong content: '$actual'" }
-            # Source should be gone (Move mode)
-            if (Test-Path $src) { throw "Source should not exist after move" }
-        } finally {
-            Remove-Item $tmpDir -Recurse -Force -ErrorAction SilentlyContinue
-        }
-    }
-
-    Test "Set-BinaryFile replaces existing file (Copy)" {
-        $tmpDir = Join-Path $env:TEMP "b4-test-$(New-Guid)"
-        New-Item -ItemType Directory $tmpDir -Force | Out-Null
-        try {
-            $src = Join-Path $tmpDir "source.exe"
-            $dst = Join-Path $tmpDir "target.exe"
-            "old" | Out-File $dst -Encoding ASCII
-            "new" | Out-File $src -Encoding ASCII
-            Set-BinaryFile -TargetPath $dst -SourcePath $src
-            if ((Get-Content $dst -Raw).Trim() -ne "new") { throw "Content not replaced" }
-        } finally {
-            Remove-Item $tmpDir -Recurse -Force -ErrorAction SilentlyContinue
-        }
-    }
-
-    Test "Set-BinaryFile replaces existing file (Move)" {
-        $tmpDir = Join-Path $env:TEMP "b4-test-$(New-Guid)"
-        New-Item -ItemType Directory $tmpDir -Force | Out-Null
-        try {
-            $src = Join-Path $tmpDir "source.exe"
-            $dst = Join-Path $tmpDir "target.exe"
-            "old" | Out-File $dst -Encoding ASCII
-            "moved" | Out-File $src -Encoding ASCII
-            Set-BinaryFile -TargetPath $dst -SourcePath $src -Move
-            if ((Get-Content $dst -Raw).Trim() -ne "moved") { throw "Content not replaced" }
-            if (Test-Path $src) { throw "Source should not exist after move" }
-        } finally {
-            Remove-Item $tmpDir -Recurse -Force -ErrorAction SilentlyContinue
-        }
-    }
 }
 
 Write-Host ""