chore: Revise RACommons CI workflow for improved build and release process

- Updated workflow name and descriptions to reflect RACommons focus.
- Simplified version handling and removed unnecessary core version input.
- Enhanced build steps for iOS and Android, including artifact management.
- Improved release asset preparation and packaging for both platforms.
- Clarified documentation in the release notes regarding library contents and usage.

Author: sanchitmonga22

.github/workflows/commons-release.yml

@@ -1,18 +1,15 @@
-name: Build and Release XCFrameworks
+name: Build and Release RACommons
 
 # =============================================================================
-# This workflow builds modular XCFrameworks for iOS/macOS:
-#   - RACommons.xcframework (core commons library)
-#   - RABackendLlamaCPP.xcframework (LLM backend)
-#   - RABackendONNX.xcframework (STT/TTS/VAD backend)
+# RACommons Release Workflow
 #
-# It downloads runanywhere-core source from runanywhere-binaries releases,
-# builds the XCFrameworks, and publishes them as a GitHub release on this repo.
+# Builds RACommons.xcframework - the standalone infrastructure library.
+# This does NOT build backends (LlamaCPP, ONNX, WhisperCPP) - those are
+# released from runanywhere-core repository.
 #
 # Trigger:
 #   - Tag push: commons-v*
 #   - Manual workflow_dispatch
-#
 # =============================================================================
 
 on:
@@ -22,13 +19,9 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'Version to release (e.g., 2.0.0)'
+        description: 'Version to release (e.g., 0.2.0)'
         required: true
         type: string
-      core_version:
-        description: 'runanywhere-core version to use (leave empty for latest)'
-        required: false
-        type: string
       dry_run:
         description: 'Dry run (build only, do not publish)'
         required: false
@@ -39,19 +32,17 @@ permissions:
   contents: read
 
 env:
-  # Working directory for commons
   COMMONS_DIR: sdk/runanywhere-commons
 
 jobs:
   # ===========================================================================
-  # Build iOS XCFrameworks
+  # Build iOS XCFramework
   # ===========================================================================
   build-ios:
-    name: Build iOS XCFrameworks
+    name: Build iOS
     runs-on: macos-14
     outputs:
       version: ${{ steps.version.outputs.version }}
-      core_version: ${{ steps.core.outputs.core_version }}
 
     steps:
       - name: Checkout
@@ -66,7 +57,7 @@ jobs:
             VERSION="${GITHUB_REF#refs/tags/commons-v}"
           fi
           echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "Building version: $VERSION"
+          echo "Building RACommons v$VERSION"
 
       - name: Setup Xcode
         uses: maxim-lobanov/setup-xcode@v1
@@ -76,169 +67,205 @@ jobs:
       - name: Install Dependencies
         run: brew install cmake ninja
 
-      - name: Download runanywhere-core Source
-        id: core
+      - name: Setup Development Config
         working-directory: ${{ env.COMMONS_DIR }}
         run: |
-          chmod +x scripts/download-core.sh
-
-          # Determine core version
-          if [ -n "${{ github.event.inputs.core_version }}" ]; then
-            CORE_VERSION="${{ github.event.inputs.core_version }}"
-          else
-            CORE_VERSION="0.1.1-dev.03aacf9"
+          # Create development_config.cpp from template (gitignored)
+          if [ -f src/infrastructure/network/development_config.cpp.template ]; then
+            cp src/infrastructure/network/development_config.cpp.template \
+               src/infrastructure/network/development_config.cpp
           fi
 
-          echo "Using core version: $CORE_VERSION"
-          echo "core_version=$CORE_VERSION" >> $GITHUB_OUTPUT
-
-          RUNANYWHERE_CORE_VERSION="$CORE_VERSION" ./scripts/download-core.sh
+      - name: Build RACommons XCFramework
+        working-directory: ${{ env.COMMONS_DIR }}
+        run: |
+          chmod +x scripts/build-rac-commons.sh
+          ./scripts/build-rac-commons.sh --ios --release --package
 
-      - name: Verify Downloads
+      - name: List Artifacts
         working-directory: ${{ env.COMMONS_DIR }}
         run: |
-          echo "=== Verifying Downloads ==="
-          # Check core source
-          if [ ! -f "third_party/runanywhere-core/CMakeLists.txt" ]; then
-            echo "ERROR: runanywhere-core not downloaded"
-            exit 1
+          echo "=== Build Artifacts ==="
+          ls -la dist/
+          if [ -d dist/packages ]; then
+            echo ""
+            echo "=== Packages ==="
+            ls -la dist/packages/
           fi
-          echo "✓ Core: $(cat third_party/runanywhere-core/DOWNLOADED_VERSION)"
 
