Merge branch 'main' into audit-process-workflows

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/plugin/README.md

@@ -0,0 +1,42 @@
+# PSModule process plugin
+
+This repository hosts the `psmodule` GitHub Copilot CLI marketplace and its
+`psmodule` plugin. The marketplace and plugin are owned and released
+with the PSModule process.
+
+## Install through the marketplace
+
+Register this repository's marketplace and install the plugin:
+
+```console
+copilot plugin marketplace add https://github.com/PSModule/Process-PSModule.git
+copilot plugin install psmodule
+```
+
+## Install directly
+
+Install the plugin directly from this repository:
+
+```console
+copilot plugin install PSModule/Process-PSModule:.github/plugin/psmodule
+```
+
+The plugin provides the
+[`psmodule-pester-migration`](./psmodule/skills/psmodule-pester-migration/SKILL.md)
+skill for migrating every Pester test set in a PSModule repository to Pester
+6.1.0, and the
+[`psmodule-v8-upgrade`](./psmodule/skills/psmodule-v8-upgrade/SKILL.md)
+skill for upgrading Process-PSModule consumer repositories to framework v8.
+It also provides
+[`psmodule-zensical-migration`](./psmodule/skills/psmodule-zensical-migration/SKILL.md)
+for migrating legacy MkDocs sites to the Process-PSModule Zensical design.
+Verify the installation with:
+
+```console
+copilot plugin list
+/skills list
+```
+
+The marketplace catalog is in [`marketplace.json`](./marketplace.json), and
+plugin metadata is in
+[`plugin.json`](./psmodule/plugin.json).

.github/plugin/marketplace.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/marketplace.schema.json",
+  "name": "psmodule",
+  "owner": {
+    "name": "PSModule"
+  },
+  "metadata": {
+    "description": "Agent plugins for the PSModule repository process.",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "psmodule",
+      "description": "PSModule process guidance and reusable skills for PowerShell module repositories.",
+      "version": "1.0.0",
+      "source": ".github/plugin/psmodule"
+    }
+  ]
+}

.github/plugin/psmodule/plugin.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "psmodule",
+  "description": "PSModule process guidance and reusable skills for PowerShell module repositories.",
+  "version": "1.0.0",
+  "author": {
+    "name": "PSModule",
+    "url": "https://github.com/PSModule"
+  },
+  "homepage": "https://psmodule.io/docs/",
+  "repository": "https://github.com/PSModule/Process-PSModule",
+  "license": "MIT",
+  "keywords": [
+    "powershell",
+    "psmodule",
+    "pester",
+    "testing",
+    "github-actions"
+  ],
+  "skills": "skills/"
+}