browser4-cli 0.1.24 → 0.1.26

package/scripts/install-browser4-cli.sh

@@ -16,19 +16,20 @@
 #   --version, -v TAG   Release tag (e.g. "v4.11.0"). Default: latest.
 #   --install-dir, -d DIR  Install directory (default: ~/.local/bin).
 #   --source SRC        Force download source: "github" or "oss".
-#                       Default (auto): locale-aware — OSS first for China mainland.
+#                       Default (auto): locale-aware -- OSS first for China mainland.
 #   --no-path            Skip adding install dir to PATH.
 #   --skip-local         Skip checking for a locally-bundled binary.
 #   --locate             Print detection results and exit (no install).
 #   --silent, -s         Suppress non-error output.
 #   --dry-run            Print what would be done without doing it.
+#   --skip-if-installed  Skip download if binary already exists at install path.
 #   --help, -h           Show this message.
 
 set -euo pipefail
 
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 # Globals
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 
 GITHUB_REPO="platonai/Browser4"
 OSS_BASE="https://browser4.oss-cn-beijing.aliyuncs.com"
@@ -39,19 +40,20 @@ SOURCE=""
 ADD_TO_PATH=true
 SILENT=false
 DRY_RUN=false
+SKIP_IF_INSTALLED=false
 SKIP_LOCAL=false
 LOCATE_MODE=false
 CHINA_DETECTED=false
 SCRIPT_DIR=""
 
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 # Helpers
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 
 say()    { if [[ "$SILENT" != true ]]; then echo -e "$*"; fi; }
-step()   { say "  → $*"; }
-ok()     { say "    ✓ $*"; }
-warn()   { say "    ⚠ $*" >&2; }
+step()   { say "  -> $*"; }
+ok()     { say "    [v] $*"; }
+warn()   { say "    [!] $*" >&2; }
 die()    { echo "ERROR: $*" >&2; exit 1; }
 
 color_cyan='\033[0;36m'
@@ -61,16 +63,16 @@ color_reset='\033[0m'
 
 header() {
   if [[ "$SILENT" != true ]]; then
-    echo -e "${color_cyan}╔════════════════════════════════════════╗${color_reset}"
-    echo -e "${color_cyan}║   browser4-cli Installer               ║${color_reset}"
-    echo -e "${color_cyan}╚════════════════════════════════════════╝${color_reset}"
+    echo -e "${color_cyan}==========================================${color_reset}"
+    echo -e "${color_cyan}    browser4-cli Installer${color_reset}"
+    echo -e "${color_cyan}==========================================${color_reset}"
     echo ""
   fi
 }
 
-# ──────────────────────────────────────────────
-# Script location — find ourselves on disk
-# ──────────────────────────────────────────────
+# ----------------------------------------------
+# Script location -- find ourselves on disk
+# ----------------------------------------------
 
 detect_script_dir() {
   # BASH_SOURCE works even when sourced; prefer it over $0.
@@ -79,7 +81,7 @@ detect_script_dir() {
   elif [[ -n "${0:-}" ]] && [[ "$0" != "bash" ]] && [[ "$0" != "-bash" ]] && [[ -f "$0" ]]; then
     SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
   fi
-  # If piped via curl | bash, SCRIPT_DIR stays empty — no local binaries available.
+  # If piped via curl | bash, SCRIPT_DIR stays empty -- no local binaries available.
 }
 
 # Search for a pre-downloaded binary near the script (bundled/sideload install).
@@ -127,6 +129,7 @@ Options:
   --locate            Print detection results and exit without installing.
   --silent, -s        Suppress non-error output.
   --dry-run           Print what would be done without doing it.
+  --skip-if-installed Skip download if binary already exists at install path.
   --help, -h          Show this message.
 
 Examples:
@@ -137,12 +140,13 @@ Examples:
   $(basename "$0") --locate                 # Run diagnostics (no install)
   $(basename "$0") --skip-local             # Force download, ignore bundled binary
   $(basename "$0") --source oss             # Force Aliyun OSS (China mainland)
+  $(basename "$0") --skip-if-installed      # Skip download if already installed
 EOF
 }
 
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 # Argument parsing
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
@@ -163,29 +167,30 @@ while [[ $# -gt 0 ]]; do
     --locate) LOCATE_MODE=true; shift ;;
     --silent|-s) SILENT=true; shift ;;
     --dry-run) DRY_RUN=true; shift ;;