-          # Check ONNX Runtime (in commons third_party/ for FetchONNXRuntime.cmake)
-          if [ ! -d "third_party/onnxruntime-ios/onnxruntime.xcframework" ]; then
-            echo "ERROR: onnxruntime.xcframework not downloaded"
-            exit 1
-          fi
-          echo "✓ ONNX Runtime (third_party/onnxruntime-ios/)"
+      - name: Upload Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: racommons-ios-${{ steps.version.outputs.version }}
+          path: |
+            ${{ env.COMMONS_DIR }}/dist/RACommons.xcframework
+            ${{ env.COMMONS_DIR }}/dist/packages/*.zip
+            ${{ env.COMMONS_DIR }}/dist/packages/*.sha256
+          retention-days: 30
 
-          # Check Sherpa-ONNX (inside runanywhere-core/third_party/ for ONNX backend CMake)
-          if [ ! -d "third_party/runanywhere-core/third_party/sherpa-onnx-ios/sherpa-onnx.xcframework" ]; then
-            echo "ERROR: sherpa-onnx.xcframework not downloaded"
-            exit 1
-          fi
-          echo "✓ Sherpa-ONNX (third_party/runanywhere-core/third_party/sherpa-onnx-ios/)"
+  # ===========================================================================
+  # Build Android Libraries
+  # ===========================================================================
+  build-android:
+    name: Build Android (${{ matrix.abi }})
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        abi: [arm64-v8a, armeabi-v7a, x86_64]
 
-          echo ""
-          echo "=== third_party/ contents ==="
-          ls -la third_party/
-          echo ""
-          echo "=== third_party/runanywhere-core/third_party/ contents ==="
-          ls -la third_party/runanywhere-core/third_party/
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
 
-      - name: Setup Development Config
-        working-directory: ${{ env.COMMONS_DIR }}
+      - name: Determine Version
+        id: version
         run: |
-          # Create development_config.cpp from template (gitignored, contains placeholders)
-          cp src/infrastructure/network/development_config.cpp.template \
-             src/infrastructure/network/development_config.cpp
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            VERSION="${{ github.event.inputs.version }}"
+          else
+            VERSION="${GITHUB_REF#refs/tags/commons-v}"
+          fi
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
 
-      - name: Build iOS XCFrameworks
-        working-directory: ${{ env.COMMONS_DIR }}
-        run: |
-          chmod +x scripts/build-ios.sh
-          ./scripts/build-ios.sh
+      - name: Setup JDK
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
 
-      - name: Package Release
-        working-directory: ${{ env.COMMONS_DIR }}
+      - name: Setup Android SDK
+        uses: android-actions/setup-android@v3
+
+      - name: Setup NDK
         run: |
-          chmod +x scripts/package-release.sh
-          ./scripts/package-release.sh ${{ steps.version.outputs.version }}
+          NDK_VERSION="27.0.12077973"
+          echo "y" | sdkmanager --install "ndk;${NDK_VERSION}" --sdk_root=${ANDROID_SDK_ROOT}
+          echo "ANDROID_NDK_HOME=${ANDROID_SDK_ROOT}/ndk/${NDK_VERSION}" >> $GITHUB_ENV
 
-      - name: List Artifacts
+      - name: Build Android ${{ matrix.abi }}
         working-directory: ${{ env.COMMONS_DIR }}
         run: |
-          echo "=== Build Artifacts ==="
-          ls -la dist/
-          echo ""
-          echo "=== XCFramework Sizes ==="
-          for xcf in dist/*.xcframework; do
-            if [ -d "$xcf" ]; then
-              size=$(du -sh "$xcf" | cut -f1)
-              echo "  $(basename "$xcf"): $size"
-            fi
-          done
+          chmod +x scripts/build-rac-commons.sh
+          ./scripts/build-rac-commons.sh --android --abi ${{ matrix.abi }} --release
 
-      - name: Upload Artifacts
+      - name: Upload Artifact
         uses: actions/upload-artifact@v4
         with:
-          name: xcframeworks-${{ steps.version.outputs.version }}
+          name: racommons-android-${{ matrix.abi }}-${{ steps.version.outputs.version }}
           path: |
-            ${{ env.COMMONS_DIR }}/dist/*.xcframework.zip
-            ${{ env.COMMONS_DIR }}/dist/*.zip
-            ${{ env.COMMONS_DIR }}/dist/*.sha256
-            ${{ env.COMMONS_DIR }}/dist/MANIFEST.md
+            ${{ env.COMMONS_DIR }}/dist/android/
           retention-days: 30
 
   # ===========================================================================
-  # Publish Release to this repo (runanywhere-sdks)
+  # Publish Release
   # ===========================================================================
   publish:
     name: Publish Release
-    needs: build-ios
+    needs: [build-ios, build-android]
     if: github.event.inputs.dry_run != 'true'
     runs-on: ubuntu-latest
     permissions:
       contents: write
 
     steps:
-      - name: Download Artifacts
+      - name: Download iOS Artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: racommons-ios-${{ needs.build-ios.outputs.version }}
+          path: dist/ios
+
+      - name: Download Android Artifacts
         uses: actions/download-artifact@v4
         with:
-          name: xcframeworks-${{ needs.build-ios.outputs.version }}
-          path: dist
+          pattern: racommons-android-*
+          path: dist/android-artifacts
+          merge-multiple: false
 
-      - name: List Downloaded Artifacts
+      - name: Prepare Release Assets
         run: |
-          echo "=== Downloaded Artifacts ==="
-          ls -laR dist/
+          VERSION="${{ needs.build-ios.outputs.version }}"
+          mkdir -p release-assets
+
+          # iOS assets
+          if [ -d dist/ios/packages ]; then
+            cp dist/ios/packages/*.zip release-assets/ 2>/dev/null || true
+            cp dist/ios/packages/*.sha256 release-assets/ 2>/dev/null || true
+          fi
+
+          # Package iOS XCFramework if not already packaged
+          if [ -d dist/ios/RACommons.xcframework ] && [ ! -f release-assets/*ios*.zip ]; then
+            cd dist/ios
+            zip -r "../../release-assets/RACommons-ios-v${VERSION}.zip" RACommons.xcframework
+            cd ../../release-assets
+            shasum -a 256 "RACommons-ios-v${VERSION}.zip" > "RACommons-ios-v${VERSION}.zip.sha256"
+          fi
+
+          # Combine Android ABIs
+          mkdir -p android-combined/jniLibs
+          for dir in dist/android-artifacts/racommons-android-*/android/jniLibs/*/; do
+            if [ -d "$dir" ]; then
+              abi=$(basename "$dir")
+              mkdir -p "android-combined/jniLibs/${abi}"
+              cp -r "${dir}"* "android-combined/jniLibs/${abi}/" 2>/dev/null || true
+            fi
+          done
+
+          # Copy headers
+          HEADER_DIR=$(find dist/android-artifacts -name "include" -type d | head -1)
+          if [ -n "$HEADER_DIR" ]; then
+            cp -r "$HEADER_DIR" android-combined/
+          fi
+
+          # Package Android
+          cd android-combined
+          zip -r "../release-assets/RACommons-android-v${VERSION}.zip" .
+          cd ../release-assets
+          shasum -a 256 "RACommons-android-v${VERSION}.zip" > "RACommons-android-v${VERSION}.zip.sha256"
+
+          echo "=== Release Assets ==="
+          ls -la
 
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
           tag_name: commons-v${{ needs.build-ios.outputs.version }}
-          name: RunAnywhere Commons v${{ needs.build-ios.outputs.version }}
+          name: RACommons v${{ needs.build-ios.outputs.version }}
           files: |
-            dist/**/*.zip
-            dist/**/*.sha256
+            release-assets/*.zip
+            release-assets/*.sha256
           body: |
-            ## RunAnywhere Commons v${{ needs.build-ios.outputs.version }}
-
-            Modular XCFrameworks for iOS/macOS.
+            ## RACommons v${{ needs.build-ios.outputs.version }}
 
-            ### XCFrameworks
+            Standalone infrastructure library for RunAnywhere SDKs.
 
-            | Framework | Description |
-            |-----------|-------------|
-            | `RACommons.xcframework` | Core commons library (service registry, model management) |
-            | `RABackendLlamaCPP.xcframework` | LLM backend (llama.cpp + Metal) |
-            | `RABackendONNX.xcframework` | STT/TTS/VAD backend (Sherpa-ONNX) |
+            ### Contents
+            - Logging, error handling, and event tracking
+            - Service registry and provider infrastructure
+            - Model management (download strategies, storage)
+            - Platform backend (Apple Foundation Models, System TTS) - iOS/macOS only
 
-            ### Swift Package Manager
+            ### iOS/macOS
+            `RACommons-ios-v${{ needs.build-ios.outputs.version }}.zip`
+            - Contains `RACommons.xcframework`
 
-            Update your `Package.swift`:
+            ### Android
+            `RACommons-android-v${{ needs.build-ios.outputs.version }}.zip`
+            - Contains `jniLibs/{abi}/librac_commons.so`
+            - Contains `include/` headers
 
-            ```swift
-            .binaryTarget(
-                name: "RACommonsBinary",
-                url: "https://github.com/RunanywhereAI/runanywhere-sdks/releases/download/commons-v${{ needs.build-ios.outputs.version }}/RACommons-${{ needs.build-ios.outputs.version }}.zip",
-                checksum: "..."
-            ),
-            ```
-
-            ### Requirements
-
-            - **ONNX Runtime**: `RABackendONNX` requires `onnxruntime.xcframework` (download separately)
-            - **Platforms**: iOS 17+, macOS 14+
+            ### Note
+            Backend libraries (LlamaCPP, ONNX, WhisperCPP) are released separately from `runanywhere-core`.
 
             ### Verification
-
             ```bash
             shasum -a 256 -c *.sha256
             ```
 
             ---
-            Built with runanywhere-core: ${{ needs.build-ios.outputs.core_version }}
+            Built from runanywhere-sdks @ ${{ github.sha }}
           draft: false
           prerelease: false
         env: