ci: consolidate publish workflow with enhanced version management

Merges release and test publishing workflows into a single comprehensive workflow with improved version bump options, automated version detection, and better package management controls

The previous separate workflows for release and test publishing have been combined into one unified publish.yml workflow that handles both official and test releases with enhanced configuration options.

---

ci: 合并发布工作流程并增强版本管理

将发布和测试发布工作流合并为一个综合工作流程，具有改进的版本递增选项、自动版本检测和更好的包管理控制

之前用于发布和测试发布工作流已合并为一个统一的 publish.yml 工作流，该工作流处理正式发布和测试发布，并提供增强的配置选项。

Change-Id: Iecdd190ec2f09d3a351b6608d708e89087f66d53
Signed-off-by: OhYee <oyohyee@oyohyee.com>

Author: OhYee

.github/workflows/publish.yml

@@ -1,70 +1,180 @@
 name: Publish to npm
 
 on:
-  push:
-    tags:
-      - 'v*'
-    branches:
-      - main
+  # GitHub Release 触发正式发布
+  release:
+    types: [published]
+
+  # 手动触发
   workflow_dispatch:
     inputs:
       publish_type:
-        description: 'Type of publish: official or test'
+        description: '发布类型 / Publish type'
         required: true
         default: 'test'
         type: choice
         options:
-          - official
-          - test
+          - official  # 正式发布
+          - test      # 测试发布
+      version:
+        description: '版本号（留空则自动递增）/ Version (leave empty for auto-increment)'
+        required: false
+        type: string
+      version_bump:
+        description: '版本递增类型（仅自动递增时有效）/ Version bump type (only for auto-increment)'
+        required: false
+        default: 'patch'
+        type: choice
+        options:
+          - patch   # 0.0.1 -> 0.0.2
+          - minor   # 0.0.1 -> 0.1.0
+          - major   # 0.0.1 -> 1.0.0
       test_package_name:
-        description: 'Optional custom package name for test publish (e.g. @alicloud/agentrun-sdk-test)'
+        description: '测试包名（可选）/ Test package name (optional)'
         required: false
+        type: string
 
 jobs:
-  prepare:
-    name: Build
+  publish:
+    name: Publish Package
     runs-on: ubuntu-latest
-    outputs:
-      built: ${{ steps.build.outputs.built }}
+    permissions:
+      contents: write
+      id-token: write
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          ssh-key: ${{ secrets.DEPLOY_KEY }}
+          ref: main
+          fetch-depth: 0
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '18'
           registry-url: 'https://registry.npmjs.org'
+          always-auth: true
 
-      - name: Clean and install dependencies
+      - name: Determine publish type and version
+        id: config
         run: |
-          rm -rf node_modules package-lock.json
-          npm install
+          # 确定发布类型
+          if [ "${{ github.event_name }}" = "release" ]; then
+            PUBLISH_TYPE="official"
+            VERSION="${{ github.event.release.tag_name }}"
+            VERSION="${VERSION#v}"  # 移除 v 前缀
+            echo "Triggered by release: $VERSION"
+          else
+            PUBLISH_TYPE="${{ inputs.publish_type }}"
+            VERSION="${{ inputs.version }}"
+          fi
+          
+          echo "PUBLISH_TYPE=${PUBLISH_TYPE}" >> $GITHUB_OUTPUT
+          echo "Publish type: ${PUBLISH_TYPE}"
+          
+          # 确定包名
+          if [ "$PUBLISH_TYPE" = "test" ]; then
+            TEST_PKG_NAME="${{ inputs.test_package_name }}"
+            if [ -z "$TEST_PKG_NAME" ]; then
+              TEST_PKG_NAME="@agentrun/sdk-test"
+            fi
+            PACKAGE_NAME="$TEST_PKG_NAME"
+            NPM_TAG="test"
+          else
+            PACKAGE_NAME=$(node -p "require('./package.json').name")
+            NPM_TAG="latest"
+          fi
+          
+          echo "PACKAGE_NAME=${PACKAGE_NAME}" >> $GITHUB_OUTPUT
+          echo "NPM_TAG=${NPM_TAG}" >> $GITHUB_OUTPUT
+          echo "Package name: ${PACKAGE_NAME}"
+          echo "NPM tag: ${NPM_TAG}"
+          
+          # 确定版本号
+          if [ -n "$VERSION" ]; then
+            # 使用指定的版本号
+            echo "VERSION=${VERSION}" >> $GITHUB_OUTPUT
+            echo "Using specified version: ${VERSION}"
+          else
+            # 自动递增版本号
+            echo "Auto-incrementing version..."
+            
+            # 从 npm 获取当前最新版本
+            NPM_RESPONSE=$(npm view "$PACKAGE_NAME" version 2>/dev/null || echo "")
+            
+            if [ -z "$NPM_RESPONSE" ]; then
+              CURRENT_VERSION="0.0.0"
+              echo "Package not found on npm, starting from 0.0.0"
+            else
+              CURRENT_VERSION="$NPM_RESPONSE"
+              echo "Latest version on npm: $CURRENT_VERSION"
+            fi
+            
+            # 解析版本号
+            IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT_VERSION"
+            
+            # 根据用户选择递增版本
+            BUMP_TYPE="${{ inputs.version_bump }}"
+            if [ -z "$BUMP_TYPE" ]; then
+              BUMP_TYPE="patch"
+            fi
+            
+            case "$BUMP_TYPE" in
+              major)
+                MAJOR=$((MAJOR + 1))
+                MINOR=0
+                PATCH=0
+                ;;
+              minor)
+                MINOR=$((MINOR + 1))
+                PATCH=0
+                ;;
+              patch)
+                PATCH=$((PATCH + 1))
+                ;;
+            esac
+            
+            VERSION="${MAJOR}.${MINOR}.${PATCH}"
+            echo "VERSION=${VERSION}" >> $GITHUB_OUTPUT
+            echo "New version: ${VERSION}"
+          fi
 
-      - name: Build
-        id: build
+      - name: Update package.json
         run: |
-          npm run build
-          echo "built=true" >> $GITHUB_OUTPUT
-
-  publish-official:
-    name: Publish Official Package
-    needs: prepare
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-    if: startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'workflow_dispatch' && github.event.inputs.publish_type == 'official')
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
+          VERSION="${{ steps.config.outputs.VERSION }}"
+          PACKAGE_NAME="${{ steps.config.outputs.PACKAGE_NAME }}"
+          PUBLISH_TYPE="${{ steps.config.outputs.PUBLISH_TYPE }}"
+          
+          # 更新 package.json
+          node -e "
+            const fs = require('fs');
+            const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+            pkg.version = process.env.VERSION;
+            if (process.env.PUBLISH_TYPE === 'test') {
+              pkg.name = process.env.PACKAGE_NAME;
+            }
+            fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n');
+          "
+          echo "Updated package.json:"
+          cat package.json | head -10
+        env:
+          VERSION: ${{ steps.config.outputs.VERSION }}
+          PACKAGE_NAME: ${{ steps.config.outputs.PACKAGE_NAME }}
+          PUBLISH_TYPE: ${{ steps.config.outputs.PUBLISH_TYPE }}
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-          registry-url: 'https://registry.npmjs.org'
-          always-auth: true
+      - name: Commit version changes (official release only)
+        if: steps.config.outputs.PUBLISH_TYPE == 'official'
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git add package.json
+          if git diff --staged --quiet; then
+            echo "No version changes to commit"
+          else
+            git commit -m "chore: bump version to ${{ steps.config.outputs.VERSION }}"
+            git push
+          fi
 
       - name: Clean and install dependencies
         run: |
@@ -74,52 +184,51 @@ jobs:
       - name: Build
         run: npm run build
 
-      - name: Publish to npm (official)
+      - name: Publish to npm
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: |
-          echo "Publishing official package to npm"
-          npm publish --access public
+          NPM_TAG="${{ steps.config.outputs.NPM_TAG }}"
+          PACKAGE_NAME="${{ steps.config.outputs.PACKAGE_NAME }}"
+          VERSION="${{ steps.config.outputs.VERSION }}"
+          
+          echo "Publishing ${PACKAGE_NAME}@${VERSION} with tag=${NPM_TAG}"
+          npm publish --tag "$NPM_TAG" --access public
 
-  publish-test:
-    name: Publish Test Package
-    needs: prepare
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-    if: (github.ref == 'refs/heads/main') || (github.event_name == 'workflow_dispatch' && github.event.inputs.publish_type == 'test')
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-          registry-url: 'https://registry.npmjs.org'
-          always-auth: true
-
-      - name: Clean and install dependencies
+      - name: Create and push tag (test release only)
+        if: steps.config.outputs.PUBLISH_TYPE == 'test'
         run: |
-          rm -rf node_modules package-lock.json
-          npm install
+          PACKAGE_NAME="${{ steps.config.outputs.PACKAGE_NAME }}"
+          VERSION="${{ steps.config.outputs.VERSION }}"
+          # 简化包名作为 tag 前缀
+          TAG_PREFIX=$(echo "$PACKAGE_NAME" | sed 's/@//g' | sed 's/\//-/g')
+          TAG="${TAG_PREFIX}-v${VERSION}"
+          
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git tag -a "$TAG" -m "Release test package version ${VERSION}" || true
+          git push origin "$TAG" || true
+          echo "Created and pushed tag: $TAG"
 
-      - name: Build
-        run: npm run build
-
-      - name: Publish test package (tag=test)
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-          TEST_PKG_NAME: ${{ github.event.inputs.test_package_name }}
+      - name: Summary
         run: |
-          set -e
-          echo "Publishing test package (tag=test)"
-          if [ -n "$TEST_PKG_NAME" ]; then
-            node -e "const fs=require('fs');const p=JSON.parse(fs.readFileSync('package.json'));p.name=process.env.TEST_PKG_NAME;fs.writeFileSync('package.json.tmp',JSON.stringify(p,null,2));fs.copyFileSync('package.json','package.json.bak');fs.copyFileSync('package.json.tmp','package.json');"
-            npm publish --tag test --access public
-            mv package.json.bak package.json
-            rm -f package.json.tmp
+          PUBLISH_TYPE="${{ steps.config.outputs.PUBLISH_TYPE }}"
+          PACKAGE_NAME="${{ steps.config.outputs.PACKAGE_NAME }}"
+          VERSION="${{ steps.config.outputs.VERSION }}"
+          NPM_TAG="${{ steps.config.outputs.NPM_TAG }}"
+          
+          if [ "$PUBLISH_TYPE" = "official" ]; then
+            echo "## 🚀 Official Package Released!" >> $GITHUB_STEP_SUMMARY
           else
-            npm publish --tag test --access public
+            echo "## 🧪 Test Package Released!" >> $GITHUB_STEP_SUMMARY
           fi
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- **Package Name:** ${PACKAGE_NAME}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Version:** ${VERSION}" >> $GITHUB_STEP_SUMMARY
+          echo "- **NPM Tag:** ${NPM_TAG}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Commit:** ${{ github.sha }}" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "Install with:" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`bash" >> $GITHUB_STEP_SUMMARY
+          echo "npm install ${PACKAGE_NAME}@${VERSION}" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY