ci: restructure workflow for parallel execution with dependency caching

- Add setup job that installs dependencies and caches them
- Split linting, type-checking, and testing into parallel jobs
- Update build job to depend on all parallel jobs
- All jobs now use cached dependencies for faster execution

Author: mnaimfaizy

.github/workflows/ci.yml

@@ -7,9 +7,11 @@ on:
     branches: [main, develop]
 
 jobs:
-  lint-and-test:
-    name: Lint, Type-Check, and Test
+  setup:
+    name: Setup Dependencies
     runs-on: ubuntu-latest
+    outputs:
+      cache-hit: ${{ steps.cache-node-modules.outputs.cache-hit }}
 
     steps:
       - name: Checkout code
@@ -21,15 +23,96 @@ jobs:
           node-version: "20"
           cache: "npm"
 
+      - name: Cache node modules
+        id: cache-node-modules
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
+      - name: Install dependencies
+        run: npm ci
+
+  lint:
+    name: Lint Code
+    runs-on: ubuntu-latest
+    needs: setup
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Restore cached dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+
       - name: Install dependencies
         run: npm ci
 
       - name: Run linter
         run: npm run lint
 
+  type-check:
+    name: Type Check
+    runs-on: ubuntu-latest
+    needs: setup
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Restore cached dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+
+      - name: Install dependencies
+        run: npm ci
+
       - name: Run type-check
         run: npx tsc --noEmit
 
+  test:
+    name: Run Tests
+    runs-on: ubuntu-latest
+    needs: setup
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Restore cached dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+
+      - name: Install dependencies
+        run: npm ci
+
       - name: Run tests
         run: npm run test:run
 
@@ -47,7 +130,7 @@ jobs:
   build:
     name: Build Application
     runs-on: ubuntu-latest
-    needs: lint-and-test
+    needs: [lint, type-check, test]
 
     steps:
       - name: Checkout code
@@ -59,6 +142,12 @@ jobs:
           node-version: "20"
           cache: "npm"
 
+      - name: Restore cached dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+
       - name: Install dependencies
         run: npm ci
 
@@ -88,6 +177,12 @@ jobs:
           node-version: "20"
           cache: "npm"
 
+      - name: Restore cached dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+
       - name: Install dependencies
         run: npm ci