perf(scripts): scope, batch, and deduplicate markdown link checks

.github/workflows/README.md

@@ -143,7 +143,7 @@ authorized manual actions. Local validation does not execute or verify them.
 | `frontmatter-validation.yml` | Custom PS script         | YAML frontmatter validation          | `soft-fail` (false), `changed-files-only` (true), `skip-footer-validation` (false), `warnings-as-errors` (true) | frontmatter-validation-results |
 | `skill-validation.yml`       | Custom PS script         | Skill directory structure validation | `soft-fail` (false), `changed-files-only` (true)                                                                | skill-validation-results       |
 | `link-lang-check.yml`        | Custom PS script         | Detect language-specific URLs        | `soft-fail` (false)                                                                                             | link-lang-check-results        |
-| `markdown-link-check.yml`    | markdown-link-check      | Validate links (internal/external)   | `soft-fail` (true)                                                                                              | markdown-link-check-results    |
+| `markdown-link-check.yml`    | markdown-link-check      | Validate links (internal/external)   | `soft-fail` (true), `changed-files-only` (true), `throttle-limit` (8)                                           | markdown-link-check-results    |
 
 All validation workflows use `permissions: contents: read`, publish PR annotations, and retain artifacts for 30 days.
 

.github/workflows/markdown-link-check.yml

@@ -10,6 +10,21 @@ on:
         required: false
         type: boolean
         default: false
+      changed-files-only:
+        description: 'Only validate markdown files changed against the base branch'
+        required: false
+        type: boolean
+        default: true
+      base-branch:
+        description: 'Base branch or SHA for change detection (defaults to origin/main)'
+        required: false
+        type: string
+        default: ''
+      throttle-limit:
+        description: 'Maximum number of markdown files checked concurrently'
+        required: false
+        type: number
+        default: 8
 
 permissions:
   contents: read
@@ -25,6 +40,7 @@ jobs:
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
+          fetch-depth: 0
 
       - name: Setup Node.js
         uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
@@ -43,8 +59,19 @@ jobs:
       - name: Run markdown link check
         id: link-check
         shell: pwsh
+        env:
+          BASE_BRANCH: ${{ inputs.base-branch }}
+          CHANGED_FILES_ONLY: ${{ inputs.changed-files-only }}
+          THROTTLE_LIMIT: ${{ inputs.throttle-limit }}
         run: |
-          & scripts/linting/Markdown-Link-Check.ps1
+          $params = @{ ThrottleLimit = [int]$env:THROTTLE_LIMIT }
+          if ($env:CHANGED_FILES_ONLY -eq 'true') {
+            $params['ChangedFilesOnly'] = $true
+            if (-not [string]::IsNullOrEmpty($env:BASE_BRANCH)) {
+              $params['BaseBranch'] = $env:BASE_BRANCH
+            }
+          }
+          & scripts/linting/Markdown-Link-Check.ps1 @params
         continue-on-error: ${{ inputs.soft-fail }}
 
       - name: Upload markdown link check results
@@ -54,6 +81,7 @@ jobs:
           name: markdown-link-check-results
           path: logs/markdown-link-check-results.json
           retention-days: 30
+          if-no-files-found: ignore
 
       - name: Check results and fail if needed
         if: ${{ !inputs.soft-fail && steps.link-check.outcome == 'failure' }}

.github/workflows/pr-validation.yml

@@ -389,6 +389,8 @@ jobs:
       contents: read
     with:
       soft-fail: true
+      changed-files-only: true
+      base-branch: ${{ github.event.pull_request.base.sha || format('origin/{0}', github.base_ref) }}
 
   dependency-pinning-check:
     name: Validate Dependency Pinning

.github/workflows/weekly-validation.yml

@@ -92,6 +92,15 @@ jobs:
     permissions:
       contents: read
 
+  markdown-link-check:
+    name: Markdown Link Check (Full Repository)
+    uses: ./.github/workflows/markdown-link-check.yml
+    permissions:
+      contents: read
+    with:
+      soft-fail: true
+      changed-files-only: false
+
   create-stale-docs-issues:
     name: Create or Update Issues for Stale Documentation
     needs: [msdate-freshness]