🩹 [Patch]: Establish Settings as integration channel

.github/copilot-instructions.md

@@ -2,17 +2,18 @@
 
 ## Terminal Commands
 
-When executing terminal commands (using `run_in_terminal` or similar tools):
-
 - Prefer MCP server calls over command-line tools when possible.
-- **ALWAYS** send commands into `pwsh -Command` to ensure proper execution.
-  - These commands must be enclosed in single quotes.
-  - Escape any single quotes within the command by doubling them (e.g., `It's` becomes `It''s`).
-  - Use double quotes for string with variables or expressions inside the single-quoted command.
+- When running scripts within the [scripts](../.specify/scripts/) folder, just run them directly (shell is default PowerShell).
+- For other commands, send them into `pwsh -Command` to ensure proper execution.
+
+### Quoting in PowerShell
+
+Proper quoting is essential in PowerShell to prevent parsing errors and ensure correct command execution.
+
+- **Direct script execution**: Scripts run directly in PowerShell use standard PowerShell quoting rules. Double quotes expand variables and expressions, while single quotes are literal. No additional shell escaping is needed.
+
+- **Via `pwsh -Command`**: Commands are passed as strings to PowerShell. Enclose the entire command in single quotes to treat it as a literal string. Escape single quotes within the command by doubling them (e.g., `It's` becomes `It''s`). Use double quotes within the command for variable expansion, but ensure the outer single quotes protect the string from shell interpretation.
 
-## Other instructions
+For arguments containing single quotes, prefer double-quoting the argument inside the command string.
 
-| Tech       | Instruction file                                            |
-|------------|-------------------------------------------------------------|
-| PowerShell | [pwsh.instructions.md](./instructions/pwsh.instructions.md) |
-| Markdown   | [md.instructions.md](./instructions/md.instructions.md)     |
+Example: `pwsh -Command 'Write-Host "I''m Groot"'`

.github/workflows/AfterAll-ModuleLocal.yml

@@ -0,0 +1,56 @@
+name: AfterAll-ModuleLocal
+
+on:
+  workflow_call:
+    inputs:
+      Settings:
+        type: string
+        description: The complete settings object including test suites.
+        required: true
+
+permissions:
+  contents: read # to checkout the repo
+
+jobs:
+  AfterAll-ModuleLocal:
+    name: AfterAll-ModuleLocal
+    runs-on: ubuntu-latest
+    env:
+      SETTINGS: ${{ inputs.Settings }}
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+
+      - name: Run AfterAll Teardown Scripts
+        if: always()
+        uses: PSModule/GitHub-Script@8b9d2739d6896975c0e5448d2021ae2b94b6766a # v1.7.6
+        with:
+          Name: AfterAll-ModuleLocal
+          ShowInfo: false
+          ShowOutput: true
+          Debug: ${{ fromJson(inputs.Settings).Debug }}
+          Prerelease: ${{ fromJson(inputs.Settings).Prerelease }}
+          Verbose: ${{ fromJson(inputs.Settings).Verbose }}
+          Version: ${{ fromJson(inputs.Settings).Version }}
+          WorkingDirectory: ${{ fromJson(inputs.Settings).WorkingDirectory }}
+          Script: |
+            LogGroup "Running AfterAll Teardown Scripts" {
+                $afterAllScript = 'tests/AfterAll.ps1'
+
+                if (-not (Test-Path $afterAllScript)) {
+                    Write-Host "No AfterAll.ps1 script found at [$afterAllScript] - exiting successfully"
+                    exit 0
+                }
+
+                Write-Host "Running AfterAll teardown script: $afterAllScript"
+                try {
+                    & $afterAllScript
+                    Write-Host "AfterAll script completed successfully: $afterAllScript"
+                } catch {
+                    Write-Warning "AfterAll script failed: $afterAllScript - $_"
+                    # Don't throw for teardown scripts to ensure other cleanup scripts can run
+                }
+            }

.github/workflows/BeforeAll-ModuleLocal.yml

@@ -0,0 +1,55 @@
+name: BeforeAll-ModuleLocal
+
+on:
+  workflow_call:
+    inputs:
+      Settings:
+        type: string
+        description: The complete settings object including test suites.
+        required: true
+
+permissions:
+  contents: read # to checkout the repo
+
+jobs:
+  BeforeAll-ModuleLocal:
+    name: BeforeAll-ModuleLocal
+    runs-on: ubuntu-latest
+    env:
+      Settings: ${{ inputs.Settings }}
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+
+      - name: Run BeforeAll Setup Scripts
+        uses: PSModule/GitHub-Script@8b9d2739d6896975c0e5448d2021ae2b94b6766a # v1.7.6
+        with:
+          Name: BeforeAll-ModuleLocal
+          ShowInfo: false
+          ShowOutput: true
+          Debug: ${{ fromJson(inputs.Settings).Debug }}
+          Prerelease: ${{ fromJson(inputs.Settings).Prerelease }}
+          Verbose: ${{ fromJson(inputs.Settings).Verbose }}
+          Version: ${{ fromJson(inputs.Settings).Version }}
+          WorkingDirectory: ${{ fromJson(inputs.Settings).WorkingDirectory }}
+          Script: |
+            LogGroup "Running BeforeAll Setup Scripts" {
+                $beforeAllScript = 'tests/BeforeAll.ps1'
+
+                if (-not (Test-Path $beforeAllScript)) {
+                    Write-Host "No BeforeAll.ps1 script found at [$beforeAllScript] - exiting successfully"
+                    exit 0
+                }
+
+                Write-Host "Running BeforeAll setup script: $beforeAllScript"
+                try {
+                    & $beforeAllScript
+                    Write-Host "BeforeAll script completed successfully: $beforeAllScript"
+                } catch {
+                    Write-Error "BeforeAll script failed: $beforeAllScript - $_"
+                    throw
+                }
+            }

