refactor(ci): improve badge action with explicit filename configuration

- Replace brittle string manipulation with explicit matrix filename parameters
- Add filename input parameter to update-test-badge action
- Update matrix configuration to declare explicit filenames:
  * test-results-linux.json
  * test-results-windows.json
  * test-results-macos.json
- Consolidate to single Gist (472c59b7c2a1898c48a29f3c88897c5a) with multiple files
- Remove platform string transformation logic from action
- Update documentation with explicit filename advantages
- Improve action reusability and predictability

Resolves brittle filename generation and improves maintainability

Author: Blind-Striker

.github/actions/update-test-badge/README.md

@@ -1,13 +1,12 @@
 # Update Test Results Badge Action
 
-A reusable GitHub Action that updates test result badges by uploading test data to GitHub Gists and displaying badge URLs for README files.
+A reusable GitHub Action that updates test result badges by uploading test data to GitHub Gist files and displaying badge URLs for README files.
 
 ## Purpose
 
 This action simplifies the process of maintaining dynamic test result badges by:
-
 - Creating structured JSON data from test results
-- Uploading the data to platform-specific GitHub Gists
+- Uploading the data to platform-specific files in a single GitHub Gist
 - Providing ready-to-use badge URLs for documentation
 
 ## Usage
@@ -17,7 +16,8 @@ This action simplifies the process of maintaining dynamic test result badges by:
   uses: ./.github/actions/update-test-badge
   with:
     platform: "Linux"
-    gist_id: "c149767013f99f00791256d9036ef71b"
+    gist_id: "472c59b7c2a1898c48a29f3c88897c5a"
+    filename: "test-results-linux.json"
     gist_token: ${{ secrets.GIST_SECRET }}
     test_passed: 1099
     test_failed: 0
