mcp-lint 0.1.0

package/dist/config/config.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from '../core/rule.js';
+export declare function loadConfig(configPath?: string): Promise<Config>;
+export declare const DEFAULT_CONFIG: Required<Omit<Config, 'rules'>>;

package/dist/config/config.js

@@ -0,0 +1,38 @@
+import { readFile } from 'node:fs/promises';
+import { resolve, dirname } from 'node:path';
+import { homedir } from 'node:os';
+async function readConfigFile(filePath) {
+    const content = await readFile(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+export async function loadConfig(configPath) {
+    if (configPath) {
+        try {
+            return await readConfigFile(configPath);
+        }
+        catch (err) {
+            throw new Error(`Cannot load config from "${configPath}": ${err.message}`);
+        }
+    }
+    let dir = process.cwd();
+    const home = homedir();
+    while (true) {
+        try {
+            return await readConfigFile(resolve(dir, '.mcplintrc.json'));
+        }
+        catch {
+            // not found here, try parent
+        }
+        const parent = dirname(dir);
+        if (parent === dir || dir === home)
+            break;
+        dir = parent;
+    }
+    return {};
+}
+export const DEFAULT_CONFIG = {
+    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+    ignore: [],
+    maxDepth: 5,
+};
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,KAAK,UAAU,cAAc,CAAC,QAAgB;IAC5C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAW,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAmB;IAClD,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,MAAO,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IAEvB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,MAAM,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI;YAAE,MAAM;QAC1C,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAoC;IAC7D,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACjD,MAAM,EAAE,EAAE;IACV,QAAQ,EAAE,CAAC;CACZ,CAAC"}

package/dist/core/diagnostic.d.ts

@@ -0,0 +1,15 @@
+import type { Severity } from './severity.js';
+import type { ClientId } from './rule.js';
+export interface Fix {
+    description: string;
+    apply: (schema: Record<string, unknown>) => Record<string, unknown>;
+}
+export interface Diagnostic {
+    ruleId: string;
+    severity: Severity;
+    message: string;
+    toolName: string;
+    path: string;
+    clients: ClientId[];
+    fix?: Fix;
+}

package/dist/core/diagnostic.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagnostic.js.map

package/dist/core/diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../../src/core/diagnostic.ts"],"names":[],"mappings":""}

package/dist/core/engine.d.ts

@@ -0,0 +1,8 @@
+import type { Rule, MCPTool, Config } from './rule.js';
+import type { Diagnostic } from './diagnostic.js';
+export declare class LintEngine {
+    private readonly rules;
+    private readonly config;
+    constructor(rules: Rule[], config: Config);
+    lint(tools: MCPTool[]): Diagnostic[];
+}

package/dist/core/engine.js

@@ -0,0 +1,35 @@
+export class LintEngine {
+    rules;
+    config;
+    constructor(rules, config) {
+        this.rules = rules;
+        this.config = config;
+    }
+    lint(tools) {
+        const context = { config: this.config };
+        const diagnostics = [];
+        for (const tool of tools) {
+            if (this.config.ignore?.includes(tool.name))
+                continue;
+            for (const rule of this.rules) {
+                const severityOverride = this.config.rules?.[rule.id];
+                if (severityOverride === 'off')
+                    continue;
+                // Filter by clients: skip rule if none of its clients are in config.clients
+                if (this.config.clients &&
+                    this.config.clients.length > 0 &&
+                    !rule.clients.some((c) => this.config.clients.includes(c))) {
+                    continue;
+                }
+                const ruleDiagnostics = rule.check(tool, context);
+                for (const diag of ruleDiagnostics) {
+                    diagnostics.push(severityOverride
+                        ? { ...diag, severity: severityOverride }
+                        : diag);
+                }
+            }
+        }
+        return diagnostics;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/core/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/core/engine.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,UAAU;IAEF;IACA;IAFnB,YACmB,KAAa,EACb,MAAc;QADd,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ,IAAI,CAAC,KAAgB;QACnB,MAAM,OAAO,GAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QACrD,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEtD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtD,IAAI,gBAAgB,KAAK,KAAK;oBAAE,SAAS;gBAEzC,4EAA4E;gBAC5E,IACE,IAAI,CAAC,MAAM,CAAC,OAAO;oBACnB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;oBAC9B,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAC3D,CAAC;oBACD,SAAS;gBACX,CAAC;gBAED,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAElD,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;oBACnC,WAAW,CAAC,IAAI,CACd,gBAAgB;wBACd,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,gBAA4B,EAAE;wBACrD,CAAC,CAAC,IAAI,CACT,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;CACF"}

package/dist/core/fixer.d.ts

@@ -0,0 +1,3 @@
+import type { MCPTool } from './rule.js';
+import type { Diagnostic } from './diagnostic.js';
+export declare function applyFixes(tools: MCPTool[], diagnostics: Diagnostic[], onlyRules?: string[]): MCPTool[];

package/dist/core/fixer.js

@@ -0,0 +1,37 @@
+function parsePath(path) {
+    return path.split('.').flatMap((part) => {
+        const m = part.match(/^([^\[]+)\[(\d+)\]$/);
+        return m ? [m[1], m[2]] : [part];
+    });
+}
+export function applyFixes(tools, diagnostics, onlyRules) {
+    const fixable = diagnostics.filter((d) => d.fix != null && (!onlyRules || onlyRules.includes(d.ruleId)));
+    if (fixable.length === 0)
+        return tools;
+    const result = structuredClone(tools);
+    for (const diag of fixable) {
+        const toolIndex = result.findIndex((t) => t.name === diag.toolName);
+        if (toolIndex === -1)
+            continue;
+        const parts = parsePath(diag.path);
+        if (parts.length === 0)
+            continue;
+        const toolObj = result[toolIndex];
+        let parent = toolObj;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const next = parent[parts[i]];
+            if (next == null || typeof next !== 'object') {
+                parent = {}; // will be skipped below
+                break;
+            }
+            parent = next;
+        }
+        const lastKey = parts[parts.length - 1];
+        const node = parent[lastKey];
+        if (node != null && typeof node === 'object') {
+            parent[lastKey] = diag.fix.apply(node);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=fixer.js.map

package/dist/core/fixer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixer.js","sourceRoot":"","sources":["../../src/core/fixer.ts"],"names":[],"mappings":"AAGA,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC5C,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAAgB,EAChB,WAAyB,EACzB,SAAoB;IAEpB,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CACrE,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEvC,MAAM,MAAM,GAAc,eAAe,CAAC,KAAK,CAAC,CAAC;IAEjD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,SAAS,KAAK,CAAC,CAAC;YAAE,SAAS;QAE/B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEjC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAuC,CAAC;QAExE,IAAI,MAAM,GAA4B,OAAO,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7C,MAAM,GAAG,EAA6B,CAAC,CAAC,wBAAwB;gBAChE,MAAM;YACR,CAAC;YACD,MAAM,GAAG,IAA+B,CAAC;QAC3C,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,GAAI,CAAC,KAAK,CAAC,IAA+B,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/rule.d.ts

@@ -0,0 +1,52 @@
+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 interface JSONSchema {
+    type?: string | string[];
+    properties?: Record<string, JSONSchema>;
+    required?: string[] | boolean;
+    items?: JSONSchema | JSONSchema[];
+    enum?: unknown[];
+    $ref?: string;
+    $defs?: Record<string, JSONSchema>;
+    definitions?: Record<string, JSONSchema>;
+    if?: JSONSchema;
+    then?: JSONSchema;
+    else?: JSONSchema;
+    oneOf?: JSONSchema[];
+    anyOf?: JSONSchema[];
+    allOf?: JSONSchema[];
+    not?: JSONSchema;
+    patternProperties?: Record<string, JSONSchema>;
+    additionalItems?: JSONSchema | boolean;
+    dependencies?: Record<string, JSONSchema | string[]>;
+    $dynamicRef?: string;
+    contentEncoding?: string;
+    format?: string;
+    default?: unknown;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface MCPTool {
+    name: string;
+    description?: string;
+    inputSchema: JSONSchema;
+}
+export interface Config {
+    rules?: Record<string, Severity | 'off'>;
+    clients?: ClientId[];
+    ignore?: string[];
+    maxDepth?: number;
+}
+export interface RuleContext {
+    config: Config;
+}
+export interface Rule {
+    id: string;
+    severity: Severity;
+    description: string;
+    url?: string;
+    clients: ClientId[];
+    check: (tool: MCPTool, context: RuleContext) => Diagnostic[];
+}

package/dist/core/rule.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rule.js.map

package/dist/core/rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../src/core/rule.ts"],"names":[],"mappings":""}

package/dist/core/severity.d.ts

@@ -0,0 +1 @@
+export type Severity = 'error' | 'warning' | 'info';

package/dist/core/severity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=severity.js.map

package/dist/core/severity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.js","sourceRoot":"","sources":["../../src/core/severity.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+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';
+const program = new Command();
+program
+    .name('mcp-lint')
+    .description('Lint MCP server tool schemas for cross-client compatibility')
+    .version('0.1.0');
+registerCheckCommand(program);
+registerFixCommand(program);
+registerInitCommand(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/loaders/file-loader.d.ts

@@ -0,0 +1,2 @@
+import type { MCPTool } from '../core/rule.js';
+export declare function loadFile(filePath: string): Promise<MCPTool[]>;

package/dist/loaders/file-loader.js

@@ -0,0 +1,30 @@
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+export async function loadFile(filePath) {
+    let content;
+    try {
+        content = await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        throw new Error(`Cannot read file "${filePath}": ${err.message}`);
+    }
+    const ext = extname(filePath).toLowerCase();
+    let data;
+    try {
+        if (ext === '.yaml' || ext === '.yml') {
+            data = parseYaml(content);
+        }
+        else {
+            data = JSON.parse(content);
+        }
+    }
+    catch (err) {
+        throw new Error(`Failed to parse "${filePath}": ${err.message}`);
+    }
+    if (!Array.isArray(data)) {
+        throw new Error(`Expected an array of MCP tools in "${filePath}", got ${typeof data}`);
+    }
+    return data;
+}
+//# sourceMappingURL=file-loader.js.map

package/dist/loaders/file-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-loader.js","sourceRoot":"","sources":["../../src/loaders/file-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,MAAO,GAA6B,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,IAAa,CAAC;IAElB,IAAI,CAAC;QACH,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACtC,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,MAAO,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,UAAU,OAAO,IAAI,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,IAAiB,CAAC;AAC3B,CAAC"}

package/dist/loaders/sse-loader.d.ts

@@ -0,0 +1,2 @@
+import type { MCPTool } from '../core/rule.js';
+export declare function loadSSE(url: string): Promise<MCPTool[]>;

package/dist/loaders/sse-loader.js

@@ -0,0 +1,19 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+export async function loadSSE(url) {
+    const transport = new SSEClientTransport(new URL(url));
+    const client = new Client({ name: 'mcp-lint', version: '0.1.0' }, { capabilities: {} });
+    await client.connect(transport);
+    try {
+        const result = await client.listTools();
+        return result.tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        }));
+    }
+    finally {
+        await client.close();
+    }
+}
+//# sourceMappingURL=sse-loader.js.map

package/dist/loaders/sse-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-loader.js","sourceRoot":"","sources":["../../src/loaders/sse-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW;IACvC,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;IAExF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAqC;SACrD,CAAC,CAAC,CAAC;IACN,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/loaders/stdio-loader.d.ts

@@ -0,0 +1,2 @@
+import type { MCPTool } from '../core/rule.js';
+export declare function loadStdio(command: string, args: string[]): Promise<MCPTool[]>;

package/dist/loaders/stdio-loader.js

@@ -0,0 +1,19 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+export async function loadStdio(command, args) {
+    const transport = new StdioClientTransport({ command, args });
+    const client = new Client({ name: 'mcp-lint', version: '0.1.0' }, { capabilities: {} });
+    await client.connect(transport);
+    try {
+        const result = await client.listTools();
+        return result.tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        }));
+    }
+    finally {
+        await client.close();
+    }
+}
+//# sourceMappingURL=stdio-loader.js.map

package/dist/loaders/stdio-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-loader.js","sourceRoot":"","sources":["../../src/loaders/stdio-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe,EAAE,IAAc;IAC7D,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;IAExF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAqC;SACrD,CAAC,CAAC,CAAC;IACN,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

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

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

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

@@ -0,0 +1,30 @@
+import { walkSchema } from '../../utils/schema-walker.js';
+export const claudeNoTypeArray = {
+    id: 'claude/no-type-array',
+    severity: 'warning',
+    description: 'Claude may not handle array syntax for `type` (e.g. `["string", "null"]`) correctly.',
+    clients: ['claude'],
+    check(tool, _context) {
+        const diagnostics = [];
+        walkSchema(tool.inputSchema, (schema, path) => {
+            if (Array.isArray(schema.type)) {
+                const diagnosticPath = path ? `inputSchema.${path}` : 'inputSchema';
+                const primaryType = schema.type.find((t) => t !== 'null') ?? schema.type[0];
+                diagnostics.push({
+                    ruleId: 'claude/no-type-array',
+                    severity: 'warning',
+                    message: `Array type syntax \`"type": ${JSON.stringify(schema.type)}\` at "${diagnosticPath}" may not be handled correctly by Claude. Use a single type string.`,
+                    toolName: tool.name,
+                    path: diagnosticPath,
+                    clients: ['claude'],
+                    fix: {
+                        description: `Convert to single type "${primaryType}"`,
+                        apply: (s) => ({ ...s, type: primaryType }),
+                    },
+                });
+            }
+        });
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=claude.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/rules/client-specific/claude.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,EAAE,EAAE,sBAAsB;IAC1B,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,sFAAsF;IACnG,OAAO,EAAE,CAAC,QAAQ,CAAC;IAEnB,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,IAAI,CAAC,EAAE,CAAC;gBAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;gBACpE,MAAM,WAAW,GAAI,MAAM,CAAC,IAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC1F,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,sBAAsB;oBAC9B,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,+BAA+B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,cAAc,qEAAqE;oBAChK,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,CAAC,QAAQ,CAAC;oBACnB,GAAG,EAAE;wBACH,WAAW,EAAE,2BAA2B,WAAW,GAAG;wBACtD,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;qBAC5C;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

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

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

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

@@ -0,0 +1,49 @@
+import { walkSchema } from '../../utils/schema-walker.js';
+function inferType(value) {
+    if (value === null)
+        return undefined;
+    if (typeof value === 'string')
+        return 'string';
+    if (typeof value === 'number')
+        return Number.isInteger(value) ? 'integer' : 'number';
+    if (typeof value === 'boolean')
+        return 'boolean';
+    if (Array.isArray(value))
+        return 'array';
+    if (typeof value === 'object')
+        return 'object';
+    return undefined;
+}
+export const cursorNoDefaultWithoutType = {
+    id: 'cursor/no-default-without-type',
+    severity: 'error',
+    description: 'Cursor requires an explicit `type` when a `default` value is present.',
+    clients: ['cursor'],
+    check(tool, _context) {
+        const diagnostics = [];
+        walkSchema(tool.inputSchema, (schema, path) => {
+            if (schema.default !== undefined && schema.type === undefined) {
+                const diagnosticPath = path ? `inputSchema.${path}` : 'inputSchema';
+                const inferred = inferType(schema.default);
+                diagnostics.push({
+                    ruleId: 'cursor/no-default-without-type',
+                    severity: 'error',
+                    message: `Property at "${diagnosticPath}" has a \`default\` value but no \`type\`. Cursor requires an explicit type when defaults are present.`,
+                    toolName: tool.name,
+                    path: diagnosticPath,
+                    clients: ['cursor'],
+                    ...(inferred
+                        ? {
+                            fix: {
+                                description: `Add \`"type": "${inferred}"\` inferred from the default value`,
+                                apply: (s) => ({ ...s, type: inferred }),
+                            },
+                        }
+                        : {}),
+                });
+            }
+        });
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=cursor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/rules/client-specific/cursor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;IACrF,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAS;IAC9C,EAAE,EAAE,gCAAgC;IACpC,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,uEAAuE;IACpF,OAAO,EAAE,CAAC,QAAQ,CAAC;IAEnB,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,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC9D,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;gBACpE,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC3C,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,gCAAgC;oBACxC,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,gBAAgB,cAAc,wGAAwG;oBAC/I,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,CAAC,QAAQ,CAAC;oBACnB,GAAG,CAAC,QAAQ;wBACV,CAAC,CAAC;4BACE,GAAG,EAAE;gCACH,WAAW,EAAE,kBAAkB,QAAQ,qCAAqC;gCAC5E,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;6BACzC;yBACF;wBACH,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

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

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

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

@@ -0,0 +1,60 @@
+export const geminiNoOptionalWithoutDefault = {
+    id: 'gemini/no-optional-without-default',
+    severity: 'warning',
+    description: 'Gemini handles optional parameters better when they have explicit default values.',
+    clients: ['gemini'],
+    check(tool, _context) {
+        const diagnostics = [];
+        const { properties, required } = tool.inputSchema;
+        if (!properties)
+            return diagnostics;
+        const requiredSet = new Set(Array.isArray(required) ? required : []);
+        for (const [propName, propSchema] of Object.entries(properties)) {
+            if (!requiredSet.has(propName) && propSchema.default === undefined) {
+                diagnostics.push({
+                    ruleId: 'gemini/no-optional-without-default',
+                    severity: 'warning',
+                    message: `Optional parameter "${propName}" in tool "${tool.name}" has no \`default\` value. Gemini handles optional params better with explicit defaults.`,
+                    toolName: tool.name,
+                    path: `inputSchema.properties.${propName}`,
+                    clients: ['gemini'],
+                });
+            }
+        }
+        return diagnostics;
+    },
+};
+function getObjectDepth(schema, depth = 0) {
+    if (!schema || typeof schema !== 'object')
+        return depth;
+    if (!schema.properties)
+        return depth;
+    let max = depth;
+    for (const child of Object.values(schema.properties)) {
+        if (child.type === 'object' || child.properties) {
+            max = Math.max(max, getObjectDepth(child, depth + 1));
+        }
+    }
+    return max;
+}
+export const geminiNoNestedObjects = {
+    id: 'gemini/no-nested-objects',
+    severity: 'warning',
+    description: 'Gemini has limited support for object properties nested more than 2 levels deep.',
+    clients: ['gemini'],
+    check(tool, _context) {
+        const depth = getObjectDepth(tool.inputSchema);
+        if (depth > 2) {
+            return [{
+                    ruleId: 'gemini/no-nested-objects',
+                    severity: 'warning',
+                    message: `Tool "${tool.name}" has object properties nested ${depth} level(s) deep. Gemini's function calling has limited support beyond 2 levels.`,
+                    toolName: tool.name,
+                    path: 'inputSchema',
+                    clients: ['gemini'],
+                }];
+        }
+        return [];
+    },
+};
+//# sourceMappingURL=gemini.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../../src/rules/client-specific/gemini.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,8BAA8B,GAAS;IAClD,EAAE,EAAE,oCAAoC;IACxC,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,mFAAmF;IAChG,OAAO,EAAE,CAAC,QAAQ,CAAC;IAEnB,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,WAAW,GAAiB,EAAE,CAAC;QACrC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QAClD,IAAI,CAAC,UAAU;YAAE,OAAO,WAAW,CAAC;QAEpC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAErE,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACnE,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,oCAAoC;oBAC5C,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,uBAAuB,QAAQ,cAAc,IAAI,CAAC,IAAI,2FAA2F;oBAC1J,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,0BAA0B,QAAQ,EAAE;oBAC1C,OAAO,EAAE,CAAC,QAAQ,CAAC;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC;AAEF,SAAS,cAAc,CAAC,MAAkB,EAAE,KAAK,GAAG,CAAC;IACnD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAErC,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YAChD,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAS;IACzC,EAAE,EAAE,0BAA0B;IAC9B,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,kFAAkF;IAC/F,OAAO,EAAE,CAAC,QAAQ,CAAC;IAEnB,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,CAAC;oBACN,MAAM,EAAE,0BAA0B;oBAClC,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,kCAAkC,KAAK,gFAAgF;oBAClJ,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,aAAa;oBACnB,OAAO,EAAE,CAAC,QAAQ,CAAC;iBACpB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC"}

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

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

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

@@ -0,0 +1,22 @@
+const MAX_PARAMS = 15;
+export const vscodeMaxParams = {
+    id: 'vscode/max-params',
+    severity: 'warning',
+    description: `VS Code Copilot performance degrades with more than ${MAX_PARAMS} parameters.`,
+    clients: ['vscode'],
+    check(tool, _context) {
+        const count = Object.keys(tool.inputSchema.properties ?? {}).length;
+        if (count > MAX_PARAMS) {
+            return [{
+                    ruleId: 'vscode/max-params',
+                    severity: 'warning',
+                    message: `Tool "${tool.name}" has ${count} parameters. VS Code Copilot performance degrades with more than ${MAX_PARAMS}. Consider splitting into multiple tools.`,
+                    toolName: tool.name,
+                    path: 'inputSchema.properties',
+                    clients: ['vscode'],
+                }];
+        }
+        return [];
+    },
+};
+//# sourceMappingURL=vscode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vscode.js","sourceRoot":"","sources":["../../../src/rules/client-specific/vscode.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,mBAAmB;IACvB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,uDAAuD,UAAU,cAAc;IAC5F,OAAO,EAAE,CAAC,QAAQ,CAAC;IAEnB,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACpE,IAAI,KAAK,GAAG,UAAU,EAAE,CAAC;YACvB,OAAO,CAAC;oBACN,MAAM,EAAE,mBAAmB;oBAC3B,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,SAAS,KAAK,oEAAoE,UAAU,2CAA2C;oBAClK,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,wBAAwB;oBAC9B,OAAO,EAAE,CAAC,QAAQ,CAAC;iBACpB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC"}

package/dist/rules/description-exists.d.ts

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

package/dist/rules/description-exists.js

@@ -0,0 +1,35 @@
+export const descriptionExists = {
+    id: 'description-exists',
+    severity: 'warning',
+    description: 'Tools and parameters should have descriptions for better LLM tool-use quality.',
+    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+    check(tool, _context) {
+        const diagnostics = [];
+        if (!tool.description || tool.description.trim() === '') {
+            diagnostics.push({
+                ruleId: 'description-exists',
+                severity: 'warning',
+                message: `Tool "${tool.name}" is missing a description. All clients use descriptions for prompt construction.`,
+                toolName: tool.name,
+                path: 'description',
+                clients: ['claude', 'cursor', 'gemini', 'vscode'],
+            });
+        }
+        if (tool.inputSchema.properties) {
+            for (const [propName, propSchema] of Object.entries(tool.inputSchema.properties)) {
+                if (!propSchema.description || propSchema.description.trim() === '') {
+                    diagnostics.push({
+                        ruleId: 'description-exists',
+                        severity: 'warning',
+                        message: `Parameter "${propName}" in tool "${tool.name}" is missing a description.`,
+                        toolName: tool.name,
+                        path: `inputSchema.properties.${propName}`,
+                        clients: ['claude', 'cursor', 'gemini', 'vscode'],
+                    });
+                }
+            }
+        }
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=description-exists.js.map

package/dist/rules/description-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-exists.js","sourceRoot":"","sources":["../../src/rules/description-exists.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,EAAE,EAAE,oBAAoB;IACxB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,gFAAgF;IAC7F,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAEjD,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACxD,WAAW,CAAC,IAAI,CAAC;gBACf,MAAM,EAAE,oBAAoB;gBAC5B,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,mFAAmF;gBAC9G,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;YAChC,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjF,IAAI,CAAC,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBACpE,WAAW,CAAC,IAAI,CAAC;wBACf,MAAM,EAAE,oBAAoB;wBAC5B,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,cAAc,QAAQ,cAAc,IAAI,CAAC,IAAI,6BAA6B;wBACnF,QAAQ,EAAE,IAAI,CAAC,IAAI;wBACnB,IAAI,EAAE,0BAA0B,QAAQ,EAAE;wBAC1C,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;qBAClD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/rules/index.d.ts

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