webmcp-cli 1.2.2 → 1.2.3

package/dist/rules/best-practices/BP-009.js

@@ -0,0 +1,77 @@
+/**
+ * BP-009: No Orphaned Tools
+ *
+ * Checks that all registered tools are reachable through some UI path.
+ * An orphaned tool is one that exists in the MCP registry but has no
+ * corresponding UI element on the page.
+ */
+import { createRuleResult } from '../runner.js';
+export const BP_009 = {
+    id: 'BP-009',
+    category: 'best-practices',
+    name: 'No Orphaned Tools',
+    description: 'All registered tools should be reachable through some UI path',
+    severity: 'info',
+    maxScore: 5,
+    async check(context) {
+        const tools = context.tools;
+        if (tools.length === 0) {
+            return createRuleResult('BP-009', 5, {
+                passed: true,
+                score: 5,
+                message: 'No tools detected (rule not applicable)',
+            });
+        }
+        const html = context.html ?? '';
+        if (html.length === 0) {
+            return createRuleResult('BP-009', 5, {
+                passed: true,
+                score: 5,
+                message: 'No HTML available for analysis',
+            });
+        }
+        const orphaned = [];
+        const htmlLower = html.toLowerCase();
+        for (const tool of tools) {
+            // Declarative tools are always tied to a form
+            if (tool.source === 'declarative')
+                continue;
+            const toolName = tool.name.toLowerCase();
+            // Convert snake_case to words for search
+            const toolWords = toolName.replace(/[_-]/g, ' ').split(/\s+/);
+            // Search for any reference in the HTML to this tool's name/words
+            const hasUIReference = htmlLower.includes(toolName) ||
+                htmlLower.includes(toolName.replace(/_/g, '-')) ||
+                toolWords.some((word) => word.length > 3 &&
+                    (htmlLower.includes(`id="${word}`) ||
+                        htmlLower.includes(`class="${word}`) ||
+                        htmlLower.includes(`data-action="${word}`) ||
+                        htmlLower.includes(`aria-label="${word}`)));
+            if (!hasUIReference) {
+                orphaned.push(tool.name);
+            }
+        }
+        if (orphaned.length === 0) {
+            return createRuleResult('BP-009', 5, {
+                passed: true,
+                score: 5,
+                message: 'All imperative tools have corresponding UI elements',
+            });
+        }
+        const penalty = Math.min(orphaned.length, 5);
+        const score = Math.max(0, 5 - penalty);
+        return createRuleResult('BP-009', 5, {
+            passed: false,
+            score,
+            message: `${orphaned.length} tool(s) appear orphaned (no matching UI element)`,
+            details: orphaned.map((name) => `Tool "${name}" has no detectable corresponding UI element on the page`),
+            suggestions: [
+                'Ensure each tool corresponds to a visible UI element or action',
+                'Remove tools that no longer have a UI counterpart',
+                'Tools without UI elements confuse agents about available actions',
+            ],
+            affectedTools: orphaned,
+        });
+    },
+};
+//# sourceMappingURL=BP-009.js.map

package/dist/rules/best-practices/BP-009.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BP-009.js","sourceRoot":"","sources":["../../../src/rules/best-practices/BP-009.ts"],"names":[],"mappings":"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"}

package/dist/rules/best-practices/BP-010.d.ts

@@ -0,0 +1,8 @@
+/**
+ * BP-010: Documentation Quality
+ *
+ * Checks that tool definitions are self-documenting with complete
+ * descriptions, parameter documentation, and examples where appropriate.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const BP_010: Rule;

package/dist/rules/best-practices/BP-010.js

@@ -0,0 +1,85 @@
+/**
+ * BP-010: Documentation Quality
+ *
+ * Checks that tool definitions are self-documenting with complete
+ * descriptions, parameter documentation, and examples where appropriate.
+ */
+import { createRuleResult } from '../runner.js';
+const MIN_DESCRIPTION_LENGTH = 15;
+const MIN_PARAM_DESC_LENGTH = 5;
+export const BP_010 = {
+    id: 'BP-010',
+    category: 'best-practices',
+    name: 'Documentation Quality',
+    description: 'Tool definitions should be self-documenting and complete',
+    severity: 'info',
+    maxScore: 5,
+    async check(context) {
+        const tools = context.tools;
+        if (tools.length === 0) {
+            return createRuleResult('BP-010', 5, {
+                passed: true,
+                score: 5,
+                message: 'No tools detected (rule not applicable)',
+            });
+        }
+        const issues = [];
+        for (const tool of tools) {
+            const problems = [];
+            // Check tool description quality
+            if (!tool.description || tool.description.length < MIN_DESCRIPTION_LENGTH) {
+                problems.push(`Description too short (${tool.description?.length ?? 0} chars, need ${MIN_DESCRIPTION_LENGTH}+)`);
+            }
+            // Check that description is not just the tool name repeated
+            if (tool.description &&
+                tool.description.toLowerCase().replace(/[_\s-]/g, '') ===
+                    tool.name.toLowerCase().replace(/[_\s-]/g, '')) {
+                problems.push('Description is just the tool name restated');
+            }
+            // Check parameter descriptions
+            const schema = tool.inputSchema;
+            if (schema?.properties) {
+                const params = Object.entries(schema.properties);
+                const undocumentedParams = [];
+                for (const [paramName, prop] of params) {
+                    if (!prop.description ||
+                        prop.description.length < MIN_PARAM_DESC_LENGTH) {
+                        undocumentedParams.push(paramName);
+                    }
+                }
+                if (undocumentedParams.length > 0) {
+                    problems.push(`${undocumentedParams.length} param(s) lack descriptions: [${undocumentedParams.join(', ')}]`);
+                }
+            }
+            // Check if annotations title is present for better readability
+            if (!tool.annotations?.title && tool.name.includes('_')) {
+                problems.push('No annotations.title — snake_case names benefit from human-readable titles');
+            }
+            if (problems.length > 0) {
+                issues.push({ tool: tool.name, problems });
+            }
+        }
+        if (issues.length === 0) {
+            return createRuleResult('BP-010', 5, {
+                passed: true,
+                score: 5,
+                message: 'All tools are well-documented',
+            });
+        }
+        const penalty = Math.min(issues.length, 5);
+        const score = Math.max(0, 5 - penalty);
+        return createRuleResult('BP-010', 5, {
+            passed: false,
+            score,
+            message: `${issues.length} tool(s) have documentation quality issues`,
+            details: issues.flatMap((i) => i.problems.map((p) => `Tool "${i.tool}": ${p}`)),
+            suggestions: [
+                'Write descriptive tool descriptions (15+ characters) explaining what the tool does',
+                'Add descriptions to all parameters explaining expected values',
+                'Use annotations.title for a human-readable display name',
+            ],
+            affectedTools: issues.map((i) => i.tool),
+        });
+    },
+};
+//# sourceMappingURL=BP-010.js.map

package/dist/rules/best-practices/BP-010.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BP-010.js","sourceRoot":"","sources":["../../../src/rules/best-practices/BP-010.ts"],"names":[],"mappings":"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"}

package/dist/rules/coverage/COV-002.d.ts

