chore: script to generate examples (#244)

This PR addresses issue #68.

It introduces a script to automatically generate the example workflow
files from the main workflow files.
This will help to keep the workflows DRY and avoid duplication.

Author: leehagoodjames

CONTRIBUTING.md

@@ -65,6 +65,7 @@ Before contributing, ensure you have:
       ```sh
       npm run docs
       ```
+    - If you update workflow files in `/.gemini/workflows/`, run `./scripts/generate-examples.sh` to auto-generate the examples.
 
 3. **Commit Your Changes**
     - Commit with a descriptive message following [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/)

scripts/generate-examples.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+WORKFLOWS_DIR="${REPO_ROOT}/.github/workflows"
+EXAMPLES_DIR="${REPO_ROOT}/examples/workflows"
+
+for workflow_file in "${WORKFLOWS_DIR}"/*.yml; do
+  workflow_name="$(basename "${workflow_file}")"
+  example_dir=""
+  example_filename=""
+
+  # Add case for each file that should exist in /examples/
+  case "${workflow_name}" in
+    "gemini-invoke.yml")
+      example_dir="${EXAMPLES_DIR}/gemini-assistant"
+      example_filename="gemini-invoke.yml"
+      ;; 
+    "gemini-triage.yml")
+      example_dir="${EXAMPLES_DIR}/issue-triage"
+      example_filename="gemini-triage.yml"
+      ;; 
+    "gemini-scheduled-triage.yml")
+      example_dir="${EXAMPLES_DIR}/issue-triage"
+      example_filename="gemini-scheduled-triage.yml"
+      ;; 
+    "gemini-review.yml")
+      example_dir="${EXAMPLES_DIR}/pr-review"
+      example_filename="gemini-review.yml"
+      ;; 
+    *)
+      echo "Skipping ${workflow_name}"
+      continue
+      ;; 
+  esac
+
+  example_file="${example_dir}/${example_filename}"
+  echo "Generating ${example_file}"
+
+  # Update lines that are different in the /examples/, such as the version of the action
+  sed \
+    -e "s|uses: 'google-github-actions/run-gemini-cli@main'|uses: 'google-github-actions/run-gemini-cli@v0'|g" \
+    "${workflow_file}" > "${example_file}"
+done