litellm/.github/workflows/create-release-branch.yml

name: Create Release Branch

on:
  workflow_dispatch:
    inputs:
      tag:
        description: "Release tag (e.g. 1.84.0, 1.84.0rc1, 1.84.0.dev42, 1.84.0.post1; legacy v1.83.10-stable still accepted) — branch will be named release/<tag>"
        required: true
        type: string
      commit_hash:
        description: "Full 40-char commit SHA the branch should point to"
        required: true
        type: string
  workflow_call:
    inputs:
      tag:
        description: "Release tag (e.g. 1.84.0, 1.84.0rc1, 1.84.0.dev42, 1.84.0.post1; legacy v1.83.10-stable still accepted)"
        required: true
        type: string
      commit_hash:
        description: "Full 40-char commit SHA the branch should point to"
        required: true
        type: string

permissions: {}

jobs:
  create-branch:
    name: Create Release Branch
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - name: Validate inputs
        env:
          TAG: ${{ inputs.tag }}
          COMMIT_HASH: ${{ inputs.commit_hash }}
        run: |
          if ! echo "${COMMIT_HASH}" | grep -qE '^[0-9a-f]{40}$'; then
            echo "::error::commit_hash must be a full 40-character commit SHA"
            exit 1
          fi
          if ! echo "${TAG}" | grep -qE '^v?[0-9]+\.[0-9]+\.[0-9]+'; then
            echo "::error::tag must start with X.Y.Z (optional leading v), e.g. 1.84.0, 1.84.0rc1, 1.84.0.dev42, or v1.83.10-stable"
            exit 1
          fi

      - name: Create release branch
        env:
          TAG: ${{ inputs.tag }}
          COMMIT_HASH: ${{ inputs.commit_hash }}
        uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
        with:
          script: |
            const tag = process.env.TAG;
            const commitHash = process.env.COMMIT_HASH;
            const branchName = `release/${tag}`;

            await github.rest.git.createRef({
              owner: context.repo.owner,
              repo: context.repo.repo,
              ref: `refs/heads/${branchName}`,
              sha: commitHash,
            });
            core.info(`Created branch ${branchName} at ${commitHash}`);

      - name: Create stable line branch
        env:
          TAG: ${{ inputs.tag }}
          COMMIT_HASH: ${{ inputs.commit_hash }}
        uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
        with:
          script: |
            const tag = process.env.TAG;
            const commitHash = process.env.COMMIT_HASH;

            const match = tag.match(/^v?(\d+)\.(\d+)\.0$/);
            if (!match) {
              core.info(`Tag ${tag} is not the X.Y.0 stable opener; skipping stable line branch`);
              return;
            }
            const lineBranch = `stable/${match[1]}.${match[2]}.x`;

            await github.rest.git.createRef({
              owner: context.repo.owner,
              repo: context.repo.repo,
              ref: `refs/heads/${lineBranch}`,
              sha: commitHash,
            });
            core.info(`Created branch ${lineBranch} at ${commitHash}`);