Skip to content

Send merged PRs to the docs sync webhook - #28

Merged
caseymanos merged 2 commits into
mainfrom
casey/docs-sync-webhook
Nov 18, 2026
Merged

caseymanos merged 2 commits into
mainfrom
casey/docs-sync-webhook

Conversation

@caseymanos

@caseymanos caseymanos commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

The docs sync used to listen for merged PRs through the GitHub App, so every run ended with a comment on the PR, even when there was nothing to document. This workflow posts each merged PR to a custom webhook instead, so the agent only opens a docs PR when one is needed, and nothing is posted on this repo.

It runs on the PR's closed event when the PR merged into main, and sends {repository, pull_request, sha} with a Bearer secret. pull_request_target gives the job the secrets; it never checks out PR code and has no token permissions. Same file as adapt/platform.

The DOCS_SYNC_WEBHOOK_URL and DOCS_SYNC_WEBHOOK_SECRET repo secrets are set.

@the-adaptile the-adaptile Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Confidence Score: 4/5

Summary

Adds a push-triggered docs-sync webhook notification for merged main-branch PRs. Risk is limited to notification delivery; actionlint, Bash syntax, and seven mocked workflow cases passed. Live webhook delivery and repository-secret configuration were not verified.

Deployed verification not applicable: adapt/platform-cli is outside the adapt/adapt and adapt/platform pilot and has no PR-preview deployment workflow. No verification webhook was sent.

Important Files Changed

File Changes
.github/workflows/docs-sync.yml Triggers docs synchronization for merged main-branch PRs through an authenticated webhook.

Run info

Field ID
Agent 0d6ccd7e-b62f-4075-a561-199d1a7b1bf0
Automation ec14e69d-634f-4af0-a6dd-27aa06a1f6b3
Run 15f585eb-f909-4cab-b235-30a86b02902a

Reviewed: 0abc22f-c1807a7 · ↻ Re-run review

@caseymanos
caseymanos merged commit ce8604b into main Nov 18, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant