browser-debug-mcp-bridge 1.12.0 → 1.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-debug-mcp-bridge",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "Chrome Extension + Node.js MCP server for browser debugging",
   "private": false,
   "publishConfig": {
@@ -8,13 +8,17 @@
   },
   "files": [
     "scripts/mcp-start.cjs",
+    "scripts/browser-debug-cli.cjs",
+    ".agents/skills/browser-debug-cli/**/*",
     "apps/mcp-server/dist/**/*",
     "apps/mcp-server/package.json",
     "README.md",
     "LICENSE"
   ],
   "bin": {
-    "browser-debug-mcp-bridge": "scripts/mcp-start.cjs"
+    "browser-debug-mcp-bridge": "scripts/mcp-start.cjs",
+    "bdmcp": "scripts/browser-debug-cli.cjs",
+    "browser-debug-cli": "scripts/browser-debug-cli.cjs"
   },
   "scripts": {
     "typecheck": "nx run-many -t lint --projects mcp-server,chrome-extension,shared,redaction,selectors,mcp-contracts",
@@ -22,14 +26,15 @@
     "test:non-e2e": "nx run-many -t test --exclude=e2e-playwright",
     "lint": "nx run-many -t lint",
     "build": "nx run-many -t build",
-    "verify:ci": "pnpm typecheck && pnpm lint && pnpm test:non-e2e && pnpm build && pnpm docs:ci && pnpm mcp:check-stdio-guard",
-    "verify": "pnpm typecheck && pnpm lint && pnpm test && pnpm build && pnpm docs:ci && pnpm mcp:check-stdio-guard",
+    "verify:ci": "pnpm typecheck && pnpm lint && pnpm test:non-e2e && pnpm build && pnpm docs:ci && pnpm mcp:check-stdio-guard && pnpm mcp:package-smoke",
+    "verify": "pnpm typecheck && pnpm lint && pnpm test && pnpm build && pnpm docs:ci && pnpm mcp:check-stdio-guard && pnpm mcp:package-smoke",
     "serve": "nx serve mcp-server",
     "mcp:start": "node scripts/mcp-start.cjs",
     "mcp:diagnose": "node tools/mcp/diagnose-bridge.mjs",
     "mcp:doctor": "node tools/mcp/diagnose-bridge.mjs",
     "mcp:doctor:json": "node tools/mcp/diagnose-bridge.mjs --json",
     "mcp:smoke": "node tools/mcp/diagnose-bridge.mjs --smoke",
+    "mcp:package-smoke": "node tools/mcp/package-smoke.mjs",
     "build:mcp-runtime": "pnpm -C apps/mcp-server build",
     "prepack": "pnpm run build:mcp-runtime",
     "docs:dev": "nx serve docs",
@@ -64,7 +69,7 @@
   "license": "ISC",
   "packageManager": "pnpm@10.28.2",
   "engines": {
-    "node": ">=20"
+    "node": ">=22.19"
   },
   "devDependencies": {
     "@docusaurus/core": "^3.10.1",
@@ -101,8 +106,10 @@
     "@modelcontextprotocol/sdk": "^1.27.1",
     "better-sqlite3": "^12.6.2",
     "cheerio": "^1.2.0",
+    "chrome-launcher": "1.2.1",
     "fastify": "^5.7.4",
     "jszip": "^3.10.1",
+    "lighthouse": "13.3.0",
     "tsx": "^4.21.0",
     "ws": "^8.19.0",
     "zod": "^4.3.6"

package/scripts/browser-debug-cli.cjs

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+const { spawn } = require('node:child_process');
+const { existsSync } = require('node:fs');
+const { dirname, join, resolve } = require('node:path');
+const { createRequire } = require('node:module');
+
+const repoRoot = resolve(__dirname, '..');
+const distEntry = join(repoRoot, 'apps', 'mcp-server', 'dist', 'cli', 'main.js');
+const sourceEntry = join(repoRoot, 'apps', 'mcp-server', 'src', 'cli', 'main.ts');
+const localRequire = createRequire(join(repoRoot, 'package.json'));
+
+function resolveRuntimePath(specifier) {
+  try {
+    return localRequire.resolve(specifier);
+  } catch {
+    return '';
+  }
+}
+
+function resolveFromPackage(packageName, relativePath) {
+  const packageJsonPath = resolveRuntimePath(`${packageName}/package.json`);
+  if (!packageJsonPath) return '';
+  const candidate = join(dirname(packageJsonPath), relativePath);
+  return existsSync(candidate) ? candidate : '';
+}
+
+function resolveBinFallback(name) {
+  const cmdSuffix = process.platform === 'win32' ? '.cmd' : '';
+  const candidate = join(repoRoot, 'node_modules', '.bin', `${name}${cmdSuffix}`);
+  return existsSync(candidate) ? candidate : '';
+}
+
+const tsxCli =
+  resolveRuntimePath('tsx/dist/cli.mjs') ||
+  resolveFromPackage('tsx', 'dist/cli.mjs') ||
+  resolveBinFallback('tsx');
+
+function spawnCli(runtime, entry, args) {
+  const child =
+    runtime === 'dist'
+      ? spawn(process.execPath, [entry, ...args], {
+          cwd: process.cwd(),
+          env: process.env,
+          stdio: 'inherit',
+        })
+      : spawn(
+          tsxCli.endsWith('.cmd') ? tsxCli : process.execPath,
+          tsxCli.endsWith('.cmd') ? [entry, ...args] : [tsxCli, entry, ...args],
+          {
+            cwd: process.cwd(),
+            env: process.env,
+            stdio: 'inherit',
+          },
+        );
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exit(code ?? 0);
+  });
+
+  child.on('error', (error) => {
+    process.stderr.write(`[bdmcp] Failed to launch CLI: ${error.message}\n`);
+    process.exit(1);
+  });
+}
+
+const args = process.argv.slice(2);
+
+if (existsSync(distEntry)) {
+  spawnCli('dist', distEntry, args);
+} else if (existsSync(sourceEntry) && existsSync(tsxCli)) {
+  spawnCli('tsx', sourceEntry, args);
+} else {
+  process.stderr.write('[bdmcp] Missing CLI runtime. Build mcp-server first or install package dependencies.\n');
+  process.exit(1);
+}