.github/workflows/Build-Docs.yml

@@ -3,40 +3,10 @@ name: Build-Docs
 on:
   workflow_call:
     inputs:
-      Name:
+      Settings:
         type: string
-        description: The name of the module to process. Scripts default to the repository name if nothing is specified.
-        required: false
-      Debug:
-        type: boolean
-        description: Enable debug output.
-        required: false
-        default: false
-      Verbose:
-        type: boolean
-        description: Enable verbose output.
-        required: false
-        default: false
-      Version:
-        type: string
-        description: Specifies the version of the GitHub module to be installed. The value must be an exact version.
-        required: false
-        default: ''
-      Prerelease:
-        type: boolean
-        description: Whether to use a prerelease version of the 'GitHub' module.
-        required: false
-        default: false
-      WorkingDirectory:
-        type: string
-        description: The working directory where the script will run from.
-        required: false
-        default: '.'
-      ShowSummaryOnSuccess:
-        type: boolean
-        description: Whether to show the super-linter summary on success.
-        required: false
-        default: false
+        description: The complete settings object.
+        required: true
 
 permissions:
   contents: read # to checkout the repo
@@ -57,30 +27,30 @@ jobs:
         uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
         with:
           name: module
-          path: ${{ inputs.WorkingDirectory }}/outputs/module
+          path: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/module
 
       - name: Document module
         uses: PSModule/Document-PSModule@15dc407c99e408fc0a4023d4f16aee2a5507ba74 # v1.0.12
         with:
-          Name: ${{ inputs.Name }}
-          WorkingDirectory: ${{ inputs.WorkingDirectory }}
+          Name: ${{ fromJson(inputs.Settings).Name }}
+          WorkingDirectory: ${{ fromJson(inputs.Settings).WorkingDirectory }}
 
       - name: Upload docs artifact
         uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
         with:
           name: docs
-          path: ${{ inputs.WorkingDirectory }}/outputs/docs
+          path: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/docs
           if-no-files-found: error
           retention-days: 1
 
       - name: Commit all changes
         uses: PSModule/GitHub-Script@8b9d2739d6896975c0e5448d2021ae2b94b6766a # v1.7.6
         with:
-          Debug: ${{ inputs.Debug }}
-          Prerelease: ${{ inputs.Prerelease }}
-          Verbose: ${{ inputs.Verbose }}
-          Version: ${{ inputs.Version }}
-          WorkingDirectory: ${{ inputs.WorkingDirectory }}
+          Debug: ${{ fromJson(inputs.Settings).Debug }}
+          Prerelease: ${{ fromJson(inputs.Settings).Prerelease }}
+          Verbose: ${{ fromJson(inputs.Settings).Verbose }}
+          Version: ${{ fromJson(inputs.Settings).Version }}
+          WorkingDirectory: ${{ fromJson(inputs.Settings).WorkingDirectory }}
           Script: |
             # Rename the gitignore file to .gitignore.bak
             if (Test-Path -Path .gitignore) {
@@ -106,8 +76,8 @@ jobs:
         env:
           RUN_LOCAL: true
           DEFAULT_BRANCH: main
-          DEFAULT_WORKSPACE: ${{ inputs.WorkingDirectory }}
-          FILTER_REGEX_INCLUDE: ${{ inputs.WorkingDirectory }}/outputs/docs
+          DEFAULT_WORKSPACE: ${{ fromJson(inputs.Settings).WorkingDirectory }}
+          FILTER_REGEX_INCLUDE: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/docs
           ENABLE_GITHUB_ACTIONS_GROUP_TITLE: true
           GITHUB_TOKEN: ${{ github.token }}
           VALIDATE_ALL_CODEBASE: true
@@ -123,7 +93,7 @@ jobs:
           SAVE_SUPER_LINTER_SUMMARY: true
 
       - name: Post super-linter summary
-        if: failure() || inputs.ShowSummaryOnSuccess == true
+        if: failure() || fromJson(inputs.Settings).Build.Docs.ShowSummaryOnSuccess == true
         shell: pwsh
         run: |
           $summaryPath = Join-Path $env:GITHUB_WORKSPACE 'super-linter-output' 'super-linter-summary.md'

.github/workflows/Build-Module.yml

@@ -3,20 +3,15 @@ name: Build-Module
 on:
   workflow_call:
     inputs:
-      Name:
+      Settings:
         type: string
-        description: The name of the module to process. Scripts default to the repository name if nothing is specified.
-        required: false
+        description: The settings object as a JSON string.
+        required: true
       ArtifactName:
         type: string
         description: Name of the artifact to upload.
         required: false
         default: module
-      WorkingDirectory:
-        type: string
-        description: The working directory where the script will run from.
-        required: false
-        default: '.'
 
 permissions:
   contents: read # to checkout the repository
@@ -37,6 +32,6 @@ jobs:
       - name: Build module
         uses: PSModule/Build-PSModule@fe8cc14a7192066cc46cb9514659772ebde05849 # v4.0.9
         with:
-          Name: ${{ inputs.Name }}
+          Name: ${{ fromJson(inputs.Settings).Name }}
           ArtifactName: ${{ inputs.ArtifactName }}
-          WorkingDirectory: ${{ inputs.WorkingDirectory }}
+          WorkingDirectory: ${{ fromJson(inputs.Settings).WorkingDirectory }}

.github/workflows/Build-Site.yml

@@ -3,35 +3,10 @@ name: Build-Site
 on:
   workflow_call:
     inputs:
-      Name:
+      Settings:
         type: string
-        description: The name of the module to process. Scripts default to the repository name if nothing is specified.
-        required: false
-      Debug:
-        type: boolean
-        description: Enable debug output.
-        required: false
-        default: false
-      Verbose:
-        type: boolean
-        description: Enable verbose output.
-        required: false
-        default: false
-      Version:
-        type: string
-        description: Specifies the version of the GitHub module to be installed. The value must be an exact version.
-        required: false
-        default: ''
-      Prerelease:
-        type: boolean
-        description: Whether to use a prerelease version of the 'GitHub' module.
-        required: false
-        default: false
-      WorkingDirectory:
-        type: string
-        description: The working directory where the script will run from.
-        required: false
-        default: '.'
+        description: The complete settings object.
+        required: true
 
 permissions:
   contents: read # to checkout the repo
@@ -54,7 +29,7 @@ jobs:
         uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
         with:
           name: docs
-          path: ${{ inputs.WorkingDirectory }}/outputs/docs
+          path: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/docs
 
       - name: Install mkdocs-material
         shell: pwsh
@@ -67,16 +42,16 @@ jobs:
       - name: Structure site
         uses: PSModule/GitHub-Script@8b9d2739d6896975c0e5448d2021ae2b94b6766a # v1.7.6
         with:
-          Debug: ${{ inputs.Debug }}
-          Prerelease: ${{ inputs.Prerelease }}
-          Verbose: ${{ inputs.Verbose }}
-          Version: ${{ inputs.Version }}
-          WorkingDirectory: ${{ inputs.WorkingDirectory }}
+          Debug: ${{ fromJson(inputs.Settings).Debug }}
+          Prerelease: ${{ fromJson(inputs.Settings).Prerelease }}
+          Verbose: ${{ fromJson(inputs.Settings).Verbose }}
+          Version: ${{ fromJson(inputs.Settings).Version }}
+          WorkingDirectory: ${{ fromJson(inputs.Settings).WorkingDirectory }}
           Script: |
             LogGroup "Get folder structure" {
                 $functionDocsFolder = New-Item -Path "outputs/site/docs/Functions" -ItemType Directory -Force
                 Copy-Item -Path "outputs/docs/*" -Destination "outputs/site/docs/Functions" -Recurse -Force
-                $moduleName = [string]::IsNullOrEmpty('${{ inputs.Name }}') ? $env:GITHUB_REPOSITORY_NAME : '${{ inputs.Name }}'
+                $moduleName = [string]::IsNullOrEmpty('${{ fromJson(inputs.Settings).Name }}') ? $env:GITHUB_REPOSITORY_NAME : '${{ fromJson(inputs.Settings).Name }}'
                 $ModuleSourcePath = Resolve-Path 'src' | Select-Object -ExpandProperty Path
                 $SiteOutputPath = Resolve-Path 'outputs/site' | Select-Object -ExpandProperty Path
 
@@ -162,7 +137,7 @@ jobs:
             }
 
       - name: Build mkdocs-material project
-        working-directory: ${{ inputs.WorkingDirectory }}/outputs/site
+        working-directory: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/site
         shell: pwsh
         run: |
           LogGroup 'Build docs - mkdocs build - content' {
@@ -176,5 +151,5 @@ jobs:
       - uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b # v4.0.0
         with:
           name: github-pages
-          path: ${{ inputs.WorkingDirectory }}/_site
+          path: ${{ fromJson(inputs.Settings).WorkingDirectory }}/_site
           retention-days: 1