@@ -29,12 +29,24 @@ This action simplifies the process of maintaining dynamic test result badges by:
     server_url: ${{ github.server_url }}
 ```
 
+## Gist Structure
+
+This action uses a **single Gist** with **multiple files** for different platforms:
+
+```
+Gist ID: 472c59b7c2a1898c48a29f3c88897c5a
+├── test-results-linux.json
+├── test-results-windows.json
+└── test-results-macos.json
+```
+
 ## Inputs
 
 | Input | Description | Required | Default |
 |-------|-------------|----------|---------|
 | `platform` | Platform name (Linux, Windows, macOS) | ✅ | - |
 | `gist_id` | GitHub Gist ID for storing test results | ✅ | - |
+| `filename` | Filename for platform-specific JSON (e.g., test-results-linux.json) | ✅ | - |
 | `gist_token` | GitHub token with gist permissions | ✅ | - |
 | `test_passed` | Number of passed tests | ✅ | - |
 | `test_failed` | Number of failed tests | ✅ | - |
@@ -49,14 +61,13 @@ This action simplifies the process of maintaining dynamic test result badges by:
 ## Outputs
 
 This action produces:
-
-- **Gist Update**: Updates the specified Gist with test result JSON
+- **Gist File Update**: Updates the platform-specific file in the single Gist
 - **Console Output**: Displays badge URLs ready for README usage
 - **Debug Info**: Shows HTTP status and error details
 
 ## Generated JSON Format
 
-The action creates JSON data in this format:
+The action creates JSON data in this format for each platform file:
 
 ```json
 {
@@ -78,46 +89,53 @@ The action creates JSON data in this format:
 - **Non-essential**: Uses `continue-on-error: true` to prevent workflow failures
 - **Graceful degradation**: Provides detailed error messages without stopping execution
 - **HTTP status reporting**: Shows API response codes for debugging
+- **File-specific updates**: Only updates the specific platform file, doesn't affect other platform data
 
 ## Integration with Badge API
 
 This action is designed to work with the LocalStack .NET Client Badge API that:
-
-- Reads from the updated Gists
+- Reads from the updated Gist files
 - Generates shields.io-compatible badge JSON
 - Provides redirect endpoints to test result pages
 
 ## Matrix Integration Example
 
 ```yaml
+env:
+  BADGE_GIST_ID: "472c59b7c2a1898c48a29f3c88897c5a"
+
 strategy:
   matrix:
     include:
       - os: ubuntu-22.04
         name: "Linux"
-        gist_id: "c149767013f99f00791256d9036ef71b"
+        filename: "test-results-linux.json"
       - os: windows-latest
         name: "Windows"
-        gist_id: "3640d86bbf37520844f737e6a76b4d90"
+        filename: "test-results-windows.json"
       - os: macos-latest
         name: "macOS"
-        gist_id: "db58d93cf17ee5db079d06e3bfa4c069"
+        filename: "test-results-macos.json"
 
 steps:
   - name: "Update Test Results Badge"
     uses: ./.github/actions/update-test-badge
     with:
       platform: ${{ matrix.name }}
-      gist_id: ${{ matrix.gist_id }}
+      gist_id: ${{ env.BADGE_GIST_ID }}
+      filename: ${{ matrix.filename }}
       gist_token: ${{ secrets.GIST_SECRET }}
       # ... other inputs
 ```
 
 ## Required Setup
 
-1. **Create GitHub Gists** for each platform
+1. **Create single GitHub Gist** with platform-specific files:
+   - `test-results-linux.json`
+   - `test-results-windows.json`
+   - `test-results-macos.json`
 2. **Generate GitHub PAT** with `gist` scope
-3. **Add to repository secrets** as `GIST_TOKEN`
+3. **Add to repository secrets** as `GIST_SECRET`
 4. **Deploy Badge API** to consume the Gist data
 
 ## Badge URLs Generated
@@ -128,17 +146,33 @@ The action displays ready-to-use markdown for README files:
 [![Test Results (Linux)](https://your-api-domain/badge/tests/linux)](https://your-api-domain/redirect/tests/linux)
 ```
 
+## Advantages of Explicit Filename Configuration
+
+- ✅ **No String Manipulation**: Eliminates brittle string transformation logic
+- ✅ **Declarative**: Filenames are explicitly declared in workflow configuration
+- ✅ **Predictable**: No risk of unexpected filename generation
+- ✅ **Reusable**: Action works with any filename structure
+- ✅ **Debuggable**: Easy to see exactly what files will be created
+- ✅ **Flexible**: Supports any naming convention without code changes
+
+## Advantages of Single Gist Approach
+
+- ✅ **Simplified Management**: One Gist to manage instead of three
+- ✅ **Atomic Operations**: All platform data in one place
+- ✅ **Better Organization**: Clear file structure with descriptive names
+- ✅ **Easier Debugging**: Single location to check all test data
+- ✅ **Cost Efficient**: Fewer API calls and resources
+
 ## Troubleshooting
 
 **Common Issues:**
-
-- **403 Forbidden**: Check `GIST_TOKEN` permissions
+- **403 Forbidden**: Check `GIST_SECRET` permissions
 - **404 Not Found**: Verify `gist_id` is correct
 - **JSON Errors**: Ensure `jq` is available in runner
+- **File Missing**: Gist files are created automatically on first update
 
 **Debug Steps:**
-
 1. Check action output for HTTP status codes
 2. Verify Gist exists and is publicly accessible  
 3. Confirm token has proper `gist` scope
-4. Test Gist update manually with curl
+4. Check individual file URLs: `https://gist.githubusercontent.com/{gist_id}/raw/test-results-{platform}.json`

.github/actions/update-test-badge/action.yml

@@ -9,6 +9,9 @@ inputs:
   gist_id:
     description: 'GitHub Gist ID for storing test results'
     required: true
+  filename:
+    description: 'Filename for the platform-specific JSON file (e.g., test-results-linux.json)'
+    required: true
   gist_token:
     description: 'GitHub token with gist permissions'
     required: true
@@ -48,6 +51,9 @@ runs:
     - name: 'Update Test Results Badge Data'
       shell: bash
       run: |
+        # Use explicit filename from input
+        FILENAME="${{ inputs.filename }}"
+        
         # Calculate totals
         TOTAL=$((${{ inputs.test_passed }} + ${{ inputs.test_failed }} + ${{ inputs.test_skipped }}))
         
@@ -70,14 +76,14 @@ runs:
         echo "📊 Generated test results JSON for ${{ inputs.platform }}:"
         cat test-results.json | jq '.' 2>/dev/null || cat test-results.json
         
-        # Upload to platform-specific Gist
-        echo "📤 Uploading to Gist: ${{ inputs.gist_id }}"
+        # Upload to single Gist with platform-specific filename
+        echo "📤 Uploading to Gist: ${{ inputs.gist_id }} (file: ${FILENAME})"
         
-        # Create gist update payload
+        # Create gist update payload - only update the specific platform file
         cat > gist-payload.json << EOF
         {
           "files": {
-            "test-results.json": {
+            "${FILENAME}": {
               "content": $(cat test-results.json | jq -R -s '.')
             }
           }
@@ -94,9 +100,9 @@ runs:
           -o response.json)
         
         if [ "$HTTP_STATUS" -eq 200 ]; then
-          echo "✅ Successfully updated Gist (HTTP $HTTP_STATUS)"
+          echo "✅ Successfully updated Gist file ${FILENAME} (HTTP $HTTP_STATUS)"
         else
-          echo "⚠️ Failed to update Gist (HTTP $HTTP_STATUS)"
+          echo "⚠️ Failed to update Gist file ${FILENAME} (HTTP $HTTP_STATUS)"
           echo "Response:"
           cat response.json 2>/dev/null || echo "No response body"
         fi
@@ -105,6 +111,7 @@ runs:
       shell: bash
       run: |
         PLATFORM_LOWER=$(echo "${{ inputs.platform }}" | tr '[:upper:]' '[:lower:]')
+        FILENAME="${{ inputs.filename }}"
         
         echo "🎯 Badge URL for ${{ inputs.platform }}:"
         echo ""
@@ -114,4 +121,5 @@ runs:
         echo "**Raw URLs:**"
         echo "- Badge: https://${{ inputs.api_domain }}/badge/tests/${PLATFORM_LOWER}"
         echo "- Redirect: https://${{ inputs.api_domain }}/redirect/tests/${PLATFORM_LOWER}"
-        echo "- Gist: https://gist.github.com/${{ inputs.gist_id }}" 
+        echo "- Gist: https://gist.github.com/${{ inputs.gist_id }}"
+        echo "- Gist File: https://gist.githubusercontent.com/${{ inputs.gist_id }}/raw/${FILENAME}" 

.github/workflows/ci-cd.yml

@@ -27,6 +27,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     env:
       NUGET_PACKAGES: ${{ contains(matrix.os, 'windows') && format('{0}\.nuget\packages', github.workspace) || format('{0}/.nuget/packages', github.workspace) }}
+      BADGE_GIST_ID: "472c59b7c2a1898c48a29f3c88897c5a"
 
     strategy:
       fail-fast: false
@@ -35,23 +36,23 @@ jobs:
           - os: windows-latest
             name: "Windows"
             script: "./build.ps1"
-            gist_id: "3640d86bbf37520844f737e6a76b4d90"
+            filename: "test-results-windows.json"
 
           - os: ubuntu-22.04
             name: "Linux"
             script: "./build.sh"
-            gist_id: "c149767013f99f00791256d9036ef71b"
+            filename: "test-results-linux.json"
 
           - os: macos-latest
             name: "macOS"
             script: "./build.sh"
-            gist_id: "db58d93cf17ee5db079d06e3bfa4c069"
+            filename: "test-results-macos.json"
 
     steps:
       - name: "Checkout"
         uses: actions/checkout@v4
         with:
-          fetch-depth: 0  # Full history for better caching
+          fetch-depth: 0 # Full history for better caching
 
       - name: "Setup .NET SDK"
         uses: actions/setup-dotnet@v4
@@ -83,19 +84,20 @@ jobs:
         uses: dorny/test-reporter@v1
         if: success() || failure()
         with:
-          name: 'Test Results (${{ matrix.name }})'
-          path: '**/TestResults/*.trx'
-          reporter: 'dotnet-trx'
+          name: "Test Results (${{ matrix.name }})"
+          path: "**/TestResults/*.trx"
+          reporter: "dotnet-trx"
           fail-on-error: true
           max-annotations: 50
 
       - name: "Update Test Results Badge"
-        if: always()  # Run even if tests failed or were skipped
-        continue-on-error: true  # Don't fail workflow if badge update fails
+        if: always() # Run even if tests failed or were skipped
+        continue-on-error: true # Don't fail workflow if badge update fails
         uses: ./.github/actions/update-test-badge
         with:
           platform: ${{ matrix.name }}
-          gist_id: ${{ matrix.gist_id }}
+          gist_id: ${{ env.BADGE_GIST_ID }}
+          filename: ${{ matrix.filename }}
           gist_token: ${{ secrets.GIST_SECRET }}
           test_passed: ${{ steps.test-results.outputs.passed || 0 }}
           test_failed: ${{ steps.test-results.outputs.failed || 0 }}
@@ -156,20 +158,20 @@ jobs:
         run: chmod +x ./build.sh
 
       - name: "Setup GitHub Packages Configuration"
-        run: |         
+        run: |
           echo "🔐 Adding GitHub Packages authentication..."
           dotnet nuget add source https://nuget.pkg.github.com/${{ github.repository_owner }}/index.json \
             --name github-packages \
             --username ${{ github.actor }} \
             --password ${{ secrets.GITHUB_TOKEN }} \
             --store-password-in-clear-text
-          
+
           echo "🔧 Original nuget.config..."
           cat nuget.config
-        
+
           echo "📝 Backing up original nuget.config..."
           cp nuget.config nuget.config.backup
-          
+
           echo "🔧 Using GitHub-optimized nuget.config..."
           cp .github/nuget.config nuget.config