Merge branch 'main' into feature/configurable-important-file-patterns

Author: MariusStorhaug

.github/workflows/Build-Module.yml

@@ -30,7 +30,7 @@ jobs:
           fetch-depth: 0
 
       - name: Build module
-        uses: PSModule/Build-PSModule@7a3ae1be38587e8051833d85ffa53c348de3cd0d # v4.0.13
+        uses: PSModule/Build-PSModule@345728124d201f371a8b0f1aacb98f89000a06dc # v4.0.14
         with:
           Name: ${{ fromJson(inputs.Settings).Name }}
           ArtifactName: ${{ inputs.ArtifactName }}

.github/workflows/Lint-Repository.yml

@@ -9,8 +9,9 @@ on:
         required: true
 
 permissions:
-  contents: read  # to checkout the repository
-  statuses: write # to update the status of the workflow from linter
+  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
 
 jobs:
   Lint-Repository:

.github/workflows/Test-Module.yml

@@ -63,7 +63,7 @@ jobs:
           path: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/module
 
       - name: Test-Module
-        uses: PSModule/Test-PSModule@d4d6d1d2ac1d243ca82c9c199371533e8d2220ef # v3.0.8
+        uses: PSModule/Test-PSModule@8c3337136dc7cf320da39eeb50e776d04bc9ac73 # v3.0.10
         with:
           Name: ${{ fromJson(inputs.Settings).Name }}
           Debug: ${{ fromJson(inputs.Settings).Debug }}

.github/workflows/Test-SourceCode.yml

@@ -27,7 +27,7 @@ jobs:
           fetch-depth: 0
 
       - name: Test-SourceCode
-        uses: PSModule/Test-PSModule@d4d6d1d2ac1d243ca82c9c199371533e8d2220ef # v3.0.8
+        uses: PSModule/Test-PSModule@8c3337136dc7cf320da39eeb50e776d04bc9ac73 # v3.0.10
         with:
           Debug: ${{ fromJson(inputs.Settings).Debug }}
           Prerelease: ${{ fromJson(inputs.Settings).Prerelease }}

README.md

@@ -163,6 +163,14 @@ The [PSModule - SourceCode tests](./scripts/tests/SourceCode/PSModule/PSModule.T
   - [PSModule framework settings for style and standards for modules](https://github.com/PSModule/Test-PSModule?tab=readme-ov-file#module-tests)
   - [PSScriptAnalyzer rules](https://github.com/PSModule/Invoke-ScriptAnalyzer)
 - This produces a JSON-based report that is used by [Get-PesterTestResults](#get-test-results) evaluate the results of the tests.
+- **Code coverage for framework-generated code**: This step collects code coverage for framework-generated
+  boilerplate. During the [build step](#build-module), [Build-PSModule](https://github.com/PSModule/Build-PSModule)
+  injects boilerplate code into the compiled `.psm1` file — including type accelerator registration for public classes
+  and enums, and the `OnRemove` cleanup hook. The framework tests in
+  [Test-PSModule](https://github.com/PSModule/Test-PSModule) exercise these code paths and produce coverage artifacts
+  that are aggregated with coverage from [Test-ModuleLocal](#test-module) in the
+  [Get code coverage](#get-code-coverage) step. This keeps framework-generated lines from counting against the module
+  author's coverage report.
 
 ### Test module
 
@@ -299,6 +307,9 @@ The [PSModule - Module tests](./scripts/tests/Module/PSModule/PSModule.Tests.ps1
 
 [workflow](./.github/workflows/Get-CodeCoverage.yml)
 - Gathers the code coverage from the previous steps and creates a summary of the results.
+- Aggregates coverage from the [Framework test](#framework-test) step (framework-generated boilerplate) and the
+  [Test module](#test-module) step (module author code). A command executed in either step counts as covered, so
+  framework-generated lines do not count against the module author's coverage target.
 - If the code coverage is below the target, the workflow will fail here.
 
 ### Publish module