chore: add support for running CI workflow in local using ACT tool

.github/workflows/build.yml

@@ -8,25 +8,41 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
       - uses: actions/setup-java@v3
         with:
           distribution: temurin
           java-version: '21'
           cache: maven
-
+
+      - uses: stCarolas/setup-maven@v5
+        with:
+          maven-version: '3.9.11'
+          cache: true
+
+      - if: ${{ env.ACT }}
+        name: Install system deps for ACT
+        run: |
+          sudo apt-get -q update
+          sudo apt-get install -y -qq xorg xvfb
+
       - name: Cache Tycho/P2 dependencies
         uses: actions/cache@v3
         with:
           path: ~/.m2/repository/.cache/tycho
           key: ${{ runner.os }}-tycho-${{ hashFiles('**/pom.xml') }}
           restore-keys: |
             ${{ runner.os }}-tycho-
-      
+
       - name: Build and Test with Maven
         run: |
           export DISPLAY=:99
-          xvfb-run -a mvn -B verify
-      
+          xvfb-run -a mvn -ntp -B verify
+
       - name: Upload test logs
         if: failure()
         uses: actions/upload-artifact@v4

TESTING.md

@@ -39,6 +39,29 @@ For manual validation of REST endpoints:
 3. Use REST client tools to test endpoints
 4. Verify operations in Eclipse workspace
 
+### Running CI Workflow Locally with act
+
+You can run the GitHub Actions CI workflow locally using the [act](https://github.com/nektos/act) tool. This simulates the CI build and test steps on your machine.
+
+#### Install act
+```bash
+brew install act # macOS
+# or see https://github.com/nektos/act for other platforms
+```
+
+#### Run the workflow
+```bash
+act pull_request -W .github/workflows/build.yml --artifact-server-path /tmp/artifacts --container-architecture linux/amd64
+```
+
+This command:
+- Uses the workflow in `.github/workflows/build.yml`
+- Stores workflow artifacts in `/tmp/artifacts`
+- Uses the `linux/amd64` container architecture (recommended for Tycho/Eclipse builds)
+
+**Note:**
+- The act tool is for local simulation only; actual CI runs on GitHub Actions.
+
 ## Test Coverage Areas
 
 ### Core Functionality