mcp-lint 0.1.0 → 0.3.0

package/dist/core/quality-score.js

@@ -0,0 +1,30 @@
+function gradeFromScore(score) {
+    if (score >= 90)
+        return 'A';
+    if (score >= 75)
+        return 'B';
+    if (score >= 60)
+        return 'C';
+    if (score >= 40)
+        return 'D';
+    return 'F';
+}
+export function computeQualityReport(tools, diagnostics) {
+    const byTool = new Map();
+    for (const tool of tools)
+        byTool.set(tool.name, []);
+    for (const d of diagnostics)
+        byTool.get(d.toolName)?.push(d);
+    const toolScores = tools.map((tool) => {
+        const diags = byTool.get(tool.name) ?? [];
+        const errors = diags.filter((d) => d.severity === 'error').length;
+        const warnings = diags.filter((d) => d.severity === 'warning').length;
+        const score = Math.max(0, 100 - errors * 15 - warnings * 5);
+        return { toolName: tool.name, score, grade: gradeFromScore(score), errors, warnings };
+    });
+    const overall = tools.length === 0
+        ? 100
+        : Math.round(toolScores.reduce((sum, t) => sum + t.score, 0) / toolScores.length);
+    return { overall, grade: gradeFromScore(overall), tools: toolScores };
+}
+//# sourceMappingURL=quality-score.js.map

package/dist/core/quality-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-score.js","sourceRoot":"","sources":["../../src/core/quality-score.ts"],"names":[],"mappings":"AAiBA,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAgB,EAAE,WAAyB;IAC9E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,WAAW;QAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAE7D,MAAM,UAAU,GAAgB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;QAClE,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QACtE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,GAAG,EAAE,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC;QAC5D,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC;QAChC,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAEpF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACxE,CAAC"}

package/dist/core/rule.d.ts

@@ -1,7 +1,7 @@
 import type { Severity } from './severity.js';
 export type { Severity } from './severity.js';
 import type { Diagnostic } from './diagnostic.js';