+    --skip-if-installed) SKIP_IF_INSTALLED=true; shift ;;
     --help|-h) usage; exit 0 ;;
     *) die "Unknown argument: $1 (use --help)";;
   esac
 done
 
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 # China mainland locale detection (zero-network)
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 
 detect_china_locale() {
-  # 1 — Locale env vars
+  # 1 -- Locale env vars
   local lang
   lang="${LC_ALL:-${LANG:-${LC_CTYPE:-${LC_MESSAGES:-}}}}"
   case "$lang" in
     zh_CN*|zh-CN*|"Chinese (Simplified)_China"*) return 0 ;;
   esac
 
-  # 2 — TZ env var
+  # 2 -- TZ env var
   case "${TZ:-}" in
     Asia/Shanghai|Asia/Chongqing|Asia/Urumqi|Asia/Harbin) return 0 ;;
   esac
 
-  # 3 — /etc/timezone
+  # 3 -- /etc/timezone
   if [[ -f /etc/timezone ]]; then
     local tz
     tz=$(cat /etc/timezone 2>/dev/null || true)
@@ -197,9 +202,9 @@ detect_china_locale() {
   return 1
 }
 
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 # Platform detection
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 
 detect_os() {
   case "$(uname -s)" in
@@ -235,7 +240,7 @@ detect_libc() {
     fi
   fi
 
-  # Check for musl loader — covers common architectures
+  # Check for musl loader -- covers common architectures
   # x86_64, aarch64, armhf (32-bit ARM), i386, riscv64, s390x, ppc64le, mips64
   local musl_loader
   for musl_loader in \
@@ -298,9 +303,9 @@ get_default_install_dir() {
   echo "$dir"
 }
 
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 # Download
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 
 check_commands() {
   local missing=()
@@ -392,7 +397,7 @@ download_file() {
       return 0
     fi
 
-    warn "Downloaded file too small (${size} bytes) — may be an error page"
+    warn "Downloaded file too small (${size} bytes) -- may be an error page"
     rm -f "$dest"
     return 1
   fi
@@ -402,9 +407,9 @@ download_file() {
   return 1
 }
 
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 # PATH management
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 
 add_to_shell_rc() {
   local dir="$1"
@@ -468,9 +473,9 @@ add_to_shell_rc() {
   say "    Reload with: source $rc_file"
 }
 
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 # Symlinks
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 
 create_symlinks() {
   local binary_name="$1"
@@ -514,9 +519,9 @@ create_symlinks() {
   fi
 }
 
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 # Main
-# ──────────────────────────────────────────────
+# ----------------------------------------------
 
 main() {
   check_commands
@@ -538,11 +543,11 @@ main() {
   platform_key=$(get_platform_key)
   binary_name=$(get_binary_name "$platform_key")
 
-  # ── Locate mode: print diagnostics and exit ──
+  # -- Locate mode: print diagnostics and exit --
   if [[ "$LOCATE_MODE" == true ]]; then
-    echo -e "${color_cyan}─── Locate / diagnostics ───${color_reset}"
+    echo -e "${color_cyan}--- Locate / diagnostics ---${color_reset}"
     echo ""
-    step "Script dir:       ${SCRIPT_DIR:-'(not available — piped via curl?)'}"
+    step "Script dir:       ${SCRIPT_DIR:-'(not available -- piped via curl?)'}"
     step "Platform key:     $platform_key"
     step "Binary name:      $binary_name"
     step "Default install:  $(get_default_install_dir)"
@@ -606,7 +611,7 @@ main() {
 
   local binary_path="${INSTALL_DIR}/${binary_name}"
 
-  # ── Local binary discovery (bundled/sideload) ──
+  # -- Local binary discovery (bundled/sideload) --
   local use_local_binary=false
   local local_binary_path=""
   if [[ "$SKIP_LOCAL" != true ]]; then
@@ -616,7 +621,7 @@ main() {
         ok "Local binary verified (--version OK)"
         use_local_binary=true
       else
-        warn "Local binary found but --version check failed — will download instead"
+        warn "Local binary found but --version check failed -- will download instead"
       fi
     fi
   else
@@ -624,7 +629,7 @@ main() {
   fi
 
   # Install binary: local copy > already installed > download
-  if [[ -f "$binary_path" ]] && [[ -z "$VERSION" ]] && [[ "$use_local_binary" != true ]]; then
+  if [[ -f "$binary_path" ]] && [[ -z "$VERSION" ]] && [[ "$SKIP_IF_INSTALLED" == true ]] && [[ "$use_local_binary" != true ]]; then
     ok "Binary already installed: $binary_path"
   elif [[ "$use_local_binary" == true ]]; then
     # Copy local binary to install dir
@@ -705,10 +710,10 @@ main() {
   say ""
   if [[ "$DRY_RUN" != true ]]; then
     if version_output=$("$binary_path" --version 2>&1); then
-      echo -e "${color_green}✓ browser4-cli installed successfully${color_reset}"
+      echo -e "${color_green}[v] browser4-cli installed successfully${color_reset}"
       say "  Version: $version_output"
     else
-      echo -e "${color_green}✓ Binary installed at: $binary_path${color_reset}"
+      echo -e "${color_green}[v] Binary installed at: $binary_path${color_reset}"
       warn "Could not verify --version (this is normal on first install)"
     fi
   else

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

@@ -0,0 +1,366 @@
+<#
+.SYNOPSIS
+  Tests for install-browser4-cli.ps1
+  PowerShell 5.1+ only — zero external dependencies.
+  Run: powershell -NoProfile -ExecutionPolicy Bypass -File install-browser4-cli.tests.ps1
+#>
+
+$ErrorActionPreference = "Stop"
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$installScript = Join-Path (Split-Path $scriptDir -Parent) "install-browser4-cli.ps1"
+
+$pass = 0
+$fail = 0
+
+function Test($name, [ScriptBlock]$block) {
+    try {
+        $null = & $block
+        $script:pass++
+        Write-Host "  PASS  $name" -ForegroundColor Green
+    } catch {
+        $script:fail++
+        Write-Host "  FAIL  $name" -ForegroundColor Red
+        Write-Host "        $($_.Exception.Message)" -ForegroundColor Red
+    }
+}
+
+function RunScript([string]$scriptArgs, [ref]$exitCode) {
+    # Use -Command to control stderr redirect (2> path must come before script args,
+    # which -File would pass as literal arguments to the script).
+    $tmpErr = [System.IO.Path]::GetTempFileName()
+    $cmd = "& '$installScript' $scriptArgs 2>'$tmpErr'"
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = "powershell.exe"
+    $psi.Arguments = "-NoProfile -ExecutionPolicy Bypass -Command `"$cmd`""
+    $psi.RedirectStandardOutput = $true
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $proc = [System.Diagnostics.Process]::Start($psi)
+    $out = $proc.StandardOutput.ReadToEnd()
+    $proc.WaitForExit()
+    $exitCode.Value = $proc.ExitCode
+    $err = if (Test-Path $tmpErr) { Get-Content $tmpErr -Raw -ErrorAction SilentlyContinue; Remove-Item $tmpErr -Force -ErrorAction SilentlyContinue } else { "" }
+    return [PSCustomObject]@{ Output = $out; Error = $err; ExitCode = $proc.ExitCode }
+}
+
+Write-Host "============================================" -ForegroundColor Cyan
+Write-Host " install-browser4-cli.ps1 Test Suite" -ForegroundColor Cyan
+Write-Host "============================================" -ForegroundColor Cyan
+Write-Host ""
+
+# ── Pre-flight ──
+Write-Host "--- Pre-flight ---" -ForegroundColor Cyan
+
+Test "file exists" {
+    if (-not (Test-Path $installScript)) { throw "Not found: $installScript" }
+}
+
+Test "file is readable" {
+    $null = Get-Content $installScript -Raw -ErrorAction Stop
+}
+
+Test "no non-ASCII bytes" {
+    $bytes = [System.IO.File]::ReadAllBytes($installScript)
+    $nonAscii = @($bytes | Where-Object { $_ -gt 127 })
+    if ($nonAscii.Count -gt 0) {
+        throw "Found $($nonAscii.Count) non-ASCII bytes"
+    }
+}
+
+Test "AST parses without errors" {
+    $parseErrors = $null
+    $ast = [System.Management.Automation.Language.Parser]::ParseFile(
+        $installScript, [ref]$null, [ref]$parseErrors
+    )
+    if ($parseErrors.Count -gt 0) {
+        $msg = ($parseErrors | ForEach-Object { "L$($_.Extent.StartLineNumber): $($_.Message)" }) -join "; "
+        throw $msg
+    }
+}
+
+Write-Host ""
+
+# ── Param block (via AST) ──
+Write-Host "--- Param block ---" -ForegroundColor Cyan
+
+$content = Get-Content $installScript -Raw
+$parseErrors = $null
+$ast = [System.Management.Automation.Language.Parser]::ParseInput($content, [ref]$null, [ref]$parseErrors)
+
+Test "param block defines all expected parameters" {
+    $expected = @('Version', 'InstallDir', 'Source', 'AddToPath',
+                  'Silent', 'DryRun', 'SkipIfInstalled', 'SkipLocal', 'Locate')
+    # Extract param block text via AST extents
+    $paramAst = $ast.ParamBlock
+    if (-not $paramAst) { throw "Could not find param block AST" }
+    $txt = $content.Substring($paramAst.Extent.StartOffset, $paramAst.Extent.EndOffset - $paramAst.Extent.StartOffset)
+    foreach ($p in $expected) {
+        if ($txt -notmatch ('\$' + $p + '\b')) {
+            throw "Missing parameter: $p"
+        }
+    }
+}
+
+Test "Source has ValidateSet with empty string" {
+    if ($content -notmatch 'ValidateSet\("",\s*"github",\s*"oss"\)') {
+        throw "ValidateSet must include empty string for iex compatibility"
+    }
+}
+
+Write-Host ""
+
+# ── Locate mode ──
+Write-Host "--- Locate mode ---" -ForegroundColor Cyan
+
+$ec = 0
+$r = RunScript -scriptArgs "-Locate" -exitCode ([ref]$ec)
+
+Test "-Locate exits with code 0" {
+    if ($ec -ne 0) { throw "Exit code: $ec" }
+}
+
+Test "-Locate shows platform key" {
+    if ($r.Output -notmatch 'Platform key') {
+        throw "Missing 'Platform key' in: $($r.Output.Substring(0, [Math]::Min(500, $r.Output.Length)))"
+    }
+}
+
+Test "-Locate shows binary name" {
+    if ($r.Output -notmatch 'Binary name') {
+        throw "Missing 'Binary name' in output (len=$($r.Output.Length))"
+    }
+}
+
+Test "-Locate shows download order" {
+    if ($r.Output -notmatch 'Download order') {
+        throw "Missing 'Download order' in output"
+    }
+}
+
+Write-Host ""
+
+# ── Download URLs (via -Locate output) ──
+Write-Host "--- Download URLs ---" -ForegroundColor Cyan
+
+Test "locate shows correct GitHub latest/download URL" {
+    if ($r.Output -notmatch 'github\.com/platonai/Browser4/releases/latest/download/') {
+        $lines = ($r.Output -split '\n' | Where-Object { $_ -match 'ownload' }) -join '; '
+        throw "GitHub latest URL not found. Download lines: $lines"
+    }
+}
+
+Test "locate shows correct OSS download/latest URL" {
+    if ($r.Output -notmatch 'oss-cn-beijing.*?releases/download/latest/') {
+        $lines = ($r.Output -split '\n' | Where-Object { $_ -match 'ownload' }) -join '; '
+        throw "OSS latest URL not found. Download lines: $lines"
+    }
+}
+
+# Test versioned URLs
+$ec2 = 0
+$r2 = RunScript -scriptArgs "-Version v4.11.0 -Locate" -exitCode ([ref]$ec2)
+
+Test "-Version shows tag-based URLs" {
+    if ($r2.Output -notmatch 'releases/download/v4\.11\.0/') {
+        throw "Versioned URL not in output"
+    }
+}
+
+Write-Host ""
+
+# ── Parameter acceptance ──
+Write-Host "--- Parameter acceptance ---" -ForegroundColor Cyan
+
+Test "-SkipIfInstalled flag accepted" {
+    $ec3 = 0; $r3 = RunScript -scriptArgs "-SkipIfInstalled -DryRun" -exitCode ([ref]$ec3)
+    if ($ec3 -ne 0) { throw "Exit code: $ec3, output: $($r3.Output)" }
+}
+
+Test "-SkipLocal flag accepted" {
+    $ec4 = 0; $r4 = RunScript -scriptArgs "-SkipLocal -DryRun" -exitCode ([ref]$ec4)
+    if ($ec4 -ne 0) { throw "Exit code: $ec4, output: $($r4.Output)" }
+}
+
+Test "-Force rejected (replaced by -SkipIfInstalled)" {
+    $ec5 = 0; $r5 = RunScript -scriptArgs "-Force -DryRun" -exitCode ([ref]$ec5)
+    if ($r5.Error -notmatch 'Force') {
+        throw "-Force should be rejected, got: $($r5.Error)"
+    }
+}
+
+Test "-Source oss accepted" {
+    $ec6 = 0; $r6 = RunScript -scriptArgs "-Source oss -DryRun" -exitCode ([ref]$ec6)
+    if ($ec6 -ne 0) { throw "Exit code: $ec6, output: $($r6.Output)" }
+}
+
+Test "-Source github accepted" {
+    $ec7 = 0; $r7 = RunScript -scriptArgs "-Source github -DryRun" -exitCode ([ref]$ec7)
+    if ($ec7 -ne 0) { throw "Exit code: $ec7, output: $($r7.Output)" }
+}
+
+Test "-Source invalid rejected" {
+    $ec8 = 0; $r8 = RunScript -scriptArgs "-Source invalid -DryRun" -exitCode ([ref]$ec8)
+    if ($r8.Error -notmatch 'Source|invalid|parameter') {
+        throw "-Source invalid should be rejected, got: $($r8.Error)"
+    }
+}
+
+Test "-Silent flag accepted" {
+    $ec9 = 0; $r9 = RunScript -scriptArgs "-Silent -DryRun" -exitCode ([ref]$ec9)
+    if ($ec9 -ne 0) { throw "Exit code: $ec9, output: $($r9.Output)" }
+}
+
+Test "-Version flag accepted" {
+    $ec10 = 0; $r10 = RunScript -scriptArgs "-Version v4.11.0 -DryRun" -exitCode ([ref]$ec10)
+    if ($ec10 -ne 0) { throw "Exit code: $ec10, output: $($r10.Output)" }
+}
+
+Write-Host ""
+
+# ── Functions via dot-source ──
+Write-Host "--- Functions ---" -ForegroundColor Cyan
+
+# Strip trailing Main call and dot-source for function-level tests
+$scriptContent = Get-Content $installScript -Raw
+$scriptContent = $scriptContent -replace '\r?\nMain\s*$', ''
+$scriptContent = $scriptContent -replace '\$ErrorActionPreference\s*=\s*"Stop"', ''
+$sb = [ScriptBlock]::Create($scriptContent)
+
+& {
+    # Suppress output
+    $Silent = $true
+    $DryRun = $false
+    $SkipLocal = $false
+    $Locate = $false
+    $Source = ""
+    $Version = ""
+    $InstallDir = ""
+    $AddToPath = $true
+
+    . $sb
+
+    Test "Get-PlatformKey returns valid format" {
+        $key = Get-PlatformKey
+        if ($key -notmatch '^(win32|linux|darwin)-(x64|arm64)$' -and
+            $key -notmatch '^linux-musl-(x64|arm64)$') {
+            throw "Unexpected platform key: $key"
+        }
+    }
+
+    Test "Get-BinaryName includes .exe on win32" {
+        $name = Get-BinaryName -PlatformKey "win32-x64"
+        if ($name -ne "browser4-cli-win32-x64.exe") { throw "Got: $name" }
+    }
+
+    Test "Get-BinaryName excludes .exe on linux" {
+        $name = Get-BinaryName -PlatformKey "linux-x64"
+        if ($name -ne "browser4-cli-linux-x64") { throw "Got: $name" }
+    }
+
+    Test "Get-BinaryName excludes .exe on darwin" {
+        $name = Get-BinaryName -PlatformKey "darwin-arm64"
+        if ($name -ne "browser4-cli-darwin-arm64") { throw "Got: $name" }
+    }
+
+    Test "Get-DefaultInstallDir returns non-empty" {
+        $dir = Get-DefaultInstallDir
+        if ([string]::IsNullOrEmpty($dir)) { throw "Empty install dir" }
+    }
+
+    Test "Test-ChinaLocale returns [bool]" {
+        $result = Test-ChinaLocale
+        if ($result -isnot [bool]) { throw "Expected [bool], got $($result.GetType())" }
+    }
+
+    Test "Find-LocalBinary returns null for non-existent" {
+        $result = Find-LocalBinary -BinaryName "nonexistent-file-xyz.exe"
+        if ($result -ne $null) { throw "Expected null, got: $result" }
+    }
+
+    Test "Test-LocalBinary returns false for empty string" {
+        if (Test-LocalBinary -Path "") { throw "Should be false" }
+    }
+
+    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 ""
+
+# ── Summary ──
+Write-Host "============================================" -ForegroundColor Cyan
+$total = $pass + $fail
+Write-Host " Results: $pass / $total passed" -ForegroundColor $(if ($fail -eq 0) { "Green" } else { "Red" })
+Write-Host "============================================" -ForegroundColor Cyan
+
+if ($fail -gt 0) { exit 1 }
+exit 0