test: improve coverage and error handling per architect review

Author: Ajit Pratap Singh

.github/workflows/test.yml

@@ -59,6 +59,21 @@ jobs:
         name: codecov-${{ matrix.os }}-${{ matrix.go }}
       continue-on-error: true
 
+  race-check:
+    name: Race Detector
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Go
+      uses: actions/setup-go@v5
+      with:
+        go-version: '1.24'
+        cache: true
+
+    - name: Run tests with race detector
+      run: go test -race -short ./...
+
   benchmark:
     name: Benchmark
     runs-on: ubuntu-latest