chore: (PRO-271) Update / cleanup Makefile and add debug commands and test runner

.github/actions/cleanup-test-env/action.yml

@@ -1,53 +1,15 @@
 name: 'Cleanup Test Environment'
-description: 'Stop all test processes (Kora RPC, Solana validator, etc.)'
+description: 'Kill any remaining test processes (safety net for test runner failures)'
 
 runs:
   using: 'composite'
   steps:
-    - name: Stop test processes
+    - name: Kill remaining processes
       shell: bash
       if: always()
       run: |
-        echo "🧹 Cleaning up test environment..."
-
-        # Stop Kora RPC server using saved PID
-        if [ -f /tmp/kora_pid ]; then
-          KORA_PID=$(cat /tmp/kora_pid)
-          if [ ! -z "$KORA_PID" ]; then
-            echo "Stopping Kora RPC server (PID: $KORA_PID)"
-            kill $KORA_PID 2>/dev/null || true
-          fi
-          rm -f /tmp/kora_pid
-        fi
-
-        # Stop using environment variable as fallback
-        if [ ! -z "$KORA_PID" ]; then
-          echo "Stopping Kora RPC server (ENV PID: $KORA_PID)"
-          kill $KORA_PID 2>/dev/null || true
-        fi
-
-        # Stop Solana validator using saved PID
-        if [ -f /tmp/validator_pid ]; then
-          VALIDATOR_PID=$(cat /tmp/validator_pid)
-          if [ ! -z "$VALIDATOR_PID" ]; then
-            echo "Stopping Solana validator (PID: $VALIDATOR_PID)"
-            kill $VALIDATOR_PID 2>/dev/null || true
-          fi
-          rm -f /tmp/validator_pid
-        fi
-
-        # Stop using environment variable as fallback
-        if [ ! -z "$VALIDATOR_PID" ]; then
-          echo "Stopping Solana validator (ENV PID: $VALIDATOR_PID)"
-          kill $VALIDATOR_PID 2>/dev/null || true
-        fi
-
-        # Kill any remaining processes by name (nuclear option)
-        echo "Killing any remaining test processes..."
+        echo "🧹 Safety cleanup of any remaining processes..."
         pkill -f "solana-test-validator" 2>/dev/null || true
         pkill -f "kora" 2>/dev/null || true
-
-        # Wait a moment for processes to stop
-        sleep 2
-
+        sleep 1
         echo "✅ Cleanup completed"

.github/actions/run-test-runner/action.yml

@@ -0,0 +1,45 @@
+name: "Run Test Runner"
+description: "Execute Kora integration tests using the test runner with specified filters"
+
+inputs:
+  filters:
+    description: "Test filters to apply (e.g., '--filter regular --filter auth')"
+    required: true
+  verbose:
+    description: "Enable verbose output"
+    required: false
+    default: "true"
+  rpc-url:
+    description: "Solana RPC URL to use"
+    required: false
+    default: "http://127.0.0.1:8899"
+  force-refresh:
+    description: "Force refresh of test accounts"
+    required: false
+    default: "false"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Run integration tests with test runner
+      shell: bash
+      run: |
+        echo "🧪 Running integration tests with filters: ${{ inputs.filters }}"
+
+        # Build command arguments
+        ARGS=""
+        if [ "${{ inputs.verbose }}" = "true" ]; then
+          ARGS="$ARGS --verbose"
+        fi
+        if [ "${{ inputs.force-refresh }}" = "true" ]; then
+          ARGS="$ARGS --force-refresh"
+        fi
+        if [ "${{ inputs.rpc-url }}" != "http://127.0.0.1:8899" ]; then
+          ARGS="$ARGS --rpc-url ${{ inputs.rpc-url }}"
+        fi
+
+        # Add filters
+        ARGS="$ARGS ${{ inputs.filters }}"
+
+        # Run the test runner
+        cargo run -p tests --bin test_runner -- $ARGS

.github/workflows/build-rust.yml

@@ -0,0 +1,39 @@
+name: Build Rust Artifacts
+
+on:
+  workflow_call:
+    inputs:
+      cache-key:
+        description: "Cache key suffix for rust cache"
+        required: true
+        type: string
+      artifact-name:
+        description: "Name for the uploaded artifact"
+        required: true
+        type: string
+
+jobs:
+  build:
+    name: Build Rust Artifacts
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: Swatinem/rust-cache@v2
+        with:
+          shared-key: ${{ inputs.cache-key }}
+
+      - name: Build workspace
+        run: make build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ inputs.artifact-name }}
+          path: |
+            target/debug/kora
+            target/debug/test_runner
+          retention-days: 1