ci: add workflow stubs to enable workflow_dispatch on feature branches (#142)

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Author: aaronsteers

.github/workflows/generate-command.yml

@@ -0,0 +1,38 @@
+# Stub: Speakeasy SDK Generation Workflow
+#
+# This is a minimal placeholder to register the workflow_dispatch trigger on main.
+# The full implementation will arrive in a follow-up PR.
+# Without this stub on main, workflow_dispatch and /generate slash commands
+# cannot target feature branches.
+
+name: Generate SDK
+
+"on":
+    workflow_dispatch:
+        inputs:
+            dry_run:
+                description: Validate generation without creating a PR
+                type: boolean
+                default: false
+            pr:
+                description: 'PR number (if set, pushes results to the PR branch instead of creating a new PR)'
+                type: string
+                required: false
+            comment-id:
+                description: 'Comment ID (for slash command triggers)'
+                type: string
+                required: false
+    workflow_call:
+        inputs:
+            dry_run:
+                description: Validate generation without creating a PR
+                type: boolean
+                default: false
+
+jobs:
+    stub:
+        name: Stub (placeholder)
+        runs-on: ubuntu-latest
+        steps:
+            - name: Placeholder
+              run: echo "This is a stub workflow. The full implementation will arrive in a follow-up PR."

.github/workflows/pre-release-command.yml

@@ -0,0 +1,35 @@
+# Stub: Pre-Release Workflow
+#
+# Minimal placeholder to register the workflow_dispatch trigger on main.
+# Full implementation arrives in a follow-up PR.
+
+name: Pre-Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Pre-release version (e.g. 1.0.0rc1)'
+        required: true
+        type: string
+      ref:
+        description: 'Branch, tag, or commit SHA to build from'
+        required: false
+        default: 'main'
+        type: string
+      pr:
+        description: 'PR number (for slash command triggers)'
+        required: false
+        type: string
+      comment-id:
+        description: 'Comment ID (for slash command triggers)'
+        required: false
+        type: string
+
+jobs:
+  stub:
+    name: Stub (placeholder)
+    if: false
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "stub"

.github/workflows/publish.yml

@@ -0,0 +1,18 @@
+# Stub: Publish to PyPI Workflow
+#
+# Minimal placeholder to register the release trigger on main.
+# Full implementation arrives in a follow-up PR.
+
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  stub:
+    name: Stub (placeholder)
+    if: false
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "stub"

.github/workflows/release-drafter.yml

@@ -0,0 +1,20 @@
+# Stub: Release Drafter Workflow
+#
+# Minimal placeholder to register the workflow_dispatch trigger on main.
+# Full implementation arrives in a follow-up PR.
+
+name: Release Drafter
+
+on:
+  workflow_dispatch: {}
+  push:
+    branches:
+      - main
+
+jobs:
+  stub:
+    name: Stub (placeholder)
+    if: false
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "stub"

.github/workflows/semantic-pr-title.yml

@@ -0,0 +1,18 @@
+# Stub: Validate PR Title Workflow
+#
+# Minimal placeholder to register the pull_request trigger on main.
+# Full implementation arrives in a follow-up PR.
+
+name: Validate PR Title
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize]
+
+jobs:
+  stub:
+    name: Stub (placeholder)
+    if: false
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "stub"

.github/workflows/slash-command-dispatch.yml

@@ -0,0 +1,49 @@
+name: Slash Command Dispatch
+
+on:
+  issue_comment:
+    types: [created]
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+  actions: write
+
+jobs:
+  slash-command-dispatch:
+    name: Slash Command Dispatch
+    # Only allow slash commands on pull requests (not on issues)
+    if: ${{ github.event.issue.pull_request }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Authenticate as GitHub App
+        uses: actions/create-github-app-token@v3
+        id: get-app-token
+        with:
+          app-id: ${{ secrets.OCTAVIA_BOT_APP_ID }}
+          private-key: ${{ secrets.OCTAVIA_BOT_PRIVATE_KEY }}
+
+      - name: Slash Command Dispatch
+        id: dispatch
+        uses: peter-evans/slash-command-dispatch@9bdcd7914ec1b75590b790b844aa3b8eee7c683a # v5.0.2
+        with:
+          repository: ${{ github.repository }}
+          token: ${{ steps.get-app-token.outputs.token }}
+          dispatch-type: workflow
+          issue-type: pull-request
+          commands: |
+            generate
+          static-args: |
+            pr=${{ github.event.issue.number }}
+            comment-id=${{ github.event.comment.id }}
+          # Only run for users with 'write' permission on the main repository
+          permission: write
+
+      - name: Edit comment with error message
+        if: steps.dispatch.outputs.error-message
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          comment-id: ${{ github.event.comment.id }}
+          body: |
+            > Error: ${{ steps.dispatch.outputs.error-message }}

.github/workflows/test-full.yml

@@ -0,0 +1,18 @@
+# Stub: Test (Full) Workflow
+#
+# Minimal placeholder to register the workflow_dispatch trigger on main.
+# Full implementation arrives in a follow-up PR.
+
+name: Test (Full)
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  stub:
+    name: Stub (placeholder)
+    if: false
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "stub"