From f314654bf7bf6f3a9e1044435cab7ad9911dfd45 Mon Sep 17 00:00:00 2001
From: Pratyush Sharma <56130065+pratyush618@users.noreply.github.com>
Date: Sun, 6 Sep 2026 19:32:32 +0530
Subject: [PATCH 1/2] ci: notify the docs portal after deploy

---
 .github/workflows/docs.yml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 3853ed0..feb3d36 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -67,3 +67,16 @@ jobs:
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v5
+
+      # Rebuilds docs.byteveda.org/agenteval/ now instead of at the portal's next
+      # cron. The run id is passed because this run is still in progress here, so
+      # the portal cannot find it as the latest successful docs.yml run — it would
+      # mirror the build before this one.
+      - name: Notify docs portal
+        env:
+          GH_TOKEN: ${{ secrets.DOCS_DISPATCH_TOKEN }}
+        run: |
+          gh api repos/ByteVeda/byteveda.site/dispatches \
+            -f event_type=tool-docs-published \
+            -f "client_payload[slug]=agenteval" \
+            -f "client_payload[run_id]=${{ github.run_id }}"

From a83724c1a4f5ee7b043ab773136d9298ef1adea1 Mon Sep 17 00:00:00 2001
From: Pratyush Sharma <56130065+pratyush618@users.noreply.github.com>
Date: Sun, 6 Sep 2026 19:39:55 +0530
Subject: [PATCH 2/2] ci: annotate instead of failing on dispatch error

---
 .github/workflows/docs.yml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index feb3d36..20f00e8 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -72,6 +72,9 @@ jobs:
       # cron. The run id is passed because this run is still in progress here, so
       # the portal cannot find it as the latest successful docs.yml run — it would
       # mirror the build before this one.
+      # Pages is already published by the step above, so a failed ping costs
+      # freshness, not the release — the portal's daily cron still catches up.
+      # Annotate instead of failing the deploy.
       - name: Notify docs portal
         env:
           GH_TOKEN: ${{ secrets.DOCS_DISPATCH_TOKEN }}
@@ -79,4 +82,5 @@ jobs:
           gh api repos/ByteVeda/byteveda.site/dispatches \
             -f event_type=tool-docs-published \
             -f "client_payload[slug]=agenteval" \
-            -f "client_payload[run_id]=${{ github.run_id }}"
+            -f "client_payload[run_id]=${{ github.run_id }}" ||
+            echo "::error::docs portal dispatch failed — docs.byteveda.org/agenteval/ refreshes on the portal's daily cron instead"