webmcp-cli 1.2.2 → 1.2.3

package/dist/rules/implementation/IMP-002.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IMP-002: Feature Detection
+ *
+ * Checks if the site guards WebMCP usage with
+ * `"modelContext" in navigator` before calling APIs.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const IMP_002: Rule;
+export default IMP_002;

package/dist/rules/implementation/IMP-002.js

@@ -0,0 +1,59 @@
+/**
+ * IMP-002: Feature Detection
+ *
+ * Checks if the site guards WebMCP usage with
+ * `"modelContext" in navigator` before calling APIs.
+ */
+import { createRuleResult } from '../runner.js';
+const FEATURE_DETECTION_PATTERNS = [
+    /["']modelContext["']\s*in\s*(window\.)?navigator/,
+    /navigator\s*\.\s*modelContext\s*!==?\s*undefined/,
+    /typeof\s+navigator\s*\.\s*modelContext\s*!==?\s*["']undefined["']/,
+    /navigator\.modelContext\s*\?\./,
+];
+export const IMP_002 = {
+    id: 'IMP-002',
+    category: 'implementation',
+    name: 'Feature Detection',
+    description: 'Checks if site guards WebMCP usage with feature detection',
+    severity: 'warning',
+    maxScore: 5,
+    async check(context) {
+        if (!context.hasWebMCP) {
+            return createRuleResult('IMP-002', 5, {
+                passed: true,
+                score: 5,
+                message: 'No WebMCP API detected (rule not applicable)',
+            });
+        }
+        const scripts = context.scripts ?? [];
+        const html = context.html ?? '';
+        // Search in scripts and inline HTML for feature detection patterns
+        const allContent = [
+            ...scripts.map((s) => s.content),
+            html,
+        ];
+        for (const content of allContent) {
+            for (const pattern of FEATURE_DETECTION_PATTERNS) {
+                if (pattern.test(content)) {
+                    return createRuleResult('IMP-002', 5, {
+                        passed: true,
+                        score: 5,
+                        message: 'Site uses feature detection before accessing WebMCP API',
+                    });
+                }
+            }
+        }
+        return createRuleResult('IMP-002', 5, {
+            passed: false,
+            score: 0,
+            message: 'No feature detection found for WebMCP API',
+            suggestions: [
+                'Guard WebMCP usage with: if ("modelContext" in navigator) { ... }',
+                'This prevents errors in browsers that do not support WebMCP',
+            ],
+        });
+    },
+};
+export default IMP_002;
+//# sourceMappingURL=IMP-002.js.map

package/dist/rules/implementation/IMP-002.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMP-002.js","sourceRoot":"","sources":["../../../src/rules/implementation/IMP-002.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,0BAA0B,GAAG;IACjC,kDAAkD;IAClD,kDAAkD;IAClD,mEAAmE;IACnE,gCAAgC;CACjC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,gBAAgB;IAC1B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,2DAA2D;IACxE,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,CAAC;IAEX,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,8CAA8C;aACxD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAEhC,mEAAmE;QACnE,MAAM,UAAU,GAAG;YACjB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAChC,IAAI;SACL,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;YACjC,KAAK,MAAM,OAAO,IAAI,0BAA0B,EAAE,CAAC;gBACjD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1B,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;wBACpC,MAAM,EAAE,IAAI;wBACZ,KAAK,EAAE,CAAC;wBACR,OAAO,EAAE,yDAAyD;qBACnE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,2CAA2C;YACpD,WAAW,EAAE;gBACX,mEAAmE;gBACnE,6DAA6D;aAC9D;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/rules/implementation/IMP-006.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IMP-006: Tool Has Execute
+ *
+ * Checks that every imperative tool has an execute function.
+ * Without execute, the agent cannot invoke the tool.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const IMP_006: Rule;
+export default IMP_006;

package/dist/rules/implementation/IMP-006.js

@@ -0,0 +1,48 @@
+/**
+ * IMP-006: Tool Has Execute
+ *
+ * Checks that every imperative tool has an execute function.
+ * Without execute, the agent cannot invoke the tool.
+ */
+import { createRuleResult } from '../runner.js';
+export const IMP_006 = {
+    id: 'IMP-006',
+    category: 'implementation',
+    name: 'Tool Has Execute',
+    description: 'Every imperative tool must have an execute function',
+    severity: 'critical',
+    maxScore: 10,
+    async check(context) {
+        const imperativeTools = context.tools.filter((t) => t.source === 'imperative');
+        if (imperativeTools.length === 0) {
+            return createRuleResult('IMP-006', 10, {
+                passed: true,
+                score: 10,
+                message: 'No imperative tools found to check',
+            });
+        }
+        const toolsWithoutExecute = imperativeTools.filter((t) => !t.hasExecute);
+        if (toolsWithoutExecute.length === 0) {
+            return createRuleResult('IMP-006', 10, {
+                passed: true,
+                score: 10,
+                message: `All ${imperativeTools.length} imperative tool(s) have execute functions`,
+            });
+        }
+        return createRuleResult('IMP-006', 10, {
+            passed: false,
+            score: Math.max(0, 10 - toolsWithoutExecute.length * 5),
+            message: `${toolsWithoutExecute.length} imperative tool(s) missing execute function`,
+            details: toolsWithoutExecute.map((t) => `Tool "${t.name || '(unnamed)'}" has no execute function`),
+            suggestions: [
+                'Every imperative tool must define an execute function',
+                'Example: navigator.modelContext.registerTool({ name: "...", execute: async (params) => { ... } })',
+            ],
+            affectedTools: toolsWithoutExecute
+                .filter((t) => t.name)
+                .map((t) => t.name),
+        });
+    },
+};
+export default IMP_006;
+//# sourceMappingURL=IMP-006.js.map

package/dist/rules/implementation/IMP-006.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMP-006.js","sourceRoot":"","sources":["../../../src/rules/implementation/IMP-006.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,gBAAgB;IAC1B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,qDAAqD;IAClE,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,EAAE;IAEZ,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,CACjC,CAAC;QAEF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;gBACrC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,oCAAoC;aAC9C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAChD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CACrB,CAAC;QAEF,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;gBACrC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,OAAO,eAAe,CAAC,MAAM,4CAA4C;aACnF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;YACrC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC;YACvD,OAAO,EAAE,GAAG,mBAAmB,CAAC,MAAM,8CAA8C;YACpF,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,IAAI,WAAW,2BAA2B,CACjE;YACD,WAAW,EAAE;gBACX,uDAAuD;gBACvD,mGAAmG;aACpG;YACD,aAAa,EAAE,mBAAmB;iBAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACtB,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/rules/implementation/IMP-008.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IMP-008: Declarative Has Toolname
+ *
+ * Checks that declarative forms have a toolname attribute.
+ * Without toolname, the form cannot be exposed as a WebMCP tool.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const IMP_008: Rule;
+export default IMP_008;

package/dist/rules/implementation/IMP-008.js

@@ -0,0 +1,46 @@
+/**
+ * IMP-008: Declarative Has Toolname
+ *
+ * Checks that declarative forms have a toolname attribute.
+ * Without toolname, the form cannot be exposed as a WebMCP tool.
+ */
+import { createRuleResult } from '../runner.js';
+export const IMP_008 = {
+    id: 'IMP-008',
+    category: 'implementation',
+    name: 'Declarative Has Toolname',
+    description: 'Declarative forms must have a toolname attribute',
+    severity: 'critical',
+    maxScore: 10,
+    async check(context) {
+        const declarativeTools = context.tools.filter((t) => t.source === 'declarative');
+        if (declarativeTools.length === 0) {
+            return createRuleResult('IMP-008', 10, {
+                passed: true,
+                score: 10,
+                message: 'No declarative tools found to check',
+            });
+        }
+        const toolsWithoutName = declarativeTools.filter((t) => !t.name || t.name.trim() === '');
+        if (toolsWithoutName.length === 0) {
+            return createRuleResult('IMP-008', 10, {
+                passed: true,
+                score: 10,
+                message: `All ${declarativeTools.length} declarative form(s) have toolname attributes`,
+            });
+        }
+        return createRuleResult('IMP-008', 10, {
+            passed: false,
+            score: Math.max(0, 10 - toolsWithoutName.length * 5),
+            message: `${toolsWithoutName.length} declarative form(s) missing toolname attribute`,
+            details: toolsWithoutName.map((t) => `Declarative form at ${t.pageUrl} is missing toolname`),
+            suggestions: [
+                'Add a toolname attribute to each form: <form toolname="search-flights">',
+                'The toolname identifies the form as a WebMCP tool',
+            ],
+            affectedPages: [...new Set(toolsWithoutName.map((t) => t.pageUrl))],
+        });
+    },
+};
+export default IMP_008;
+//# sourceMappingURL=IMP-008.js.map

package/dist/rules/implementation/IMP-008.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMP-008.js","sourceRoot":"","sources":["../../../src/rules/implementation/IMP-008.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,gBAAgB;IAC1B,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,kDAAkD;IAC/D,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,EAAE;IAEZ,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAClC,CAAC;QAEF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;gBACrC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,qCAAqC;aAC/C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAC9C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CACvC,CAAC;QAEF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;gBACrC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,OAAO,gBAAgB,CAAC,MAAM,+CAA+C;aACvF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;YACrC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;YACpD,OAAO,EAAE,GAAG,gBAAgB,CAAC,MAAM,iDAAiD;YACpF,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC,CAAC,OAAO,sBAAsB,CAC9D;YACD,WAAW,EAAE;gBACX,yEAAyE;gBACzE,mDAAmD;aACpD;YACD,aAAa,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;SACpE,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/rules/implementation/IMP-009.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IMP-009: Declarative Has Tooldescription
+ *
+ * Checks that declarative forms have a tooldescription attribute.
+ * Without tooldescription, the agent cannot determine when to use the form.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const IMP_009: Rule;
+export default IMP_009;

package/dist/rules/implementation/IMP-009.js

@@ -0,0 +1,48 @@
+/**
+ * IMP-009: Declarative Has Tooldescription
+ *
+ * Checks that declarative forms have a tooldescription attribute.
+ * Without tooldescription, the agent cannot determine when to use the form.
+ */
+import { createRuleResult } from '../runner.js';
+export const IMP_009 = {
+    id: 'IMP-009',
+    category: 'implementation',
+    name: 'Declarative Has Tooldescription',
+    description: 'Declarative forms must have a tooldescription attribute',
+    severity: 'critical',
+    maxScore: 10,
+    async check(context) {
+        const declarativeTools = context.tools.filter((t) => t.source === 'declarative');
+        if (declarativeTools.length === 0) {
+            return createRuleResult('IMP-009', 10, {
+                passed: true,
+                score: 10,
+                message: 'No declarative tools found to check',
+            });
+        }
+        const toolsWithoutDesc = declarativeTools.filter((t) => !t.description || t.description.trim() === '');
+        if (toolsWithoutDesc.length === 0) {
+            return createRuleResult('IMP-009', 10, {
+                passed: true,
+                score: 10,
+                message: `All ${declarativeTools.length} declarative form(s) have tooldescription attributes`,
+            });
+        }
+        return createRuleResult('IMP-009', 10, {
+            passed: false,
+            score: Math.max(0, 10 - toolsWithoutDesc.length * 5),
+            message: `${toolsWithoutDesc.length} declarative form(s) missing tooldescription attribute`,
+            details: toolsWithoutDesc.map((t) => `Form "${t.name || '(unnamed)'}" at ${t.pageUrl} is missing tooldescription`),
+            suggestions: [
+                'Add a tooldescription attribute: <form toolname="..." tooldescription="Search for flights between airports">',
+                'Descriptions help agents understand when and how to use the tool',
+            ],
+            affectedTools: toolsWithoutDesc
+                .filter((t) => t.name)
+                .map((t) => t.name),
+        });
+    },
+};
+export default IMP_009;
+//# sourceMappingURL=IMP-009.js.map

package/dist/rules/implementation/IMP-009.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMP-009.js","sourceRoot":"","sources":["../../../src/rules/implementation/IMP-009.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,gBAAgB;IAC1B,IAAI,EAAE,iCAAiC;IACvC,WAAW,EAAE,yDAAyD;IACtE,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,EAAE;IAEZ,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAClC,CAAC;QAEF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;gBACrC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,qCAAqC;aAC/C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAC9C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,CACrD,CAAC;QAEF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;gBACrC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,OAAO,gBAAgB,CAAC,MAAM,sDAAsD;aAC9F,CAAC,CAAC;QACL,CAAC;QAED,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;YACrC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;YACpD,OAAO,EAAE,GAAG,gBAAgB,CAAC,MAAM,wDAAwD;YAC3F,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,IAAI,WAAW,QAAQ,CAAC,CAAC,OAAO,6BAA6B,CACpF;YACD,WAAW,EAAE;gBACX,8GAA8G;gBAC9G,kEAAkE;aACnE;YACD,aAAa,EAAE,gBAAgB;iBAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACtB,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/rules/implementation/IMP-010.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IMP-010: Declarative Submit Button
+ *
+ * Checks that declarative forms have a submit button.
+ * Without a submit button, agents may not be able to invoke the form.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const IMP_010: Rule;
+export default IMP_010;

package/dist/rules/implementation/IMP-010.js

@@ -0,0 +1,66 @@
+/**
+ * IMP-010: Declarative Submit Button
+ *
+ * Checks that declarative forms have a submit button.
+ * Without a submit button, agents may not be able to invoke the form.
+ */
+import * as cheerio from 'cheerio';
+import { createRuleResult } from '../runner.js';
+export const IMP_010 = {
+    id: 'IMP-010',
+    category: 'implementation',
+    name: 'Declarative Submit Button',
+    description: 'Declarative forms should have a submit button',
+    severity: 'warning',
+    maxScore: 5,
+    async check(context) {
+        const declarativeTools = context.tools.filter((t) => t.source === 'declarative');
+        if (declarativeTools.length === 0) {
+            return createRuleResult('IMP-010', 5, {
+                passed: true,
+                score: 5,
+                message: 'No declarative tools found to check',
+            });
+        }
+        const html = context.html ?? '';
+        if (!html) {
+            return createRuleResult('IMP-010', 5, {
+                passed: true,
+                score: 5,
+                message: 'No HTML content available for analysis',
+            });
+        }
+        const $ = cheerio.load(html);
+        const formsWithoutSubmit = [];
+        $('form[toolname]').each((_i, form) => {
+            const $form = $(form);
+            const toolname = $form.attr('toolname') ?? '(unnamed)';
+            const hasSubmitButton = $form.find('button[type="submit"]').length > 0 ||
+                $form.find('input[type="submit"]').length > 0 ||
+                $form.find('button:not([type])').length > 0;
+            if (!hasSubmitButton) {
+                formsWithoutSubmit.push(toolname);
+            }
+        });
+        if (formsWithoutSubmit.length === 0) {
+            return createRuleResult('IMP-010', 5, {
+                passed: true,
+                score: 5,
+                message: 'All declarative forms have submit buttons',
+            });
+        }
+        return createRuleResult('IMP-010', 5, {
+            passed: false,
+            score: Math.max(0, 5 - formsWithoutSubmit.length * 2),
+            message: `${formsWithoutSubmit.length} declarative form(s) missing a submit button`,
+            details: formsWithoutSubmit.map((name) => `Form "${name}" has no submit button`),
+            suggestions: [
+                'Add a <button type="submit"> or <input type="submit"> to each form',
+                'Submit buttons allow agents to trigger form submission',
+            ],
+            affectedTools: formsWithoutSubmit,
+        });
+    },
+};
+export default IMP_010;
+//# sourceMappingURL=IMP-010.js.map

package/dist/rules/implementation/IMP-010.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMP-010.js","sourceRoot":"","sources":["../../../src/rules/implementation/IMP-010.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,gBAAgB;IAC1B,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,+CAA+C;IAC5D,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,CAAC;IAEX,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAClC,CAAC;QAEF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,qCAAqC;aAC/C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,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,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,kBAAkB,GAAa,EAAE,CAAC;QAExC,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;YACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC;YAEvD,MAAM,eAAe,GACnB,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,MAAM,GAAG,CAAC;gBAC9C,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,MAAM,GAAG,CAAC;gBAC7C,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YAE9C,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,2CAA2C;aACrD,CAAC,CAAC;QACL,CAAC;QAED,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;YACrD,OAAO,EAAE,GAAG,kBAAkB,CAAC,MAAM,8CAA8C;YACnF,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAC7B,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,wBAAwB,CAChD;YACD,WAAW,EAAE;gBACX,oEAAoE;gBACpE,wDAAwD;aACzD;YACD,aAAa,EAAE,kBAAkB;SAClC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/rules/implementation/IMP-011.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IMP-011: Declarative Labels
+ *
+ * Checks that form fields in declarative forms have associated label elements.
+ * Labels help agents understand what each field represents.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const IMP_011: Rule;
+export default IMP_011;

package/dist/rules/implementation/IMP-011.js

@@ -0,0 +1,82 @@
+/**
+ * IMP-011: Declarative Labels
+ *
+ * Checks that form fields in declarative forms have associated label elements.
+ * Labels help agents understand what each field represents.
+ */
+import * as cheerio from 'cheerio';
+import { createRuleResult } from '../runner.js';
+export const IMP_011 = {
+    id: 'IMP-011',
+    category: 'implementation',
+    name: 'Declarative Labels',
+    description: 'Form fields should have associated label elements',
+    severity: 'warning',
+    maxScore: 5,
+    async check(context) {
+        const declarativeTools = context.tools.filter((t) => t.source === 'declarative');
+        if (declarativeTools.length === 0) {
+            return createRuleResult('IMP-011', 5, {
+                passed: true,
+                score: 5,
+                message: 'No declarative tools found to check',
+            });
+        }
+        const html = context.html ?? '';
+        if (!html) {
+            return createRuleResult('IMP-011', 5, {
+                passed: true,
+                score: 5,
+                message: 'No HTML content available for analysis',
+            });
+        }
+        const $ = cheerio.load(html);
+        const fieldsWithoutLabels = [];
+        $('form[toolname]').each((_i, form) => {
+            const $form = $(form);
+            const toolname = $form.attr('toolname') ?? '(unnamed)';
+            $form
+                .find('input, select, textarea')
+                .not('[type="hidden"], [type="submit"]')
+                .each((_j, input) => {
+                const $input = $(input);
+                const id = $input.attr('id');
+                const name = $input.attr('name') ?? '(unnamed)';
+                const ariaLabel = $input.attr('aria-label');
+                const ariaLabelledBy = $input.attr('aria-labelledby');
+                // Check for associated label: for=id, wrapper label, or aria
+                const hasLabel = (id && $(`label[for="${id}"]`).length > 0) ||
+                    $input.closest('label').length > 0 ||
+                    !!ariaLabel ||
+                    !!ariaLabelledBy;
+                if (!hasLabel) {
+                    fieldsWithoutLabels.push({ form: toolname, field: name });
+                }
+            });
+        });
+        if (fieldsWithoutLabels.length === 0) {
+            return createRuleResult('IMP-011', 5, {
+                passed: true,
+                score: 5,
+                message: 'All form fields have associated labels',
+            });
+        }
+        return createRuleResult('IMP-011', 5, {
+            passed: false,
+            score: Math.max(0, 5 - fieldsWithoutLabels.length),
+            message: `${fieldsWithoutLabels.length} form field(s) missing labels`,
+            details: fieldsWithoutLabels.map((v) => `Field "${v.field}" in form "${v.form}" has no associated label`),
+            suggestions: [
+                'Add <label for="fieldId"> for each input field',
+                'Or wrap inputs in <label> elements',
+                'Or use aria-label/aria-labelledby attributes',
+                'Labels help agents understand field purpose',
+            ],
+            affectedTools: [
+                ...new Set(fieldsWithoutLabels.map((v) => v.form)),
+            ],
+        });
+    },
+};
+export default IMP_011;
+//# sourceMappingURL=IMP-011.js.map

package/dist/rules/implementation/IMP-011.js.map

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

package/dist/rules/implementation/IMP-012.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IMP-012: Declarative Required Match
+ *
+ * Checks that HTML required attributes on form fields match
+ * the schema required array for declarative tools.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const IMP_012: Rule;
+export default IMP_012;

package/dist/rules/implementation/IMP-012.js

@@ -0,0 +1,88 @@
+/**
+ * IMP-012: Declarative Required Match
+ *
+ * Checks that HTML required attributes on form fields match
+ * the schema required array for declarative tools.
+ */
+import * as cheerio from 'cheerio';
+import { createRuleResult } from '../runner.js';
+export const IMP_012 = {
+    id: 'IMP-012',
+    category: 'implementation',
+    name: 'Declarative Required Match',
+    description: 'HTML required attributes should match schema required array',
+    severity: 'warning',
+    maxScore: 5,
+    async check(context) {
+        const declarativeTools = context.tools.filter((t) => t.source === 'declarative' && t.inputSchema);
+        if (declarativeTools.length === 0) {
+            return createRuleResult('IMP-012', 5, {
+                passed: true,
+                score: 5,
+                message: 'No declarative tools with schemas found to check',
+            });
+        }
+        const html = context.html ?? '';
+        if (!html) {
+            return createRuleResult('IMP-012', 5, {
+                passed: true,
+                score: 5,
+                message: 'No HTML content available for analysis',
+            });
+        }
+        const $ = cheerio.load(html);
+        const mismatches = [];
+        for (const tool of declarativeTools) {
+            const $form = $(`form[toolname="${tool.name}"]`);
+            if ($form.length === 0)
+                continue;
+            const schemaRequired = new Set((tool.inputSchema?.required ?? []).map((r) => r.toLowerCase()));
+            const htmlRequired = new Set();
+            $form
+                .find('input[required], select[required], textarea[required]')
+                .each((_i, el) => {
+                const name = $(el).attr('name');
+                if (name)
+                    htmlRequired.add(name.toLowerCase());
+            });
+            // Fields required in HTML but not in schema
+            for (const field of htmlRequired) {
+                if (!schemaRequired.has(field)) {
+                    mismatches.push({
+                        tool: tool.name,
+                        details: `Field "${field}" is required in HTML but not in schema`,
+                    });
+                }
+            }
+            // Fields required in schema but not in HTML
+            for (const field of schemaRequired) {
+                if (!htmlRequired.has(field)) {
+                    mismatches.push({
+                        tool: tool.name,
+                        details: `Field "${field}" is required in schema but not in HTML`,
+                    });
+                }
+            }
+        }
+        if (mismatches.length === 0) {
+            return createRuleResult('IMP-012', 5, {
+                passed: true,
+                score: 5,
+                message: 'HTML required attributes match schema required arrays',
+            });
+        }
+        return createRuleResult('IMP-012', 5, {
+            passed: false,
+            score: Math.max(0, 5 - mismatches.length),
+            message: `${mismatches.length} required field mismatch(es) found`,
+            details: mismatches.map((m) => `Tool "${m.tool}": ${m.details}`),
+            suggestions: [
+                'Ensure HTML required attributes match the schema required array',
+                'Both the form and schema should agree on which fields are mandatory',
+            ],
+            affectedTools: [...new Set(mismatches.map((m) => m.tool))],
+        });
+    },
+};
+export default IMP_012;
+//# sourceMappingURL=IMP-012.js.map

package/dist/rules/implementation/IMP-012.js.map

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

package/dist/rules/implementation/IMP-014.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IMP-014: Execute Returns Content
+ *
+ * Checks that execute functions return { content: [...] } format.
+ * This is the expected response format for WebMCP tool results.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const IMP_014: Rule;
+export default IMP_014;

package/dist/rules/implementation/IMP-014.js

@@ -0,0 +1,58 @@
+/**
+ * IMP-014: Execute Returns Content
+ *
+ * Checks that execute functions return { content: [...] } format.
+ * This is the expected response format for WebMCP tool results.
+ */
+import { createRuleResult } from '../runner.js';
+const CONTENT_RETURN_PATTERNS = [
+    /return\s*\{[\s\S]*content\s*:/,
+    /return\s*\{[\s\S]*["']content["']\s*:/,
+    /\.content\s*=\s*\[/,
+];
+export const IMP_014 = {
+    id: 'IMP-014',
+    category: 'implementation',
+    name: 'Execute Returns Content',
+    description: 'Execute functions should return { content: [...] } format',
+    severity: 'warning',
+    maxScore: 5,
+    async check(context) {
+        const imperativeTools = context.tools.filter((t) => t.source === 'imperative' && t.hasExecute && t.executeSource);
+        if (imperativeTools.length === 0) {
+            return createRuleResult('IMP-014', 5, {
+                passed: true,
+                score: 5,
+                message: 'No imperative tools with execute source to check',
+            });
+        }
+        const violations = [];
+        for (const tool of imperativeTools) {
+            const source = tool.executeSource ?? '';
+            const hasContentReturn = CONTENT_RETURN_PATTERNS.some((p) => p.test(source));
+            if (!hasContentReturn) {
+                violations.push(tool.name);
+            }
+        }
+        if (violations.length === 0) {
+            return createRuleResult('IMP-014', 5, {
+                passed: true,
+                score: 5,
+                message: `All ${imperativeTools.length} execute function(s) return content format`,
+            });
+        }
+        return createRuleResult('IMP-014', 5, {
+            passed: false,
+            score: Math.max(0, 5 - violations.length * 2),
+            message: `${violations.length} execute function(s) may not return { content: [...] } format`,
+            details: violations.map((name) => `Tool "${name}" execute function does not appear to return { content: [...] }`),
+            suggestions: [
+                'Execute functions should return: { content: [{ type: "text", text: "result" }] }',
+                'This format allows agents to properly parse tool results',
+            ],
+            affectedTools: violations,
+        });
+    },
+};
+export default IMP_014;
+//# sourceMappingURL=IMP-014.js.map

package/dist/rules/implementation/IMP-014.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMP-014.js","sourceRoot":"","sources":["../../../src/rules/implementation/IMP-014.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,uBAAuB,GAAG;IAC9B,+BAA+B;IAC/B,uCAAuC;IACvC,oBAAoB;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,gBAAgB;IAC1B,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE,2DAA2D;IACxE,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,CAAC;IAEX,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,aAAa,CACpE,CAAC;QAEF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,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,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;YACxC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1D,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CACf,CAAC;YAEF,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,OAAO,eAAe,CAAC,MAAM,4CAA4C;aACnF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;YAC7C,OAAO,EAAE,GAAG,UAAU,CAAC,MAAM,+DAA+D;YAC5F,OAAO,EAAE,UAAU,CAAC,GAAG,CACrB,CAAC,IAAI,EAAE,EAAE,CACP,SAAS,IAAI,iEAAiE,CACjF;YACD,WAAW,EAAE;gBACX,kFAAkF;gBAClF,0DAA0D;aAC3D;YACD,aAAa,EAAE,UAAU;SAC1B,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/rules/implementation/IMP-015.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IMP-015: Execute Returns on Error
+ *
+ * Checks that execute functions handle errors by returning error content
+ * rather than just throwing exceptions.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const IMP_015: Rule;
+export default IMP_015;