Merge branch 'main' into create-pester-migration-skill

Author: MariusStorhaug

.github/actions/Get-PesterCodeCoverage/README.md

@@ -77,8 +77,12 @@ Summary:
 
 ## Requirements
 
-1. **Pester Code Coverage Reports**
+1. **Pester 6.1 Code Coverage Reports**
+
    Preceding steps must generate JSON coverage reports named `*-CodeCoverage*.json`
+   from the Pester 6.1 `CodeCoverage` result object. The action consumes
+   `CoveragePercent`, `CoveragePercentTarget`, `CommandsMissed`,
+   `CommandsExecuted`, and `FilesAnalyzed` plus their count properties.
 
 2. **GitHub CLI**
    The action uses `gh run download` to fetch artifacts from the current workflow run

.github/actions/Test-PSModule/action.yml

@@ -85,7 +85,7 @@ inputs:
     required: false
   CodeCoverage_OutputFormat:
     description: |
-      Format to use for code coverage report. Possible values: JaCoCo, CoverageGutters, Cobertura
+      Format to use for code coverage report. Possible values in Pester 6.1: JaCoCo or Cobertura.
     required: false
   CodeCoverage_OutputPath:
     description: |
@@ -113,7 +113,7 @@ inputs:
     required: false
   CodeCoverage_UseBreakpoints:
     description: |
-      EXPERIMENTAL: When false, use Profiler based tracer to do CodeCoverage instead of using breakpoints.
+      When false, use the profiler-based tracer instead of breakpoints for code coverage.
     required: false
   CodeCoverage_SingleHitBreakpoints:
     description: |
@@ -288,6 +288,7 @@ runs:
       with:
         Debug: ${{ inputs.Debug }}
         Verbose: ${{ inputs.Verbose }}
+        Version: '[6.1.0,7.0.0)'
         GitHubVersion: ${{ inputs.Version }}
         GitHubPrerelease: ${{ inputs.Prerelease }}
         WorkingDirectory: ${{ inputs.WorkingDirectory }}

.github/actions/Test-PSModule/src/tests/Module/PSModule/PSModule.Tests.ps1

@@ -43,7 +43,7 @@ if ($hasClassExporter) {
 
 
 # Run-phase setup — recompute from $Path so that It/Context blocks can use these variables.
-# Pester v5 Discovery and Run are separate executions. The script-scope variables above drive
+# Pester 6 Discovery and Run are separate executions. The script-scope variables above drive
 # -Skip and -ForEach during Discovery. This BeforeAll recomputes the same values for the Run
 # phase, where It blocks actually execute. The duplication is intentional and required.
 BeforeAll {

.github/workflows/Build-Docs.yml

@@ -10,7 +10,6 @@ on:
 
 permissions:
   contents: read # to checkout the repo
-  statuses: write # to create commit status
 
 jobs:
   Build-Docs:

.github/workflows/Lint-Repository.yml

@@ -9,9 +9,7 @@ on:
         required: true
 
 permissions:
-  contents: read       # to checkout the repository
-  statuses: write      # to update the status of the workflow from linter
-  pull-requests: write # to post super-linter summary comments on PRs
+  contents: read # to checkout the repository
 
 jobs:
   Lint-Repository:

.github/workflows/Plan.yml

@@ -64,7 +64,6 @@ on:
 
 permissions:
   contents: read # to checkout the repo
-  pull-requests: write # to add labels / comments to PRs
 
 jobs:
   Plan:

.github/workflows/Publish-Module.yml

@@ -25,8 +25,7 @@ jobs:
     name: Publish-Module
     runs-on: ubuntu-24.04
     permissions:
-      contents: write # Create releases and upload release artifacts.
-      pull-requests: write # Comment on pull requests.
+      contents: read # Checkout uses github.token.
     env:
       SETTINGS: ${{ inputs.Settings }}
     steps:

.github/workflows/Test-Actions.yml

@@ -34,13 +34,33 @@ jobs:
       - name: Install test dependencies
         shell: pwsh
         run: |
-          Install-PSResource -Name Pester -Version '[5.7.1,6.0.0)' -Repository PSGallery -TrustRepository
+          Install-PSResource -Name Pester -Version '[6.1.0,7.0.0)' -Repository PSGallery -TrustRepository
           Install-PSResource -Name PSSemVer -Repository PSGallery -TrustRepository
           Install-PSResource -Name GitHub -Version '[0.43.1,0.44.0)' -Repository PSGallery -TrustRepository
 
       - name: Run action unit tests
         shell: pwsh
         run: |
+          $configuration = New-PesterConfiguration
+          $configuration.Run.Shuffle = $true
+          $configuration.Run.ShuffleSeed = 42
+          $configuration.Run.Parallel = $true
+          $configuration.Run.ParallelThrottleLimit = 2
+          $configuration.Debug.ShowStartMarkers = $true
+
+          $expectedOptions = @{
+              'Run.Shuffle' = $configuration.Run.Shuffle.Value
+              'Run.ShuffleSeed' = $configuration.Run.ShuffleSeed.Value -eq 42
+              'Run.Parallel' = $configuration.Run.Parallel.Value
+              'Run.ParallelThrottleLimit' = $configuration.Run.ParallelThrottleLimit.Value -eq 2
+              'Debug.ShowStartMarkers' = $configuration.Debug.ShowStartMarkers.Value
+          }
+          foreach ($option in $expectedOptions.GetEnumerator()) {
+              if (-not $option.Value) {
+                  throw "Pester 6.1 configuration option [$($option.Key)] was not applied."
+              }
+          }
+
           $testPaths = Get-ChildItem -Path '.github/actions' -Directory |
               ForEach-Object { Join-Path -Path $_.FullName -ChildPath 'tests' } |
               Where-Object { Test-Path -Path $_ }

.github/workflows/Test-ModuleLocal.yml

@@ -72,9 +72,10 @@ jobs:
         uses: PSModule/Invoke-Pester@4ff33199141fdf22568990b6107fe3148ae93a1c # v5.1.0
         with:
           Debug: ${{ fromJson(inputs.Settings).Debug }}
-          Prerelease: ${{ fromJson(inputs.Settings).Prerelease }}
           Verbose: ${{ fromJson(inputs.Settings).Verbose }}
-          Version: ${{ fromJson(inputs.Settings).Version }}
+          Version: '[6.1.0,7.0.0)'
+          GitHubVersion: ${{ fromJson(inputs.Settings).Version }}
+          GitHubPrerelease: ${{ fromJson(inputs.Settings).Prerelease }}
           TestResult_TestSuiteName: ${{ matrix.TestName }}-${{ matrix.OSName }}
           TestResult_Enabled: true
           CodeCoverage_Enabled: true

.github/workflows/Workflow-Test-Default.yml

@@ -35,9 +35,7 @@ concurrency:
   cancel-in-progress: false
 
 permissions:
-  contents: write
-  pull-requests: write
-  statuses: write
+  contents: read
   pages: write
   id-token: write
 
@@ -66,6 +64,7 @@ jobs:
         ^\.github/workflows/(?!Release\.yml$|Linter\.yml$)
 
   VerifyRootFunctionsIndexDefault:
+    if: github.event.action != 'closed'
     name: Verify root Functions index [Default]
     runs-on: ubuntu-latest
     needs: