Extract version parsing to shared function and improve error handling

- Created Get-VersionChangeType function in scripts/utils.ps1 (DRY principle)
- Updated vendor.yml and update.ps1 to use shared function
- Fixed numeric comparison for COUNT_UPDATED (fromJSON for proper numeric eval)
- Improved git operation error handling with proper exit code checking
- Only reset commit if it succeeded but push failed

Agent-Logs-Url: https://github.com/cmderdev/cmder/sessions/4511d497-599a-4a80-bc3c-12bd6f2d8191

Co-authored-by: DRSDavidSoft <4673812+DRSDavidSoft@users.noreply.github.com>

.github/workflows/build.yml

@@ -12,6 +12,7 @@ on:
       - "v*"
   pull_request:
     branches: [ "master", "development" ]
+  workflow_dispatch:
 
 #---------------------------------#
 #    environment configuration    #
@@ -47,31 +48,48 @@ jobs:
         $cmderVersion = Get-VersionStr
         $buildTime = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
 
-        # Determine branch link (handle PR merge refs)
-        $branchName = "${{ github.ref_name }}"
+        # Determine branch and PR information
+        $refName = "${{ github.ref_name }}"
+        $headRef = "${{ github.head_ref }}"
+        $eventName = "${{ github.event_name }}"
+        $prNumber = $null
+        $actualBranchName = $refName
         $branchLink = ""
