Add Automated release versioning

Author: ryukofc

.github/workflows/ci.yml

@@ -1,42 +1,46 @@
 name: CI - Build, Test, and Publish SDKs
 
+# This workflow builds, tests, and publishes Python SDK packages
+# - Builds and tests run on all branches (main, release/*)
+# - Publishing to package repository ONLY happens on release/* branches
+# - Development versions (with 'dev' suffix) are created on all non-tagged commits
+# - Official releases (without 'dev' suffix) require a Git tag on a release/* branch
+
 on:
   push:
-    branches: [ main, master ]
+    branches: [ main, "release/*" ]
   pull_request:
-    branches: [ main, master ]
+    branches: [ main, "release/*" ]
 
 jobs:
   version-number:
     runs-on: ubuntu-latest
     steps:
-    - name: Set current date in UTC as env variable
-      run: |
-        export CURRENT_DATE="$(date -u +'%Y.%m.%d')"
-        echo "Current date is ${CURRENT_DATE}"
-        echo "CURRENT_DATE=${CURRENT_DATE}" >> $GITHUB_ENV
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # Need full history for git versioning
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
 
-    - id: build_version
-      name: Generate Build Version
+    - name: Install setuptools-git-versioning
       run: |
-        export BUILD_VERSION="$CURRENT_DATE.${{ github.run_number }}"
-        echo "Build version is ${BUILD_VERSION}"
-        echo "BUILD_VERSION=${BUILD_VERSION}" >> $GITHUB_OUTPUT
+        python -m pip install --upgrade pip
+        python -m pip install setuptools-git-versioning
 
     - id: package_version
-      name: Generate Package Version
+      name: Calculate Package Version
       run: |
-        export PACKAGE_VERSION="$CURRENT_DATE-preview.${{ github.run_number }}"
-        echo "Package version is ${PACKAGE_VERSION}"
-        echo "PACKAGE_VERSION=${PACKAGE_VERSION}" >> $GITHUB_OUTPUT
-        export PYTHON_PACKAGE_VERSION="$CURRENT_DATE+preview.${{ github.run_number }}"
-        echo "Python package version is ${PYTHON_PACKAGE_VERSION}"
-        echo "PYTHON_PACKAGE_VERSION=${PYTHON_PACKAGE_VERSION}" >> $GITHUB_OUTPUT
+        cd ./versioning
+        version=$(python -m setuptools_git_versioning)
+        echo "Package version calculated: $version"
+        echo "PACKAGE_VERSION=$version" >> $GITHUB_OUTPUT
 
     outputs:
-      BUILD_VERSION: ${{ steps.build_version.outputs.BUILD_VERSION }}
       PACKAGE_VERSION: ${{ steps.package_version.outputs.PACKAGE_VERSION }}
-      PYTHON_PACKAGE_VERSION: ${{ steps.package_version.outputs.PYTHON_PACKAGE_VERSION }}
 
   changed-sdks:
     name: Determine Changed SDKs
@@ -110,7 +114,7 @@ jobs:
 
     - name: Build package
       run: |
-        A365_SDK_VERSION=${{ needs.version-number.outputs.PYTHON_PACKAGE_VERSION }} uv build --all-packages --wheel
+        PackageVersion=${{ needs.version-number.outputs.PACKAGE_VERSION }} uv build --all-packages --wheel
 
     - name: Run unit tests
       run: |
@@ -143,7 +147,11 @@ jobs:
         path: ~/drop/python-${{ matrix.python-version }}.zip
 
     - name: Publish
-      if: github.event_name == 'push' && github.ref == 'refs/heads/main' && needs.changed-sdks.outputs.python-sdk == 'true'
+      # Only publish when:
+      # 1. It's a push event (not a PR)
+      # 2. The branch is a release/* branch
+      # 3. There are SDK changes
+      if: github.event_name == 'push' && startsWith(github.ref, 'refs/heads/release/') && needs.changed-sdks.outputs.python-sdk == 'true'
       run: |
         uv run twine upload --config-file .pypirc -r Agent365 dist/*
       continue-on-error: true