From abe69c779c0fdffb243d9ca87b55a989ef0ea615 Mon Sep 17 00:00:00 2001
From: David Crossley <david@indexdata.com>
Date: Mon, 10 Aug 2026 18:01:13 +1000
Subject: [PATCH 1/4] Add README schedule-deployment Workflow DEVOPS-8235

---
 js/README.md | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/js/README.md b/js/README.md
index 7ac82a5..c7e339e 100644
--- a/js/README.md
+++ b/js/README.md
@@ -4,8 +4,6 @@
 
 <!-- $GH_FOLIO/okapi/doc/md2toc -l 2 -h 4 README.md -->
 * [Matchkeys](#matchkeys)
-* [Table of contents](#table-of-contents)
-* [Matchkeys](#matchkeys)
 * [Transformers](#transformers)
     * [999 subfield definitions](#999-subfield-definitions)
         * [999 10 (source holdings record)](#999-10-source-holdings-record)
@@ -22,6 +20,7 @@
 * [GitHub Workflows Actions](#github-workflows-actions)
     * [Workflow biome-check](#workflow-biome-check)
     * [Workflow verify-matchkey](#workflow-verify-matchkey)
+    * [Workflow schedule-deployment](#workflow-schedule-deployment)
 
 ## Matchkeys
 
@@ -191,3 +190,19 @@ See documentation above for the local pre-commit [Conduct tests](#conduct-tests)
 The Workflow will discover the changed files and will run the test for each associated matchkey.
 
 Note that there is currently a tiny glitch with this workflow. The first git push for a branch will fail, but subsequent pushes will operate properly. There is a workaround to push an initial branch with no modifications, then push subsequent changes.
+
+### Workflow schedule-deployment
+
+The [schedule-deployment](https://github.com/indexdata/matchkeys/actions/workflows/schedule-deployment.yml) Workflow adds an entry to the [schedule-matchkeys.jsonl](schedule-matchkeys.jsonl) file.
+
+Other back-room processes will conduct the deployment of the matchkeys and the pool.
+
+When a matchkey is ready (whether it is still on a feature branch or already merged to mainline) then create a new git branch for preparation of this schedule entry. Select the Workflow and trigger a run via the workflow_dispatch event (i.e. select `Run workflow` on the right-hand side).
+
+Specify the new branch (note that `main` branch is not allowed).
+
+For each matchkey that is to form the pool, specify its matchkey name and the relevant git commit as a short (or long) commit hash SHA. This is a comma-separated list of matchkeys.
+
+For example `goldrush2024:1163910,isxn:d88522c`
+
+Raise a pull-request to target mainline.

From c1937f72b5bfbc781a6dc6986bfaf4f4bc7fd417 Mon Sep 17 00:00:00 2001
From: David Crossley <david@indexdata.com>
Date: Mon, 10 Aug 2026 18:02:39 +1000
Subject: [PATCH 2/4] Do not record branch schedule-deployment DEVOPS-8235

---
 .github/workflows/schedule-deployment.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/schedule-deployment.yml b/.github/workflows/schedule-deployment.yml
index 2fde1d4..4b4eead 100644
--- a/.github/workflows/schedule-deployment.yml
+++ b/.github/workflows/schedule-deployment.yml
@@ -64,7 +64,7 @@ jobs:
               continue
             fi
             echo "branch=${branch}"
-            schedules+=("${matchkey}:${sha}:${branch}")
+            schedules+=("${matchkey}:${sha}")
           done
           if [ ${#errors[@]} -gt 0 ]; then
             printf "ERROR: %s\n" "${errors[@]}"

From f283876012148048372e311f6a47c86f3cc86516 Mon Sep 17 00:00:00 2001
From: dcrossleyau <8520792+dcrossleyau@users.noreply.github.com>
Date: Mon, 10 Aug 2026 08:03:58 +0000
Subject: [PATCH 3/4] Apply schedule matchkeys

---
 js/schedule-matchkeys.jsonl | 1 +
 1 file changed, 1 insertion(+)

diff --git a/js/schedule-matchkeys.jsonl b/js/schedule-matchkeys.jsonl
index ca3c752..289fcdc 100644
--- a/js/schedule-matchkeys.jsonl
+++ b/js/schedule-matchkeys.jsonl
@@ -1 +1,2 @@
 {"id": 16, "scheduleDate": "2026-08-10T00:19:07+00:00", "deployment": "goldrush2024:1163910:remotes/origin/main,isxn:d88522c:remotes/origin/main"}
+{"id": 19, "scheduleDate": "2026-08-10T08:03:57+00:00", "deployment": "goldrush2024:1163910,isxn:d88522c"}

From 97a258a93184c0287ff0cdeee11af091f8193c1c Mon Sep 17 00:00:00 2001
From: David Crossley <david@indexdata.com>
Date: Mon, 10 Aug 2026 18:05:36 +1000
Subject: [PATCH 4/4] Delete test entries schedule-matchkeys DEVOPS-8235

---
 js/schedule-matchkeys.jsonl | 1 -
 1 file changed, 1 deletion(-)

diff --git a/js/schedule-matchkeys.jsonl b/js/schedule-matchkeys.jsonl
index 289fcdc..3b185d3 100644
--- a/js/schedule-matchkeys.jsonl
+++ b/js/schedule-matchkeys.jsonl
@@ -1,2 +1 @@
-{"id": 16, "scheduleDate": "2026-08-10T00:19:07+00:00", "deployment": "goldrush2024:1163910:remotes/origin/main,isxn:d88522c:remotes/origin/main"}
 {"id": 19, "scheduleDate": "2026-08-10T08:03:57+00:00", "deployment": "goldrush2024:1163910,isxn:d88522c"}