@@ -0,0 +1,8 @@
+/**
+ * COV-002: Missing Search Tool
+ *
+ * Checks if the site has search functionality (search inputs, search forms)
+ * but no corresponding WebMCP search tool.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const COV_002: Rule;

package/dist/rules/coverage/COV-002.js

@@ -0,0 +1,68 @@
+/**
+ * COV-002: Missing Search Tool
+ *
+ * Checks if the site has search functionality (search inputs, search forms)
+ * but no corresponding WebMCP search tool.
+ */
+import { createRuleResult } from '../runner.js';
+const SEARCH_HTML_PATTERNS = [
+    /type\s*=\s*["']search["']/i,
+    /role\s*=\s*["']search["']/i,
+    /name\s*=\s*["'](?:q|query|search|keyword|s)["']/i,
+    /id\s*=\s*["'](?:search|searchbox|search-input|searchbar)["']/i,
+    /class\s*=\s*["'][^"']*search[^"']*["']/i,
+    /placeholder\s*=\s*["'][^"']*search[^"']*["']/i,
+    /aria-label\s*=\s*["'][^"']*search[^"']*["']/i,
+];
+export const COV_002 = {
+    id: 'COV-002',
+    category: 'coverage',
+    name: 'Missing Search Tool',
+    description: 'Sites with search functionality should expose a WebMCP search tool',
+    severity: 'warning',
+    maxScore: 5,
+    async check(context) {
+        const html = context.html ?? '';
+        if (html.length === 0) {
+            return createRuleResult('COV-002', 5, {
+                passed: true,
+                score: 5,
+                message: 'No HTML available for analysis',
+            });
+        }
+        const hasSearchUI = SEARCH_HTML_PATTERNS.some((p) => p.test(html));
+        if (!hasSearchUI) {
+            return createRuleResult('COV-002', 5, {
+                passed: true,
+                score: 5,
+                message: 'No search UI detected on the page',
+            });
+        }
+        // Check if any tool covers search
+        const hasSearchTool = context.tools.some((t) => {
+            const text = `${t.name} ${t.description}`.toLowerCase();
+            return /\bsearch\b|\bfind\b|\bquery\b|\blookup\b/.test(text);
+        });
+        if (hasSearchTool) {
+            return createRuleResult('COV-002', 5, {
+                passed: true,
+                score: 5,
+                message: 'Search functionality is covered by a WebMCP tool',
+            });
+        }
+        return createRuleResult('COV-002', 5, {
+            passed: false,
+            score: 0,
+            message: 'Site has search UI but no WebMCP search tool',
+            details: [
+                'Search input or form detected on the page without a corresponding tool',
+            ],
+            suggestions: [
+                'Register a search tool using navigator.modelContext.registerTool()',
+                'Or add toolname="search" to the search form element',
+                'A search tool is one of the most valuable tools for AI agents',
+            ],
+        });
+    },
+};
+//# sourceMappingURL=COV-002.js.map

package/dist/rules/coverage/COV-002.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"COV-002.js","sourceRoot":"","sources":["../../../src/rules/coverage/COV-002.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,oBAAoB,GAAG;IAC3B,4BAA4B;IAC5B,4BAA4B;IAC5B,kDAAkD;IAClD,+DAA+D;IAC/D,yCAAyC;IACzC,+CAA+C;IAC/C,8CAA8C;CAC/C,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,oEAAoE;IACtE,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,CAAC;IAEX,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAEhC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,gCAAgC;aAC1C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEnE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,mCAAmC;aAC7C,CAAC,CAAC;QACL,CAAC;QAED,kCAAkC;QAClC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;YACxD,OAAO,0CAA0C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,kDAAkD;aAC5D,CAAC,CAAC;QACL,CAAC;QAED,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,8CAA8C;YACvD,OAAO,EAAE;gBACP,wEAAwE;aACzE;YACD,WAAW,EAAE;gBACX,oEAAoE;gBACpE,qDAAqD;gBACrD,+DAA+D;aAChE;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/rules/coverage/COV-003.d.ts

@@ -0,0 +1,8 @@
+/**
+ * COV-003: Missing Filter Tool
+ *
+ * Checks if the site has filter/sort controls but no corresponding
+ * WebMCP filter tool.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const COV_003: Rule;

package/dist/rules/coverage/COV-003.js

@@ -0,0 +1,68 @@
+/**
+ * COV-003: Missing Filter Tool
+ *
+ * Checks if the site has filter/sort controls but no corresponding
+ * WebMCP filter tool.
+ */
+import { createRuleResult } from '../runner.js';
+const FILTER_HTML_PATTERNS = [
+    /class\s*=\s*["'][^"']*filter[^"']*["']/i,
+    /id\s*=\s*["'][^"']*filter[^"']*["']/i,
+    /data-filter/i,
+    /aria-label\s*=\s*["'][^"']*filter[^"']*["']/i,
+    /aria-label\s*=\s*["'][^"']*sort[^"']*["']/i,
+    /class\s*=\s*["'][^"']*sort[^"']*["']/i,
+    /name\s*=\s*["'](?:sort|sort_by|sortBy|order|orderBy|filter)["']/i,
+    /<select[^>]*(?:sort|filter|order)/i,
+];
+export const COV_003 = {
+    id: 'COV-003',
+    category: 'coverage',
+    name: 'Missing Filter Tool',
+    description: 'Sites with filter/sort controls should expose WebMCP filter tools',
+    severity: 'info',
+    maxScore: 3,
+    async check(context) {
+        const html = context.html ?? '';
+        if (html.length === 0) {
+            return createRuleResult('COV-003', 3, {
+                passed: true,
+                score: 3,
+                message: 'No HTML available for analysis',
+            });
+        }
+        const hasFilterUI = FILTER_HTML_PATTERNS.some((p) => p.test(html));
+        if (!hasFilterUI) {
+            return createRuleResult('COV-003', 3, {
+                passed: true,
+                score: 3,
+                message: 'No filter/sort UI detected on the page',
+            });
+        }
+        const hasFilterTool = context.tools.some((t) => {
+            const text = `${t.name} ${t.description}`.toLowerCase();
+            return /\bfilter\b|\bsort\b|\border\b|\brefine\b/.test(text);
+        });
+        if (hasFilterTool) {
+            return createRuleResult('COV-003', 3, {
+                passed: true,
+                score: 3,
+                message: 'Filter/sort functionality is covered by a WebMCP tool',
+            });
+        }
+        return createRuleResult('COV-003', 3, {
+            passed: false,
+            score: 0,
+            message: 'Site has filter/sort UI but no WebMCP filter tool',
+            details: [
+                'Filter or sort controls detected on the page without a corresponding tool',
+            ],
+            suggestions: [
+                'Register a filter/sort tool to let agents refine results',
+                'Add toolname attribute to filter forms',
+                'Filter tools help agents navigate large datasets efficiently',
+            ],
+        });
+    },
+};
+//# sourceMappingURL=COV-003.js.map

package/dist/rules/coverage/COV-003.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"COV-003.js","sourceRoot":"","sources":["../../../src/rules/coverage/COV-003.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,oBAAoB,GAAG;IAC3B,yCAAyC;IACzC,sCAAsC;IACtC,cAAc;IACd,8CAA8C;IAC9C,4CAA4C;IAC5C,uCAAuC;IACvC,kEAAkE;IAClE,oCAAoC;CACrC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,mEAAmE;IACrE,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,CAAC;IAEX,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAEhC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,gCAAgC;aAC1C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEnE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,wCAAwC;aAClD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;YACxD,OAAO,0CAA0C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,uDAAuD;aACjE,CAAC,CAAC;QACL,CAAC;QAED,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,mDAAmD;YAC5D,OAAO,EAAE;gBACP,2EAA2E;aAC5E;YACD,WAAW,EAAE;gBACX,0DAA0D;gBAC1D,wCAAwC;gBACxC,8DAA8D;aAC/D;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/rules/coverage/COV-004.d.ts

@@ -0,0 +1,8 @@
+/**
+ * COV-004: Missing Action Tool
+ *
+ * Checks if the site has action buttons (add to cart, like, follow, etc.)
+ * without corresponding WebMCP tools.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const COV_004: Rule;

package/dist/rules/coverage/COV-004.js

@@ -0,0 +1,89 @@
+/**
+ * COV-004: Missing Action Tool
+ *
+ * Checks if the site has action buttons (add to cart, like, follow, etc.)
+ * without corresponding WebMCP tools.
+ */
+import { createRuleResult } from '../runner.js';
+const ACTION_BUTTON_PATTERNS = [
+    /(?:add.to.cart|buy.now|purchase|order.now)/i,
+    /(?:subscribe|follow|like|favorite|bookmark|save)/i,
+    /(?:share|download|export|print)/i,
+    /(?:apply|register|sign.up|join)/i,
+    /(?:submit|send|post|publish)/i,
+    /(?:edit|update|modify|change)/i,
+];
+const ACTION_HTML_SELECTORS = [
+    /<button[^>]*>([^<]*)<\/button>/gi,
+    /<input[^>]*type\s*=\s*["'](?:submit|button)["'][^>]*value\s*=\s*["']([^"']+)["']/gi,
+    /<a[^>]*class\s*=\s*["'][^"']*(?:btn|button|cta)[^"']*["'][^>]*>([^<]*)<\/a>/gi,
+];
+export const COV_004 = {
+    id: 'COV-004',
+    category: 'coverage',
+    name: 'Missing Action Tool',
+    description: 'Sites with action buttons should have corresponding WebMCP tools',
+    severity: 'warning',
+    maxScore: 5,
+    async check(context) {
+        const html = context.html ?? '';
+        if (html.length === 0) {
+            return createRuleResult('COV-004', 5, {
+                passed: true,
+                score: 5,
+                message: 'No HTML available for analysis',
+            });
+        }
+        // Extract button/action text from HTML
+        const actionTexts = [];
+        for (const regex of ACTION_HTML_SELECTORS) {
+            const r = new RegExp(regex.source, regex.flags);
+            let match;
+            while ((match = r.exec(html)) !== null) {
+                const text = (match[1] ?? '').trim();
+                if (text.length > 2 && text.length < 50) {
+                    actionTexts.push(text);
+                }
+            }
+        }
+        // Find actions that match known action patterns but have no tool
+        const uncoveredActions = [];
+        for (const text of actionTexts) {
+            const isAction = ACTION_BUTTON_PATTERNS.some((p) => p.test(text));
+            if (!isAction)
+                continue;
+            // Check if any tool covers this action
+            const textWords = text.toLowerCase().split(/\s+/);
+            const isCovered = context.tools.some((t) => {
+                const toolText = `${t.name} ${t.description}`.toLowerCase();
+                return textWords.some((word) => word.length > 3 && toolText.includes(word));
+            });
+            if (!isCovered) {
+                uncoveredActions.push(text);
+            }
+        }
+        if (uncoveredActions.length === 0) {
+            return createRuleResult('COV-004', 5, {
+                passed: true,
+                score: 5,
+                message: 'Action buttons are covered by WebMCP tools',
+            });
+        }
+        const coverageRatio = actionTexts.length > 0
+            ? (actionTexts.length - uncoveredActions.length) / actionTexts.length
+            : 1;
+        const score = Math.round(coverageRatio * 5);
+        return createRuleResult('COV-004', 5, {
+            passed: false,
+            score,
+            message: `${uncoveredActions.length} action button(s) without WebMCP tools`,
+            details: uncoveredActions.map((text) => `Action button "${text}" has no corresponding tool`),
+            suggestions: [
+                'Register tools for interactive action buttons',
+                'Action buttons like "Add to Cart" are high-value tool opportunities',
+                'Even simple click actions benefit from WebMCP tool registration',
+            ],
+        });
+    },
+};
+//# sourceMappingURL=COV-004.js.map

package/dist/rules/coverage/COV-004.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"COV-004.js","sourceRoot":"","sources":["../../../src/rules/coverage/COV-004.ts"],"names":[],"mappings":"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"}

package/dist/rules/coverage/COV-005.d.ts

@@ -0,0 +1,8 @@
+/**
+ * COV-005: Missing Navigation Tool
+ *
+ * Checks if complex navigation (dropdowns, mega menus, tab navigation)
+ * is exposed as WebMCP tools for agent navigation.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const COV_005: Rule;

package/dist/rules/coverage/COV-005.js

@@ -0,0 +1,67 @@
+/**
+ * COV-005: Missing Navigation Tool
+ *
+ * Checks if complex navigation (dropdowns, mega menus, tab navigation)
+ * is exposed as WebMCP tools for agent navigation.
+ */
+import { createRuleResult } from '../runner.js';
+const COMPLEX_NAV_PATTERNS = [
+    /<nav[^>]*class\s*=\s*["'][^"']*(?:mega|dropdown|sidebar|subnav)[^"']*["']/i,
+    /class\s*=\s*["'][^"']*(?:tab-nav|tabs|tab-list|tab-bar)[^"']*["']/i,
+    /role\s*=\s*["']tablist["']/i,
+    /class\s*=\s*["'][^"']*(?:breadcrumb)[^"']*["']/i,
+    /class\s*=\s*["'][^"']*(?:pagination)[^"']*["']/i,
+    /class\s*=\s*["'][^"']*(?:accordion|collapsible)[^"']*["']/i,
+    /class\s*=\s*["'][^"']*(?:stepper|wizard|multi-step)[^"']*["']/i,
+];
+export const COV_005 = {
+    id: 'COV-005',
+    category: 'coverage',
+    name: 'Missing Navigation Tool',
+    description: 'Complex navigation should be exposed as WebMCP tools',
+    severity: 'info',
+    maxScore: 3,
+    async check(context) {
+        const html = context.html ?? '';
+        if (html.length === 0) {
+            return createRuleResult('COV-005', 3, {
+                passed: true,
+                score: 3,
+                message: 'No HTML available for analysis',
+            });
+        }
+        const hasComplexNav = COMPLEX_NAV_PATTERNS.some((p) => p.test(html));
+        if (!hasComplexNav) {
+            return createRuleResult('COV-005', 3, {
+                passed: true,
+                score: 3,
+                message: 'No complex navigation detected',
+            });
+        }
+        const hasNavTool = context.tools.some((t) => {
+            const text = `${t.name} ${t.description}`.toLowerCase();
+            return /\bnavigate\b|\bgoto\b|\bgo_to\b|\bswitch\b|\btab\b|\bpage\b|\bnext\b|\bprev/.test(text);
+        });
+        if (hasNavTool) {
+            return createRuleResult('COV-005', 3, {
+                passed: true,
+                score: 3,
+                message: 'Complex navigation is covered by WebMCP tools',
+            });
+        }
+        return createRuleResult('COV-005', 3, {
+            passed: false,
+            score: 0,
+            message: 'Complex navigation exists without WebMCP navigation tools',
+            details: [
+                'Tabs, mega menus, pagination, or wizard steps detected without navigation tools',
+            ],
+            suggestions: [
+                'Register navigation tools for tabs, pagination, and multi-step flows',
+                'Navigation tools help agents traverse complex page structures',
+                'Example: registerTool({ name: "navigate_tab", ... })',
+            ],
+        });
+    },
+};
+//# sourceMappingURL=COV-005.js.map

package/dist/rules/coverage/COV-005.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"COV-005.js","sourceRoot":"","sources":["../../../src/rules/coverage/COV-005.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,oBAAoB,GAAG;IAC3B,4EAA4E;IAC5E,oEAAoE;IACpE,6BAA6B;IAC7B,iDAAiD;IACjD,iDAAiD;IACjD,4DAA4D;IAC5D,gEAAgE;CACjE,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,sDAAsD;IACxD,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,CAAC;IAEX,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAEhC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,gCAAgC;aAC1C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAErE,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,gCAAgC;aAC1C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;YACxD,OAAO,6EAA6E,CAAC,IAAI,CACvF,IAAI,CACL,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,+CAA+C;aACzD,CAAC,CAAC;QACL,CAAC;QAED,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,2DAA2D;YACpE,OAAO,EAAE;gBACP,iFAAiF;aAClF;YACD,WAAW,EAAE;gBACX,sEAAsE;gBACtE,+DAA+D;gBAC/D,sDAAsD;aACvD;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/rules/coverage/COV-006.d.ts

@@ -0,0 +1,9 @@
+/**
+ * COV-006: JavaScript-Only Functionality
+ *
+ * Checks for functionality that exists only in JavaScript without
+ * corresponding WebMCP tools, such as keyboard shortcuts,
+ * event-driven interactions, or JS-only features.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const COV_006: Rule;

package/dist/rules/coverage/COV-006.js

@@ -0,0 +1,76 @@
+/**
+ * COV-006: JavaScript-Only Functionality
+ *
+ * Checks for functionality that exists only in JavaScript without
+ * corresponding WebMCP tools, such as keyboard shortcuts,
+ * event-driven interactions, or JS-only features.
+ */
+import { createRuleResult } from '../runner.js';
+const JS_ONLY_PATTERNS = [
+    /addEventListener\s*\(\s*['"](?:click|dblclick|contextmenu)["']/,
+    /\.onclick\s*=/,
+    /\.ondblclick\s*=/,
+    /\$\([^)]*\)\.(?:click|on|bind)\s*\(/,
+    /document\.querySelector[^.]*\.addEventListener/,
+];
+export const COV_006 = {
+    id: 'COV-006',
+    category: 'coverage',
+    name: 'JavaScript-Only Functionality',
+    description: 'Functionality existing only in JS without WebMCP should be flagged',
+    severity: 'info',
+    maxScore: 3,
+    async check(context) {
+        const scripts = context.scripts ?? [];
+        if (scripts.length === 0) {
+            return createRuleResult('COV-006', 3, {
+                passed: true,
+                score: 3,
+                message: 'No scripts available for analysis',
+            });
+        }
+        if (context.tools.length === 0 && !context.hasWebMCP) {
+            return createRuleResult('COV-006', 3, {
+                passed: true,
+                score: 3,
+                message: 'No WebMCP implementation detected (rule not applicable)',
+            });
+        }
+        let jsOnlyInteractions = 0;
+        for (const script of scripts) {
+            for (const pattern of JS_ONLY_PATTERNS) {
+                const matches = script.content.match(new RegExp(pattern.source, 'g'));
+                if (matches) {
+                    jsOnlyInteractions += matches.length;
+                }
+            }
+        }
+        // Compare JS interactions to tool count
+        const toolCount = context.tools.length;
+        const gap = jsOnlyInteractions - toolCount;
+        if (gap <= 2 || jsOnlyInteractions <= 3) {
+            return createRuleResult('COV-006', 3, {
+                passed: true,
+                score: 3,
+                message: `JS interactions (${jsOnlyInteractions}) adequately covered by tools (${toolCount})`,
+            });
+        }
+        const coverageRatio = toolCount / Math.max(jsOnlyInteractions, 1);
+        const score = Math.min(3, Math.round(coverageRatio * 3));
+        return createRuleResult('COV-006', 3, {
+            passed: false,
+            score,
+            message: `${jsOnlyInteractions} JS interactions but only ${toolCount} WebMCP tools`,
+            details: [
+                `Detected ${jsOnlyInteractions} JavaScript-based interactions with ${toolCount} tool(s)`,
+                `Coverage gap of ~${gap} interactions not exposed as tools`,
+            ],
+            suggestions: [
+                'Register tools for JavaScript-driven interactions that agents should access',
+                'Focus on high-value interactions (actions, data mutations) over decorative ones',
+                'Not every click handler needs a tool — prioritize user-facing functionality',
+            ],
+        });
+    },
+};
+//# sourceMappingURL=COV-006.js.map

package/dist/rules/coverage/COV-006.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"COV-006.js","sourceRoot":"","sources":["../../../src/rules/coverage/COV-006.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,gBAAgB,GAAG;IACvB,gEAAgE;IAChE,eAAe;IACf,kBAAkB;IAClB,qCAAqC;IACrC,gDAAgD;CACjD,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,oEAAoE;IACtE,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,CAAC;IAEX,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAEtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,mCAAmC;aAC7C,CAAC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACrD,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,yDAAyD;aACnE,CAAC,CAAC;QACL,CAAC;QAED,IAAI,kBAAkB,GAAG,CAAC,CAAC;QAE3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;gBACvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;gBACtE,IAAI,OAAO,EAAE,CAAC;oBACZ,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;gBACvC,CAAC;YACH,CAAC;QACH,CAAC;QAED,wCAAwC;QACxC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QACvC,MAAM,GAAG,GAAG,kBAAkB,GAAG,SAAS,CAAC;QAE3C,IAAI,GAAG,IAAI,CAAC,IAAI,kBAAkB,IAAI,CAAC,EAAE,CAAC;YACxC,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,oBAAoB,kBAAkB,kCAAkC,SAAS,GAAG;aAC9F,CAAC,CAAC;QACL,CAAC;QAED,MAAM,aAAa,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC;QAEzD,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,KAAK;YACL,OAAO,EAAE,GAAG,kBAAkB,6BAA6B,SAAS,eAAe;YACnF,OAAO,EAAE;gBACP,YAAY,kBAAkB,uCAAuC,SAAS,UAAU;gBACxF,oBAAoB,GAAG,oCAAoC;aAC5D;YACD,WAAW,EAAE;gBACX,6EAA6E;gBAC7E,iFAAiF;gBACjF,6EAA6E;aAC9E;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/rules/coverage/COV-007.d.ts

@@ -0,0 +1,8 @@
+/**
+ * COV-007: Keyboard Shortcuts Not Exposed
+ *
+ * Checks if the page has keyboard shortcuts that aren't documented
+ * as WebMCP tools, leaving agents unaware of these capabilities.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const COV_007: Rule;