feat(ci): add test matrix for CI workflow, fix docs, fix arch mapping + include arm64 (#87)

* add test matrix
from #85

* os.arch() can not return x32, also return arm64, cannot return aarch64 as suggested in #85

Author: zerosnacks

.github/workflows/ci.yml

@@ -19,6 +19,58 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  test:
+    runs-on: ${{ matrix.config.os }}
+    strategy:
+      matrix:
+        # Note: GitHub does not host Alpine runners, so we skip testing there for now.
+        config:
+          - { os: ubuntu-latest, arch: x64 } # foundry_v[ersion]_linux_amd64.tar.gz
+          - { os: ubuntu-24.04-arm, arch: arm64 } # foundry_v[ersion]_linux_arm64.tar.gz
+          - { os: macos-latest, arch: arm64 } # foundry_v[ersion]_darwin_arm64.tar.gz
+          - { os: macos-15-intel, arch: x64 } # foundry_v[ersion]_darwin_amd64.tar.gz
+          - { os: windows-latest, arch: x64 } # foundry_v[ersion]_windows_amd64.zip
+        version: [stable, nightly]
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          persist-credentials: false
+
+      - name: Use Node.js 24.x
+        uses: actions/setup-node@v5
+        with:
+          node-version: 24.x
+
+      - name: Install dependencies
+        run: npm ci --ignore-scripts
+
+      - name: Rebuild dist/
+        run: npm run build
+
+      - name: Test action installation (${{ matrix.version }})
+        uses: ./
+        with:
+          version: ${{ matrix.version }}
+          cache: false
+
+      - name: Verify Foundry installation
+        shell: bash
+        run: |
+          forge --version
+          cast --version
+          anvil --version
+          chisel --version
+
+      - name: Test basic Foundry functionality
+        shell: bash
+        run: |
+          forge init test-project --force
+          cd test-project
+          forge build
+          forge test -vvv
+
   match:
     runs-on: ubuntu-latest
     permissions:
@@ -27,6 +79,7 @@ jobs:
       - uses: actions/checkout@v5
         with:
           persist-credentials: false
+
       - name: Use Node.js 24.x
         uses: actions/setup-node@v5
         with:
@@ -106,6 +159,7 @@ jobs:
     runs-on: ubuntu-latest
     if: always()
     needs:
+      - test
       - match
       - codeql
     timeout-minutes: 30

.nvmrc

@@ -1 +1 @@
-v24.8.0
+v24.9.0

README.md

@@ -131,10 +131,10 @@ When opening a PR, you must build the action exactly following the below steps f
 Install [nvm](https://github.com/nvm-sh/nvm).
 
 ```console
-$ nvm install 24.8.0
+$ nvm install 24.9.0
 $ nvm use
-$ npm ci
+$ npm ci --ignore-scripts
 $ npm run build
 ```
 
-You **must** use the Node.js version `24.8.0` to build.
+You **must** use the Node.js version `24.9.0` to build.

dist/index.js

@@ -45522,8 +45522,8 @@ function normalizeVersionName(version) {
 
 function mapArch(arch) {
   const mappings = {
-    x32: "386",
     x64: "amd64",
+    arm64: "arm64",
   };
 
   return mappings[arch] || arch;

dist/index.js.map

@@ -6,8 +6,8 @@ function normalizeVersionName(version) {
 
 function mapArch(arch) {
   const mappings = {
-    x32: "386",
     x64: "amd64",
+    arm64: "arm64",
   };
 
   return mappings[arch] || arch;