fix(ci): retry flaky documentation link checks

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

@@ -25,7 +25,43 @@ jobs:
           key: cache-lychee-${{ github.run_id }}
           restore-keys: cache-lychee-
 
-      - name: Check documentation links with lychee
+      - name: Check documentation links with lychee (first attempt)
+        id: lychee
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: >-
+            --cache
+            --no-progress
+            --max-retries 4
+            --retry-wait-time 3
+            --timeout 30
+            --root-dir ${{ github.workspace }}
+            --exclude-path ".*ATTRIBUTIONS.*"
+            --exclude-path "./lib/llm/tests/data/.*"
+            --exclude-path "./container/compliance/spdx_licenses/.*"
+            --accept "200..=299, 403, 429"
+            --exclude-all-private
+            --exclude 0.0.0.0
+            --verbose
+            --host-concurrency 10
+            --host-request-interval 1s
+            --host-stats
+            .
+          # Capture the exit code so the retry step can propagate a second failure.
+          fail: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Clear failed links from cache before retry
+        if: steps.lychee.outputs.exit_code != '0'
+        run: |
+          if [ -f .lycheecache ]; then
+            grep -E ',2[0-9]{2},' .lycheecache > .lycheecache.tmp || true
+            mv .lycheecache.tmp .lycheecache
+          fi
+
+      - name: Retry documentation links with lychee
+        if: steps.lychee.outputs.exit_code != '0'
         uses: lycheeverse/lychee-action@v2
         with:
           args: >-