ci(docs): dispatch convoy-java SDK generation

[mekilis]

Summary

• Adds convoy-java to the SDK regeneration dispatch matrix in speakeasy-sdk.yml. The repo implements the same sdk_generation.yaml contract as convoy.js/convoy-python (feat: add OpenAPI-generated API client convoy-java#1), generating via OpenAPI Generator (java, native library).
• Updates docs/md/SPEAKEASY_SDK.md for the third client and notes that SDK_REPOS_PAT / SDK_BOT_PAT must cover convoy-java.

Ops prerequisite before the first dispatched run: extend SDK_REPOS_PAT (on this repo) and add SDK_BOT_PAT (on convoy-java) to cover frain-dev/convoy-java. Missing tokens fail the dispatch step loudly; they do not create a security gap.

Test plan

• Matrix entry mirrors the existing two rows; no other workflow logic changed
• convoy-java's sdk_generation.yaml validated end to end locally (generation, compile, 25 tests)

---

Note

Low Risk
CI and documentation only, reusing the existing dispatch pattern; token scope must be updated before the first Java run or dispatch will fail loudly.

Overview
Extends the speakeasy-sdk.yml dispatcher so OpenAPI changes on main also trigger frain-dev/convoy-java via the same sdk_generation.yaml contract as the JS and Python repos (Java uses OpenAPI Generator locally in that repo).

Workflow comments now describe the per-repo generator model and that SDK_REPOS_PAT must cover all three SDK repos. The optional feature_branch guard adds refs/* so names like refs/heads/main cannot slip past the main block and affect force-push behavior downstream.

docs/md/SPEAKEASY_SDK.md documents convoy-java, expands scope/secrets/pipeline diagrams, and drops Java from the “future languages” list.

^{Reviewed by Cursor Bugbot for commit f7a9aaf. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Current version of PR was reviewed by /review-bugbot on Jul 19, 22:30 GMT+1. It flagged 0 findings.

^{Bugbot on commit 9065fec is skipped.}