ci: auto-approve and auto-merge sync PRs

[xingyaoww]

• I have read and reviewed the documentation changes to the best of my ability.
• If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

• Enable auto-approval and auto-merge for PRs created by:
  • sync-docs-code-blocks.yml
  • sync-agent-sdk-openapi.yml
• Uses gh pr review --approve and gh pr merge (prefers --auto, with immediate-merge fallbacks).
• Gated behind DOCS_SYNC_TOKEN so behavior is unchanged unless the secret is configured.

Notes:

• DOCS_SYNC_TOKEN should be a token with permission to approve/review PRs and merge to the repo.
• If GitHub Auto-merge is disabled in repo settings, the workflow will attempt an immediate merge as a fallback.

@xingyaoww can click here to continue refining the PR

[xingyaoww]

@OpenHands /codereview-roasted

[openhands-ai]

I'm on it! xingyaoww can track my progress at all-hands.dev

[openhands-ai]

I performed a “roasted” code review of PR #260 (branch auto-merge-sync-workflows) and provided blunt, actionable feedback without modifying any code (as requested by /codereview-roasted).

Checklist against your instructions:

• Restated the review outcome in a final summary
• No repository changes were made (working tree remained clean)
• No commits created, no pushes performed (nothing to push)

What I reviewed:

• The diff against main shows 52 new lines across:
  • .github/workflows/sync-docs-code-blocks.yml
  • .github/workflows/sync-agent-sdk-openapi.yml
• Changes add id: cpr, then auto-approve + auto-merge steps using gh pr review and gh pr merge, gated by DOCS_SYNC_TOKEN.

Key feedback I delivered (summary):

• Potentially brittle output usage (steps.cpr.outputs.pull-request-number)—verify the action’s actual outputs for v7 in your scenario.
• Feature-flag gating via secrets.DOCS_SYNC_TOKEN != '' is weak/unclear—prefer a clearer truthy check or repo variable toggle.
• The long merge fallback chain is messy and non-deterministic—pick a single merge strategy (likely squash) and fail loudly if it can’t happen.
• Recommended adding explicit permissions: and concurrency: to avoid breakage and race conditions.

No further action taken since you asked for a summary only.

View full conversation

[openhands-ai]

Looks like there are a few issues preventing this PR from being merged!

• GitHub Actions are failing:
  • .github/workflows/sync-docs-code-blocks.yml
  • .github/workflows/sync-agent-sdk-openapi.yml

If you'd like me to help, just leave a comment, like

@OpenHands please fix the failing actions on PR #260 at branch `auto-merge-sync-workflows`

Feel free to include any additional details that might help me get this PR into a better state.

_{^{You can manage your notification settings}}