openspec-playwright 0.3.55 → 0.3.57

package/dist/utils/mcp-tools.js

@@ -1,130 +0,0 @@
-/**
- * Shared utilities for Playwright MCP tool synchronization.
- * Parses @playwright/mcp README to extract browser_* tool names and
- * updates the Healer MCP tools table in SKILL.md.
- */
-import { execSync } from 'child_process';
-import { existsSync, readFileSync, writeFileSync } from 'fs';
-import { join } from 'path';
-import chalk from 'chalk';
-/** Cached directory for npm temp files */
-const TMP_DIR = '/tmp/openspec-pw-mcp';
-/**
- * Get the latest @playwright/mcp version from npm registry.
- * Falls back to cached README if network fails.
- */
-function getLatestVersion() {
-    try {
-        const json = execSync('npm show @playwright/mcp version --json', { stdio: 'pipe', encoding: 'utf-8' }).trim();
-        return JSON.parse(json);
-    }
-    catch {
-        return '0.0.68'; // fallback to known version
-    }
-}
-/**
- * Download and parse the @playwright/mcp README to extract all browser_* tools.
- */
-export function fetchMcpTools() {
-    const version = getLatestVersion();
-    const tmpPkg = join(TMP_DIR, 'package');
-    // Clean and prepare temp dir
-    execSync(`rm -rf ${TMP_DIR} && mkdir -p ${TMP_DIR}`, { stdio: 'pipe' });
-    // Download tarball
-    execSync(`cd ${TMP_DIR} && npm pack @playwright/mcp@${version} --pack-destination ${TMP_DIR}`, { stdio: 'pipe' });
-    const tarball = execSync(`ls -t ${TMP_DIR}/playwright-mcp-*.tgz | head -1`, { encoding: 'utf-8' }).trim();
-    execSync(`tar -xzf "${tarball}" -C ${TMP_DIR} --strip-components=1`, { stdio: 'pipe' });
-    const readme = readFileSync(join(TMP_DIR, 'README.md'), 'utf-8');
-    return parseToolsFromReadme(readme);
-}
-/**
- * Parse browser_* tools from the MCP README markdown.
- * Format:
- * - **browser_navigate**
- *   - Title: Navigate to a URL
- *   - Description: Navigate to a URL
- */
-function parseToolsFromReadme(readme) {
-    const tools = [];
-    // Match tool blocks: **browser_name** followed by Title and Description
-    const blockRegex = /- \*\*([a-z_]+)\*\*[\s\S]*?- Title: ([^\n]+)\n[\s\S]*?- Description: ([^\n]+)/g;
-    let match;
-    while ((match = blockRegex.exec(readme)) !== null) {
-        const name = match[1];
-        const title = match[2].trim();
-        const description = match[3].trim();
-        // Map tool name to Healer purpose
-        const purpose = mapToolToPurpose(name, title, description);
-        tools.push({ name, title, description, purpose });
-    }
-    return tools;
-}
-/** Map a browser_* tool to its Healer purpose in the SKILL */
-function mapToolToPurpose(name, title, description) {
-    const map = {
-        browser_navigate: 'Go to the failing test\'s page',
-        browser_snapshot: 'Get page structure to find equivalent selectors',
-        browser_console_messages: 'Diagnose JS errors that may cause failures',
-        browser_take_screenshot: 'Visually compare before/after fixes',
-        browser_run_code: 'Execute custom fix logic (optional)',
-    };
-    return map[name] || title;
-}
-/**
- * Update the Healer MCP tools table in SKILL.md.
- * Only syncs the 5 core Healer tools; all other MCP tools are
- * general-purpose automation not specific to healing.
- * Deduplicates by tool name.
- */
-export function updateSkillHealerTable(skillPath, tools) {
-    if (!existsSync(skillPath))
-        return;
-    const content = readFileSync(skillPath, 'utf-8');
-    // Only the 5 core Healer tools
-    const healerToolNames = [
-        'browser_navigate',
-        'browser_snapshot',
-        'browser_console_messages',
-        'browser_take_screenshot',
-        'browser_run_code',
-    ];
-    // Filter to healer tools, deduplicate by name
-    const healerTools = tools.filter(t => healerToolNames.includes(t.name));
-    const seen = new Set();
-    const unique = healerTools.filter(t => {
-        if (seen.has(t.name))
-            return false;
-        seen.add(t.name);
-        return true;
-    });
-    // Build new table rows
-    const rows = unique.map(t => `| \`${t.name}\` | ${t.purpose} |`).join('\n');
-    // Replace the existing table
-    const tableHeader = '| Tool | Purpose |';
-    const tableSep = '|------|---------|';
-    const start = content.indexOf(tableHeader);
-    const end = content.indexOf(tableSep, start + 1);
-    if (start === -1 || end === -1)
-        return;
-    const newSection = tableHeader + '\n' + tableSep + '\n' + rows;
-    const newContent = content.substring(0, start) +
-        newSection +
-        content.substring(end + tableSep.length);
-    writeFileSync(skillPath, newContent, 'utf-8');
-}
-/**
- * Main entry point: fetch tools and update SKILL.md.
- * Call this after installing the skill in init.ts and update.ts.
- */
-export function syncMcpTools(skillPath) {
-    try {
-        const tools = fetchMcpTools();
-        updateSkillHealerTable(skillPath, tools);
-        console.log(chalk.green(`  ✓ Healer tools synced from @playwright/mcp`));
-    }
-    catch (err) {
-        console.log(chalk.yellow(`  ⚠ Failed to sync MCP tools: ${err}`));
-        console.log(chalk.gray('  SKILL.md MCP tools table may be stale'));
-    }
-}
-//# sourceMappingURL=mcp-tools.js.map

