Polish release pipeline

Change-Id: I600646bad64a72be6faaa88211a5fbc64dfc3869
Co-developed-by: Cursor <noreply@cursor.com>

Author: Cirilla-zmh

.github/workflows/loongsuite-release.yml

@@ -2,8 +2,15 @@
 #
 # This workflow handles the complete LoongSuite release process:
 #
-# 1. PyPI packages (loongsuite-util-genai, loongsuite-distro) - .whl only, NOT loongsuite-python-agent.tar.gz
-# 2. GitHub Release (instrumentation-genai/*, instrumentation-loongsuite/* as tar.gz)
+# 1. Create release/{version} branch from main
+# 2. Build packages (bootstrap_gen.py, PyPI wheels, GitHub Release tar.gz)
+# 3. Collect changelogs and archive Unreleased sections
+# 4. Commit & push release branch
+# 5. Create GitHub Release
+# 6. Publish to PyPI / Test PyPI
+#
+# The core logic lives in scripts/loongsuite/loongsuite_release.sh, which can also be
+# run locally for the same workflow.
 #
 # Trigger:
 # - workflow_dispatch: Manual trigger with version inputs
@@ -30,9 +37,6 @@ on:
       upstream_version:
         description: 'Upstream OTel version (e.g., 0.60b1) - for opentelemetry-* packages in bootstrap_gen.py'
         required: true
-      release_notes:
-        description: 'Release notes (optional, uses CHANGELOG-loongsuite.md Unreleased if empty)'
-        required: false
       skip_pypi:
         description: 'Skip PyPI publish (for testing)'
         type: boolean
@@ -48,33 +52,31 @@ on:
     tags:
       - 'v*'
 
-permissions:
-  contents: read
-
 env:
   PYTHON_VERSION: '3.11'
 
 jobs:
-  # Build all packages
+  # Build all packages, create release branch, archive changelogs
   build:
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     outputs:
       loongsuite_version: ${{ steps.version.outputs.loongsuite_version }}
       upstream_version: ${{ steps.version.outputs.upstream_version }}
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - name: Set versions from tag or input
         id: version
         run: |
           if [[ "${{ github.event_name }}" == "push" && "${{ github.ref_type }}" == "tag" ]]; then
-            # Tag-based release: extract version from tag (v0.1.0 -> 0.1.0)
             tag="${GITHUB_REF#refs/tags/}"
             loongsuite_version="${tag#v}"
-            # For tag-based release, upstream_version must be set via environment or default
             upstream_version="${UPSTREAM_VERSION:-0.60b1}"
           else
-            # Manual release: use inputs
             loongsuite_version="${{ github.event.inputs.loongsuite_version }}"
             upstream_version="${{ github.event.inputs.upstream_version }}"
           fi
@@ -90,8 +92,6 @@ jobs:
 
           echo "loongsuite_version=$loongsuite_version" >> $GITHUB_OUTPUT
           echo "upstream_version=$upstream_version" >> $GITHUB_OUTPUT
-          echo "LOONGSUITE_VERSION=$loongsuite_version" >> $GITHUB_ENV
-          echo "UPSTREAM_VERSION=$upstream_version" >> $GITHUB_ENV
 
           echo "LoongSuite version: $loongsuite_version"
           echo "Upstream version: $upstream_version"
@@ -100,51 +100,34 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
-      - name: Install build dependencies
+      - name: Configure git for CI
         run: |
-          python -m pip install --upgrade pip
-          python -m pip install -r pkg-requirements.txt
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
 
-      - name: Generate bootstrap_gen.py with versions
+      - name: Run release script
         run: |
-          python scripts/generate_loongsuite_bootstrap.py \
+          ./scripts/loongsuite/loongsuite_release.sh \
+            --loongsuite-version ${{ steps.version.outputs.loongsuite_version }} \
             --upstream-version ${{ steps.version.outputs.upstream_version }} \
