Merge branch 'main' into coverage-missed-paths-upstream

MariusStorhaug · web-flow · commit 6ebfd44d2782 · 2026-08-08T18:47:51.000+02:00
diff --git a/.github/workflows/AfterAll-ModuleLocal.yml b/.github/workflows/AfterAll-ModuleLocal.yml
@@ -26,13 +26,12 @@ jobs:
       SETTINGS: ${{ inputs.Settings }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-          fetch-depth: 0
 
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
diff --git a/.github/workflows/BeforeAll-ModuleLocal.yml b/.github/workflows/BeforeAll-ModuleLocal.yml
@@ -26,13 +26,12 @@ jobs:
       Settings: ${{ inputs.Settings }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-          fetch-depth: 0
 
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
diff --git a/.github/workflows/Build-Docs.yml b/.github/workflows/Build-Docs.yml
@@ -18,13 +18,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-          fetch-depth: 0
 
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
@@ -83,9 +82,8 @@ jobs:
         uses: super-linter/super-linter/slim@4ce20838b8ab83717e78138c5b3a1407148e0918 # v8.7.0
         env:
           RUN_LOCAL: true
-          DEFAULT_BRANCH: main
           DEFAULT_WORKSPACE: ${{ fromJson(inputs.Settings).WorkingDirectory }}
-          FILTER_REGEX_INCLUDE: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/docs
+          FILTER_REGEX_INCLUDE: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/docs/.*\.(md|markdown)$
           ENABLE_GITHUB_ACTIONS_GROUP_TITLE: true
           GITHUB_TOKEN: ${{ github.token }}
           VALIDATE_ALL_CODEBASE: true
@@ -98,6 +96,7 @@ jobs:
           VALIDATE_MARKDOWN_PRETTIER: false
           VALIDATE_YAML_PRETTIER: false
           ENABLE_GITHUB_ACTIONS_STEP_SUMMARY: false
+          USE_FIND_ALGORITHM: true
           SAVE_SUPER_LINTER_SUMMARY: true
 
       - name: Post super-linter summary
diff --git a/.github/workflows/Build-Module.yml b/.github/workflows/Build-Module.yml
@@ -24,13 +24,12 @@ jobs:
       GH_TOKEN: ${{ github.token }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-          fetch-depth: 0
 
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
diff --git a/.github/workflows/Build-Site.yml b/.github/workflows/Build-Site.yml
@@ -17,13 +17,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-          fetch-depth: 0
 
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
diff --git a/.github/workflows/Get-CodeCoverage.yml b/.github/workflows/Get-CodeCoverage.yml
@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
diff --git a/.github/workflows/Get-TestResults.yml b/.github/workflows/Get-TestResults.yml
@@ -22,7 +22,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
diff --git a/.github/workflows/Lint-Repository.yml b/.github/workflows/Lint-Repository.yml
@@ -21,10 +21,9 @@ jobs:
       Settings: ${{ inputs.Settings }}
     steps:
       - name: Checkout repo
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-          fetch-depth: 0
 
       - name: Load dynamic envs
         shell: pwsh
@@ -56,6 +55,7 @@ jobs:
           FILTER_REGEX_INCLUDE: ${{ fromJson(env.Settings).WorkingDirectory }}
           FILTER_REGEX_EXCLUDE: ${{ fromJson(env.Settings).WorkingDirectory }}/src/classes/public/.*\.ps1$
           ENABLE_GITHUB_ACTIONS_STEP_SUMMARY: false
+          USE_FIND_ALGORITHM: true
           SAVE_SUPER_LINTER_SUMMARY: true
 
       - name: Post super-linter summary
diff --git a/.github/workflows/Lint-SourceCode.yml b/.github/workflows/Lint-SourceCode.yml
@@ -21,7 +21,7 @@ jobs:
         include: ${{ fromJson(inputs.Settings).Test.SourceCode.Suites }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
 
diff --git a/.github/workflows/Linter.yml b/.github/workflows/Linter.yml
@@ -2,7 +2,9 @@ name: Linter
 
 run-name: "Linter - [${{ github.event.pull_request.title }} #${{ github.event.pull_request.number }}] by @${{ github.actor }}"
 
-on: [pull_request]
+on:
+  pull_request:
+  workflow_dispatch:
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -19,10 +21,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repo
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-          fetch-depth: 0
 
       - name: Lint code base
         uses: super-linter/super-linter@4ce20838b8ab83717e78138c5b3a1407148e0918 # v8.7.0
@@ -31,7 +32,9 @@ jobs:
           FILTER_REGEX_EXCLUDE: 'tests/src(TestRepo|WithManifestTestRepo)/src/classes/public/.*\.ps1$'
           VALIDATE_BIOME_FORMAT: false
           VALIDATE_GITHUB_ACTIONS: false
+          VALIDATE_GITHUB_ACTIONS_ZIZMOR: false
           VALIDATE_JSCPD: false
           VALIDATE_JSON_PRETTIER: false
           VALIDATE_MARKDOWN_PRETTIER: false
           VALIDATE_YAML_PRETTIER: false
+          USE_FIND_ALGORITHM: true
diff --git a/.github/workflows/Plan.yml b/.github/workflows/Plan.yml
@@ -67,13 +67,12 @@ jobs:
       Settings: ${{ steps.Enrich-Settings.outputs.Settings }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-          fetch-depth: 0
 
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
diff --git a/.github/workflows/Publish-Module.yml b/.github/workflows/Publish-Module.yml
@@ -24,13 +24,12 @@ jobs:
       SETTINGS: ${{ inputs.Settings }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-          fetch-depth: 0
 
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
diff --git a/.github/workflows/Release.yml b/.github/workflows/Release.yml
@@ -32,7 +32,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repo
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
 
diff --git a/.github/workflows/Test-Actions.yml b/.github/workflows/Test-Actions.yml
@@ -24,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repo
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
 
diff --git a/.github/workflows/Test-Module.yml b/.github/workflows/Test-Module.yml
@@ -21,12 +21,12 @@ jobs:
         include: ${{ fromJson(inputs.Settings).Test.PSModule.Suites }}
     steps:
       - name: Checkout repository
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
 
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
@@ -59,7 +59,7 @@ jobs:
         include: ${{ fromJson(inputs.Settings).Test.PSModule.Suites }}
     steps:
       - name: Checkout repository
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
 
diff --git a/.github/workflows/Test-ModuleLocal.yml b/.github/workflows/Test-ModuleLocal.yml
@@ -31,13 +31,12 @@ jobs:
         include: ${{ fromJson(inputs.Settings).Test.Module.Suites }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-          fetch-depth: 0
 
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
diff --git a/.github/workflows/Test-SourceCode.yml b/.github/workflows/Test-SourceCode.yml
@@ -21,13 +21,12 @@ jobs:
         include: ${{ fromJson(inputs.Settings).Test.SourceCode.Suites }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-          fetch-depth: 0
 
       - name: Checkout Process-PSModule
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ job.workflow_repository }}
           ref: ${{ job.workflow_sha }}
diff --git a/.github/workflows/Workflow-Test-Default.yml b/.github/workflows/Workflow-Test-Default.yml
@@ -8,6 +8,7 @@ on:
     paths:
       - '.github/actions/**'
       - '.github/workflows/**'
+      - 'tests/srcTestRepo/**'
       - '!.github/workflows/Release.yml'
       - '!.github/workflows/Linter.yml'
   schedule:
@@ -46,3 +47,46 @@ jobs:
         ^README\.md$
         ^\.github/actions/
         ^\.github/workflows/(?!Release\.yml$|Linter\.yml$)
+
+  VerifyRootFunctionsIndexDefault:
+    name: Verify root Functions index [Default]
+    runs-on: ubuntu-latest
+    needs:
+      - WorkflowTestDefault
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+
+      - name: Download docs artifact
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c
+        with:
+          name: docs
+          path: tests/srcTestRepo/outputs/docs
+
+      - name: Verify root Functions index is published
+        shell: pwsh
+        run: |
+          $path = 'tests/srcTestRepo/outputs/docs/index.md'
+          if (-not (Test-Path -Path $path)) {
+              throw 'Expected root Functions index at ' +
+                  'tests/srcTestRepo/outputs/docs/index.md.'
+          }
+
+          $content = Get-Content -Path $path -Raw
+          $expectedSnippets = @(
+              '# Functions'
+              'This landing page is authored from the root of ' +
+              '`src/functions/public`.'
+              'Use it to introduce the module''s function surface ' +
+              'before readers drill into each group.'
+          )
+
+          foreach ($snippet in $expectedSnippets) {
+              if (-not $content.Contains($snippet)) {
+                  throw 'Expected snippet not found in generated root ' +
+                      "Functions index: $snippet"
+              }
+          }
diff --git a/.github/workflows/Workflow-Test-WithManifest.yml b/.github/workflows/Workflow-Test-WithManifest.yml
@@ -8,6 +8,7 @@ on:
     paths:
       - '.github/actions/**'
       - '.github/workflows/**'
+      - 'tests/srcWithManifestTestRepo/**'
       - '!.github/workflows/Release.yml'
       - '!.github/workflows/Linter.yml'
   schedule:
@@ -46,3 +47,46 @@ jobs:
         ^README\.md$
         ^\.github/actions/
         ^\.github/workflows/(?!Release\.yml$|Linter\.yml$)
+
+  VerifyRootFunctionsIndexWithManifest:
+    name: Verify root Functions index [WithManifest]
+    runs-on: ubuntu-latest
+    needs:
+      - WorkflowTestWithManifest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+
+      - name: Download docs artifact
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c
+        with:
+          name: docs
+          path: tests/srcWithManifestTestRepo/outputs/docs
+
+      - name: Verify root Functions index is published
+        shell: pwsh
+        run: |
+          $path = 'tests/srcWithManifestTestRepo/outputs/docs/index.md'
+          if (-not (Test-Path -Path $path)) {
+              throw 'Expected root Functions index at ' +
+                  'tests/srcWithManifestTestRepo/outputs/docs/index.md.'
+          }
+
+          $content = Get-Content -Path $path -Raw
+          $expectedSnippets = @(
+              '# Functions'
+              'This landing page is authored from the root of ' +
+              '`src/functions/public`.'
+              'Use it to introduce the module''s function surface ' +
+              'before readers drill into each group.'
+          )
+
+          foreach ($snippet in $expectedSnippets) {
+              if (-not $content.Contains($snippet)) {
+                  throw 'Expected snippet not found in generated root ' +
+                      "Functions index: $snippet"
+              }
+          }
diff --git a/AGENTS.md b/AGENTS.md
diff --git a/tests/srcTestRepo/src/functions/public/index.md b/tests/srcTestRepo/src/functions/public/index.md
diff --git a/tests/srcWithManifestTestRepo/src/functions/public/index.md b/tests/srcWithManifestTestRepo/src/functions/public/index.md