package/dist/utils/mcp-tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-tools.js","sourceRoot":"","sources":["../../src/utils/mcp-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAa,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,0CAA0C;AAC1C,MAAM,OAAO,GAAG,sBAAsB,CAAC;AAUvC;;;GAGG;AACH,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CACnB,yCAAyC,EACzC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CACrC,CAAC,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC,CAAC,4BAA4B;IAC/C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAExC,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,OAAO,gBAAgB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAExE,mBAAmB;IACnB,QAAQ,CACN,MAAM,OAAO,gCAAgC,OAAO,uBAAuB,OAAO,EAAE,EACpF,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAC;IAEF,MAAM,OAAO,GAAG,QAAQ,CACtB,SAAS,OAAO,iCAAiC,EACjD,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CAAC,IAAI,EAAE,CAAC;IAET,QAAQ,CAAC,aAAa,OAAO,QAAQ,OAAO,uBAAuB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAExF,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;IACjE,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,MAAc;IAC1C,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,wEAAwE;IACxE,MAAM,UAAU,GAAG,gFAAgF,CAAC;IACpG,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,kCAAkC;QAClC,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8DAA8D;AAC9D,SAAS,gBAAgB,CAAC,IAAY,EAAE,KAAa,EAAE,WAAmB;IACxE,MAAM,GAAG,GAA2B;QAClC,gBAAgB,EAAE,gCAAgC;QAClD,gBAAgB,EAAE,iDAAiD;QACnE,wBAAwB,EAAE,4CAA4C;QACtE,uBAAuB,EAAE,qCAAqC;QAC9D,gBAAgB,EAAE,qCAAqC;KACxD,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,KAAgB;IACxE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO;IAEnC,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEjD,+BAA+B;IAC/B,MAAM,eAAe,GAAG;QACtB,kBAAkB;QAClB,kBAAkB;QAClB,0BAA0B;QAC1B,yBAAyB;QACzB,kBAAkB;KACnB,CAAC;IAEF,8CAA8C;IAC9C,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACpC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAC1B,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,OAAO,IAAI,CACnC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,6BAA6B;IAC7B,MAAM,WAAW,GAAG,oBAAoB,CAAC;IACzC,MAAM,QAAQ,GAAG,oBAAoB,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACjD,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO;IAEvC,MAAM,UAAU,GACd,WAAW,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IAE9C,MAAM,UAAU,GACd,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC;QAC3B,UAAU;QACV,OAAO,CAAC,SAAS,CAAC,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE3C,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;QAC9B,sBAAsB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC,CAAC;IACrE,CAAC;AACH,CAAC"}