Merge branch 'main' into telemetry/clearcut-logger-02

Author: ergunsh

.github/workflows/pre-release.yml

@@ -3,6 +3,7 @@ name: Pre-release
 permissions: read-all
 
 on:
+  workflow_dispatch:
   push:
     branches:
       - release-please-*
@@ -23,10 +24,5 @@ jobs:
           cache: npm
           node-version-file: '.nvmrc'
 
-      - name: Install MCP Publisher
-        run: |
-          export OS=$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
-          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_${OS}.tar.gz" | tar xz mcp-publisher
-
       - name: Verify server.json
         run: npm run verify-server-json-version

.github/workflows/run-tests.yml

@@ -57,15 +57,10 @@ jobs:
         shell: bash
         run: echo 0 | sudo tee /proc/sys/kernel/apparmor_restrict_unprivileged_userns
 
-      - name: Run tests (node20)
-        if: ${{ matrix.node == '20' }}
-        shell: bash
-        run: npm run test:node20
-
       - name: Run tests
         shell: bash
-        if: ${{ matrix.node != '20' }}
-        run: npm run test:no-build
+        # Retry tests if they fail in the merge queue.
+        run: npm run test:no-build -- ${{ github.event_name == 'merge_group' && '--retry' || '' }}
 
   # Gating job for branch protection.
   test-success:

GEMINI.md

@@ -1,4 +1,6 @@
 # Instructions
 
-- use `npm run build` to run tsc and test build
-- use `npm run test` to run tests, run all tests to verify correctness
+- Use only scripts from `package.json` to run commands.
+- Use `npm run build` to run tsc and test build.
+- Use `npm run test` to build and run tests, run all tests to verify correctness.
+- use `npm run test path-to-test.ts` to build and run a single test file, for example, `npm run test tests/McpContext.test.ts`.

README.md

@@ -94,7 +94,7 @@ Chrome DevTools MCP will not start the browser instance automatically using this
     Use the Claude Code CLI to add the Chrome DevTools MCP server (<a href="https://code.claude.com/docs/en/mcp">guide</a>):
 
 ```bash
-claude mcp add chrome-devtools npx chrome-devtools-mcp@latest
+claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest
 ```
 
 </details>

docs/tool-reference.md

@@ -234,14 +234,17 @@
 
 - **autoStop** (boolean) **(required)**: Determines if the trace recording should be automatically stopped.
 - **reload** (boolean) **(required)**: Determines if, once tracing has started, the page should be automatically reloaded.
+- **filePath** (string) _(optional)_: The absolute file path, or a file path relative to the current working directory, to save the raw trace data. For example, trace.json.gz (compressed) or trace.json (uncompressed).
 
 ---
 
 ### `performance_stop_trace`
 
 **Description:** Stops the active performance trace recording on the selected page.
 
-**Parameters:** None
+**Parameters:**
+
+- **filePath** (string) _(optional)_: The absolute file path, or a file path relative to the current working directory, to save the raw trace data. For example, trace.json.gz (compressed) or trace.json (uncompressed).
 
 ---
 

eslint.config.mjs

@@ -60,6 +60,7 @@ export default defineConfig([
     name: 'TypeScript rules',
     rules: {
       '@local/check-license': 'error',
+      curly: ['error', 'all'],
 
       'no-undef': 'off',
       'no-unused-vars': 'off',

package-lock.json

@@ -16,12 +16,10 @@
     "docs:generate": "node --experimental-strip-types scripts/generate-docs.ts",
     "start": "npm run build && node build/src/index.js",
     "start-debug": "DEBUG=mcp:* DEBUG_COLORS=false npm run build && node build/src/index.js",
-    "test:node20": "node --import ./build/tests/setup.js --test-reporter spec --test-force-exit --test build/tests",
-    "test:no-build": "node --import ./build/tests/setup.js --no-warnings=ExperimentalWarning --experimental-print-required-tla --test-reporter spec --test-force-exit --test \"build/tests/**/*.test.js\"",
-    "test": "npm run build && npm run test:no-build",
-    "test:only": "npm run build && npm run test:only:no-build",
-    "test:only:no-build": "node --import ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
-    "test:update-snapshots": "npm run build && node --import ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-force-exit --test --test-update-snapshots \"build/tests/**/*.test.js\"",
+    "test": "npm run build && node scripts/test.mjs",
+    "test:no-build": "node scripts/test.mjs",
+    "test:only": "npm run build && node scripts/test.mjs --test-only",
+    "test:update-snapshots": "npm run build && node scripts/test.mjs --test-update-snapshots",
     "prepare": "node --experimental-strip-types scripts/prepare.ts",
     "verify-server-json-version": "node --experimental-strip-types scripts/verify-server-json-version.ts"
   },
@@ -53,7 +51,7 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1566234",
+    "chrome-devtools-frontend": "1.0.1567721",
     "core-js": "3.47.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",