mcp-lint 0.5.3 → 0.6.2

package/README.md

@@ -7,7 +7,9 @@
 [![MCP server ready](https://img.shields.io/badge/MCP-server_ready-6f42c1)](#mcp-server)
 [![robert19001-cmyk/mcp-lint MCP server](https://glama.ai/mcp/servers/robert19001-cmyk/mcp-lint/badges/score.svg)](https://glama.ai/mcp/servers/robert19001-cmyk/mcp-lint)
 
-**Lint MCP server tool schemas for cross-client compatibility.**
+**Lint MCP server tool schemas, then check whether an agent can recover when a tool fails.**
+
+Proof page, with a live bench: [mcp-lint-alpha.vercel.app](https://mcp-lint-alpha.vercel.app/)
 
 MCP servers expose tool schemas consumed by **Claude**, **Cursor**, **Gemini**, **VS Code Copilot**, **Windsurf**, **Cline**, **OpenAI Agents SDK**, and **Continue.dev**. Each client has different JSON Schema support and quirks — a schema that works in Claude may silently break in Cursor or OpenAI. `mcp-lint` catches these issues before your users do.
 
@@ -60,6 +62,9 @@ mcp-lint init
 
 # Run as an MCP server
 mcp-lint-server
+
+# Score whether a tool failure tells the agent which tool to call next
+mcp-lint recover examples/recover/bad-credential.json
 ```
 
 ---
@@ -332,7 +337,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: robert19001-cmyk/mcp-lint@v0.5.3
+      - uses: robert19001-cmyk/mcp-lint@v0.6.2
         with:
           input: tools.json
           severity: warning
@@ -556,6 +561,68 @@ Use them directly in shell wrappers or CI gates.
 
 ---
 
+## `mcp-lint recover` — Can the agent get back up?
+
+Schema lint does not say what happens when a tool fails. `recover` reads the error text and checks four things an agent limited to MCP tools needs:
+
+- A credential or permission error names a tool on this server, such as `login`.
+- A rate limit or timeout names the call to repeat. "Wait and retry" is not enough.
+- The next step is not a terminal command, a config edit, or a web page.
+- The failure is not silent, and a hang is cut off at 15 seconds.
+
+```bash
+$ mcp-lint recover examples/recover/bad-credential.json
+
+search#1
+  ✖ Credential or permission error does not name a tool on this server. Say which tool to call, for example `login`, then retry.
+    [recover/names-tool]
+  ✖ Next step asks for a terminal command, which an agent limited to MCP tools cannot do. Name a tool from this server instead.
+    [recover/agent-reachable]
+
+search#2
+  ✖ Retry text does not name the call to repeat. Name `search` instead of "wait and retry".
+    [recover/names-retry]
+
+3 errors, 1 recoverable of 3
+```
+
+Exit `1` when any sample has an error. Exit `0` when every failure is recoverable.
+
+Probe a live server. Tools with no required arguments are skipped, so an empty call cannot fire a real action.
+
+```bash
+mcp-lint recover --server stdio -- node server.js
+mcp-lint recover errors.json --hang-ms 8000 --format json
+```
+
+File shape:
+
+```json
+{
+  "tools": ["login", "search"],
+  "samples": [
+    {
+      "tool": "search",
+      "kind": "credential",
+      "message": "Unauthorized. Call the login tool, then retry search."
+    }
+  ]
+}
+```
+
+`kind` is `credential`, `permission`, `rate_limit`, `explicit`, `silent`, `timeout`, or `malformed`.
+
+```typescript
+import { scoreRecovery } from 'mcp-lint/recover';
+
+const report = scoreRecovery(
+  [{ tool: 'search', kind: 'rate_limit', message: 'Wait before retrying.' }],
+  { tools: ['login', 'search'] },
+);
+```
+
+---
+
 ## MCP Server
 
 `mcp-lint` also ships as a stdio MCP server for Claude Desktop, Claude Code, Cursor, VS Code, and registry scanners such as Glama.
@@ -586,6 +653,7 @@ Available MCP tools:
 | `mcp_lint_check_tools` | Lint MCP tool schemas passed as JSON |
 | `mcp_lint_fix_tools` | Return safely auto-fixed tool schemas without writing files |
 | `mcp_lint_preflight_action` | Score a proposed agent action and return allow/deny/approval/rewrite |
+| `mcp_lint_score_recovery` | Score a recorded tool failure for whether an agent can recover |
 
 All server tools are read-only from the host perspective: they return diagnostics, fixed JSON, or policy decisions and never execute the action being evaluated.
 
@@ -600,6 +668,24 @@ The repository includes `glama.json` and a production Dockerfile so MCP director
 
 ---
 
+## Site
+
+The proof page is in `site/`. It runs the same recovery scorer as the CLI.
+
+```bash
+npm run site
+```
+
+The public page is https://mcp-lint-alpha.vercel.app/. The same page runs locally:
+
+```bash
+npm run site
+```
+
+Open http://127.0.0.1:4731. The built page is not part of the npm package.
+
+---
+
 ## License
 
 MIT © Robert

package/dist/cli/commands/recover.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerRecoverCommand(program: Command): void;

package/dist/cli/commands/recover.js

@@ -0,0 +1,97 @@
+import { readFile } from 'node:fs/promises';
+import chalk from 'chalk';
+import { scoreRecovery } from '../../recover/score.js';
+import { probeStdio } from '../../recover/probe.js';
+import { DEFAULT_HANG_MS } from '../../recover/types.js';
+export function registerRecoverCommand(program) {
+    program
+        .command('recover [file]')
+        .description('Score MCP tool failures for whether an agent limited to tools can recover')
+        .option('--format <format>', 'Output format: terminal|json', 'terminal')
+        .option('--no-color', 'Disable terminal colors')
+        .option('--server <type>', 'Probe a live server: stdio')
+        .option('--hang-ms <ms>', 'Hang budget in milliseconds', String(DEFAULT_HANG_MS))
+        .allowExcessArguments(true)
+        .action(async (file, options) => {
+        if (!options.color)
+            chalk.level = 0;
+        const hangMs = Number(options.hangMs);
+        if (!Number.isInteger(hangMs) || hangMs < 1) {
+            process.stderr.write('Error: --hang-ms must be a positive integer\n');
+            process.exit(2);
+        }
+        try {
+            let report;
+            let skipped = [];
+            if (options.server === 'stdio') {
+                const rawArgv = process.argv;
+                const sepIdx = rawArgv.indexOf('--');
+                if (sepIdx === -1 || sepIdx >= rawArgv.length - 1) {
+                    throw new Error('--server stdio requires a command after --, e.g.: mcp-lint recover --server stdio -- node server.js');
+                }
+                const [cmd, ...cmdArgs] = rawArgv.slice(sepIdx + 1);
+                const probed = await probeStdio(cmd, cmdArgs, { hangMs });
+                report = probed.report;
+                skipped = probed.skipped;
+            }
+            else if (options.server) {
+                throw new Error(`Unknown server transport "${options.server}". Use stdio.`);
+            }
+            else {
+                if (!file)
+                    throw new Error('Specify a recovery file or use --server stdio -- <command>');
+                const parsed = JSON.parse(await readFile(file, 'utf8'));
+                report = scoreRecovery(samplesFromFile(parsed), { hangMs: parsed.hangMs ?? hangMs, tools: parsed.tools });
+            }
+            const output = options.format === 'json'
+                ? JSON.stringify({ ...report, skipped }, null, 2) + '\n'
+                : renderTerminal(report, skipped);
+            process.stdout.write(output);
+            process.exit(report.errors > 0 ? 1 : 0);
+        }
+        catch (err) {
+            process.stderr.write(`Error: ${err.message}\n`);
+            process.exit(2);
+        }
+    });
+}
+function samplesFromFile(parsed) {
+    if (!parsed || !Array.isArray(parsed.samples)) {
+        throw new Error('Recovery file must be { "tools": string[], "samples": [...] }');
+    }
+    if (!Array.isArray(parsed.tools) || parsed.tools.length === 0) {
+        throw new Error('Recovery file must list the server tools in "tools"');
+    }
+    return parsed.samples;
+}
+function renderTerminal(report, skipped) {
+    const lines = [''];
+    if (report.findings.length === 0) {
+        lines.push(chalk.green(`All ${report.samples} failure${report.samples === 1 ? '' : 's'} are recoverable.`));
+    }
+    else {
+        const grouped = new Map();
+        for (const item of report.findings) {
+            const bucket = grouped.get(item.sampleId) ?? [];
+            bucket.push(item);
+            grouped.set(item.sampleId, bucket);
+        }
+        for (const [sampleId, items] of grouped) {
+            lines.push(chalk.bold(sampleId));
+            for (const item of items) {
+                const mark = item.severity === 'error' ? chalk.red('✖') : chalk.yellow('⚠');
+                lines.push(`  ${mark} ${item.message}`);
+                lines.push(chalk.dim(`    [${item.ruleId}]`));
+            }
+            lines.push('');
+        }
+    }
+    if (skipped.length > 0) {
+        lines.push(chalk.dim(`Skipped ${skipped.length} tool${skipped.length === 1 ? '' : 's'} with no required arguments: ${skipped.join(', ')}`));
+    }
+    const summary = `${report.errors} error${report.errors === 1 ? '' : 's'}, ${report.recoverable} recoverable of ${report.samples}`;
+    lines.push(report.errors > 0 ? chalk.red(summary) : chalk.green(summary));
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=recover.js.map

package/dist/cli/commands/recover.js.map

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

package/dist/core/rule.d.ts

@@ -30,11 +30,19 @@ export interface JSONSchema {
     description?: string;
     [key: string]: unknown;
 }
+export interface ToolAnnotations {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
 export interface MCPTool {
     name: string;
     title?: string;
     description?: string;
     inputSchema: JSONSchema;
+    annotations?: ToolAnnotations;
 }
 export interface Config {
     extends?: string;

package/dist/index.js

@@ -7,11 +7,12 @@ import { registerCompatCommand } from './cli/commands/compat.js';
 import { registerExplainCommand } from './cli/commands/explain.js';
 import { registerDiffCommand } from './cli/commands/diff.js';
 import { registerPreflightCommand } from './cli/commands/preflight.js';
+import { registerRecoverCommand } from './cli/commands/recover.js';
 const program = new Command();
 program
     .name('mcp-lint')
-    .description('Lint MCP server tool schemas for cross-client compatibility')
-    .version('0.5.3');
+    .description('Lint MCP tool schemas and score whether an agent can recover from tool failures')
+    .version('0.6.0');
 registerCheckCommand(program);
 registerFixCommand(program);
 registerInitCommand(program);
@@ -19,5 +20,6 @@ registerCompatCommand(program);
 registerExplainCommand(program);
 registerDiffCommand(program);
 registerPreflightCommand(program);
+registerRecoverCommand(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;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,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;AAC7B,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAElC,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;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,iFAAiF,CAAC;KAC9F,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;AAC7B,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAEhC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/mcp-server.js

@@ -11,7 +11,9 @@ import { DEFAULT_CONFIG } from './config/config.js';
 import { allRules } from './rules/index.js';
 import { preflight } from './preflight/engine.js';
 import { parsePolicy } from './preflight/policy.js';
-const VERSION = '0.5.3';
+import { scoreRecovery } from './recover/score.js';
+import { FAILURE_KINDS } from './recover/types.js';
+const VERSION = '0.6.0';
 const ClientIdSchema = z.enum([
     'claude',
     'cursor',
@@ -229,6 +231,35 @@ export function createMcpLintServer() {
         const policy = policyYaml ? parsePolicy(policyYaml) : undefined;
         return result({ decision: preflight(action, policy) });
     });
+    server.registerTool('mcp_lint_score_recovery', {
+        title: 'Score MCP Failure Recovery',
+        description: 'Score MCP tool failure text for whether an agent that can only call tools can recover. Does not call the failing tool.',
+        inputSchema: {
+            tools: z.array(z.string().min(1)).min(1).describe('Tool names the agent is allowed to call.'),
+            hangMs: z.number().int().positive().optional().describe('Hang budget in milliseconds. Defaults to 15000.'),
+            samples: z.array(z.object({
+                id: z.string().optional(),
+                tool: z.string().min(1).describe('Tool that failed.'),
+                kind: z.enum(FAILURE_KINDS).describe('Failure kind: credential, permission, rate_limit, explicit, silent, timeout, or malformed.'),
+                message: z.string().optional().describe('Error text shown to the agent.'),
+                isError: z.boolean().optional(),
+                durationMs: z.number().int().nonnegative().optional(),
+            })).describe('Recorded tool failures to score.'),
+        },
+        outputSchema: {
+            report: JsonObjectSchema,
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ tools, hangMs, samples }) => {
+        return result({
+            report: scoreRecovery(samples, { tools, hangMs }),
+        });
+    });
     return server;
 }
 async function main() {

package/dist/mcp-server.js.map

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

package/dist/recover/index.d.ts

@@ -0,0 +1,5 @@
+export { scoreRecovery, mentionedTool, unreachableStep, instructionBlocker, classifyFailure, normalizeSample } from './score.js';
+export { probeClient, probeStdio } from './probe.js';
+export type { ProbeClient, ProbeTool, ProbeCallResult } from './probe.js';
+export type { FailureKind, RecoveryFile, RecoveryFinding, RecoveryReport, RecoveryRuleId, RecoverySample, RecoverySampleInput, } from './types.js';
+export { DEFAULT_HANG_MS, FAILURE_KINDS } from './types.js';

package/dist/recover/index.js

@@ -0,0 +1,4 @@
+export { scoreRecovery, mentionedTool, unreachableStep, instructionBlocker, classifyFailure, normalizeSample } from './score.js';
+export { probeClient, probeStdio } from './probe.js';
+export { DEFAULT_HANG_MS, FAILURE_KINDS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/recover/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recover/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjI,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAWrD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/recover/probe.d.ts

@@ -0,0 +1,39 @@
+import type { RecoveryReport, RecoverySampleInput } from './types.js';
+export interface ProbeTool {
+    name: string;
+    inputSchema?: {
+        required?: unknown;
+    };
+}
+export interface ProbeCallResult {
+    isError?: boolean;
+    content?: Array<{
+        type: string;
+        text?: string;
+    }>;
+}
+export interface ProbeClient {
+    listTools(): Promise<{
+        tools: ProbeTool[];
+    }>;
+    callTool(params: {
+        name: string;
+        arguments: Record<string, unknown>;
+    }, resultSchema: undefined, options: {
+        timeout: number;
+    }): Promise<ProbeCallResult>;
+}
+export declare function probeClient(client: ProbeClient, options?: {
+    hangMs?: number;
+}): Promise<{
+    report: RecoveryReport;
+    samples: RecoverySampleInput[];
+    skipped: string[];
+}>;
+export declare function probeStdio(command: string, args: string[], options?: {
+    hangMs?: number;
+}): Promise<{
+    report: RecoveryReport;
+    samples: RecoverySampleInput[];
+    skipped: string[];
+}>;

package/dist/recover/probe.js

@@ -0,0 +1,80 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { classifyFailure, scoreRecovery } from './score.js';
+import { DEFAULT_HANG_MS } from './types.js';
+export async function probeClient(client, options = {}) {
+    const hangMs = options.hangMs ?? DEFAULT_HANG_MS;
+    const listed = await client.listTools();
+    const tools = listed.tools.map((tool) => tool.name);
+    const samples = [];
+    const skipped = [];
+    for (const tool of listed.tools) {
+        const required = Array.isArray(tool.inputSchema?.required) ? tool.inputSchema.required : [];
+        if (required.length === 0) {
+            skipped.push(tool.name);
+            continue;
+        }
+        const started = Date.now();
+        let timedOut = false;
+        let isError;
+        let message = '';
+        try {
+            const result = await withHang(client.callTool({ name: tool.name, arguments: {} }, undefined, { timeout: hangMs }), hangMs);
+            isError = result.isError;
+            message = textFromContent(result.content);
+        }
+        catch (err) {
+            timedOut = Date.now() - started >= hangMs || /timed out|timeout/i.test(err.message);
+            message = err.message;
+            isError = true;
+        }
+        const durationMs = Date.now() - started;
+        samples.push({
+            id: tool.name,
+            tool: tool.name,
+            kind: classifyFailure({ message, isError, durationMs, hangMs, timedOut }),
+            message,
+            isError,
+            durationMs,
+            tools,
+        });
+    }
+    return {
+        report: scoreRecovery(samples, { hangMs, tools }),
+        samples,
+        skipped,
+    };
+}
+export async function probeStdio(command, args, options = {}) {
+    const transport = new StdioClientTransport({ command, args });
+    const client = new Client({ name: 'mcp-lint-recover', version: '0.6.0' }, { capabilities: {} });
+    await client.connect(transport);
+    try {
+        return await probeClient(client, options);
+    }
+    finally {
+        await client.close();
+    }
+}
+function textFromContent(content) {
+    if (!content)
+        return '';
+    return content
+        .filter((block) => block.type === 'text' && typeof block.text === 'string')
+        .map((block) => block.text)
+        .join('\n')
+        .trim();
+}
+function withHang(work, hangMs) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`timed out after ${hangMs}ms`)), hangMs);
+        work.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=probe.js.map

package/dist/recover/probe.js.map

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

package/dist/recover/score.d.ts

@@ -0,0 +1,18 @@
+import type { FailureKind, RecoveryReport, RecoverySample, RecoverySampleInput } from './types.js';
+export declare function scoreRecovery(samples: RecoverySampleInput[], options?: {
+    hangMs?: number;
+    tools?: string[];
+}): RecoveryReport;
+export declare function normalizeSample(input: RecoverySampleInput, fallbackTools: string[] | undefined, index: number): RecoverySample;
+export declare function mentionedTool(message: string, tools: string[]): string | null;
+export type BlockedStep = 'a terminal command' | 'a config change' | 'a web page';
+export declare function unreachableStep(message: string): BlockedStep | null;
+/** Description lint ignores a bare URL. Error text still treats a URL as a step the agent cannot open. */
+export declare function instructionBlocker(message: string): BlockedStep | null;
+export declare function classifyFailure(input: {
+    message: string;
+    isError?: boolean;
+    durationMs: number;
+    hangMs: number;
+    timedOut?: boolean;
+}): FailureKind;

package/dist/recover/score.js

@@ -0,0 +1,145 @@
+import { DEFAULT_HANG_MS, FAILURE_KINDS } from './types.js';
+const NAMED_TOOL_KINDS = new Set(['credential', 'permission']);
+const RETRY_KINDS = new Set(['rate_limit', 'timeout']);
+const SILENT_KINDS = new Set(['silent', 'malformed']);
+export function scoreRecovery(samples, options = {}) {
+    const hangMs = options.hangMs ?? DEFAULT_HANG_MS;
+    const findings = [];
+    let recoverable = 0;
+    samples.forEach((input, index) => {
+        const sample = normalizeSample(input, options.tools, index);
+        const before = findings.length;
+        findings.push(...scoreSample(sample, hangMs));
+        const errors = findings.slice(before).filter((finding) => finding.severity === 'error');
+        if (errors.length === 0)
+            recoverable += 1;
+    });
+    return {
+        samples: samples.length,
+        errors: findings.filter((finding) => finding.severity === 'error').length,
+        warnings: findings.filter((finding) => finding.severity === 'warning').length,
+        recoverable,
+        findings,
+    };
+}
+export function normalizeSample(input, fallbackTools, index) {
+    if (!input.tool?.trim()) {
+        throw new Error(`Sample ${index + 1} is missing a tool name`);
+    }
+    if (!FAILURE_KINDS.includes(input.kind)) {
+        throw new Error(`Sample ${index + 1} has unknown kind "${String(input.kind)}"`);
+    }
+    const tools = input.tools ?? fallbackTools;
+    if (!tools || tools.length === 0) {
+        throw new Error(`Sample ${index + 1} has no tool list. Put tool names on the sample or on the file.`);
+    }
+    return {
+        id: input.id ?? `${input.tool}#${index + 1}`,
+        tool: input.tool,
+        kind: input.kind,
+        message: input.message,
+        isError: input.isError,
+        durationMs: input.durationMs,
+        tools,
+    };
+}
+function scoreSample(sample, hangMs) {
+    const findings = [];
+    const text = sample.message?.trim() ?? '';
+    const named = mentionedTool(text, sample.tools);
+    const blocked = unreachableStep(text);
+    if (SILENT_KINDS.has(sample.kind) || (sample.kind === 'explicit' && text.length === 0)) {
+        findings.push(finding(sample, 'recover/not-silent', 'Failure has no text an agent can act on. Return an error that names the tool to call next.'));
+    }
+    const hung = sample.durationMs === undefined
+        ? sample.kind === 'timeout'
+        : sample.durationMs >= hangMs;
+    if (hung) {
+        const took = sample.durationMs !== undefined ? `${sample.durationMs}ms` : 'too long';
+        findings.push(finding(sample, 'recover/bounded-hang', `Call ran ${took}, past the ${hangMs}ms hang budget. Cut it off instead of waiting.`));
+    }
+    if (NAMED_TOOL_KINDS.has(sample.kind) && !named) {
+        findings.push(finding(sample, 'recover/names-tool', 'Credential or permission error does not name a tool on this server. Say which tool to call, for example `login`, then retry.'));
+    }
+    if (RETRY_KINDS.has(sample.kind) && !named) {
+        findings.push(finding(sample, 'recover/names-retry', `Retry text does not name the call to repeat. Name \`${sample.tool}\` instead of "wait and retry".`));
+    }
+    if (blocked && !named) {
+        findings.push(finding(sample, 'recover/agent-reachable', `Next step asks for ${blocked}, which an agent limited to MCP tools cannot do. Name a tool from this server instead.`));
+    }
+    else if (blocked && named) {
+        findings.push(finding(sample, 'recover/agent-reachable', `Next step still mentions ${blocked} beside tool \`${named}\`. Agents follow that step and stop. Leave only the tool call.`, 'warning'));
+    }
+    return findings;
+}
+function finding(sample, ruleId, message, severity = 'error') {
+    return {
+        ruleId,
+        severity,
+        tool: sample.tool,
+        sampleId: sample.id ?? sample.tool,
+        message,
+    };
+}
+export function mentionedTool(message, tools) {
+    const visible = message
+        .replace(/\b(npm|npx|pnpm|yarn|pip|brew|sudo)\s+\S+/gi, ' ')
+        .replace(/`[^`]*(?:npm |npx |sudo |export )[^`]*`/gi, ' ')
+        .replace(/\bhttps?:\/\/\S+/gi, ' ');
+    const ordered = [...tools].filter((tool) => tool.trim().length > 0).sort((a, b) => b.length - a.length);
+    for (const tool of ordered) {
+        const pattern = new RegExp(`(^|[^A-Za-z0-9_-])${escapeRegExp(tool)}(?![A-Za-z0-9_-])`);
+        if (pattern.test(visible))
+            return tool;
+    }
+    return null;
+}
+export function unreachableStep(message) {
+    if (!message.trim())
+        return null;
+    if (TERMINAL.test(message))
+        return 'a terminal command';
+    if (CONFIG.test(message))
+        return 'a config change';
+    if (WEB.test(message))
+        return 'a web page';
+    return null;
+}
+/** Description lint ignores a bare URL. Error text still treats a URL as a step the agent cannot open. */
+export function instructionBlocker(message) {
+    if (!message.trim())
+        return null;
+    if (TERMINAL.test(message))
+        return 'a terminal command';
+    if (CONFIG.test(message))
+        return 'a config change';
+    if (WEB_INSTRUCTION.test(message))
+        return 'a web page';
+    return null;
+}
+const TERMINAL = /\b(npm|npx|pnpm|yarn|pip|brew|sudo)\s+\S|\b(in (your |the )?terminal|command line|shell command)\b|`[^`]*(npm |npx |sudo |export )/i;
+const CONFIG = /\b(config(uration)? file|\.env|environment variable|edit your config)\b|\bset [A-Z][A-Z0-9_]{2,}\b/;
+const WEB = /\bhttps?:\/\/\S|\b(open|visit|go to|sign in at|log in at)\b[^.]{0,80}\b(browser|page|dashboard)\b/i;
+const WEB_INSTRUCTION = /\b(open|visit|go to|sign in at|log in at)\b[^.]{0,80}\b(browser|page|dashboard)\b/i;
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export function classifyFailure(input) {
+    const text = input.message.trim();
+    if (input.timedOut || input.durationMs >= input.hangMs || /\btime(?:d)? out\b/i.test(text)) {
+        return 'timeout';
+    }
+    if (/rate limit|too many requests|\b429\b/i.test(text))
+        return 'rate_limit';
+    if (/unauthori[sz]ed|invalid (token|api key|credential)|expired (token|credential)|\b401\b/i.test(text)) {
+        return 'credential';
+    }
+    if (/\bforbidden\b|permission denied|\b403\b/i.test(text))
+        return 'permission';
+    if (input.isError === false && text.length === 0)
+        return 'silent';
+    if (text.length === 0)
+        return 'malformed';
+    return 'explicit';
+}
+//# sourceMappingURL=score.js.map

package/dist/recover/score.js.map

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

package/dist/recover/types.d.ts

@@ -0,0 +1,41 @@
+export type FailureKind = 'credential' | 'permission' | 'rate_limit' | 'explicit' | 'silent' | 'timeout' | 'malformed';
+export type RecoveryRuleId = 'recover/names-tool' | 'recover/names-retry' | 'recover/agent-reachable' | 'recover/not-silent' | 'recover/bounded-hang';
+export interface RecoverySample {
+    id?: string;
+    tool: string;
+    kind: FailureKind;
+    message?: string;
+    isError?: boolean;
+    durationMs?: number;
+    tools: string[];
+}
+export interface RecoverySampleInput {
+    id?: string;
+    tool: string;
+    kind: FailureKind;
+    message?: string;
+    isError?: boolean;
+    durationMs?: number;
+    tools?: string[];
+}
+export interface RecoveryFile {
+    tools: string[];
+    hangMs?: number;
+    samples: RecoverySampleInput[];
+}
+export interface RecoveryFinding {
+    ruleId: RecoveryRuleId;
+    severity: 'error' | 'warning';
+    tool: string;
+    sampleId: string;
+    message: string;
+}
+export interface RecoveryReport {
+    samples: number;
+    errors: number;
+    warnings: number;
+    recoverable: number;
+    findings: RecoveryFinding[];
+}
+export declare const DEFAULT_HANG_MS = 15000;
+export declare const FAILURE_KINDS: readonly FailureKind[];

package/dist/recover/types.js

@@ -0,0 +1,11 @@
+export const DEFAULT_HANG_MS = 15_000;
+export const FAILURE_KINDS = [
+    'credential',
+    'permission',
+    'rate_limit',
+    'explicit',
+    'silent',
+    'timeout',
+    'malformed',
+];
+//# sourceMappingURL=types.js.map

package/dist/recover/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/recover/types.ts"],"names":[],"mappings":"AA0DA,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,SAAS;IACT,WAAW;CACZ,CAAC"}

package/dist/rules/agent-unreachable.d.ts

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

package/dist/rules/agent-unreachable.js

@@ -0,0 +1,36 @@
+import { instructionBlocker } from '../recover/score.js';
+const CLIENTS = ['claude', 'cursor', 'gemini', 'vscode', 'windsurf', 'cline', 'openai', 'continue'];
+export const noUnreachableInstruction = {
+    id: 'agent/no-unreachable-instruction',
+    severity: 'warning',
+    description: 'Tool text must not send an agent to a terminal, a config file, or a web page.',
+    clients: CLIENTS,
+    docs: {
+        why: 'An agent that can only call MCP tools follows the step it is given. A terminal command, config edit, or browser page stops the task.',
+        badExample: {
+            name: 'search',
+            description: 'Search issues. If this fails, run npm login in your terminal.',
+            inputSchema: { type: 'object', properties: {} },
+        },
+        goodExample: {
+            name: 'search',
+            description: 'Search issues. If authorization fails, call the login tool, then retry search.',
+            inputSchema: { type: 'object', properties: {} },
+        },
+    },
+    check(tool, _context) {
+        const text = [tool.title, tool.description].filter(Boolean).join('\n');
+        const blocked = instructionBlocker(text);
+        if (!blocked)
+            return [];
+        return [{
+                ruleId: 'agent/no-unreachable-instruction',
+                severity: 'warning',
+                message: `Tool "${tool.name}" tells the agent to use ${blocked}. Name a tool on this server instead.`,
+                toolName: tool.name,
+                path: 'description',
+                clients: CLIENTS,
+            }];
+    },
+};
+//# sourceMappingURL=agent-unreachable.js.map

package/dist/rules/agent-unreachable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-unreachable.js","sourceRoot":"","sources":["../../src/rules/agent-unreachable.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,OAAO,GAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AAEhH,MAAM,CAAC,MAAM,wBAAwB,GAAS;IAC5C,EAAE,EAAE,kCAAkC;IACtC,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,+EAA+E;IAC5F,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE;QACJ,GAAG,EAAE,sIAAsI;QAC3I,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+DAA+D;YAC5E,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;SAChD;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gFAAgF;YAC7F,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;SAChD;KACF;IAED,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC;gBACN,MAAM,EAAE,kCAAkC;gBAC1C,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,4BAA4B,OAAO,uCAAuC;gBACrG,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/rules/destructive-hint.d.ts

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

package/dist/rules/destructive-hint.js

@@ -0,0 +1,82 @@
+const CLIENTS = ['claude', 'cursor', 'gemini', 'vscode', 'windsurf', 'cline', 'openai', 'continue'];
+const DESTRUCTIVE = /\b(delete|drop|destroy|wipe|truncate|unlink|send|pay|charge|deploy|overwrite)\b/i;
+export const destructiveUnmarked = {
+    id: 'annotations/destructive-unmarked',
+    severity: 'warning',
+    description: 'A tool whose name deletes, sends, pays, or deploys must set annotations.destructiveHint.',
+    clients: CLIENTS,
+    docs: {
+        why: 'Clients use destructiveHint to decide whether a call needs a person. A delete tool with no hint looks the same as a read.',
+        badExample: {
+            name: 'delete_file',
+            description: 'Delete a file.',
+            inputSchema: { type: 'object', properties: {} },
+        },
+        goodExample: {
+            name: 'delete_file',
+            description: 'Delete a file.',
+            annotations: { destructiveHint: true, readOnlyHint: false },
+            inputSchema: { type: 'object', properties: {} },
+        },
+        fixNote: 'Set annotations.destructiveHint to true, or to false only when the name is not actually destructive.',
+    },
+    check(tool, _context) {
+        if (!isDestructive(tool) || tool.annotations?.readOnlyHint === true)
+            return [];
+        if (tool.annotations?.destructiveHint === true)
+            return [];
+        if (tool.annotations?.destructiveHint === false) {
+            return [diagnostic(tool, 'error', `Tool "${tool.name}" looks destructive but annotations.destructiveHint is false.`)];
+        }
+        return [diagnostic(tool, 'warning', `Tool "${tool.name}" looks destructive and has no annotations.destructiveHint.`)];
+    },
+};
+export const readonlyConflict = {
+    id: 'annotations/readonly-conflict',
+    severity: 'error',
+    description: 'A tool marked readOnlyHint must not be named like a delete, send, payment, or deploy.',
+    clients: CLIENTS,
+    docs: {
+        why: 'readOnlyHint tells the client the call cannot change anything. A conflicting name hides a write.',
+        badExample: {
+            name: 'delete_file',
+            annotations: { readOnlyHint: true },
+            inputSchema: { type: 'object', properties: {} },
+        },
+        goodExample: {
+            name: 'delete_file',
+            annotations: { readOnlyHint: false, destructiveHint: true },
+            inputSchema: { type: 'object', properties: {} },
+        },
+    },
+    check(tool, _context) {
+        if (tool.annotations?.readOnlyHint !== true || !isDestructive(tool))
+            return [];
+        return [{
+                ruleId: 'annotations/readonly-conflict',
+                severity: 'error',
+                message: `Tool "${tool.name}" is marked read-only but its name is destructive.`,
+                toolName: tool.name,
+                path: 'annotations.readOnlyHint',
+                clients: CLIENTS,
+            }];
+    },
+};
+function isDestructive(tool) {
+    const words = [tool.name, tool.title ?? '']
+        .join(' ')
+        .replace(/[_-]+/g, ' ')
+        .replace(/([a-z])([A-Z])/g, '$1 $2');
+    return DESTRUCTIVE.test(words);
+}
+function diagnostic(tool, severity, message) {
+    return {
+        ruleId: 'annotations/destructive-unmarked',
+        severity,
+        message,
+        toolName: tool.name,
+        path: 'annotations.destructiveHint',
+        clients: CLIENTS,
+    };
+}
+//# sourceMappingURL=destructive-hint.js.map

package/dist/rules/destructive-hint.js.map

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

package/dist/rules/index.js

@@ -14,6 +14,8 @@ 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';
+import { noUnreachableInstruction } from './agent-unreachable.js';
+import { destructiveUnmarked, readonlyConflict } from './destructive-hint.js';
 export const allRules = [
     noRequiredFalse,
     noContentEncoding,
@@ -34,5 +36,8 @@ export const allRules = [
     clineDescriptionMaxLength,
     openaiNoAdditionalProperties,
     openaiStrictTypes,
+    noUnreachableInstruction,
+    destructiveUnmarked,
+    readonlyConflict,
 ];
 //# 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,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAC/F,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,oBAAoB;IACpB,8BAA8B;IAC9B,qBAAqB;IACrB,eAAe;IACf,oBAAoB;IACpB,yBAAyB;IACzB,4BAA4B;IAC5B,iBAAiB;CAClB,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,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAC/F,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;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,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,oBAAoB;IACpB,8BAA8B;IAC9B,qBAAqB;IACrB,eAAe;IACf,oBAAoB;IACpB,yBAAyB;IACzB,4BAA4B;IAC5B,iBAAiB;IACjB,wBAAwB;IACxB,mBAAmB;IACnB,gBAAgB;CACjB,CAAC"}

package/examples/github-action.yml

@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Lint MCP tool schemas
-        uses: robert19001-cmyk/mcp-lint@v0.3.0
+        uses: robert19001-cmyk/mcp-lint@v0.6.2
         with:
           input: tools.json
           severity: warning

package/examples/recover/bad-credential.json

@@ -0,0 +1,20 @@
+{
+  "tools": ["login", "search"],
+  "samples": [
+    {
+      "tool": "search",
+      "kind": "credential",
+      "message": "Unauthorized. Run npm login in your terminal."
+    },
+    {
+      "tool": "search",
+      "kind": "rate_limit",
+      "message": "Wait before retrying."
+    },
+    {
+      "tool": "search",
+      "kind": "credential",
+      "message": "Unauthorized. Call the login tool, then retry search."
+    }
+  ]
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "mcp-lint",
-  "version": "0.5.3",
+  "version": "0.6.2",
   "mcpName": "io.github.robert19001-cmyk/mcp-lint",
-  "description": "Lint MCP server tool schemas for cross-client compatibility + runtime preflight for agent tool calls",
+  "description": "Lint MCP server tool schemas for cross-client compatibility, runtime preflight, and agent recovery from tool failures",
   "type": "module",
   "repository": {
     "type": "git",
@@ -11,7 +11,7 @@
   "bugs": {
     "url": "https://github.com/robert19001-cmyk/mcp-lint/issues"
   },
-  "homepage": "https://github.com/robert19001-cmyk/mcp-lint#readme",
+  "homepage": "https://mcp-lint-alpha.vercel.app/",
   "bin": {
     "mcp-lint": "dist/index.js",
     "mcp-lint-server": "dist/mcp-server.js"
@@ -27,6 +27,10 @@
       "types": "./dist/preflight/index.d.ts",
       "default": "./dist/preflight/index.js"
     },
+    "./recover": {
+      "types": "./dist/recover/index.d.ts",
+      "default": "./dist/recover/index.js"
+    },
     "./rules": {
       "types": "./dist/rules/index.d.ts",
       "default": "./dist/rules/index.js"
@@ -55,6 +59,7 @@
     "schema",
     "validation",
     "preflight",
+    "recover",
     "agent-safety",
     "policy",
     "guardrails"
@@ -69,6 +74,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
+    "site": "vite --config site/vite.config.ts",
+    "site:build": "vite build --config site/vite.config.ts",
     "prepublishOnly": "npm run build && npm run test"
   },
   "dependencies": {
@@ -81,6 +88,7 @@
   "devDependencies": {
     "@types/node": "^25.5.0",
     "typescript": "^6.0.2",
+    "vite": "^8.3.5",
     "vitest": "^4.1.1"
   }
 }