attempt to add a verification which checks if version in the repo matches the release tag

Author: eosfor

.github/workflows/publish.yml

@@ -19,6 +19,49 @@ jobs:
         with:
           fetch-depth: 0
 
+      # --- Manual Version Reminder / Guard ---
+      - name: Verify manifest version matches release tag (manual update reminder)
+        if: github.event_name == 'release'
+        shell: pwsh
+        run: |
+          $tag = "$env:GITHUB_REF" -replace '^refs/tags/', ''
+          if (-not $tag) { Write-Error 'No tag ref found.'; exit 1 }
+          $tagCore = $tag -replace '^v',''
+          if ($tagCore -notmatch '^([0-9]+\.[0-9]+\.[0-9]+)(?:-([A-Za-z0-9\-]+))?$') {
+            Write-Error "Tag '$tag' has invalid format. Use vX.Y.Z or vX.Y.Z-suffix"; exit 1
+          }
+          $expectedVersion = $Matches[1]
+          $expectedPrerelease = $Matches[2]
+          $psd1Path = Join-Path $PWD 'PSGraph/PSQuickGraph.psd1'
+          if (-not (Test-Path $psd1Path)) { Write-Error 'PSQuickGraph.psd1 not found.'; exit 1 }
+          $raw = Get-Content $psd1Path -Raw
+          $moduleVersion = ($raw | Select-String -Pattern "ModuleVersion\s*=\s*'([^']+)'" -AllMatches).Matches.Groups[1].Value
+          $prLine = ($raw | Select-String -Pattern "^\s*Prerelease\s*=\s*'([^']+)'" -AllMatches)
+          $manifestPrerelease = if ($prLine) { $prLine.Matches.Groups[1].Value } else { $null }
+          $ok = $true
+          if ($moduleVersion -ne $expectedVersion) {
+            Write-Host "::error::Manifest ModuleVersion ($moduleVersion) does not match tag version ($expectedVersion)."; $ok = $false
+          }
+          if ($expectedPrerelease) {
+            if ($manifestPrerelease -ne $expectedPrerelease) {
+              Write-Host "::error::Manifest Prerelease ('$manifestPrerelease') does not match tag prerelease ('$expectedPrerelease')."; $ok = $false
+            }
+          } else {
+            if ($manifestPrerelease) {
+              Write-Host "::warning::Manifest has Prerelease '$manifestPrerelease' but tag is a stable release."; $ok = $false
+            }
+          }
+          if (-not $ok) {
+            Write-Host '--- Manual Action Required ---'
+            Write-Host 'Update PSGraph/PSQuickGraph.psd1 with:'
+            Write-Host "  ModuleVersion = '$expectedVersion'"
+            if ($expectedPrerelease) { Write-Host "  Prerelease    = '$expectedPrerelease'" } else { Write-Host '  (Remove/Comment any Prerelease entry)' }
+            Write-Host 'Commit the change and recreate the release (or re-run after fixing).'
+            exit 1
+          } else {
+            Write-Host "Manifest version check passed ($moduleVersion${if($manifestPrerelease){"-$manifestPrerelease"}})."
+          }
+
       - name: Setup .NET Core SDK ${{ matrix.dotnet-version }}
         uses: actions/setup-dotnet@v3
         with: