From b352a18d09888c09f07b4806d6e5d767fbe21abc Mon Sep 17 00:00:00 2001
From: Richard Abrich <richard.abrich@mldsai.com>
Date: Wed, 19 Aug 2026 18:08:08 -0400
Subject: [PATCH] fix(ci): repin the docs dispatch action and stop the
 recurring bump

The Notify docs job fails on main with "Request body length does not
match content-length header". peter-evans/repository-dispatch v4.0.1
sends a mismatched Content-Length for this payload on GitHub-hosted
runners, so the docs sync dispatch never reaches openadapt-ops.

This is not new breakage from the merge that surfaced it. #1053 already
pinned the action back to v3 for exactly this reason on 2026-07-25.
Dependabot PR #1079 bumped it to v4 again on 2026-08-12, and the job has
been latently broken since; the failure only appears on a push that
touches README.md or CHANGELOG.md, and the first such push after the
bump was #1096.

- pin the action to the v3.0.0 commit instead of a floating major tag
- ignore 4.x for this action in dependabot.yml so the bump cannot silently
  reintroduce the regression a third time
- address the dispatch to OpenAdaptAI/openadapt-ops directly rather than
  relying on the rename redirect from openadapt-maintenance

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 .github/dependabot.yml            |  7 +++++++
 .github/workflows/notify-docs.yml | 13 ++++++++-----
 2 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index c19199c22..47e63c2fb 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -15,3 +15,10 @@ updates:
     open-pull-requests-limit: 5
     labels:
       - "dependencies"
+    ignore:
+      # v4 breaks the docs dispatch with a mismatched Content-Length on
+      # GitHub-hosted runners. Bumping it silently red-mains the docs sync;
+      # this already happened twice (#1049, #1079). Remove once upstream
+      # ships a fixed release.
+      - dependency-name: "peter-evans/repository-dispatch"
+        versions: ["4.x"]
diff --git a/.github/workflows/notify-docs.yml b/.github/workflows/notify-docs.yml
index b03c86c8c..ba2570651 100644
--- a/.github/workflows/notify-docs.yml
+++ b/.github/workflows/notify-docs.yml
@@ -11,12 +11,15 @@ jobs:
   notify:
     runs-on: ubuntu-latest
     steps:
-      # v4 currently sends a mismatched Content-Length for this payload on
-      # GitHub-hosted runners. Keep the last verified release until upstream
-      # resolves the regression.
-      - uses: peter-evans/repository-dispatch@v4
+      # Pinned to v3.0.0 by commit. v4 (v4.0.1) sends a mismatched
+      # Content-Length for this payload on GitHub-hosted runners and fails with
+      # "Request body length does not match content-length header". #1053 pinned
+      # this back once already; a Dependabot bump (#1079) reverted it to v4 and
+      # broke the docs dispatch again. The ignore rule in dependabot.yml keeps
+      # that from recurring. Revisit when upstream ships a fixed v4.
+      - uses: peter-evans/repository-dispatch@ff45666b9427631e3450c54a1bcbee4d9ff4d7c0 # v3.0.0
         with:
           token: ${{ secrets.DOCS_DISPATCH_TOKEN }}
-          repository: OpenAdaptAI/openadapt-maintenance
+          repository: OpenAdaptAI/openadapt-ops
           event-type: repo-updated
           client-payload: '{"repo": "${{ github.repository }}", "sha": "${{ github.sha }}"}'