ci: headless tests with coverage and OpenAPI contract validation

- twd-cli, vite-plugin-istanbul and nyc as devDependencies
- twd.config.json points puppeteer at :3000, instruments coverage to
  ./coverage / .nyc_output and validates mocks against
  contracts/todos-3.0.json (strict, error mode, /api baseUrl)
- vite.config.ts wires vite-plugin-istanbul (requireEnv off in CI)
- npm scripts: dev:ci, test:ci, collect:coverage:{text,html,lcov}
- GitHub Actions workflow boots dev:ci, runs the BRIKEV/twd-cli action
  with contract-report enabled, then prints text coverage; granted
  pull-requests: write so the action can post the contract summary

Author: kevinccbsg

.github/workflows/ci.yml

@@ -2,30 +2,42 @@ name: CI - twd tests
 
 on:
   push:
-    branches: [ main ]
+    branches: [main]
   pull_request:
-    branches: [ main ]
+    branches: [main]
+
+permissions:
+  pull-requests: write
 
 jobs:
   test:
     runs-on: ubuntu-latest
 
     steps:
-      - name: Checkout repository
-        uses: actions/checkout@v5
+      - uses: actions/checkout@v5
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v5
+      - uses: actions/setup-node@v5
         with:
           node-version: 24
-          cache: 'npm'
+          cache: npm
 
       - name: Install dependencies
         run: npm ci
 
-      - name: Start Vite dev server
+      - name: Install mock service worker
+        run: npx twd-js init public --save
+
+      - name: Start dev server
         run: |
-          nohup npm run dev > vite.log 2>&1 &
-          npx wait-on http://localhost:5173
+          nohup npm run dev:ci > /dev/null 2>&1 &
+          npx wait-on http://localhost:3000
         env:
           CI: true
+
+      - name: Run TWD tests
+        uses: BRIKEV/twd-cli/.github/actions/run@main
+        with:
+          contract-report: 'true'
+
+      - name: Display coverage
+        run: npm run collect:coverage:text

.gitignore

@@ -11,3 +11,6 @@ dist-ssr
 .vinxi
 __unconfig*
 todos.json
+coverage
+.nyc_output
+.twd