update

.biome.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.8.0/schema.json",
+  "files": {
+    "ignore": [
+      "**/node_modules/**",
+      "dist/**",
+      "coverage/**",
+      "src/__tests__/**",
+      "tests/**"
+    ]
+  },
+  "linter": {
+    "rules": {
+      "recommended": true
+    }
+  }
+}

.github/workflows/build.yml

@@ -0,0 +1,109 @@
+name: Lint/Test/Build
+
+on:
+  push:
+    branches: ["**"]
+    tags: [ 'v*.*.*' ]
+  pull_request:
+    branches: ["**"]
+
+jobs:
+  test-and-build:
+    name: Lint/Test/Build (Node 20)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Detect file changes
+        id: changes
+        uses: dorny/paths-filter@v3
+        with:
+          filters: |
+            docker:
+              - 'Dockerfile'
+              - 'docker-compose.yml'
+              - 'docker-compose.yaml'
+              - '.dockerignore'
+            docs:
+              - 'docs/**'
+
+      - name: Show change filters
+        run: |
+          echo "Docker files changed: ${{ steps.changes.outputs.docker }}"
+          echo "Docs files changed: ${{ steps.changes.outputs.docs }}"
+
+      - name: Use Node 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Check commit message (conventional commits)
+        run: npx commitlint --from=HEAD~1 --to=HEAD
+
+      - name: Run lint (Node 20)
+        run: npm run lint
+
+      - name: Run tests (Node 20)
+        run: npm test
+
+      - name: Run coverage (Node 20)
+        run: npm run test:coverage
+
+      - name: Upload coverage to CodeCov
+        uses: codecov/codecov-action@v5
+        with:
+          fail_ci_if_error: false
+
+      - name: Build (Node 20)
+        run: npm run build
+
+      - name: Build Docker image (no push, on Docker changes)
+        if: steps.changes.outputs.docker == 'true'
+        run: docker build -t mcp-playwright-ci:latest .
+
+  docs-build:
+    name: Docs Build (Docusaurus)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Detect docs changes
+        id: changes
+        uses: dorny/paths-filter@v3
+        with:
+          filters: |
+            docs:
+              - 'docs/**'
+
+      - name: Show change filters
+        run: |
+          echo "Docker files changed: ${{ steps.changes.outputs.docker }}"
+          echo "Docs files changed: ${{ steps.changes.outputs.docs }}"
+
+      - name: Use Node 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Build docs (Docusaurus)
+        if: steps.changes.outputs.docs == 'true'
+        env:
+          DOCS_ORG: ${{ github.repository_owner }}
+          DOCS_PROJECT: ${{ github.event.repository.name }}
+          DOCS_URL: https://${{ github.repository_owner }}.github.io
+          DOCS_BASE_URL: /${{ github.event.repository.name }}/
+        run: |
+          cd docs
+          npm ci
+          npm run build

.github/workflows/docker-publish.yml

@@ -0,0 +1,99 @@
+name: Docker Image Build/Push
+
+on:
+  push:
+    branches: ["**"]
+    tags:
+      - "v*.*.*"
+  pull_request:
+    branches: ["**"]
+  release:
+    types: [published, created]
+  workflow_dispatch:
+    inputs:
+      push_image:
+        description: "Set to true to force a push on manual runs"
+        required: false
+        default: "false"
+  workflow_call: {}
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    name: Docker Image (build/push)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    env:
+      PUSH_IMAGE: ${{ github.event_name == 'release' || startsWith(github.ref, 'refs/tags/v') || github.ref == 'refs/heads/main' || github.event.inputs.push_image == 'true' }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.release.tag_name || github.ref }}
+
+      - name: Detect docker file changes
+        id: changes
+        uses: dorny/paths-filter@v3
+        with:
+          filters: |
+            docker:
+              - 'Dockerfile'
+              - 'docker-compose.yml'
+              - 'docker-compose.yaml'
+              - '.dockerignore'
+
+      - name: Show docker change filters
+        run: 'echo "Docker files changed: ${{ steps.changes.outputs.docker }}"'
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: arm64,amd64
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Extract Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=semver,pattern=v{{version}},enable=${{ startsWith(github.ref, 'refs/tags/v') }}
+            type=semver,pattern=v{{major}}.{{minor}},enable=${{ startsWith(github.ref, 'refs/tags/v') }}
+            type=semver,pattern=v{{major}},enable=${{ startsWith(github.ref, 'refs/tags/v') }}
+            type=raw,value=latest,enable=${{ startsWith(github.ref, 'refs/tags/v') }}
+            type=ref,event=branch,enable=${{ !startsWith(github.ref, 'refs/tags/v') && github.event_name != 'release' }}
+
+      - name: Log in to GitHub Container Registry (main/tags only)
+        uses: docker/login-action@v3
+        if: env.PUSH_IMAGE == 'true'
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Image build/push (GHCR)
+        if: ${{ steps.changes.outputs.docker == 'true' || env.PUSH_IMAGE == 'true' || github.event_name == 'release' || startsWith(github.ref, 'refs/tags/v') }}
+        uses: docker/build-push-action@v5
+        env:
+          DOCS_ORG: ${{ github.repository_owner }}
+          DOCS_PROJECT: ${{ github.event.repository.name }}
+          DOCS_URL: https://${{ github.repository_owner }}.github.io
+          DOCS_BASE_URL: /${{ github.event.repository.name }}/
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: ${{ env.PUSH_IMAGE == 'true' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.github/workflows/docusaurus-gh-pages.yml

@@ -1,13 +1,8 @@
 name: Deploy Docusaurus documentation to GH Pages
 
 on:
-  # Runs on pushes targeting the default branch
   push:
     branches: ["main"]
-  pull_request:
-    branches: [ "main" ]
-
-  # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
 # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages

.github/workflows/release-please.yml

@@ -0,0 +1,22 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch: {}
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Release Please
+        uses: googleapis/release-please-action@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          command: manifest-pr
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json

.husky/commit-msg

@@ -0,0 +1 @@
+npx commitlint --edit "$1"

.husky/pre-commit

@@ -0,0 +1 @@
+npm test

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}

.release-please-template.hbs

@@ -0,0 +1,13 @@
+{{> header}}
+
+## What's Changed
+
+{{#each entries}}
+### {{title}}
+
+{{#each commits}}
+* {{subject}}{{#if scope}} ({{scope}}){{/if}}{{#if author}} by @{{author.login}}{{/if}}
+{{/each}}
+
+{{/each}}
+