Consolidate milestone badge publishing into Pages build

Author: zhongkechen

.github/workflows/build.yml

@@ -6,6 +6,7 @@
 # Triggers:
 #   - pull_request: when a PR targets main
 #   - push: when code is pushed to main
+#   - milestone: when milestone metadata changes
 #
 # Notes:
 #   Builds against Java 17, 21, and 25.
@@ -15,6 +16,8 @@ run-name: Build - ${{ github.event_name }}
 
 on:
   workflow_dispatch:
+  milestone:
+    types: [created, edited, closed, deleted]
   pull_request:
     branches:
       - main
@@ -38,6 +41,7 @@ on:
 
 permissions:
   contents: read
+  issues: read
   pages: write
   id-token: write
 
@@ -54,6 +58,8 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v7
+        with:
+          ref: ${{ github.event_name == 'milestone' && github.event.repository.default_branch || github.ref }}
 
       - name: Setup Java ${{ matrix.java }}
         uses: actions/setup-java@v5
@@ -76,16 +82,38 @@ jobs:
         if: ${{ matrix.java == 17 }}
         run: mvn -B -pl sdk -am javadoc:javadoc
 
+      - name: Generate milestone badge
+        if: ${{ matrix.java == 17 }}
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euo pipefail
+
+          TITLE=$(gh api repos/${{ github.repository }}/milestones \
+            --jq '[.[] | select(.state == "open" and .due_on != null)] | sort_by(.due_on) | .[0].title // empty')
+
+          if [ -z "$TITLE" ]; then
+            URL="https://img.shields.io/badge/Next%20Milestone-No%20milestone-lightgrey"
+          else
+            ENCODED=$(echo -n "$TITLE" | jq -sRr @uri | sed 's/-/--/g')
+            URL="https://img.shields.io/badge/Next%20Milestone-${ENCODED}-blue"
+          fi
+
+          mkdir -p milestone
+          curl -sfL "$URL" -o milestone/badge.svg
+          echo "Badge generated for: ${TITLE:-No milestone}"
+
       - name: Configure GitHub Pages
         if: ${{ matrix.java == 17 }}
         uses: actions/configure-pages@v5
 
       - name: Prepare GitHub Pages artifact
         if: ${{ matrix.java == 17 }}
         run: |
-          mkdir -p github-pages/coverage github-pages/javadoc
+          mkdir -p github-pages/coverage github-pages/javadoc github-pages/milestone
           cp -R coverage-report/target/site/jacoco-aggregate/. github-pages/coverage
           cp -R sdk/target/reports/apidocs/. github-pages/javadoc
+          cp -R milestone/. github-pages/milestone
           touch github-pages/.nojekyll
 
       - name: Upload GitHub Pages artifact
@@ -95,7 +123,7 @@ jobs:
           path: github-pages
 
   deploy-pages:
-    if: ${{ github.ref == 'refs/heads/main' }}
+    if: ${{ github.event_name == 'milestone' || github.ref == 'refs/heads/main' }}
     needs: build
     runs-on: ubuntu-latest
     environment:

.github/workflows/update-milestone-badge.yml

@@ -5,11 +5,11 @@
 [![Build](https://github.com/aws/aws-durable-execution-sdk-java/actions/workflows/build.yml/badge.svg)](https://github.com/aws/aws-durable-execution-sdk-java/actions/workflows/build.yml)
 [![Javadoc](https://img.shields.io/badge/JavaDoc-Online-green)](https://aws.github.io/aws-durable-execution-sdk-java/javadoc/)
 [![Maven](https://badges.mvnrepository.com/badge/software.amazon.lambda.durable/aws-durable-execution-sdk-java/badge.svg?label=Maven)](https://mvnrepository.com/artifact/software.amazon.lambda.durable/aws-durable-execution-sdk-java)
-[![Coverage](https://raw.githubusercontent.com/aws/aws-durable-execution-sdk-java/refs/heads/docs/coverage/jacoco.svg)](https://aws.github.io/aws-durable-execution-sdk-java/coverage/)
+[![Coverage](https://aws.github.io/aws-durable-execution-sdk-java/coverage/jacoco.svg)](https://aws.github.io/aws-durable-execution-sdk-java/coverage/)
 [![E2E Tests](https://github.com/aws/aws-durable-execution-sdk-java/actions/workflows/e2e-tests.yml/badge.svg)](https://github.com/aws/aws-durable-execution-sdk-java/actions/workflows/e2e-tests.yml)
 [![CodeQL](https://github.com/aws/aws-durable-execution-sdk-java/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/aws/aws-durable-execution-sdk-java/actions/workflows/github-code-scanning/codeql)
 [![Spotless](https://github.com/aws/aws-durable-execution-sdk-java/actions/workflows/check-spotless.yml/badge.svg)](https://github.com/aws/aws-durable-execution-sdk-java/actions/workflows/check-spotless.yml)
-[![Roadmap](https://raw.githubusercontent.com/aws/aws-durable-execution-sdk-java/refs/heads/docs/milestone/badge.svg)](https://github.com/orgs/aws/projects/346/views/6)
+[![Roadmap](https://aws.github.io/aws-durable-execution-sdk-java/milestone/badge.svg)](https://github.com/orgs/aws/projects/346/views/6)
 
 Build resilient, long-running AWS Lambda functions that automatically checkpoint progress and resume after failures. Durable functions can run for up to one year while you pay only for active compute time.
 
@@ -110,6 +110,7 @@ See [Deploy Lambda durable functions with Infrastructure as Code](https://docs.a
 - [<u>Configuration</u>](docs/advanced/configuration.md) - Customize SDK behaviour
 - [<u>Error Handling</u>](docs/advanced/error-handling.md) - SDK exceptions for handling failures
 - [<u>Logging</u>](docs/advanced/logging.md) - How to use DurableLogger
+- [<u>Migrating from 1.x to 2.x</u>](docs/migration-1.x-to-2.x.md) - Upgrade guide for breaking changes since `v1.2.1`
 - [<u>Testing</u>](docs/advanced/testing.md) - Utilities for local development and cloud-based integration testing
 
 ## Related SDKs