Feature/157 feature add codescene code coverage gates for pull requests (#159)

* #157 fix: add CodeScene PR coverage gates

 - add a reusable check-coverage action for cs-coverage check
 - run CodeScene coverage gates on pull requests in Tests.yml
 - keep the existing develop/manual CodeScene analysis flow
 - document the new PR gate behavior in the contributor docs and changelog

* #157 feat: Validate repository changelog with Test-KeepAChangelogFile

* feat(#157): update PR description generation requirements

- Add mandatory steps for reading prompt and template files
- Specify output structure and folder creation for PR descriptions

Author: stiwicourage

.github/prompts/pr-description.prompt.md

@@ -28,12 +28,22 @@ Analyze the provided input and:
 
 Be pragmatic: if information is missing, make reasonable assumptions but call them out briefly.
 
----
+Before generating the PR description, you MUST:
 
-## Output format
+- Read this prompt file from `.github/prompts/pr-description.prompt.md` directly, even if hidden folders were not
+  surfaced by an earlier search.
+- Read `.github/pull_request_template.md` directly and treat it as authoritative.
+- Resolve all relative paths from the repository root.
+- Treat `./pr-descriptions/` as a repository-root-relative output folder.
+- Never assume `.github/` content is missing just because a previous listing or glob search did not show hidden folders.
 
-You MUST return the PR description using this exact structure:
+---
 
-### Pull Request Template
+## Output format
 
-.github/pull_request_template.md
+You MUST return the PR description using this exact structure, you will find the template in
+`.github/pull_request_template.md`:
+You MUST fill in all sections, and you MUST NOT modify the template structure.
+You MUST create a *.md file in the `./pr-descriptions/` folder with the same name as the PR title, and write the
+generated description there.
+If the folder does not exist yet, you MUST create it under the repository root before writing the file.

.github/workflows/Tests.yml

@@ -33,6 +33,13 @@ jobs:
       - name: Run NovaModuleTools CI test and coverage workflow
         run: ./scripts/build/ci/Invoke-NovaModuleToolsCI.ps1 -OutputDirectory ./artifacts
 
+      - name: Validate repository changelog with Test-KeepAChangelogFile
+        run: |
+          $result = Test-KeepAChangelogFile -Path ./CHANGELOG.md
+          if (-not $result.IsValid) {
+            throw ($result.Errors -join [Environment]::NewLine)
+          }
+          
       - name: Upload CI artifacts
         if: always()
         uses: actions/upload-artifact@v4