-        if ($branchName -match '^(\d+)/(merge|head)$') {
-          # This is a PR merge/head ref, link to the PR
+        $prLink = ""
+
+        # Check if this is a PR merge ref (e.g., "3061/merge")
+        if ($refName -match '^(\d+)/(merge|head)$') {
           $prNumber = $Matches[1]
-          $branchLink = "https://github.com/${{ github.repository }}/pull/$prNumber"
-        } elseif ("${{ github.event_name }}" -eq "pull_request") {
-          # This is a pull request event, link to the PR
-          $branchLink = "https://github.com/${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
+          # Use head_ref for the actual branch name if available
+          if ($headRef) {
+            $actualBranchName = $headRef
+          }
+          $branchLink = "https://github.com/${{ github.repository }}/tree/$actualBranchName"
+          $prLink = "https://github.com/${{ github.repository }}/pull/$prNumber"
+        } elseif ($eventName -eq "pull_request") {
+          # This is a pull request event
+          $prNumber = "${{ github.event.pull_request.number }}"
+          if ($headRef) {
+            $actualBranchName = $headRef
+          }
+          $branchLink = "https://github.com/${{ github.repository }}/tree/$actualBranchName"
+          $prLink = "https://github.com/${{ github.repository }}/pull/$prNumber"
         } else {
           # Regular branch, link to the branch tree
-          $branchLink = "https://github.com/${{ github.repository }}/tree/${{ github.ref_name }}"
+          $branchLink = "https://github.com/${{ github.repository }}/tree/$refName"
         }
 
         $summary = @"
         ## 📦 Build Cmder - Workflow Summary
 
-        <small>Build started: $buildTime</small>
+        <small>Build started: ``$buildTime``</small>
 
         ### Repository Information
         | Property | Value |
         | --- | --- |
         | Repository | [``${{ github.repository }}``](https://github.com/${{ github.repository }}) |
-        | Branch | [``$branchName``]($branchLink) |
+        | Branch | [``$actualBranchName``]($branchLink) |
+        $(if ($prNumber) { "| Pull Request | [#$prNumber]($prLink) |" })
         | Commit | [``${{ github.sha }}``](https://github.com/${{ github.repository }}/commit/${{ github.sha }}) |
         | Actor | [@${{ github.actor }}](https://github.com/${{ github.actor }}) |
         | Workflow | ``${{ github.workflow }}`` |
@@ -79,18 +97,34 @@ jobs:
 
         ---
 
-        ### 📁 Vendor Packages
+        ### 🗃️ Vendor Packages ([sources.json](vendor/sources.json))
         | Package | Version |
         | --- | --- |
         "@
 
         # Read vendor sources.json and add to summary
-        $vendorSources = Get-Content "vendor/sources.json" | ConvertFrom-Json
+        $vendorSources = Get-Content -Raw "vendor/sources.json" | ConvertFrom-Json
         if ($vendorSources.Count -eq 0) {
           $summary += "`n| _No vendor packages found_ | |"
         } else {
           foreach ($vendor in $vendorSources) {
-            $summary += "`n| ``$($vendor.name)`` | $($vendor.version) |"
+            # Create release link based on vendor package
+            $versionLink = "$($vendor.version)"
+            if ($vendor.url) {
+              # Extract owner/repo/tag from the URL and create release link
+              # Handle both /releases/download/ and /archive/ URLs
+              if ($vendor.url -match 'github\.com/([^/]+)/([^/]+)/(releases/download|archive)/([^/]+)') {
+                $owner = $Matches[1]
+                $repo = $Matches[2]
+                $pathType = $Matches[3]
+                $tag = $Matches[4]
+                if ($pathType -eq 'archive') {
+                  $tag = $tag -replace '\.(?:tar\.gz|tgz|zip)$', ''
+                }
+                $versionLink = "[$($vendor.version)](https://github.com/$owner/$repo/releases/tag/$tag)"
+              }
+            }
+            $summary += "`n| ``$($vendor.name)`` | $versionLink |"
           }
         }
 
@@ -99,7 +133,7 @@ jobs:
         $summary | Add-Content -Path $env:GITHUB_STEP_SUMMARY -Encoding utf8
 
     - name: Add MSBuild to PATH
-      uses: microsoft/setup-msbuild@v2
+      uses: microsoft/setup-msbuild@v3
 
     - name: Build Cmder Launcher
       shell: pwsh
@@ -114,8 +148,6 @@ jobs:
 
         ---
 
-        ### Build Status
-
         ✅ Cmder built successfully.
 
         "@
@@ -128,29 +160,33 @@ jobs:
       run: .\pack.ps1 -verbose
 
     - name: Upload artifact (cmder.zip)
-      uses: actions/upload-artifact@v6
+      uses: actions/upload-artifact@v7
       with:
         path: build/cmder.zip
         name: cmder.zip
+        archive: false
         if-no-files-found: error
 
     - name: Upload artifact (cmder.7z)
-      uses: actions/upload-artifact@v6
+      uses: actions/upload-artifact@v7
       with:
         path: build/cmder.7z
         name: cmder.7z
+        archive: false
 
     - name: Upload artifact (cmder_mini.zip)
-      uses: actions/upload-artifact@v6
+      uses: actions/upload-artifact@v7
       with:
         path: build/cmder_mini.zip
         name: cmder_mini.zip
+        archive: false
 
     - name: Upload artifact (hashes.txt)
-      uses: actions/upload-artifact@v6
+      uses: actions/upload-artifact@v7
       with:
         path: build/hashes.txt
         name: hashes.txt
+        archive: false
 
     - name: Summary - Artifacts uploaded
       if: success()
@@ -158,56 +194,29 @@ jobs:
       env:
         GH_TOKEN: ${{ github.token }}
       run: |
-        $summary = @"
+        # Source utility functions
+        . scripts/utils.ps1
 
-        ---
+        $summary = @"
 
         ### 🗃️ Artifacts
 
-        | Artifact | Size | Download | Hash (SHA256) |
-        | --- | --- | --- | --- |
+        | Artifact | Size | Hash (SHA256) |
+        | --- | --- | --- |
         "@
 
-        # Function to get artifact download URL with retry logic
-        function Get-ArtifactDownloadUrl {
-          param(
-            [string]$ArtifactName,
-            [int]$MaxRetries = 3,
-            [int]$DelaySeconds = 2
-          )
+        # Get all files from the build directory (excluding directories and hidden files)
+        if (Test-Path "build") {
+          $buildFiles = Get-ChildItem -Path "build" -File | Where-Object { -not $_.Name.StartsWith('.') } | Sort-Object Name
 
-          for ($i = 0; $i -lt $MaxRetries; $i++) {
-            try {
-              # Use GitHub CLI to get artifact information
-              $artifactsJson = gh api "repos/${{ github.repository }}/actions/runs/${{ github.run_id }}/artifacts" --jq ".artifacts[] | select(.name == `"$ArtifactName`")"
-
-              if ($artifactsJson) {
-                $artifact = $artifactsJson | ConvertFrom-Json
-                if ($artifact.archive_download_url) {
-                  return $artifact.archive_download_url
-                }
-              }
-            } catch {
-              Write-Host "Attempt $($i + 1) failed to get artifact URL for $ArtifactName : $_"
-            }
-
-            if ($i -lt ($MaxRetries - 1)) {
-              Start-Sleep -Seconds $DelaySeconds
-            }
-          }
-
-          return $null
-        }
-
-        $artifacts = @("cmder.zip", "cmder.7z", "cmder_mini.zip", "hashes.txt")
-        foreach ($artifact in $artifacts) {
-          $path = "build/$artifact"
-          if (Test-Path $path) {
-            $size = (Get-Item $path).Length / 1MB
+          foreach ($file in $buildFiles) {
+            $artifact = $file.Name
+            $path = $file.FullName
+            $sizeFormatted = Format-FileSize -Bytes $file.Length
             $hash = (Get-FileHash $path -Algorithm SHA256).Hash
 
             # Try to get the actual artifact download URL
-            $downloadUrl = Get-ArtifactDownloadUrl -ArtifactName $artifact
+            $downloadUrl = Get-ArtifactDownloadUrl -ArtifactName $artifact -Repository "${{ github.repository }}" -RunId "${{ github.run_id }}"
             $warning = ""
 
             if (-not $downloadUrl) {
@@ -219,13 +228,13 @@ jobs:
             # Determine emoji based on file type
             if ($artifact -match '\.txt$') {
               $emoji = "📄"
-            } elseif ($artifact -match '\.(zip|7z)$') {
+            } elseif ($artifact -match '\.(zip|rar|7z)$') {
               $emoji = "🗄️"
             } else {
               $emoji = "📦"
             }
 
-            $summary += "`n| $emoji ``$artifact`` | $([math]::Round($size, 2)) MB | [📥 Download$warning]($downloadUrl) | ``$hash`` |"
+            $summary += "`n| $emoji [``$artifact``$warning]($downloadUrl) | $sizeFormatted | ``$hash`` |"
           }
         }
         $summary += "`n"

.github/workflows/codeql.yml

@@ -79,7 +79,7 @@ jobs:
         # queries: security-extended,security-and-quality
 
     - name: Add MSBuild to PATH
-      uses: microsoft/setup-msbuild@v2
+      uses: microsoft/setup-msbuild@v3
 
     - name: Build Cmder Launcher
       shell: pwsh

.github/workflows/tests.yml

@@ -79,8 +79,11 @@ jobs:
         # Get vendor versions from sources.json
         $vendorInfo = @()
         $sources = Get-Content "vendor\sources.json" -Raw | ConvertFrom-Json
-        $vendorDirs = $sources.PSObject.Properties | ForEach-Object { $_.Name }
-        foreach ($dir in $vendorDirs) {
+        foreach ($source in $sources) {
+          $dir = $source.name
+          if (-not $dir) {
+            continue
+          }
           $versionFile = "vendor/$dir/.cmderver"
           if (Test-Path $versionFile) {
             $version = Get-Content $versionFile -Raw
@@ -100,7 +103,7 @@ jobs:
           if ($vendorInfo.Count -eq 0) {
             $summary += "_No vendor version information available._"
           } else {
-            $summary += $vendorInfo -join '`n'
+            $summary += $vendorInfo -join "`n"
           }
         )
 
@@ -121,34 +124,64 @@ jobs:
 
     - name: Testing Clink Shell
       id: test-clink
+      shell: pwsh
       run: |
+          $startTime = Get-Date
           cmd /c vendor\init.bat /v /d /t
+          $duration = [math]::Round(((Get-Date) - $startTime).TotalSeconds, 2)
+          echo "duration=$duration" >> $env:GITHUB_OUTPUT
 
     - name: Summary - Clink Shell test
       if: success()
       shell: pwsh
       run: |
-        "| Clink Shell | ✅ Passed | Cmd shell initialization |" | Add-Content -Path $env:GITHUB_STEP_SUMMARY -Encoding utf8
+        $duration = "${{ steps.test-clink.outputs.duration }}"
+        if ($duration) {
+          $duration = "$duration s"
+        } else {
+          $duration = "N/A"
+        }
+        "| Clink Shell | ✅ Passed | $duration |" | Add-Content -Path $env:GITHUB_STEP_SUMMARY -Encoding utf8
     - name: Testing PowerShell
       id: test-powershell
+      shell: pwsh
       run: |
+          $startTime = Get-Date
           PowerShell.exe -ExecutionPolicy Bypass -NoLogo -NoProfile -Command "$env:CMDER_DEBUG='1'; . 'vendor\profile.ps1'"
+          $duration = [math]::Round(((Get-Date) - $startTime).TotalSeconds, 2)
+          echo "duration=$duration" >> $env:GITHUB_OUTPUT
 
     - name: Summary - PowerShell test
       if: success()
       shell: pwsh
       run: |
-        "| PowerShell | ✅ Passed | Profile script execution |" | Add-Content -Path $env:GITHUB_STEP_SUMMARY -Encoding utf8
+        $duration = "${{ steps.test-powershell.outputs.duration }}"
+        if ($duration) {
+          $duration = "$duration s"
+        } else {
+          $duration = "N/A"
+        }
+        "| PowerShell | ✅ Passed | $duration |" | Add-Content -Path $env:GITHUB_STEP_SUMMARY -Encoding utf8
     - name: Testing Bash
       id: test-bash
+      shell: pwsh
       run: |
+          $startTime = Get-Date
           bash vendor/cmder.sh
+          $duration = [math]::Round(((Get-Date) - $startTime).TotalSeconds, 2)
+          echo "duration=$duration" >> $env:GITHUB_OUTPUT
 
     - name: Summary - Bash test
       if: success()
       shell: pwsh
       run: |
-        "| Bash | ✅ Passed | Bash environment initialization |" | Add-Content -Path $env:GITHUB_STEP_SUMMARY -Encoding utf8
+        $duration = "${{ steps.test-bash.outputs.duration }}"
+        if ($duration) {
+          $duration = "$duration s"
+        } else {
+          $duration = "N/A"
+        }
+        "| Bash | ✅ Passed | $duration |" | Add-Content -Path $env:GITHUB_STEP_SUMMARY -Encoding utf8
 
     - name: Summary - All tests completed
       if: success()

.github/workflows/vendor.yml

@@ -6,6 +6,10 @@ on:
   # At 13:37 UTC every day.
   - cron: '37 13 * * *'
 
+concurrency:
+  group: vendor-update
+  cancel-in-progress: false
+
 defaults:
   run:
     shell: pwsh
@@ -45,76 +49,245 @@ jobs:
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       run: |
-        $currentVersion = (Get-Content .\vendor\sources.json | ConvertFrom-Json)
-        . .\scripts\update.ps1 -verbose
-        Set-GHVariable -Name COUNT_UPDATED -Value $count
-        $newVersion = (Get-Content .\vendor\sources.json | ConvertFrom-Json)
-        $listUpdated = ""
-        $updateMessage = "| Name | Old Version | New Version |`n| :--- | ---- | ---- |`n"
-        foreach ($s in $newVersion) {
-          $oldVersion = ($currentVersion | Where-Object {$_.name -eq $s.name}).version
-          if ($s.version -ne $oldVersion) {
-            $repoUrl = ($repoUrl = $s.Url.Replace("/archive/", "/releases/")).Substring(0, $repoUrl.IndexOf("/releases/")) + "/releases"
-            $listUpdated += "$($s.name) v$($s.version), "
-            $updateMessage += "| **[$($s.name)]($repoUrl)** | $oldVersion | **$($s.version)** |`n"
-          }
-        }
-        if ($count -eq 0) { return }
-        Set-GHVariable -Name LIST_UPDATED -Value $listUpdated.Trim(', ')
+          $currentVersion = (Get-Content -Raw .\vendor\sources.json | ConvertFrom-Json)
+          . .\scripts\update.ps1 -verbose
 
-        echo "UPDATE_MESSAGE<<<EOF`n$updateMessage`n<EOF" | Out-File -FilePath $env:GITHUB_ENV -Append -Encoding utf8
+          # Export count of updated packages (update.ps1 is expected to set $count)
+          if (-not ($count)) { $count = 0 }
+          Set-GHVariable -Name COUNT_UPDATED -Value $count
+
+          $newVersion = (Get-Content -Raw .\vendor\sources.json | ConvertFrom-Json)
+          # Source utility functions
+          . scripts/utils.ps1
+
+          $listUpdated = ""
+          $updateMessage = "| Name | Old Version | New Version |`n| :--- | :---: | :---: |`n"
+          $majorUpdates = @()
+          $singleDepName = ""
+          $singleDepOldVersion = ""
+          $singleDepNewVersion = ""
+          foreach ($s in $newVersion) {
+            $oldVersion = ($currentVersion | Where-Object {$_.name -eq $s.name}).version
+            if ($s.version -ne $oldVersion) {
+              $repoUrl = ($repoUrl = $s.Url.Replace("/archive/", "/releases/")).Substring(0, $repoUrl.IndexOf("/releases/")) + "/releases"
+
+              # Store single dependency info for messages (only if this is the only update)
+              if ($count -eq 1) {
+                $singleDepName = $s.name
+                $singleDepOldVersion = $oldVersion
+                $singleDepNewVersion = $s.version
+              }
+
+              # Determine change type and emoji using shared function
+              $result = Get-VersionChangeType -OldVersion $oldVersion -NewVersion $s.version
+              $changeType = $result.ChangeType
+              $emoji = $result.Emoji
+              $isMajor = $result.IsMajor
+
+              # Track major updates for changelog section
+              if ($isMajor) {
+                $compareUrl = "$repoUrl/compare/v$oldVersion...v$($s.version)"
+                $majorUpdates += @{
+                  name = $s.name
+                  oldVersion = $oldVersion
+                  newVersion = $s.version
+                  compareUrl = $compareUrl
+                  repoUrl = $repoUrl
+                }
+              }
+
+              $listUpdated += "$($s.name) v$($s.version), "
+              $updateMessage += "| $emoji **[$($s.name)]($repoUrl)** | \`$oldVersion\` | **\`$($s.version)\`** |`n"
+            }
+          }
+
+          if ($count -eq 0) { return }
+
+          Set-GHVariable -Name LIST_UPDATED -Value $listUpdated.Trim(', ')
+          # Set single dependency variables (they will only be used if COUNT_UPDATED is 1)
+          # Use safe fallback values in case variables weren't set (shouldn't happen but prevents errors)
+          if ([string]::IsNullOrEmpty($singleDepName) -and $count -eq 1) {
+            # This shouldn't happen, but if it does, log a warning
+            Write-Warning "Single dependency name not set despite count being 1"
+            $singleDepName = "unknown-package"
+            $singleDepOldVersion = "unknown"
+            $singleDepNewVersion = "unknown"
+          } elseif ([string]::IsNullOrEmpty($singleDepName)) {
+            # For multiple dependencies, set placeholder values (won't be used)
+            $singleDepName = ""
+            $singleDepOldVersion = ""
+            $singleDepNewVersion = ""
+          }
+
+          Set-GHVariable -Name SINGLE_DEP_NAME -Value $singleDepName
+          Set-GHVariable -Name SINGLE_DEP_OLD_VERSION -Value $singleDepOldVersion
+          Set-GHVariable -Name SINGLE_DEP_NEW_VERSION -Value $singleDepNewVersion
+
+          # Write multiline UPDATE_MESSAGE to GITHUB_ENV
+          ## echo "UPDATE_MESSAGE<<EOF`n$updateMessage`nEOF" | Out-File -FilePath $env:GITHUB_ENV -Append -Encoding utf8
+          Add-Content -Path $env:GITHUB_ENV -Value "UPDATE_MESSAGE<<EOF"
+          Add-Content -Path $env:GITHUB_ENV -Value $updateMessage
+          Add-Content -Path $env:GITHUB_ENV -Value "EOF"
+
+          # Generate major updates changelog section and export
+          if ($majorUpdates.Count -gt 0) {
+            $changelogSection = "`n<details>`n<summary>🔥 Major version updates - View changelog</summary>`n`n"
+            foreach ($update in $majorUpdates) {
+              $changelogSection += "### [$($update.name)]($($update.repoUrl))`n"
+              $changelogSection += "**$($update.oldVersion)** → **$($update.newVersion)**`n`n"
+              $changelogSection += "- [View full changelog]($($update.compareUrl))`n"
+              $changelogSection += "- [Release notes]($($update.repoUrl)/tag/v$($update.newVersion))`n`n"
+            }
+            $changelogSection += "</details>`n"
+
+            Add-Content -Path $env:GITHUB_ENV -Value "CHANGELOG_SECTION<<EOF"
+            Add-Content -Path $env:GITHUB_ENV -Value $changelogSection
+            Add-Content -Path $env:GITHUB_ENV -Value "EOF"
+            Add-Content -Path $env:GITHUB_ENV -Value "HAS_BREAKING_CHANGES=True"
+          } else {
+            Add-Content -Path $env:GITHUB_ENV -Value "CHANGELOG_SECTION="
+            Add-Content -Path $env:GITHUB_ENV -Value "HAS_BREAKING_CHANGES=False"
+          }
 
     - name: Summary - Update check results
       shell: pwsh
       run: |
         $count = [int]$env:COUNT_UPDATED
+
         if ($count -eq 0) {
           $summary = @"
           ### ✅ No Updates Available
 
-          All vendor dependencies are up to date.
+          All vendor dependencies are up to date! 🎉
           "@
         } else {
           $word = if ($count -eq 1) { 'dependency' } else { 'dependencies' }
           $summary = @"
           ### 🔄 Updates Found
 
-          **$count** vendor $word updated:
-
-          $env:UPDATE_MESSAGE
-
           "@
+          $summary += '📦 **' + $env:SINGLE_DEP_NAME + '** updated from `' + $env:SINGLE_DEP_OLD_VERSION + '` to `' + $env:SINGLE_DEP_NEW_VERSION + '`' + "`n" + "`n"
+          $summary += '📦 **' + $count + '** vendor ' + $word + ' updated:' + "`n" + "`n"
+        }
+
+        $summary += $env:UPDATE_MESSAGE + "`n"
+
+        # Check if we can auto-merge (only minor/patch changes)
+        $hasBreaking = $env:HAS_BREAKING_CHANGES -eq 'True'
+        if ($hasBreaking) {
+          $summary += '> ⚠️ **Note:** This update contains major version changes that may include breaking changes.'
+        } else {
+          $summary += '> ℹ️ **Note:** This update only contains minor or patch changes.'
         }
 
         $summary | Add-Content -Path $env:GITHUB_STEP_SUMMARY -Encoding utf8
 
-    - uses: peter-evans/create-pull-request@v7
-      if: env.COUNT_UPDATED > 0
+    - name: Auto-merge minor updates
+      if: env.COUNT_UPDATED > 0 && env.HAS_BREAKING_CHANGES != 'True'
+      shell: pwsh
+      run: |
+        try {
+          echo "### 🚀 Auto-merging Updates" >> $env:GITHUB_STEP_SUMMARY
+          echo "" >> $env:GITHUB_STEP_SUMMARY
+          echo "Attempting to automatically merge non-breaking changes to master..." >> $env:GITHUB_STEP_SUMMARY
+
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+          # Commit the changes
+          git add vendor/sources.json
+          $commitResult = git commit -m "⬆️ Update dependencies ($env:LIST_UPDATED)"
+          $commitSuccess = $LASTEXITCODE -eq 0
+
+          if ($commitSuccess) {
+            # Push directly to master
+            git push origin HEAD:master
+            $pushSuccess = $LASTEXITCODE -eq 0
+
+            if ($pushSuccess) {
+              echo "" >> $env:GITHUB_STEP_SUMMARY
+              echo "✅ **Success!** Updates have been automatically merged to master." >> $env:GITHUB_STEP_SUMMARY
+              echo "" >> $env:GITHUB_STEP_SUMMARY
+              echo "**Updated dependencies:** $env:LIST_UPDATED" >> $env:GITHUB_STEP_SUMMARY
+
+              # Set a flag to skip PR creation
+              echo "AUTO_MERGED=true" | Out-File -FilePath $env:GITHUB_ENV -Append -Encoding utf8
+            } else {
+              throw "Failed to push to master (exit code: $LASTEXITCODE)"
+            }
+          } else {
+            throw "Failed to commit changes (exit code: $LASTEXITCODE)"
+          }
+        } catch {
+          echo "" >> $env:GITHUB_STEP_SUMMARY
+          echo "⚠️ **Warning:** Unable to automatically merge updates." >> $env:GITHUB_STEP_SUMMARY
+          echo "" >> $env:GITHUB_STEP_SUMMARY
+          echo "**Error:** $($_.Exception.Message)" >> $env:GITHUB_STEP_SUMMARY
+          echo "" >> $env:GITHUB_STEP_SUMMARY
+          echo "Falling back to creating a pull request..." >> $env:GITHUB_STEP_SUMMARY
+
+          Write-Warning "Failed to auto-merge: $($_.Exception.Message)"
+
+          # Only reset if commit was successful but push failed
+          if ($commitSuccess -and -not $pushSuccess) {
+            try {
+              git reset --hard HEAD~1
+              if ($LASTEXITCODE -ne 0) {
+                Write-Warning "Failed to reset commit (exit code: $LASTEXITCODE), continuing with PR creation"
+              }
+            } catch {
+              Write-Warning "Failed to reset commit: $($_.Exception.Message), continuing with PR creation"
+            }
+          }
+
+          # Set flag to create PR instead
+          echo "AUTO_MERGED=false" | Out-File -FilePath $env:GITHUB_ENV -Append -Encoding utf8
+        }
+
+    - uses: peter-evans/create-pull-request@v8
+      if: fromJSON(env.COUNT_UPDATED) > 0 && (env.HAS_BREAKING_CHANGES == 'True' || env.AUTO_MERGED == 'false')
       with:
-        title: 'Updates to `${{ env.COUNT_UPDATED }}` vendored dependencies'
+        title: ${{ env.COUNT_UPDATED == 1 && format('⬆️ Update {0}', env.LIST_UPDATED) || format('⬆️ Update {0} vendored dependencies', env.COUNT_UPDATED) }}
         body: |
-          ### Automatically updated `${{ env.COUNT_UPDATED }}` dependencies:
+          ### ${{ env.COUNT_UPDATED == 1 && format('📦 Updated {0} from `{1}` to `{2}`', env.SINGLE_DEP_NAME, env.SINGLE_DEP_OLD_VERSION, env.SINGLE_DEP_NEW_VERSION) || format('📦 Automatically updated `{0}` dependencies', env.COUNT_UPDATED) }}
+
           ${{ env.UPDATE_MESSAGE }}
+
+          ${{ env.CHANGELOG_SECTION }}
+
           ---
-          Please verify and then **Merge** the pull request to update.
+
+          ${{ env.HAS_BREAKING_CHANGES == 'True' && '⚠️ **This update contains major version changes that may include breaking changes.**' || 'ℹ️ This update only contains minor or patch changes.' }}
+
+          Please verify and then **Merge** the pull request to apply the updates.
         commit-message: '⬆️ Update dependencies (${{ env.LIST_UPDATED }})'
         branch: update-vendor
         base: master
 
     - name: Summary - Pull request created
-      if: env.COUNT_UPDATED > 0
+      if: env.COUNT_UPDATED > 0 && (env.HAS_BREAKING_CHANGES == 'True' || env.AUTO_MERGED == 'false')
       shell: pwsh
       run: |
-        $Summary = @"
+        $summary = @"
         ### 🎉 Pull Request Created
 
         A pull request has been created to update the vendor dependencies.
 
         **Branch:** ``update-vendor``
 
-        **Updated dependencies:** $env:LIST_UPDATED
+        $(if (-not [string]::IsNullOrEmpty($env:LIST_UPDATED)) { "**Updated dependencies:** $env:LIST_UPDATED" } else { "**Updated dependencies:** " })
 
+        "@
+
+        if ($env:HAS_BREAKING_CHANGES -eq 'True') {
+          $summary += "> ⚠️ **Manual review required:** This update contains major version changes."
+        } else {
+          $summary += "> ℹ️ **Note:** Auto-merge failed, manual review required."
+        }
+
+        $summary += @"
         > Please review and merge the pull request to apply the updates.
+
         "@
 
         $summary | Add-Content -Path $env:GITHUB_STEP_SUMMARY -Encoding utf8

scripts/pack.ps1

@@ -70,7 +70,7 @@ if ($PSCmdlet.MyInvocation.BoundParameters["Verbose"].IsPresent) {
 foreach ($t in $targets.GetEnumerator()) {
     Create-Archive "$cmderRoot" "$saveTo\$($t.Name)" $t.Value
     $hash = (Digest-Hash "$saveTo\$($t.Name)")
-    Add-Content -path "$saveTo\hashes.txt" -value ($t.Name + ' ' + $hash)
+    Add-Content -path "$saveTo\hashes.txt" -value ($t.Name + "`t" + $hash)
 }
 
 Pop-Location

scripts/update.ps1

@@ -259,6 +259,8 @@ function Fetch-DownloadUrl {
 }
 
 $count = 0
+$hasBreakingChanges = $false
+$updateDetails = @()
 
 # Read the current sources content
 $sources = Get-Content $sourcesPath | Out-String | ConvertFrom-Json
@@ -301,6 +303,26 @@ foreach ($s in $sources) {
         # }
 
         $count++
+
+        # Analyze version change type using shared function
+        $result = Get-VersionChangeType -OldVersion $s.version -NewVersion $version
+        $changeType = $result.ChangeType
+        
+        # Determine if this is a breaking change
+        if ($changeType -eq "downgrade" -or $changeType -eq "major") {
+            $hasBreakingChanges = $true
+        } elseif ($changeType -eq "unknown") {
+            # If version parsing failed, treat as potentially breaking
+            $hasBreakingChanges = $true
+            Write-Verbose "Could not parse version as semantic version for dependency '$($s.name)' (old: '$($s.version)', new: '$version'), treating as potentially breaking"
+        }
+
+        $updateDetails += @{
+            name = $s.name
+            oldVersion = $s.version
+            newVersion = $version
+            changeType = $changeType
+        }
     }
 
     $s.url = $downloadUrl
@@ -314,12 +336,16 @@ if ($count -eq 0) {
     return
 }
 
+# Export update details for GitHub Actions
+if ($Env:GITHUB_ACTIONS -eq 'true') {
+    $updateDetailsJson = $updateDetails | ConvertTo-Json -Compress
+    Write-Output "UPDATE_DETAILS=$updateDetailsJson" | Out-File -FilePath $env:GITHUB_ENV -Append -Encoding utf8
+    Write-Output "HAS_BREAKING_CHANGES=$hasBreakingChanges" | Out-File -FilePath $env:GITHUB_ENV -Append -Encoding utf8
+    Write-Output "::notice title=Task Complete::Successfully updated $count dependencies."
+}
+
 if ($Env:APPVEYOR -eq 'True') {
     Add-AppveyorMessage -Message "Successfully updated $count dependencies." -Category Information
 }
 
-if ($Env:GITHUB_ACTIONS -eq 'true') {
-    Write-Output "::notice title=Task Complete::Successfully updated $count dependencies."
-}
-
 Write-Host -ForegroundColor green "Successfully updated $count dependencies."

scripts/utils.ps1

@@ -249,3 +249,201 @@ function Download-File {
     $wc.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials;
     $wc.DownloadFile($Url, $File)
 }
+
+function Format-FileSize {
+    <#
+    .SYNOPSIS
+    Formats a file size in bytes to a human-readable string using binary units.
+    
+    .DESCRIPTION
+    Converts file sizes to appropriate binary units (B, KiB, MiB, GiB) for better readability.
+    
+    .PARAMETER Bytes
+    The file size in bytes to format.
+    
+    .EXAMPLE
+    Format-FileSize -Bytes 1024
+    Returns "1.00 KiB"
+    
+    .EXAMPLE
+    Format-FileSize -Bytes 15728640
+    Returns "15.00 MiB"
+    #>
+    param(
+        [Parameter(Mandatory = $true)]
+        [double]$Bytes
+    )
+    
+    if ($Bytes -ge 1GB) {
+        return "{0:N2} GiB" -f ($Bytes / 1GB)
+    } elseif ($Bytes -ge 1MB) {
+        return "{0:N2} MiB" -f ($Bytes / 1MB)
+    } elseif ($Bytes -ge 1KB) {
+        return "{0:N2} KiB" -f ($Bytes / 1KB)
+    } else {
+        return "{0:N0} B" -f $Bytes
+    }
+}
+
+function Get-VersionChangeType {
+    <#
+    .SYNOPSIS
+    Analyzes version changes using semantic versioning to determine the type of update and appropriate emoji.
+    
+    .DESCRIPTION
+    Parses old and new version strings, compares them using semantic versioning rules,
+    and returns information about the change type, emoji indicator, and whether it's a major update.
+    
+    .PARAMETER OldVersion
+    The previous version string (e.g., "1.2.3" or "2.52.0.windows.1").
+    
+    .PARAMETER NewVersion
+    The new version string (e.g., "1.3.0" or "3.0.0.windows.1").
+    
+    .OUTPUTS
+    Returns a hashtable with the following keys:
+    - ChangeType: "major", "minor", "patch", "downgrade", or "unknown"
+    - Emoji: The corresponding emoji indicator (🔥, 🚀, ⬆️, or 🔄)
+    - IsMajor: Boolean indicating if this is a major version update
+    
+    .EXAMPLE
+    $result = Get-VersionChangeType -OldVersion "1.2.3" -NewVersion "2.0.0"
+    # Returns: @{ ChangeType = "major"; Emoji = "🔥"; IsMajor = $true }
+    
+    .EXAMPLE
+    $result = Get-VersionChangeType -OldVersion "1.2.3" -NewVersion "1.3.0"
+    # Returns: @{ ChangeType = "minor"; Emoji = "🚀"; IsMajor = $false }
+    #>
+    param(
+        [Parameter(Mandatory = $true)]
+        [string]$OldVersion,
+        
+        [Parameter(Mandatory = $true)]
+        [string]$NewVersion
+    )
+    
+    $changeType = "unknown"
+    $emoji = "🔄"
+    $isMajor = $false
+    
+    try {
+        # Handle versions with more than 4 parts and strip pre-release identifiers
+        $oldVerStr = $OldVersion.Split('-')[0]
+        $newVerStr = $NewVersion.Split('-')[0]
+        
+        # Split by dots and take only numeric parts, first 4 max
+        $oldParts = $oldVerStr.Split('.') | Where-Object { $_ -match '^\d+$' } | Select-Object -First 4
+        $newParts = $newVerStr.Split('.') | Where-Object { $_ -match '^\d+$' } | Select-Object -First 4
+        
+        # Ensure we have at least 2 parts (major.minor) for semantic versioning
+        if ($oldParts.Count -ge 2 -and $newParts.Count -ge 2) {
+            $oldVerParseable = $oldParts -join '.'
+            $newVerParseable = $newParts -join '.'
+            
+            $oldVer = [System.Version]::Parse($oldVerParseable)
+            $newVer = [System.Version]::Parse($newVerParseable)
+            
+            if ($newVer -lt $oldVer) {
+                $changeType = "downgrade"
+                # Don't set emoji for downgrades in this function - caller handles it
+            } elseif ($newVer.Major -gt $oldVer.Major) {
+                $changeType = "major"
+                $emoji = "🔥"
+                $isMajor = $true
+            } elseif ($newVer.Minor -gt $oldVer.Minor) {
+                $changeType = "minor"
+                $emoji = "🚀"
+            } elseif ($newVer -gt $oldVer) {
+                $changeType = "patch"
+                $emoji = "⬆️"
+            } else {
+                # No version increase detected (versions are equal)
+                $changeType = "unknown"
+                $emoji = "🔄"
+            }
+        } else {
+            # Not enough numeric parts for semantic versioning
+            throw "Not enough numeric version parts"
+        }
+    } catch {
+        # If semantic versioning fails, return unknown
+        $changeType = "unknown"
+        $emoji = "🔄"
+        $isMajor = $false
+    }
+    
+    return @{
+        ChangeType = $changeType
+        Emoji = $emoji
+        IsMajor = $isMajor
+    }
+}
+
+function Get-ArtifactDownloadUrl {
+    <#
+    .SYNOPSIS
+    Retrieves the download URL for a GitHub Actions artifact with retry logic.
+    
+    .DESCRIPTION
+    Uses the GitHub CLI to fetch artifact information from the GitHub API with automatic retries.
+    Falls back to returning $null if all attempts fail.
+    
+    .PARAMETER ArtifactName
+    The name of the artifact to retrieve the download URL for.
+    
+    .PARAMETER Repository
+    The GitHub repository in the format "owner/repo".
+    
+    .PARAMETER RunId
+    The GitHub Actions workflow run ID.
+    
+    .PARAMETER MaxRetries
+    Maximum number of retry attempts. Default is 3.
+    
+    .PARAMETER DelaySeconds
+    Delay in seconds between retry attempts. Default is 2.
+    
+    .EXAMPLE
+    Get-ArtifactDownloadUrl -ArtifactName "cmder.zip" -Repository "cmderdev/cmder" -RunId "123456789"
+    
+    .EXAMPLE
+    Get-ArtifactDownloadUrl -ArtifactName "build-output" -Repository "owner/repo" -RunId "987654321" -MaxRetries 5 -DelaySeconds 3
+    #>
+    param(
+        [Parameter(Mandatory = $true)]
+        [string]$ArtifactName,
+        
+        [Parameter(Mandatory = $true)]
+        [string]$Repository,
+        
+        [Parameter(Mandatory = $true)]
+        [string]$RunId,
+        
+        [int]$MaxRetries = 3,
+        [int]$DelaySeconds = 2
+    )
+    
+    for ($i = 0; $i -lt $MaxRetries; $i++) {
+        try {
+            # Use GitHub CLI to get artifact information
+            $artifactsJson = gh api "repos/$Repository/actions/runs/$RunId/artifacts" --jq ".artifacts[] | select(.name == `"$ArtifactName`")"
+            
+            if ($artifactsJson) {
+                $artifact = $artifactsJson | ConvertFrom-Json
+                if ($artifact.id) {
+                    # Construct browser-accessible GitHub Actions artifact download URL
+                    # Format: https://github.com/owner/repo/actions/runs/{run_id}/artifacts/{artifact_id}
+                    return "https://github.com/$Repository/actions/runs/$RunId/artifacts/$($artifact.id)"
+                }
+            }
+        } catch {
+            Write-Host "Attempt $($i + 1) failed to get artifact URL for $ArtifactName : $_"
+        }
+        
+        if ($i -lt ($MaxRetries - 1)) {
+            Start-Sleep -Seconds $DelaySeconds
+        }
+    }
+    
+    return $null
+}