.github/workflows/cut-release-branch.yml

name: Cut Release Branch

on:
  workflow_dispatch:
    inputs:
      version:
        description: 'Version string (format X.Y)'
        required: true
        type: string
      commit_hash:
        description: 'The hash of the commit to branch off of'
        required: true
        type: string

jobs:
  check-membership:
    runs-on: ubuntu-latest
    outputs:
      is_member: ${{ steps.check.outputs.is_member }}
    steps:
      - name: Check if user is in the required team
        id: check
        env:
          GH_TOKEN: ${{ secrets.FLUTTER_READ_ORG }}
        run: |
          # Use the GitHub CLI to check team membership
          # Returns 204 if member, 404 if not
          if gh api orgs/flutter/teams/flutter-release-eng/memberships/${{ github.actor }} --silent; then
            echo "is_member=true" >> $GITHUB_OUTPUT
          else
            echo "::error::User ${{ github.actor }} is not a member of flutter-release-eng."
            exit 1
          fi

  create-release-branch:
    needs: check-membership
    runs-on: ubuntu-latest
    permissions:
      contents: write # Required to create branches and push commits

    steps:
      - name: Validate Version Format
        run: |
          if [[ ! "${{ inputs.version }}" =~ ^[0-9]+\.[0-9]+$ ]]; then
            echo "Error: Version must be in 'X.Y' format (e.g., 3.10)."
            exit 1
          fi

      - name: Checkout target commit
        uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6.0.0
        with:
          ref: ${{ inputs.commit_hash }}

      - name: Set Environment Variables
        run: |
          echo "BRANCH_NAME=flutter-${{ inputs.version }}-candidate.0" >> $GITHUB_ENV

      - name: Check if branch already exists
        run: |
          if git ls-remote --exit-code --heads origin ${{ env.BRANCH_NAME }}; then
            echo "Error: Branch ${{ env.BRANCH_NAME }} already exists on remote."
            exit 1
          fi

      - name: Configure Git
        run: |
          git config user.name "flutteractionsbot"
          git config user.email "<flutter-actions-bot@google.com>"

      - name: Create Branch and Version File
        run: |
          # Create and switch to the new branch locally
          git checkout -b ${{ env.BRANCH_NAME }}

          # Create the version file
          mkdir -p bin/internal/
          echo -n "${{ env.BRANCH_NAME }}" > bin/internal/release-candidate-branch.version

          # Commit the change
          git add bin/internal/release-candidate-branch.version
          git commit -m "Initialize release branch ${{ env.BRANCH_NAME }}"

      - name: Push new branch
        run: |
          git push origin ${{ env.BRANCH_NAME }}
          echo "## Release Branch \`${{ env.BRANCH_NAME }}\` Cut Successfully" >> $GITHUB_STEP_SUMMARY
          echo "" >> $GITHUB_STEP_SUMMARY
          echo "🔗 **View Branch** https://github.com/$GITHUB_REPOSITORY/tree/${{ env.BRANCH_NAME }}" >> $GITHUB_STEP_SUMMARY