Refactor CI workflow for improved clarity

Author: qadult0

.github/workflows/ci.yml

@@ -9,6 +9,7 @@ on:
 jobs:
   build:
     runs-on: ubuntu-latest
+
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -34,38 +35,42 @@ jobs:
           echo "Repository root:"
           ls -la
 
-      - name: Detect languages and install/build/test
+      - name: Detect languages and install / build / test
         run: |
           set -e
           echo "Repository contents:"
           ls -la || true
 
-          # NODE: prefer lockfile installs, fall back to normal install
+          # -------- Node.js --------
           if [ -f package.json ]; then
             echo ""
             echo "Detected Node.js project (package.json found)"
+
             if [ -f package-lock.json ]; then
-              echo "Found package-lock.json → running: npm ci"
+              echo "Found package-lock.json -> running: npm ci"
+              npm ci
+            elif [ -f npm-shrinkwrap.json ]; then
+              echo "Found npm-shrinkwrap.json -> running: npm ci"
               npm ci
             elif [ -f pnpm-lock.yaml ]; then
-              echo "Found pnpm-lock.yaml → running: pnpm install --frozen-lockfile"
+              echo "Found pnpm-lock.yaml -> running: pnpm install --frozen-lockfile"
               npm i -g pnpm || true
               pnpm install --frozen-lockfile || pnpm install
             elif [ -f yarn.lock ]; then
-              echo "Found yarn.lock → running: yarn install --frozen-lockfile"
+              echo "Found yarn.lock -> running: yarn install --frozen-lockfile"
               yarn install --frozen-lockfile || yarn install
             else
-              echo "No lockfile found → running: npm install (will create package-lock.json locally)"
+              echo "No lockfile found -> running: npm install (safe fallback)"
               npm install
             fi
 
-            # build if script exists
+            # run build script if present
             if npm run | sed -n '1,200p' | grep -q " build"; then
               echo "Running npm run build"
               npm run build || true
             fi
 
-            # run tests if any
+            # run tests if present
             if npm test --silent 2>/dev/null; then
               echo "Running npm test"
               npm test || true
@@ -74,7 +79,7 @@ jobs:
             echo "No package.json found, skipping Node steps"
           fi
 
-          # PYTHON
+          # -------- Python --------
           if [ -f requirements.txt ] || [ -f pyproject.toml ] || [ -f setup.py ]; then
             echo ""
             echo "Detected Python project"
@@ -97,7 +102,7 @@ jobs:
             echo "No Python packaging files detected"
           fi
 
-          # GO
+          # -------- Go --------
           if ls *.go >/dev/null 2>&1 || [ -d cmd ]; then
             echo ""
             echo "Detected Go project"
@@ -109,10 +114,10 @@ jobs:
             echo "No Go files detected"
           fi
 
-          # Makefile
+          # -------- Makefile --------
           if [ -f Makefile ]; then
             echo ""
-            echo "Makefile found — running build/test if present"
+            echo "Makefile found — running build/test targets if present"
             if grep -qE '^build:' Makefile; then
               make build || true
             fi