feat: Validate external URLs in CI using Lychee

.github/workflows/cd.yaml

@@ -8,7 +8,28 @@ on:
       - completed
 
 jobs:
+  validate-urls:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install lychee
+        run: cargo install lychee
+
+      - name: Check external links
+        id: check_links
+        run: lychee --verbose --exclude-mail --no-progress ./**/*.md | tee lychee-output.txt
+
+      - name: Fail CI if broken links exist
+        run: |
+          if grep -q "🚫" lychee-output.txt; then
+            echo "❌ Broken links found! CI is failing."
+            exit 1
+          fi
+
   maven-cd:
+    needs: validate-urls
     uses: jenkins-infra/github-reusable-workflows/.github/workflows/maven-cd.yml@v1
     secrets:
       MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}

.github/workflows/link-check.yml

@@ -0,0 +1,29 @@
+name: Validate External Links
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  link-check:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Install lychee
+        run: cargo install lychee
+
+      - name: Run lychee to check links
+        id: lychee_check
+        run: lychee --verbose --exclude-mail --no-progress ./**/*.md | tee lychee-output.txt
+
+      - name: Fail CI if broken links exist
+        run: |
+          if grep -q "🚫" lychee-output.txt; then
+            echo "Broken links found! CI is failing."
+            exit 1
+          fi