ci(docs): dispatch convoy-go, convoy.rb and convoy-php SDK generation (#2740)

* ci(docs): dispatch convoy-go, convoy.rb and convoy-php SDK generation

adds the three repos to the trigger-sdk-repos matrix. each repo owns its
generator behind the shared sdk_generation.yaml filename and inputs
(convoy-go: oapi-codegen; convoy.rb / convoy-php: OpenAPI Generator).
SDK_REPOS_PAT must cover the new repos.

* docs: extend SDK client doc for go, ruby and php generation

Author: mekilis

.github/workflows/speakeasy-sdk.yml

@@ -1,17 +1,19 @@
 name: Speakeasy SDK regeneration
 
 # When public OpenAPI artifacts change on main (or via manual dispatch), kick
-# SDK generation in convoy.js / convoy-python / convoy-java. SDK repos pull
-# docs/v3/openapi3.yaml from this repository. Each repo owns its generator
-# (convoy.js: Speakeasy; convoy-python: openapi-python-client; convoy-java:
-# OpenAPI Generator) behind the same sdk_generation.yaml filename and inputs.
+# SDK generation in the SDK repos (see the trigger-sdk-repos matrix). SDK
+# repos pull docs/v3/openapi3.yaml from this repository. Each repo owns its
+# generator (convoy.js: Speakeasy; convoy-python: openapi-python-client;
+# convoy-go: oapi-codegen; convoy-java / convoy.rb / convoy-php: OpenAPI
+# Generator) behind the same sdk_generation.yaml filename and inputs.
 #
 # Required repository secrets:
 #   SPEAKEASY_API_KEY   — Speakeasy workspace API key (also required on convoy.js)
 #   SDK_REPOS_PAT       — GitHub PAT (or fine-grained token) that can
-#                         workflow_dispatch and open/edit PRs on
-#                         frain-dev/convoy.js, frain-dev/convoy-python and
-#                         frain-dev/convoy-java
+#                         workflow_dispatch and open/edit PRs on every repo in
+#                         the trigger-sdk-repos matrix (convoy.js,
+#                         convoy-python, convoy-java, convoy-go, convoy.rb,
+#                         convoy-php)
 
 on:
   push:
@@ -99,6 +101,12 @@ jobs:
             repo: convoy-python
           - language: java
             repo: convoy-java
+          - language: go
+            repo: convoy-go
+          - language: ruby
+            repo: convoy.rb
+          - language: php
+            repo: convoy-php
     steps:
       - name: Prepare feature branch
         id: branch

docs/md/SPEAKEASY_SDK.md

@@ -8,18 +8,18 @@ pattern, per-language generator picks:
 | `convoy.js` | [Speakeasy](https://www.speakeasy.com/) (free tier) | Free tier allows exactly one generated SDK per workspace; JS holds the slot |
 | `convoy-python` | [openapi-python-client](https://github.com/openapi-generators/openapi-python-client) (OSS, pinned) | Speakeasy slot taken; OSS output proven idiomatic and complete. Speakeasy pipeline kept dormant in-repo for a provider switch |
 | `convoy-java` | [OpenAPI Generator](https://openapi-generator.tech/) (OSS, pinned; `java`/`native` library) | Same OSS pattern as Python; native `java.net.http` + Jackson, no framework deps |
+| `convoy-go` | [oapi-codegen](https://github.com/oapi-codegen/oapi-codegen) (OSS, pinned) | Go-native generator; single-file `client/` subpackage beside the hand-written client |
+| `convoy.rb` | OpenAPI Generator (OSS, pinned; `ruby`) | Generated `ConvoyApi` namespace beside the hand-written `Convoy` gem code |
+| `convoy-php` | OpenAPI Generator (OSS, pinned; `php`) | Generated `Convoy\Client` namespace under `src/Client/` beside the hand-written SDK |
 
 ## Scope
 
 | Surface | Ownership |
 | --- | --- |
-| Public API client (JS, Python, Java) | Generated from OpenAPI |
+| Public API client (JS, Python, Java, Go, Ruby, PHP) | Generated from OpenAPI |
 | Webhook signature verify | **Hand-written** in every language (`signature-vectors.json`) |
 | Dashboard `/ui` auth/billing/org | Out of scope for PDE-755 |
 
-Follow-up tickets cover Go / Ruby / PHP API codegen (Go candidate:
-`oapi-codegen`; Ruby/PHP deferred until demand signal).
-
 ## Pipeline
 
 ```text
@@ -28,6 +28,9 @@ Follow-up tickets cover Go / Ruby / PHP API codegen (Go candidate:
               convoy.js:      Speakeasy action → regen PR
               convoy-python:  openapi-python-client → regen PR (only on diff)
               convoy-java:    OpenAPI Generator → regen PR (only on diff)
+              convoy-go:      oapi-codegen → regen PR (only on diff)
+              convoy.rb:      OpenAPI Generator → regen PR (only on diff)
+              convoy-php:     OpenAPI Generator → regen PR (only on diff)
 signature-vectors.json → hand-written verify tests (unchanged)
 ```
 
@@ -47,8 +50,8 @@ and inputs (`force`, `feature_branch`); each repo owns its generator.
 | Secret | Where | Purpose |
 | --- | --- | --- |
 | `SPEAKEASY_API_KEY` | `convoy`, `convoy.js` | Speakeasy generation (JS only now) |
-| `SDK_REPOS_PAT` | `convoy` | Dispatch workflows / open PRs on SDK repos |
-| `SDK_BOT_PAT` | `convoy.js`, `convoy-python`, `convoy-java` | Open generation PRs so verify CI triggers — PRs opened with `GITHUB_TOKEN` do not fire `pull_request` workflows. Can be the same fine-grained token as `SDK_REPOS_PAT` (which must also cover `convoy-java`). |
+| `SDK_REPOS_PAT` | `convoy` | Dispatch workflows / open PRs on every SDK repo in the matrix |
+| `SDK_BOT_PAT` | every SDK repo (`convoy.js`, `convoy-python`, `convoy-java`, `convoy-go`, `convoy.rb`, `convoy-php`) | Open generation PRs so verify CI triggers — PRs opened with `GITHUB_TOKEN` do not fire `pull_request` workflows. Can be the same fine-grained token as `SDK_REPOS_PAT` (which must cover all matrix repos). |
 
 ## Speakeasy plan limit