From bfe3b77b81d4fc9bf1428313f586922361b5f235 Mon Sep 17 00:00:00 2001
From: Marc Durdin <marc@durdin.net>
Date: Tue, 23 Dec 2025 12:30:53 +1100
Subject: [PATCH] maint: add script to report on recent changes to stable
 release

Build-bot: skip
Test-bot: skip
---
 resources/build/version/README.md | 12 +++++++++++-
 resources/build/version/build.sh  | 18 +++++++++++++++++-
 2 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/resources/build/version/README.md b/resources/build/version/README.md
index 323102f7df..45255d3161 100644
--- a/resources/build/version/README.md
+++ b/resources/build/version/README.md
@@ -6,4 +6,14 @@ history has been found, increments the version, and creates a PR for the
 increment.
 
 It is wrappered by ../../teamcity/triggers/trigger-release-builds.sh for normal CI
-usage.
\ No newline at end of file
+usage.
+
+## Reporting on pending changes to stable
+
+This script will give you a report on the pending changes to the most recent
+Keyman stable release, based on recently merged pull requests on the stable-x.y
+branch:
+
+```bash
+./build.sh report-stable-changes
+```
\ No newline at end of file
diff --git a/resources/build/version/build.sh b/resources/build/version/build.sh
index ccf97a2a19..c2cfb83a5c 100755
--- a/resources/build/version/build.sh
+++ b/resources/build/version/build.sh
@@ -10,13 +10,29 @@ THIS_SCRIPT="$(readlink -f "${BASH_SOURCE[0]}")"
 
 ################################ Main script ################################
 
-builder_describe "Build version tooling" clean configure build
+# assuming that last stable release is also minor version .0 at this point
+STABLE_VERSION_MINOR=0
+STABLE_VERSION_MAJOR=$(( $KEYMAN_VERSION_MAJOR - 1 ))
+
+builder_describe "Build version tooling" clean configure build \
+  "report-stable-changes   Report on pending changes to most recent Keyman stable-$STABLE_VERSION_MAJOR.$STABLE_VERSION_MINOR release"
+
 builder_describe_outputs \
   configure /resources/build/version/node_modules \
   build     /resources/build/version/build/src/index.js
 
+builder_describe_internal_dependency \
+  report-stable-changes:project  build:project
+
 builder_parse "$@"
 
+function do_report_stable_changes() {
+  cd "$KEYMAN_ROOT"
+  git fetch
+  node resources/build/version report-history -b "stable-$STABLE_VERSION_MAJOR.$STABLE_VERSION_MINOR" -t "$GITHUB_TOKEN" --github-pr
+}
+
 builder_run_action clean      rm -rf build/ node_modules/ dist/ lib/
 builder_run_action configure  node_select_version_and_npm_ci
 builder_run_action build      tsc --build
+builder_run_action report-stable-changes        do_report_stable_changes
\ No newline at end of file