-export type ClientId = 'claude' | 'cursor' | 'gemini' | 'vscode';
+export type ClientId = 'claude' | 'cursor' | 'gemini' | 'vscode' | 'windsurf' | 'cline' | 'openai' | 'continue';
 export interface JSONSchema {
     type?: string | string[];
     properties?: Record<string, JSONSchema>;
@@ -20,6 +20,7 @@ export interface JSONSchema {
     not?: JSONSchema;
     patternProperties?: Record<string, JSONSchema>;
     additionalItems?: JSONSchema | boolean;
+    additionalProperties?: JSONSchema | boolean;
     dependencies?: Record<string, JSONSchema | string[]>;
     $dynamicRef?: string;
     contentEncoding?: string;
@@ -34,6 +35,8 @@ export interface MCPTool {
     inputSchema: JSONSchema;
 }
 export interface Config {
+    extends?: string;
+    plugins?: string[];
     rules?: Record<string, Severity | 'off'>;
     clients?: ClientId[];
     ignore?: string[];
@@ -42,11 +45,18 @@ export interface Config {
 export interface RuleContext {
     config: Config;
 }
+export interface RuleDocs {
+    why: string;
+    badExample: object;
+    goodExample: object;
+    fixNote?: string;
+}
 export interface Rule {
     id: string;
     severity: Severity;
     description: string;
     url?: string;
     clients: ClientId[];
+    docs?: RuleDocs;
     check: (tool: MCPTool, context: RuleContext) => Diagnostic[];
 }

package/dist/index.js

@@ -3,13 +3,19 @@ import { Command } from 'commander';
 import { registerCheckCommand } from './cli/commands/check.js';
 import { registerFixCommand } from './cli/commands/fix.js';
 import { registerInitCommand } from './cli/commands/init.js';
+import { registerCompatCommand } from './cli/commands/compat.js';
+import { registerExplainCommand } from './cli/commands/explain.js';
+import { registerDiffCommand } from './cli/commands/diff.js';
 const program = new Command();
 program
     .name('mcp-lint')
     .description('Lint MCP server tool schemas for cross-client compatibility')
-    .version('0.1.0');
+    .version('0.3.0');
 registerCheckCommand(program);
 registerFixCommand(program);
 registerInitCommand(program);
+registerCompatCommand(program);
+registerExplainCommand(program);
+registerDiffCommand(program);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,6DAA6D,CAAC;KAC1E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,6DAA6D,CAAC;KAC1E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/rules/client-specific/cline.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from '../../core/rule.js';
+export declare const clineDescriptionMaxLength: Rule;

package/dist/rules/client-specific/cline.js

@@ -0,0 +1,49 @@
+const MAX_LENGTH = 200;
+export const clineDescriptionMaxLength = {
+    id: 'cline/description-max-length',
+    severity: 'warning',
+    description: `Cline truncates descriptions longer than ${MAX_LENGTH} characters.`,
+    clients: ['cline'],
+    docs: {
+        why: 'Cline\'s UI and prompt construction truncates tool and parameter descriptions at 200 characters. Longer descriptions are silently cut off, hiding important information.',
+        badExample: { description: 'A very long description that exceeds two hundred characters and will be truncated by Cline without any warning, potentially causing confusion for users who rely on the full text.' },
+        goodExample: { description: 'A concise description under 200 characters.' },
+        fixNote: 'Trim description to 200 characters.',
+    },
+    check(tool, _context) {
+        const diagnostics = [];
+        if (tool.description && tool.description.length > MAX_LENGTH) {
+            diagnostics.push({
+                ruleId: 'cline/description-max-length',
+                severity: 'warning',
+                message: `Tool "${tool.name}" description is ${tool.description.length} characters. Cline truncates at ${MAX_LENGTH}.`,
+                toolName: tool.name,
+                path: 'description',
+                clients: ['cline'],
+                fix: {
+                    description: `Trim description to ${MAX_LENGTH} characters`,
+                    apply: (s) => ({ ...s, description: s.description.slice(0, MAX_LENGTH) }),
+                },
+            });
+        }
+        const props = tool.inputSchema.properties ?? {};
+        for (const [propName, propSchema] of Object.entries(props)) {
+            if (typeof propSchema.description === 'string' && propSchema.description.length > MAX_LENGTH) {
+                diagnostics.push({
+                    ruleId: 'cline/description-max-length',
+                    severity: 'warning',
+                    message: `Parameter "${propName}" description is ${propSchema.description.length} characters. Cline truncates at ${MAX_LENGTH}.`,
+                    toolName: tool.name,
+                    path: `inputSchema.properties.${propName}`,
+                    clients: ['cline'],
+                    fix: {
+                        description: `Trim description to ${MAX_LENGTH} characters`,
+                        apply: (s) => ({ ...s, description: s.description.slice(0, MAX_LENGTH) }),
+                    },
+                });
+            }
+        }
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=cline.js.map

package/dist/rules/client-specific/cline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cline.js","sourceRoot":"","sources":["../../../src/rules/client-specific/cline.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,MAAM,CAAC,MAAM,yBAAyB,GAAS;IAC7C,EAAE,EAAE,8BAA8B;IAClC,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,4CAA4C,UAAU,cAAc;IACjF,OAAO,EAAE,CAAC,OAAO,CAAC;IAClB,IAAI,EAAE;QACJ,GAAG,EAAE,0KAA0K;QAC/K,UAAU,EAAE,EAAE,WAAW,EAAE,oLAAoL,EAAE;QACjN,WAAW,EAAE,EAAE,WAAW,EAAE,6CAA6C,EAAE;QAC3E,OAAO,EAAE,qCAAqC;KAC/C;IAED,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YAC7D,WAAW,CAAC,IAAI,CAAC;gBACf,MAAM,EAAE,8BAA8B;gBACtC,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,oBAAoB,IAAI,CAAC,WAAW,CAAC,MAAM,mCAAmC,UAAU,GAAG;gBACtH,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,CAAC,OAAO,CAAC;gBAClB,GAAG,EAAE;oBACH,WAAW,EAAE,uBAAuB,UAAU,aAAa;oBAC3D,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,WAAW,EAAG,CAAC,CAAC,WAAsB,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC;iBACtF;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,IAAI,EAAE,CAAC;QAChD,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,IAAI,OAAO,UAAU,CAAC,WAAW,KAAK,QAAQ,IAAI,UAAU,CAAC,WAAW,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBAC7F,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,8BAA8B;oBACtC,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,cAAc,QAAQ,oBAAoB,UAAU,CAAC,WAAW,CAAC,MAAM,mCAAmC,UAAU,GAAG;oBAChI,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,0BAA0B,QAAQ,EAAE;oBAC1C,OAAO,EAAE,CAAC,OAAO,CAAC;oBAClB,GAAG,EAAE;wBACH,WAAW,EAAE,uBAAuB,UAAU,aAAa;wBAC3D,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,WAAW,EAAG,CAAC,CAAC,WAAsB,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC;qBACtF;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/rules/client-specific/continue.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from '../../core/rule.js';
+export declare const continueNoDefaultValues: Rule;

package/dist/rules/client-specific/continue.js

@@ -0,0 +1,30 @@
+export const continueNoDefaultValues = {
+    id: 'continue/no-default-values',
+    severity: 'warning',
+    description: 'Continue.dev ignores `default` fields — users may assume defaults are applied when they are not.',
+    clients: ['continue'],
+    docs: {
+        why: 'Continue.dev\'s MCP client does not apply `default` values from schemas. If a user omits an optional parameter, they won\'t get the default — they\'ll get an error or undefined behavior.',
+        badExample: { properties: { limit: { type: 'number', default: 10 } } },
+        goodExample: { properties: { limit: { type: 'number', description: 'Number of results (optional, defaults to 10 if omitted)' } } },
+        fixNote: 'Document the default value in the description instead of relying on the `default` field.',
+    },
+    check(tool, _context) {
+        const diagnostics = [];
+        const props = tool.inputSchema.properties ?? {};
+        for (const [propName, propSchema] of Object.entries(props)) {
+            if (propSchema.default !== undefined) {
+                diagnostics.push({
+                    ruleId: 'continue/no-default-values',
+                    severity: 'warning',
+                    message: `Parameter "${propName}" in tool "${tool.name}" has a \`default\` value that Continue.dev will ignore. Document the default in the description instead.`,
+                    toolName: tool.name,
+                    path: `inputSchema.properties.${propName}`,
+                    clients: ['continue'],
+                });
+            }
+        }
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=continue.js.map

package/dist/rules/client-specific/continue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continue.js","sourceRoot":"","sources":["../../../src/rules/client-specific/continue.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,uBAAuB,GAAS;IAC3C,EAAE,EAAE,4BAA4B;IAChC,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,kGAAkG;IAC/G,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,IAAI,EAAE;QACJ,GAAG,EAAE,4LAA4L;QACjM,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE;QACtE,WAAW,EAAE,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yDAAyD,EAAE,EAAE,EAAE;QAClI,OAAO,EAAE,0FAA0F;KACpG;IAED,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,WAAW,GAAiB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,IAAI,EAAE,CAAC;QAEhD,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACrC,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,4BAA4B;oBACpC,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,cAAc,QAAQ,cAAc,IAAI,CAAC,IAAI,2GAA2G;oBACjK,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,0BAA0B,QAAQ,EAAE;oBAC1C,OAAO,EAAE,CAAC,UAAU,CAAC;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/rules/client-specific/openai.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../../core/rule.js';
+export declare const openaiNoAdditionalProperties: Rule;
+export declare const openaiStrictTypes: Rule;

package/dist/rules/client-specific/openai.js

@@ -0,0 +1,59 @@
+import { walkSchema } from '../../utils/schema-walker.js';
+const ALLOWED_TYPES = new Set(['string', 'number', 'boolean', 'object', 'array', 'null']);
+export const openaiNoAdditionalProperties = {
+    id: 'openai/no-additional-properties',
+    severity: 'error',
+    description: 'OpenAI Agents SDK strict mode requires `additionalProperties: false` on the root inputSchema.',
+    clients: ['openai'],
+    docs: {
+        why: 'OpenAI\'s strict function calling mode rejects schemas that don\'t explicitly set `additionalProperties: false` at the root level.',
+        badExample: { type: 'object', properties: { q: { type: 'string' } } },
+        goodExample: { type: 'object', properties: { q: { type: 'string' } }, additionalProperties: false },
+        fixNote: 'Add `"additionalProperties": false` to the root inputSchema.',
+    },
+    check(tool, _context) {
+        if (tool.inputSchema.additionalProperties === false)
+            return [];
+        return [{
+                ruleId: 'openai/no-additional-properties',
+                severity: 'error',
+                message: `Tool "${tool.name}" is missing \`additionalProperties: false\` on inputSchema. Required for OpenAI Agents SDK strict mode.`,
+                toolName: tool.name,
+                path: 'inputSchema',
+                clients: ['openai'],
+                fix: {
+                    description: 'Add `additionalProperties: false` to inputSchema',
+                    apply: (s) => ({ ...s, additionalProperties: false }),
+                },
+            }];
+    },
+};
+export const openaiStrictTypes = {
+    id: 'openai/strict-types',
+    severity: 'error',
+    description: 'OpenAI Agents SDK only allows string, number, boolean, object, array, null types.',
+    clients: ['openai'],
+    docs: {
+        why: 'OpenAI\'s function calling schema validation rejects non-standard types like `integer`. Use `number` instead.',
+        badExample: { properties: { count: { type: 'integer' } } },
+        goodExample: { properties: { count: { type: 'number' } } },
+    },
+    check(tool, _context) {
+        const diagnostics = [];
+        walkSchema(tool.inputSchema, (schema, path) => {
+            if (typeof schema.type === 'string' && !ALLOWED_TYPES.has(schema.type)) {
+                const diagnosticPath = path ? `inputSchema.${path}` : 'inputSchema';
+                diagnostics.push({
+                    ruleId: 'openai/strict-types',
+                    severity: 'error',
+                    message: `Schema at "${diagnosticPath}" uses type "${schema.type}" which is not allowed by OpenAI Agents SDK. Use one of: ${[...ALLOWED_TYPES].join(', ')}.`,
+                    toolName: tool.name,
+                    path: diagnosticPath,
+                    clients: ['openai'],
+                });
+            }
+        });
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=openai.js.map

package/dist/rules/client-specific/openai.js.map

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

package/dist/rules/client-specific/windsurf.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from '../../core/rule.js';
+export declare const windsurfNoUnionTypes: Rule;

package/dist/rules/client-specific/windsurf.js

@@ -0,0 +1,39 @@
+import { walkSchema } from '../../utils/schema-walker.js';
+export const windsurfNoUnionTypes = {
+    id: 'windsurf/no-union-types',
+    severity: 'warning',
+    description: 'Windsurf does not support `anyOf` with more than 2 variants.',
+    clients: ['windsurf'],
+    docs: {
+        why: 'Windsurf\'s MCP client has limited support for complex union types. `anyOf` with more than 2 variants may be silently ignored or cause unexpected behavior.',
+        badExample: {
+            properties: {
+                value: { anyOf: [{ type: 'string' }, { type: 'number' }, { type: 'boolean' }] },
+            },
+        },
+        goodExample: {
+            properties: {
+                value: { anyOf: [{ type: 'string' }, { type: 'null' }] },
+            },
+        },
+        fixNote: 'Reduce anyOf to at most 2 variants, or replace with a single type.',
+    },
+    check(tool, _context) {
+        const diagnostics = [];
+        walkSchema(tool.inputSchema, (schema, path) => {
+            if (Array.isArray(schema.anyOf) && schema.anyOf.length > 2) {
+                const diagnosticPath = path ? `inputSchema.${path}` : 'inputSchema';
+                diagnostics.push({
+                    ruleId: 'windsurf/no-union-types',
+                    severity: 'warning',
+                    message: `Schema at "${diagnosticPath}" uses \`anyOf\` with ${schema.anyOf.length} variants. Windsurf supports at most 2.`,
+                    toolName: tool.name,
+                    path: diagnosticPath,
+                    clients: ['windsurf'],
+                });
+            }
+        });
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=windsurf.js.map

package/dist/rules/client-specific/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../../src/rules/client-specific/windsurf.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,MAAM,CAAC,MAAM,oBAAoB,GAAS;IACxC,EAAE,EAAE,yBAAyB;IAC7B,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,8DAA8D;IAC3E,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,IAAI,EAAE;QACJ,GAAG,EAAE,6JAA6J;QAClK,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE;aAChF;SACF;QACD,WAAW,EAAE;YACX,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE;aACzD;SACF;QACD,OAAO,EAAE,oEAAoE;KAC9E;IAED,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;gBACpE,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,yBAAyB;oBACjC,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,cAAc,cAAc,yBAAyB,MAAM,CAAC,KAAK,CAAC,MAAM,yCAAyC;oBAC1H,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,CAAC,UAAU,CAAC;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/rules/index.js

@@ -7,9 +7,13 @@ import { noRecursiveRefs } from './no-recursive-refs.js';
 import { validJsonSchemaSubset } from './valid-json-schema-subset.js';
 import { noUnsupportedFormats } from './no-unsupported-formats.js';
 import { claudeNoTypeArray } from './client-specific/claude.js';
+import { continueNoDefaultValues } from './client-specific/continue.js';
 import { cursorNoDefaultWithoutType } from './client-specific/cursor.js';
 import { geminiNoOptionalWithoutDefault, geminiNoNestedObjects } from './client-specific/gemini.js';
 import { vscodeMaxParams } from './client-specific/vscode.js';
+import { windsurfNoUnionTypes } from './client-specific/windsurf.js';
+import { clineDescriptionMaxLength } from './client-specific/cline.js';
+import { openaiNoAdditionalProperties, openaiStrictTypes } from './client-specific/openai.js';
 export const allRules = [
     noRequiredFalse,
     noContentEncoding,
@@ -20,9 +24,14 @@ export const allRules = [
     validJsonSchemaSubset,
     noUnsupportedFormats,
     claudeNoTypeArray,
+    continueNoDefaultValues,
     cursorNoDefaultWithoutType,
     geminiNoOptionalWithoutDefault,
     geminiNoNestedObjects,
     vscodeMaxParams,
+    windsurfNoUnionTypes,
+    clineDescriptionMaxLength,
+    openaiNoAdditionalProperties,
+    openaiStrictTypes,
 ];
 //# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,CAAC,MAAM,QAAQ,GAAW;IAC9B,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,WAAW;IACX,QAAQ;IACR,eAAe;IACf,qBAAqB;IACrB,oBAAoB;IACpB,iBAAiB;IACjB,0BAA0B;IAC1B,8BAA8B;IAC9B,qBAAqB;IACrB,eAAe;CAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAE9F,MAAM,CAAC,MAAM,QAAQ,GAAW;IAC9B,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,WAAW;IACX,QAAQ;IACR,eAAe;IACf,qBAAqB;IACrB,oBAAoB;IACpB,iBAAiB;IACjB,uBAAuB;IACvB,0BAA0B;IAC1B,8BAA8B;IAC9B,qBAAqB;IACrB,eAAe;IACf,oBAAoB;IACpB,yBAAyB;IACzB,4BAA4B;IAC5B,iBAAiB;CAClB,CAAC"}

package/package.json

@@ -1,44 +1,44 @@
-{
-  "name": "mcp-lint",
-  "version": "0.1.0",
-  "description": "Lint MCP server tool schemas for cross-client compatibility",
-  "type": "module",
-  "bin": {
-    "mcp-lint": "./dist/index.js"
-  },
-  "main": "./dist/core/engine.js",
-  "types": "./dist/core/engine.d.ts",
-  "files": [
-    "dist/"
-  ],
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "lint",
-    "schema",
-    "validation"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "prepublishOnly": "npm run build && npm run test"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.28.0",
-    "chalk": "^5.6.2",
-    "commander": "^14.0.3",
-    "yaml": "^2.8.3"
-  },
-  "devDependencies": {
-    "@types/node": "^25.5.0",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.1"
-  }
-}
+{
+  "name": "mcp-lint",
+  "version": "0.3.0",
+  "description": "Lint MCP server tool schemas for cross-client compatibility",
+  "type": "module",
+  "bin": {
+    "mcp-lint": "./dist/index.js"
+  },
+  "main": "./dist/core/engine.js",
+  "types": "./dist/core/engine.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "lint",
+    "schema",
+    "validation"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "yaml": "^2.8.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.1"
+  }
+}