easy-devops 0.1.0

package/install.ps1

@@ -0,0 +1,653 @@
+<#
+.SYNOPSIS
+  Easy DevOps Bootstrap Installer for Windows
+
+.DESCRIPTION
+  Installs Node.js (via nvm-windows), project dependencies, and registers
+  the easy-devops CLI command globally.
+
+.PARAMETER Help
+  Print this help message and exit.
+
+.PARAMETER Version
+  Skip the version picker and use the specified Node.js major version.
+  Example: -Version 20
+
+.PARAMETER KeepNode
+  Skip Node.js management entirely. Proceeds directly to dependency
+  installation using whatever Node.js is currently active.
+
+.EXAMPLE
+  .\install.ps1                  # Interactive install
+  .\install.ps1 -Version 20      # Install Node.js 20.x (latest patch via nvm)
+  .\install.ps1 -KeepNode        # Skip Node.js management
+#>
+param(
+  [switch]$Help,
+  [string]$Version  = "",
+  [switch]$KeepNode
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$REQUIRED_NODE_MAJOR = 18
+$NVM_WINDOWS_VERSION = '1.1.12'
+$NODE_FALLBACK       = '20'
+
+# ─── Summary tracking (mirrors install.sh add_result) ────────────────────────
+
+$stepResults = [System.Collections.Generic.List[PSCustomObject]]::new()
+
+function Add-Result {
+  param([string]$Name, [bool]$OK, [string]$Detail = '')
+  $script:stepResults.Add([PSCustomObject]@{ Name = $Name; OK = $OK; Detail = $Detail })
+}
+
+# ─── Output helpers ───────────────────────────────────────────────────────────
+
+$script:currentStep = 0
+$script:totalSteps  = 7   # always 7; package-mode steps shown as skipped
+
+function Write-Step {
+  param([string]$msg)
+  $script:currentStep++
+  Write-Host ""
+  Write-Host "  [$script:currentStep/$script:totalSteps] $msg" -ForegroundColor Cyan
+  Write-Host "  $('-' * 50)" -ForegroundColor DarkGray
+}
+
+function Write-OK   { param([string]$msg) Write-Host "         OK   $msg" -ForegroundColor Green  }
+function Write-Warn { param([string]$msg) Write-Host "       WARN   $msg" -ForegroundColor Yellow }
+function Write-Err  { param([string]$msg) Write-Host "      ERROR   $msg" -ForegroundColor Red    }
+function Write-Info { param([string]$msg) Write-Host "             $msg"  -ForegroundColor Gray   }
+
+function Refresh-Path {
+  $env:Path = [System.Environment]::GetEnvironmentVariable('Path', 'Machine') + ';' +
+              [System.Environment]::GetEnvironmentVariable('Path', 'User')
+}
+
+function Get-NodeMajor {
+  param([string]$version)
+  try { return [int](($version -replace '^v','').Split('.')[0]) } catch { return 0 }
+}
+
+# ─── Help output ──────────────────────────────────────────────────────────────
+
+function Print-Help {
+  Write-Host ""
+  Write-Host "Easy DevOps Bootstrap Installer" -ForegroundColor Cyan
+  Write-Host ""
+  Write-Host "Usage:"
+  Write-Host "  .\install.ps1 [OPTIONS]"
+  Write-Host ""
+  Write-Host "Options:"
+  Write-Host "  -Help            Print this help and exit"
+  Write-Host "  -Version <ver>   Skip the version picker; install specified Node.js major"
+  Write-Host "                   Example: -Version 20"
+  Write-Host "  -KeepNode        Skip Node.js management; use current Node.js on PATH"
+  Write-Host ""
+  Write-Host "Exit codes:"
+  Write-Host "  0  Installation completed successfully"
+  Write-Host "  1  Unrecoverable error"
+  Write-Host "  2  User cancelled"
+  Write-Host ""
+  Write-Host "Examples:"
+  Write-Host "  .\install.ps1                  # Interactive install"
+  Write-Host "  .\install.ps1 -Version 20      # Install Node.js 20.x"
+  Write-Host "  .\install.ps1 -KeepNode        # Skip Node.js management"
+  Write-Host ""
+}
+
+if ($Help) {
+  Print-Help
+  exit 0
+}
+
+# ─── BITS/WebClient download with progress ────────────────────────────────────
+
+function Download-File {
+  param([string]$Url, [string]$Dest, [string]$Label)
+
+  $bitsOK = $false
+  try { Import-Module BitsTransfer -ErrorAction Stop; $bitsOK = $true } catch {}
+
+  if ($bitsOK) {
+    try {
+      Write-Info "Downloading $Label..."
+      Start-BitsTransfer `
+        -Source      $Url  `
+        -Destination $Dest `
+        -DisplayName "Easy DevOps Installer" `
+        -Description "Downloading $Label" `
+        -ErrorAction Stop
+      return
+    } catch {
+      Write-Info "BITS unavailable, falling back to WebClient..."
+    }
+  }
+
+  Write-Info "Downloading $Label..."
+  $wc = New-Object System.Net.WebClient
+  $wc.Headers.Add('User-Agent', 'EasyDevOps-Installer/1.0')
+  try   { $wc.DownloadFile($Url, $Dest) }
+  finally { $wc.Dispose() }
+}
+
+# ─── Fetch Node.js LTS versions from nodejs.org ───────────────────────────────
+
+$script:ltsVersions = $null
+
+function Fetch-NodeVersions {
+  Write-Info "Fetching available Node.js LTS versions from nodejs.org..."
+
+  try {
+    $releases = Invoke-RestMethod -Uri "https://nodejs.org/dist/index.json" -TimeoutSec 20
+
+    $script:ltsVersions = $releases |
+      Where-Object { $_.lts -and $_.lts -ne $false } |
+      Group-Object { ($_.version -replace '^v(\d+)\..*', '$1') } |
+      ForEach-Object {
+        $_.Group | Sort-Object { [System.Version]($_.version -replace '^v','') } -Descending |
+                   Select-Object -First 1
+      } |
+      Sort-Object { [int]($_.version -replace '^v(\d+)\..*','$1') } -Descending |
+      Select-Object -First 6
+
+    if (-not $script:ltsVersions -or @($script:ltsVersions).Count -eq 0) {
+      Write-Warn "No LTS versions found in response."
+      return $false
+    }
+    return $true
+  } catch {
+    Write-Warn "Could not fetch version list: $_"
+    return $false
+  }
+}
+
+# ─── Interactive version picker ───────────────────────────────────────────────
+
+function Select-NodeVersion {
+  param([string]$CurrentVersion = "")
+
+  $list = @($script:ltsVersions)
+
+  Write-Host ""
+  Write-Host "  Available Node.js LTS versions:" -ForegroundColor Cyan
+  Write-Host ""
+
+  for ($i = 0; $i -lt $list.Count; $i++) {
+    $v       = $list[$i]
+    $ltsName = if ($v.lts -is [string] -and $v.lts) { "  ($($v.lts))" } else { "" }
+    $current = if ($CurrentVersion -and ($v.version -replace '^v(\d+)\..*','$1') -eq ($CurrentVersion -replace '^v(\d+)\..*','$1')) { "  [current]" } else { "" }
+    $def     = if ($i -eq 0) { " <- default" } else { "" }
+    Write-Host "    [$($i+1)] $($v.version)$ltsName$current$def" -ForegroundColor White
+  }
+
+  Write-Host ""
+
+  $majorVersion = $NODE_FALLBACK
+  while ($true) {
+    $raw = Read-Host "  Choose a version [1-$($list.Count), press Enter for default]"
+    if ([string]::IsNullOrWhiteSpace($raw)) { $raw = "1" }
+
+    if ($raw -match '^\d+$') {
+      $idx = [int]$raw - 1
+      if ($idx -ge 0 -and $idx -lt $list.Count) {
+        $majorVersion = ($list[$idx].version -replace '^v(\d+)\..*', '$1')
+        Write-OK "Selected $($list[$idx].version)"
+        return $majorVersion
+      }
+    }
+    Write-Warn "Please enter a number between 1 and $($list.Count)"
+  }
+}
+
+# ─── Detect install mode ──────────────────────────────────────────────────────
+# Source mode  = running from a git-cloned directory -> need npm install + link
+# Package mode = easy-devops already globally installed via npm
+
+$scriptDir    = Split-Path -Parent $MyInvocation.MyCommand.Path
+$isSourceMode = $true
+$existingCmd  = $null
+
+try {
+  $existingCmd = (& where.exe easy-devops 2>$null)
+  if ($LASTEXITCODE -eq 0 -and $existingCmd) {
+    $isSourceMode = $false
+  }
+} catch {}
+
+# ─── Banner ───────────────────────────────────────────────────────────────────
+
+Write-Host ""
+Write-Host "  ==========================================" -ForegroundColor Cyan
+Write-Host "    Easy DevOps  --  Windows Installer" -ForegroundColor Cyan
+Write-Host "  ==========================================" -ForegroundColor Cyan
+
+if (-not $isSourceMode) {
+  Write-Host ""
+  Write-Host "  Mode: package  (easy-devops already installed at $existingCmd)" -ForegroundColor DarkGray
+  Write-Host "        Skipping npm install / npm link steps." -ForegroundColor DarkGray
+} else {
+  Write-Host ""
+  Write-Host "  Mode: source  (installing from project directory)" -ForegroundColor DarkGray
+}
+
+# ─── Step 1: Detect system ───────────────────────────────────────────────────
+
+Write-Step "Detecting system"
+
+$osVer = [System.Environment]::OSVersion.Version
+if ($osVer.Major -lt 10) {
+  Write-Err "Windows 10 or later is required (found $($osVer.Major).$($osVer.Minor))"
+  exit 1
+}
+Write-OK "Windows $($osVer.Major).$($osVer.Minor)"
+Add-Result "System detection" $true "Windows $($osVer.Major).$($osVer.Minor)"
+
+if ($PSVersionTable.PSVersion.Major -lt 5) {
+  Write-Err "PowerShell 5.1+ is required (found $($PSVersionTable.PSVersion))"
+  exit 1
+}
+Write-OK "PowerShell $($PSVersionTable.PSVersion)"
+
+if (-not $KeepNode) {
+  try {
+    $null = Invoke-WebRequest -Uri "https://nodejs.org" -UseBasicParsing -TimeoutSec 10
+    Write-OK "Internet connectivity confirmed"
+  } catch {
+    Write-Err "No internet connection. Please check your network and try again."
+    exit 1
+  }
+}
+
+# Detect existing Node.js
+$nodeOK      = $false
+$nodeVersion = $null
+
+try {
+  $raw = (& node --version 2>$null).Trim()
+  if ($LASTEXITCODE -eq 0 -and $raw -match '^v') {
+    $nodeVersion = $raw
+    $major = Get-NodeMajor $nodeVersion
+    if ($major -ge $REQUIRED_NODE_MAJOR) {
+      Write-OK "Node.js $nodeVersion -- compatible"
+      $nodeOK = $true
+    } else {
+      Write-Warn "Node.js $nodeVersion found but v$REQUIRED_NODE_MAJOR+ is required"
+    }
+  } else {
+    Write-Info "Node.js not found on PATH"
+  }
+} catch {
+  Write-Info "Node.js not found on PATH"
+}
+
+# ─── Step 2: Fetch Node.js release list ──────────────────────────────────────
+
+$NODE_ACTION = ""    # keep | upgrade | switch
+$NODE_TARGET = ""    # major version string
+
+if ($KeepNode) {
+  Write-Step "Fetching Node.js release list"
+  Write-OK "Skipped (--KeepNode)"
+  Add-Result "Node.js release list" $true "Skipped (-KeepNode)"
+  $NODE_ACTION = "keep"
+} elseif ($Version -ne "") {
+  Write-Step "Fetching Node.js release list"
+  Write-OK "Skipped (-Version $Version specified)"
+  Add-Result "Node.js release list" $true "Skipped (-Version $Version)"
+  $NODE_ACTION = "switch"
+  $NODE_TARGET = $Version
+} else {
+  Write-Step "Fetching Node.js release list"
+  $fetchOK = Fetch-NodeVersions
+  if (-not $fetchOK) {
+    Write-Warn "Using fallback version $NODE_FALLBACK."
+    $script:ltsVersions = @([PSCustomObject]@{ version = "v$NODE_FALLBACK.0.0"; lts = "LTS" })
+  }
+  Add-Result "Node.js release list" $true "@($script:ltsVersions).Count LTS versions"
+}
+
+# ─── Step 3: Node.js version selection ───────────────────────────────────────
+
+if ($NODE_ACTION -eq "keep") {
+  Write-Step "Node.js version selection"
+  Write-OK "Skipped (-KeepNode)"
+  Add-Result "Node.js selection" $true "Skipped (-KeepNode)"
+} elseif ($Version -ne "") {
+  Write-Step "Node.js version selection"
+  Write-OK "Skipped (using -Version $Version)"
+  Add-Result "Node.js selection" $true "$Version"
+} else {
+  Write-Step "Node.js version selection"
+
+  if ($nodeOK) {
+    # Node >= 18 already installed: 3-option menu (mirrors install.sh)
+    Write-Host ""
+    Write-Host "  Node.js $nodeVersion is already installed." -ForegroundColor White
+    Write-Host "  What would you like to do?" -ForegroundColor White
+    Write-Host ""
+    Write-Host "    [1] Keep current version ($nodeVersion)"     -ForegroundColor White
+    Write-Host "    [2] Upgrade to latest LTS automatically"     -ForegroundColor White
+    Write-Host "    [3] Switch to a different version (picker)"  -ForegroundColor White
+    Write-Host ""
+
+    while ($true) {
+      $raw = Read-Host "  Enter 1, 2, or 3 (q to quit)"
+      switch ($raw.Trim()) {
+        "1" {
+          $NODE_ACTION = "keep"
+          $NODE_TARGET = ""
+          break
+        }
+        "2" {
+          $NODE_ACTION = "upgrade"
+          # Pick the newest LTS from the fetched list
+          $list = @($script:ltsVersions)
+          if ($list.Count -gt 0) {
+            $NODE_TARGET = ($list[0].version -replace '^v(\d+)\..*','$1')
+          } else {
+            $NODE_TARGET = $NODE_FALLBACK
+          }
+          Write-OK "Upgrading to latest LTS (major $NODE_TARGET)"
+          break
+        }
+        "3" {
+          $NODE_ACTION = "switch"
+          $NODE_TARGET = Select-NodeVersion -CurrentVersion $nodeVersion
+          break
+        }
+        { $_ -eq "q" -or $_ -eq "Q" } {
+          Write-Host ""
+          Write-Host "  Installation cancelled by user." -ForegroundColor Yellow
+          exit 2
+        }
+        default {
+          Write-Warn "Invalid choice. Please enter 1, 2, or 3."
+          continue
+        }
+      }
+      break
+    }
+
+    if ($NODE_ACTION -eq "keep") {
+      Write-OK "Keeping Node.js $nodeVersion"
+      Add-Result "Node.js selection" $true "Keep $nodeVersion"
+    } else {
+      Add-Result "Node.js selection" $true "$NODE_ACTION -> $NODE_TARGET"
+    }
+  } else {
+    # Node not installed or below 18: go straight to picker
+    if ($script:ltsVersions) {
+      $NODE_TARGET = Select-NodeVersion
+    } else {
+      $NODE_TARGET = $NODE_FALLBACK
+      Write-OK "Using default Node.js $NODE_TARGET"
+    }
+    $NODE_ACTION = "switch"
+    Add-Result "Node.js selection" $true "$NODE_TARGET"
+  }
+}
+
+# ─── Step 4: Install nvm-windows ─────────────────────────────────────────────
+
+$nvmReady   = $false
+$nvmVersion = $null
+
+if ($NODE_ACTION -eq "keep") {
+  Write-Step "Installing nvm-windows"
+  Write-OK "Skipped (keeping current Node.js)"
+  Add-Result "nvm-windows" $true "Skipped (keep)"
+  $nvmReady = $true
+} else {
+  Write-Step "Installing nvm-windows"
+
+  # Check if nvm-windows is already present
+  try {
+    $nvmVersion = (& nvm version 2>$null).Trim()
+    if ($LASTEXITCODE -eq 0 -and $nvmVersion) {
+      Write-OK "nvm-windows $nvmVersion already installed"
+      Add-Result "nvm-windows" $true $nvmVersion
+      $nvmReady = $true
+    }
+  } catch {}
+
+  if (-not $nvmReady) {
+    $skipNvm  = $false
+
+    if ($nodeOK) {
+      Write-Host ""
+      Write-Host "  nvm-windows is not installed." -ForegroundColor Yellow
+      Write-Host "  Required for 'nvm install $NODE_TARGET'. Install now?" -ForegroundColor Gray
+      Write-Host ""
+      $answer = Read-Host "  Install nvm-windows? [Y/n]"
+      if ($answer -match '^[Nn]') {
+        Write-Info "Skipping nvm-windows."
+        Add-Result "nvm-windows" $true "Skipped (optional)"
+        $skipNvm = $true
+      }
+    }
+
+    if (-not $skipNvm) {
+      $installer = "$env:TEMP\nvm-setup.exe"
+      $nvmUrl    = "https://github.com/coreybutler/nvm-windows/releases/download/$NVM_WINDOWS_VERSION/nvm-setup.exe"
+
+      try {
+        Download-File -Url $nvmUrl -Dest $installer -Label "nvm-windows $NVM_WINDOWS_VERSION"
+        Write-OK "Downloaded"
+      } catch {
+        Write-Err "Download failed: $_"
+        Write-Info "Manual: https://github.com/coreybutler/nvm-windows/releases"
+        Add-Result "nvm-windows" $false "Download failed"
+        if (-not $nodeOK) { exit 1 }
+      }
+
+      if (Test-Path $installer) {
+        try {
+          Write-Info "Running installer silently..."
+          $proc = Start-Process -FilePath $installer -ArgumentList '/S' -Wait -PassThru
+          if ($proc.ExitCode -ne 0) {
+            Write-Err "Installer exited with code $($proc.ExitCode)"
+            Add-Result "nvm-windows" $false "Exit code $($proc.ExitCode)"
+            if (-not $nodeOK) { exit 1 }
+          } else {
+            Write-OK "nvm-windows $NVM_WINDOWS_VERSION installed"
+            Add-Result "nvm-windows" $true $NVM_WINDOWS_VERSION
+            $nvmReady = $true
+          }
+        } catch {
+          Write-Err "Installer failed: $_"
+          Add-Result "nvm-windows" $false "$_"
+          if (-not $nodeOK) { exit 1 }
+        } finally {
+          try { Remove-Item $installer -Force -ErrorAction SilentlyContinue } catch {}
+        }
+
+        Refresh-Path
+      }
+    }
+  }
+}
+
+# ─── Step 5: Install Node.js via nvm ─────────────────────────────────────────
+
+if ($NODE_ACTION -eq "keep") {
+  Write-Step "Installing Node.js via nvm"
+  Write-OK "Skipped (keeping current Node.js)"
+  Add-Result "Node.js install" $true "Skipped (keep)"
+} else {
+  Write-Step "Installing Node.js via nvm"
+
+  if ($nvmReady -and -not $nodeOK) {
+    # No compatible Node.js: install chosen version
+    Write-Info "Installing Node.js $NODE_TARGET via nvm..."
+    try {
+      & nvm install $NODE_TARGET 2>&1 | ForEach-Object { Write-Info "  $_" }
+      & nvm use     $NODE_TARGET 2>&1 | ForEach-Object { Write-Info "  $_" }
+      Refresh-Path
+
+      $raw = (& node --version 2>$null).Trim()
+      if ($raw -match '^v') {
+        $nodeVersion = $raw
+        Write-OK "Node.js $nodeVersion installed and active"
+        Add-Result "Node.js install" $true $nodeVersion
+        $nodeOK = $true
+      } else {
+        Write-Warn "nvm install ran but node is not yet on PATH"
+        Write-Warn "Open a NEW terminal, then run:  nvm use $NODE_TARGET"
+        Add-Result "Node.js install" $false "PATH refresh needed -- open a new terminal"
+      }
+    } catch {
+      Write-Warn "nvm node install error: $_"
+      Write-Warn "Open a new terminal and run:  nvm install $NODE_TARGET"
+      Add-Result "Node.js install" $false "Manual step needed"
+    }
+  } elseif ($nvmReady -and $nodeOK -and ($NODE_ACTION -eq "upgrade" -or $NODE_ACTION -eq "switch")) {
+    # Upgrade or switch: install the selected version
+    Write-Info "Installing Node.js $NODE_TARGET via nvm..."
+    try {
+      & nvm install $NODE_TARGET 2>&1 | ForEach-Object { Write-Info "  $_" }
+      & nvm use     $NODE_TARGET 2>&1 | ForEach-Object { Write-Info "  $_" }
+      Refresh-Path
+
+      $raw = (& node --version 2>$null).Trim()
+      if ($raw -match '^v') {
+        $nodeVersion = $raw
+        Write-OK "Node.js $nodeVersion active"
+        Add-Result "Node.js install" $true $nodeVersion
+        $nodeOK = $true
+      } else {
+        Write-Warn "node not yet on PATH -- open a new terminal and run: nvm use $NODE_TARGET"
+        Add-Result "Node.js install" $false "PATH refresh needed"
+        $nodeOK = $false
+      }
+    } catch {
+      Write-Warn "nvm error: $_ -- open a new terminal and run: nvm use $NODE_TARGET"
+      Add-Result "Node.js install" $false "Manual step needed"
+      $nodeOK = $false
+    }
+  } elseif (-not $nvmReady -and $nodeOK) {
+    # nvm not available but Node >= 18 already present: skip
+    Write-OK "nvm not available; using existing Node.js $nodeVersion"
+    Add-Result "Node.js install" $true "Using existing $nodeVersion"
+  } else {
+    Write-Warn "No Node.js installed and nvm not available."
+    Write-Info "Install Node.js manually from: https://nodejs.org"
+    Add-Result "Node.js install" $false "Manual install required"
+  }
+}
+
+# ─── Source-mode steps ────────────────────────────────────────────────────────
+
+if (-not $isSourceMode) {
+  # Package mode: steps 6+7 skipped
+  Write-Step "Installing Easy DevOps dependencies"
+  Write-OK "Skipped (package mode -- easy-devops already installed)"
+  Add-Result "npm install" $true "Skipped (package mode)"
+
+  Write-Step "Registering global command"
+  Write-OK "Skipped (package mode)"
+  Add-Result "CLI registered" $true "Skipped (package mode)"
+} else {
+
+# ─── Step 6: npm install ─────────────────────────────────────────────────────
+
+Write-Step "Installing Easy DevOps dependencies"
+
+$packageJson = Join-Path $scriptDir "package.json"
+if (-not (Test-Path $packageJson)) {
+  Write-Err "package.json not found at: $packageJson"
+  Write-Err "Run this installer from the Easy DevOps project root."
+  exit 1
+}
+
+if (-not $nodeOK) {
+  Write-Warn "Skipping -- Node.js is not ready. Re-run install.ps1 after setting up Node.js."
+  Add-Result "npm install" $false "Skipped -- Node.js not ready"
+} else {
+  try {
+    Push-Location $scriptDir
+    Write-Info "Running npm install..."
+    & npm install
+    if ($LASTEXITCODE -ne 0) {
+      Write-Err "npm install failed (exit code $LASTEXITCODE)"
+      Add-Result "npm install" $false "Exit code $LASTEXITCODE"
+      exit 1
+    }
+    Write-OK "All dependencies installed"
+    Add-Result "npm install" $true ""
+  } catch {
+    Write-Err "npm install error: $_"
+    Add-Result "npm install" $false "$_"
+    exit 1
+  } finally {
+    Pop-Location
+  }
+}
+
+# ─── Step 7: npm link ────────────────────────────────────────────────────────
+
+Write-Step "Registering global command"
+
+if (-not $nodeOK) {
+  Write-Warn "Skipping -- Node.js is not ready"
+  Add-Result "CLI registered" $false "Skipped -- Node.js not ready"
+} else {
+  try {
+    Push-Location $scriptDir
+    & npm link
+    if ($LASTEXITCODE -ne 0) {
+      Write-Warn "npm link failed -- CLI won't be globally available"
+      Write-Warn "You can still run:  node cli/index.js"
+      Add-Result "CLI registered" $false "Exit code $LASTEXITCODE"
+    } else {
+      Write-OK "easy-devops command linked globally"
+      Add-Result "CLI registered" $true ""
+    }
+  } catch {
+    Write-Warn "npm link failed: $_ -- run: node cli/index.js"
+    Add-Result "CLI registered" $false "$_"
+  } finally {
+    Pop-Location
+  }
+}
+
+} # end source-mode block
+
+# ─── Summary (mirrors install.sh summary block) ───────────────────────────────
+
+Write-Host ""
+Write-Host "  ==========================================" -ForegroundColor Cyan
+Write-Host "    Installation Summary" -ForegroundColor Cyan
+Write-Host "  ==========================================" -ForegroundColor Cyan
+Write-Host ""
+
+$allOK = $true
+foreach ($r in $stepResults) {
+  if ($r.OK) {
+    $icon  = " OK "
+    $color = 'Green'
+  } else {
+    $icon  = "FAIL"
+    $color = 'Yellow'
+    $allOK = $false
+  }
+  $detail = if ($r.Detail) { "  ($($r.Detail))" } else { "" }
+  Write-Host "    [$icon]  $($r.Name)$detail" -ForegroundColor $color
+}
+
+Write-Host ""
+if ($allOK) {
+  Write-Host "  All steps completed successfully!" -ForegroundColor Green
+  Write-Host ""
+  Write-Host "  Run the CLI:" -ForegroundColor White
+  Write-Host "    easy-devops" -ForegroundColor Cyan
+} else {
+  Write-Host "  Some steps need attention -- see warnings above." -ForegroundColor Yellow
+  Write-Host ""
+  Write-Host "  Fallback:" -ForegroundColor White
+  Write-Host "    node cli/index.js" -ForegroundColor Cyan
+}
+Write-Host ""