feat(coverage-matrix): add SDK coverage matrix dashboard

Add a coverage matrix tool that automatically discovers all @forgerock/*
package exports and measures test coverage across unit tests, type tests,
and e2e tests — with zero manual path maintenance.

Pipeline (all via Nx):
  pnpm nx run @forgerock/coverage-matrix:coverage-report

- Discovers packages from workspace package.json exports fields
- Extracts public exports via TypeScript AST
- Collects V8 unit coverage from Vitest
- Collects V8 e2e coverage from Playwright's built-in CDP API
- Merges into a per-export coverage matrix
- Builds a Svelte dashboard deployable to GitHub Pages

E2E coverage uses Playwright's page.coverage.startJSCoverage() —
no instrumented builds, no Vite plugins, no Nx cache concerns.
The @forgerock/e2e-shared package provides a coverage fixture that
all 26 e2e test files import for automatic collection.

CI integration:
- Non-blocking coverage-report step in PR workflow
- Coverage summary posted as PR comment
- Dashboard deployed to GitHub Pages on merge to main

Author: ryanbas21

.github/workflows/ci.yml

@@ -134,3 +134,57 @@ jobs:
 
             ---
             <sub>🔄 Updated automatically on each push to this PR</sub>
+
+      # Coverage Matrix (non-blocking)
+      # Runs the full pipeline: analyze exports, collect V8 unit coverage,
+      # merge into final matrix, and build the Svelte dashboard.
+      # Zero manual path maintenance — discovers packages and exports automatically.
+      - name: Generate coverage matrix and build dashboard
+        continue-on-error: true
+        run: pnpm nx run @forgerock/coverage-matrix:coverage-report
+
+      - name: Generate coverage matrix summary
+        continue-on-error: true
+        id: coverage-matrix-summary
+        run: |
+          node -e "
+            const fs = require('fs');
+            try {
+              const data = JSON.parse(fs.readFileSync('tools/coverage-matrix/data/coverage-matrix.json', 'utf-8'));
+              const rows = data.packages.map(p => {
+                const s = p.summary;
+                const uPct = s.totalExports > 0 ? Math.round(s.unitCovered / s.totalExports * 100) : 0;
+                const ePct = s.totalExports > 0 ? Math.round(s.e2eCovered / s.totalExports * 100) : 0;
+                const fPct = s.totalSourceFiles > 0 ? Math.round(s.unitTestedFiles / s.totalSourceFiles * 100) : 0;
+                return '| ' + p.name + ' | ' + s.totalExports + ' | ' + fPct + '% (' + s.unitTestedFiles + '/' + s.totalSourceFiles + ') | ' + uPct + '% | ' + ePct + '% | ' + s.uncovered + ' |';
+              });
+              const table = '| Package | Exports | Unit Files | Unit Exports | E2E | Uncovered |\n|---------|---------|------------|--------------|-----|-----------|' + '\n' + rows.join('\n');
+              fs.appendFileSync(process.env.GITHUB_OUTPUT, 'table<<EOF\n' + table + '\nEOF\n');
+            } catch (e) {
+              fs.appendFileSync(process.env.GITHUB_OUTPUT, 'table=Coverage matrix data not available.\n');
+            }
+          "
+
+      - name: Post coverage matrix PR comment
+        continue-on-error: true
+        if: github.event_name == 'pull_request'
+        uses: peter-evans/create-or-update-comment@v4
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          body: |
+            <!-- coverage-matrix -->
+            ## Coverage Matrix
+
+            ${{ steps.coverage-matrix-summary.outputs.table }}
+
+            [Full dashboard](https://forgerock.github.io/ping-javascript-sdk/coverage-matrix/)
+
+      - name: Deploy dashboard to GitHub Pages
+        continue-on-error: true
+        if: github.ref == 'refs/heads/main'
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./tools/coverage-matrix/dist
+          destination_dir: coverage-matrix
+          keep_files: true

.gitignore

@@ -85,3 +85,4 @@ test-output
 # Gemini local knowledge base files
 GEMINI.md
 **/GEMINI.md
+.e2e-coverage/

e2e/davinci-suites/package.json

@@ -17,5 +17,8 @@
   "main": "src/index.js",
   "nx": {
     "implicitDependencies": ["@forgerock/davinci-app", "@forgerock/mock-api-v2"]
+  },
+  "dependencies": {
+    "@forgerock/e2e-shared": "workspace:*"
   }
 }

e2e/davinci-suites/src/basic.test.ts

@@ -4,7 +4,7 @@
  * This software may be modified and distributed under the terms
  * of the MIT license. See the LICENSE file for details.
  */
-import { expect, test } from '@playwright/test';
+import { expect, test } from '@forgerock/e2e-shared/coverage-fixture';
 import { asyncEvents } from './utils/async-events.js';
 import { password, username } from './utils/demo-user.js';
 

e2e/davinci-suites/src/fido.test.ts

@@ -1,4 +1,4 @@
-import { test, expect, CDPSession } from '@playwright/test';
+import { test, expect, CDPSession } from '@forgerock/e2e-shared/coverage-fixture';
 import { asyncEvents } from './utils/async-events.js';
 
 const username = 'JSFidoUser@user.com';

e2e/davinci-suites/src/form-fields.test.ts

@@ -4,7 +4,7 @@
  * This software may be modified and distributed under the terms
  * of the MIT license. See the LICENSE file for details.
  */
-import { expect, test } from '@playwright/test';
+import { expect, test } from '@forgerock/e2e-shared/coverage-fixture';
 
 import { asyncEvents } from './utils/async-events.js';
 

e2e/davinci-suites/src/logging.test.ts

@@ -4,7 +4,7 @@
  * This software may be modified and distributed under the terms
  * of the MIT license. See the LICENSE file for details.
  */
-import { expect, test } from '@playwright/test';
+import { expect, test } from '@forgerock/e2e-shared/coverage-fixture';
 import { asyncEvents } from './utils/async-events.js';
 import { password, username } from './utils/demo-user.js';
 

e2e/davinci-suites/src/mfa.test.ts

@@ -4,7 +4,7 @@
  * This software may be modified and distributed under the terms
  * of the MIT license. See the LICENSE file for details.
  */
-import { expect, test } from '@playwright/test';
+import { expect, test } from '@forgerock/e2e-shared/coverage-fixture';
 import { asyncEvents } from './utils/async-events.js';
 import { password } from './utils/demo-user.js';
 

e2e/davinci-suites/src/middleware.test.ts

@@ -4,7 +4,7 @@
  * This software may be modified and distributed under the terms
  * of the MIT license. See the LICENSE file for details.
  */
-import { expect, test } from '@playwright/test';
+import { expect, test } from '@forgerock/e2e-shared/coverage-fixture';
 import { asyncEvents } from './utils/async-events.js';
 import { password, username } from './utils/demo-user.js';
 

e2e/davinci-suites/src/phone-number-field.test.ts

@@ -4,7 +4,7 @@
  * This software may be modified and distributed under the terms
  * of the MIT license. See the LICENSE file for details.
  */
-import { expect, test } from '@playwright/test';
+import { expect, test } from '@forgerock/e2e-shared/coverage-fixture';
 import { password } from './utils/demo-user.js';
 
 test.describe('Device registration tests', () => {