fix cache issue

Author: jagan-jaya

.github/workflows/cypress.yml

@@ -1,6 +1,12 @@
 # Cypress E2E Tests
 #
-# Single job: builds the Decision Engine, starts all services, runs all specs.
+# Single job, three parallel workers (background processes).
+# Mirrors `just cypress-parallel` locally — same split, same runner.
+#
+# Workers:
+#   worker-1  — general UI specs
+#   worker-2  — euclid rule-builder specs
+#   worker-3  — API specs
 #
 # Caching layers:
 #   - Docker BuildKit layers → GHA cache, scoped per branch.
@@ -110,43 +116,37 @@ jobs:
           BASE_URL: http://localhost:8080
           ADMIN_SECRET: test_admin
 
-      # ── Start UI dev server ───────────────────────────────────────────────
-      # Use the Vite dev server, NOT vite build + vite preview.
-      #
-      # vite preview has no proxy, so API calls from the browser go directly to
-      # http://localhost:8080 — a different origin (cross-origin from port 5173).
-      # The decision engine does not emit CORS headers for localhost:5173, so the
-      # browser blocks every API call and the app renders blank.
-      #
-      # The Vite dev server proxies /decision-engine-api/* → http://localhost:8080
-      # (same origin, no CORS). It also uses base '/' so routes are at the root —
-      # no /decision-engine prefix in CYPRESS_UI_BASE_URL needed.
-      - name: Start UI dev server
-        run: npx vite --port 5173 &
+      # ── Build + serve UI ─────────────────────────────────────────────────
+      # Build first so import/compile errors (e.g. missing React hooks) fail
+      # fast with a clear message before Cypress even starts.
+      # vite preview has a proxy configured in vite.config.ts (same routes as
+      # the dev server), so API calls are forwarded to http://localhost:8080
+      # without CORS issues.
+      - name: Build UI
+        run: npx vite build
+        working-directory: website
+
+      - name: Start UI preview server
+        run: npx vite preview --port 5173 --host &
         working-directory: website
 
       - name: Wait for UI
         run: |
           timeout 60 bash -c \
             'until curl -sf http://localhost:5173; do sleep 2; done'
 
-      # ── Run all Cypress specs ─────────────────────────────────────────────
-      # Includes: all UI tests + all API tests.
-      # Excludes: cypress/e2e/runtime/ — runtime-smoke.cy.js calls
-      #   waitForRuntimeSurface() which requires the Mintlify docs server.
-      #   Mintlify is only present in the dashboard-* compose profiles,
-      #   not in postgres-local. Add it here if that profile is adopted.
+      - name: Install just
+        run: curl --proto '=https' --tlsv1.2 -sSf https://just.systems/install.sh | bash -s -- --to /usr/local/bin
+
+      # ── Run all Cypress specs across 3 parallel workers ───────────────────
+      # Delegates to `just cypress-parallel` — identical to local runs.
       - name: Run Cypress
-        run: |
-          npx cypress run \
-            --spec "cypress/e2e/ui/**/*.cy.js,cypress/e2e/api/**/*.cy.js" \
-            --headless
+        run: just cypress-parallel
         env:
           CYPRESS_API_BASE_URL: http://localhost:8080
           CYPRESS_UI_BASE_URL: http://localhost:5173
           CYPRESS_RUNTIME_MODE: ci
 
-
       - name: Upload screenshots on failure
         uses: actions/upload-artifact@v4
         if: failure()

justfile

@@ -75,7 +75,7 @@ test *FLAGS:
     cargo test {{ FLAGS }}
 alias t := test
 
-# Run all Cypress E2E tests headlessly (replicates CI behaviour)
+# Run all Cypress E2E tests headlessly (replicates CI behaviour — single browser, sequential)
 cypress:
     npx cypress run --spec "cypress/e2e/ui/**/*.cy.js,cypress/e2e/api/**/*.cy.js" --headless
 alias cy := cypress
@@ -84,6 +84,43 @@ alias cy := cypress
 cypress-spec spec:
     npx cypress run --spec "{{ spec }}" --headless
 
+# Run all Cypress E2E tests across 3 balanced parallel workers.
+#
+# Split is based on measured spec durations (see worker comments).
+# Euclid specs are distributed across all three workers so no single
+# worker is left idle while another finishes the euclid suite alone.
+#
+#   Worker 1 ~78s — heavy euclid:  builder(1:07) + enum-operators(0:11)
+#   Worker 2 ~75s — medium euclid: e2e(0:36)     + lifecycle(0:39)
+#   Worker 3 ~86s — fast euclid + general UI + API:
+#                   nested-branches(0:09) + volume-split-priority(0:14) +
+#                   volume-split(0:14) + all general UI(0:35) + all API(0:14)
+cypress-parallel:
+    #!/usr/bin/env bash
+    set -uo pipefail
+
+    npx cypress run --headless \
+      --spec "cypress/e2e/ui/euclid-rules-builder.cy.js,cypress/e2e/ui/euclid-rules-enum-operators.cy.js" \
+      2>&1 | sed 's/^/[worker-1] /' &
+    pid1=$!
+
+    npx cypress run --headless \
+      --spec "cypress/e2e/ui/euclid-rules-e2e.cy.js,cypress/e2e/ui/euclid-rules-lifecycle.cy.js" \
+      2>&1 | sed 's/^/[worker-2] /' &
+    pid2=$!
+
+    npx cypress run --headless \
+      --spec "cypress/e2e/ui/euclid-rules-nested-branches.cy.js,cypress/e2e/ui/euclid-rules-volume-split-priority.cy.js,cypress/e2e/ui/euclid-rules-volume-split.cy.js,cypress/e2e/ui/analytics-page.cy.js,cypress/e2e/ui/auth-page.cy.js,cypress/e2e/ui/dashboard-overview.cy.js,cypress/e2e/ui/debit-routing-page.cy.js,cypress/e2e/ui/decision-explorer.cy.js,cypress/e2e/ui/payment-audit.cy.js,cypress/e2e/ui/volume-split-page.cy.js,cypress/e2e/api/**/*.cy.js" \
+      2>&1 | sed 's/^/[worker-3] /' &
+    pid3=$!
+
+    failed=0
+    wait "$pid1" || failed=1
+    wait "$pid2" || failed=1
+    wait "$pid3" || failed=1
+    exit "$failed"
+alias cyp := cypress-parallel
+
 # Run pre-commit checks
 precommit: fmt clippy