From f1b09d674441b0dc73cbb22a573dedfcd36939f8 Mon Sep 17 00:00:00 2001
From: ernolf <raphael.gradenwitz@googlemail.com>
Date: Mon, 3 Aug 2026 15:18:13 +0200
Subject: [PATCH] ci: install managed CI workflows

- branch-cleanup.yml

Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
---
 .github/workflows/.ncmake-workflows.json |  5 ++
 .github/workflows/branch-cleanup.yml     | 59 ++++++++++++++++++++++++
 2 files changed, 64 insertions(+)
 create mode 100644 .github/workflows/branch-cleanup.yml

diff --git a/.github/workflows/.ncmake-workflows.json b/.github/workflows/.ncmake-workflows.json
index a24615a..3cdc6a1 100644
--- a/.github/workflows/.ncmake-workflows.json
+++ b/.github/workflows/.ncmake-workflows.json
@@ -4,6 +4,11 @@
     "sha": "4972f8bb33dbeef4ff141444c50ad49adf6cb93d",
     "source": "nextcloud"
   },
+  "branch-cleanup.yml": {
+    "hash": "2b3011daceeab1eb43062f8096d559829f0fc387688298f8977b77deb7975399",
+    "sha": "5fee38eb16b76634495d19760bb4299ea258fd18",
+    "source": "ncmake"
+  },
   "lint-info-xml.yml": {
     "hash": "629ecc8bed8b31c8271dff087b6d27a0c20abc50ede536cfb6460d7b5ee9b7ed",
     "sha": "8e6968c9160c9904e43c917e67cb88dd54114e97",
diff --git a/.github/workflows/branch-cleanup.yml b/.github/workflows/branch-cleanup.yml
new file mode 100644
index 0000000..5fee38e
--- /dev/null
+++ b/.github/workflows/branch-cleanup.yml
@@ -0,0 +1,59 @@
+# SPDX-FileCopyrightText: 2026 [ernolf] Raphael Gradenwitz <raphael.gradenwitz@googlemail.com>
+# SPDX-License-Identifier: MIT
+#
+# ncmake branch cleanup: when a pull request is merged, delete its head branch
+# if it is still there. This is the workflow-shipped equivalent of the
+# repository "Automatically delete head branches" setting (see
+# doc/DELETE_MERGED_BRANCHES.md): unlike that per-repository toggle it travels
+# with the repository through `make workflows-install`, so a repository gets the
+# cleanup even when no admin has flipped the setting. Running both is harmless:
+# whichever removes the branch first wins and the other is a quiet no-op.
+#
+# It only deletes a branch that lives in this repository (never a fork's branch)
+# and never the default branch, and it tolerates the branch already being gone,
+# so it is safe to run alongside the repository setting, Dependabot's own branch
+# deletion, or the workflow updater's self-cleanup.
+
+name: ncmake branch cleanup
+
+on:
+  # Fires for every closed pull request; the job filters down to merged ones.
+  pull_request:
+    types: [closed]
+
+permissions:
+  contents: write
+
+concurrency:
+  # Serialise deletions of the same branch; never cancel an in-flight delete.
+  group: ncmake-branch-cleanup-${{ github.event.pull_request.head.ref }}
+  cancel-in-progress: false
+
+jobs:
+  delete-branch:
+    # Only merged pull requests, only a head branch that lives in this
+    # repository (a fork's branch cannot and must not be deleted from here),
+    # and never the default branch.
+    if: >-
+      github.event.pull_request.merged == true
+      && github.event.pull_request.head.repo.full_name == github.repository
+      && github.event.pull_request.head.ref != github.event.repository.default_branch
+    runs-on: ubuntu-latest
+    steps:
+      - name: Delete the merged head branch if it is still there
+        env:
+          GH_TOKEN: ${{ github.token }}
+          HEAD_REF: ${{ github.event.pull_request.head.ref }}
+        run: |
+          ref="repos/${{ github.repository }}/git/refs/heads/${HEAD_REF}"
+          # The repository's "Automatically delete head branches" setting,
+          # Dependabot, or a fast-clicking admin may have removed the branch
+          # already. Only delete what is still there, and tolerate it vanishing
+          # between the check and the delete, so a redundant run is a quiet
+          # no-op instead of a failure.
+          if gh api "$ref" >/dev/null 2>&1; then
+            gh api --method DELETE "$ref" \
+              || echo "Could not delete the branch (already gone or handled elsewhere); nothing to do."
+          else
+            echo "Branch already deleted; nothing to do."
+          fi