From a777d5db59237aadab209ddc97ddf69d4f4fa5b2 Mon Sep 17 00:00:00 2001
From: Rahul Krishna <rkrsn@ibm.com>
Date: Tue, 23 Jun 2026 00:05:14 -0400
Subject: [PATCH] ci(release): notify docs to regenerate the API reference on
 release

After publishing to GitHub and PyPI, send a repository_dispatch (sdk-release) to
codellm-devkit/docs carrying the released tag, so the docs repo regenerates and
opens a PR for the Python API reference matched to this version.

Requires a DOCS_DISPATCH_TOKEN secret: a PAT/fine-grained token with
contents:write on codellm-devkit/docs.
---
 .github/workflows/release.yml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 1230118..f240dd4 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -91,3 +91,15 @@ jobs:
 
       - name: Publish package distributions to PyPI
         run: uv publish --token ${{ secrets.PYPI_API_TOKEN }}
+
+      - name: Trigger docs API-reference update
+        # After a successful release, tell the docs repo to regenerate and PR the
+        # Python API reference against this tag. Requires a DOCS_DISPATCH_TOKEN
+        # secret: a PAT (or fine-grained token) with contents:write on
+        # codellm-devkit/docs. See docs-astro .github/workflows/update-api-docs.yml.
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          token: ${{ secrets.DOCS_DISPATCH_TOKEN }}
+          repository: codellm-devkit/docs
+          event-type: sdk-release
+          client-payload: '{"ref": "${{ github.ref_name }}"}'