-            --loongsuite-version ${{ steps.version.outputs.loongsuite_version }}
-
-          echo "Generated bootstrap_gen.py:"
-          head -30 loongsuite-distro/src/loongsuite/distro/bootstrap_gen.py
-
-      - name: Build PyPI packages
-        run: |
-          python scripts/build_loongsuite_package.py \
-            --build-pypi \
-            --version ${{ steps.version.outputs.loongsuite_version }}
-
-          echo "PyPI packages built:"
-          ls -la dist/*.whl
-
-      - name: Build GitHub Release packages
-        run: |
-          python scripts/build_loongsuite_package.py \
-            --build-github-release \
-            --version ${{ steps.version.outputs.loongsuite_version }}
-
-          echo "GitHub Release tar:"
-          ls -la dist/*.tar.gz
+            --skip-install \
+            --skip-github-release
 
       - name: Upload PyPI artifacts
         uses: actions/upload-artifact@v4
         with:
           name: pypi-packages
           path: |
-            dist/loongsuite_util_genai-*.whl
-            dist/loongsuite_distro-*.whl
+            dist-pypi/loongsuite_util_genai-*.whl
+            dist-pypi/loongsuite_distro-*.whl
 
-      - name: Upload GitHub Release artifact
+      - name: Upload GitHub Release artifacts
         uses: actions/upload-artifact@v4
         with:
           name: github-release
-          path: dist/loongsuite-python-agent-*.tar.gz
+          path: |
+            dist/loongsuite-python-agent-*.tar.gz
+            dist/release-notes.md
 
   # Publish to production PyPI
   publish-pypi:
@@ -157,7 +140,7 @@ jobs:
       name: pypi
       url: https://pypi.org/project/loongsuite-distro/
     permissions:
-      id-token: write  # For OIDC; or use PYPI_API_TOKEN secret
+      id-token: write
     steps:
       - name: Download PyPI artifacts
         uses: actions/download-artifact@v4
@@ -195,78 +178,20 @@ jobs:
     needs: build
     runs-on: ubuntu-latest
     permissions:
-      contents: write  # Required for creating releases
+      contents: write
     steps:
-      - uses: actions/checkout@v4
-
-      - name: Download GitHub Release artifact
+      - name: Download GitHub Release artifacts
         uses: actions/download-artifact@v4
         with:
           name: github-release
           path: dist/
 
-      - name: Generate release notes
-        id: release_notes
-        run: |
-          LOONGSUITE_VERSION="${{ needs.build.outputs.loongsuite_version }}"
-          UPSTREAM_VERSION="${{ needs.build.outputs.upstream_version }}"
-
-          if [[ -n "${{ github.event.inputs.release_notes }}" ]]; then
-            echo "${{ github.event.inputs.release_notes }}" > /tmp/release-notes.txt
-          else
-            # Start with header
-            cat > /tmp/release-notes.txt << EOF
-          # LoongSuite Python Agent v${LOONGSUITE_VERSION}
-
-          ## Installation
-
-          \`\`\`bash
-          pip install loongsuite-distro==${LOONGSUITE_VERSION}
-          loongsuite-bootstrap -a install --version ${LOONGSUITE_VERSION}
-          \`\`\`
-
-          ## Package Versions
-
-          - loongsuite-* packages: ${LOONGSUITE_VERSION}
-          - opentelemetry-* packages: ${UPSTREAM_VERSION}
-
-          ---
-
-          EOF
-
-            # Collect from root CHANGELOG-loongsuite.md
-            if [[ -f CHANGELOG-loongsuite.md ]]; then
-              echo "## loongsuite-distro" >> /tmp/release-notes.txt
-              echo "" >> /tmp/release-notes.txt
-              sed -n '/^## \[*Unreleased\]*$/,/^## /p' CHANGELOG-loongsuite.md | sed '/^## /d' >> /tmp/release-notes.txt
-              echo "" >> /tmp/release-notes.txt
-            fi
-
-            # Collect from instrumentation-loongsuite/*/CHANGELOG.md
-            for changelog in instrumentation-loongsuite/*/CHANGELOG.md; do
-              if [[ -f "$changelog" ]]; then
-                pkg_dir=$(dirname "$changelog")
-                pkg_name=$(basename "$pkg_dir")
-                unreleased_content=$(sed -n '/^## \[*Unreleased\]*$/,/^## /p' "$changelog" | sed '/^## /d')
-                if [[ -n "$unreleased_content" && "$unreleased_content" =~ [^[:space:]] ]]; then
-                  echo "## $pkg_name" >> /tmp/release-notes.txt
-                  echo "" >> /tmp/release-notes.txt
-                  echo "$unreleased_content" >> /tmp/release-notes.txt
-                  echo "" >> /tmp/release-notes.txt
-                fi
-              fi
-            done
-          fi
-
-          echo "Release notes:"
-          cat /tmp/release-notes.txt
-
       - name: Create GitHub release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           VERSION="${{ needs.build.outputs.loongsuite_version }}"
           gh release create "v${VERSION}" \
             --title "LoongSuite Python Agent v${VERSION}" \
-            --notes-file /tmp/release-notes.txt \
+            --notes-file dist/release-notes.md \
             dist/loongsuite-python-agent-${VERSION}.tar.gz