feat: add performance profiling setup (#514)

- Add performance:benchmark script to package.json
- Add dedicated performance CI job that runs the benchmark
- Wire performance job into merge-protection and ci-success gates

Closes #83

Author: icodeBisola

.github/workflows/ci.yml

@@ -474,6 +474,36 @@ jobs:
           name: bundle-size-report-${{ github.sha }}
           path: bundle-size-report.json
 
+  # ─────────────────────────────────────────────────────────
+  # Performance Monitoring
+  # ─────────────────────────────────────────────────────────
+  performance:
+    name: Performance Budget Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Cache node modules
+        uses: actions/cache@v4
+        id: cache-node-modules
+        with:
+          path: node_modules
+          key: ${{ runner.os }}-node-${{ env.NODE_VERSION }}-${{ hashFiles('package-lock.json') }}
+
+      - name: Install dependencies
+        if: steps.cache-node-modules.outputs.cache-hit != 'true'
+        run: npm ci --legacy-peer-deps
+
+      - name: Run performance benchmark
+        run: npm run performance:benchmark
+
   # ─────────────────────────────────────────────────────────
   # Merge Protection (only on PRs)
   # ─────────────────────────────────────────────────────────
@@ -495,6 +525,7 @@ jobs:
         rust-build,
         load-test,
         bundle-size,
+        performance,
       ]
     steps:
       - name: All checks passed
@@ -521,6 +552,7 @@ jobs:
         rust-build,
         load-test,
         bundle-size,
+        performance,
       ]
     steps:
       - name: Check for failures
@@ -539,7 +571,8 @@ jobs:
              [ "${{ needs.rust-tests.result }}" != "success" ] || \
              [ "${{ needs.rust-build.result }}" != "success" ] || \
              [ "${{ needs.load-test.result }}" != "success" ] || \
-             [ "${{ needs.bundle-size.result }}" != "success" ]; then
+             [ "${{ needs.bundle-size.result }}" != "success" ] || \
+             [ "${{ needs.performance.result }}" != "success" ]; then
             echo "One or more CI checks failed"
             exit 1
           fi

package.json

@@ -19,6 +19,7 @@
     "test": "jest --passWithNoTests",
     "test:coverage": "jest --coverage",
     "performance:ci": "node scripts/check-performance-budget.js",
+    "performance:benchmark": "node scripts/check-performance-budget.js",
     "mutation:test": "npx --yes @stryker-mutator/core@9.0.0 run",
     "build": "expo export",
     "build:android": "expo run:android --variant release",